Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via our email. Thanks so much!
This plugin will allow you to build from scratch an autoblogging system, based on WordPress.com blogs with REST API support, you define.
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 news. 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:
Wpcomomatic WordPress.com To WordPress Automatic Crossposter Plugin will import items from any content from public WordPress.com websites, 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 WordPress.com posts
manually add post categories or tags to items
generate post or page or any custom post type
automatically generate a featured image for the post
enable/disable comments for the generated post
import comments from the WordPress.com post as blog comments
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 WordPress.com public pages
Using WordPress.com's 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
This plugin requires a WordPress.com Application Password. How do I get that?
For the application password, you need to install on your target WordPress.com install this plugin. After the istallation, go to WordPress.com's 'Users' settings menu, select the user you want to use for publishing, scroll down until you see the 'Account Management' section, and create a new application key filling out the 'Application Password Name' field and hitting 'Add New'. You will be prompted with a popup containing the application key. Copy it in the plugin's settings menu -> 'Main Settings' -> 'WordPress.com Application Password'.
Plugin requirements:
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
PHP Curl
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.com 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.com called 'Wpcomomatic WordPress.com To WordPress Automatic Crossposter Plugin'. First thing first, let's head over to Settings > Wpcomomatic WordPress.com To WordPress Automatic Crossposter Plugin and take a look at what options are available.
Refreshingly, Wpcomomatic WordPress.com To WordPress Automatic Crossposter 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:
Wpcomomatic WordPress.com To WordPress Automatic Crossposter Plugin Main Switch: Enable or disable the Wpcomomatic WordPress.com To WordPress Automatic Crossposter Plugin. This acts like a main switch.
WordPress.com App ID: Insert your WordPress.com APP ID. You can get one here.
WordPress.com App Secret: Insert your WordPress.com APP secret. You can get one here.
Copy Images From Content Locally: Click this option if your want to save images found in post content locally. Note that this option may be heavy on your hosting free space.
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.
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.
WordPress.com Post Types to Skip: Skip these WordPress.com post types when inserting blog posts. Valid values are: link, status, photo, video, event, offer. Separate multiple entries by comma. Ex: 'status, offer, link'. To disable this feature, leave this textfield blank. For more info about WordPress.com post types, check plugin documentation.
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.
WordPress.com To Posts:
ID This is the ID of the rule.
Blog URL Input the WordPressCom blog URL from where you want to get posts.
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-50 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: %%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: %%item_date%%, %%item_audio_play_year%%, %%item_audio_track_number%%, %%item_audio_album%%, %%item_audio_artist%%, %%item_quote_source%%, %%item_play_count%%, %%item_asking_name%%, %%item_asking_url%%, %%item_link_author%%, %%item_link_publisher%%, %%item_link_url%%, %%item_link_excerpt%%, %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_description%%, %%item_content%%, %%item_content_plain_text%%, %%item_image_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?
Post Type To Search: Specify the post type. Defaults to 'post', use 'any' to query for both posts and pages. Post types besides post and page need to be whitelisted using the rest_api_allowed_post_types filter.
Post Search Query: Do you want to search posts by a search query? To disable this, please leave this field blank.
Search Posts From Author IDs: Do you want to search for posts only from specific authors? You must specify v author ID. You can specify more author IDs, separated by comma. To disable this feature, leave this field blank.
Search Posts By Slugs: Do you want to search for posts based on their slugs? You can define more slugs, separated by comma.
Term To Search By: Specify comma-separated term slugs to search within, indexed by taxonomy slug.
Search By Meta Key: Do you want to search based on a meta key?
Search By Meta Value: Do you want to exclude specific post IDs from the result?
Skip First Results: Offset the result set by a specific number of items. Skip first X results.
Search Posts Create After Date: Do you want to search for posts created only after this predefined date?
Search Posts Create Before Date: Do you want to search for posts created only before this predefined date?
Search Posts Modified After Date: Do you want to search for posts modified only after this predefined date?
Search Posts Modified Before Date: Do you want to search for posts modified only before this predefined date?
Search Posts By Category Name/Slug Do you want to search for posts based on their category name/slug? To disable this feature, leave this field blank.
Exclude Posts Tree By ID: Excludes the specified post and all of its descendants from the response. Applies only to hierarchical post types.
Search Posts By Tag Name/Slug: Do you want to search for posts based on their tag name/slug? To disable this feature, leave this field blank.
Exclude Posts By Post ID: Excludes the specified post ID(s) from the response
Search Posts By Status: Do you want to search posts by their status?
Get Only Sticky Posts: Do you want to get only sticky posts?
Order Results By: Select by what category to order the resulting posts.
Sort Results: Select how to sort the resulting posts (asc/desc).
Copy Existing Meta Fields From Posts Do you want to copy existing post meta fields and import them to created posts?
Pause Between Requests (ms): Do you want to insert a pause between consequest requests to the original WordPress.com site, that are made in the plugin? This feature can be usefull if the original WordPress.com site has rate limiting enabled. To disable this, leave this field blank. Value is expressed in milliseconds -> 1000 ms = 1 second.
Set Post Original Date: Do you want to set post date as the original date from WordPress.com?
Strip Images From Content: Do you want to strip images from generated content?
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?
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.
Import Comments: Do you want to automatically generate post comments from item's comments feed?
Posts To WordPress.com:
Delay Posting By (Seconds): Do you want delay posting with this amount of seconds from post publish? This will create a single cron job for each post (cron is a requirement for this to function). If you leave this field blank, posts will be automatically published on post creation.
Sites Where to Publish Posts: Select the sites associated with your App ID, where you want to publish your posts. To select multiple entries, please hold down the 'Control' key.
WordPress.com Post Title Template: Choose the template of your WordPress.com posts title. You can use the following shortcodes: %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %post_excerpt%%
WordPress.com Post Content Template: Choose the template of your WordPress.com posts. You can use the following shortcodes: %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %post_excerpt%%
WordPress.com Post Excerpt Template: Choose the template of your WordPress.com posts excerpt. You can use the following shortcodes: %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %%post_excerpt%%.
WordPress.com Posting Type: Choose what you want to create: post or page.
WordPress.com Post State: Choose what state will the automatically generated posts have on WordPress.com.
Page Menu Order: (Pages Only) the order pages should appear in. Use 0 to maintain alphabetical order.
Page Template: (Pages Only) The page template this page should use.
Generated Post Format: Set the post format you want to assign to generated posts.
Enable Comments: Choose what state will the comments be in, for generated posts.
Enable Pingbacks/Trackbacks: Choose what state will the pingbacks/trackbacks be in, for generated posts.
Import Meta Fields From Posts: Do you want to automatically import meta fields from source posts?.
Post Custom Taxonomies: Mapping of taxonomy to comma-separated list of term names. The syntax for this field is the following: taxonomy_name1 => term11,term12; taxonomy_name2 => term21,term22; ... . In termXX, you can use shortcodes, same like in post content. You can use the following shortcodes: %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %post_excerpt%%
Publicize Posted Article: Select if the post should be publicized to external services.
Publicize Message Template: Custom message to be publicized to external services. You can use the following shortcodes: %%featured_image%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%post_link%%, %%post_title%%, %%post_content%%, %post_excerpt%%
Generate Sticky Posts: Do you want to automatically generate sticky posts?
Likes Enabled For Posts: Do you want to likes for generated posts?
Sharing Enabled For Posts: Do you want to enable sharing for generated posts?
Copy Source Post Featured Image: Do you want to automatically set source post featured image as generated post featured image?
Copy Source Post Media: Do you want to automatically set source post media as generated post media?
Default Image ID To Set When No Image Available: .Choose the default image id (from the destination image gallery - media library) to use, when the post does not have a featured image to set. To disable this feature, leave this field blank.
WordPress.com Post Author Username/ID: Choose the author id who will generate the resulting published posts on the target WordPress.com install.
WordPress.com Post Password: Choose if you want to protect the generated posts by password.
WordPress.com Post Date: Choose what you want to set as generated post tags on WordPress.com. You can select between WordPress.com post's tags, categories, both or none.
Auto WordPress.com Post Tags: Choose what you want to set as generated post tags on WordPress.com. You can select between WordPress.com post's tags, categories, both or none.
Auto WordPress.com Post Categories: Choose what you want to set as generated post tags on WordPress.com. You can select between WordPress.com post's tags, categories, both or none.
Additional Post Categories: Choose an additional post category for generated posts.
WordPress.com Post Manual Tags: Choose what tags you want to manually add to generated posts on WordPress.com. Separate multiple tags by comma. Ex: flower, green, apple.
Disable Autoposting of 'Posts': Do you want to disable automatically posting of WordPress.com 'posts' to WordPress.com?.
Disable Autoposting of 'Pages': Do you want to disable automatically posting of WordPress.com 'pages' to WordPress.com?
Disable Autoposting of 'Custom Post Types': Do you want to disable automatically posting of WordPress.com 'custom post types' to WordPress.com?
Disable Autoposting of Selected Categories: Do you want to disable automatically posting of WordPress.com 'posts' to WordPress.com?
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.
Pause Between Requests (ms): Do you want to insert a pause between consequest requests to the original WordPressCom site, that are made in the plugin? This feature can be usefull if the original WordPressCom site has rate limiting enabled. To disable this, leave this field blank. Value is expressed in milliseconds -> 1000 ms = 1 second.
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_title%% - includes the item title
%%item_date%% - includes the item publishing date
%%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 wordpresscom 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 WordPress.com post's author's name
%%item_likes_enabled%% - includes the WordPress.com post's likes status
%%item_sharing_enabled%% - includes the WordPress.com post's sharing status
%%item_like_count%% - includes the WordPress.com post's like count
%%item_format%% - includes the WordPress.com post's format
%%item_geo%% - includes the WordPress.com post's geo location info
%%item_attachments%% - includes the WordPress.com post's attachments list
%%site_ID%% - includes the WordPress.com post's source site id
%%item_modified%% - includes the WordPress.com post's modified date
%%item_short_URL%% - includes the WordPress.com post's short url
%%item_slug%% - includes the WordPress.com post's slug
%%item_guid%% - includes the WordPress.com post's guid
%%item_status%% - includes the WordPress.com post's status
%%item_sticky%% - includes the WordPress.com post's sticky status
%%item_password%% - includes the WordPress.com post's password
%%item_parent%% - includes the WordPress.com post's parent id
%%item_type%% - includes the WordPress.com post's type
%%author_link%% - includes the WordPress.com post's author's URL (on WordPress.com)
%%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:
Wpcomomatic WordPress.com To WordPress Automatic Crossposter Plugin 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!
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.