=== Clipform - Video Forms, Quizzes & Surveys ===
Contributors: clipform
Tags: form, quiz, survey, video, embed
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed interactive video forms, quizzes and surveys from Clipform with a block or the [clipform] shortcode. Paste a Form ID - no account needed in WP.

== Description ==

[Clipform](https://www.clipform.io) is a video-first form builder: interactive video forms, quizzes and surveys that respondents answer by tapping, typing, or recording their own video and audio replies. This plugin embeds your published Clipform forms anywhere on your WordPress site.

You build and publish forms at clipform.io, then drop them into a post, page or widget here with a block or a shortcode. The plugin is a thin client that renders the form inline on your page.

**Features**

* **Clipform block** - add the "Clipform" block, paste your Form ID, and a preview appears in the editor.
* **`[clipform]` shortcode** - `[clipform id="abc12345"]` works in any post, page or text widget.
* **Inline embeds** - the form renders right in your content; set a max width to fit your layout.
* **Mobile-friendly** - portrait video that expands to fullscreen on phones, or stays inline if you prefer.
* **Multiple forms per page** - add as many as you like; the embed SDK loads only once.
* **No account or API key in WordPress** - just paste your form's Form ID.
* **Lightweight** - no database tables, no cookies set by the plugin, no admin dashboard clutter. The embed script loads only on pages that contain a Clipform.

**Third-party service**

Clipform is a hosted (SaaS) service. To display a form, this plugin loads Clipform's embed SDK from `https://js.clipform.io/embed.js` and renders a container element that the SDK fills in. Forms are created, stored and served by Clipform; this plugin only renders them. By embedding a form you are using the Clipform service, subject to its terms:

* Terms of Service: https://www.clipform.io/terms
* Privacy Policy: https://www.clipform.io/privacy

== Installation ==

1. Install the plugin through **Plugins > Add New**, or upload the plugin folder to `/wp-content/plugins/`, then activate it.
2. Publish a form at [clipform.io](https://www.clipform.io) and open its **Share** dialog to copy the **Form ID** - the short code at the end of the share link (e.g. the `abc12345` in `clipform.io/abc12345`).
3. Edit a post or page, add the **Clipform** block, and paste the Form ID into the block sidebar. Or use the shortcode: `[clipform id="abc12345"]`.
4. Publish or update the post. The form renders inline for your visitors.

**Shortcode options**

* `id` - your form's Form ID (required), e.g. `[clipform id="abc12345"]`
* `max-width` - maximum width in pixels, e.g. `[clipform id="abc12345" max-width="600"]`
* `inline-on-mobile` - set to `true` to keep the form inline on phones instead of expanding to fullscreen, e.g. `[clipform id="abc12345" inline-on-mobile="true"]`

== Frequently Asked Questions ==

= Where do I find my Form ID? =

In the Clipform dashboard, open a published form and click **Share**. The Form ID is the short code at the end of the share link (for example, `abc12345` in `clipform.io/abc12345`). Paste just that code into the block or shortcode.

= Do I need a Clipform account or API key? =

You need a Clipform account to *build* a form, but the WordPress plugin itself needs no account, login or API key. It only needs the public Form ID of a form you've already published.

= Why does the plugin load a script from clipform.io? =

Clipform is a hosted service. The interactive form is rendered by Clipform's embed SDK (`embed.js`), which the plugin loads over HTTPS from `https://js.clipform.io/embed.js`. Loading it from Clipform (rather than bundling a copy) means your embedded forms always run the current, secure version and keep working without plugin updates. The script is only enqueued on pages that actually contain a Clipform block or shortcode. Use of the service is subject to Clipform's [Terms of Service](https://www.clipform.io/terms) and [Privacy Policy](https://www.clipform.io/privacy).

= What data does the plugin send to Clipform? =

The plugin renders an embed container holding your form's Form ID and your site's hostname (so Clipform can attribute the embed). Respondent answers are collected by the Clipform service itself, governed by Clipform's Privacy Policy. The plugin stores no data in your WordPress database and sets no cookies of its own.

= The form doesn't show up on my page. =

This is almost always a caching or security plugin stripping the embed or blocking the script. If you use a page-cache (e.g. WP Super Cache, W3 Total Cache, LiteSpeed) or a security/firewall plugin (e.g. Wordfence), clear your cache after adding the block, and make sure it isn't removing the embed `<div data-embed-id="...">` or blocking requests to `clipform.io`. Forms also need to be **published** in Clipform before they will render.

= Can I embed more than one form on a page? =

Yes. Add as many blocks or shortcodes as you like - the embed SDK is loaded only once per page.

= Can I show the form as a popup or button? =

Not yet. This version renders forms inline within your content (with optional fullscreen on mobile). Popup / lightbox triggers are planned for a future release.

= Is Clipform free? =

Clipform offers free and paid plans. The WordPress plugin is free and works with any plan. See [clipform.io](https://www.clipform.io) for current pricing.

== Screenshots ==

1. The Clipform block in the editor, with a preview and the Form ID / width / mobile settings in the sidebar.
2. A published Clipform video form embedded inline on a page.
3. Adding a form with the `[clipform]` shortcode in a post.
4. A Clipform quiz rendered on the front end on mobile.

== Changelog ==

= 0.1.2 =
* The embed script now loads from Clipform's dedicated script host (js.clipform.io) instead of the marketing site. No change to how your forms look or behave.

= 0.1.1 =
* Embeds are now tagged as coming from WordPress in Clipform's analytics, so form issues can be attributed to this integration. No change to how your forms look or behave.

= 0.1.0 =
* Initial release: Clipform block and `[clipform]` shortcode for inline embeds, with max-width and inline-on-mobile options.

== Upgrade Notice ==

= 0.1.2 =
Embed script now served from js.clipform.io - no functional change.

= 0.1.1 =
Analytics attribution only - no functional change.

= 0.1.0 =
Initial release.
