Tooltip Taxonomy
This module allows you to automatically add explanatory tooltips to taxonomy terms on your website. You can configure these tooltips to appear on specific pages, content types, view modes, or fields, providing a way to clarify ambiguous terms and enhance user understanding.
This module delivers a capability to attach explanation tooltip to taxonomy terms automatically. You can specify which taxonomies will have the explanation tooltip in certain pages, content types or all page across entire website. You also can apply the tooltip to certain field rather than all text fields. It also provides a solution to cope with ambiguous terms.
Features:
- Specify taxonomy tooltip by path, content types, view modes and fields.
- Ambiguous terms.
- Attach tooltip automatically.
- Simple accessible tooltip compatible with all browsers.
- Compatible with entities other than node.
Requirement
- Drupal 9.3 or greater
- PHP 7.0 or greater
Installation
Install this module using the normal Drupal module installation process.
This module uses pure CSS tooltip solution which has been included in, you don't need to install any other library.
Configuration:
- Go to the configuration page: /admin/config/content/tooltip_taxonomy
- Create filter conditions for explanation tooltip using one or multiple vocabularies attached to certain path, content types, view modes or fields.
- For ambiguous meaning taxonomy terms, you need to create respective filter condition for each meaning with different weight value. The one has greater weight value will overwrite those have lesser weight value. For instance, taxonomy term of 'CMS' has different meaning in different pages or content types or fields. You can create a filter condition with a less weight applied to all pages across whole site that has a general meaning, for example CMS means 'Content Management System' in most of pages. But in certain pages or content types or even fields, CMS means something else. Then you can create another filter condition using different vocabulary with greater weight that will overwrite the general meaning in specific pages or fields.
- Format HTML limit filter setting: In order to make the tooltip working, the span tag and class attribute must be allowed for those text fields. You can go to the text format setting UI to check and update them. For example, you can to go '/admin/config/content/formats/manage/basic_html' and add following into the 'Allowed HTML tag' settings.
<span class="tx-tooltip tx-tooltip-text">
See the screenshot attached for this example.
User guide: Configuring Text Formats and Editors
If you are using CKEditor 5, the allowed tags is configured by the CKEditor. By default, you don't need to change it as the 'span' tag is allowed by default. - The taxonomy term using for a tooltip has to be published.