=== Clever Linked Terms ===
Contributors: jealbr75
Tags: glossary, internal linking, tooltips, semantic linking, terms
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create a smarter WordPress glossary with automatic linking, tooltips, semantic relationships, term maps, and FluentCommunity support.

== Description ==

Clever Linked Terms is a WordPress glossary, automatic linking, and semantic relationship plugin for content-heavy websites, documentation libraries, communities, learning platforms, knowledge bases, and editorial sites.

Create glossary terms, automatically link important phrases in your content, show helpful tooltip previews, publish a polished glossary index, and optionally enable deeper semantic tools through Terms Engine.

Version 1.1.0 is the largest Clever Linked Terms release so far. It moves the plugin beyond a basic glossary and into a more complete semantic linking system for WordPress and FluentCommunity.

= What You Can Build =

With Clever Linked Terms, you can:

* Create a public glossary of important terms.
* Automatically link terms inside selected WordPress content.
* Show tooltip previews when visitors hover linked terms.
* Publish a searchable A-Z glossary index.
* Create single term pages with definitions, sources, categories, and tags.
* Add semantic relationships such as synonyms, aliases, abbreviations, and variations.
* Use optional Terms Engine tools for term health, conflicts, maps, link rules, and semantic organization.
* Support FluentCommunity portals with SPA-aware glossary linking.
* Track glossary engagement with optional analytics.
* Import and export glossary data through CSV/XML workflows.

= Core Glossary Features =

Clever Linked Terms includes the essential tools needed to create and manage a useful glossary:

* Glossary term content type.
* Public single term pages.
* Tooltip summaries.
* Full WYSIWYG definitions.
* Dedicated Sources field.
* Term categories.
* Semantic tags.
* Automatic linking in selected WordPress content.
* Exclusion controls for posts, pages, and terms.
* Public glossary index shortcode.
* Multiple glossary index layouts.
* Sticky A-Z navigation.
* Custom glossary index slug.
* Custom glossary index title.
* Optional leading-word sorting, such as sorting “The Odyssey” under “O.”
* Configurable tooltip and glossary styling.

= Terms Engine =

Terms Engine is an optional semantic control center for Clever Linked Terms.

When enabled, it adds deeper tools for managing relationships, possible issues, maps, and advanced glossary structure. Terms Engine is modular, so individual features can be turned on only when needed.

Terms Engine modules include:

* Semantic Relationships.
* Relationship Phrase Linking.
* Term Health & Conflicts.
* Admin Term Map.
* Public Term Connections.
* Glossary Knowledge Map.
* Tag IQ.
* Bulk Tools.

When Terms Engine is disabled, related menus, fields, maps, conflict tools, relationship panels, and public connection widgets do not load.

= Semantic Relationships =

Clever Linked Terms can organize alternate phrases around a canonical term.

Supported relationship types include:

* Synonyms.
* Aliases.
* Abbreviations.
* Variations.

These relationships help you connect different ways people refer to the same idea without creating duplicate glossary entries.

For example:

* “SEO” can point to “Search Engine Optimization.”
* “FCom” can point to “FluentCommunity.”
* “plug-in” can point to “plugin.”
* “The Odyssey” can display normally while sorting under “O” in the glossary index.

Relationship phrase linking is optional and includes global controls, per-type controls, and per-term override settings.

= Term Health =

Term Health helps you review glossary quality and relationship conflicts.

It can help identify:

* Possible duplicate relationship phrases.
* Relationship phrase conflicts.
* Terms that may need editorial review.
* Missing or weak content.
* Issues that should be marked clear or reopened later.

Term Health uses “Possible Issues” language so warnings are treated as review items rather than automatic failures.

= Term Maps =

Clever Linked Terms v1.1.0 introduces map-based views for exploring term relationships.

Map features include:

* Admin Term Map for editors.
* Public Term Connections for visitors.
* Glossary Knowledge Map on glossary index pages.
* Focused term maps.
* Clickable map nodes.
* Connections based on shared tags, shared categories, and relationships.
* Lazy-loaded public maps for better performance.

The Glossary Knowledge Map is hidden behind a smooth “View glossary map” launcher so it does not take over the page by default.

