Nats list tours

From TMMwiki
Jump to: navigation, 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
    Template Functions
nats_add_to_array
nats_adtool_replace_linkcode
nats_array_flip
nats_array_to_xml
nats_build_array_by_reference
nats_convert_bytes
nats_decode
nats_display_account_campaigns
nats_display_account_change_history
nats_display_account_notifications
nats_display_account_preview
nats_display_admin_links
nats_display_admin_message
nats_display_adtool_form
nats_display_adtool_types
nats_display_adtools
nats_display_adtools_type_limit
nats_display_choose_adtools_group
nats_display_code_info
nats_display_create_campaign
nats_display_edit_account_details
nats_display_edit_account_settings
nats_display_edit_defaults
nats_display_edit_password
nats_display_edit_payvia
nats_display_edit_payvia_info
nats_display_edit_skin
nats_display_gallery_builder
nats_display_graph
nats_display_hourly_sales
nats_display_latest_adtools
nats_display_map
nats_display_news
nats_display_page_peel
nats_display_payment_history
nats_display_payment_summary
nats_display_ratio
nats_display_reward_category
nats_display_reward_order
nats_display_reward_purchases
nats_display_signup_advanced
nats_display_signup_basic
nats_display_signup_payvia
nats_display_stats
nats_display_stats_calendar
nats_display_stats_form
nats_display_stats_referrals
nats_display_stats_retention
nats_display_stats_subscription_details
nats_display_stats_table
nats_display_timezones
nats_display_top_stats
nats_dump_data
nats_encode
nats_get_first_in_array
nats_get_period_end
nats_get_reward_categories
nats_get_member
nats_list_adtool_groups
nats_list_affiliates
nats_list_billers
nats_list_campaigns
nats_list_linkcodes
nats_list_options
nats_get_option_details
nats_list_programs
nats_list_sites
nats_list_tool_categories
nats_list_tours
nats_list_xsells
nats_smarty_function_amount_owed
nats_smarty_function_getbonus
nats_smarty_rebuild_form
nats_smarty_rebuild_link
nats_smarty_rebuild_query
nats_tooltip
nats_track_link
nats_strack_link
tmm_admin_pagination
Template Shortcuts
add_to_array
adtool_replace_linkcode
affiliate_select_form
array_flip
array_to_xml
amount_owed
build_array_by_reference
convert_bytes
display_account_campaigns
display_account_change_history
display_account_notifications
display_account_preview
display_admin_links
display_adtool_form
display_adtool_types
display_adtools
display_adtools_type_limit
display_choose_adtools_group
display_code_info
display_create_campaign
display_gallery_builder
display_stats_referrals
display_edit_account_details
display_edit_account_settings
display_edit_defaults
display_edit_password
display_edit_payvia
display_edit_payvia_info
display_edit_skin
display_graph
display_hourly_sales
display_latest_adtools
display_map
display_news
display_page_peel
display_payment_history
display_payment_summary
display_ratio
display_reward_category
display_reward_order
display_reward_purchases
display_signup_advanced
display_signup_basic
display_signup_payvia
display_stats
display_stats_calendar
display_stats_table
display_stats_form
display_stats_retention
display_stats_subscription_details
display_top_stats
display_timezones
dump_data
get_first
get_period_end
get_reward_categories
list_billers
list_campaigns
list_linkcodes
list_options
list_programs
list_sites
list_tool_categories
list_tours
list_xsells
rebuild_form
rebuild_link
rebuild_query
reward_points
tooltip
Common Parameters
assign
assign_prefix
count
data_only
display_on_assign
start
tpl



Applies to NATS 4.0.25 and greater.

nats_list_tours

Creates the list of all tours offered by a particular program.

Alias: list_tours

Parameters

(Required parameters in bold)

Parameter Description Possible Values Default Value Example
program The program's ID number Any valid program ID number The default program ID number program="123"
site The site's ID number Any valid site ID number The default site ID number site="123"
full
version 4.0.71.1+
Do you want full details for the tour, instead of just the name 1 or 0. You MUST also specify a site if you specify full 0 full="1"
shortname If set to "1", adds the tour's shortname to its name in the output 0 or 1 (exclusive). Off; does not print shortname shortname="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

Output placed in Smarty array $tours. Each element in the array is a tour. For example:

Array (2)
1 => Array (1)
  1 => "Default Tour"
2 => Array (1)
  2 => "Default Tour"

If the shortname parameter is set, then each tour name starts with its shortname. For example:

1 => Array (1)
  1 => "(MAIN) Default Tour"
2 => Array (1)
  2 => "(MAIN) Default Tour"

If full is set, you will get a lot more data:

