Terms Infusion (Dictionary/Glossary) v1.01
PHP-Fusion: v6.01.12
original author: muscapaul
email: muscapaul@gmail.com
web: www.muscapaul.com
date: 17.10.2007
--------------------------------------------------
Copyright: Released under the terms and conditions
of the GNU General Public License (Version 2)
--------------------------------------------------

FEATURES
--------
* This infusion provides the possibility to build a glossary or dictionary with your own chosen terms.
* The infusion mode (Glossary, Dictionary and Default [no choice between the former two made]) can be changed in the infusions's General Settings.
* The terms can be categorized in categories of your own definition.
* Translations/descriptions can be formatted using BBcode (with the exception of [img] [/img]).
* Members can submit terms that will be assigned a status 'Submitted'. The submitted terms can be placed in the approriate category or, if this one is not present, in the category 'Submitted' (which is created upon infusion). Selected users (usergroup, Superadmin by default) can publish submitted terms by changing the term status and transfering it to the appropriate category. A list of terms that were submitted and not yet approved can be seen by choosing the 'Submitted terms' in the drop-down menu 'Show Synonyms'.
* Visibility access can be set for each separate category (enabling 'premium access' to categories for members, if so desired).
* Individual terms can always be commented on, allowing suggestions for alternative translations/explanations.
* Terms can be designated as synonyms with fixed format with a link to the correct word. If a certain term is synonymic with two different terms (homonymy), then a synonymy category with free format can be assigned, allowing redirection to the different terms in the way you choose.
* Ratings system for individual terms optional (general setting by default set to off).
* Maximum number of displayed items on a page can be changed by the visitor (default: 20; other options: 5, 10, and 50).
* Visitor can choose to view lists with or without the synonyms.
* Upon infusion a Dictionary/Glossary link is added to the Navigation panel.
* A panel can be added that shows the number of submitted Terms including a link to a page with the submitted terms.
* Separate instructions are provided to allow the use of [glos] tags that will lead to the page with the term enclosed between the tags (if created). Primarily aimed at the Glossary but can be used in the Dictionary, too.

CHANGED FILES
-------------
None, unless [glos] tags will be used. See separate instructions.

COMMENTS
--------
* The skeleton of this infusion was the Advanced Download DB V2.10 by Giuseppe Nichelini (nick56). Lots of redundant code were removed (uploading files, images, etc.), new code was added and some parts were recoded (for example to set access levels).

INSTALL
-------

READ BEFORE INFUSION
In the terms folder in the package you will find three infusion files: infusion.php, Glossary_infusion.php and Dictionary_infusion.php. The first will infuse this infusion without a choice being made whether the infusion will be used a Dictionary or as Glossary. The selected locale files are drafted similarly, giving double descriptions (like 'Terms/Words'). The database information stored (Site Link, infusion information) is similarly drafted.
You can change between the different uses at any time by changing the setting in the General Settings. However, the title information stored in the database is not updated accordingly. So, it is recommended that you decide on the use of the infusion before you infuse it. If you want to infuse it as Glossary or Dictionary, rename infusion.php to Default_infusion.php and rename either Glossary_infusion.php or Dictionary_infusion.php to infusion.php.
If you decide you want to test the infusion first, you can still add categories and terms/words to the database. At any time when you to change the type of the infusion (from default to Glossary, or from Glossary to Dictionary) and make sure that titles in the database are reflecting this, you make a backup of the [fusion]_term_cats and [fusion]_terms tables. Next you defuse the infusion and re-infuse it with the correct infusion file.

1. Copy the contents of the php-files folder to the corresponding folders on your server after you have decided on the infusion type (see above).

2. Go via Admin Panel -> System Admin to Infusions and install the Terms infusion.

(If you have decided to infuse the infusion as Glossary, continue at step 4. If you ever decide to change from Glossary to the Dictionary, you need to go through step 3 at that time.)

3.  Go via Admin Panel -> Infusions to Terms and click the Terms General Settings button. Default language to translate from is the Site Language. Change this if necessary. No language is set to translate to. This should be set now. If so desired, change the setting to allow rating of terms.

4. Go via Admin Panel -> System Admin to Panels and create a new side panel. From the Panel Filename drop-down menu choose 'term_submissions_panel', give it an appropriate panel name (e.g., Term Submissions) and set the appropriate access. Save the panel, go back to Panel Management and enable the panel. Reposition as desired.

CHANGELOG
---------
v1.01
* Modified core file ../maincore.php updated for PHP-Fusion v6.01.12.

v1.00
* Modified core files (maincore.php and for forum) updated for PHP-Fusion v6.01.10.
* Removed a superfluous html tag from terms_settings.php.

v1.00 (rc1_19012007)
* Removed some layout niggles for the Terms page and the Admin page.

v1.00 (beta_14112006)
* Separate infusion files updated so that they should work under all MySQL versions.
* Two table format errors on admin pages corrected.
* Missing admin access to Term Categories fixed for Term admins that are not Site admins.
* Bug fixed so that submitted (and thus unapproved) terms are no more visible to all members but only to Terms admins.

v1.00 (beta_06102006)
* Modified maincore.php updated for PHP-Fusion v6.01.6.
* Some code cleaning to comply with W3C standards (hopefully finished).

v1.00 (beta_26092006)
* JavaScript code for button 'Back to previous page' when viewing a single terms made compatible with all major browsers.
* Some code cleaning to comply with W3C standards (not yet finished).

v1.00 (beta_25092006)
* Modified maincore.php updated for PHP-Fusion v6.01.5.
* Bug in page navigation when sorting by starting letter/number fixed.

v1.00 (beta_25072006)
* Link in term_submissions_panel.php adjusted so that the full list with submitted terms is shown, rather than just the list of terms in the category 'Submitted'.

v1.00
* None (first release)

TO DO
-----
* Introduce some kind of image management.

CONSIDERED
----------
* Adding a search function?