= Term Studio =

Term Studio is the structured editor experience for glossary terms.

It supports:

* Term title.
* Slug.
* Status.
* Scheduled date.
* Tooltip summary.
* Full WYSIWYG definition.
* Sources.
* Categories.
* Tags.
* WordPress exclusions.
* FluentCommunity exclusions.
* Terms Engine relationship fields when enabled.

Supported statuses include:

* Published.
* Draft.
* Scheduled.
* Pending Review.
* Private.
* Trash.

= Term Manager =

Term Manager provides a cleaner card-based way to browse and manage larger glossaries.

Features include:

* Search.
* Status filters.
* Published, Draft, Scheduled, Review, and Trash views.
* Pagination.
* Terms-per-page selector.
* Cleaner actions.
* Conflict badges when Term Health is enabled.

This helps larger glossaries avoid loading every term at once.

= Glossary Index =

The glossary index can be generated from the settings screen or added manually using:

`[clevlite_linked_terms_index]`

Glossary index features include:

* Custom index title.
* Custom index slug.
* Search.
* A-Z navigation.
* Multiple layouts.
* Optional auto-linking inside glossary card content.
* Optional glossary knowledge map.
* Sticky navigation offset handling for themes with sticky headers.
* Leading-word sorting controls.

Available layouts include:

* Modern Cards.
* Compact Directory.
* Split Index.
* Minimal List.
* Feature Grid.
* Glossy Panels.
* Knowledge Base.

= Single Term Pages =

Single term pages can display:

* Term title.
* Definition.
* Tooltip summary.
* Sources.
* Categories.
* Tags.
* Relationship chips.
* Public term connection map.
* Back to glossary button using the configured glossary index title.

Available layouts include:

* Theme Default.
* Clean Card.
* Hero Card.
* Split Panel.
* Resource Hub.
* Editorial.
* Minimal Modern.

= FluentCommunity Support =

Clever Linked Terms includes optional FluentCommunity compatibility.

When enabled, it supports glossary linking inside FluentCommunity’s Vue/SPA portal behavior.

FluentCommunity support includes:

* SPA-aware processing after route changes.
* Feed and space content linking.
* Tooltip support inside community content.
* New-tab behavior for glossary links so members do not lose their place in the community.
* FluentCommunity-aware analytics context when analytics is enabled.

FluentCommunity is optional and is not required for normal WordPress glossary linking.

= Analytics Add-On =

The optional Analytics add-on can track glossary engagement.

Analytics can record:

* Impressions.
* Clicks.
* Matched text.
* Canonical term.
* Relationship type.
* WordPress or FluentCommunity context.
* Recent activity.
* Top terms.
* Top matched phrases.

Analytics data is stored locally in the WordPress database.

= Import / Export =

The optional Import / Export tools support CSV and XML workflows.

Supported v1.1.0 fields include:

* Title.
* Definition.
* Tooltip.
* Slug.
* Status.
* Scheduled Date.
* Categories.
* Tags.
* Sources.
* Synonyms.
* Variations.
* Abbreviations.
* Aliases.
* WordPress exclusions.
* FluentCommunity exclusions.
* Per-term relationship linking mode.
* Per-type relationship linking toggles.

The importer ignores placeholder values in list-style fields, including:

* none
* n/a
* na
* null
* *
* —

= Term Discovery =

Term Discovery is an optional add-on that helps fetch definitions, summaries, synonyms, and sources from external services.

Fetch tools can help populate:

* Definitions.
* Tooltip summaries.
* WYSIWYG editor content.
* Synonyms.
* Sources.

Fetched content should always be reviewed by an editor before publishing.

= Performance =

Clever Linked Terms is designed with larger glossaries in mind.

Performance-focused behavior includes:

* Terms Engine feature gating.
* Term Manager pagination.
* Lazy-loaded public maps.
* Cached map rendering patterns.
* Optional glossary map loading.
* Module-level controls so unused features do not load.
* Sticky glossary navigation offset handling.
* Conservative controls for relationship phrase linking.

For large sites, enable Terms Engine modules one at a time and test performance with page cache, object cache, and CDN cache cleared.

