Existing version 1.0 rules remain available without migration. Export a backup, update the plugin, verify the rules screen, and use the preview on a small product selection before a large production run.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3335591,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-265x265.png":{"filename":"icon-265x265.png","revision":3335591,"resolution":"265x265","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.2.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3659381,"resolution":"1","location":"assets","locale":"","width":2642,"height":1292},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3659381,"resolution":"2","location":"assets","locale":"","width":2108,"height":1488},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3659381,"resolution":"3","location":"assets","locale":"","width":3308,"height":1734}},"screenshots":[]},"plugin_section":[],"plugin_tags":[569,11143,472,66485,286],"plugin_category":[45,57],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-242992","plugin","type-plugin","status-publish","hentry","plugin_tags-automation","plugin_tags-bulk-edit","plugin_tags-keywords","plugin_tags-product-categories","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-taxonomy","plugin_committers-fradigital"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/keyword-based-bulk-category-assignment-for-woocommerce\/assets\/icon-128x128.png?rev=3335591","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/keyword-based-bulk-category-assignment-for-woocommerce\/assets\/screenshot-1.png?rev=3659381","caption":""},{"src":"https:\/\/ps.w.org\/keyword-based-bulk-category-assignment-for-woocommerce\/assets\/screenshot-2.png?rev=3659381","caption":""},{"src":"https:\/\/ps.w.org\/keyword-based-bulk-category-assignment-for-woocommerce\/assets\/screenshot-3.png?rev=3659381","caption":""}],"raw_content":"\n
Keyword-Based Bulk Category Assignment for WooCommerce reduces repetitive category work after product imports or catalog updates. Create rules once, select products in the WooCommerce Products list, review the exact planned assignments, and apply them only after confirmation.<\/p>\n\n
The plugin adds categories to a product. It does not remove unrelated categories that are already assigned.<\/p>\n\n
\"AND\"<\/code> syntax.<\/li>\n<\/ul>\n\nRule logic<\/h3>\n\nSimple terms use OR<\/h4>\n\n
Enter separate terms as individual chips. A category matches when at least one Contains chip matches the selected product fields.<\/p>\n\n
Example:<\/p>\n\n
shoes, sneakers, boots\n<\/code><\/pre>\n\nThis means shoes OR sneakers OR boots<\/code>.<\/p>\n\nAND groups require every term<\/h4>\n\n
Choose + AND group<\/strong>, enter at least two comma-separated terms, and press Enter.<\/p>\n\nExample input in the AND-group editor:<\/p>\n\n
red, leather\n<\/code><\/pre>\n\nThe plugin stores this as:<\/p>\n\n
red \"AND\" leather\n<\/code><\/pre>\n\nBoth terms must occur in the searchable product content. Simple terms and AND groups can be combined in the same rule. For example, shoes, red \"AND\" leather<\/code> means shoes OR (red AND leather)<\/code>.<\/p>\n\nExclusions take priority<\/h4>\n\n
Rules in Does not contain<\/strong> use the same chip and AND-group logic. If any exclusion chip or exclusion AND group matches, the category is skipped even if a Contains rule matches.<\/p>\n\nMatching details<\/h4>\n\n\n- Matching is case-insensitive.<\/li>\n
- HTML markup is ignored.<\/li>\n
- Repeated whitespace is normalized.<\/li>\n
- German umlauts are normalized so, for example,
M\u00fcller<\/code> also matches mueller<\/code>.<\/li>\n- Terms are substring matches; choose specific terms to avoid broad unintended matches.<\/li>\n<\/ul>\n\n
How to use the plugin<\/h3>\n\n\n- Go to WooCommerce > Category Auto Rules<\/strong>.<\/li>\n
- Select the product fields that the rules should search. Existing installations default to Title<\/strong>.<\/li>\n
- Find the desired category. The category hierarchy and term ID are displayed for clarity.<\/li>\n
- Add one or more terms under Contains<\/strong>. Press Enter or leave the input to accept the text.<\/li>\n
- Add optional exclusions under Does not contain<\/strong>.<\/li>\n
- Use + AND group<\/strong> when multiple terms must occur together.<\/li>\n
- Save with the button above or below the table.<\/li>\n
- Go to Products<\/strong>, select the products to evaluate, and choose Apply Category Auto Rules (Preview first)<\/strong> from Bulk actions.<\/li>\n
- Review the planned assignments and the matching reasons.<\/li>\n
- Confirm the preview to apply new categories. Use Undo last run<\/strong> in the success notice if the result needs to be reverted.<\/li>\n<\/ol>\n\n
Import and export<\/h3>\n\n
Export downloads all category rules as JSON. The exported structure intentionally keeps the option format used by earlier releases, so it can also be read by version 1.0.<\/p>\n\n
Import replaces the current category rules only. Before replacement, version 1.2.4 stores a backup of the previous rules. The Restore pre-import backup<\/strong> action can swap back to that rule set. The global product-field selection is not overwritten. Imports are restricted to valid JSON files up to 2 MB.<\/p>\n\nCategory rules are keyed by WooCommerce term ID. When rules are moved between different stores, corresponding categories should use the same term IDs. Review the imported rows before applying rules to products.<\/p>\n\n
Backward compatibility<\/h3>\n\n
Version 1.2.4 continues to use the original keywbuca_category_rules<\/code> WordPress option and the original rule keys contains<\/code> and not_contains<\/code>. Existing rules are available immediately after the update; no destructive migration or activation cleanup runs.<\/p>\n\nThe original syntax remains valid:<\/p>\n\n
\n- commas separate OR blocks;<\/li>\n
- the literal
\"AND\"<\/code> joins required terms inside one block;<\/li>\n- title-only matching remains the default until an administrator enables more fields.<\/li>\n<\/ul>\n\n
As a precaution for any production update, export the existing rules and create a normal site\/database backup before installing a new plugin version. After updating, open the rules screen, confirm the stored rules, save once, and test a small product selection through the preview.<\/p>\n\n
Privacy<\/h3>\n\n
The plugin does not contact external services, create public-facing cookies, or transmit product data. Rules, preview data, and undo data remain in the WordPress installation.<\/p>\n\n
License<\/h3>\n\n
This program is free software; you can redistribute it and\/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.<\/p>\n\n\n
\n- Upload the complete plugin folder to
\/wp-content\/plugins\/<\/code>, install the ZIP through Plugins > Add New > Upload Plugin<\/strong>, or deploy the release through the WordPress.org plugin directory.<\/li>\n- Activate WooCommerce.<\/li>\n
- Activate Keyword-Based Bulk Category Assignment for WooCommerce<\/strong>.<\/li>\n
- Open WooCommerce > Category Auto Rules<\/strong>.<\/li>\n
- Create or review the rules before processing products.<\/li>\n<\/ol>\n\n
Updating from version 1.0 does not require deleting, deactivating, or recreating existing rules.<\/p>\n\n\n
\nWill an update from version 1.0 delete my rules?<\/h3><\/dt>\nNo. Version 1.2.4 reads the same keywbuca_category_rules<\/code> option and the same per-category rule values. It does not run the old cleanup routine during activation.<\/p><\/dd>\nDoes the plugin change products as soon as a rule is saved?<\/h3><\/dt>\nNo. Rules run only when an authorized user selects products and starts the dedicated bulk action. The first step is a preview; products are changed only after the preview is confirmed.<\/p><\/dd>\n
What happens when a product already has a matching category?<\/h3><\/dt>\nThe preview lists only new assignments. Existing category relationships are left unchanged and are not counted as a new assignment.<\/p><\/dd>\n
What happens when a product matches multiple categories?<\/h3><\/dt>\nEvery newly matching category is added to the product, provided its exclusion rule does not match.<\/p><\/dd>\n
Are existing product categories removed?<\/h3><\/dt>\nNo. Applying rules appends matching categories. It does not remove unrelated categories.<\/p><\/dd>\n
How does undo work?<\/h3><\/dt>\nAfter a successful run, the success notice offers Undo last run<\/strong>. Undo restores the complete category set recorded immediately before that user's most recent run. A later run replaces that user's previous undo record.<\/p><\/dd>\nWhich product fields can be searched?<\/h3><\/dt>\nTitle, short description, full description, SKU, and attribute names and values. The title is enabled by default for compatibility with earlier versions.<\/p><\/dd>\n
Can rules be transferred between stores?<\/h3><\/dt>\nYes, using JSON export and import. Because rules use category term IDs, verify that the destination categories use the intended IDs.<\/p><\/dd>\n
Does uninstalling the plugin erase saved rules?<\/h3><\/dt>\nNo. The plugin deliberately leaves its configuration in the WordPress database so an accidental removal does not destroy a rule set.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.2.4<\/h4>\n\n\n- Preserved the original
keywbuca_category_rules<\/code> option, rule keys, comma-separated OR blocks, and \"AND\"<\/code> group syntax.<\/li>\n- Preserved title-only matching as the upgrade default.<\/li>\n
- Added explicit WordPress 7.1 and WooCommerce 11.0 compatibility metadata.<\/li>\n
- Added save controls directly above and below the rules table.<\/li>\n
- Added a clearer, responsive rules interface with category search, configured-only filtering, rule counts, hierarchy indentation, and unsaved-change status.<\/li>\n
- Prevented unconfirmed chip-editor text from being lost when the form is saved.<\/li>\n
- Added accessible chip removal controls and improved keyboard behavior.<\/li>\n
- Added global matching-field selection for titles, descriptions, SKUs, and product attributes.<\/li>\n
- Added safe previews with exact match reasons before product changes are committed.<\/li>\n
- Limited previews to the administrator who created them and strengthened transient identifiers.<\/li>\n
- Added per-user one-click undo while retaining compatibility with an existing legacy undo log.<\/li>\n
- Added legacy-compatible JSON export, stricter JSON import validation, and a restorable pre-import backup.<\/li>\n
- Improved custom and taxonomy attribute matching.<\/li>\n
- Avoided fatal errors on PHP installations without the optional mbstring extension.<\/li>\n
- Reduced category-query overhead by loading and rendering the hierarchy in one pass.<\/li>\n
- Updated and expanded installation, usage, compatibility, privacy, import\/export, and FAQ documentation.<\/li>\n<\/ul>\n\n
1.0<\/h4>\n\n\n- Initial release with title-based Contains and Not contains rules, comma-separated OR blocks,
\"AND\"<\/code> groups, bulk application, and JSON import\/export.<\/li>\n<\/ul>","raw_excerpt":"Assign WooCommerce product categories to selected products using reusable keyword rules, a safe preview, and one-click undo.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/242992","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=242992"}],"author":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/fradigital"}],"wp:attachment":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=242992"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=242992"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=242992"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=242992"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=242992"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=242992"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}