Frontend Post Submission Manager Lite - Documentation

Installing Instructions

  1. Upload the plugin files to the /wp-content/plugins/frontend-post-submission-manager-lite directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Frontend Post Submission admin menu to configure the available forms

Forms List

You can check all the available forms by clicking "All Forms" sub menu under "Frontend Post Submission". In free version there are two forms available. One is "Guest Post Form" and another is "Login Require Form" which you can use both simultaneously and configure them individually.

Frontend Post Submission forms

Basic Settings

Once the form is created, there are few configuration section which need to configure before starting to use in frontend. Basic settings section consists of all the basic options related with the form. Available options are:

 

  • Form Title
    • This is the title given while creating the form
  • Form Alias
    • This is the alias given to the form while creating the form. We don't recommend editing form alias because it is used to fetch all the necessary settings and list the post in the frontend post management dashboard
  • Post Status
    • As per your requirement, you can configure the post status of the submitted post such as Publish, Draft or Pending.
  • Post Format
    • This will list all the post format supported by your active theme. If your active theme doesn't support post formats then this option will not be available
  • Validation Error Message
    • In this field, you can enter the validation error message to show when any validation error occurs in the form.
  • Form Success Message
    • In this field, you can enter the message to display on the successful form submission
  • Redirection
    • With this option, you can enable the redirection after the successful form submission. There are two types of redirection. One is Redirect to Published Post or Custom URL

 

Login Settings

Please note that this section will only show when you are editing the "Login Require" type form. In this section, you can choose the login type. Available login types are:

  • Show Login Form
  • Show Login Message
  • Redirect to Login Page

Other options are generated as per the selected login type

Form Fields Settings

In this section you can configure all the necessary fields for the form. You can enable or disable existing fields, add custom fields. Pre available fields are

  • Post Title
  • Post Content
  • Post Image
  • Post Excerpt
  • Categories
  • Tags

 

Form field settings

Post Title

For post title, here are the available options:

  • Show on form - You can enable or disable it as per your need in the form
  • Required - You can make it required if required.
  • Field Label - This is the label which will actually be shown in the form when used in the frontend.
  • Field Note - This note will show just below the field. You can use this to give any extra information regarding the field.
  • Character Limit - You can set the character limit for the post title if required.

 

Post Content Settings

For post content, here are the available options:

  • Show on form - You can enable or disable it as per your need in the form
  • Required - You can make it required if required.
  • Field Label - This is the label which will actually be shown in the form when used in the frontend.
  • Field Note - This note will show just below the field. You can use this to give any extra information regarding the field.
  • Editor Type - Here are currently 4 editor types.
    • Simple Textarea - This editor is a simple textarea which doesn't have any editing tools
    • Rich Text Editor - This editor is the WYSIWYG editor which has both html and visual version which consists of text editing tools such as bold, italics
    • Visual Text Editor - This editor is the WYSIWYG editor which has only visual version without html version
    • HTML Text Editor - This editor is the WYSIWYG editor which has only HTML version without visual version
  • Media Upload - If you enable this option then the Visual or Rich Text Editor will have a functionality to upload various supported file types if any logged in users have the capability to upload the files in WordPress Media
  • Character Limit - You can set the character limit for the post content if required.

 

Post Image Settings

For post image, here are the available options:

  • Show on form - You can enable or disable it as per your need in the form
  • Required - You can make it required if required.
  • Field Label - This is the label which will actually be shown in the form when used in the frontend.
  • Field Note - This note will show just below the field. You can use this to give any extra information regarding the field.
  • Upload Button Label - This is the label for the image uploader.
  • Upload File Size Limit - If you want to set the size limit for the uploaded image then you can set through this field.
  • Max Size Error Message - This field is for the message to be displayed for upload file size limit.

Categories Settings

For post categories, here are the available options:

  • Show on form - You can enable or disable it as per your need in the form
  • Required - You can make it required if required.
  • Field Label - This is the label which will actually be shown in the form when used in the frontend.
  • Field Note - This note will show just below the field. You can use this to give any extra information regarding the field.
  • Field Type - There are two field types available for categories: Select Dropdown and Checkbox
  • First Option label - This option is for displaying the first label of the Select Dropdown. This option is available when you choose Select Dropdown as the field type
  • Display Child Categories of - In case you want to display child categories of a specific category, then you can choose one from dropdown.
  • Exclude Categories - In case you want to exclude some categories from displaying in the frontend, then you can add their slugs separated by comma in this field.
  • Auto Assign Categories - If you want to assign the submitted post to some specific categories then you can choose them in this field.

Tags Settings

