=== Plyrel Widgets ===
Contributors: plyrel
Tags: widgets, popup, spin wheel, contact form, countdown
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add your Plyrel widgets to WordPress with a block or a shortcode: prize wheels, forms, countdowns, quizzes, popups and more.

== Description ==

Plyrel is a library of interactive widgets you brand in a visual editor and add to any website. This plugin is the easy way to add them to WordPress.

* **A block for the editor.** Add the "Plyrel Widget" block and paste your embed code. It picks out the widget ID for you.
* **A shortcode for everywhere else.** `[plyrel id="wgt_abc12345"]` works in classic themes, sidebars and page builders such as Elementor and Divi.
* **Site-wide widgets.** List popups, announcement bars, cookie notices and floating contact buttons under Settings > Plyrel to load them on every page.
* **Nothing to slow you down.** One small script, loaded in the background, and only on pages that use a widget. Nothing runs on your server when a visitor views a widget.
* **Cannot clash with your theme.** Each widget is sealed off from your theme's styles.

You make and edit your widgets at plyrel.com. Changes you publish there appear on your site straight away, with nothing to update in WordPress.

Plyrel is free for up to three widgets, with unlimited views. Free widgets show a small "Powered by Plyrel" link; paid plans remove it.

== External services ==

This plugin shows widgets that are hosted by Plyrel. A Plyrel account is needed to make them.

On pages where you have placed a widget, the visitor's browser downloads the widget's script and settings from `cdn.plyrel.com`. As with any file on the web, that request includes the visitor's IP address and browser details. No cookies are set by that request and the plugin itself sends no other data.

Some widgets have features that send data elsewhere, and only when you set them up: a form sends what the visitor typed to the webhook or email service you chose.

* Service: [Plyrel](https://www.plyrel.com)
* [Terms of use](https://www.plyrel.com/terms)
* [Privacy policy](https://www.plyrel.com/privacy)

== Installation ==

1. In your WordPress admin go to Plugins > Add New Plugin > Upload Plugin, choose the zip file and press Install Now.
2. Press Activate.
3. Make and publish a widget at plyrel.com, then press Copy code.
4. Edit a page, add the "Plyrel Widget" block and paste the code into it.

== Frequently Asked Questions ==

= Where do I find my widget ID? =

In your Plyrel dashboard, press Embed on a published widget. The ID starts with `wgt_`. You can paste the whole embed code and the plugin will find it.

= The widget does not show in the editor. =

That is expected. The editor shows a placeholder; the widget itself appears on the live page.

= I added a widget and still cannot see it. =

Check that the widget is published and not paused in Plyrel. If you use a caching plugin, clear its cache.

= Does it work with page builders? =

Yes. Use the shortcode in the builder's Shortcode or Text element.

= Can I use a different address for the script? =

Developers can change it with the `plyrel_loader_url` filter.

== Changelog ==

= 1.0.0 =
* First release: block, shortcode and site-wide widgets.
