WPForms Documentation

Documentation, Reference Materials and Tutorials for WPForms

How to Install and Use the Post Submissions Addon in WPForms

Would you like to let your users create a WordPress post by submitting a form? With the Post Submissions addon for WPForms, you can easily accept guest post submissions, user submitted events, and more.

In this article, we will show you how to install and use the Post Submissions addon for WPForms.

  1. Create a Post Submissions Form
  2. Customizing Post Submissions Settings
Requirements: You will need a Pro license level or higher to access the Post Submissions addon.

1. Create a Post Submissions Form

Before we get started, be sure to install the WPForms plugin on your WordPress site.

Once WPForms is installed and activated, the next step is to install the Post Submissions addon.

Now that the Post Submissions addon has been installed to your site, we need to create a form that will accept new posts. For this example we’ll create a new form, however you can modify an existing form to accept post submissions if you’d prefer.

To create a new form, go to WPForms » Add New in your site’s WordPress menu.

Add new form in WPForms

From the templates list, we’ll select Blog Post Submission Form. This template will already include all the fields we need to create a standard WordPress blog post.

Create a new Blog Post Submission form

After choosing the template, the form builder will open. By default, this template will include the following fields:

Blog Post Submission Form template

  • Author Details
    • Name
    • Email
    • Short Author Bio
  • Create a Blog Post
    • Post Title
    • Post Content
    • Featured Image
    • Post Excerpt
    • Category

You can change these fields however you’d like, delete fields, or add new fields depending on what information you’d like included in the blog post.

Note: The Blog Post Submission Form template includes all of the fields that you can connect to a standard WordPress post.

For an example that uses a custom post type, please check out our tutorial on accepting user-submitted events.

2. Customizing Post Submissions Settings

When you feel your form is ready, click on Settings in left form builder menu and then select the Post Submissions tab.

To enable the creation of posts, make sure that the Post Submissions dropdown is set to On.

Enable Post Submissions in WPForms

If you’re using the default Blog Submissions Form template, the settings on this page will already be completed for you. Whether using the template or a custom form, though, it’s a good idea to check through these settings.

Available settings for WPForms post submissions addon

Here are the available Post Submissions settings and a description of each:

  • Post Title: The title of the blog post
  • Post Content: The main body of the post
  • Post Excerpt: Used by many themes when displaying a list of posts (more details)
  • Post Featured Image: Used in many themes to visually represent a post (more details)
  • Post Type: Options will include Posts or Pages by default, but any custom post types will be available also (more details)
  • Post Status: Choose whether submitted posts get published right away or wait for your review. Options are Draft, Pending Review, Private, or Published (more details)
  • Post Author: Choose a user to assign as the author. If the user is registered to your site, the Current User option will assign them as the author.

Allowing Users to Select a Post Category

By default, the Post Submissions template will include a Dropdown field named Category. This will include a list of all Post Categories on your site. However, you can also add this list to a different template or swap the Dropdown field out for a Checkboxes or Multiple Choice field.

To do this, first be sure to add the field type you’d like to use to your form. Then, click on this field to open its Field Options panel and open the Advanced Options section.

Towards the bottom of this section, you should see a dropdown labeled Dynamic Choices. This will need to be set to Taxonomy for post submissions. Then, under Dynamic Taxonomy Source, select Categories.

Advanced Options for the Category field

That’s it! You can now easily allow your users to add posts to your WordPress site.

Next, would you like to collect payment for before you allow guests to submit a post? Be sure to check out our tutorials on adding Stripe or PayPal payments to your forms for all the details.

Changelog

1.0.4 (2017-08-21)

  • Changed: Template uses new `core` property so it displays with other core templates

1.0.3 (2017-03-09)

  • Added: Improved integration for storing The Events Calendar post meta

1.0.2 (2017-02-23)

  • Fixed: Capitalized letters not being allowed in custom post meta keys

1.0.1 (2017-01-17)

  • Fixed: Possible error if custom meta fields were setup but incomplete

1.0.0 (2016-10-05)

  • Initial release.