Documentation of AccessPress Anonymous Post Pro Plugin

Installing Instructions

1. Unzip codecanyon-9160446-accesspress-anonymous-post-pro.zip file
2. Upload all the files to the /wp-content/plugins/accesspress-anonymous-post-pro
3. Activate the plugin through the ‘Plugins’ menu in WordPress.
4. For customizing the plugin’s settings, click on AccessPress Anonymous Post Pro option menu in WordPress left admin menu.

Alternative installation from WordPress Dashboard

1. Open your Dashboard-> Plugins-> Add New
2. Click on Upload Plugin
3. Click on Choose File
4. Select the file codecanyon-9160446-accesspress-anonymous-post-pro.zip file and click Install Now
5. Once the plugin is installed click on Activate Plugin
6. You are done, to customizing the plugin’s settings, click on AccessPress Anonymous Post Pro option menu in WordPress left admin menu.

How to Update your Plugin

1. To get your new update file, go to https://codecanyon.net/downloads and download your update file.
2. If you try to install the update when you already have the plugin installed, you may get the error
   

   Destination folder already exists.

3. To update your plugin, first deactivate your currently installed plugin from Dashboard-> Plugins listing and delete the plugin.
4. Then follow the Installation Instructions above.

The plugin data and settings are all stored in your WordPress Database and will not be affected if you delete the plugin file.

How to use

Once the plugin is installed and activated you will find a menu named “AccessPress Anonymous Post Pro” in the left menu bar of the admin menu.

Once you click on that menu, you will go to the Anonymous forms list. An example Form called Anonymous post should be present on your first installation. You will see Title, Shortcode, Template Shortcode. You can hover over the Title to Edit, Copy Preview or Delete the form.
When you click on the Anonymous Post Pro on the left admin bar you will see the following screen:

You can click on Add New to create a new Form.
There are five main settings panels from which you can configure all the plugin settings as per your requirements.

1. General Settings
2. Email Settings
3. Form Settings
4. Captcha Settings
5. Form Style Settings

General Settings

From general setting panel, you can configure all the basic settings for the plugin and the frontend form.

1. Form Title
   This is the field for the title of the form.
2. Post Publish Status
   You can choose any publish status (draft, pending or published)  for the post submitted from the frontend.
3. Post Format
   Here you can select the post formats for the Frontend post submission. The Default value is Standard. However, all the post formats supported by the theme you are using is listed. Examples of other post formats are aside, gallery, link, image, quote, status, video, audio.
4. Submit Post As
   You can choose your post type here. All the registered post types will be listed here and all the submitted post from the frontform will be submitted as the selected post type. If you want to use the plugin for a Custom post type you should find the Custom post type option here.
5. Check Login
   This option provides you the ability to hide or show the form in the frontend by checking the login status of the users. If you wish that only logged in users to submit the post from the frontend then you can check this option.
6. Login Type
   Please choose the option to whether to show login form or login message if you have marked the check login option. The Anonymous Post plugin provide two different login methods:
   • Show Login Message
     Login message will show the custom login message with the link to backend login. You can set login button text and login URL to your default login page.
   • Show Login Form
     Login form will show the inline login form where users can login to submit the post. The labels supported by the form are User Label, Password Label, Login, Button Label.

   The plugin is not a user registration plugin and does not have the feature to register new users.

7. Anonymous Image Upload
   Check if you want to allow the guest visitors to upload images in the post content editor.
8. Link to source URL
   Check if you want to link the anonymously uploaded image file to its source.
9. Add Lightbox Rel Attribute
   Check if you want to add rel=”lightbox” parameter in the added source link of the anonymously uploaded image. Please check Link to source URL too to use this feature.
10. Anonymous Image Max Upload Size
    Set the maximum allowed upload image size in MB for anonymous user. Default is 2 MB.
11. Media Upload
    Check if you want to allow the logged in users to upload media in the Rich/ Visual editor.
    Please note that the Add Media button will only show for the users with the upload_files Capability such as Administrator and Editor. Please check here for more details.
12. Assign Author
    This option provides you the ability to assign specific author to the post submitted from frontend.
13. Logged in User as Author
    Check if you want to assign logged in user as the author of a new post. If not logged in, above assigned author will be default author.
14. Redirect Type
    The plugin provides two redirectional types:
    • Redirect to URL
      If you wish to redirect to some other page after the successful form submission then, you can fill this field with that desired url and then the form will automatically be redirected to that page after successful post submission. If you don’t keep any redirect URL then the form will be redirected to same page where the form is located.
    • Redirect to newly created posts/page
      Redirect to newly created posts/page will only work if you have set the post publish status to publish.
15. Redirect URL
    URL to be redirected after successful post submission.If kept blank, it will be redirected to same page.
