Okay, the Glossary moduleAn add-on, or extension, to Drupal to provide additional functionality; written in PHP. is not actually mine, but I have supplied a lot of patches lately and been given commit (update) authority.

---

Glossary helps newbies understand the jargon which always crops up when specialists talk about a topic. Doctors discuss CBC and EKG and CCs. Web developers keep talking about CSSCascading Style Sheet - a hierarchical means of specifying how to format HTML elements on the page, P2P, XSLT, etc. This can all be intimidating for newbies.

The glossary moduleAn add-on, or extension, to Drupal to provide additional functionality; written in PHP. scans content for glossary terms (including synonyms). The glossary indicator is inserted after every found term, or the term itself is turned into an indicator, depending on the siteA logically grouped set of content - also web site. settings. By hovering over the indicator, users will see the definition of that term displayed as a "tool tip." Clicking the indicator leads the user to that term presented within the whole glossary or directly to the detailed description of the term, if available.

The glossary uses Drupal

Drupal

An open-source content management system that is used on this site and is taking over the world.'s built in taxonomy feature, so you organize your terms in a Drupal

Drupal

An open-source content management system that is used on this site and is taking over the world. vocabulary. This allows you to create hierarchical structures, synonyms, and relations. Glossary terms are represented with the taxonomy terms in the glossary vocabulary. Descriptions are used to provide a short explanation of the terms. You can attach nodes to the terms to provide detailed explanation on the keywords.

Some background

The working part of the Glossary moduleAn add-on, or extension, to Drupal to provide additional functionality; written in PHP. is an implementation of Drupal

Drupal

An open-source content management system that is used on this site and is taking over the world.'s filter mechanism. As such it is not the fastest feature on your siteA logically grouped set of content - also web site.. To help speed it up, there is a separate cache ("cache_filter") to hold content that has already been processed so it need not be done each time that content is displayed.

The Glossary moduleAn add-on, or extension, to Drupal to provide additional functionality; written in PHP. will invalidate the filter cache any time a taxonomy term is added to, deleted from, or changed in an associated vocabulary or a setting is changed that would affect the display. You may manually empty the cache_filter table any time you like. Just be aware that there will be a temporary performance impact until the cache is rebuilt. This will, obviously, be more noticeable on a slower server.

Where to Put Terms

The words that are to be flagged by the Glossary moduleAn add-on, or extension, to Drupal to provide additional functionality; written in PHP. are defined as terms within the "Glossary" vocabulary. You'll find this under "Administer » Content » Categories" (in Drupal

Drupal

An open-source content management system that is used on this site and is taking over the world. 6, "Administer » Content » Taxonomy"). There you will see "Glossary" in the list of vocabularies. Next to it you will see a linkThe technique which points to another page, anywhere on the Internet, from the current page. to edit it.

You set up the vocabulary to define which content types will be scanned for glossary substitutions, such as "page" and "story." You also indicate if the vocabulary is hierarchical (usually not), has related terms, etc. [I recommend that "multi-select," "free-tagging," and "required" be left unselected.]

Usage note: If you choose a hierarchical vocabulary, be aware that the supplied CSSCascading Style Sheet - a hierarchical means of specifying how to format HTML elements on the page file only supports a depth of three (3). If your hierarchy is deeper, you should add additional formatting to deal with it.

Next you add terms to the vocabulary. You don't have to get them all at once; you can come back any time and add more.

There is no point in adding a term without a description - that's the whole point of the Glossary moduleAn add-on, or extension, to Drupal to provide additional functionality; written in PHP..

Full Node or "Detailed" Descriptions

Glossary runs on a taxonomy vocabulary and its terms. That means that there is a "Glossary" vocabulary to be used on the node types for which you have it set. Hopefully one of those types is either "page" or "story."

This had me confused for a while: You should not assign these terms to the nodes that will have the glossary flagged. Those who have done so have noticed that clicking on the indicator takes them to a "taxonomy/term" page for that term - listing all such tagged content.

The only content that should be tagged with the actual glossary terms are the "full node" descriptions. That way clicking on the linkThe technique which points to another page, anywhere on the Internet, from the current page. takes you to that full-node description. I would assume that the vast majority of the time there will be only one node assigned with those terms.

Authors

Originally written by Moshe Weitzman. Much help from killes.
Modified extensively by Al Maw.
Many improvements by Gábor Hojtsy
More improvements by Frodo Looijaard
More improvements by Moshe Weitzman again. And so it goes around ...
Additional fixes and improvements by Nancy Wichmann