For post tags, here are the available options:

  • Show on form - You can enable or disable it as per your need in the form
  • Required - You can make it required if required.
  • Field Label - This is the label which will actually be shown in the form when used in the frontend.
  • Field Note - This note will show just below the field. You can use this to give any extra information regarding the field.
  • Field Type - There are 3 field types available for categories: Select Dropdown, Checkbox and Textfield
  • First Option label - This option is for displaying the first label of the Select Dropdown. This option is available when you choose Select Dropdown as the field type
  • Auto Complete - If you enable this option then auto complete will generate the existing available tags and users can choose from existing tags or enter a new tag.
  • Auto Assign Tags - If you want to assign the submitted post to some specific tags then you can choose them in this field.

Custom Fields Settings

If the pre available fields are not sufficient then you can add custom fields which has various field types. The available fields types are:

  • Textfield
  • Textarea

 

While adding custom field, you will need to enter Label and Meta key. Label is for displaying the label in the form and meta key is for storing the custom field. While entering meta key, you shouldn't use any special characters or symbols except underscore(_). If you want to add custom field for receiving Street Address then meta key shall be street_address

Textfield Settings

Here are the options available for Textfield:

  • Show on form - You can enable or disable it as per your need in the form
  • Required - You can make it required if required.
  • Field Label - This is the label which will actually be shown in the form when used in the frontend.
  • Field Note - This note will show just below the field. You can use this to give any extra information regarding the field.
  • Character Limit - You can set the character limit for the post title if required.
  • Character Limit Error Message - You can set the message to be displayed when character limit error occurs.
  • Post Detail Display - By enabling this option, you can display received custom fields value in the post detail page in the frontend.
  • Display Position - You can either choose to display the received custom field value before the content or after the content
  • Display Label - This is the label which will be shown in the post detail page while displaying the received custom field value

Textarea Settings

All of the settings are same as Textfield

Layout Settings

In layout settings, you can choose the template from our pre designed templates.

 

And also you can choose custom fields frontend display styles for the custom fields added in the form and chosen to display in the frontend.

Notification Settings

In this section, you can configure all the necessary notifications related with frontend post submission. You can configure:

  • Admin Notification - Here are the available options for admin notification.
    • Enable - You can either enable or disable admin notification
    • Notification emails - You can enter the email address separated by comma in which you want to receive the admin notifications. If left blank, the notification will be sent to the email of the site admin configured in your site's general settings.
    • Subject - This field is for entering the subject for admin notification email
    • From Name - This field is for entering the "From Name" for admin notification email. Please enter the value which won't resemble any real person's name such as "No Reply" else email may land in the spam.
    • From Email - This field is for entering the "From Email" for admin notification email. Please enter the value which won't resemble any real person's email such as "noreply@yoursiteurl.com" else email may land in the spam.
    • Message - In this field you can enter the message which you will receive in the admin notification email. You can use [post_title] and [post_admin_link] to replace submitted post title and post admin link in the admin notification email message.

  • Post Publish Notification
    • Enable - You can either enable or disable post publish notification
    • Subject - This field is for entering the subject for post publish notification email
    • From Name - This field is for entering the "From Name" for post publish notification email. Please enter the value which won't resemble any real person's name such as "No Reply" else email may land in the spam.
    • From Email - This field is for entering the "From Email" for post publish notification email. Please enter the value which won't resemble any real person's email such as "noreply@yoursiteurl.com" else email may land in the spam.
    • Message - In this field you can enter the message which you will receive in the post publish notification email. You can use [author_name],[post_title] and [post_link] to replace submitted author name, post title and post link in the post publish notification email message.

Security Settings

You can enable the google recaptcha V2 for both login form and post submission form. For enabling google reCaptcha, you will need reCaptcha site key and secret Key which can be get from here.

Global Settings

In case you need to disable fontawesome, disable jQuery UI CSS or disable jQuery Are you Sure JS then you can disable them from our plugin's global settings page which can be accessed from settings submenu of our plugin's menu.

Shortcodes

As soon as the form is created, it will generate two shortcodes if the form is "Login require" form and single shortcode when form is "Guest" form which you can view on the top of setting navigation menu of form as shown in below screenshot.

Form Shortcode shall be [fpsm alias="alias_of_your_form"]

Frontend Dashboard Shortcode shall be [fpsm_dashboard alias="alias_of_your_form"]

Developer Documentation

In case you want to extend or modify any functionality in the plugin from outside the plugin using hooks and filters then we have added some necessary hooks and filters in the plugin which we have listed in detail inside the Help section of our plugin.

So if required then you can check all the available hooks and filter inside the help section of our plugin.