=== Plvgin Brand Showcase for Elementor ===
Contributors: plvgin
Tags: elementor, woocommerce, brands, product brand, brand showcase
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://buymeacoffee.com/bravo2

Display all your WooCommerce product brands in a beautiful, fully-customisable Elementor widget — dynamically, with zero manual entry.

== Description ==

**Plvgin Brand Showcase** adds a professional **Brand Showcase** widget to your Elementor panel. It automatically reads your WooCommerce brand taxonomy and renders every brand as a premium, hover-animated card — complete with logos, names, product counts, and a live search bar.

= Key Features =

* **Auto-detects** the brand taxonomy from popular plugins (Perfect WooCommerce Brands, YITH WooCommerce Brands, or any custom taxonomy)
* **Zero manual entry** — brands are fetched live from your database
* **Monogram placeholder** when a brand has no logo set
* **Live search bar** — filter brands client-side with no page reload
* **Product count badge** on each card
* **Flexible card styles**: Logo Only / Logo + Name / Logo + Name + Count
* **Order by** Name, Product Count, or Random
* **Responsive grid** — configurable per breakpoint
* **Premium hover effects**: lift, glow, shimmer line, logo scale
* **Full Elementor style controls**: colours, typography, border, shadow, padding

= Requirements =

* WordPress 6.0+
* Elementor 3.5.0+ (free)
* A brand taxonomy (e.g. Perfect WooCommerce Brands or YITH Brands)
* PHP 7.4+

== Installation ==

1. Upload the `plvgin-brand-showcase` folder to `/wp-content/plugins/` or install via **Plugins → Add New**.
2. Activate the plugin.
3. Ensure **Elementor** and a brand taxonomy plugin are active.
4. Edit any page with Elementor and search for **"Brand Showcase"** under the *Plvgin Brand Showcase* category.

== Frequently Asked Questions ==

= Which brand plugins are supported? =

Perfect WooCommerce Brands (`pwb-brand`), YITH WooCommerce Brands (`yith_product_brand`), and any custom taxonomy by entering its slug manually.

= What if a brand has no logo? =

A monogram placeholder (first two letters) is shown automatically.

= Does the widget link to brand archive pages? =

Yes — enable "Link Cards to Brand Archive" in the widget settings.

= Will this slow down my site? =

No. The query uses `get_terms()` (cached by WordPress), and the search filter is pure vanilla JS with no jQuery dependency.

== Screenshots ==
1. Desktop view
2. Mobile view

== Changelog ==

= 1.0.0 – 2026-03-25 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.