Fork me on GitHub Open Source

Upgrade

Preamble: Before starting the upgrade, backing up both your database and your site files is of great importance.

Note: You may need to clear your web browser cache after the upgrade.


2.4 -> 2.5

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v2.5 download, do the following:
- rename the /upload/ folder to match your /comments/ folder.
- rename the admin folder upload/admin/ to match your admin folder.
- delete all the text files in /upload/includes/words/
4. Upload the /upload/ folder onto your existing comments folder to overwrite everything.
5. In the pages where Commentics is integrated, do the following:
- remove the line: ob_start();
- remove the line: <link rel="stylesheet" type="text/css" href="comments/css/stylesheet.css"/>
- remove the line: define('IN_COMMENTICS', 'true'); //no need to edit this line
6. Delete the file http://www.domain.com/upload/includes/db/details.php
7. Run the upgrade http://www.domain.com/upload/installer/
8. Log in to your admin panel and make sure everything is working.
9. Take the script out of maintenance mode (Settings -> Maintenance).

2.3 -> 2.4

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v2.4 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the file comments/includes/db/details.php
- delete the files in comments/includes/words/ except for admin_tips.txt
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Add your email signature in Settings -> Email -> Setup.
8. Take the script out of maintenance mode (Settings -> Maintenance).

2.2 -> 2.3

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v2.3 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- enter your database details in comments/includes/db/details.php
- delete the files in comments/includes/words/ except for admin_tips.txt
- delete the folder comments/includes/emails/
4. On your server set normal file permissions (644) for comments/includes/db/details.php
5. Upload the comments folder onto your existing comments folder to overwrite everything.
6. On your server set read-only file permissions (444) for comments/includes/db/details.php
7. Run the upgrade http://www.domain.com/comments/installer/
8. Log in to your admin panel and make sure everything is working.
9. Take the script out of maintenance mode (Settings -> Maintenance).

The 'Subscriber Notification' email has changed. Upload (overwrite) the file /comments/includes/emails/your_language/user/subscriber_notification.txt from v2.3. Then add your signature to it using the Settings -> Email -> Editor.


2.1 -> 2.2

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v2.2 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the files in comments/includes/words/ except for admin_tips.txt
- delete the file comments/includes/db/details.php
- delete the folders in comments/includes/emails/ except for /russian/
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

2.0 -> 2.1

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v2.1 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the folder comments/includes/words/
- delete the folder comments/includes/emails/
- delete the folder comments/includes/language/
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

1.8 -> 2.0

As this is an upgrade to a major version, there are a few additional steps to take first. Ask on the forum if you're not sure.

a) The image captcha has changed to ReCaptcha. If you want to use it, sign-up for your API keys now.

b) The variables in the integration code have changed. Change $page_id to $cmtx_page_id, change $reference to $cmtx_reference, change $path_to_comments_folder to $cmtx_path (2 cases), and if you are using $parameters then change it to $cmtx_parameters. See the Integration guide, or the example.php file in the download package, as an example.

c) If you are using the Rich Snippets feature, remove any mark-up from your page as it is now fully built-in.

d) Make sure that in Manage -> Pages, the Custom ID column does not say "Not Set". If it does, edit the page and enter the ID value into the Custom ID field. (This only applies if you have been using Commentics since v1.0).

e) An extra sentence has been added in the 'Subscriber Notification' email. Upload (overwrite) the file /comments/includes/emails/your_language/user/subscriber_notification.txt from v2.0. Then add your signature to it using the Settings -> Email -> Editor.
1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v2.0 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- enter your database details in comments/includes/db/details.php
- delete the files in comments/includes/words/ except for admin_tips.txt
- delete the folder comments/includes/emails/
4. On your server set normal file permissions (644) for comments/includes/db/details.php
5. Upload the comments folder onto your existing comments folder to overwrite everything.
6. On your server set read-only file permissions (444) for comments/includes/db/details.php
7. Run the upgrade http://www.domain.com/comments/installer/
8. Log in to your admin panel and make sure everything is working.
9. Take the script out of maintenance mode (Settings -> Maintenance).

(There may be an accompanying blog post about files/folders which you can optionally delete.)


