Upgrading THCNET
THCNET 1.1.0.4 upgrade documentation.
Upgrading THCNET
from all versions:
copy the lib/ directory, as well as all the root level php files into thcnet directory open the thcnet.php file in your browser and the database will be upgraded automatically.
From 1.1.0.2
With the introduction of 1.1.0.4, the location of the default templates has been moved from the root directory to the themes/standard directory. The database upgrade will change the location of the "standard" template, if it exists, to "/themes/standard/"
copy the themes/ directory into your thcnet directory, in order to use the standard template set.
From 1.1.0.0
There was an undocumented "p" macro condition, which was included in the default thcnetmenu.template. Change this to an "m" or copy the updated thcnetmenu.template.
This version also removed the old disabled url session code, so if your templates contain the macro %%session%%, you'll need to remove it from there. thcnetmenu.template was the only one which still had references to it.
Note: As of version 1.1.0.1, all versions with the format 1.0.pre## were renamed to 1.0.0.## to reduce confusion in naming.
From 1.0.0.23
We've added selectable theme support. So you can now define multiple system template sets. It creates the default system template by copying what is currently configured, and moving it's configuration into the template system. Update your user template to take advantage of the new %%inputtemplate%% macro. Administer your new templates user the Template Definition section.
From 1.0.0.22
We add in an article rating system. Update your thcnetarticle.template. See the packaged version for an example.
From 1.0.0.21
This version introduces auto-signatures. There are some changes with the userinfo template if you want to enable this function. The quickest way to enable this is to edit the thcnetuser.template and thcnetusersignature.template for your use on your system.
The ability for users to add, edit, and delete signatures is enabled when you add the %%signatureform%% your userinfo template. This inserts the contents of the usersignature template for each signature a user has. In this template insert the macros %%inputdeletesignature%% and %%inputsignature%%. Then lastly in the userinfo template add the %%submitaddsignature%% macro to insert a button that lets the user add additional signatures.
Take a look at the thcnetuser.template and thcnetusersignature.template for an example of how this is setup.
Note if you decide to disable the ability to edit multiple signatures, this does not remove the additional signatures from the database.
From 1.0.0.20
This version introduces an updated spell check function that uses the PHP pspell libraries. You need to make sure PHP is compiled with these libraries to take advantage of the new spell checking function. THCNET requires that it has the ability to write to the pers-dict directory off the root THCNET directory. It will try to create this directory if it doesn't exist, though the web server must have write access to the THCNET directory to do this.
This version also has a completely rewritten search routine. There is a configuration variable to specify the mysql fulltext minimum word size, to display a warning when users search for worders shorter in lenght than this.
There are three new templates relating to searching.
thcnetsearch.template container for basic search results. thcnetadvancedsearch.template container for advanced search results and advanced
search form.
thcnetsearchresult.template search result template for each returned item. thcnetmenu.template has been updated to include the link to the
advanced search.
Copy these templates into the thcnet directory and modify them for your needs.
From 1.0.0.18
This update takes a long time to reprocess the message text. be patient. A lot of insertion of html breaks in the code have been removed in favor of inserting them where desired in the templates. look at the new CSS thcnet templates for an example.
From 1.0.0.11
A new template for posting has been added. Copy the file thcnetpost.template into the thcnet directory and modify it for your needs.
an option to delete messages when deleting a user has been added. Replace, or look at thcnetuser.template for a configuration example.
From 1.0.0.10
Navigation has been moved to a macro. Insert %%navigator%% in your thcnetpage.template
From 1.0.0.9
Replace %%menupicks%% with %%include,"thcnetmenu.template"%% in the thcnetpage.template Replace %%calendar%% with %%includephp,"calendar.php"%% or %%include,"calendar.html"%% read the changelog.txt, there are a lot of new things that 1.0.0.10 can do.
From 1.0.0.8
The template/macro system has been massively updated. Refer to the macro.txt file for a list of all the macros and their uses, as well as the template files for an example of the macros in use.
From 1.0.0.7
There were some cosmetic changes in this release. Most notably, the "articlenewcolor" configuration item has been removed, and it's functionality moved into the cascading style sheets with a new class called menunew. Update your style.css file to include the definitions for that class if you want to change how the *New* link on new messages appears.
One other change is the Main Page and First New links on the article subpage display now use the CSS menu class, so you should be aware that their coloring will change to whatever you have that set to.
The sysinfo function has been update to use CSS as well. System messages are surrounded by paragraph tags with the CSS sysinfo class. Error messages are surrounded by bold tags with the CSS syserror class.
The system now has configurable images per message base, aka slashdot. If you want to use this feature, update your article template to include the tag %%articleimage%% where you want the image to be located.
See the distribution style.css file for details.
There were a ton of other updates to the usertemplate, userlisttemplate, menutemplate, articletemplate. See the changelog.txt for information as to what was added.
From 1.0.0.6
Update your thcnetpage.template and thcnetsubpage.template insert the function %%info%% on a line by itself. See the thcnetpage.template for an example of how this should be done
Update your thcnetuser.template add the functions %%userupdatelastread%%, %%userresetlastread%%, and %%userdumplastread%% see the thcnetuser.template for an example of how this should be done
Update your thcnetmenu.template add the function %%menulastread%% see the thcnetmenu.template for an example of how this should be done
Upgrading MySQL
A note when upgrading from MySQL 3.22 to 3.23:
Mysql changes the default table type from ISAM to MyISAM, and thus breaks the internal table cleanup/optimization in the thcnet code. The code will still function correctly. In fact It was a good 6 months before I noticed there was a potential problem. To fix you just have to use the alter table command to convert the table types to MyISAM..
ALTER TABLE [tablename] TYPE=MyISAM;
I'll be making an automated fix for this in the future once I figure out how to check for the version of mysql running.
