Difference between revisions of "Duplicating Adtool Types"

From TMM Wiki
Jump to navigationJump to search
 
(4 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
[[NATS]] provides the ability to duplicate [[ct#Adtool|Adtool]] types, allowing you to build new adtools off of previously existing ones.  
 
[[NATS]] provides the ability to duplicate [[ct#Adtool|Adtool]] types, allowing you to build new adtools off of previously existing ones.  
  
'''Note''': Make sure you complete the following instructions before you begin customizing your duplicated adtool type in the [[NATS4 Adtools Admin|Adtools Admin].
+
'''Note''': Make sure you complete the following instructions before you begin customizing your duplicated adtool type in the [[NATS4 Adtools Admin|Adtools Admin]].
  
 
== Duplicating An Adtool ==
 
== Duplicating An Adtool ==
  
To duplicate an already existing adtool type, go to the [[NATS4 Adtools Admin|adtools admin]], find the adtool type you wish to duplicate, and click the "Duplicate Adtool Type" icon.
+
To duplicate an already existing [[Ct#Adtool|adtool]] type, go to the [[NATS4 Adtools Admin|Adtools Admin]], find the adtool type you wish to duplicate, and click the "Duplicate Adtool Type" icon.
  
After you enter a [[Ct#Shortname|shortname]] for your duplicated adtool type, you will be taken to the Editing Adtool Type page. Change your adtool description to a unique description and click Save Changes-- you will be making other changes later on. Next, click the "View Adtools" tab and upload your duplicated adtool type's first adtool.
+
After you enter a [[Ct#Shortname|shortname]] for your duplicated adtool type, you will be taken to the Editing Adtool Type page. Change your adtool description to a unique description and click Save Changes -- you will be making other changes later on. Next, click the "View Adtools" tab and upload your duplicated adtool type's first [[Ct#Adtool|adtool]].
 +
 
 +
[[File:Edit adtool type.PNG|Editing Your Duplicated Adtool Type]]
  
 
To clarify, "original adtool type" refers to the adtool type that existed before duplicating, while "duplicated adtool type" refers to the new adtool type that [[NATS]] created after you clicked the icon.
 
To clarify, "original adtool type" refers to the adtool type that existed before duplicating, while "duplicated adtool type" refers to the new adtool type that [[NATS]] created after you clicked the icon.
  
== Configuring Your Duplicated Adtool ==
+
== Editing Adtool Templates ==
 +
 
 +
To further configure your duplicated [[Ct#Adtool|adtool]], go to the [[NATS4 Skins and Templates Admin|Skins and Templates Admin]] and edit your ''default'' skin. On the next page, find the [[Ct#Template|templates]] related to your original adtool type. The template names you need contain three parts: "function_display_adtool", a [[Ct#Shortname|shortname]], and a view type.
  
Go to the [[Skins & Templates Admin]] and edit the ''default'' skin. You
+
Find the [[Ct#Template|templates]] that begin with "function_display_adtool" and contain the original [[Ct#Adtool|adtool]] type's [[Ct#Shortname|shortname]]. For example, you need to find the following two templates to duplicate the [[NATS4 Content|Content adtool type]].
need to find templates related to your original adtool type. The
 
template names you need contain three parts: "function_display_adtool",
 
a [[ct#Shortname|shortname]], and a view type. Find template names starting
 
with "function_display_adtool" and containing the original adtool type's
 
shortname. For example, to duplicate the Content adtool type, find the
 
following two templates:
 
  
 
* ''function_display_adtools_content_min''
 
* ''function_display_adtools_content_min''
 
* ''function_display_adtools_content_max''
 
* ''function_display_adtools_content_max''
  
For each template you find, make your web browser open the template's
+
[[File:Display adtool template.PNG|500px|Adtool Templates to Customize]]
edit page in a new tab or window. Usually you can do this by holding
+
 
your keyboard's Ctrl key while clicking the edit icon in NATS. Without
+
Open each relevant [[Ct#Template|template]] you find in a new web browser tab or window. You can usually do this by holding your keyboard's CTRL (Command key for Macs) key while clicking the edit icon, middle clicking the edit icon, or pressing CTRL+T (Command+T for Macs). Without closing your new tabs or windows, go back to the template list (in your original tab) and scroll to the top of the screen. In the "Create Template" box, enter a new name in the following form:
closing the new tabs or windows, go back to the template listing and
 
scroll to the top of the screen. In the create template box, enter a
 
name with the following form:
 
  
 
* function_display_adtools_<shortname>_<view type>
 
* function_display_adtools_<shortname>_<view type>
  
Replace ''<shortname>'' with your duplicated adtool type's shortname. Replace
+
Select "function_" from the first drop-down menu in the Name column, then replace ''<shortname>'' with your duplicated adtool type's shortname. Replace
 
''<view type>'' with the view type of the first template you found
 
''<view type>'' with the view type of the first template you found
earlier. For example, the first Content adtool type template gets the following name:
+
earlier. For example, the first Content adtool type template should be assigned the following name:
  
 
* ''function_display_adtools_mytool_min''
 
* ''function_display_adtools_mytool_min''
 +
 +
[[File:Duplicate adtool name.PNG|450px|Creating a Duplicate Adtool Template]]
  
 
In the Header drop-down, choose ''No Header;'' in the Footer drop-down,
 
In the Header drop-down, choose ''No Header;'' in the Footer drop-down,
choose ''No Footer.'' Enter a description and click Add. Go to the first
+
choose ''No Footer.'' Enter a description and click Add. Go to the first (default) template you found earlier, copy the entire contents of the [[Ct#Template|template's]] body, and paste it into the new template's body.
template you found earlier, copy the entire contents of the template's
+
 
Template Body, and paste it into the new template's Template Body.
+
In your new [[Ct#Template|template]], you will need to update the variables that reference the original [[Ct#Adtool|adtool]] type's fields so that they reference the duplicated adtool type's fields instead. When you are changing field names in the template, make sure to use the prefix "ign_" before each field name.
  
In the new template, you need to update the variables that reference the original
+
== Configuring Your Duplicated Adtool ==
adtool type's fields so that they reference the duplicated adtool type's fields. When changing
 
the field names in the template, prefix "ign_" to each field name.
 
  
After duplicating each template you found earlier, return to the Ad
+
After duplicating each [[Ct#Template|template]] you found earlier, return to the [[NATS4 Adtools Admin|adtools admin]] to edit your duplicated [[Ct#Adtool|adtool]] type. In the "Display Template" field, select your duplicate adtool's [[Ct#Shortname|shortname]] from the drop-down menu and click Save Changes.
Tools Admin and edit your duplicated adtool type. In the Display Template
 
field, click the drop-down box, select the option with your adtool's
 
shortname, and click Save Changes.
 
  
From the Main Program Page, go to Affiliate Adtools, find your duplicated
+
Once you've finished configuring your adtool, go to your Main Program Page. Navigate to the Affiliate Adtools page, find your duplicated [[Ct#Adtool|adtool]] type, and try getting the initial adtool you uploaded earlier. If this doesn't work, please [http://clients.toomuchmedia.com submit a ticket and we'll help you out].
adtool type, and try getting the initial adtool you uploaded earlier. If
 
it doesn't work, please  
 
[http://clients.toomuchmedia.com submit a ticket and we'll help you out].
 
  
 
----
 
----
Line 66: Line 55:
 
You can find specific instructions for duplicating a downloadable
 
You can find specific instructions for duplicating a downloadable
 
content adtool type in the [[New Downloadable Content Adtool Type]] article.
 
content adtool type in the [[New Downloadable Content Adtool Type]] article.
 +
 +
[[Category:NATS4 Adtools Admin]]

Latest revision as of 16:31, 20 July 2011

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
Adtools Admin
The Adtools Admin
Duplicating Adtool Types
Add New Adtools
Add New Adtool Type
Bulk Import Adtools
Downloadable Content Adtool Type
Get Hosted Galleries
Adtool Templates
Content of the Day
Linkcodes and Tools Admin
Setting Rules

NATS provides the ability to duplicate Adtool types, allowing you to build new adtools off of previously existing ones.

Note: Make sure you complete the following instructions before you begin customizing your duplicated adtool type in the Adtools Admin.

Duplicating An Adtool

To duplicate an already existing adtool type, go to the Adtools Admin, find the adtool type you wish to duplicate, and click the "Duplicate Adtool Type" icon.

After you enter a shortname for your duplicated adtool type, you will be taken to the Editing Adtool Type page. Change your adtool description to a unique description and click Save Changes -- you will be making other changes later on. Next, click the "View Adtools" tab and upload your duplicated adtool type's first adtool.

Editing Your Duplicated Adtool Type

To clarify, "original adtool type" refers to the adtool type that existed before duplicating, while "duplicated adtool type" refers to the new adtool type that NATS created after you clicked the icon.

Editing Adtool Templates

To further configure your duplicated adtool, go to the Skins and Templates Admin and edit your default skin. On the next page, find the templates related to your original adtool type. The template names you need contain three parts: "function_display_adtool", a shortname, and a view type.

Find the templates that begin with "function_display_adtool" and contain the original adtool type's shortname. For example, you need to find the following two templates to duplicate the Content adtool type.

  • function_display_adtools_content_min
  • function_display_adtools_content_max

Adtool Templates to Customize

Open each relevant template you find in a new web browser tab or window. You can usually do this by holding your keyboard's CTRL (Command key for Macs) key while clicking the edit icon, middle clicking the edit icon, or pressing CTRL+T (Command+T for Macs). Without closing your new tabs or windows, go back to the template list (in your original tab) and scroll to the top of the screen. In the "Create Template" box, enter a new name in the following form:

  • function_display_adtools_<shortname>_<view type>

Select "function_" from the first drop-down menu in the Name column, then replace <shortname> with your duplicated adtool type's shortname. Replace <view type> with the view type of the first template you found earlier. For example, the first Content adtool type template should be assigned the following name:

  • function_display_adtools_mytool_min

Creating a Duplicate Adtool Template

In the Header drop-down, choose No Header; in the Footer drop-down, choose No Footer. Enter a description and click Add. Go to the first (default) template you found earlier, copy the entire contents of the template's body, and paste it into the new template's body.

In your new template, you will need to update the variables that reference the original adtool type's fields so that they reference the duplicated adtool type's fields instead. When you are changing field names in the template, make sure to use the prefix "ign_" before each field name.

Configuring Your Duplicated Adtool

After duplicating each template you found earlier, return to the adtools admin to edit your duplicated adtool type. In the "Display Template" field, select your duplicate adtool's shortname from the drop-down menu and click Save Changes.

Once you've finished configuring your adtool, go to your Main Program Page. Navigate to the Affiliate Adtools page, find your duplicated adtool type, and try getting the initial adtool you uploaded earlier. If this doesn't work, please submit a ticket and we'll help you out.


You can find specific instructions for duplicating a downloadable content adtool type in the New Downloadable Content Adtool Type article.