16. Post Submission Message
    Place the message that needed to be displayed after successful post submission.

Email Settings

From the Email settings you can set the email settings for Admin Notification, User Notification and Post Rejection Notification.

1. Admin Notification
   Please check this to recieve the admin notification after every post submission from the frontform. You can add upto 3 extra email address for the admin notifications if there are multiple admins in the site. You can set the Admin Notification Subject, Admin Notification From Name and Admin Notification From Email as well.
2. Admin Notification Message
   Please enter the message format that will be sent to the admin emails. For sending the post title use #post_title and for sending post admin link, use #post_admin_link. In email these both codes will be replaced by the real post title and admin links that the users will submit.
   The Default Notification Message is

   Hello There,

   A new post has been submitted via AccessPress Anonymous post plugin in your Anonymous Post Pro website. Please find details below:

   Post Title: #post_title
   _____

   To take action (approve/reject) – please go here:
   #post_admin_link

   Thank you

   You can use #post_title,#post_admin_link,#post_author_name,#post_author_email,#post_author_url codes in the above message to get the respective values in the email.

3. User Notification
   Please check this option if you want to send the automatic email message to the post author/post submitter when the post is published in the site. You can set the User Notification Subject, User Notification From Name and User Notification From Email.
4. User Notification Message
   Please enter the notification message format that will be sent to post author/post submitter when the post is published.Please use #post_title and #post_link codes to send the post title and post frontend link to the post author/post submitter in the email.
   The Default Notification Message is

   Hello There,

   Your post has been published in Anonymous Post Pro website. Please find details below:

   Post Title: #post_title
   _____

   To view your post in the site – please go here: #post_link

   Thank you

   You can use #post_title, #post_link for sending respective values in the email.The email will only be sent to guest author if author email is also recieved from post submission form.

5. Post Rejection Notification
   Please Check if you want to notify guest author via email after the post is rejected or trashed. You can set the Post Rejection Notification Subject, Post Rejection Notification From Name and Post Rejection Notification From Email.
6. Post Rejection Notification Message
   Please enter the notification message format that will be sent to post author/post submitter when the post is rejected/ trashed. Please use #post_titlecodes to send the post title.
   The Default Notification Message is

   Hello There,

   Your post has been rejected in Anonymous Post Pro website. Please find details below:

   Post Title: #post_title

   Thank you

   You can use #post_title for sending post title in the email.The email will only be sent to guest author if author email is also recieved from post submission form.

Make use to set the email settings. Empty email fields may lead to your post notification emails not being sent. Make sure to check your spam/ trash mail as well for notification mails.

Form Settings

From form setting panel, you can configure all the detailed settings regarding form. You can select all the fields that you want to show in the forms.And also you can configure the labels for individual fields that will show in the form.

