=== ONE FORM ===
Contributors: yamadaoneframe
Tags: form, contact form, embed, shortcode, iframe
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed forms published on ONE FORM into your WordPress site with a shortcode.

== Description ==

ONE FORM is a hosted form service that handles form building and response management in the cloud. This plugin connects your WordPress site to ONE FORM so you can place published forms on your pages.

* Connect to your ONE FORM organization with an API key
* Browse your published forms in the WordPress admin
* Copy a shortcode for any form and paste it into a post or page
* The form is rendered in an iframe on the public page

Creating forms, editing fields and reviewing submissions are done in ONE FORM. This plugin only handles embedding.

A ONE FORM account is required. See https://one-form.jp/ for details about the service and its pricing.

= External service =

This plugin communicates with ONE FORM (https://one-form.jp/).

* When you open the plugin settings screen or refresh the form list, the plugin sends a request to the ONE FORM API (https://app.one-form.jp/api/v1/forms) with your saved API key in order to retrieve your organization name and the list of published forms.
* On public pages, the browser loads the form page URL returned by ONE FORM inside an iframe.
* The API key is never printed to the page, the HTML source, or the shortcode output.

Terms of service: https://one-form.jp/terms
Privacy policy: https://one-form.jp/privacy

== Installation ==

1. Install and activate the plugin.
2. Issue an API key in your ONE FORM organization settings.
3. Open the "ONE FORM" screen in the WordPress admin and save the API key.
4. In each ONE FORM form setting, register this site's origin as an allowed embed URL.
5. Copy a shortcode from the form list and paste it into a post or page.

== Frequently Asked Questions ==

= The form does not appear on my page =

Check that this site's origin is registered as an allowed embed URL in the ONE FORM settings for that form. The exact origin to register is shown on the plugin's admin screen.

= Which shortcode attributes are available? =

`key` is required. `height` sets the height in pixels and defaults to 600. `title` overrides the iframe title.

`[oneform key="contact" height="600"]`

= Can I store the API key in wp-config.php? =

Yes. Define `ONEFORM_API_KEY` and that value takes precedence, which also hides the field in the admin screen.

`define( 'ONEFORM_API_KEY', 'of_live_xxxxxxxxx' );`

= Can I point the plugin at another environment? =

Yes. Define `ONEFORM_API_URL` or use the `oneform_api_url` filter. This is intended for testing against a staging environment.

== Changelog ==

= 1.0.0 =
* Initial release.
* Connect with an API key, retrieve the list of published forms, and embed them with the `[oneform]` shortcode.
