simple-tags / readme.txt

readme.txt in Tag, Category, and Taxonomy Manager – Autotagger Automatically Add Terms trunk, at readme.txt

299 lines 23.1 KB

Raw Download Zip

1	=== Tag, Category, and Taxonomy Manager - Autotagger Automatically Add Terms ===
2	Contributors: publishpress, kevinB, stevejburge, andergmartins, olatechpro, ojopaul, deji98
3	Tags: category, tag, taxonomy, categories, tag cloud
4	Requires at least: 5.0
5	Tested up to: 7.1
6	Stable tag: 3.53.0
7	Requires PHP: 7.4
8	License: GPLv2 or later
9	License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
11	Tags, Categories and WordPress terms are easy with TaxoPress. Add a Tag or Category to Pages, manage your WooCommerce Categories and Tags and more.
12
13	== Description ==
14
15	TaxoPress allows you to create and manage Tags, Categories, and all your WordPress taxonomy terms. TaxoPress can help with all your WordPress content, from adding Tags and Categories to Pages, to managing WooCommerce Product Categories and bbPress Topic Tags.
16
17	TaxoPress has integrations with AI tools including OpenAI. You can use these AI services to find the best taxonomy terms for your content.
18
19	With TaxoPress, you can organize, optimize, and showcase all your WordPress content:
20
21	* Organize: In TaxoPress, you can manage taxonomies, and also terms. There are tools for you to add, rename, remove, delete and even merge terms. You can add any term or taxonomy to any post type.
22	* Optimize: TaxoPress can improve your SEO with automatic term management. TaxoPress can automatically suggest relevant terms for your content and link those terms to the correct archive pages.
23	* Showcase: TaxoPress allows you to use your terms for advanced features such as Related Posts and Tag Clouds.
24
25	## TaxoPress Pro ##
26
27	> <strong>Upgrade to TaxoPress Pro</strong><br />
28	> This plugin is the free version of TaxoPress. The Pro version of TaxoPress has extra features and expert support. [Get the TaxoPress Pro plugin now!](https://taxopress.com/taxopress)
29
30	## 10 Key Features in TaxoPress ##
31
32	1. Manage Terms and Taxonomies: You can create new taxonomies and edit all the settings for each taxonomy.
33	2. Terms Display: This feature allows you to create a customizable display of all the terms in one taxonomy.
34	3. Terms for Current Post: This enables you to create a customizable display of all the terms assigned to the current post.
35	4. Related Posts: Shows lists of posts with similar tags and categories.
36	5. Auto Links: If you have a term called “WordPress”, the Auto Links feature will find any instances of “WordPress” in your content and add links to the archive page for that tag.
37	6. Auto Terms: If you have a term called "WordPress", Auto Terms can analyze your posts, and when it finds the word "WordPress", it can add that term to your post.
38	7. Add Terms with AI: The Pro version of TaxoPress has AI integrations with OpenAI, IBM Watson, and more. This makes it easier for you to find or create the best taxonomy terms for your content.
39	8. Term Synonyms: This feature allows you to have multiple words associated with a single term.
40	9. Linked Terms: You can connect terms. When the main term is added to a post, the linked terms will be added also.
41	10. Manage Terms: Add, rename, merge, remove, delete and even delete unused terms.
42
43	## Feature 1. Create and Manage Taxonomies ##
44
45	TaxoPress can manage all the taxonomies created by WordPress and your plugins and themes. You can change the settings for each taxonomy. For example, you can change the visual labels, and control whether the taxonomy is organized in parent-child relationships. You can also assign your taxonomies to different post types. For example, you can use TaxoPress to add Categories to Pages, or WooCommerce Tags to Posts.
46
47	[Click here to read about managing taxonomies](https://taxopress.com/docs/introduction-taxonomies-screen/).
48
49	## Feature 2. Terms Display ##
50
51	The Terms Display feature in TaxoPress allows you to show a cloud or list of the terms used on your site. For example, you can create a "Tag Cloud" showing all your WooCommerce product categories, or you can create a list of all the tags on bbPress topics.
52
53	TaxoPress makes it easy to customize the format of your terms, and add custom CSS styles. The terms can be shown in a shortcode, a widget, or TaxoPress can try and automatically add the terms into your content.
54
55	[Click here to read about Terms Display](https://taxopress.com/docs/introduction-to-tag-clouds/).
56
57	## Feature 3. Terms for Current Post ##
58
59	The Terms for Current Post feature in TaxoPress allows you to customize the displays of terms for single posts. This display is separate from any default display of terms in your theme, so you can use this feature to easily show terms anywhere on your site.
60
61	TaxoPress makes it easy to customize the format of your terms, and add custom CSS styles. The terms can be shown in a shortcode, a widget, or TaxoPress can try and automatically add the terms into your content.
62
63	[Click here to read about Terms for Current Post](https://taxopress.com/docs/introduction-to-tags-for-current-post/).
64
65	## Feature 4. Related Posts ##
66
67	TaxoPress can display posts that are related to the current post. This feature works by checking for shared taxonomy terms. If your post has the terms “Vegetables” and “Food”, then this feature will likely display other posts that also have the terms “Vegetables” and “Food”. The more terms that are shared, the more likely a post is to show.
68
69	The Related Posts can be shown in a shortcode, a widget, or TaxoPress can try and automatically add the related posts into your content.
70
71	[Click here to read about Related Posts](https://taxopress.com/docs/introduction-to-related-posts/).
72
73	## Feature 5. Auto Links ##
74
75	The Auto Links feature in TaxoPress will automatically add links to your content. If you have a term called “WordPress”, the Auto Links feature will find any instances of “WordPress” in your content and add a link to the archive page for that tag. So any instances of “WordPress” will link to /tag/wordpress.
76
77	[Click here to read about Auto Links](https://taxopress.com/docs/introduction-to-auto-links/).
78
79	## Feature 6. Auto Terms ##
80
81	This feature allows WordPress to examine your post content and title for specified terms and automatically add those terms as Tags. Here’s an example of how it works:
82
83	* You add “WordPress” to the keywords list in TaxoPress.
84	* If your post content or title contains the word “WordPress”, then TaxoPress will automatically add “WordPress” as a term for this post.
85
86	[Click here to read about automatically adding terms](https://taxopress.com/docs/introduction-to-auto-terms/).
87
88	## Feature 7. Add Terms with AI (Pro version) ##
89
90	This feature makes it easier for you to find or create the best taxonomy terms for your content. TaxoPress AI can show a metabox on your post editing screen with all these options:.
91
92	* Manage Post Terms: This feature allows you to manage all the terms that are currently attached to a post.
93	* Suggest Existing Terms: This feature uses a tool in the TaxoPress plugin that can scan your posts and suggest relevant terms that already exist on your site.
94	* Show All Existing Terms: This feature allows you to browse all the terms in a taxonomy.
95	* OpenAI: These integrations allow you to connect to external service. These services will scan your content and suggest relevant terms. They can suggest existing terms and also new terms.
96
97	[Click here to read about TaxoPress and AI](https://taxopress.com/docs/sources-for-auto-terms/).
98
99	## Feature 8. Term Synonyms ##
100
101	Synonyms is a feature in TaxoPress Pro that allows you to have multiple words associated with a single term. If TaxoPress scans your content and finds a synonym, it will act as if it has found the main term.
102
103	Synonyms will be available on each term screen. For example, if your term is “Apple”, you can create synonyms such as “Apples”, “Golden Delicious”, “Granny Smith”, “Pink Lady”, “Honeycrisp”, “Red Delicious”, “Braeburn” and “Gravenstein”.
104
105	[Click here to read about Term Synonyms](https://taxopress.com/docs/synonyms/).
106
107	## Feature 9. Linked Terms ##
108
109	Linked Terms is a feature in TaxoPress Pro that allows you to connect terms. When the main term is added to a post, the linked terms will be added also.
110
111	For sites with a lot of terms, this feature makes it easier and quicker for your users to add the correct terms. For example, if you add the term “WordPress” to your posts, TaxoPress can automatically add Linked Terms that include “CMS”, “website”, and “website design”.
112
113	[Click here to read about Linked Terms](https://taxopress.com/docs/linked-terms/).
114
115	## Feature 10. Manage Terms ##
116
117	The Manage Terms screen in TaxoPress provides you with several useful tools to manage the terms on your site. These tools can be used with any taxonomy. Here are some of the tools on the Manage Terms screen:
118
119	* Add terms: Quickly add terms to your content.
120	* Rename terms: Change the name of your terms in bulk.
121	* Merge terms: Combine existing terms together. This is very useful for fixing typos in your terms.
122	* Delete unused terms: Delete any terms that are rarely used.
123
124	[Click here to read about managing terms](https://taxopress.com/docs/introduction-to-manage-terms/).
125
126	## TaxoPress Pro ##
127
128	> <strong>Upgrade to TaxoPress Pro</strong><br />
129	> This plugin is the free version of TaxoPress. The Pro version of TaxoPress has extra features and expert support. [Get the TaxoPress Pro plugin now!](https://taxopress.com/taxopress)
130
131	## The TaxoPress and Tag Groups plugins ##
132
133	TaxoPress is developed by the same team that support the popular [Tag Groups plugin](https://wordpress.org/plugins/tag-groups/). Together Tag Groups and TaxoPress are an excellent solution for organizing and displaying your site’s content.
134
135	## TaxoPress Bug Reports =
136
137	Bug reports for TaxoPress are welcomed in our [repository on GitHub](https://github.com/taxopress/taxopress). Please note that GitHub is not a support forum, but a place to report bugs in the plugn that can be replicated outside of a single site.
138
139	= Follow the TaxoPress team =
140
141	Follow TaxoPress on [Facebook](https://www.facebook.com/taxopress), [Twitter](https://www.twitter.com/taxopress) and [YouTube](https://www.youtube.com/taxopress).
142
143
144	== Installation ==
145
146	Requires PHP 5.6 or ideally PHP 7.
147
148	TaxoPress can be installed in 3 easy steps:
149
150	1. Unzip the TaxoPress archive and put all files into a folder like "/wp-content/plugins/simple-tags/"
151	2. Activate the plugin through the 'Plugins' menu in WordPress
152	3. Inside the WordPress admin, go to the 'TaxoPress' mennu.
153
154	== Frequently Asked Questions ==
155
156	= Can I Add Categories and Tags to WordPress Pages? =
157
158	Yes, you can. Both Categories and Tags are “taxonomies” and they can help you sort your content. However, on a normal WordPress site, both Categories and Tags are only available for Posts. This means that you do not have any options to organize your Pages … unless you use a plugin such as TaxoPress. I’ll show you how to add Categories to your WordPress Pages.
159
160	* Install the TaxoPress plugin.
161	* Go to “TaxoPress” and then “Taxonomies” in your WordPress admin area.
162	* Click “Edit” under “Categories”.
163	* Click the “Post Types” tab.
164	* Check the box for “Pages”.
165	* You may also want to check the box “Show content from all post types on archive page” so that your Posts and Pages are grouped together on the Category pages.
166	* You will now see that “Categories” are available under “Pages” in your WordPress admin menu.
167	* When you are editing a Page, you will see the “Categories” box in the right sidebar.
168	* You will also be able to add and remove Categories using the “Quick Edit” and “Bulk Edit” features.
169
170	[Click here to see how to Add Categories and Tags to WordPress Pages](https://taxopress.com/add-categories-wordpress-pages/).
171
172	= How Many Levels of Sub-Categories Does WordPress Support? =
173
174	There is no technical limit to how deep your nested categories can go. In an image you can see by clicking the link below, I’ve created 10 levels of categories. You can keep adding sub-category levels as deep as you wish.
175
176	The main limitation to consider will be the WordPress admin area which will start to look strained. In another you can see by clicking, I’ve added twenty levels. When I go to add “Level 21”, the “Parent Category” dropdown appears to be broken. Those extra levels appear on the main “Categories” screen, but each one is only displayed after a long row of hyphens. And when you try to add a category to a post, you may find that the lower levels are not easily visible inside the metabox. The reason that WordPress allows you to have an unlimited number of sub-categories is that these are simple database entries. The sub-categories are controlled by the parent column in the wp_term_taxonomy table. Adding more sub-categories will not slow your site down at all.
177
178	Finally, I’ll note that you can add multiple levels to any WordPress taxonomy. Go to the “Taxonomies” screen in TaxoPress. When you click “Edit”, you’ll be able to change the settings for each taxonomy. You can control whether the taxonomy is organized in parent-child relationships.
179
180	[Click here to see about category levels in WordPress](https://taxopress.com/how-many-levels-sub-categories/).
181
182	= How Do I Create WordPress Taxonomies for Internal Use? =
183
184	We often have TaxoPress users who want to organize their content privately. They want a taxonomy that is only used and seen in the WordPress admin area. With the TaxoPress plugin, you can create taxonomies for internal use only. Your content will still be visible, but it can be organized with hidden taxonomies.
185
186	* Install the TaxoPress plugin.
187	* Go to “Taxonomies” in the WordPress admin area.
188	* Create a new taxonomy.
189
190	That’s it! The easy approach is to use TaxoPress to create a new taxonomy. If you never decide to actively display the taxonomy, it will never be shown anywhere. It will only be available in the WordPress admin area. You will be able to add terms to this taxonomy while adding content.
191
192	Inside the “Taxonomies” screen, you can click the “Admin Area” tab and choose where your private taxonomy appears:
193
194	* Show user interface: Should be the visible screen to manage these terms?
195	* Show in admin menus: Should there be a link to this taxonomy in the WordPress admin menu?
196	* Show in frontend menus: Should this taxonomy be available for the “Menus” screen.
197	* Show admin menu: Should this taxonomy appear on screens such as “Posts” and “Pages”?
198	* Show in “Quick Edit” and “Bulk Edit”: Should this taxonomy be available in editing tools on screens such as “Posts” and “Pages”?
199
200	[Click here to see more about private taxonomies](https://taxopress.com/how-to-create-wordpress-taxonomies-for-internal-use/).
201
202	= How Do I Display Taxonomy Terms in a Widget? =
203
204	It is possible to use TaxoPress to show terms in a WordPress widget. Go to Appearance > Widget and look for the “Term Display (TaxoPress Shortcode)” widget. This can be placed into any area that your theme has available.
205
206	[Click here to see more about showing terms in a widget](https://taxopress.com/docs/tag-cloud-widget/).
207
208	= How Do I Display Taxonomy Terms with a Shortcode? =
209
210	TaxoPress allows you to show a cloud or list of the terms in a taxonomy. You can show your terms using the shortcode shown on the “Terms Display” screen. If you are using the block editor in WordPress, you can add shortcodes using the “Shortcode” block.
211
212	[Click here to see more about showing terms with a shortcode](https://taxopress.com/docs/tag-cloud-shortcode/).
213
214	= How Do I Automatically Add Tags in WordPress? =
215
216	If you have a busy WordPress site, it can be difficult to organize all your content. Fortunately, with TaxoPress, there is a way to automatically add Tags to posts. You can create the Tags and then allow TaxoPress to add them to relevant posts. The “Auto Terms” feature in TaxoPress can scan your WordPress posts and automatically assign Tags. For example, imagine you have a term called “Apples”. Auto Terms can analyze your posts and when it finds the word “Apples”, it can add that Tag to your post.
217
218	* Go to TaxoPress > Auto Terms in your WordPress admin menu.
219	* Choose the taxonomy you want to use with Auto Terms. In this example, choose “Tags”.
220	* Choose the post types you want to use with this feature. In this example, choose “Posts”.
221	* The other required setting is in “Terms to Use”. You need to choose whether to use all the terms in your “Tags” taxonomy, or only a select group. If you choose to use all the terms, test carefully as this process may slow your site if you have 10,000’s of terms, or if you have a slow server.
222	* Click “Save Auto Terms”.
223	* You are now ready to automatically add terms! One approach is to use the “Existing content” option to retroactively add Tags to your content. For new content, TaxoPress can automatically scanned the post text and added the correct Tags.
224
225	[Click here to see more about automatically adding WordPress Tags](https://taxopress.com/automatically-add-tags-wordpress/).
226
227	= How Do I Automatically Add WooCommerce Product Tags and Categories? =
228
229	If you have a busy WooCommerce site, it can be difficult to organize all your products. Fortunately, with TaxoPress, there is a way to automatically add Product Tags and Categories. The “Auto Terms” feature in TaxoPress can scan your WooCommerce products and automatically assign WooCommerce Tags and WooCommerce Category. For example, imagine you have a term called “WordPress”. Auto Terms can analyze your WooCommerce products and when it finds the word “WordPress”, it can add that term to your post.
230
231	* Go to TaxoPress > Auto Terms in your WordPress admin menu.
232	* Choose the taxonomy you want to use with Auto Terms. In this example, choose “Product Tags”.
233	* Choose the post types you want to use with this feature. In this example, choose “Products”.
234	* The other required setting is in “Terms to Use”. You need to choose whether to use all the terms in your “Product Tags” taxonomy, or only a select group. If you choose to use all the terms, test carefully as this process may slow your site if you have 10,000’s of terms, or if you have a slow server.
235	* You are now ready to automatically add terms! One approach is to use the “Existing content” option to retroactively add Product Tags to your WooCommerce products. For new content, TaxoPress can automatically scanned the product text and added the correct WooCommerce Tag or WooCommerce Category.
236
237	[Click here to see more about automatically adding WooCoomerce Product Tags](https://taxopress.com/automatically-add-woocommerce-product-tags-and-categories/).
238
239	= What’s the Difference Between WordPress Categories and Tags? =
240
241	The main difference between Categories and Tags is the ability to create levels of Categories. Categories are hierarchical, which means terms can be organized into a parent-child relationship. For example, you could have a Category called “Fruit”, and under this Category you could have categories called “Apples”, “Bananas”, “Grapes”, and “Peaches”. Tags are not hierarchical, which means there’s no relationship between them. You can still add the same words as Tags, but by default they can not have relationships. You can modify this using [the Taxonomies screen in TaxoPress](https://taxopress.com/docs/introduction-taxonomies-screen/).
242
243	[Click here to see the difference between Tags and Categories](https://taxopress.com/difference-categories-tags/)
244
245	= Can I Build WordPress Tag Generator With TaxoPress? =
246
247	Yes, this is possible with the TaxoPress plugin. TaxoPress has a feature that can analyze your content and automatically add new terms. This tag generator will be very useful for anyone who creates a lot of content. This feature is called “Auto Terms” and it works by integrating with the OpenAI, IBM Watson, Dandelion or LSEF systems to scan content and create terms.
248
249	[Click here to see how to build a tag generator](https://taxopress.com/wordpress-tag-generator/)
250
251	= How Do I Integrate OpenAI with TaxoPress? =
252
253	OpenAI / OpenAI / ChatGPT is the most popular AI tool available today. The TaxoPress AI feature has an integration with the OpenAI service. [This OpenAI guide](https://taxopress.com/docs/register-openai/) will help you register for an account at OpenAI and get an API Key to use with TaxoPress.
254
255	= How Do I Integrate IBW Watson with TaxoPress? =
256
257	IBW Watson is one of the most powerful AI tools available today. The TaxoPress AI feature has an integration with the Natural Language Understanding service from IBM. [This IBM Watson guide](https://taxopress.com/docs/register-ibm/) will help you register for an account at IBM Cloud and get an API Key and URL to use with TaxoPress.
258
259
260	== Screenshots ==
261
262	1. You can create new taxonomies and edit all the settings for each taxonomy.
263	2. With TaxoPress you can show all the terms in one taxonomy. You can build dynamic tag clouds and lists with many configuration options.
264	3. TaxoPress has tools to help you manage terms on a busy site. You can quickly add, rename, remove, delete and even merge terms.
265	4. TaxoPress can analyze your posts and automatically create relevant Tags and Categories.
266	5. TaxoPress can use the Dandelion API and OpenCalais APIs to analyze your WordPress content and suggest terms that you can add to your post.
267	6. If you have a term called “WordPress”, the Auto Links feature will find any instances of “WordPress” in your content and add a link to the archive page for that tag.
268
269	== Changelog ==
270
271	## [3.53.0] - 01 September, 2026
272	* Fixed: Mass Edit pagination is broken, #3014
273	* Update: Enforce native taxonomy capabilities for term actions, #3013
274	* Update: Bound Auto Terms existing-content processing, #3012
275	* Update: Restrict administrative taxonomy term lookups, #3011
276	* Update: Harden AI integrations and metabox mutations, #3010
277	* Add a loco.xml file, #3009
278
279	## [3.52.0] - 19 August, 2026 =
280	* Update: Normalize Auto Terms specific-term values, #3001
281	* Update: Add permission checks to Pro configuration copy actions, #3000
282	* Update: Restrict synonym validation to TaxoPress managers, #2999
283	* Add permission checks to term copy actions, #2998
284	* Harden Linked Terms list and bulk actions, #2997
285	* Strengthen Manage Terms request validation, #2995
286	* Tighten access checks for term suggestion lookups, #2993
287	* Add request validation to legacy tag creation, #2991
288	* Harden TaxoPress AI term result rendering, #2989
289
290	## [3.51.0] - 22 July, 2026 =
291	* Fixed: Fatal memory exhaustion on Terms screen (st_terms) with hierarchical taxonomy — not related to term count, #2967
292	* Fixed: Related Posts thumbnail image resolution setting is ignored, #2964
293	* Fixed: Terms screen causes memory exhaustion on large sites, #2962
294	* Fixed: Improve AI preview post validation, #2968. Thanks to Duy for the report
295	* Fixed: Terms screen can run out of memory on large sites, #2961
296	* Update: Remove the lock icon in the Pro version, #2963
297	* Update: Include changelog in readme.txt for plugin update dialog box, #2959
298
299	The full changelog can be found on [GitHub](https://github.com/taxopress/taxopress/blob/master/CHANGELOG.md).