{"id":242992,"date":"2025-07-28T22:58:04","date_gmt":"2025-07-28T22:58:04","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/keyword-based-bulk-category-assignment-for-woocommerce\/"},"modified":"2025-07-29T23:16:13","modified_gmt":"2025-07-29T23:16:13","slug":"keyword-based-bulk-category-assignment-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/ca-valencia.wordpress.org\/plugins\/keyword-based-bulk-category-assignment-for-woocommerce\/","author":23331926,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0","stable_tag":"1.0","tested":"6.8.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Keyword-Based Bulk Category Assignment for WooCommerce","header_author":"fra.digital","header_description":"Automatically categorize WooCommerce products based on keyword rules with AND\/OR logic, import\/export functionality, and hierarchical category display.","assets_banners_color":"","last_updated":"2025-07-29 23:16:13","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.fra.digital\/","header_author_uri":"https:\/\/www.fra.digital\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":307,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"fradigital","date":"2025-07-29 23:16:13"}},"upgrade_notice":{"1.0":"<p>First stable version.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3335591,"resolution":"128x128","location":"assets","locale":""},"icon-265x265.png":{"filename":"icon-265x265.png","revision":3335591,"resolution":"265x265","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3336254,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3336254,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"<p>Managing category keywords under <strong>WooCommerce &gt; Category Auto Rules<\/strong>. This is where you define relevant keywords for each existing product category. Rules support both inclusion and exclusion criteria, based on product titles.<\/p>","2":"<p>Selecting the products to be processed (e.g. uncategorized products or items that should receive additional categories) in the product list. The defined rules can then be applied via the <strong>Bulk Actions<\/strong> dropdown menu.<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[569,245504,472,243636,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-category-assignment","plugin_tags-keywords","plugin_tags-product-categorization","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=3336254","caption":"<p>Managing category keywords under <strong>WooCommerce &gt; Category Auto Rules<\/strong>. This is where you define relevant keywords for each existing product category. Rules support both inclusion and exclusion criteria, based on product titles.<\/p>"},{"src":"https:\/\/ps.w.org\/keyword-based-bulk-category-assignment-for-woocommerce\/assets\/screenshot-2.png?rev=3336254","caption":"<p>Selecting the products to be processed (e.g. uncategorized products or items that should receive additional categories) in the product list. The defined rules can then be applied via the <strong>Bulk Actions<\/strong> dropdown menu.<\/p>"}],"raw_content":"<!--section=description-->\n<p>This plugin helps you save hours of manual work when importing large batches of products that do not have any categories assigned. It allows you to define keyword-based rules per category and apply them in bulk to selected products.<\/p>\n\n<p><strong>Key Features:<\/strong>\n- Create flexible keyword rules per category.\n- Supports \"OR\" logic by default and \"AND\" logic via special syntax.\n- Exclude products via \"Not Contains\" keywords.\n- Bulk-apply rules to selected products in the Products list.\n- Import and export rules as JSON files for backup and transfer.<\/p>\n\n<p><strong>How It Works<\/strong><\/p>\n\n<p><strong>1. Create and Save Rules<\/strong><\/p>\n\n<p>1.1. Go to <strong>WooCommerce &gt; Keyword Category Rules<\/strong>.\n1.2. For each existing category, enter:\n     - <strong>Contains:<\/strong> keywords separated by commas (example: <code>shoes, sneakers<\/code>).\n     - <strong>Not Contains:<\/strong> keywords that should exclude a product (example: <code>damaged, used<\/code>).\n1.3. To require multiple words to appear together, use <code>\"AND\"<\/code> (with \"\") between them:\n     - Example: <code>shoes \"AND\" leather<\/code> matches titles containing both \"shoes\" and \"leather\".\n1.4. Save your rules.<\/p>\n\n<p><strong>2. Apply Rules to Products<\/strong><\/p>\n\n<p>2.1. In the WooCommerce Products (All products) list, select the products you want to process.\n2.2. In the <strong>Bulk Actions<\/strong> menu, choose <strong>Apply Keyword-Based Category Rules<\/strong>, then click <strong>Apply<\/strong>.\n2.3. The plugin will evaluate all selected products, assign matching categories, and show a success notice.<\/p>\n\n<p><strong>Limitations:<\/strong>\n- This plugin does not automatically assign categories to new products when they are created or imported. The assignment must be triggered manually via Bulk Actions.\n- The matching is performed against the <strong>product title only<\/strong>.\n\u2013 Currently, the plugin works in one direction only: it <strong>adds<\/strong> categories to products based on matching keyword rules, but it does <strong>not remove<\/strong> any previously assigned categories when the keywords are removed or changed. This means: If you remove a keyword from a rule or replace it with a different one, the plugin will not remove previously applied category assignments from affected products. Once a rule has been applied, its effects remain in place unless manually adjusted via the product edit screen or other third-party tools.<\/p>\n\n<h3>License<\/h3>\n\n<p>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<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> or install via the WordPress Plugin Installer.<\/li>\n<li>Activate the plugin.<\/li>\n<li>Go to <strong>WooCommerce &gt; Keyword Category Rules<\/strong> to configure and save your keyword rules.<\/li>\n<li>Apply rules to selected products on <strong>Products (All products) page<\/strong><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20are%20keywords%20evaluated%3F'><h3>How are keywords evaluated?<\/h3><\/dt>\n<dd><ul>\n<li>All keywords in <strong>Contains<\/strong> are evaluated with OR logic.<\/li>\n<li>You can enforce AND logic by separating words with <code>\"AND\"<\/code>.\n\n<ul>\n<li>Example: <code>red \"AND\" shoes<\/code> matches only if both \"red\" and \"shoes\" are in the title.<\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt id='what%20happens%20if%20a%20product%20matches%20multiple%20categories%3F'><h3>What happens if a product matches multiple categories?<\/h3><\/dt>\n<dd><ul>\n<li>All matching categories will be assigned simultaneously.<\/li>\n<\/ul><\/dd>\n<dt id='can%20i%20undo%20an%20assignment%3F'><h3>Can I undo an assignment?<\/h3><\/dt>\n<dd><ul>\n<li>No automatic undo is provided. You can manually remove categories from products in the WooCommerce Product Edit screen.<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Assign WooCommerce product categories in bulk using keyword rules. Ideal for batch-imported products without categories.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/242992","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=242992"}],"author":[{"embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/fradigital"}],"wp:attachment":[{"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=242992"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=242992"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=242992"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=242992"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=242992"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ca-valencia.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=242992"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}