“CJomatic - Commission Junction Affiliate Plugin for WordPress” Help by CodeRevolution

---

“CJomatic - Commission Junction Affiliate Plugin for WordPress Help”

---

Table of Contents

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

---

Basic Plugin Information

This plugin will allow you to build from scratch an affiliate marketing referral website for all online marketplaces that are affiliate with Commission Junction. This plugin provides one solution to the ongoing search for new referral 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 from the Commission Junction Markets. 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:
CJomatic Commission Junction Affiliate Plugin will import items from Commission Junction Marketplaces you define to your blog. Resulting blog posts are fully customizable and rich in content. List of customizable stuff for each post:

• import products based on custom keyword search, to WordPress posts
• import products based on monthly top sellers on monthly top commissions
• edit post author user name
• edit post status (published, draft, pending, private, trash)
• edit automatically generate post categories or tags from marketplace items
• manually add post categories or tags to items
• generate post or page or any other custom post type
• automatically generate a featured image for the post
• enable/disable comments for the generated post
• customize post title and content (with the included wide variaty of relevant post shortcodes)

Other plugin features:

• Using CJ Affiliate API
• Link hiding using Goo.gl link shortener
• Automatically update generated posts
• Keyword Replacer (replace relevant keywords with referral links)
• Random sentence generator (relevant sentences - as you define them)
• detailed plugin activity logging
• scheduled rule runs
>

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

How to get an affiliate key and website id?

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

Plugin Settings - top

Refreshingly, CJomatic Commission Junction Affiliate 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:

• CJomatic Commission Junction Affiliate Plugin Main Switch: Enable or disable the CJomatic Commission Junction Affiliate Plugin. This acts like a main switch.
• Commission Junction API Key: Insert your Commission Junction API Key. You can get one here: here. Before you can get one, you have to sign up for their affiliate program, here.
• Commission Junction Website ID: Insert your Website affiliate ID. Get one here click 'Account' -> 'Websites' -> 'Add Website'. For this to work, be sure you disable your 'ADBLOCKING' plugins from your browser, because they will make this page not to work. After you registered your webpage, copy the ID of the website here.
• Show Extended Item Information Metabox in Post: Choose if you want to show an extended information metabox under every plugin generated post.
• Automatically Shorten URLs: Choose if you want to cloak URLs with goo.gl link shortener. To lean more about this, please visit this link.
• Goo.gl API key: Insert your goo.gl api key. To lean more about this, please visit this link.
• Strip Links From Generated Post Content: Choose if you want to strip links from the generated post content.
• 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.
• 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.
• 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 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.
• Skip Posts That Do Not Have Images: Choose if you want to skip posts that do not have images.
• Automatically Translate Content To: Do you want to automatically translate generated content using Google Translate?
• Hide Google Translate Popup: Do you want to hide the Google Translate Popup that shows when hovering on the resulting translated text, containing the original text before translation?
• 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!
• 'The Best Spinner' User Name: Insert your user name on 'The Best Spinner'.
• 'The Best Spinner' Password: Insert your password on 'The Best Spinner'.
• 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.
• Search Keyword This keyword will be replaced with a link you define.
• Replacement Keyword 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 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.

Each Rule Type has the following settings in it's own settings screen:

• ID: This is the ID of the rule.
• Keyword Search: Input your queried keyword. Posts will be generated based on these keywords. This value restricts the search results based on keywords found in the advertiser's name, the product name or the product description. This parameter may be left blank if other parameters (such as upc, isbn) are provided. You may use simple Boolean logic operators ('r;+', 'r;-'r;) to obtain more relevant search results. By default, the system assumes basic OR logic. The examples below illustrate how these operators affect search results.'kitchen sink' - Any product with the word 'kitchen' or 'sink'; '+kitchen +sink'- Any product with the words 'kitchen' and 'sink'; '+kitchen -sink' - Any product with 'kitchen' and without 'sink'; 'kitchen +sink' - All the products with the word 'sink'; if they also contain 'kitchen', it increases the product's relevancy.
• 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-200 interval allowed..
• 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.
• Del: Do you want to delete this rule?
• 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.

From here on, each rule type will have an advanced settings panel. Each rule type will have the following advanced settings:

