“Imguromatic Automatic Post Generator for WordPress” Help by CodeRevolution

---

“Imguromatic Automatic Post Generator for WordPress Help”

---

Table of Contents

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

---

About this plugin - top

Many of us have used Imgur to share content on Reddit and other social networking sites. Some people upload their large images to Imgur and serve it directly from there to improve their site's speed. Thanks to this plugin, you can upload images to Imgur or add them to your site from Imgur more efficiently.

If you're an online writer or publisher and you want to include a picture from Imgur, it's now easy to do so in a totally legit way thanks to this plugin's new embedding capabilities. Also if you want to automatically post to Imgur, this plugin is also on your side.

This plugin will allow you to build from scratch an autoblogging system, based on Imgur feeds you define (based on keyword search). This plugin provides one solution to the ongoing search for new blog content. It not only provides a steady stream of rich, searchable content, it also helps to keep your website up to date with the latest pictures from Imgur. You can build rules that will generate posts that are near to unique in website crawlers's eyes. They require none to very little customization.
The goal is to achieve the following:
Imguromatic Automatic Post Generator will import items from any content from public Imgur content, you define to your blog. Resulting blog posts are fully customizable and rich in content. List of customizable stuff for each post:

• post author user name
• post status (published, draft, pending, private, trash)
• automatically generate post categories or tags from Imgur posts
• manually add post categories or tags to items
• generate post or page
• automatically generate a featured image for the post
• enable/disable comments for the generated post
• enable/disable pingbacks/trackbacks for the generated post
• customize post title and content (with the included wide variaty of relevant post shortcodes)

Other plugin features:

• Google Translate support ' select the language in which you want to post your articles
• Text Spinner support ' automatically modify generated text, changing words with their synonyms ' great SEO value!
• Supports Imgur public content
• Using Imgur API
• Keyword Replacer (replace relevant keywords with your links)
• Random sentence generator (relevant sentences - as you define them)
• Detailed plugin activity logging
• Scheduled rule runs

---

Plugin requirements:

PHP 5.0.0 or newer

php CURL extension (install to Debian/Ubuntu etc with apt-get install php5-curl)

