=== Auction Lister ===
Contributors: halfnibble
Tags: ebay, auctions, embed, widget, ecommerce
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show your live eBay auctions on your WordPress site — searchable, browsable, always in sync. Free widget from auctionlister.pro.

== Description ==

Auction Lister embeds a live, searchable showcase of your eBay auctions
anywhere on your WordPress site.

*   Grid and list views with countdown timers and bid counts
*   Keyword search and category filters, generated from your live listings
*   Renders inline in your page — isolated styling that can't clash with
    your theme, flows and resizes like normal content (an iframe mode is
    also available)
*   Always in sync with eBay — no importing, no maintenance
*   100% free: the widget is funded by eBay Partner Network referrals, not by you

**Getting started**

1.  Get your free widget key at [auctionlister.pro](https://auctionlister.pro) —
    just type your eBay store name.
2.  Install this plugin.
3.  Drop `[auction_lister key="YOUR-WIDGET-KEY"]` into any page or post, or
    use the **Auction Lister** block. Optionally set a default key and
    default display options (theme, view, size, photo shape, background,
    height) under *Settings → Auction Lister*.

**Shortcode options**

`[auction_lister key="..." theme="dark" view="list" size="compact" background="transparent"]`

*   `key` — your widget key (falls back to the default from settings)
*   `embed` — `inline` (default: renders directly in the page) or `iframe`
*   `theme` — `light`, `dark`, `material`, or `business`
*   `view` — `grid` or `list`
*   `size` — `compact`, `standard`, or `large` listing cards
*   `aspect` — listing photo shape: `standard` (4:3) or `tall` (3:4, great
    for trading cards and other portrait items)
*   `background` — `solid` or `transparent`; transparent lets your page show
    through around the listings while the listing cards keep their own
    background
*   `height` — iframe mode only: initial height in pixels before the frame
    auto-sizes (default 720)

Options you leave out fall back to the defaults from *Settings → Auction
Lister*, then to the widget's own settings from your auctionlister.pro
dashboard.

eBay is a trademark of eBay Inc. This plugin is not affiliated with,
endorsed by, or sponsored by eBay Inc.

== Installation ==

1.  Install and activate the plugin through the Plugins screen, or upload
    the plugin folder to `/wp-content/plugins/auction-lister/`.
2.  Get your free widget key at [auctionlister.pro](https://auctionlister.pro) —
    just enter your eBay store name.
3.  Add `[auction_lister key="YOUR-WIDGET-KEY"]` to any page or post, or
    use the **Auction Lister** block. Site-wide defaults live under
    *Settings → Auction Lister*.

== External Services ==

This plugin is a front-end for the **auctionlister.pro** service, operated
by Auction Lister. It connects to auctionlister.pro to render your live
eBay listings and cannot function without it.

What is sent, and when:

*   On every page view where the widget is embedded, the visitor's browser
    loads the widget script (inline mode) or the embed page (iframe mode)
    and the widget's listing data from auctionlister.pro. As with any web
    request, the visitor's IP address, user agent, and referring page URL
    are transmitted to the service.
*   The widget key you configure is sent to identify which seller's
    listings to show.
*   No WordPress user accounts, emails, credentials, or other site data
    are sent.

Service terms: [auctionlister.pro/terms](https://auctionlister.pro/terms)
Privacy policy: [auctionlister.pro/privacy](https://auctionlister.pro/privacy)

== Screenshots ==

1. The widget in the classic light theme — live listings with search, category filter, sorts, and grid/list views.
2. The classic dark theme.
3. The Material theme.
4. The Business theme.

== Frequently Asked Questions ==

= Does this need my eBay password? =

No. Auction Lister only reads your public listings via eBay's official API.

= How much does it cost? =

Nothing, ever. When a visitor clicks through to eBay and buys, eBay pays
auctionlister.pro a small referral commission. Your prices don't change.

= Why does the plugin load a script from auctionlister.pro? =

Auction Lister is a front-end for the auctionlister.pro service — your live
listings, search, and category data are served by it in real time, so the
widget cannot work without connecting to it. The default inline embed loads
the service's widget script (the same widget the iframe mode shows) and
renders it inside an isolated shadow root, so it can't affect the rest of
your page's styles or content. If you prefer full frame isolation, set the
embed mode to iframe under *Settings → Auction Lister*.

== Changelog ==

= 1.4.0 =
* New photo shape option (`aspect="tall"`) — 3:4 portrait listing photos for
  trading cards and other tall items, alongside the standard 4:3.
* Photo shape control in the block and a site-wide default under
  Settings → Auction Lister.

= 1.3.0 =
* New default inline embed: the widget renders directly in the page inside
  an isolated shadow root — no iframe, natural page flow, responsive to the
  space it's given. Existing embeds switch automatically.
* `embed="iframe"` shortcode attribute, block control, and site-wide
  setting to keep the previous iframe behavior.
* Multiple iframe embeds on one page now auto-resize independently.
* Block editor strings are now translatable.
* Plugin options are removed from the database on uninstall.

= 1.2.0 =
* New transparent background option (`background="transparent"`) — the widget blends into your page while listing cards keep their own background.
* Settings → Auction Lister now holds site-wide defaults for theme, view, size, background, and height.
* The block gained Listing size and Background controls.

= 1.1.0 =
* Iframes now auto-resize to fit the widget content (no inner scrollbars).
* New size attribute (compact/standard/large) and Material/Business themes.

= 1.0.0 =
* Initial release: shortcode, Gutenberg block, default-key setting.
