ONE FORM

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.

FAQ

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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“ONE FORM” is open source software. The following people have contributed to this plugin.

Contributors

Translate “ONE FORM” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

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