“Prometheus User Submitted Content Plugin for WordPress” Help by CodeRevolution

---

“Prometheus User Submitted Content Plugin for WordPress Help”

---

Table of Contents

1. About the plugin
2. Wordpress installation
3. Plugin Settings
4. Summary
5. Sources and Credits

---

About the plugin - top

How to enable users to submit content to your website? Have you ever participated in a website that allows any approved user to submit content to the site? Maybe you've throug about using this type of model with your own website, but you're not sure how to make this happen.
Frontend publishing is very useful when you want users to submit guest blog posts, add images to your gallery, or create new business listings in your business directory.
It is no secret'fresh and engaging content is the lifeblood of any successful website. It drives traffic, promotes conversions, and provides searchable material for Google and other search engines to scan and evaluate. Without a steady flow of new content the Internet would virtually grind to a halt. But creating new and engaging content takes time and effort, and SEOs and webmasters are constantly on the look out for new ways to bring rich content to their sites.
This plugin provides one solution to the ongoing search for new content. It not only provides a steady stream of rich, searchable content for a given website, it also helps to keep webmasters and SEOs informed on the trending topics that their customer base finds most interesting. But just what is user-generated content, and how can it play a part in your SEO strategy?
The goal is to achieve the following:

• Allowing users to register and post content on your website.
• Making it easier for users to login and signup.
• Extending user profiles and author pages.
• Making it easier for users to post content.

User Generated Content Benefits
Allowing visitors to your site to leave comments, post reviews, upload images, and participate in forum discussions, gives you the opportunity to see exactly how consumers are talking about your products and services. This can be invaluable when researching keywords and phrases for your SEO campaign. By looking at the language your customers use, and the phrases that get repeated across a number of different postings, you will be able to identify new long tail keywords that will be invaluable in your on-page optimization strategies.


User Generated Content as a Source for Your Own Content
One of the biggest challenges facing webmasters and SEOs is creating their own stream of unique content for their websites. User generated content provides a great source for blog topics. By monitoring the UGC on your websites, you can get a good idea of what your customer base is talking about, what questions they may have about your products and services, as well as related concerns they may have with your industry in general. This is a rich vein of information that can be mined for blog topics that will be timely and address the specific interests of your customer base.


User Generated Content Allows You To Interact With Your Customers
This is another area that is particularly important for e-commerce sites. Enabling reviews, testimonials, and customer forums may be a great way to generate content for your site, but they should be closely monitored. If a customer has an issue with your service, or a complaint about a product, other customers will judge you according to how well you deal with the complaint. So be quick and courteous in your replies. It is also important to use a strong spam filter on your site to avoid getting a flood of spammy content. Search engines hate spam as much as potential customers, and you want to minimize its occurrence as much as possible.

The plugin helps you handle with ease the 'user generated content' sent by your visitors, besides having a whole bunch of features to help you in your work. These features include:

• Include a shortcode that will add the submission form anywhere on your website: posts, pages, widgets, template
• Define a wide range of rules regarding how the user submission form is configured
• Define a wide range of constrains regarding user submissions
• View Statistics about user submitted posts
• Translate plugin in any language you want, or simply modify any outputed string as you like
• Moderate submitted posts or publish them immediately
• Track your submitters by IP Address, User Agent and Referrer
• Ban users that break your rules
• Allow only a predefined list of users to submit posts
• Receive Email alerts every time a new post gets submitted
• Get protected against spam bots
• Curse Words Filtering - censor unwanted content
• And many, many other features...
• Not enought features for you? This plugin is also fully mobile compatible, is translations ready, is optimized for speed - has no speed impact and benefits of lifetime updates and support.

Wordpress installation - top

Youtube video tutorial:

I also provided a Quick Install Guide to feature an easy plugin installation for everyone.

To make this plugin work, first, you'll need to install the plugin. The easiest method is to take the .zip file you've downloaded and upload it via Plugins > Add New > Upload Plugin in the WordPress Dashboard. Once the plugin is installed, be sure to Activate it.

Now that you've installed and activated the plugin, you'll see a new menu item created inside WordPress called 'Prometheus User Submitted Content'. First thing first, let's head over to Settings > Prometheus User Submitted Content and take a look at what options are available.

Plugin Settings - top

