=== StackWC Custom Permalinks for WooCommerce ===
Contributors: stackwc, ilmosys, mahdiali
Tags: woocommerce permalinks, custom permalinks, product url, category url, seo urls
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
WC requires at least: 7.2
WC tested up to: 11.0

Custom Permalinks Manager for WooCommerce allows you to change WooCommerce permalinks and remove product and category slugs from URLs.

== Description ==

<a href="https://stackwc.com/plugins/custom-permalinks-for-woocommerce/?utm_source=wprepo&utm_medium=link&utm_campaign=plugin" title="StackWC - Custom Permalinks for WooCommerce">Custom Permalinks for WooCommerce</a> helps store owners create short, readable, search-friendly WooCommerce URLs without complex code.

Whether you want `/product-name`, `/category/product-name`, or `/shop/category/product-name`, this plugin gives you practical global controls to match your SEO strategy and store structure.

Perfect for:

* WooCommerce stores migrating to cleaner URLs
* SEO-focused stores that want consistent URL structures
* Merchants who want store-wide permalink customization without code
* Teams that want easier URL management without custom development

== Free Features ==

* Global WooCommerce product permalink structure controls (default, product slug only, with category, full path)
* Global product category permalink structure controls
* Remove product base where applicable
* Remove category base where applicable
* Redirect wrong product/category URLs to the canonical URL (301)
* Use Yoast SEO primary category for product paths (optional)
* Canonical link tags and breadcrumb support (optional)
* Works with WooCommerce permalink settings and routing
* Compatible with modern WordPress and WooCommerce versions

== Pro Features (separate plugin) ==

Pro is available as a separate plugin at [stackwc.com](https://stackwc.com/plugins/custom-permalinks-for-woocommerce/). Pro adds:

* Per-product permalink structure selection from product edit sidebar
* Per-product custom permalink path support
* SKU-based product URLs (global and per-product)
* Optional URL suffixes (for example `.html`)
* Automatic redirects when permalink structures change
* Remove product tag base from URLs
* Remove "Shop" from breadcrumbs
* Automatic rewrite refresh when product permalink structure, custom permalink, or SKU changes

== SEO Benefits ==

* Clean URLs improve click-through and user trust
* Consistent permalink patterns help crawl efficiency
* Reduced duplicate URL risk with canonical-friendly behavior
* Easier URL migration planning for category and product pages
* Supports readable, keyword-friendly product paths


###StackWC Recommended Plugins###
- <a href="https://stackwc.com/plugins/woc-order-alert/?utm_source=wprepo&utm_medium=link&utm_campaign=footer_plugin_name">Order Notification for WooCommerce</a>
- <a href="https://stackwc.com/plugins/product-tabs-for-woo/?utm_source=wprepo&utm_medium=link&utm_campaign=footer_plugin_name">Custom Product Tabs for WooCommerce</a>
- <a href="https://stackwc.com/plugins/quick-buy-now-button-for-woocommerce/?utm_source=wprepo&utm_medium=link&utm_campaign=footer_plugin_name">Quick Buy Now Button for WooCommerce</a>
- <a href="https://stackwc.com/plugins/woc-open-close/?utm_source=wprepo&utm_medium=link&utm_campaign=footer_plugin_name">Open Close Store for WooCommerce</a>

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/stackwc-custom-permalinks-for-woocommerce` directory, or install via WordPress Plugins screen.
2. Activate the plugin through the `Plugins` screen.
3. Go to `WooCommerce > Settings > Custom Permalinks`.
4. Choose product and category permalink structures.
5. Save settings and regenerate permalinks.

== Frequently Asked Questions ==

= Is this plugin SEO friendly? =
Yes. The plugin is designed for SEO-friendly WooCommerce URLs with clean structures and better canonical behavior for custom permalink routes.

= Does it support WooCommerce default permalink settings? =
Yes. You can keep WooCommerce default structures or switch to custom structures. The plugin is built to work with WooCommerce permalink bases.

= Can I set permalink structure per product? =
Per-product permalink control is available in the separate Pro plugin. The free plugin includes fully functional global permalink settings.

= Does `.html` suffix work for products and categories? =
URL suffix support (for example `.html`) is a Pro feature available in the separate Pro plugin.

= What happens when I change a product SKU? =
SKU-based product URLs are a Pro feature. With Pro active and licensed, rewrite refresh is scheduled automatically after SKU changes.

= Will changing permalinks affect my existing SEO? =
Any URL change can affect SEO if old URLs are not redirected. The free plugin redirects non-canonical product and category URLs to the canonical URL (301). Pro adds automatic redirects when permalink structures or custom paths change.

= Is Pro included in this download? =
No. Pro is a separate plugin sold at stackwc.com. This WordPress.org package contains only fully functional free features. Upgrade prompts are informational links only.

== Screenshots ==
1. Customize product and category URL structures for better SEO and cleaner permalinks.
2. Use primary category and SEO options for cleaner, search-friendly product URLs.
3. Free vs Pro comparison and upgrade information in settings.

== Changelog ==
= 1.0.4 - 31 August, 2026 =
* Added: JavaScript translation support for the admin settings app
* Fixed: REST API permissions now require manage_woocommerce only
* Fixed: Readme FAQ clarifies free canonical redirects vs Pro migration redirects
* Fixed: Pro upsell wording for redirect features
* Fixed: Escaping and i18n for settings and StackWC dashboard links
* Updated: Tested up to WooCommerce 11.0
* Updated: Tested up to WordPress 7.1

= 1.0.3 - 21 July, 2026 =
* Updated: Tested up to WooCommerce 10.9
* Updated: Tested up to WordPress 7.0

= 1.0.2 - 16 July, 2026 =
* Removed: All premium code, license gates, and locked UI from the WordPress.org package
* Fixed: Free plugin includes only fully functional features; upgrade prompts are informational links only

= 1.0.1 - 04 April, 2026 =
* Integrated with Freemius for licensing and updates
* UI improvements and styling updates
* Improved rewrite handling for WooCommerce default and custom product/category URL structures
* Improved optional URL suffix routing behavior (including `.html`) across product and category URLs in PRO
* Fixed per-product custom structure URL resolution for: in PRO
  * Product slug only
  * Product with category
  * Full path
  * SKU-based product URLs
* Added automatic rewrite refresh scheduling on: in PRO
  * single product permalink structure change
  * single product custom permalink change
  * product SKU change
* Improved reliability so permalink changes apply without manual permalink settings save in common flows

= 1.0.0 =
* Initial release