TNG 13.x Upgrade

(From v.11.x )

Installation Instructions

1. Back up settings and custom files, other preparation.   |   Show instructions

   If you haven't done so lately, please make a backup of the following important files before proceeding (you might need them later, even if nothing goes wrong here):

   • config.php (general settings)
   • *footer.php or footer.html (custom footer)
   • importconfig.php (import settings)
   • *index.php or index.html (your home page!)
   • logconfig.php (log settings)
   • mapconfig.php (map settings)
   • meta.php (custom meta data & scripting)
   • mmconfig.php (mod manager settings)
   • *css/mytngstyle.css (style sheet)
   • pedconfig.php (pedigree settings)
   • templateconfig.php (template settings)
   • *topmenu.php or topmenu.html (custom header)

   *A note on the custom header, footer, home page and mytngstyle.css stylesheet: If you're using a post-8.1.0 template, remember that the files you'll want to back up are the ones in the templates/template# folder (where # is the template number). If you never customized these files directly, then you don't actually need to back them up.

   You might also want to back up your database tables (using Admin/Utilities), your table structure (same place), and any TNG files that you may have altered, although the risk for data loss during this upgrade is very minimal.

   
   

2. Uninstall all mods.   |   Show instructions

   If you previously installed any mods with the Mod Manager, uninstall all of them before proceeding with the upgrade.

   1. in Admin > Mod Manager, select Installed and click the Go button
   2. on the Installed selection screen, click the Select All button and then click the Uninstall button
   3. Select Partially Installed and click the Go button
   4. on the Partially Installed selection screen, click the Select All button and then click the Clean Up button
   5. When you return to the Mod List, the All mods screen should show all the mods as Ok to Install or Cannot Install
   6. If any mods cannot be reinstalled, check here for updates: https://tng.lythgoes.net/wiki/index.php?title=Category:Mods_for_TNG_v13

   When the upgrade is complete, you may reinstall if needed. Look for updated versions of any that are not ready to be immediately reinstalled.

3. Upload the files and folders.   |   Show instructions

   Upload all the files and folders (except the "special" and "templates" folders, which will be covered later) to the main TNG area on your web site. For many of you, the main TNG area will be the "public_html" folder. Be sure to overwrite existing files that have the same names. Note: The folders contained in this zip file do not contain all of the files that are supposed to be in the same folders on your site. Only files that have changed since the last release are included. If your upload program will erase the unchanged files when you upload these smaller folders with the same names, then be sure to merge the folders instead.

4. Open this readme file from your site.   |   Show instructions

   If you previously opened this file from your local computer, close it now and open it again from your web site (for example, "http://www.mysite.com/readme11x-13x.html"). Use a browser, not an FTP program! The file should be among the files you just uploaded.

5. "Special" Files   |   Show instructions

   Some of your upgrade files should have unzipped into a folder called special. Read below to see if you should upload the files included there. If you do need to upload those files, they should go in your main TNG folder. Do not upload the "special" folder itself to your site.

   1. subroot.php. If you've decided to store your config files somewhere other than in the main TNG folder, this file keeps track of that location. If you've never moved your config files, then you can upload and overwrite the subroot.php file without worry. If you're already keeping your config files elsewhere, then you can upload the file and just re-enter the config location in your General Settings (go there first and copy it), or you can manually insert the config location the appropriate spot in this file and then upload it.

   2. tngrobots.php. This file attempts to tell Google and other search engines which files to index and which ones to ignore. If you've never touched it, then go ahead and upload it. Otherwise, merge in your changes first.

   
   

6. Templates   |   Show instructions

   Most people: If you're using a template and haven't changed any of the actual template files, or if you're not using a template at all (but might in the future), then upload the entire templates folder included in this upgrade.

   A few of you: If you have altered any of the files in your template folder, then upload everything in the templates folder that you haven't changed (all the templates you're not using, and all the files from your template that you haven't touched). You should then consider merging your changes into the remaining files. NOTE: Many of the template home page, header and footer files have been updated to include mobile support. In order to experience those features, you will need to incorporate the latest changes to these files.

7. Update the database structure.   |   Show instructions

   Click this link: upgrade_db11x-13x.php. That operation will open a new window and make a few database structure changes. Your data should not be affected. You will see a short list of messages detailing what is being done, as well as a message when the script has finished. When the operation is complete, you can remove the upgrade_db11x-13x.php file from your site if desired.

8. Convert image maps.   |   Show instructions

   TNG 13 has improved image tagging. To convert your old HTML image maps to the new method, click here (optional): upgrade_convert_image_maps.php.

   Note: If you are using the Tooltip mod with image maps and want to continue using that method, you may want to skip this step for now.

   
   

9. Clear your cache.   |   Show instructions

   It isn't always necessary, but if things aren't working properly after the upgrade, it could just be that some of the old files or pages are still stuck in your browser cache. Before asking for help, please clear your cache and check your results again. If you need help figuring out how to do this, please see this page on the TNG wiki: http://tng.lythgoes.net/wiki/index.php?title=Bypassing_Browser_Cache.

   
   

NOTES:

1. If you have your config files in a different folder, please copy the pedconfig.php file included with this upgrade into that folder, overwriting the existing file with that name.
2. Depending on the template you're using, you may have some new links or paragraphs on your home page. Go to the Template Settings to customize these (or blank them out if you want to remove them).
3. If you are using the Mod Manager (or might use it in the future), go to Admin/Mod Manager and run the Recommended Updates script to update you cust_text.php files.

The update should be complete. You did it! If anything doesn't look right, please try the following before asking for support:

1. Review all the instructions again. Make sure you didn't miss something!
2. Try clearing your browser cache again, then refresh the page.
3. Repeat any step(s) you think you may have missed. You can't break anything by doing it again.

Convenience Links:
Go to your home page
Go to the Admin menu (address is now "admin.php" instead of "admin/index.php")