=== Deastek Sticker Swap ===
Contributors: deastek
Tags: stickers, collection, swap, block, elementor
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.5.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track duplicate and missing stickers, invite friends to a private swap group and organise swaps with a block, a shortcode or Elementor.

== Description ==

Every collector of team sport stickers knows the problem: duplicates pile up in boxes, wish lists get lost in group chats and nobody knows any more who is missing what.

Deastek Sticker Swap gives your friends, club or colleagues one organised place to swap stickers:

* **Albums**: paste the sticker list of your collection (`1-670`, `FWC1-FWC19` or `code;name;section` lines).
* **Private groups** with an invitation link to share on WhatsApp or by email.
* **My album**: one tap to add or remove a sticker, filters for missing stickers and duplicates, a ready-to-paste text of your list.
* **Automatic matches**: see at a glance which member has in duplicate what you are missing, and the reverse.
* **Fair 1-for-1 swaps**: 1 sticker given = 1 sticker received. A duplicate offered in a proposal is reserved: it is never promised to two members. Propose, accept, decline, cancel, complete. Inventories are updated automatically when a swap is completed.
* **Managers**: administrators can name accounts that run the tool (albums, groups) without being administrators. They keep their role and get the "Owner" badge in their groups.
* Works with the **block editor**: a "Sticker Swap Board" block with content and colour settings.
* Also available as a shortcode, `[deastek_sticker_swap]`, and as an **Elementor widget** when Elementor is active (optional).

Every feature is free and unlimited: albums, groups, members and swaps.

= Pro add-on =

[Deastek Sticker Swap Pro](https://deastek.fr/produit/deastek-sticker-swap-pro/) is a separate add-on sold on deastek.fr (monthly or yearly subscription for one domain). It adds features on top of this plugin and never unlocks anything in it:

* Sticker images in the album grid and in swap proposals, with bulk matching by file name.
* Image settings in Elementor.
* Top Collectors ranking and a completion contest with gifts for the first members who complete the album.
* Export / import of albums, images and members to another site.

Sticker images are uploaded by each site: no official sticker artwork is shipped. Elementor is not required.

= Privacy =

Everything stays on your site. Members see each other's nickname, duplicates and missing stickers, never email addresses. The plugin does not contact any external service. Personal data export and erasure tools of WordPress are supported.

== Installation ==

1. In Plugins → Add New, search for "Deastek Sticker Swap", install and activate it.
2. In Sticker Swap → Albums, create the sticker list of your collection.
3. Add the **Sticker Swap Board** block (category "Deastek") to a page and publish it. You can also use the `[deastek_sticker_swap]` shortcode or, with Elementor, the Sticker Swap Board widget.
4. In Sticker Swap → Settings, choose that page as the board page.
5. Log in, open the page, create a group and share the invitation link.

== Frequently Asked Questions ==

= Do members need an account? =

Yes, members are WordPress users so their inventory is kept. If you enable "Account creation from an invitation", people opening an invitation link can create a subscriber account themselves.

= Can a member be in several groups? =

Yes. The inventory is per album, so it is shared between groups using the same album.

= Is there a limit on swaps? =

No. Members can have as many swaps in progress as they want.

= What happens to swaps when a member leaves? =

Their swaps in progress in that group are cancelled. Completed swaps stay in the history.

= Do I need Elementor? =

No. Use the "Sticker Swap Board" block or the `[deastek_sticker_swap]` shortcode. With Elementor, the same board is also available as a widget.

Shortcode options: `title`, `matches`, `swaps` and `members` (`yes` or `no`), `logged_out_text`, `no_group_text`. Example: `[deastek_sticker_swap title="Club swaps" members="no"]`.

= Is any data deleted when I uninstall the plugin? =

Only if you tick "Delete data on uninstall" in the settings.

== Screenshots ==

1. My album: tap + and - to record each sticker, filter missing stickers and duplicates.
2. Matches: see who can give you what and propose a swap in one click.
3. Swaps: follow proposed, accepted and completed swaps.
4. Members: the group members and the invitation link to share.
5. The Sticker Swap Board block in the block editor, with its settings.
6. Albums admin screen: create an album from a list of sticker codes.

== Changelog ==

= 0.5.1 =
* Elementor widget: the labels of the My album, Matches, Swaps and Members tabs can be replaced (Content section). Empty fields keep the default labels.

= 0.5.0 =
* Managers: in Sticker Swap → Settings, administrators name accounts that manage the tool without being administrators. The account keeps its role and receives the "Manage the sticker swap" right (plus the right to upload files when it did not have it); both are removed with the manager or when the plugin is deleted.
* Managers see the Albums and Groups pages; Settings stay reserved to administrators. On the board, managers get the "Owner" badge and the invitation link of their groups.
* WooCommerce sites: managers can reach the administration of the tool.

= 0.4.4 =
* "Mark as completed" now asks for confirmation: only confirm once the stickers have really been handed over.
* Developers: the `expires_at` value an add-on adds to a swap is also displayed on accepted swaps (the free plugin itself has no countdown).

= 0.4.3 =
* Reserved stickers: a duplicate included in a pending or accepted proposal no longer appears in the other members' matches and cannot be promised twice (first come, first served).
* New developer hooks: `deastek_sticker_swap_swap_access`, `deastek_sticker_swap_validate_transition`, `deastek_sticker_swap_present_swap` and the `deastek-sticker-swap:group` browser event.

= 0.4.2 =
* Swaps are always balanced: 1 sticker given = 1 sticker received. The Send button stays disabled until both sides have the same number of stickers, and the server refuses unbalanced proposals.
* Matches where only one member can give show a notice instead of the Propose button.

= 0.4.1 =
* Duplicates filter: the badge now shows the spare copies only (the copy you keep is not a duplicate).
* Swap proposal: stickers are pre-selected in equal numbers on both sides, with a summary and a notice when the swap is unbalanced.
* New filter `deastek_sticker_swap_validate_proposal` to validate a proposal before it is saved.

= 0.4.0 =
* "Sticker Swap Board" block for the block editor (content, colours, tile width), with a demo preview in the editor.
* `[deastek_sticker_swap]` shortcode (title, matches, swaps, members, logged_out_text, no_group_text).
* Elementor is now optional; the plugin is renamed "Deastek Sticker Swap".

= 0.3.0 =
* Swaps in progress are no longer limited: every feature of the plugin is free and unlimited.
* The plugin is now updated from WordPress.org; the optional update check on deastek.fr is removed.


= 0.2.0 =
* Extension points for the Pro add-on: sticker images (`deastek_sticker_swap_album_items` filter, album edit and delete actions).
* The board displays sticker images when the Pro add-on provides them.
* Free / Pro comparison in the readme.

= 0.1.0 =
* First version: albums, private groups with invitation link, inventory, matches, swaps, Elementor widget, French translation.
