When you are using WP-O-Matic, you will see that almost all of the options have excellent descriptions next to them, helping you to understand what they do. However, we always provide installation guides for plugins we provide so that you can be taken through the installation process of the plugin and then familiarised with the features and functions enough to be able to understand the plugin, how it works and allows you to begin using the plugin on your own.

Activating

1) Download WP-O-Matic (download link found within e-mail).

2) Extract the zip file. This will result in a folder called “wp-o-matic” and inside the folder you will see a file called “wpomatic.php”.

3) Upload the “wp-o-matic” folder to your wp-content/plugins folder via ftp.

4) Login to your website, visit the plugins page and click on “activate” next to WP-O-Matic.

WP-O-Matic is now active. You now need to go through the settings to install WP-O-Matic, all of which are fully described in the next step below.

Setup

Under the Settings menu, click on WP-O-Matic. If this is the first time you have used WP-O-Matic, it will detect that it has not been installed and instantly take you to the setup screen where there are three steps to complete (the fourth step is just confirmation that the prior three steps have been completed).

Step 1

Step 1

Follow the on screen instructions to ensure that your site is running everything needed for WP-O-Matic to work properly. While it does not require much, this step is vital as it allows you to spot any issues and have them addressed before you begin using WP-O-Matic.

Step 2

Step 2

This step ensures that you are using the correct time within your WordPress site by comparing the UTC time with the timezone set within your WordPress site. You can then correct your timezone before going live which will avoid a number of date/time issues.

Step 3

Step 3

When your rss feeds need to be pulled by WP-O-Matic to create posts, it needs to be triggered on a regular basis. This is usually done by creating a cron job within your hosting account. The most common hosting control panel is cPanel and we will show you how to create a cron within cPanel below. If you use another hosting control panel, please contact your host for instructions.

Creating a cron job

Creating a cron using cPanel:

1) Login to cPanel.

2) Locate "cron jobs" and click on it to visit your cron page.

3) Set the cron job to run every 20 minutes. You do this by entering the following values into the corresponding boxes:

Minute: */20
Hour: *
Day: *
Month: *
Weekday: *

This cron will process every 20 minutes and will fetch any campaigns that are scheduled to be checked. You may want to alter the frequency of the cron, frequency of category fetch and number of posts imported on each fetch.

4) Enter the line provided by WP-O-Matic (ignoring everything before the *) into the command box.

Go back to the WP-O-Matic setup and click on "next". This will confirm the setup and you can then click on "submit" to save your settings.

WP-O-Matic has now been setup and you should now go through the available options to ensure that they are to your liking. This process is explained in full details below.

Options

Click on "options" which is displayed on the left hand side of the WP-O-Matic dashboard.

All of the options (except one) have a "more" link which will open a small window containing information about that option.

Unix Cron - You can enable and disable the Unix Cron option. Your cron details are displayed so that you can easily copy them if you need to create the cron again. Default: Active

Enable Logging - Actions such as the importing procedure and checking procedure can be logged within the database. This allows you to see which campaigns were last processed. Default: Active

Enable Logging Stdout - Allows the log to be viewed in real time as campaigns are fetched and processed. This can help you see issues as they happen, but it can also increase the load on the server. Default: Inactive

Cache Images - Images can be cached for all campaigns. If you prefer to only have some campaigns where images are cached, you can set the cache images option within the campaign. Default: Inactive

Image Cache Path - Where will the cached images be stored? The default location is "cache" which will store the images within your /wp-content/plugins/wp-o-matic/cache folder. Make sure that the folder can be written to by WP-O-Matic, otherwise it will not be able to store the cached images.

Allow Duplicate Posts - In the past WP-O-Matic would randomly duplicate posts, creating as many as 4 posts when only 1 should have been created. We added a checking feature which ensures that duplicate posts can not be created. This option has been added so that you can allow duplicate posts to be created if you so desire.

Creating a Campaign

Click on "add campaign" which can be seen to the left of Wp-O-Matic options.

This is where you will add a campaign and all of the settings for the campaign. We will take you through every step and option below.