1 => Array (76)
  tourid => "1"
  tour => "MAIN"
  siteid => "1"
  networkid => "0"
  name => "Default Tour"
  url => "http://www.sitea.com"
  linkdomain => "join.instsitea.com"
  description => "This is the default tour for the Site A"
  thumb => ""
  thumb_ext => ""
  third_party_partner_id => "0"
  spartaurl => ""
  denyurl => ""
  denypost => ""
  approvalurl => ""
  approvalpost => "http://nats_install.testbed.toomuchme..."
  rebillpost => ""
  creditpost => ""
  chargebackpost => ""
  insufficient_fundpost => ""
  voidpost => ""
  userpost => ""
  userman => ""
  expirepost => ""
  custom => ""
  admin_signup_email => ""
  upgradeurl => ""
  upgradepost => ""
  allowed_lang => ""
  alternativeurl => ""
  allowed_lang_track_raw => "0"
  allowed_lang_track_unq => "0"
  hidden => "0"
  mail_member_joined => ""
  mail_member_cancelled => ""
  mail_member_rebilled => ""
  mail_member_credited => ""
  mail_member_chargedback => ""
  mail_member_insufficient => ""
  mail_member_voided => ""
  upgradedenyurl => ""
  upgradedenypost => ""
  prejoinpost => ""
  byo_owner => "0"
  byo_program => "0"
  byo_owner_only => "0"
  deleted => "0"
  niche => ""
  strack_programid => "0"
  mail_member_change => ""
  change_detailspost => ""
  created_date => "1259581534"
  mail_member_password => "Password Retrieval"
  credit_reversal_post => ""
  chargeback_reversal_post => ""
  void_reversal_post => ""
  insufficient_funds_reversal_post => ""
  mail_member_insufficient_reversal => ""
  mail_member_void_reversal => ""
  mail_member_credit_reversal => ""
  mail_member_chargeback_reversal => ""
  admin_threshold_email => ""
  mail_threshold => ""
  join_hit_threshold_hour_to_6 => ""
  join_hit_threshold_hour_to_12 => ""
  join_hit_threshold_hour_to_18 => ""
  join_hit_threshold_hour_to_24 => ""
  mail_member_pending_joined => ""
  mail_member_pre_joined => ""
  mail_member_pending_rebilled => ""
  mail_member_pre_rebilled => ""
  pre_approvalpost => ""
  pending_approvalpost => ""
  pre_rebillpost => ""
  pending_rebillpost => ""
  https_use => "1"
2 => Array (76)
  tourid => "2"
  tour => "byot"
  siteid => "1"
  networkid => "0"
  name => "BYO Tour"
  url => "http://www.sitea.com/byo"
  linkdomain => ""
  description => ""
  thumb => ""
  thumb_ext => ""
  third_party_partner_id => "0"
  spartaurl => ""
  denyurl => ""
  denypost => ""
  approvalurl => ""
  approvalpost => ""
  rebillpost => ""
  creditpost => ""
  chargebackpost => ""
  insufficient_fundpost => ""
  voidpost => ""
  userpost => ""
  userman => ""
  expirepost => ""
  custom => ""
  admin_signup_email => ""
  upgradeurl => ""
  upgradepost => ""
  allowed_lang => ""
  alternativeurl => ""
  allowed_lang_track_raw => "0"
  allowed_lang_track_unq => "0"
  hidden => "0"
  mail_member_joined => ""
  mail_member_cancelled => ""
  mail_member_rebilled => ""
  mail_member_credited => ""
  mail_member_chargedback => ""
  mail_member_insufficient => ""
  mail_member_voided => ""
  upgradedenyurl => ""
  upgradedenypost => ""
  prejoinpost => ""
  byo_owner => "0"
  byo_program => "0"
  byo_owner_only => "0"
  deleted => "0"
  niche => ""
  strack_programid => "0"
  mail_member_change => ""
  change_detailspost => ""
  created_date => "1259581537"
  mail_member_password => "Password Retrieval"
  credit_reversal_post => ""
  chargeback_reversal_post => ""
  void_reversal_post => ""
  insufficient_funds_reversal_post => ""
  mail_member_insufficient_reversal => ""
  mail_member_void_reversal => ""
  mail_member_credit_reversal => ""
  mail_member_chargeback_reversal => ""
  admin_threshold_email => null
  mail_threshold => ""
  join_hit_threshold_hour_to_6 => null
  join_hit_threshold_hour_to_12 => null
  join_hit_threshold_hour_to_18 => null
  join_hit_threshold_hour_to_24 => null
  mail_member_pending_joined => ""
  mail_member_pre_joined => ""
  mail_member_pending_rebilled => ""
  mail_member_pre_rebilled => ""
  pre_approvalpost => ""
  pending_approvalpost => ""
  pre_rebillpost => ""
  pending_rebillpost => ""
  https_use => "0"

Site Groups

There are three(3) arrays contained in the output that return site group information:

  • {$site_groups} - Contains an array for each site group. Each group-specific array then contains:
    • site_group_id - The ID# of the group.
    • name - The full name of the group.
    • deleted - If the group is marked as deleted. If "0", the group is not marked as deleted.
    • description - The description given for this group.
    • short_name - The shortname for this group.
  • {$site_groups_names} - An array that displays the names of your groups, in order of acending site ID.
  • {$ site_groups_short} - An array that displays the shortnames of your groups, in order of acending site ID.

Notes

To use full, you must also specify the site.


See Also