外掛說明
List Post Tags Shortcode provides a simple yet powerful way to display all post tags on your WordPress site using the [list_post_tags] shortcode.
Key Features:
- Multiple Display Formats: Choose between unordered list (ul), inline, or comma-separated formats
- Flexible Sorting: Sort tags by name, count, slug, or term group in ascending or descending order
- Show Post Count: Optionally display the number of posts for each tag
- Exclude Specific Tags: Exclude tags by ID from the display
- Smart Caching: Built-in transient caching for improved performance
- Customizable Classes: Add custom CSS classes for styling
- Hide Empty Tags: Option to show or hide tags with no posts
- Developer Friendly: Clean, well-documented code following WordPress coding standards
Basic Usage:
[list_post_tags]
Advanced Examples:
Display tags inline with post counts, sorted by popularity:
[list_post_tags format=”inline” show_count=”true” orderby=”count” order=”DESC”]
Display as unordered list without caching:
[list_post_tags format=”ul” cache=”0″ class=”my-custom-class”]
Exclude specific tags (IDs 1 and 5):
[list_post_tags exclude=”1,5″]
Perfect for:
- Tag cloud pages
- Sidebar widgets
- Footer tag lists
- Custom tag archives
- Taxonomy overview pages
Privacy Policy
This plugin does not collect, store, or transmit any user data. All functionality is performed locally on your WordPress installation.
The admin review notice stores minimal preference data in the WordPress database:
* Activation date (stored in wp_options)
* User preference for review notice (stored in wp_usermeta, per administrator)
This data is used solely to manage the display of the review notice and can be deleted at any time.
Support
For support, feature requests, or bug reports, please visit:
* Plugin support forum: https://wordpress.org/support/plugin/list-post-tags-shortcode
* Plugin repository: https://github.com/andremoura/list-post-tags-shortcode (if applicable)
Credits
Developed by Andre Moura
Website: https://www.andremoura.com/
License
This plugin is licensed under the GPLv2 or later.
Good news, this plugin is free for everyone! Since it’s released under the GPL, you can use it free of charge on your personal or commercial site.
安裝方式
Automatic Installation:
- Log in to your WordPress admin panel
- Navigate to Plugins Add New
- Search for “List Post Tags Shortcode”
- Click “Install Now” and then “Activate”
Manual Installation:
- Download the plugin ZIP file
- Log in to your WordPress admin panel
- Navigate to Plugins Add New Upload Plugin
- Choose the ZIP file and click “Install Now”
- Activate the plugin
Usage:
- Create a new page or edit an existing one
- Add the shortcode
[list_post_tags]where you want the tag list to appear - Customize with attributes as needed (see FAQ for all options)
- Publish or update the page
常見問題集
-
What shortcode attributes are available?
-
- format: Display format –
'ul'(default),'inline', or'comma' - orderby: Sort tags by –
'name'(default),'count','slug', or'term_group' - order: Sort direction –
'ASC'(default) or'DESC' - show_count: Show post count –
'true'or'false'(default) - exclude: Comma-separated tag IDs to exclude – e.g.,
'1,5,12' - hide_empty: Hide tags with no posts –
'true'(default) or'false' - cache: Cache time in seconds – default
3600(1 hour), set to0to disable - class: Additional CSS class for the container
- format: Display format –
-
How do I style the tag list?
-
The plugin outputs semantic HTML with CSS classes:
- Container:
.wlpt-tags - List items (ul format):
<li>elements - Post count:
.wlpt-count - Custom class: Use the
classattribute
Example CSS:
.wlpt-tags { font-size: 14px; }
.wlpt-tags a { color: #0073aa; }
.wlpt-count { color: #999; } - Container:
-
Does this plugin use caching?
-
Yes! The plugin uses WordPress transients to cache the tag list, improving performance. The cache is automatically cleared when tags are created, edited, or deleted. Default cache time is 1 hour (3600 seconds), but you can adjust it with the
cacheattribute. -
Yes, use the
excludeattribute with comma-separated tag IDs:
[list_post_tags exclude=”1,5,12″]To find tag IDs, go to Posts Tags in your WordPress admin and hover over a tag name – the ID will appear in the URL.
-
Will this work with custom taxonomies?
-
Currently, the plugin only works with the default
post_tagtaxonomy. Support for custom taxonomies may be added in future versions. -
Is the output XSS-safe?
-
Yes, all output is properly escaped using WordPress functions (
esc_html,esc_url,esc_attr) to prevent XSS attacks. -
Can I use this in a widget?
-
Yes! If your theme supports shortcodes in widgets, you can add the shortcode directly. Alternatively, use a text widget or the WordPress block editor.
-
How do I translate this plugin?
-
The plugin is translation-ready with the text domain
list-post-tags-shortcode. Translation files should be placed in the/languagesfolder. You can use tools like Poedit or Loco Translate to create translations.
使用者評論
參與者及開發者
變更記錄
1.0.0 (2025-12-22)
- Initial release
- Multiple display formats (ul, inline, comma)
- Flexible sorting options
- Optional post count display
- Tag exclusion capability
- Smart transient caching
- Custom CSS class support
- Hide empty tags option
- Admin review notice for feedback
- Full i18n support
- Security: Proper output escaping and input sanitization
- Performance: Transient caching with automatic invalidation