Help Documentation

TM User Blog - WordPress Front End Post Submission Form Plugin

The first thing you need to do when you want to install a new WordPress plugin is to login to your site admin page. Once there, go to Plugins -> Add New. Click "Upload Plugin" button and upload the zip file from your local hard drive.

Only users who have "publish_posts" capability can submit post. To allow all your new users to publish post, you should change new user default role setting with "Author". "Subscribers" and "Contributors" can not publish post in WordPress.

You will need to update your existing users individually.

Alternatively, you can use User Role Editor plugin to give "publish_posts" capability to other roles. If you are going to enable "inline media upload" feature, you should give "upload_files" capability to the selected role as well.

General

Limit Dashboard Access: You can limit dashboard access and remove WordPress admin bar for the selected "Restricted Roles". Please note that if you are using a 3rd party plugin which offers the similar functionality, there may be compatibility issues.

Default Post Status: As default, new submissions & updates are marked as "pending". Only admins and editors can publish these posts. If you want to skip this step, you can select "published".

bbPress: If you've installed bbPress plugin, you can enable this feature to add the selected form to the user profile.

BuddyPress: If you've installed BuddyPress plugin, you can enable this feature to add the selected form to the user profile.

Google Recaptcha V2: You must have a valid "site key" and a valid "secret key" to enable this feature. You can get your keys from Google Recaptcha. Recaptcha type must be V2 checkbox.

Please note that if you are using a 3rd party plugin Recaptcha plugin, there may be compatibility issues.


Post Form

This section contains post form settings.

Rich Text Editor: You can enable/disable some editor features from this section. As mentioned on "installation" section, only users who have "upload_files" capability can use "Inline Media Upload" button (Add Media).

User Posts;


Style

You can find all style settings on this section. The style settings on the Elementor widgets overwrites these settings.

You can create as many form as you want and add them to any page with the shortcode (or custom Elementor widget). You can find the shortcodes of your forms on "Post Forms" page;

Adding the shortcode to a page using Gutenberg;


Add New Form

Click "Add new form" to create a form.

1) Form Fields

Main Fields

These are default WordPress post fields, you may want to display on your form. Some of these fields may not exist on some custom post types.

Additional Fields

Custom post meta is commonly used by 3rd party plugins and themes to add additional fields to the posts/pages. If you are creating a form for a custom post type, you may need your authors to fill these additional fields. You can find more information about custom post meta on Google. For example;

How to Add Custom Meta Boxes in WordPress Posts and Post Types

Label: The label of the form field.

Description (Optional): The description of the form field.

Meta Key (Required): "Meta Key" is basically the ID of the post meta data. If you don't know the meta key of the custom post meta, we suggest you to contact the developer of the theme or plugin which has created the field. Also please note that the value user entered, will be saved as a string to the database.

Default Value (Optional): The default value of the form field.

Field Type: There are various field types which you can choose from.

Field Options: For "Select" and "Radio" field types, you must enter the values which can be selected by the user. The data should be properly formatted like below;

red-light = Light Red, dark = Black, light = White

Required Field: You can make the field required.

2) Taxonomies

Label: The label of the form field.

Taxonomy: "category" (Categories) and "post_tag" (Tags) are used by standard WordPress posts. Other taxonomies in the dropdown may have been registered by a 3rd party plugin or theme.

Field Type: There are 3 field types which you can choose from. You can add maximum 1 field for the same taxonomy. For example if you create 2 field for "category", only the last one will be saved.

Required Field: You can make the field required.

3) Post Type

"post, page and attachment" are default WordPress post types. Other post types in the dropdown may have been registered by a 3rd party plugin or theme.

4) Recaptcha Theme

The theme of the recaptcha box on the form.

Elementor is the best WordPress Page Builder, with over 5.000.000 active installs. You can create a beautiful website using a simple, intuitive drag and drop Interface. To use TM Elementor Addons, first of all you must install Elementor Page Builder. Download Elementor.

If you haven't used Elementor before, please visit Elementor DOCS.

Widgets

You can find the custom widgets in "TM User Blog" tab.

Open the file which you've downloaded from your Codecanyon account (All Files). Templates are in demo-files folder.

Form templates

demo-files/forms/post-forms.xml is a standard WordPress XML file which you can upload from Tools->Import->WordPress. It contains sample post forms.

Elementor templates

All Elementor templates are in demo-files/elementor folder. You can upload them to Elementor library.