NATS Code Wordpress Plugin

From TMM Wiki
Revision as of 17:07, 12 December 2008 by TMMJoe (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search
NATS 4
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers
NATS Extras
TMMid
Gallery Builder Module
CAPTCHA
Remote Affiliate Authentication
Build Your Own Anything Module
Shopping Cart Sales
Moving Tours, Members' Area, and Galleries
Admin Areas
Extended Sales
NATS Code Wordpress Plugin
Error_message_display
ATVOD Verification Process
NATS 3
NATS Extras
Remote Affiliate Authentication
Shopping Cart Sales
Moving Tours, Members' Area, and Galleries
Require W-9
Admin Areas
Fraud Report
NATS Content of the Day Module
NATS Load Balancing Module
Gallery Builder Module
Build Your Own Anything Module
NATS Code Wordpress Plugin
Error_message_display
TMMid

The NATS Code Wordpress Plugin lets you use NATS codes in your Wordpress posts. The plugin will replace [nats] in your posts with affiliate NATS codes.

Installing on Wordpress

Download the plugin and extract it into your wordpress installation's wp-content/plugins/ directory. In Wordpress, go to the Plugins page, look for "NATS Code" in your Inactive Plugins list, and Activate it.

For more information on Wordpress plugin installation, please see the Managing Plugins page.

Removal

In Wordpress, go to the Plugins page. Look for "NATS Code" in your Active Plugins list, and Deactivate it.

Note: If you deactivate this plugin, you will probably want to go back and change all the links that use it; otherwise, they will have [nats] in the url instead of a NATS code.

Configuring the Plugin

On your Settings page, click the "NATS Code" tab.

Default NATS Code

Fill in the default NATS code to use if no other NATS code is available.

Affiliate

If you are an affiliate, sending traffic to other people's sites, as opposed to a program owner, sending traffic to your own sites and accepting affiliate traffic, check this box.

Note: Checking this box will disable getting NATS codes from the query string. If you're accepting affiliate traffic, your affiliates will not get any credit for it.

Site Codes

If you are set as an affiliate, you will have ability to fill in NATS codes to use with this plugin. There are three fields:

  • Short Name - an internal short name to be used with this NATS code. It will be used when you use this plugin in your posts
  • Description - (optional) an internal description of this NATS code. This won't be seen anywhere outside of the admin, and is only to help keep track of your NATS codes
  • NATS Code - the NATS code to use.

To add a new NATS code, fill in the bottom row of text boxes with these fields, and click add new.

You edit a site code, edit that rows fields and click the edit button.

To delete, click the delete button on that site code's row.

Note: If you delete a site code that is in use in your posts, the default NATS code will be used.

Using the Plugin

For Program Owners

This is how the plugin works if you do not check the "Affiliate" box on the settings page. If you have that checked, read the affiliate section of this below.

When you write a link that should pass a NATS Code, insert [nats] as a place holder. For example:

<a href="http://join.example.com/track/[nats]">Click Here</a>

The plugin replaces [nats] with the referring affiliate's linkcode when surfers referred by affiliates visit this page. The plugin replaces [nats] with the NATS code you set in the configuration step when surfers find this page on their own. The plugin can also replace [nats] with a custom NATS code when surfers find this page on their own; place the custom NATS code in [nats] separated from nats by a pipe character. For example:

<a href="http://join.example.com/track/[nats|Custom_NATS_Code]">Click Here</a>

Program Owners do not have site codes, as there's no way for this plugin to effectively change which site the NATS code is for while keeping the affiliate link. To do that, please see strack, which allows you to switch a surfer's site.

For Affiliates

This is how the plugin works if you have checked the "Affiliate" box on the settings page. If you do not have that checked, read the Program Owner section of this above.

After setting up your site NATS code on the settings page, you can insert the codes like this:

[nats|site:foo]

Where foo is the short name you created on the settings page.

As an example: if you set up a site code with the short name coolsite, with the NATS Code MyDoZwe, if you put this in your post:

<a href="http://join.example.com/track/[nats|site:coolsite]">Click Here</a>

The surfer would see this in the post:

<a href="http://join.example.com/track/MyDoZwe">Click Here</a>

You can also link to a NATS code like this:

[nats|NATS_CODE]

Where NATS_CODE is the NATS code you would like to use. (Realize this does not have any benefit over simply using the NATS code in the link).

Finally, if you want to link with the default NATS code, you can do so using this:

[nats]

Wordpress Caching

We tested this plugin with both wp-cache and wp-super-cache. It creates a separate cache file for each NATS code it receives from surfers; if you get traffic from a lot of different affliates, generating a cache file for each NATS code may undermine your caching system. Also, if you change the default NATS code or your Site Codes, you must clear your caching plugin's cache.

Wordpress Multiuser

We did not test this plugin with Wordpress Multiuser and it may not work. If you use Wordpress Multiuser and you're willing to help us test an improved version of this plugin, please submit a feature request ticket.

Previous Versions