Difference between revisions of "Nats get payment breakdown"

From TMM Wiki
Jump to navigationJump to search
Line 49: Line 49:
  
  
== Example ==
+
== Examples ==
 
You can use this function to output the breakdown of affiliate payments by site in your payment dumps.
 
You can use this function to output the breakdown of affiliate payments by site in your payment dumps.
  

Revision as of 22:43, 26 June 2019

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_payment_breakdown
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

nats_get_payment_breakdown

Provides a breakdown for the given list of payments {$data} Smarty variable.

Alias: get_payment_breakdown


Parameters

(Required parameters in bold)

Parameter Description Possible Values Default Value Example
paymentids the list of payment ids to get a breakdown for any valid payment id values <blank> paymentids="1,2,3"
breakdown the breakdown you want siteid, programid, site_group_id siteid breakdown="programid"
no_details_group_name the name for the group of payments that are not associated with transactions any string *SPECIAL PAYMENTS* no_details_group_name="Other"
assign_prefix the string to prefix output Smarty variables with any string <blank> assign_prefix="output_"


Output

A breakdown of the provided payment ids in the {$data} Smarty variable given the requested breakdown.


Examples

You can use this function to output the breakdown of affiliate payments by site in your payment dumps.

To show the site breakdown of each individual payment, you can use code like this in the 'Entry' field.

{get_payment_breakdown paymentids=$entry.paymentid}
{foreach from=$data key=site item=amount}
{$site}: {$amount/100|currency_format:2}
{/foreach}

To show the program breakdown of all payments for each affiliate, you can use code like this in the 'Entry Header' or the 'Entry Footer' field.

{get_payment_breakdown paymentids=$total.payment_list breakdown="programid"}
{foreach from=$data key=program item=amount}
{$program}: {$amount/100|currency_format:2}
{/foreach}

To show the site group breakdown of all payments, you can use code like this in the 'Header' or the 'Footer' field.

{get_payment_breakdown paymentids=$totals.all.payment_list breakdown="site_group_id"}
{foreach from=$data key=site_group item=amount}
{$site_group}: {$amount/100|currency_format:2}
{/foreach}