1. Form Field Configurations
   From this section, you can configure all the form fields individually that needed to shown or not in the frontend, is required or not, custom required messages, tooltip notes , label for the fields, drag and drop ordering of the fields. The default fields are:
   • Post Title
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text.
   • Post Content
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text, Editor Type( Simple Text area/ Rich Text Editor/ Visual Editor/ HTML Editor), Character Limit, Character Limit Message, Rich/Visual Editor Size. Please note that Character Limit feature will only work if there is only one visual/rich editor in the page.
   • Post Excerpt
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text.
   • Post Image
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text.
   • Author Name
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text, Frontend Display Settings and Frontend Display Label.
   • Author URL
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text, Frontend Display Settings and Frontend Display Label, Show as link.
   • Author Email
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text, Frontend Display Settings and Frontend Display Label.
   • Categories
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Show field as (Checkbox/ Dropdown), Exclude Categories/Tags/Terms, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text.
   • Tags
     This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Show field as ( Text Field/ Checkbox/ Dropdown), Auto Complete, Exclude Categories/Tags/Terms, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text.

   You may find additional custom fields in the case you use Custom Post Type as Submit post as

   

   Custom Fields

   You can also add unlimited custom fields which will provide you the ability to add any number of extra fields that you need in your form.You can also configure the type of those extra fields as textarea, textfield or datepicker. To create a Custom Field:
   Go to Custom Fields Meta Tab and fill in the label and meta key.

   

   • Label: Add a human readable Label to identify your new Custom Field.
   • Meta Key: Meta Key is used to identify the new fields value to the database. Please use lower case letters only for meta key and please don’t use any symbols or space keys. Use underscore( _ ) instead. For example: If you are to add Product Model then meta key can be product_model .
   • Pre Available Meta Keys: Before you create a new Meta Key, just check if the meta key you are looking for is already present in the Pre Available Meta Keys. The list is based on the meta keys used by WordPress, your themes and plugins.

   Once you have set the above fields you can click on Add Field to add a new Custom Field. You can see this field at the end of default fields. Custom Fields can be deleted by click on the recycle bin icon at the right most side of the custom field.

   Custom Field
   This fields has additional field options such as Show on form, Required, Custom Required Message, Label, Field Notes (Don’t Show/ Show as info icon, Show as Tool Tip), Field Notes Text, Frontend Display Settings and Frontend Display Label. You can set your custom field to the the following field types:

   • Text Field
   • Text Area
   • Date Picker
     The Date Picker provides these formats ISO 8601 – yy-mm-dd, Default – mm/dd/yy, Short – d M, y, Medium – d MM, y, Full – DD, d MM, yy, With text – ‘day’ d ‘of’ MM ‘in the year’ yy
   • File Uploader
     The file uploader supports
     • Images (jpg, jpeg, png, gif)
     • Documents (pdf, doc/ docx, xls/ xlsx, odt, ppt/ pptx/ pps/ ppsx)
     • Audio (mp3/ mp4/ ogg/ wav)
     • Video (mp4, m4v, mov, wmv, avi, mpg, ogv, 3gp, 3g2)
     • Custom Extensions like zip, bmp.

     You can also set Upload Button Label, Max Upload File Size, Multiple File Upload, Max Upload File Limit, Max Upload Limit Message and Attach Media to Post. When you Attach media to post, the attachment is appended to the end of your post content.

     

     For the image attachment you can set Image Dimensions and Open as lightbox.

     Other file types such as Documents, Audio, Video and Custom Extensions show up as URL path to the file. You can check Show as link if you want to change the URL path to a link.

     All you attachments are saved in your WordPress Media Library.

     If you do not select Frontend Display, the attachment will not appear in the Published Post.

   • Radio Button
     You can use Add Option to add a new radio option. You can set the option, value and default checked state.
   • Check Box
     You can use Add Option to add a new check option. You can set the option, value and default checked state.
   • Select Option
     You can use Add Option to add a new select option. You can set the option, value and default checked state. You can enable Multiple Select.

   To get the value of the Custom Fields, please go to the respective post editor. Click on Screen Options and select Custom Fields. You will see a Custom Fields Metabox with your Custom Field Meta and the value.

1. Form Extra Settings
   • Post Categories
     This section is for assigning the post submitted from the form directly to any specific category/taxonomy automatically if you don’t incude the post category selecting dropdown from the form field configurations.
   • Terms and Agreement
     Check if you want to show the terms and agreement text at the end of the form. You can set Terms and Agreement Required Message and Terms and Agreement Text. You can use basic html tags such as anchor links, strong, em, ul li etc in Terms and Agreement Text.
   • Submit Button Label
     Please enter the label for the submit button of the form

Captcha Settings

From the captcha settings , you can either enable or disable the captcha in the front form.And you can also choose the captcha type.Currently there are two captcha types available in the plugin. One is mathematical captcha and the other is Google reCaptcha which is more secure. The plugin provides Google reCaptcha Version 1 and 2. Also you can setup your custom captcha label and custom captcha error message.

For showing google captcha in the form, you will need the reCaptcha Public and Private keys for Google reCaptcha Version 1 or Site Key and Secret Key for Google reCaptcha Version 2, you can get those keys from the Google reCaptcha page.

Here is the URL to the Google reCaptcha admin page from where you can get both the keys once after you have registered your site’s domain.

https://www.google.com/recaptcha/admin#whyrecaptcha

Form Style Settings

From this section, you can configure the style of your forntend form. Currently there are two styling options. One is using already built in Form Templates. There are 4 templates that you can choose.

The next one is using the form styler to style the form yourself by configuring different styling options such as fonts, colors, width , background etc.

Using Shortcode

For showing the anonymous post form in any page in the frontend, please use [ap-form id="form_id"] shortcode in the page’s content editor or just use <?php echo do_shortcode[ap-form id="form_id"] ?> inside your theme’s template file where you wish to show the anonymous post form for the frontend post submission.

If you have kept some redirect URL in the redirect URL field in the general settings, then to display the your custom post submission message, please use [ap-form-message] in the redirected page’s content editor where you want to display the after post submission message.

If you haven’t placed any redirect URL in the general settings section then the form will be submitted to the same page and the submission will show just below the form title as per your kept format.

The plugin settings comes with a Restore Default Settings options which resets the settings to its original default state. You can use the Preview button to This is just view the basic preview which may look different when used it in the frontend as per your theme’s styles.

Settings

When you go to Dashboard-> Anonymous Post Pro-> Settings you will see two aditional settings.

1. Disable Lightbox: Check if you want to disable lightbox in this plugin.
2. Disable Jquery UI: Check if you want to disable jquery UI in this plugin.