runthings.dev

<p>Category Children Coupons for WooCommerce provides a complete replacement for WooCommerce’s built-in coupon category restrictions with additional flexibility:</p>
<p><strong>Include children mode:</strong> Select a parent category and all its subcategories are automatically included. With WooCommerce’s default restrictions, selecting “Clothing” only matches products directly in that category – not products in “T-Shirts” or “Trousers” subcategories. This plugin includes the entire category tree.</p>
<p><strong>Exclude children mode:</strong> Match only the specific categories you select, without including subcategories. This mirrors WooCommerce’s built-in behavior but is managed within this plugin’s unified interface.</p>
<p><strong>Future-proof coupons:</strong> The plugin stores your category selection and dynamically expands child categories at validation time – new subcategories are automatically included (or excluded) without editing existing coupons.</p>
<h4>Features</h4>
<ul>
<li>Four category restriction fields for complete control:
<ul>
<li>Product categories (incl. children) – allowed categories with all descendants</li>
<li>Exclude categories (incl. children) – blocked categories with all descendants</li>
<li>Product categories (excl. children) – allowed categories only, no descendants</li>
<li>Exclude categories (excl. children) – blocked categories only, no descendants</li>
</ul>
</li>
<li>Automatic subcategory handling based on your preference</li>
<li>Works alongside WooCommerce’s other (non-category coupon) restrictions</li>
<li>Customizable error messages via filter</li>
<li>AutomateWoo compatibility – category restrictions are copied when generating coupons from templates</li>
</ul>
<h4>How It Works</h4>
<p>When you select a category in an “(incl. children)” field, the plugin automatically includes all subcategories during validation. When you use an “(excl. children)” field, only the exact categories you select are matched. Selected categories with children included are validated at usage time, so the current children are automatically used, even if they have changed since the coupon was set up.</p>
<h3>Filters</h3>
<h4>runthings_category_children_coupons_error_message</h4>
<p>Customize the error message shown when a coupon fails category validation.</p>
<p><strong>Parameters:</strong></p>
<ul>
<li><code>$message</code> (string) – The default error message.</li>
<li><code>$context</code> (array) – Contains ‘coupon’ (WC_Coupon object) and ‘type’ (‘allowed’, ‘excluded’, ‘allowed_excl’, or ‘excluded_excl’).</li>
</ul>
<p><strong>Example:</strong></p>
<p>See <a href="https://github.com/runthings-dev/runthings-category-children-coupons#filters" rel="nofollow ugc">readme.md on GitHub</a> for detailed code examples.</p>
<h3>Additional Notes</h3>
<p>Built by Matthew Harris of runthings.dev, copyright 2025.</p>
<p>Visit <a href="https://runthings.dev/" rel="nofollow ugc">runthings.dev</a> for more WordPress plugins and resources.</p>
<p>Contribute or report issues at the <a href="https://github.com/runthings-dev/runthings-category-children-coupons" rel="nofollow ugc">GitHub repository</a>.</p>
<p>Icon – Discount by Gregor Cresnar, from Noun Project, https://thenounproject.com/browse/icons/term/discount/ (CC BY 3.0)</p>
<p>Icon – Tree view by Paweł Gleń from Noun Project, https://thenounproject.com/browse/icons/term/tree-view/ (CC BY 3.0) – https://thenounproject.com/icon/tree-view-3894745/</p>


Category Children Coupons for WooCommerce

Restrict WooCommerce coupons by product categories, with options to include or exclude child/descendant categories.

Francesco Sganga

<p>After installing WP Current Subcategories go to Widget Areas and add WP Current Subcategories widget:<br />
* <strong>Title</strong> – Choose the Title of Widget Section<br />
* <strong>Prefix</strong> – If checked add parent category name before subcategory name</p>
<p>Enjoy your new WordPress Plugin.</p>


WP Current Subcategories

After installing WP Current Subcategories go to Widget Areas and add WP Current Subcategories widget: * Title - Choose the Title of Widget Section * P …

Category Children Coupons for WooCommerce vs WP Current Subcategories