=== Yilick ===
Contributors: yilick
Tags: marketplace, listings, ecommerce, business, grid
Requires at least: 5.0
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display your Yilick marketplace listings on any WordPress website. Official Yilick integration for sellers.

== Description ==

**Yilick Listings** connects your Yilick business to your WordPress website, automatically displaying your product listings in a beautiful, responsive layout.

**Features:**

* ** Flexible Layouts: Choose between Grid, List, or Both (with a modern toggle) for mobile devices.
* Professional Branding: Customize primary and accent colors to match your theme.bsite's colors
* **Category filtering** — Let visitors filter by product category
* **Multiple display options** — Shortcode, Gutenberg block, or sidebar widget
* **Analytics tracking** — Impressions and clicks are tracked in your Yilick dashboard
* **Smart caching** — Configurable cache to minimize API calls
* **No dependencies** — Lightweight, pure vanilla JS and CSS

== Installation ==

1. Upload the `yilick-listings` folder to `/wp-content/plugins/`
2. Activate the plugin through the "Plugins" menu in WordPress
3. Go to **Settings → Yilick Listings**
4. Enter your Yilick URL and business slug
5. Customize your branding colors
6. Add `[yilick_listings]` to any page or post, or use the Gutenberg block

== Shortcode Usage ==

Basic usage:
`[yilick_listings]`

With options:
`[yilick_listings limit="20" category="Electronics" show_filters="yes" hot_deals="no"]`

**Available parameters:**

* `limit` — Number of listings to show (default: from settings)
* `category` — Filter by a specific category name
* `show_filters` — Show category filter bar: "yes" or "no" (default: "yes")
* `hot_deals` — Show only hot deals: "yes" or "no" (default: "no")

== Frequently Asked Questions ==

= Where do I find my business slug? =

Your business slug is in your Yilick store URL. For example, if your store URL is `yilick.ug/store/my-shop`, your slug is `my-shop`.

= Does the plugin require an API key? =

No. The plugin uses the public listings API and only requires your business slug.

= Will the listings update automatically? =

Yes. The plugin fetches listings from the Yilick API. New listings appear automatically after the cache expires (default: 15 minutes).

= Can I use the plugin on multiple pages? =

Yes. You can add the shortcode or Gutenberg block to as many pages as you like.

== Screenshots ==

1. Settings page with branding customization
2. Desktop grid layout
3. Mobile list layout
4. Gutenberg block in the editor

== Changelog ==

= 1.0.0 =
* Initial release
* Shortcode, Gutenberg block, and widget support
* Responsive grid/list layout
* Category filtering
* Impression and click tracking
* Configurable caching