Refreshingly, Prometheus User Submitted Content plugin has a super-simple settings screen. Let's look at first at the settings panel:

Here you can find the steps needed in configuring your plugin even if you have no HTML knowledge at all. You can find options for:

HINT! Don't forget to click the Save button every time you modified your settings, otherwise the modifications will be lost!

Main Settings:

• Prometheus User Submitted Content Plugin Main Switch: Enable or disable the Prometheus User Submitted Content Plugin. This acts like a main switch.
• Allow Only Registered Users to Submit Posts: Do you want to allow only logged in visitors to send posts?
• 'Only Registered Users Allowed' Message: Message to be shown to unregistered users. Basic HTML markup is allowed.
• User Categories Allowed to Submit Posts: Choose which user categories can submit posts with the submission form. User roles in WordPress are (in ascending rights order): Subscribers, Contributors, Authors, Editors and Administrators.
• User Name for Anonymous User Posts: Username of the publisher of the published posts for anonymous user submissions.
• Allow Users to Submit More Than 1 File at Once: Do you want to allow users to submit more files at once?
• Maximum Number of Files a User Can Submit: Select the maximum number of files a user can submit. Leave this field blank, to disable the limitation.
• Minimum Number of Files a User Can Submit: Select the minimum number of files a user can submit. Leave this field blank, to disable the limitation. Leave this field blank, to disable the limitation.
• Maximum File Size for Submitted Files: Select the maximum file size that you allow users to submit. Leave the textfield blank or set it to 0, if you do not want to have a maximum. The number is set in bytes. 1024b = 1Kb, 1048576b = 1Mb
• Minimum File Size for Submitted Files: Select the minimum file size that you allow users to submit. Leave the textfield blank or set it to 0, if you do not want to have a minimum. The number is set in bytes. 1024b = 1Kb, 1048576b = 1Mb
• Allowed File Extensions for Submission: Select the allowed file extensions for the files your users submit. Leave this field blank, to disable the limitation.
• Image Maximum Width: Select the maximum width for image files. Leave this field blank, to disable the limitation.
• Image Minimum Width: Select the minimum width for image files. Leave this field blank, to disable the limitation.
• Image Maximum Height: Select the maximum height for image files. Leave this field blank, to disable the limitation.
• Image Minimum Height: Select the minimum height for image files. Leave this field blank, to disable the limitation.
• Maximum Number of URLs in Post Content: Maximum number of URLs in post content. Leave this field blank, to disable the limitation.
• Allow HTML in Post Content: Do you want to allow HTML in post content.
• Ban Users Names From Submitting Posts: Ban users login names from submitting posts. You can enter more user login names in this field, all separated by a comma.
• Allow Only These Users Names to Submit Posts: Allow only these user login names to submit posts. You can enter more user login names in this field, all separated by a comma.
• Categories to Show to Submitters: Enable the list of categories you want to show to you visitors that are submitting posts.
• Minimum Number of Characters for the Post Title: The minimum number of characters that the submitted post titles should have. 0 means no minimum.
• Maximum Number of Characters for the Post Title: The maximum number of characters that the submitted post titles should have. 0 means no maximum.
• Minimum Number of Characters for the Post Content: The minimum number of characters that the submitted post content should have. 0 means no minimum.
• Maximum Number of Characters for the Post Content: The maximum number of characters that the submitted post content should have. 0 means no maximum.
• Minimum Number of Characters for Other Text Fields: The minimum number of characters that other text fields (excluding post title and post content) should have. 0 means no minimum. Affected fields are: author name, email address, author URL, post tags, post excerpt and post password.
• Maximum Number of Characters for Other Text Fields: The maximum number of characters that other text fields (excluding post title and post content) should have. 0 means no maximum. Affected fields are: author name, email address, author URL, post tags, post excerpt and post password.
• Require Unique Post Titles: Do you want to require unique post titles (useful for preventing duplicate submits)?
• Require Unique Post Content: Do you want to require unique post content (useful for preventing duplicate submits)?
• Post Status After Submission: Select the status that you want for the user published posts to have, after submission.
• Automatically Insert Any File Type in Posts: Do you want to automatically add any file type to posts? If you want to add only images to posts, uncheck this checkbox.
• Add Link to the Added Images Pointing to the Full Size Image: Do you want to add a link to inserted images? The link will open the full size image in a new tab.
• Auto Set Featured Image for Submitted Post: Do you want to generate a featured image for the post, from the first submitted image file?
• Automatically Added Image Width: Width of the image to be included in the post.
• Automatically Added Image Height: Height of the image to be included in the post.
• Enable Spammer Bot Protection: Do you want to add to your form a hidden text field to act as an extra spammer bot protection security messure?
• Enable Admin Panel Notices for New Posts: Do you want to enable admin panel notices when new posts arrive?
• Enable Email Alerts on New Post Submission: Do you want to get an email alert every time a new post is submitted to your webpage?
• Email Address Where to Send the New Post Messages: The email address where to send the new post messages. You can enter multiple email adresses, each separated by a comma from the other.
• The Sender Email Adress: The FROM Address in the sent email. You can enter only one email adress. You can enter an inexistent email adress (noreply@yourdomain.com)
• Email Subject: The Subject of the sent email. You can also use the following shortcodes: %%post_title%%, %%post_content%%, post_excerpt%%, %%post_status%%, %%post_author%%, %%post_type%%, %%post_password%%, %%tags%%, category%%, %%author%%, %%author_email%%, %%author_url%%, %%author_user_agent%%, %%author_ip%%, %%author_referrer%%, %%sitename%%, %%siteurl%%, %%permalink%%, %%editlink%%
• Email Content: The content of the sent email. You can also use the following shortcodes: %%post_title%%, %%post_content%%, post_excerpt%%, %%post_status%%, %%post_author%%, %%post_type%%, %%post_password%%, %%tags%%, category%%, %%author%%, %%author_email%%, %%author_url%%, %%author_user_agent%%, %%author_ip%%, %%author_referrer%%, %%sitename%%, %%siteurl%%, %%permalink%%, %%editlink%%
• Hide Form After a Successful Form Submission: Do you want to hide the submission form after a successful post submit?
• Hide Form After a Failed Form Submission: Do you want to hide the submission form after a failed post submit?
• Save Textfileds Value After Failed Submit Attempt: Do you want to save input textfield values after a failed submit attempt? If you leave this checkbox unchecked, you form security will be increased, but you risk to annoy your users.
• Categories to Automatically Include for the Submitted Posts: Auto include these categories for the submitted posts.
• Automatically Add These Tags to Submitted Posts: Automatically add these tags to submitted posts. You can add more tags, each separated by a comma.
• Redirect Users after Form Submission: Do you want to redirect users to a custom page after they submit their post?
• Redirect Users after Submit Success URL: Where do you want to redirct users after a successful form submission?
• Redirect Users after Submit Fail URL: Where do you want to redirct users after a failed form submission?
• Redirect Users to Their Published Post: Do you want to redirect users to their published post after they hit submit? Note that this option only applies if you set that posts are automatically published after user submission.
• Successful Form Submission Message: The message to be shown after successful form submission. Leave blank for the default messages to appear.
• Failed Form Submission Message: The message to be shown at a failed form submission. Leave blank for the default messages to appear. This message will suppress all other error messages! So set it to be as general as possible.
• Gather Extra Information from Submitters: Do you want to gather some extra information (IP, User Agent, Referrer) from those who submitted posts to your website?
• Automatically Include Submitted Files in Posts: Do you want to automatically show submitted files in posts?
• Enable Curse Words Filtering: Do you want to enable censoring of curse words?
• Censor These Words When Appearing in the Post: Censor these a list of words when they appear in the submitted post title or content. They will be replaced with * (stars).
• User Name Input Field: Do you want to show username input in your form?
• User Email Input Field: Do you want to show user email input in your form?
• User URL Input Field: Do you want to show user URL input in your form?
• Post Title Input Field: Do you want to show post title input in your form?
• Post Tags Input Field: Do you want to show post tags input in your form?
• Post Category Input Field: Do you want to show post category input in your form?
• Post Content Input Field: Do you want to show post content input in your form?
• Post Captcha Input Field: Do you want to show a captcha input in your form?
• Post Excerpt Input Field: Do you want to show an excerpt input in your form?
• Post Comment Selection Input Field: Do you want to let your users select if they want to enable comments on their submitted post?
• Post Ping Selection Input Field: Do you want to let your users select if they want to enable pings on their submitted post?
• Post Password Selection Input Field: Do you want to let your users select if they want to set a password on their submitted post? Warning! Use this field with caution! Setting a password on a post, will deny access to it!
• Post Format Selection Input Field: Do you want to let your visitors choose what type of post format do they want to apply to their submitted posts?
• Post/Page Type Selection Input Field: Do you want to let your users select if they want to submit a new post or a new page.
• Post Image Upload Input Field: Do you want to show an image upload input in your form?
• Allow Multiple Categories Selection: Do you want to allow users to select multiple categories for submitted posts?
• Built-In Captcha Question to be Shown: The Captcha question to be shown to the form users. This can be a secret question that only a limited number of people will know.
• Built-In Captcha Answer Required: The Captcha answer to be required from the form users. Warning! Case sensitive!
• Enable Google ReCaptcha Integrition: Do you want to add a Google ReCaptcha to the form?
• ReCaptcha Site Key: Please register your blog through the Google reCAPTCHA admin page and enter the site key in the fields below.
• ReCaptcha Secret Key: Please register your blog through the Google reCAPTCHA admin page and enter the secret key in the fields below.
• ReCaptcha Theme: Select the theme you would like to apply to the recaptchas. You can select between light or dark. Note that some themes rely on the 'Wrap Input Fields With Fieldset:' option and will not work if this option is not enabled!
• ReCaptcha Language: Select the language you would like to apply to the recaptchas.
• ReCaptcha Incorrect Message: Message to be show to users when the captcha they enterred is incorrect.
• ReCaptcha Spam Message: Message to be show to users when the captcha they enterred is spam.
• Default Post Title: Set the default value for the post title setting. This will apply only when you hide the title field or you do not require it and the user leaves it blank.
• Default Post Tags: Set the default value for the post tags setting. This will apply only when you hide the tags field or you do not require it and the user leaves it blank.
• Default Post Content: Set the default value for the post content setting. This will apply only when you hide the content field or you do not require it and the user leaves it blank.
• Default Post Category: Set the default value for the post category setting. This will apply only when you hide the category field or you do not require it and the user leaves it blank.
• Default Post Excerpt: Set the default value for the post excerpt setting. This will apply only when you hide the excerpt field or you do not require it and the user leaves it blank.
• Default Post Type: Set the default value for the post type setting. This will apply only when you hide the type field or you do not require it and the user leaves it blank.
• Default Post Comment Policy: Set the default value for the post comment setting. This will apply only when you hide the comment field or you do not require it and the user leaves it blank.
• Default Post Ping Policy: Set the default value for the ping setting. This will apply only when you hide the ping field or you do not require it and the user leaves it blank.
• Default Post Password: Set the default value for the post password setting. This will apply only when you hide the password field. Leave it blank to disable it.
• Default Post Format: Set the default value for the post format setting. This will apply only when you hide the format field or you do not require it and the user leaves it blank.
• Show WordPress's Rich Text Editor For Post Content: Do you want to show rich text input field for post content editing or just a plain textfield?
• Enable the 'Add Media' Button in the Rich Text Editor: Do you want to enable 'Add Media' button in the rich text editor?
• Allow Drag and Drop in Rich Text Editor: Do you want to allow drag and drop in the rich text editor?
• Custom HTML Before the Form: Custom HTML markup to be included before the form.
• Custom HTML After the Form: Custom HTML markup to be included after the form.
• Wrap Input Fields With Fieldset: Do you want to wrap every input field with fieldset?
• Submission Form Theme: Select the theme of your submission form.
• Custom CSS: Input your custom CSS code.
• Enable Bold Fonts: Do you want to show bold fonts?
• Enable Italic Fonts: Do you want to show italic fonts?
• Enable Underline Fonts: Do you want to show underline fonts?
• Transparent Form Background: Do you want to have transparent form background?
• Transparent Fieldset Background: Do you want to have transparent fieldset background?
• Form Font Size: Select the size of the font.
• Form Font Color: Select the font color of the form.
• Form Background Color: Select the background color of the form.
• Fieldsets Background Color: Select the background color of the fieldsets in the form.
• Fieldsets Border Color: Select the border color of the fieldsets in the form.
• Fieldset Border Width: The width of the border of the fieldsets.
• Form Border Color: Select the border color of the form in the form.
• Form Border Color: Select the border color of the form in the form.
• Form Border Width: The width of the border of the form.
• Shortcode: [prometheus_add_form] Adds submission form to page
• Shortcode: [prometheus_list_submitted_posts] Lists all user submitted posts
• Shortcode: [prometheus_list_submitted_pages] Lists all user submitted pages
• Shortcode: [prometheus_list_submitted_posts_and_pages] Lists all user submitted posts and pages

