WP Manifestindependent plugin directory
manifest / ecommerce / wc-regional-catalog

WC Regional Catalog

Multi-regional product catalog for WooCommerce with individual prices per city/region.

by Konstantin Sorokin · github.com/kostyasorokin/wc-regional-catalog

★ 3stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/kostyasorokin/wc-regional-catalog/archive/refs/heads/main.zip
Readme github.com/kostyasorokin/wc-regional-catalog ↗

WC Regional Catalog (for WooCommerce)

WooCommerce Regional Catalog is an enterprise-grade extension that enables multi-regional pricing, localized stock visibility, and SEO-first city-specific routing for WooCommerce stores.

Designed for scalability, it abandons heavy database meta-queries in favor of native taxonomy filtering (tax_query), making it incredibly fast even for catalogs with thousands of products.

🚀 Key Features

  • SEO-First Regional Routing: Automatically generates physical-like URLs for regions (e.g., site.com/shop/kyiv/ or site.com/shop/kharkiv/ or site.com/shop/new-york/). Perfect for local SEO strategies and capturing low-hanging fruit in regional search queries.
  • Dynamic Pricing Engine: Set custom Regular and Sale prices per city/region without duplicating products. Prices are seamlessly updated in the catalog, cart, and checkout.
  • Enterprise XML Feeds: Built-in, zero-configuration Google Merchant Center RSS 2.0 feed generator. Generates isolated feeds per region (e.g., /?wcrc_feed=1&region=new-york) for hyper-targeted Google Shopping campaigns.
  • Strictly OOP & PSR-4: Built with modern PHP 8.3 standards, utilizing Composer for autoloading and maintaining a clean, modular architecture.
  • Zero Frontend Bloat: No heavy JavaScript or unnecessary CSS injected into the frontend. Pure server-side rendering for maximum Core Web Vitals performance.

🛠 Installation

Since this plugin utilizes modern PHP practices and Composer, it should be installed via CLI.

  1. Install the Plugin Choose one of the following methods to get the plugin files:
Option A: Manual Upload (Recommended)
  • Download the plugin as a .zip file.
  • Upload the extracted folder to the /wp-content/plugins/ directory.
Option B: Via Git (For Developers)
  • Clone or download the repository into your WordPress plugins folder:
     cd wp-content/plugins/
 git clone https://github.com/kostyasorokin/wc-regional-catalog.git
  1. Activate the plugin through the 'Plugins' menu in WordPress.
  2. Go to Products -> Regions to add your target cities.
  3. (Optional) Set one city as the Default Region.
  4. Edit any product to set Regional Prices in the Product Data meta box.
  5. Place the [wc_region_switcher] shortcode in your theme.

🔗 Features & Usage

Displaying the Switcher

There are two ways to display the region selector:

  1. Shortcode: Place [wc_region_switcher] in any page, post, or widget.
  2. PHP Helper: For theme developers, use the static helper in your template files:
    <?php if (class_exists('\WCRC\App\Switcher')) \WCRC\App\Switcher::display(); ?>

Google Merchant Center Integration

Each region automatically gets its own XML product feed for highly targeted Google Shopping campaigns.

Feed URL Format:

  • site.com/?wcrc_feed=1&region=city-slug
  • site.com/?wcrc_feed=1&region=kharkiv
  • site.com/?wcrc_feed=1&region=london