---

Introduction
The mod adds a Glossary to your forum.  You can create Glossary items (ie, keywords and definitions) that are displayed in messages as a keyword tooltip containing the definition.

This mod uses the following JavaScript plugins (some with associated CSS).
- jQuery Tooltip plugin from jQuery UI (customised for this mod).
- jQuery SimpleModal plugin from SimpleModal 1.4.4 (updated for this mod).
- jQuery ContextMenu plugin originally from A Beautiful Site.
- famfamfam Silk icons available from Peacock Software.

Glossary for SMF 2.0
v0.3.1 - 25-Apr-09
o Create a Glossary consisting of keywords and keyword definitions for your forum community.
o Allow numeric keywords in addition to alphabetic keywords.
o Allow categories for grouping of keywords.
o Allow keywords to have synonyms.
o New BBCode to enable keywords to be inserted inline in messages.
o Option to allow keyword definitions to contain BBCodes.
o Tooltips:
  ~ Option to view keyword definition when hovering over keyword in a message.
  ~ Option for BBCode keywords to be not case-sensitive.
  ~ If a keyword is used more than once per message option to only display tooltip once.
  ~ Specify character to be used to insert line breaks in keywords definitions.
  ~ Support for tooltips with SimplePortal mod.
o Membergroup permissions to allow/disallow members to:
  ~ View the Glossary list.
  ~ Suggest new Glossary keywords with definitions.
  ~ Manage/administer the Glossary keywords, keyword definitions and categories.
o Glossary List Administration:
  ~ Keywords (with keyword definitions) can be:.
     * Added.
     * Updated (including being renamed and/or having synonyms added, updated, or deleted).
     * Deleted.
     * Approved.
     * Unapproved.
     * Have tooltip for keyword definition enabled.
     * Have tooltip for keyword definition disabled.
     * Assigned to a category (or no category).
   ~ Categories can be:
      * Added.
      * Updated (including being renamed).
      * Deleted.
o Enable a 'right-click' Glossary administration menu in Glossary ' Alphabetic/Alphanumeric' view (useful for large glossaries).
o Languages: French, English, and German.
o Mod setting to enable/disable mod.
o Mod setting to enable checkbox to enable tooltips for new/updated keywords by default.
o Mod settings to specify width of keyword/keyword definition columns in Glossary list.

---

Glossary for SMF 2.1
v1.0 - 09-Sep-24
o Hooks Only!!
o SMF 2.1.4 compatibility.
o Tooltips:
  ~ Improved processing of keyword for tooltip to remove 'http(s)://' from keyword to ensure tooltip is displayed correctly.
  ~ Line breaks in definitions displayed correctly without the need to use a custom line break character.
  ~ Option to only display tooltips for keywords that are inside a Glossary BBCode tag (ie, [glossary]Keyword[/glossary]).
  ~ Option to display tooltips in signatures.
  ~ Option to display tooltips in PMs.
  ~ Option to display tooltips in 'News' items.
  ~ Fixed bug where the case of whole/partial words used in definitions that contain keywords was changed to match the keyword case (eg, In the SMF 2.0 version of this mod if there was a 'RAM' keyword and the word 'mainframe' was in a definition it would be displayed as 'mainfRAMe' in a tooltip).
o Membergroup permissions to allow/disallow members to:
  ~ View Glossary tooltips in messages.
  ~ Insert Glossary BBCode in messages.
  ~ Not allow guests to manage/administer the Glossary.
o Glossary List:
  ~ Link to member profile for unapproved keywords (if guests are allowed to make keyword suggestions the word 'Guest' will be shown).
  ~ Mod settings to show keyword author to Glossary admins and/or all members who can view Glossary index.
  ~ Mod setting to only show alphanumeric characters with an associated keyword.
  ~ Mod setting to enable checkbox to approve tooltips for new/updated keywords by default.
  ~ Mod setting for definition column width removed.
  ~ Mod setting for category column width added.
  ~ Keyword synonyms shown below keywords.
     * If the synonyms mod setting is not enabled the word 'Disabled is shown at the top of the list of synonyms.
  ~ Synonym icon and tooltip removed.
  ~ Added 'right-click' context menu for Glossary administration to 'Categories' view.
o Option to make individual keywords case sensitive  Note: this will also make all the synonyms for the keyword case-sensitive.
o Synonyms:
  ~ Keyword checking to ensure keyword is not already in use as a synonym.
  ~ Synonym checking to ensure:
     * Synonym is not already in use as a keyword.
     * Synonym is not already assigned to another keyword.
  ~ Specific error messages for keyword/synonym conflicts.
  ~ Mod setting to display keyword and synonyms below keyword definition in tooltip.
o Improved disabling of mod features (eg, Glossary list [except for Glossary admins], membergroup permissions, BBCode, etc) when mod is not enabled.
o Updated error message reporting to provide SMF 2.1 compatibility.
o Updated jQuery Tooltip and SimpleModal scripts and/or CSS – customised to work with this mod.
o Updated installation process to use mod specific directories/folders for images, languages, CSS files, and scripts.
o Removal of support for SimplePortal mod.
o Removed unused strings from language file.
o Other bug fixes, performance improvements, and tweaks.
o Support for special characters in keywords and synonyms.
o Automatic Glossary integrity checking and alerting for keyword/synonym issues/conflicts.
o Languages: English.

---

