Dokan Conditional Category Attributes — Documentation

1. Overview

Dokan Conditional Category Attributes is a WordPress plugin that restricts WooCommerce global product attributes in the Dokan vendor dashboard based on product category. Administrators configure which attributes are allowed per category; vendors then see only those attributes when creating or editing products in those categories.

What it solves: In standard WooCommerce + Dokan setups, vendors see every global attribute regardless of category. This causes confusion, data-entry errors, and inconsistent catalog taxonomy. This plugin gates attributes to relevant categories only.

Inheritance: Child categories inherit allowed attributes from parent categories unless they define their own. The system walks up the category tree until it finds a configured ancestor.

2. Requirements

Required PHP extensions: cURL, mbstring, JSON, OpenSSL.

3. Installation

1. Go to Plugins → Add New → Upload Plugin in your WordPress admin.

2. Upload the plugin .zip file and activate it.

3. After activation, go to Authorization Manager in the left sidebar to activate your license.

4. License Activation

4.1 First-Time Activation

1. Navigate to Authorization Manager in the WordPress admin sidebar.

2. Enter your authorization token (format: DKN-XXXX-XXXX-XXXX-XXXX).

3. Click Activate Authorization.

4. The status badge turns green with a pulsing dot when active.

4.2 What Happens If Not Activated

• The attribute configuration interface on category pages is locked with an overlay.

• Vendors see the default unfiltered attribute list.

• A dismissible admin notice prompts activation on every admin page.

4.3 License Tiers

4.4 Managing Your License

• Sync Now: Refreshes license data from the server. Use if you recently renewed or upgraded.

• Deactivate: Releases the license from this domain so it can be used elsewhere. Requires confirmation via modal.

• Replace Authorization: Enter a new token to switch tiers or replace an expired license without manual deactivation.

4.5 Checking for Plugin Updates

The plugin checks for updates automatically via WordPress’s built-in update system. To check manually:

1. Go to Authorization Manager.

2. In the Plugin Updates card, click Check for Updates Now.

3. If an update is available, click Go to Updates Page to install via Dashboard → Updates.

5. Category Attribute Mapping

5.1 Configuring Allowed Attributes

1. Go to Products → Categories in WordPress admin.

2. Create a new category or click Edit on an existing one.

3. Scroll to the Allowed Attributes section.

4. Click Configure Allowed Attributes.

5. In the modal, search and select the attributes relevant to this category.

6. Click Apply Selections.

7. Selected attributes appear as removable chips below the button.

8. To remove an attribute: Click the × on the chip, or reopen the modal and uncheck it.

No selection = no restriction. If you leave a category unconfigured, vendors see all global attributes for products in that category.

5.2 Hierarchical Inheritance

Child categories inherit from parents unless they define their own set.

7. Frontend Category Pages

On WooCommerce category archive pages, the plugin filters layered navigation widgets and attribute filters to show only attributes relevant to that category. Customers won’t see irrelevant filter options.

8. Product Save Validation

When any product is saved (backend, Dokan frontend, CSV import, REST API, etc.), the plugin ensures only permitted global attributes are retained. Custom attributes and all other product data are preserved.

This prevents data integrity violations even if vendors bypass the JavaScript UI.

9. System Status

Go to Authorization Manager to view your system status at a glance, or see the full System Status page for detailed diagnostics.

10. Troubleshooting

11. Support

• Documentation: https://dokanconditionalattribute.com/documentation/

• Support Email: help@dokanconditionalattribute.com

• Contact Form: https://dokanconditionalattribute.com/contact/

12. Changelog

See release notes in the Plugin Updates section of the Authorization Manager.