#<\/code>, social-style.<\/li>\n<\/ol>\n\nFeatures:<\/strong>\n- Five tag templates: buttons, inline text, tag cloud, outlined pills, hashtag.\n- Native Gutenberg block with sidebar controls (no shortcode needed).\n- Shortcode support: [s7n_tag_display]<\/code> or [s7n_tag_display template=\"minimal\"]<\/code>.\n- Admin settings page with live template preview and color picker.\n- Automatic or manual tag display (before or after content).\n- Tag ordering: alphabetical, by post count, or random.\n- Limit the number of tags shown and exclude specific tags by slug.\n- Post count next to each tag (e.g. WordPress (12)<\/em>) - opt-in per instance or globally.\n- Support for custom taxonomies alongside WordPress tags.\n- SEO options: rel=\"nofollow\" and target=\"_blank\" for tag links.\n- Theme template override: place a custom template file in your theme folder to take over the output.\n- Smart Visibility<\/strong>: automatically hide, collapse, or SEO-hide tags when the count falls below a configurable threshold - improving both SEO and UX.\n- Content Density Analysis<\/strong>: trigger Smart Visibility based on the ratio of tags to words in the post, not just tag count.\n- Per-instance FORCE bypass<\/strong>: disable Smart Visibility for a single shortcode or block without touching global settings.<\/p>\n\nLicense<\/h3>\n\n
This plugin is licensed under the GPLv2 or later.<\/p>\n\n\n
\n- Upload the
tag-display<\/code> folder to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n- Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n
- Go to Tag Display<\/strong> in the main WordPress menu to configure templates, colors, tag ordering, and auto-display options.<\/li>\n
- Display tags in one of three ways:\n\n
\n- Shortcode<\/strong> - add
[s7n_tag_display]<\/code> to any post or page.<\/li>\n- Gutenberg block<\/strong> - search for \"Tag Display\" in the block inserter.<\/li>\n
- Automatic<\/strong> - enable auto-display in Tag Display \u2192 Content Types<\/strong> to add tags to every post automatically.<\/li>\n<\/ul><\/li>\n<\/ol>\n\n\n
\nHow do I use the plugin?<\/h3><\/dt>\nActivate the plugin, then go to Tag Display<\/strong> in the main WordPress menu to pick a template and configure colors. From there, add tags to your posts in one of three ways:<\/p>\n\n\n- Shortcode<\/strong> - paste
[s7n_tag_display]<\/code> into any post or page.<\/li>\n- Gutenberg block<\/strong> - search for \"Tag Display\" in the block inserter.<\/li>\n
- Automatic<\/strong> - enable auto-display in Tag Display \u2192 Content Types<\/strong> and tags appear on every post without touching the editor.<\/li>\n<\/ol><\/dd>\n
Can I change the template style?<\/h3><\/dt>\nYes. Choose between Default, Minimal, Cloud, Outlined, and Hashtag templates:<\/p>\n\n
\n- From the settings page: Tag Display \u2192 General Settings \u2192 Default Template<\/strong>.<\/li>\n
- Via shortcode:
[s7n_tag_display template=\"outlined\"]<\/code><\/li>\n- Via Gutenberg block: select the block and use the Template<\/strong> option in the sidebar.<\/li>\n<\/ul><\/dd>\n
How do I use the Gutenberg block?<\/h3><\/dt>\nIn the block editor, click the +<\/strong> button and search for \"Tag Display\". Add the block to your post. Use the sidebar panel (Display Settings<\/strong>, Link Options<\/strong>, Title<\/strong>) to override the template, ordering, tag limit, and other options for that specific block - independently of the global settings.<\/p><\/dd>\nWhat shortcode attributes are available?<\/h3><\/dt>\nAll attributes are optional and override the global settings for that specific instance:<\/p>\n\n
[s7n_tag_display template=\"hashtag\" order=\"count_desc\" max=\"8\" exclude=\"news,draft\" nofollow=\"true\" new_tab=\"true\" show_count=\"true\" title=\"Related topics:\"]\n<\/code><\/pre>\n\n\ntemplate<\/code> - default<\/code>, minimal<\/code>, cloud<\/code>, outlined<\/code>, hashtag<\/code><\/li>\norder<\/code> - alpha_asc<\/code>, alpha_desc<\/code>, count_desc<\/code>, count_asc<\/code>, random<\/code> (default: global setting)<\/li>\nmax<\/code> - maximum number of tags to show, e.g. max=\"5\"<\/code> (0 = all)<\/li>\nexclude<\/code> - comma-separated slugs to hide, e.g. exclude=\"news,uncategorized\"<\/code><\/li>\nnofollow<\/code> - true<\/code> to add rel=\"nofollow\"<\/code> to tag links<\/li>\nnew_tab<\/code> - true<\/code> to open links in a new tab<\/li>\nshow_count<\/code> - true<\/code> to show the post count next to each tag, e.g. WordPress (12)<\/em><\/li>\ntitle<\/code> - custom label above the tags, e.g. title=\"Topics:\"<\/code> (empty string hides the title)<\/li>\n<\/ul><\/dd>\nHow do I limit or sort the tags?<\/h3><\/dt>\nOpen Tag Display \u2192 General Settings<\/strong>:<\/p>\n\n\n- Tag Order<\/strong> - alphabetical (A\u2192Z \/ Z\u2192A), by post count (most\/least used), or random.<\/li>\n
- Max Tags<\/strong> - show only the first N tags (0 = show all).<\/li>\n
- Exclude Tags<\/strong> - comma-separated slugs of tags to always hide.<\/li>\n<\/ul>\n\n
These settings can also be overridden per-instance via shortcode or Gutenberg block.<\/p><\/dd>\n
How do I hide specific tags?<\/h3><\/dt>\nIn Tag Display \u2192 General Settings \u2192 Exclude Tags<\/strong>, enter the slugs (not names) of the tags you want to hide, separated by commas. Example: news, uncategorized, draft<\/code>.<\/p>\n\nTo find a tag's slug, go to Posts \u2192 Tags<\/strong> in the WordPress admin.<\/p><\/dd>\nCan I display tags automatically without a shortcode?<\/h3><\/dt>\nYes. Go to Tag Display \u2192 Content Types<\/strong>, enable auto-display for posts, pages, or custom post types, and choose whether tags appear before<\/strong> or after<\/strong> the content.<\/p><\/dd>\nHow do I add rel=\"nofollow\" or open links in a new tab?<\/h3><\/dt>\nGo to Tag Display \u2192 General Settings<\/strong> and enable the rel=\"nofollow\"<\/strong> or Open in new tab<\/strong> checkboxes. These can also be set per-instance via shortcode (nofollow=\"true\"<\/code>, new_tab=\"true\"<\/code>) or Gutenberg block sidebar.<\/p><\/dd>\nCan I create a fully custom template from my theme?<\/h3><\/dt>\nYes. Place a file named tag-display-template-{name}.php<\/code> in your theme (or child theme) root folder, where {name}<\/code> is the template you want to override: default<\/code>, minimal<\/code>, cloud<\/code>, outlined<\/code>, or hashtag<\/code>.<\/p>\n\nExample: to override the default template, create wp-content\/themes\/your-theme\/tag-display-template-default.php<\/code>.<\/p>\n\nThe plugin picks it up on the next page load. A commented example file is included in the plugin's examples\/<\/code> folder.<\/p>\n\nThe following variables are available in your custom template:<\/p>\n\n
\n$tags<\/code> - array of WP_Term objects (->name<\/code>, ->slug<\/code>, ->count<\/code>)<\/li>\n$display_title<\/code> - label text above the tags<\/li>\n$display_nofollow<\/code> - boolean, whether to add rel=\"nofollow\"<\/code><\/li>\n$display_new_tab<\/code> - boolean, whether to open links in a new tab<\/li>\n$display_show_count<\/code> - boolean, whether to show post count next to each tag<\/li>\n<\/ul><\/dd>\nWhat is Smart Visibility and how do I use it?<\/h3><\/dt>\nSmart Visibility automatically adapts tag display based on how many tags a post has - improving both SEO and user experience. When the count falls below a configurable threshold, the plugin applies the behavior you choose:<\/p>\n\n
\n- Hide<\/strong> - suppresses the tag block entirely (no HTML output). Best for SEO: avoids thin tag sections.<\/li>\n
- Hidden<\/strong> - renders tags with
display:none<\/code> so they are present in the DOM but invisible. Useful when you want to toggle them via JavaScript without a page reload.<\/li>\n- Collapse<\/strong> - renders a \"Show tags\" button; the visitor can expand the list on click. Best for UX on posts with few tags.<\/li>\n
- SEO hidden<\/strong> - tags are visually invisible to visitors but present in the DOM for search crawlers.<\/li>\n<\/ul>\n\n
To enable it, go to Tag Display \u2192 Smart Visibility<\/strong>, turn on the toggle, set your Minimum Tag Threshold<\/strong> (default: 3), and pick a behavior. When a post has at least as many tags as the threshold, it displays normally - Smart Visibility is completely transparent.<\/p>\n\nContent Density Analysis (advanced):<\/strong> you can also trigger Smart Visibility based on tag density - the ratio of tags to words in the post. Enable \"Content Density Analysis\" in the Smart Visibility tab and set a density threshold (default: 0.005, which equals 1 tag per 200 words). If the density is below the threshold, the selected behavior applies even if the tag count meets the minimum.<\/p>\n\nPer-instance override via shortcode:<\/strong><\/p>\n\n[s7n_tag_display smart=\"true\" min=\"3\" behavior=\"collapse\"]\n<\/code><\/pre>\n\n\nsmart<\/code> - true<\/code> to enable, false<\/code> to force-disable for this instance regardless of the global setting<\/li>\nmin<\/code> - minimum tag threshold for this instance<\/li>\nbehavior<\/code> - hide<\/code>, hidden<\/code>, collapse<\/code>, or seo<\/code>; use force<\/code> to bypass Smart Visibility entirely for this instance<\/li>\n<\/ul><\/dd>\nIs it compatible with the latest WordPress version?<\/h3><\/dt>\nTested up to WordPress 6.8. If you run into a compatibility issue, open a thread on the support forum.<\/p><\/dd>\n\n<\/dl>\n\n\n
2.1.0<\/h4>\n\n\n- Added Mode field in Smart Visibility admin: Auto, Density, UX, Disabled - replaces the Enable toggle when set.<\/li>\n
- Added behavior
replace<\/code>: when tags are below threshold, a related posts list is shown instead (WP_Query cascade: shared tags \u2192 shared categories, up to 5 results, transient-cached 1h).<\/li>\n- New template
tag-display-related-posts.php<\/code> with configurable title via admin field.<\/li>\n- Transient cache automatically invalidated when post terms change (
set_object_terms<\/code> hook).<\/li>\n- Admin: new \"Related Topics Title\" field; behavior dropdown includes \"Replace\".<\/li>\n
- Added CSS for
.s7n-related-posts<\/code> (neutral, theme-inheriting, responsive).<\/li>\n- Updated Italian translations for all new strings.<\/li>\n<\/ul>\n\n
2.0.0<\/h4>\n\n\n- Added content density analysis: Smart Visibility can now trigger based on tag density (tags per word) in addition to tag count.<\/li>\n
- New behavior: \"Hidden\" - renders tags with
display:none<\/code> (DOM present, togglable via JavaScript) without a full PHP re-render.<\/li>\n- Added FORCE bypass:
[s7n_tag_display smart=\"false\"]<\/code> or behavior=\"force\"<\/code> disables Smart Visibility for a single instance.<\/li>\n- Admin: new \"Content Density Analysis\" field in Smart Visibility tab with density threshold setting (default: 0.005).<\/li>\n
- Updated translations: new strings for density and hidden behavior in
.pot<\/code> and it_IT.po\/.mo<\/code>.<\/li>\n<\/ul>\n\n1.9.0<\/h4>\n\n\n- Added Smart Visibility: automatically hide, collapse, or SEO-hide tags when the post has fewer tags than a configurable threshold.<\/li>\n
- Three behaviors: Hide (no output), Collapse (expandable with a button), SEO Hidden (invisible to visitors, present for crawlers).<\/li>\n
- New admin tab: Tag Display \u2192 Smart Visibility with enable toggle, threshold setting, and behavior selector.<\/li>\n
- Shortcode support: smart, min, and behavior attributes for per-instance override.<\/li>\n
- Added Italian translations for all new strings.<\/li>\n<\/ul>\n\n
1.8.1<\/h4>\n\n\n- Fixed extra space before comma separator in Minimal template (frontend and admin preview).<\/li>\n<\/ul>\n\n
1.8.0<\/h4>\n\n\n- Moved settings menu to top-level WordPress admin navigation for easier access.<\/li>\n
- Added automatic redirect to the settings page after plugin activation.<\/li>\n<\/ul>\n\n
1.7.0<\/h4>\n\n\n- Added internationalization (i18n) support: plugin strings are now translatable.<\/li>\n
- Added Italian translation (it_IT).<\/li>\n
- Added Text Domain header to plugin file.<\/li>\n
- Fixed two admin strings missing translation wrappers.<\/li>\n<\/ul>\n\n
1.6.0<\/h4>\n\n\n- Modernized admin UI: new card-based layout, updated tab navigation, section wrappers, improved color picker area.<\/li>\n
- Updated Template Preview tab: 5 cards with header\/badge\/body structure, fixed nesting bug (Outlined and Hashtag cards were incorrectly nested inside Tag Cloud).<\/li>\n
- Updated Help tab: 5-template documentation, Gutenberg block guide, full shortcode attribute reference, theme override instructions.<\/li>\n
- Updated WordPress.org screenshots to reflect current admin UI with all 5 templates.<\/li>\n
- Updated version in package.json and block.json to match plugin version.<\/li>\n<\/ul>\n\n
1.5.0<\/h4>\n\n\n- Added theme template override: place
tag-display-template-{name}.php<\/code> in your theme folder to fully customize the output.<\/li>\n