# nats\_list\_tours *Article Topics:* [*Smarty*](https://docs.toomuchmedia.com/getting-started/common-topics/smarty)*,* [*Customization*](https://docs.toomuchmedia.com/getting-started/common-topics/customization) ## 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 ](https://docs.toomuchmedia.com/additional-resources/common-terms#shortname)to its name in the output | 0 or 1 (exclusive). | Off; does not print shortname | shortname="1" | | [assign\_prefix](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-function-parameters/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 * [nats\_list\_campaigns](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-functions/nats_list_campaigns) * [nats\_list\_sites](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-functions/nats_list_sites)