get ptc ad v2

From CashCrusaderWiki

(Difference between revisions)
Jump to: navigation, search
m
(Contest PTC info)
Line 1: Line 1:
-
{{DISPLAYTITLE:get_ptc_ad_v2}}
+
{{DISPLAYTITLE:init_contestptc_stats}}
-
Action ''get_ptc_ad_v2'' is an improved version of ''[[get_ptc_ad]]'' with added functionality like defining amount of [[PTC_(Paid2Click,_Paid_To_Click)_Ads|PTC]] ads to show at once, showing click counters of ads and country targeting.
+
Action ''init_contestptc_stats'' fetches statistics of a [[Contest_Paid_To_Click_Advertising|contest PTC]] ad group.
-
'''Required CashCrusader version:''' 2.01<br>
+
'''Required CashCrusader version:''' 2.27
-
'''Required CashCrusader version:''' 2.11 (for country targeting)<br>
+
-
'''Required CashCrusader version:''' 2.20 (for translation/customization support)<br>
+
-
'''Required CashCrusader version:''' 2.22 (for account type targeting)<br>
+
-
'''Required CashCrusader version:''' 2.24 (for improved customization)
+
-
'''Example basic usage:'''
+
'''Example usage:'''
-
''<?php action("get_ptc_ad_v2","category,5,1,1,1"); ?>''
+
''<?php $contest = action('init_contestptc_stats', 'contest|1|1'); ?>''
-
'''Details, from left to right:'''
+
'''Argument details, from left to right:'''
-
category = this is the ad category for PTCs you want to display<br />
+
contest = this is the ad group for the contest PTCs<br />
-
5 = this is the amount of PTC ads you want to display<br />
+
1 = fetch last contest winner of this specific group, 1=true 0=false<br />
-
1 = show clicks left value, 1=true 0=false<br />
+
1 = calculate user's contest PTC win counter for this specific group, 1=true 0=false<br />
-
1 = show received clicks, 1=true 0=false<br />
+
-
1 = show how much the ad is worth, 1=true 0=false<br />
+
-
'''Example translation:'''
+
'''Return value:'''
-
$ptc_customization['translated'] = true;<br>
+
This action returns an array which has contest details. If all details are not needed, the call can be optimized by disabling some statistics as described above.
-
$ptc_customization['message'] = 'The ad above is worth';<br>
+
-
$ptc_customization['notfound'] = 'Sorry, no ads are available for you to click on this page at this time';<br>
+
-
$ptc_customization['points'] = 'point(s)';<br>
+
-
$ptc_customization['cash'] = 'cent(s)';<br>
+
-
$ptc_customization['factor'] = 1;<br>
+
-
$ptc_customization['forward'] = 'Next Page';<br>
+
-
$ptc_customization['back'] = 'Previous Page';<br>
+
-
$ptc_customization['clicks_left'] = ' Clicks left'; //(version 2.24)<br>
+
-
$ptc_customization['clicks_received'] = ' Clicks received'; //(version 2.24)<br>
+
-
'''Example customization:'''
+
'''Example return value:'''
-
$ptc_customization['link_class'] = 'ptc_link';<br>
+
Array
-
$ptc_customization['target'] = '_blank';<br>
+
(
-
$ptc_customization['hide_page_number'] = true; //(version 2.24)<br>
+
[prize] => $0.10
 +
[clicks_left] => 672
 +
[last_winner] => JohnDoe
 +
[wins] => 5
 +
)
-
''Link_class'' is the CSS class attached to each PTC link and ''target'' is HTML target for the links.
 
-
Add translation and customization PHP codes before calling the ''action()''.
 
-
'''Complete example with customization and translation codes:'''
+
[[Category:Actions|init_contestptc_stats]]
-
 
+
-
<?php
+
-
$ptc_customization['translated'] = true;
+
-
$ptc_customization['message'] = 'The ad above is worth';
+
-
$ptc_customization['notfound'] = 'Sorry, no ads are available for you to click on this page at this time';
+
-
$ptc_customization['points'] = 'point(s)';
+
-
$ptc_customization['cash'] = 'cent(s)';
+
-
$ptc_customization['factor'] = 1;
+
-
$ptc_customization['forward'] = 'Next Page';
+
-
$ptc_customization['back'] = 'Previous Page';
+
-
$ptc_customization['clicks_left'] = ' Clicks left';
+
-
$ptc_customization['clicks_received'] = ' Clicks received';
+
-
$ptc_customization['link_class'] = 'ptc_link';
+
-
$ptc_customization['target'] = '_blank';
+
-
$ptc_customization['hide_page_number'] = false;
+
-
action("get_ptc_ad_v2","category,5,1,1,1");
+
-
?>
+
-
 
+
-
 
+
-
 
+
-
 
+
-
[[Category:Actions|get_ptc_ad_v2]]
+
[[Category:Customize]]
[[Category:Customize]]

Revision as of 20:43, 26 January 2012

Action init_contestptc_stats fetches statistics of a contest PTC ad group.


Required CashCrusader version: 2.27


Example usage:

<?php $contest = action('init_contestptc_stats', 'contest|1|1'); ?>


Argument details, from left to right:

contest = this is the ad group for the contest PTCs
1 = fetch last contest winner of this specific group, 1=true 0=false
1 = calculate user's contest PTC win counter for this specific group, 1=true 0=false


Return value:

This action returns an array which has contest details. If all details are not needed, the call can be optimized by disabling some statistics as described above.


Example return value:

Array
(
   [prize] => $0.10
   [clicks_left] => 672
   [last_winner] => JohnDoe
   [wins] => 5
)
Personal tools
Administration manual