= aOS / AdminOS Compatibility =

Clever Linked Terms can register as an app inside aOS/AdminOS when that environment is available.

Registered app routes include:

* Dashboard.
* Terms.
* New Term.
* Settings.

The integration is lightweight and does not require aOS/AdminOS to be installed.

= Privacy and External Services =

Clever Linked Terms can run without external lookup services.

Normal glossary linking uses local WordPress content and local glossary terms.

Optional features may involve additional data:

* Analytics stores local glossary engagement data.
* Term Discovery may send a searched term and configured API key to selected external providers when an administrator manually runs a lookup or API test.
* Documentation and community links are only visited when a user clicks them.

External service providers that may be configured for Term Discovery include:

* Wikimedia / Wikipedia REST API.
* Merriam-Webster Dictionary API.
* Merriam-Webster Thesaurus API.
* Encyclopaedia Britannica API.
* Free Dictionary API.
* API Ninjas Thesaurus API.
* WordsAPI through RapidAPI.

If you enable analytics or external lookup services, review your site privacy policy to ensure it matches your configuration.

= Links =

* Plugin page: https://wordpress.org/plugins/clever-linked-terms/
* User manual: https://jeffbrigman.com/clever-linked-terms-user-manual/
* Community: https://jeffbrigman.com/community/space/linked-terms/home

== Installation ==

= Install from WordPress.org =

1. In WordPress, go to Plugins → Add New Plugin.
2. Search for “Clever Linked Terms.”
3. Click Install Now.
4. Click Activate.

= Upload ZIP =

1. Download the plugin ZIP file.
2. Go to Plugins → Add New Plugin → Upload Plugin.
3. Upload the ZIP file.
4. Click Install Now.
5. Click Activate Plugin.

= First Setup =

1. Go to Clever Linked Terms → Settings.
2. Review the core glossary settings.
3. Create your first term.
4. Add a tooltip summary and full definition.
5. Configure WordPress content linking.
6. Create or place the glossary index shortcode.
7. Enable optional add-ons only when needed.

== Frequently Asked Questions ==

= Does Clever Linked Terms work without FluentCommunity? =

Yes. FluentCommunity support is optional. The core plugin works with normal WordPress posts, pages, and selected post types.

= Does Clever Linked Terms automatically link every term everywhere? =

No. You control where linking is enabled, which post types are processed, which selectors are used, and which terms or posts are excluded.

= Can I disable Terms Engine? =

Yes. Terms Engine is optional. When disabled, Terms Engine fields, menus, maps, conflict tools, and public connection widgets do not load.

= Are synonyms and aliases linked automatically? =

Only if Relationship Phrase Linking is enabled. You can store relationship data without automatically linking those phrases.

= Can I create a glossary index page? =

Yes. You can generate one from the settings area or manually place the shortcode:

`[clevlite_linked_terms_index]`

= Can I change the glossary index title? =

Yes. Version 1.1.0 adds a Glossary Index Title setting. You can also edit the generated page title directly in WordPress.

= Can I sort “The Odyssey” under “O” instead of “T”? =

Yes. Enable the setting to ignore leading words when grouping the glossary index. The default ignored words are “a,” “an,” and “the.”

= Does it work with page builders? =

Yes, as long as the frontend content is output in selectable HTML containers. Advanced selectors are available for themes and builders with unusual markup.

= Does the plugin track visitors? =

The core glossary does not require analytics. If the Analytics add-on is enabled, the plugin can record glossary impressions and clicks locally in your WordPress database.

= Does Term Discovery send data to external services? =

Only when Term Discovery is enabled and an administrator manually runs a lookup or API test. The searched term and configured API credentials may be sent to the selected provider.

= Is Clever Linked Terms translation-ready? =

Yes. Plugin strings are wrapped for WordPress internationalization.

== Screenshots ==

1. Clever Linked Terms dashboard.
2. Term Manager with search, filters, status chips, and pagination.
3. Term Studio editor.
4. Terms Engine Overview.
5. Semantic Relationships fields.
6. Term Health and conflict review.
7. Admin Term Map.
8. Glossary Index layouts.
9. Single term page layout.
10. Settings and add-ons.

