=== Brandix for Product Brands ===
Contributors: maha25
Tags: woocommerce, brands, product brands, elementor, shortcode
Requires at least: 5.6
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage WooCommerce product brands with logos and descriptions. Show them via shortcode, sidebar widget, or Elementor grid & slider widgets.

== Description ==

Brandix for Product Brands adds a dedicated **Brands** taxonomy to WooCommerce, lets you attach a logo and description to each brand, and gives you several ways to display them on the front-end.

**Features**

* Custom Brand taxonomy linked to WooCommerce products
* Brand logo (thumbnail) and rich description
* Configurable display position on the single product page (above title, below add to cart, in tabs, etc.)
* `[brandix]` shortcode with full attribute support — also usable from any PHP template via `do_shortcode()`
* Sidebar / classic widget with logo + count
* Elementor "Brands Grid" widget
* Elementor "Brands Slider" widget (vanilla JS carousel, no external dependencies)
* WP.org standards: escaped output, sanitized input, translation ready, ABSPATH check, HPOS-compatible

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install through the Plugins screen.
2. Activate the plugin.
3. Go to **Products &rarr; Brands** to add brands and their logos.
4. Go to **WooCommerce &rarr; Brand Settings** to configure where brands appear on the single product page.

== Usage ==

= Shortcode =

`[brandix]`

Attributes (all optional):

* `limit` – number of brands (default `-1` = all)
* `columns` – 1–8 (default `4`)
* `orderby` – `name` | `slug` | `count` | `term_id`
* `order` – `ASC` | `DESC`
* `hide_empty` – `yes` | `no`
* `include` – comma-separated term IDs to include
* `omit` – comma-separated term IDs to skip
* `show_name` – `yes` | `no`
* `show_count` – `yes` | `no`
* `show_desc` – `yes` | `no`
* `image_size` – any registered image size (default `thumbnail`)
* `layout` – `grid` | `list`

Example:

`[brandix columns="6" limit="12" orderby="name" show_count="yes"]`

= In PHP templates =

`<?php echo do_shortcode( '[brandix columns="4" limit="8"]' ); ?>`

= Sidebar widget =

Appearance &rarr; Widgets &rarr; add "Product Brands" to any sidebar.

= Elementor =

Search the editor panel for "Brands Grid" or "Brands Slider".

== Frequently Asked Questions ==

= Does this work without Elementor? =

Yes. The shortcode and sidebar widget work everywhere. The Elementor widgets only load when Elementor is active.

= Is HPOS supported? =

Yes, the plugin declares compatibility with WooCommerce Custom Order Tables (HPOS).

== Changelog ==

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Brand taxonomy with logo upload.
2. Single product brand display.
3. Elementor Brands Grid widget.
4. Elementor Brands Slider widget.
