Frontend Uploader free WordPress plugin
Description
Frontend Uploader free WordPress plugin
What is Frontend Uploader?
This plugin is a simple way for users to submit content to your site. The plugin uses a set of shortcodes to let you create highly customizable submission forms to your posts and pages. Once the content is submitted, it is held for moderation until you approve it. It’s that easy!
Exploring Customizations
You can modify the submission form as needed, and have users submit posts. Please visit the FAQ page for more information.
This plugin can be applied to Posts, Pages, and Custom Post Types. You can enable this via Settings > Frontend Uploader Settings.
Form can be used in 3 modes: upload files, submit posts/custom post types, and mixed – submit a post and attach files to it.
Form supports following fields: text, textarea, select, radio buttons, and checkboxes
Customizing Your Form with Shortcode Parameters
Frontend Uploader is flexible and powerful, but unfortunately there’s no visual form constructor at the moment – you have to use shortcodes. Please read this documentation carefully in order to leverage the plugin’s features.
At it’s most basic form, the shortcode would look like this
[fu-upload-form]
This will render a default form for media upload that has title, description and upload fields. (See screenshot 2)
The same shortcode with some customizations would look like this:
[fu-upload-form class=”html-wrapper-class” form_layout=”media” title=”Upload your media”] [input type=”text” name=”post_title” id=”title” class=”required” description=”Title”] [textarea name=”post_content” class=”textarea” id=”my-textarea” description=”Description (optional)”] [input type=”file” name=”photo” id=”my-photo-submission” class=”required” description=”Your Photo” multiple=”multiple”] [input type=”submit” class=”btn” value=”Submit”] [/fu-upload-form]
As you can see, form elements are represented by shortcodes: [input], [textarea], [radio], [checkboxes], [file]. Each of them has a set of attributes, e.g. `id, class, name, value, values, type, description, minlength, maxlength. Please refer to “Form Elements” section of this readme for more details on elements and their attributes.
Main shortcode: [fu-upload-form]
The main shortcode, it has many important parameters that modify form behavior.
In the following example we are creating a form with title “Upload your story and image”. The form will allow to submit a custom post type story with an image which is going to be automatically inserted at the end of the story. The story will have a category with ID 1. On successful submission user will be redirected to http://example.com/success-page/
[fu-upload-form form_layout=”post_media” title=”Upload your story and image” class=”my-class validate” post_type=”story” append_to_post=”true” success_page=”http://example.com/success-page/” category=”1″ ][/fu-upload-form]
The list of all parameters for [fu-upload-form]
form_layout
This determines whether the form is saved as a post/custom post type (‘post’), as a media file (media), or as a post with images (post_media). Default value is media.
Example:
[fu-upload-form form_layout=”post”]
title
Add this [fu-upload-form] shortcode, and this will be the Headline that will be displayed before the form.
Example:
fu-upload-form class=”your-class” title=”Upload your media”]
class
HTML class of the form, defaults to ‘validate’. If you want your form being validated – do not remove validate class. If you would like to item to be required before a user can submit, you can set it to ‘required.’
Example:
[input type=”text” name=”post_title” id=”title” class=”required”]
post_type
Any post whitelisted in settings post type. Defaults to ‘post’.
Example:
[fu-upload-form post_type=”my-custom-post-type-slug”]
append_to_post
Automatically insert images into uploaded post (true or false)
success_page
URL to redirect on successful submission, defaults to the URL where the form is being displayed. For security reasons this should be an URL on your site (no external links). You can use [fu-upload-response] shortcode to display success/error messages on the redirect page.
category
ID of category the post should be attached (only in post or post+media mode).
post_id
ID of the post the image should be attached to. Defaults to the post ID of the post the shortcode is on.
suppress_default_fields
Override global setting for supressing default form fields (true or false).
Example:
[fu-upload-form suppress_default_fields=”true”] … inner shortcodes omitted… [/fu-upload-form]
Form Elements
Following are form elements you can use, please refer to Field Attributes section for more details on what attributes can be used.
Text box for one line of text:
[input type=”text” name=”post_title” class=”my-class” ]
Text box for multiple lines of text:
[textarea name=”post_content” class=”my-text-area”]
File upload field:
[input type=”file” name=”my-file”]
Set of checkboxes:
[checkboxes name=”fruits” values=”value:Description,124:Banana,cherry:Cherry”]
Set of radio buttons:
[radio name=”fruit” class=”checkboxes” description=”Pick a fruit” values=”value:Description,124:Banana,cherry:Cherry”]
Select:
[select name=”select-fruit” class=”select” description=”Pick a fruit” values=”apple:Apple,banana:Banana,cherry:Cherry”]
Submit button:
[input type=”submit” class=”btn” value=”Submit”]
Recaptcha:
[recaptcha]
Field Attributes
id – id of element name – name of element class – extra classes you want to add type – text or file or submit required – This attribute specifies that the user must fill in a value before submitting a form. minlength – minimum amount of characters for field value maxlength – maximum amount of characters for field value min – The minimum (numeric or date-time) value for this item, which must not be greater than its maximum (max attribute) value. max – The maximum (numeric or date-time) value for this item, which must not be less than its minimum (min attribute) value. multiple – allow multiple file uploads (only for file inputs) placeholder – A hint to the user of what can be entered in the control. readonly – This attribute indicates that the user cannot modify the value of the control. disabled – This Boolean attribute indicates that the form control is not available for interaction value – input value description – input label help – input help text displayed underneath values – multiple option inputs (checkboxes,select,radio) values in format *value:description, another_value:anotherdescription* wysiwyg_enabled – enable TinyMCE for textareas
Support
Please make sure to read this readme including FAQ section before posting in support forum.
Development
Fork the plugin or report an issue on Github
Translations
Мы говорим по-русски (Russian)
Se habla español (Spanish) (props Rafael Calzada, gastonbesada)
Nous parlons français (French) (props dapickboy)
Nous parlons français (Canadian French) (props rfzappala)
Vi snakker norsk (Norwegian) (props André Langseth)
Wir sprechen Deutsch (German) (props Joshua Trees)
We spreken Nederlands (Dutch) (props Jaap van der Veen)
ما فارسی صحبت می کنند (Persian) (props mojtabashahi)
Falamos Português (Brazilian Portuguese) (props Murilo Pinto Pereira)