== Changelog ==

= 1.1.0 =

* Added: Terms Engine, a new semantic control center for relationships, term health, link rules, maps, categories, tags, Tag IQ, and bulk tools.
* Added: Terms Engine add-on architecture so Terms Engine can be enabled or disabled as a major feature area.
* Added: Terms Engine feature cards for Semantic Relationships, Relationship Phrase Linking, Term Health & Conflicts, Admin Term Map, Public Term Connections, Glossary Knowledge Map, Tag IQ, and Bulk Tools.
* Added: Semantic Relationships for synonyms, aliases, abbreviations, and variations.
* Added: Relationship Phrase Linking with global settings, per-type controls, and per-term override behavior.
* Added: Term Health for Possible Issues, conflict review, mark-clear handling, and reopen workflows.
* Added: Admin Term Map with clickable/refocusable term nodes.
* Added: Public Term Connections for single term pages.
* Added: Glossary Knowledge Map behind a smooth public launcher.
* Added: Tag taxonomy using clevlite_term_tag.
* Added: Tag IQ for semantic tag organization and coverage workflows.
* Added: Term Studio for structured term editing.
* Added: Term Manager with card-based management, search, filters, status chips, pagination, and terms-per-page control.
* Added: Status support for Published, Draft, Scheduled, Pending Review, Private, and Trash workflows.
* Added: Glossary Index Title setting.
* Added: Glossary page detection by stored page ID, shortcode, and marker data to help avoid duplicates.
* Added: Ignore leading words setting for glossary sorting.
* Added: Sticky glossary header offset handling.
* Added: Additional glossary index layouts.
* Added: Auto-link control for glossary index content.
* Added: Single term page layouts.
* Added: “Back to [Index Title]” single term page buttons.
* Added: Dedicated Sources field.
* Added: Term Discovery improvements for formatted editor content, source routing, and synonym normalization.
* Added: Import/export support for v1.1.0 fields.
* Added: Placeholder cleanup for imported list fields.
* Added: Analytics add-on for impressions, clicks, matched phrases, relationship type, context, and FluentCommunity-aware activity.
* Added: FluentCommunity SPA-aware compatibility improvements.
* Added: aOS/AdminOS app registration compatibility.
* Improved: Performance handling for large glossaries with lazy-loading and cached rendering patterns.
* Improved: Admin navigation with grouped persistent menus.
* Improved: WordPress.org readiness, Plugin Check handling, escaping, sanitization, and readme presentation.
* Improved: WYSIWYG saving for allowed WordPress editor formatting.
* Fixed: Glossary index page title handling so generated glossary pages no longer force the title back to “Glossary Index.”
* Fixed: Public map caching so admin-only links do not leak into logged-out visitor output.
* Fixed: Relationship synonym formatting from external APIs.
* Fixed: Multiple WordPress coding standards and compatibility issues found during final review.

= 1.0.10 =

* Fixed: WordPress.org release metadata and packaging cleanup for the public stable line.
* Fixed: Plugin readme and stable tag handling so the repository release points to the correct stable version.
* Fixed: Contributor metadata so only valid WordPress.org usernames are included.
* Improved: Baseline glossary linking stability before the larger v1.1.0 feature release.
* Improved: Compatibility foundation for the upcoming semantic relationship and Terms Engine work.
* Fixed: Minor standards and release-readiness issues identified after the initial public release cycle.

= 1.0.0 =

* Initial public release of Clever Linked Terms.
* Added: Glossary term content type for managing linked terms in WordPress.
* Added: Automatic term linking for selected WordPress content.
* Added: Tooltip previews for linked glossary terms.
* Added: Public glossary index shortcode.
* Added: Basic settings for controlling where glossary linking appears.
* Added: Per-term glossary pages with title, definition, and tooltip support.
* Added: Initial WordPress.org repository release structure.

== Upgrade Notice ==

= 1.1.0 =
Major glossary upgrade with Terms Engine, semantic relationships, term maps, improved Term Manager, glossary title controls, FluentCommunity support, and more.

= 1.0.10 =
Repository metadata and release cleanup for the public stable line.
