Difference between revisions of "Nats list campaigns"
From TMM Wiki
Jump to navigationJump to searchTMMStephenY (talk | contribs) m |
|||
| Line 46: | Line 46: | ||
== Output == | == Output == | ||
| − | Outputs an array called ''$ | + | Outputs an array called ''$campaigns''. The arguments above determine |
the array's structure. | the array's structure. | ||
| − | If ''details'' is not set or are set to "0", ''$ | + | If ''details'' is not set or are set to "0", ''$campaigns'' will have |
one-dimension with the numeric [[campaignid]] as the key and the | one-dimension with the numeric [[campaignid]] as the key and the | ||
campaign's text description as the value: | campaign's text description as the value: | ||
| Line 64: | Line 64: | ||
<pre> | <pre> | ||
| − | Array | + | Array campaigns( |
[59] => Array( | [59] => Array( | ||
[campaignid] => 59, | [campaignid] => 59, | ||
Revision as of 18:32, 9 November 2011
Applies to NATS 4.0.25 and greater.
nats_list_campaigns
Obtains a list of available campaigns for an affiliate.
Alias: list_campaigns
Parameters
(Required parameters in bold)
| Parameter | Description | Possible Values | Default Value | Example |
|---|---|---|---|---|
| userid | the loginid of the affiliate whose campaigns should be listed. | The I.D. user viewing the page. | Any integer greater than zero | userid=123 |
| details | Set to 1 to provide more details about the campaigns in the output. See note below. | 0 or 1 (exclusive) | 0 | details=1 |
| show_hidden | Set to 1 to include details about hidden campaigns in the output. | 0 or 1 (exclusive) | 0 | show_hidden=1 |
| assign_prefix | Prefix output variables with this word. (Click link for details) | Any valid Smarty variable name | None. (No prefix is used) | assign_prefix="myvar" |
Output
Outputs an array called $campaigns. The arguments above determine the array's structure.
If details is not set or are set to "0", $campaigns will have one-dimension with the numeric campaignid as the key and the campaign's text description as the value:
Array campaign (
[59] => "Main campaign used by default.",
[276] => "My second campaign."
)
If details is set to "1", all information about each campaign will be listed in a multi-dimensional array. For example:
Array campaigns(
[59] => Array(
[campaignid] => 59,
[loginid] => 45,
[name] => "Default",
[description] => "Main campaign used by default.",
[created_date] => 1209634033,
[hide] => 0,
[old_campaignid] => 0 ),
[276] => Array(
[campaignid] => 276,
[loginid] => 45,
[name] => "Second Campaign",
[description] => "John Smith Special Campaign",
[created_date] => 1209664102,
[hide] => 0,
[old_campaignid] => 0 ),
)
Notes
None.
See Also
- nats_list_sites -- lists all sites in a particular program.
- nats_list_tours -- lists all sites in a particular program and site.