1.7 -> 1.8

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.8 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- enter your database details in comments/includes/db/details.php
- delete the files in comments/includes/words/ except for admin_tips.txt
- delete the folders in comments/includes/emails/ except for /dutch/
4. On your server set normal file permissions (644) for comments/includes/db/connect.php
5. Upload the comments folder onto your existing comments folder to overwrite everything.
6. On your server set read-only file permissions (444) for comments/includes/db/details.php
7. Run the upgrade http://www.domain.com/comments/installer/
8. Log in to your admin panel and make sure everything is working.
9. Take the script out of maintenance mode (Settings -> Maintenance).

1.6 -> 1.7

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.7 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the files in comments/includes/words/ except for admin_tips.txt
- delete the folders in comments/includes/emails/ except for croatian, slovenian and thai
- delete the folders in comments/agreement/ except for croatian, slovenian and thai
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

1.5 -> 1.6

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.6 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the files in comments/includes/words/ except for admin_tips.txt
- delete the folder comments/includes/emails/
- open comments/includes/db/connect.php and enter your database details.
4. On your server rename the new_comment_flag.txt file in comments/includes/emails/ to new_flag.txt
5. On your server set normal file permissions (644) for comments/includes/db/connect.php
6. Upload the comments folder onto your existing comments folder to overwrite everything.
7. On your server set read-only file permissions (444) for comments/includes/db/connect.php
8. Run the upgrade http://www.domain.com/comments/installer/
9. Log in to your admin panel and make sure everything is working.
10. Take the script out of maintenance mode (Settings -> Maintenance).

1.4 -> 1.5

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.5 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the files in comments/includes/emails/ except for language/admin/new_comment_flag.txt
- delete the files in comments/includes/words/ except for admin_tips.txt
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

1.3.5 -> 1.4

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.4 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the files in comments/includes/emails/ except for language/admin/reset_password.txt
- delete the files in comments/includes/words/ except for admin_tips.txt, banned_towns.txt, dummy_towns.txt and reserved_towns.txt
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

1.3 -> 1.3.5

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.3.5 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the folder comments/includes/emails/
- delete the folder comments/includes/words/
- delete the folder comments/includes/language/
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

1.2 -> 1.3

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.3 download, do the following:
a) Rename the admin folder comments/admin/ to match your renamed admin folder.
b) Enter your database details in comments/includes/db/connect.php
c) Delete the files in comments/includes/words/ except for admin_tips.txt and detect_links.txt
4. On your server set normal file permissions (644) for comments/includes/db/connect.php
5. Upload the comments folder onto your existing comments folder to overwrite everything.
6. On your server set read-only file permissions (444) for comments/includes/db/connect.php
7. Run the upgrade http://www.domain.com/comments/installer/
8. On your server delete the following files and folders:
a) comments/includes/language/comments.php
b) comments/includes/language/database_errors.php
c) comments/includes/language/form.php
d) comments/includes/language/page.php
e) comments/includes/language/processor.php
f) comments/agreement/privacy_policy.html
g) comments/agreement/terms_and_conditions.html
h) comments/includes/emails/admin/
i) comments/includes/emails/user/
9. Log in to your admin panel and make sure everything is working.
10. Add your signature to your emails (Settings -> Email)
11. Take the script out of maintenance mode (Settings -> Maintenance).

1.1 -> 1.2

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.2 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the folder comments/includes/emails/
- delete the files in comments/includes/words/ except for admin_notes.txt and admin_tips.txt
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).

1.0 -> 1.1

1. Put the script in maintenance mode (Settings -> Maintenance).
2. Back up your database (Tools -> Database Backup) and your files.
3. In the v1.1 download, do the following:
- rename the admin folder comments/admin/ to match your renamed admin folder.
- delete the folder comments/includes/db/
- delete the folder comments/includes/emails/
- delete the files in comments/includes/words/ except for reserved_emails.txt and reserved_websites.txt
4. Upload the comments folder onto your existing comments folder to overwrite everything.
5. Run the upgrade http://www.domain.com/comments/installer/
6. Log in to your admin panel and make sure everything is working.
7. Take the script out of maintenance mode (Settings -> Maintenance).