Submitted Posts Statistics:

• Post Link: The link to the submitted post
• Post ID: The ID of the post
• Post Author: The name of the post author (registered)
• Post Name: The name of the post
• Post Type: The type of the post
• Post Title: The title of the post
• Post Date: The date of the post submission
• Post Status: The status of the post submission
• Post Password: The password of the post
• Comment Count: Comment count on the post
• Author Submitted Name: The submitted author name of the post

Form Default Texts:

• Here you can set the default values for every string the form will show to the user You can customize form output or add translations as you will!

What are WordPress shortcodes?

Shortcodes in WordPress are little bits of code that allow you to do various things with little effort. They were introduced in WordPress 2.5, and the reason to introduce them was to allow people to execute code inside WordPress posts, pages, and widgets without writing any code directly. This allows you to embed files or create objects that would normally require a lot of code in just one single line. For example, a shortcode for embedding information about the user's browser looks like this:

[prometheus_list_submitted_posts]

Sometimes you may want to use the text of a shortcode in a post. To do this you have to escape it using double brackets. For example, if you want to add the user submission form to a page, you can use prometheus_list_submitted_posts shortcode to add the form, by using the following shortcode:

[[prometheus_list_submitted_posts]]

Shortcodes simplify the addition of features to a WordPress site. By using shortcodes the HTML and other markup is added dynamically directly into the post or page where the user wants them to appear.