• Generated Posts Title: Set the title of the generated posts for user rules. You can use the following shortcodes: %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_description%%, %%item_content%%, %%item_cat%%, %%item_tags%%
• Generated Posts Content: Set the content of the generated posts for user rules. You can use the following shortcodes: %%item_intro%%, %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_content%%, %%item_content_plain_text%%, %%item_url%%, %%item_ad_id%%, %%item_id%%, %%item_buy_now_button%%, %%item_show_image%%, %%item_image_URL%%, %%item_description%%, %%item_ad_id%%, %%item_advertiser_id%%, %%item_advertiser_name%%, %%item_advertiser_category%%, %%item_catalog_id%%, %%item_currency%%, %%item_in_stock%%, %%item_isbn%%, %%item_manufacturer_name%%, %%item_price%%, %%item_sku%%, %%item_manufacturer_sku%%, %%item_retail_price%%, %%item_sale_price%%, %%item_upc%%, %%author%%
• 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?
• Min Retail Price: Do you want to set a minimum price for the imported item? Limits the results to products with a price greater than or equal to this value.
• Max Retail Price: Do you want to set a maximum price for the imported item? Limits the results to products with a price lower than this value.
• Min Sale Price: Do you want to set a minimum price for the imported item? Limits the results to products with a price greater than or equal to this value.
• Max Sale Price: Do you want to set a maximum price for the imported item? Limits the results to products with a price lower than this value.
• Advertiser IDs: Limits the results to a set of particular advertisers (CIDs) using one of the following four values. List of CIDs (comma separated): You may provide list of one or more advertiser CIDs, separated by commas, to limit the results to a specific sub-set of merchants. Empty String: You may provide an empty string to remove any advertiser-specific restrictions on the search. joined: This special value (joined) restricts the search to advertisers with which you have a relationship. notjoined: This special value (not-joined) restricts the search to advertisers with which you do not have a relationship.
• Servicable Area: Limits the results to a specific set of advertisers' targeted areas.
• ISBN: Limits the results to a specific product from multiple merchants identified by the appropriate unique identifier; ISBN.
• UPC: Limits the results to a specific product from multiple merchants identified by the appropriate unique identifier; UPC.
• Manufacturer Name: Manufacturer name associated with the item. You can enter all or part of the name.
• Manufacturer SKU: Limits the results to a particular manufacturer's SKU number.
• Advertiser SKU: Limits the results to a particular advertiser SKU.
• Currency: Limits the results to one of the following currencies: USD, EUR, GBP.
• Sort Results By: Select the type of sorting of the returned results.
• Sort Order: Specifies the order in which the results are sorted; the following case-insensitive values are acceptable. ASC, DESC
• 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 Commission Junction items?
• 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.
• Automatically Add Post Tags From Items: Do you want to automatically add post tags from the Commission Junction items?
• Additional Post Tags: Select the post tags that you want for the automatically generated posts to have.
• Permalinks Link To Source: Make permalinks (title and image) link directly to the post's source url. Warning: posts will not load at your site!
• Link Post Images To Source: Do you want to link post images to original article source?
• Automatically Add Post Featured Image: Do you want to automatically add post featured image from the Commission Junction item?
• 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.
• Enable Comments For Generated Posts: Do you want to enable comments for the generated posts?
• Enable Pingback/Trackback: Do you want to enable pingbacks/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_intro%%, %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_content%%, %%item_content_plain_text%%, %%item_url%%, %%item_ad_id%%, %%item_id%%, %%item_buy_now_button%%, %%item_show_image%%, %%item_image_URL%%, %%item_description%%, %%item_ad_id%%, %%item_advertiser_id%%, %%item_advertiser_name%%, %%item_advertiser_category%%, %%item_catalog_id%%, %%item_currency%%, %%item_in_stock%%, %%item_isbn%%, %%item_manufacturer_name%%, %%item_price%%, %%item_sku%%, %%item_manufacturer_sku%%, %%item_retail_price%%, %%item_sale_price%%, %%item_upc%%, %%author%%

How to customize resulting posts with built in shortcodes?

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

• %%item_intro%% - generates an item intro card, with the item main image and some relevant links with your affiliate account name added
• %%custom_html%% - the #1 custom html that you defined in the plugin settings
• %%custom_html2%% - the #2 custom html that you defined in the plugin settings
• %%random_sentence%% - the #1 random sentence generator that you configured in the plugin
• %%random_sentence2%% - the #2 random sentence generator that you configured in the plugin
• %%item_title%% - the title of the item
• %%item_description%% - the description of the item
• %%item_content%% - the main content of the item
• %%item_content_plain_text%% - the title of the item in plain text
• %%item_image_URL%% - the image url of the item
• %%item_url%% - the url of the item
• %%item_ad_id%% - the ad id of the product
• %%item_id%% - the id of the product
• %%item_buy_now_button%% - the product buy now button
• =----todo in jos %%item_show_image%% - the imgage of the product
• %%item_currency%% - the currency of the price of the product
• %%item_advertiser_id%% - the advertiser id of the product
• %%item_advertiser_name%% - the advertiser name of the product
• %%item_advertiser_category%% - the advertiser category of the product
• %%item_catalog_id%% - the catalog id of the product
• %%item_in_stock%% - is the the product
• %%item_isbn%% - the isbn of the product
• %%item_manufacturer_name%% - the manufacturer name of the product
• %%item_sku%% - the sku of the product
• %%item_manufacturer_sku%% - the manufacturer sku of the product
• %%item_retail_price%% - the retail price of the product
• %%item_sale_price%% - the sale price of the product
• %%item_upc%% - the upc of the product
• %%item_cat%% - the categories of the item
• %%item_tags%% - the tags of the item
• %%item_id%% - outputs the item id
• %%author%% - show the item's manufacturer name

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.

Results: If everything is configured well, you can go to plugin administration page, and you can wait to see it's results in your posts admin page (and in plugin control panel where you can see logs of your user submitted posts)!

Summary - top

CJomatic Commission Junction Affiliate plugin is a simple, yet powerful tool you can use to create a profitable affiliate marketing webpage. 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

---