Usage
This mod allows Glossary keywords to be displayed as tooltips (with their definition shown when hovering over/clicking on the keyword) in posts and other message types (ie, News items, PMs, and/or signatures).

---

Limitations when the use of the Glossary BBCode tag (ie, [glossary]Keyword[/glossary]) is optional
1. Although the use of the Glossary BBCode tag is optional using the mod this way may result in a noticeable increase in the time it takes pages to load when a forum has a combination of a large glossary, a large number of verbose posts on displayed topic pages, and/or is hosted on a low spec server/shared hosting.  The reason for this is that using the mod this way results in the need to check every word in every post (and other messages types) on a displayed page for a possible Glossary keyword match and to create the tooltip if a keyword match is found.

2. If a Glossary keyword/synonym is not marked as case-sensitive and it matches a HTML tag or text in another BBCode tag (eg, 'BR' matches the '<br>' tag, 'RED' matches the '[color=red]' tag) the matching string in the HTML tag/BBCode tag will be displayed as a Glossary keyword/tooltip.

3. The Glossary list is processed in alphanumeric order and, if a keyword has synonyms they are processed before the next keyword, and as a result keywords/synonyms may not always have the expected definition shown in their tooltip.
Scenario A. Keywords/synonyms that contain special characters and which are a substring of another keyword/synonym:
Keyword: Ali'i with definition: Chief or leader
Keyword: Ali'i's Home with definition: In the village ...
If the use of the Glossary BBCode tag is optional the keyword Ali'i's Home will always have the definition of the keyword Ali'i in a tooltip (ie, even if Ali'i's Home is enclosed in the Glossary BBCode tag).

Scenario B: Single/multi word keyword/synonym that is a substring of another single/multi word keyword/synonym:
First example: The keywords 'Submarine' and 'Yellow Submarine' have been added to the Glossary.
If the use of the Glossary BBCode tag is optional the tooltip for the phrase 'Yellow Submarine' will always contain the definition for the 'Submarine' keyword (ie, even if 'Yellow Submarine' is enclosed in the Glossary BBCode tag).
Second example: The keywords 'Big Boat' (with a synonym of 'Yellow'), 'Submarine' and 'Yellow Submarine' have been added to the Glossary.
If the use of the Glossary BBCode tag is optional the tooltip for the phrase 'Yellow Submarine' now will always have TWO tooltips: the definition for the 'Yellow' synonym of the 'Big Boat' keyword AND the definition for the 'Submarine' keyword.

---

Use of special characters in keywords/synonyms
Most special characters (ie, except for <, >, =, /, \, ", and leading apostrophes) and trailing apostrophes are supported in keywords/synonyms.

'Smart' quotes are not supported in keywords/synonyms and the use of other typographic characters (see Common HTML entities used for typography in keywords/synonyms may cause issues and/or make them difficult to use.

---

Other limitations/known issues
The use of the http:// or https:// strings is not supported in keywords, synonyms or definitions.

---

Fonts
The fonts used for displaying Glossary keywords and/or definitions are defined as follows:
 
Font family for displaying definitions shown in tooltips:
.ui-widget in ./Themes/default/css/glossary/glossary.ui.tooltip.css

Font family for displaying keywords/definitions in the Glossary list:
.glossary_keyword_def in ./Themes/default/css/glossary/glossary.css

To change between a serif font and a sans-serif font change the order of the font-family lines and clear the forum cache (you may also need to disable the Administration Center > Features and Options > General > Minimize CSS and JavaScript files option if this is enabled).

---

Release History:
1.0 : 09-Sep-24
o Initial release.

1.1 : 20-Sep-24
o Bug fix for issue with URLs in BBCode tags.

1.2 : 26-Sep-24
o Added option to exclude messages in specific boards from Glossary use.
   ~ To make it easier to identify board IDs this mod can optionally show them before the board name in the 'Manage Boards and Categories > Modify Boards' list.
o Minor performance/reliability improvements.

1.3 : 28-Sep-24
o Fixed tooltip corruption issue reported by JRMBelgium that occurred in a very specific of circumstances if the 'Show keyword and synonyms below definition in tooltip' option was enabled.
o Minor performance/reliability improvements and layout changes.

1.4 : 24-Oct-24
o Parsing code for processing Glossary keywords in messages completely rewritten by live627 - it's now amazingly fast!
o Added mod setting to give option to convert the line separator character(s) in the description to line breaks when editing the keyword.
o Glossary list:
   ~ Added option to enable tooltips to only be shown when individual keywords (and their synonyms) are inside the Glossary BBCode tag - previously this was only available as a global setting.
   ~ Convert the line separator character(s) in the description to line breaks when displaying keywords if the associated mod setting is enabled.
   ~ Show the total number of keywords and synonyms (plus numbers of keywords/synonyms with non-default settings).
   ~ Show non-default settings for keywords (ie, not approved, not shown as tooltips, case sensitive, and tag only) below settings icons.

1.5 : 16-Nov-24
o Bug fix for issue with synonyms that occurred when adding the very first synonym to a Glossary.

---

License
Copyright 2024 Kathy Leslie, 2024 John Rayes.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

This software is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright holder or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

Glossary_SMF2.1-v1.3.zip 144.08 KB v1.3 2.1.4

Glossary_SMF2.1-v1.5.zip 150.11 KB v1.5 2.1.4

Manual installation info 2.1.4