Results: If everything is configures well, you can go to plugin administration page, and you can wait to see it's results in the 'Submitted Posts Statistics' admin page (where you can see logs of your user submitted posts)! You can also include the following shortcode to your website:

[prometheus_add_form] - this shortcode will add a the submission form anywhere on your website!
[prometheus_list_submitted_posts] - this shortcode will list all users submitted posts!
[prometheus_list_submitted_pages] - this shortcode will list all users submitted pages!
[prometheus_list_submitted_posts_and_pages] - this shortcode will list all users submitted posts and pages!

Here are some examples of Prometheus User Submitted Content plugin features:

Basic Submission Form integrition:

Advanced Submission Form integrition:

Image Attachment example:

Customized form example:

Blue form example:

User submitted post example:

Admin panel notification example:

Widget form integrition example:

v1.4 plugin update - added translation possibilities to shortcode - top

Now you can translate your form with ease directly from the short code with which you add it to the webpage. You can add a bunch of new parameters to it and make it's output completly customizable.

Note that all these parameters are optional, and if you do not specify them, their defaul value will apply (the one saved in the plugin settings -> 'Form Default Texts' submenu.)

The new parameters (and their meaning) are:

• show_require='' - what fields you want to show and require, beside the ones defined in the plugins settings (the default fields). <'fields'> can have these values (separated by comma): user_name, user_email, user_url, user_url, post_tags, post_category, post_excerpt, post_captcha, password, accept_comments, ping_status, post_format, post_type, post_image, post_content, post_confirm, advanced_info.
• show='' - what fields you want to show, beside the ones defined in the plugins settings (the default fields). <'fields'> can have these values (separated by comma): user_name, user_email, user_url, user_url, post_tags, post_category, post_excerpt, post_captcha, password, accept_comments, ping_status, post_format, post_type, post_image, post_content, post_confirm, advanced_info.
• hide='' - what fields you want to hide, from the ones defined in the plugins settings (the default fields). <'fields'> can have these values (separated by comma): user_name, user_email, user_url, user_url, post_tags, post_category, post_excerpt, post_captcha, password, accept_comments, ping_status, post_format, post_type, post_image, post_content, post_confirm, advanced_info.
• user_name='User Name Field Text'
• user_email='User Email Field Text'
• user_url='User URL Field Text'
• post_title='Post Title Field Text'
• post_tags='Post Tags Field Text'
• post_password='Post Password Field Text'
• post_excerpt='Post Excerpt Field Text'
• post_category='Post Category Field Text'
• accept_comments='Accept Comments Field Text'
• accept_pings='Accept Pings Field Text'
• post_format='Post Format Field Text'
• post_or_page='Post or Page Field Text'
• post_attachment='Post Attachment Field Text'
• post_content='Post Content Field Text'
• submit_button='Submit Post Button Text'
• bot_trap='Bot Trap Hidden Message'
• duplicate='Duplicate Titles Error Message'
• duplicate2='Duplicate Content Error Message'
• failed='Failed to Insert Post Error Message'
• captcha='Incorrect Captcha Error Message'
• bot='You Just Fell in the Bot Trap Error Message'
• banned='Banned User Error Message'
• user='User Name Required Error Message'
• email='Emai Required Error Message'
• url='User URL Required Error Message'
• title='Post Title Required Error Message'
• tags='Tags Required Error Message'
• category='Category Required Error Message'
• content='Post Content Required Error Message'
• reqcaptcha='Recaptcha Required Error Message'
• excerpt='Post Excerpt Required Error Message'
• comments='Comments Option Required Error Message'
• ping='Pingback Option Required Error Message'
• password='Post Password Required Error Message'
• format='Post Format Required Error Message'
• type='Post Type Selection Required Error Message!'
• image='Post Image Required Error Message'
• notallowed='User Name Not On The "Allowed List" Error Message'
• nopriviledges='Not Enought Priviledges Error Message'
• titlelong='Title Too Long Error Message'
• titleshort='Title Too Short Error Message'
• contentlong='Content Too Long Error Message'
• contentshort='Content Too Short Error Message'
• authorlong='Author Name Too Long Error Message'
• authorshort='Author Name Too Short Error Message'
• emaillong='Email Too Long Error Message'
• emailshort='Email Too Short Error Message'
• urllong='User URL Too Long Error Message'
• urlshort='User URL Too Short Error Message'
• tagslong='Tags Too Long'
• tagsshort='Tags Too Short'
• excerptlong='Excerpt Too Long Error Message'
• excerptshort='Excerpt Too Short Error Message'
• passwordlong='Post Password Too Long Error Message'
• passwordshort='Post Password Too Short Error Message'
• maxfiles='Maximum Number Of Files Error Message'
• maxsize='Maximum File Size Error Message'
• minsize='Minimum File Size Error Message'
• minfiles='Minimum File Number Error Message'
• notallowedextension='File Extension Not Allowed Error Message'
• maxheight='Maximum Image Height Error Message'
• minheight='Minimum Image Height Error Message'
• maxwidth='Maximum Image Width Error Message'
• minwidth='Minimum Image Width Error Message'
• maxurls='Maximum URL Number Error Message'
• unknown='Unknown Error Error Message'
• error_string='Error Message Prefix (usually "Error: ")'
• category_default='"Please Select Default Category" Message'
• accept_string='Accept Message (for comments)'
• deny_string='Deny Message (for comments)'
• is_post='Post (Post Type)'
• is_page='Page (Post Type)'
• is_standard='Standard (Post Format)'
• is_aside='Aside (Post Format)'
• is_gallery='Gallery (Post Format)'
• is_link='Link (Post Format)'
• is_image='Image (Post Format)'
• is_quote='Quote (Post Format)'
• is_status='Status (Post Format)'
• is_video='Video (Post Format)'
• is_audio='Audio (Post Format)'
• is_chat='Chat (Post Format)'
• submit_post='Submit Post Button Text'
• success_string='Post Successfully Sent Text'

Example of usage (this is a full example - you can leave out fields as you wish):

Summary - top

Prometheus User Submitted Content plugin is a simple, yet powerful tool you can use to manage user submitted content. The setup and settings of the plugin couldn't have been easier. Now, let's go and enjoy the results of this great plugin! Have fun using it!

Sources and Credits - top

This component was made by Szabi CodeRevolution, for more information and support contact us at support@coderevolution.ro

Once again, thank you so much for purchasing this item. As I said at the beginning, I'd be glad to help you if you have any questions regarding this plugin and I'll do my best to assist.

CodeRevolution

---