PHP DOM -> how to install it (if you don't have it, but probably you already have it): http://php.net/manual/en/dom.setup.php

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 'Imguromatic Post Generator'. First thing first, let's head over to Settings > Imguromatic Post Generator and take a look at what options are available.

Plugin Settings - top

Refreshingly, Imguromatic Automatic Post Generator 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:

• Imguromatic Automatic Post Generator Main Switch: Enable or disable the Imguromatic Automatic Post Generator. This acts like a main switch.
• Imgur App ID: Insert your Imgur App ID. Learn how to get one here. If you want to post automatically to Imgur, you have to set the 'Authorization callback URL' parameter of the API to
• Imgur App Secret: Insert your Imgur App Secret. Learn how to get one here. If you want to post automatically to Imgur, you have to set the 'Authorization callback URL' parameter of the API to
• X-Mashape-Key For Commercial Use (Optional): Insert your X-Mashape-Key if you are planning to use the Mashape Imgur API (payed), instead of the free one. To use this, you must also register with Mashape. This field is optional.
• Do Not Check For Duplicate Posts: Choose if you want to skip checking for duplicate posts when publishing new posts (check this if you have 10000+ posts on your blog and you are experiencing slowdows when the plugin is running. If you check this, duplicate posts will be posted! So use it only when it is necesarry.
• Limit Returned Posts Count To Maximum Import Value Per Rule: Choose if you want to limit queried post count to maximum import value for the respective rule. This will decrease the time required for rule running, but will increase the chance that you will miss some posts from publishing.
• Try To Replace WP_Cron With Real Cron: Warning! If you don't know what this option does, please leave it unchecked. Enable this option to try to replace the wp_cron system the plugin uses with a real cron system from PHP. This will lift the limitations of wp_cron (no more website visitors required to run the job), but might not function on all systems. If you own more plugins from CodeRevolution that has this option in their settings, for best performance, please enable this option only in one of them!
• Featured Image Resize Width: Resize the image that was assigned to be the featured image to the width specified in this text field (in pixels). If you want to disable this feature, leave this field blank.
• Featured Image Resize Height: Resize the image that was assigned to be the featured image to the height specified in this text field (in pixels). If you want to disable this feature, leave this field blank.
• Strip Links From Generated Post Content: Choose if you want to strip links from the generated post content.
• Show Extended Item Information Metabox in Post: Choose if you want to show an extended information metabox under every plugin generated post.
• Enable Logging for Rules: Do you want to enable logging for rules?
• Enable Detailed Logging for Rules: Do you want to enable detailed logging for rules? Note that this will dramatically increase the size of the log this plugin generates.
• Automatically Clear Logs After: Choose if you want to automatically clear logs after a period of time.
• Timeout for Rule Running (seconds): Set the timeout (in seconds) for every rule running. I recommend that you leave this field at it's default value (3600).
• Send Rule Running Summary in Email: Choose if you want to receive a summary of the rule running in an email.
• Email Address: Input the email adress where you want to send the report. You can input more email addresses, separated by commas.
• Minimum Title Word Count: Set the minimum word count for post titles. Items that have less than this count will not be published. To disable this feature, leave this field blank.
• Maximum Title Word Count: Set the maximum word count for post titles. Items that have more than this count will not be published. To disable this feature, leave this field blank.
• Minimum Content Word Count: Set the minimum word count for post content. Items that have less than this count will not be published. To disable this feature, leave this field blank.
• Maximum Content Word Count: Set the maximum word count for post content. Items that have more than this count will not be published. To disable this feature, leave this field blank.
• Banned Words List: Do not include posts that's title or content contains at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
• Required Words List: Do not include posts that's title or content does not contain at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
• Strip HTML Elements from Final Content by ID: Strip HTML elements from final content that have this IDs. You can insert more IDs, separeted by comma. To disable this feature, leave this field blank.
• Strip HTML Elements from Final Content by Class: Strip HTML elements from final content that have this class. You can insert more classes, separeted by comma. To disable this feature, leave this field blank.
• Imgur Post Types to Skip: Skip these Imgur post types when inserting blog posts. Valid values are: image and animated gif
• Automatically Translate Content To: Do you want to automatically translate generated content using Google Translate?
• Skip Posts That Do Not Have Images: Choose if you want to skip posts that do not have images.
• Skip Posts Older Than a Selected Date: Choose if you want to skip posts that are older than a selected date.
• Choose if you want to skip posts that are older than a selected date. Select the date prior which you want to skip posts.
• Spin Text Using Word Synonyms: Do you want to randomize text by changing words of a text with synonyms using one of the listed methods? Note that this is an experimental feature and can in some instances drastically increase the rule running time!
• First List of Possible Sentences (%%random_sentence%%): Insert some sentences from which you want to get one at random. You can also use variables defined below. %something ==> is a variable. Each sentence must be sepparated by a new line.
• Second List of Possible Sentences (%%random_sentence2%%): Insert some sentences from which you want to get one at random. You can also use variables defined below. %something ==> is a variable. Each sentence must be sepparated by a new line.
• List of Possible Variables: Insert some variables you wish to be exchanged for different instances of one sentence. Please format this list as follows:Variablename => Variables (seperated by semicolon)Example:adjective => clever;interesting;smart;huge;astonishing;unbelievable;nice;adorable;beautiful;elegant;fancy;glamorous;magnificent;helpful;awesome
• Custom HTML Code #1: Insert a custom HTML code that will replace the %%custom_html%% variable. This can be anything, even an Ad code.
• Custom HTML Code #2: Insert a custom HTML code that will replace the %%custom_html2%% variable. This can be anything, even an Ad code.
• ID (Affiliate Keyword Replacer Tool Settings:) This is the ID of the rule.
• DEL (Affiliate Keyword Replacer Tool Settings:) Do you want to delete this rule?
• Search Keyword (Affiliate Keyword Replacer Tool Settings:) This keyword will be replaced with a link you define.
• Replacement Keyword (Affiliate Keyword Replacer Tool Settings:) This keyword will replace the search keyword you define. Leave this field blank if you only want to add an URL to the specified keyword.
• Link To Add (Affiliate Keyword Replacer Tool Settings:) Define the link you want to appear the defined keyword. Leave this field blank if you only want to replace the specified keyword without linking from it.

Rules List Settings Screen:

• ID This is the ID of the rule.
• Query String Set the query string. If you specify 'Advanced query search' parameters, this field will be ignored. This parameter also supports boolean operators (AND, OR, NOT) and indices (tag: user: title: ext: subreddit: album: meme:). An example compound query would be 'title: cats AND dogs ext: gif'
• Schedule (Hours) Select the interval in hours after which you want this rule to run.
• Max Posts At A Time Select the maximum number of posts that this rule can create at once. 0-100 interval allowed..
• Del: Do you want to delete this rule?
• Post Status: Select the status that you want for the automatically generated posts to have.
• Item Type : Select the type (post/page) for your automatically generated item.
• Post Author :  Select the author that you want to assign for the automatically generated posts.
• Active: Do you want to enable this rule? You can deactivate any rule (you don't have to delete them to deactivate them).
• Info: The number of items (posts, pages) this rule has generated so far.
• Actions: Do you want to run this rule now? Note that only one instance of a rule is allowed at once.

Advanced Plugin Settings Dropdown Screen:

• Generated Post Title: Set the title of the generated posts for user rules. You can use the following shortcodes: Set the title of the generated posts for user rules. You can use the following shortcodes: %%item_short_content%%, %%author%%, %%item_description%%, %%item_date%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_description%%, %%item_content%%, %%item_cat%%, %%item_tags%%
• Generated Post Content: Set the content of the generated posts for user rules. You can use the following shortcodes: Set the content of the generated posts for user rules. You can use the following shortcodes: %%item_media%%, %%item_views%%, %%item_is_nsfw%%, %%item_is_animated%%, %%item_is_album%%, %%item_date%%, %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_description%%, %%item_content%%, %%item_content_plain_text%%, %%item_img_url%%, %%item_url%%, %%item_cat%%, %%item_tags%%, %%item_read_more_button%%, %%item_show_image%%, %%item_image_URL%%, %%author%%, %%author_link%%
• Remember Last Posted Item And Continue Search From It: Do you want to remember last posted item and continue search from it the next time the importing rule runs?
• Search For Of All These Words: Search for all of these words (and)
• Search For Any Of These Words: Search for any of these words (or)
• Search Exactly For These Words: Search for exactly this word or phrase
• Exclude Results Matching: Exclude results matching this.
• Image Types To Return: Select the image types you want to return as posts.
• Sort Results By: Select how you want to sort the resulting image posts.
• Results Date Range: Change the date range of the request if the sort is 'top', day | week | month | year | all, defaults to all.
• Filter By NSFW: Select how you would like to handle nsfw images.
• Filter By Animated: Select how you would like to handle animated images (gifs).
• Disable Automatic Excerpt Generation: Do you want to disable the automatic post excerpt generation?
• Set Post Original Date: Do you want to set post date as the original date from Imgur?
• Strip Images From Content: Do you want to strip images from generated content?
• Remove WP Default Post Category: This feature will try to remove the WordPress's default post category. This may fail in case no additional categories are added, because WordPress requires at least one post category for every post.
• Limit Title Word Count: Do you want to limit the title's lenght to a specific word count? To disable this feature, leave this field blank.
• Generated Post Format: If your template supports "Post Formats", than you can select one here. If not, leave this at it\'s default value.
• Additional Post Category: Select the post category that you want for the automatically generated posts to have.
• Automatically Add Post Categories From Items: Do you want to automatically add post categories from the feed items?
• Automatically Add Post Tags From Items: Do you want to automatically add post tags from the feed items?
• Additional Post Tags: Select the post tags that you want for the automatically generated posts to have.
• Enable Comments For Generated Posts: Do you want to enable comments for the generated posts?
• Enable Pingbacks/Trackbacks For Generated Posts: Do you want to enable pingbacks and trackbacks for the generated posts?
• Post Custom Fields: Set the custom fields that will be set for generated posts. The syntax for this field is the following: custom_field_name1 => custom_field_value1, custom_field_name2 => custom_field_value2, ... . In custom_field_valueX, you can use shortcodes, same like in post content. Example (without quotes): 'title_custom_field => %%item_title%%'. You can use the following shortcodes: %%item_media%%, %%item_views%%, %%item_is_nsfw%%, %%item_is_animated%%, %%item_is_album%%, %%item_date%%, %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_description%%, %%item_content%%, %%item_content_plain_text%%, %%item_img_url%%, %%item_url%%, %%item_cat%%, %%item_tags%%, %%item_read_more_button%%, %%item_show_image%%, %%item_image_URL%%, %%author%%, %%author_link%%
• Post Custom Taxonomies: Set the custom taxonomies that will be set for generated posts. The syntax for this field is the following: custom_taxonomy_name1 => custom_taxonomy_value1A, custom_taxonomy_value1B; custom_taxonomy_name2 => custom_taxonomy_value2A, custom_taxonomy_value2B; ... . In custom_taxonomy_valueX, you can use shortcodes. Example (without quotes): 'cats_taxonomy_field => manualtax1, %%auto_tax%%; tags_taxonomy_field => manualtax2, %%auto_tax%%'. You can use the following shortcodes: %%auto_tax%%
• Automatically Get Featured Image for Generated Post: Do you want to set featured image for generated post (to the first image that was found in the post)?
• Default Featured Image if No Image Available for Item: Insert a link to a valid image that will be set for the featured image for the posts that do not have a valid image attached or if you disabled automatical featured image generation. To disable this feature, leave this field blank.

Posts To Imgur Settings Screen:

• Imguromatic Automatic Post to Imgur Main Switch: Enable or disable automatic posting to Imgur every time you publish a new post (manually or automatically).
• Imgur Post Title Template: Choose the template of your Imgur posts title. You can use the following shortcodes: %%variable_content%%, %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %post_excerpt%%
• Imgur Post Description Template: Choose the template of your Imgur posts description. You can use the following shortcodes: %%variable_content%%, %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %post_excerpt%%
• Post To Album: The ID of the album you want to add the image to. For anonymous albums, this should be the deletehash that is returned at creation.
• Post Images Anonymously: Do you want to post images anonymously?
• Disable Autoposting of 'Posts': Do you want to disable automatically posting of WordPress 'posts' to Imgur?
• Disable Autoposting of 'Pages': Do you want to disable automatically posting of WordPress 'pages' to Imgur?
• Disable Autoposting of 'Custom Post Types': Do you want to disable automatically posting of WordPress 'custom post types' to Imgur?
• Disable Autoposting of Selected Categories: Do you want to disable automatically posting of selected categories to Imgur?
• Disable Autoposting of Selected Tags: Input the tags for which you want to disable posting. You can enter more tags, separated by comma. Ex: cars, vehicles, red, luxury. To disable this feature, leave this field blank.
• %%variable_content%% Shortcode Content: Set the %%variable_content%% shortcode content.
• %%variable_content%% Shortcode Occurance Rate: Set the occurance rate of the %%variable_content%% shortcode. In this percentage, the shortcode will be filled with content and posted.

Activity and Loggind Screen:

• Rules Currently Running: These rules are currently running on your server.
• Restore Plugin Default Settings: Hit this button and the plugin settings will be restored to their default values. Warning! All settings will be lost!
• Delete All Posts Generated by this Plugin: Hit this button and all posts generated by this plugin will be deleted!
• Activity Log: This is the main log of your plugin. Here will be listed every single instance of the rules you run or are automatically run by schedule jobs (if you enable logging, in the plugin configuration).

How to customize resulting posts with built in shortcodes?

You can use the following shortcodes in post title and content editing:

• %%random_sentence%% - generates a random sentence (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
• %%random_sentence2%% - generates a random sentence (from the second geenrator) (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
• %%custom_html%% - includes the custom HTML you defined in the Main Settings interface (Custom HTML Code #1:)
• %%custom_html2%% - includes the custom HTML you defined in the Main Settings interface (Custom HTML Code #2:)
• %%item_media%% - includes the images or gifs included in the original Imgur post
• %%item_views%% - includes the number of views of the Imgur post
• %%item_is_nsfw%% - includes if the post is NSFW
• %%item_is_animated%% - includes if the post is animated
• %%item_is_album%% - includes if the post is album
• %%item_date%% - includes the date of the Imgur post
• %%item_title%% - includes the item title
• %%item_description%% - includes a short description of the article
• %%item_content%% - includes the item full HTML content
• %%item_content_plain_text%% - includes the items plain text content
• %%item_image_URL%% - includes the article's image URL (if it exists)
• %%item_url%% - includes the article's URL
• %%item_cat%% - includes the article's category (if it exists)
• %%item_read_more_button%% - includes a 'Read More' button, pointing to the imgur post from which the article was generated
• %%item_show_image%% - includes the item image in the HTML page (the full image, not only it's URL)
• %%author%% - includes the Imgur post's author's name
• %%author_link%% - includes the Imgur post's author's URL (on Imgur)
• %%item_tags%% - includes the article's tag (if it exists)

How to work with 'Random Sentence Generator'?

You can use the Random Sentence Generator by inserting list of sentences to the 'First List of Possible Sentences (%%random_sentence%%)' text field. Here, you can add full sentences, or sentences with variables. Variables are structured as: %something. A possible list of sentences can be:

• Meet this %adjective %noun %sentence_ending
• This is the %adjective %noun ever%sentence_ending
• I %love_it %nouns , because they are the %adjective %sentence_ending
• My %family says this plugin is very %adjective %sentence_ending
• These %nouns are quite %adjective %sentence_ending

You can define variables in the 'List of Possible Variables:' textfield. Here you can define values to variables, values which will be used in the random sentence forming. Variables can be defined as follows:

variable_name1 => variable_value1;variable_value2;variable_value3

variable_name2 => variable2_value1;variable2_value2;variable2_value3

You can also use variables in variable definition. Example:

noun_with_adjective => %noun;%adjective %noun

An example of variable definition:

adjective_very => %adjective;very %adjective;

adjective => clever;interesting;smart;huge;astonishing;unbelievable;nice;adorable;beautiful;elegant;fancy;glamorous;magnificent;helpful;awesome

noun_with_adjective => %noun;%adjective %noun

noun => plugin;WordPress plugin;item;ingredient;component;constituent;module;add-on;plug-in;addon;extension

nouns => plugins;WordPress plugins;items;ingredients;components;constituents;modules;add-ons;plug-ins;addons;extensions

love_it => love;adore;like;be mad for;be wild about;be nuts about;be crazy about

family => %adjective %family_members;%family_members

family_members => grandpa;brother;sister;mom;dad;grandma

sentence_ending => .;!;!!

These random sentences can be used in post titles or post content, by adding the %%random_sentence%% or %%random_sentence2%% shortcode.

Available shortcode

Available shortcodes: [imguromatic-list-posts] to include a list that contains only posts imported by this plugin and [imguromatic-display-posts] to include a WordPress like post listing. Usage: [imguromatic-display-posts type='any/post/page/...' title_color='#ffffff' excerpt_color='#ffffff' read_more_text="Read More" link_to_source='yes' order='ASC/DESC' orderby='title/ID/author/name/date/rand/comment_count' title_font_size='19px', excerpt_font_size='19px' posts=number_of_posts_to_show category='posts_category' ruleid='ID_of_echo_rule'].
Example: [imguromatic-list-posts type='any' order='ASC' orderby='date' posts=50 category= '' ruleid='0']
Example 2: [imguromatic-display-posts include_excerpt='true' image_size='thumbnail' wrapper='div'].

Summary - top

Imguromatic Automatic Post Generator is a simple, yet powerful tool you can use to create an autoblog with ease. 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

---