CM Tooltip (CMTG) - Free Version Tutorial
Tooltip Glossary Free Version Tutorial
This article covers only features present in the free version of Tooltip Glossary.
CM Tooltip Glossary
This plugin shows you how to set up a tooltip such as this:
Table of Contents
Here are the steps needed to install the plugin:
- Download - To manually install the plugin, you must first download it from WordPress.org to your computer.
- Navigate to the Plugins tab in the WordPress Admin Panel to install the plugin.
- Activate the plugin.
Once the plugin is active you can find the plugin settings under the CM Tooltip Glossary menu:
If you like, you can register your plugin to receive information about updates and our latest offers. You can complete your registration at any time.
If you don’t want to register right away, you can select the Skip button.
- How The Plugin Works
- Permalinks - Why they are important
- Upgrading from Free to Pro and between Pro Editions
- Basic TroubleShooting
List of Features Present in the Free Version
- Automatically generates a Glossary index of terms. Example.
- Ability to show your Glossary index list as a list or as tiles:
- Each glossary term has its own unique post, just like regular WordPress posts or pages.
- Tooltip windows can optionally appear when a term is hovered over by the cursor.
- Term pages can optionally be linked directly from posts or pages.
- Includes several filters to optimize the tooltip window and limit the length of the description that is displayed.
- Prevents the glossary from parsing text, when needed, by using a Shortcode
[glossary_exclude] text [/glossary_exclude].
- Supports custom excerpts (if they exist) as the text that appears in the Tooltip window.
- Controls the location and area where the tooltip appears (pages, posts, homepage).
- Controls the settings in cases where the tooltip appears more than once.
- Supports UTF-8.
Using the Plugin
Note: For your tooltip to work, you may need to save your WordPress permalinks.
- The plugin automatically creates a page that works as a glossary of terms. This page is called the Glossary Index Page.
- Select the CM Tooltip Glossary menu item in the admin panel:
- The most important action is adding terms. Do this by clicking on the “Add New” link. Glossary Terms can be created and edited using the WordPress editor, just like any other post on your site.
- Terms can contain title, description, and excerpt. Multimedia content, such as images and videos are only displayed in the premium versions of the plugin.
- Click Glossary to manage all your terms:
- You can customize some of the behavior of the plugin by adjusting the settings.
Warning: The free version of the Tooltip Glossary plugin has a limit to show only 500 terms on the Glossary Index Page, for performance reasons. In all of the Pro editions, the issues have been solved and this limitation is lifted.
You can access the settings in the path Admin Panel → CM Tooltip Glossary → Settings.
-To learn more about an option, you can hover over the blue icon with the question mark.
In this tab you can choose the ID of the Glossary Index Page, where to highlight terms and which terms to highlight.
Glossary Index Page ID and Glossary Terms Permalink
When the plugin is installed, a Glossary Index Page is created for you automatically. The name and slug of this page is glossary.
In this setting, you can select any existing page to use for your Glossary Index Page. And if you check the box "Generate page for Glossary Index", a new page is created, but you must remove the old glossary page which was created by the plugin. Select -None- in the drop down if you do not wish to have a Glossary Index Page.
You can can change the Glossary Terms Permalink for example if you wish to translate it to a different language. When changing the permalink, be careful not to use a link that already exists.
Where to show the term link and tooltip
The are several settings that helps you select where to highlight the term. You can choose to disable the highlights on posts or pages, or on archives.
The Highlight first term occurrence only? option prevents the term from being highlighted more than once.
Here you will find two settings that may help solving conflicts with themes or other plugins.
Only highlight on "main" WP query?
Some themes are using more than one query on each page (for example, a theme that has a slideshow and also lists your latest posts).
When this happens, it results in the terms being parsed only on the first query and not on the main query which outputs the actual post or page content on the screen. Enabling the option solves this problem.
Important: This is most often the case in sites that uses page builders. If you are using a page builder and are experiencing problems, please enable this option.
You can try to uncheck this setting if terms are not being highlighted at all (although you're sure the page/post contain the term).
Run the function outputting the Glossary Index Page only once
- In extremely rare cases the Glossary Index Page appear multiple times on the same page.
Checking this checkbox will ensure that it will be displayed just once.
You may need to enable this option if you are also using the Jetpack plugin. Read more.
Refer new users to any of the CM Plugins and you'll receive a minimum of 15% of their purchase! For more information please visit the CM Affiliate page.
Glossary Index Page
You will find a handy link to the Glossary Index Page above your settings tabs:
This tabs allows you to style the Glossary Index Page.
- The first options allows you to use the CSS class
glossaryLinkMainto style the links on the Glossary Index Page separately; otherwise, they will retain the class
glossaryLinkand will be identical to the linked terms on all other pages. -You can add the custom styles to your themes stylesheet, or in the Additional CSS option in the WordPress Customizer.
- You can choose to show the index in the classical view (as a simple list of terms) or as tiled list.
CM Tooltip Glossary Pro Glossary Index
Note: Premium versions have over 10 different views. Read more.
This tab affects the Glossary Term Page and the link that is available when the visitor hovers over a term in the post or page content.
Here you can choose to open the glossary term link in a new window, or remove the link.
The option Show HTML "title" attribute for glossary links adds the term to the link's title attribute. In this example, the tooltip is the box with the dark background, and the box with the light background is the link's title attribute:
The Show back link on the bottom option adds a link to the Glossary Index Page to the bottom of the term page:
Finally, this tab allows you to modify the behavior of the tooltip. You can hide the tooltip or choose the length of the text that is displayed.
If the option Use term excerpt for hover? is enabled, the terms custom excerpt, -as entered in the WordPress editor excerpt field, will be shown instead of the content of the post.
Clean tooltip text? This option will trim things like extra spaces from the text.
Avoid parsing protected tags? This option is enabled by default, and it prevents Scripts and Objects from being loaded in the tooltip.