WP Manifestindependent plugin directory
manifest / ecommerce / compatible-products

Compatible Products for WooCommerce

Suggests compatible products (cross-sell) based on WooCommerce product attributes. Includes Bricks Builder Query Type integration.

by Ale Aruca · github.com/aaruca/compatible-products · website

★ 0stars
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/aaruca/compatible-products/archive/refs/heads/main.zip
Readme github.com/aaruca/compatible-products ↗

Suggests compatible products (cross-sell) based on WooCommerce product attributes. Perfect for firearms stores.

Compatible Products for WooCommerce analyzes product attributes to suggest truly compatible accessories and related products. Unlike basic cross-sell features, this plugin understands the relationships between firearms, ammunition, magazines, optics, and accessories.

🚀 Features

  • Intelligent Matching - Uses caliber, model, mount type, and other attributes to find genuinely compatible products
  • Bricks Builder Integration - Custom Query Type for use with Query Loops
  • High Performance - Bulk data loading with optimized SQL queries (4 queries instead of 5000+)
  • Caching - Results cached for fast repeat visits
  • Flexible Filtering - Filter by product type, stock status, categories
  • Shortcode Support - Use anywhere with [compatible_products]

🔧 Supported Product Types

  • Firearms (rifles, pistols, shotguns)
  • Ammunition
  • Magazines
  • Optics (scopes, red dots, rangefinders)
  • Mounts and adapters
  • Suppressors
  • Holsters
  • Handguards and parts
  • Cleaning supplies
  • Bipods and tripods

⚙️ Requirements

  • WordPress 6.0+
  • WooCommerce 8.0+
  • PHP 8.0+
  • Bricks Builder 1.9+ (optional, for query loop integration)

📦 Installation

  1. Upload the compatible-products folder to /wp-content/plugins/
  2. Activate the plugin through the 'Plugins' menu
  3. Go to WooCommerce → Compatible Products to configure
  4. Use the Bricks Builder Query Type or shortcode on your product pages

❓ Frequently Asked Questions

What product attributes are used?

The plugin uses: caliber-gauge, product-type, model, model-fit, brand-fit, atf-type, mount-type, thread-pattern, style, and more.

Does this work without Bricks Builder?

Yes! You can use the [compatible_products] shortcode on any page or template.

How does caching work?

Results are stored as WordPress transients (24 hours by default). Cache is automatically cleared when products are updated.

📝 Changelog

1.0.0

  • Initial release
  • Bricks Builder Query Type integration
  • Shortcode [compatible_products]
  • Admin settings page with test tool
  • Support for 10+ product types
  • Caliber and mount type normalization
  • Caching with auto-invalidation