When you move from one tab to the next, you do not need to save or click on submit as the details will be stored while you move from tab to tab. Once you are happy with all of your campaign settings, you can then click on submit to finish the process.

Add Campaign - Basic

Step 1 - Basic

This is the first tab and it is the tab that you will see first when you go to add a campaign. The options for this page are:

Title - Add a title that will allow you to easily identify the campaign. The title will only be visible to site admins.

Active - Tick this box if you would like the campaign to be active as soon as you have added the campaign. If you prefer, you can untick the box and activate it later, once you are happy with your campaign settings.

Campaign Slug - This is optional and can be used to identify the campaign when using adverts within the campaign.

Add Campaign - Feeds

Step 2 - Feeds

Here, you can add all of the rss feeds that you would like for the campaign. There needs to be at least one feed, but there is no upper limit for the number of feeds you add.

Add Campaign - Categories

Step 3 - Categories

Select the category that you would like to use for this campaign. You can select one or more categories if you like, but we advise that you only use one to prevent content dilution. If you do not have a category for this campaign, you can easily add one by clicking on the "quick add" link and entering a name for the category. You can always edit the category details from your Posts >> Categories section of your WordPress site.

Add Campaign - Rewrite

Step 4 - Rewrite

This is designed for admins who want to edit the content that is imported, changing words for other words, linking certain words or changing items based on expressions. Click on the "read more" link to view more information on the rewrite functions.

Add Campaign - Options

Step 5 - Options

This is a vital page as it sets out all of the extra options for your campaign. The options available are:

Custom post template - allowing you to set the exact format that you would like for your imported content within each post.

Frequency - how often you would like to import content. Please keep in mind that the more frequent that you fetch posts for each category will cause a higher load on your server. If performing frequent checks, we advise that you import less posts each time to help reduce the load on the server.

Cache images - storing the images locally to avoid hotlinking.

Use feed date - setting the post date to the same date that the item within the feed was published.

Perform pingbacks - ideal for obtaining linkbacks from the site providing the content, especially if they are a blog.

Type of post to create - allowing you to set the new posts as published, private or draft.

Author - setting the author for the posts imported for this campaign.

Max items to create on each fetch - setting how many items are imported on each fetch. The more items you import and the more frequent this is completed, the greater the load will be on the server. Please keep in mind that the more posts you fetch, the higher the load will be on the server when the fetch is processed.

Post title links to source - If you are using a blog style, where the full content is displayed instead of an excerpt, you may want to link the post title directly to the source. This option allows you to do this.

Discussion options - Allow comments and / or pings on the post once it has been imported and published.

You can now click on the "submit" button to save your campaign. When you save a campaign for the first time, it will create a new tab within the campaign called "tools". This tab contains some fantastic tools that can be used to manage posts that have been created by the campaign. These include:

Remove all - Removes all posts that have been created by the campaign. This is great if you are testing the campaign as you can simply remove all posts and run the test again.

Change status to - Allows you to change the status of all posts created by this campaign.

Change author username to - Allows you to change the username used as the author for all posts that have been created by this campaign.

What next?

Ok, so you have completed the setup and added a campaign. Lets get WP-O-Matic to fetch the campaign so that we can view the posts and check that everything has been setup to your liking.

To do this, we would suggest that you:
1) Go to the Campaigns page, click on "edit" next to the campaign you have created. The first tab you will be shown is Basic, ensure that the tick is removed from "Active" as we do not want this campaign to fetch any posts until you have tested it and are happy with it.
2) Click on the Options tab and change the entry within the "Max items to create on each fetch" option to a very low number. We would suggest something like 5 or below. This will ensure that only a small number of posts are imported. Next, click on the "Submit" button.
3) Click on "Campaigns" and then click on "fetch" to the right of your campaign. This will fetch the campaign and create posts.
4) Visit the Campaigns page and click on "fetch" next to the campaign.
5) Once the fetch has completed, go and check the posts that have been created and make sure that they are as you would like them to be. Once you are happy, go back into the campaign, set it to active and set the number of posts that you would like imported each time.

You now have WP-O-Matic active, setup and have a campaign added. You can now add further campaigns if needed.

Should you need support, please click here to view available support options.