De
EDD_Payment_Stats klasse is ontworpen om een eenvoudige manier te bieden om verdiensten en verkoopstatistieken op te halen voor de hele winkel, of specifieke producten, voor aangewezen tijdsperioden, zoals deze week, vorige maand, vandaag, vorig jaar, enz.
Om
EDD_Payment_Stats te gebruiken, moet u een nieuwe instantie van de klasse maken:
$stats = new EDD_Payment_Stats;
Zodra de klasse is geïnstantieerd, kunt u een van de volgende lidfuncties gebruiken:
// Retrieve earnings $stats->get_earnings( $download_id = 0, $start_date = false, $end_date = false ); // Retrieve sales $stats->get_sales( $download_id = 0, $start_date = false, $end_date = false ); // Retrieve a list of the best selling Download products $stats->get_best_selling( $number = 10 );
Voor zowel
get_sales() als get_earnings(), kunnen de volgende parameters worden doorgegeven:
$download_id – Het ID-nummer van het product waarvoor statistieken moeten worden opgehaald. Als 0 of een andere lege waarde wordt doorgegeven, worden statistieken voor de hele winkel opgehaald.
$start_date – De begindatum waarvoor statistieken moeten worden opgehaald. Als u statistieken wilt ophalen voor een van de vooraf gedefinieerde perioden, geeft u eenvoudig de periode door, zoals "vandaag" of "gisteren". Deze parameter kan een datumtekenreeks, een tijdstempel of een datum zijn die in een standaardformaat is opgemaakt.
$end_date – De einddatum waarvoor statistieken moeten worden opgehaald. Als u statistieken wilt ophalen voor een van de vooraf gedefinieerde perioden, laat u dit leeg. Deze parameter kan een datumtekenreeks, een tijdstempel of een datum zijn die in een standaardformaat is opgemaakt.
Statistieken kunnen worden opgehaald voor elke vooraf gedefinieerde tijdsperiode. Deze opties omvatten:
- vandaag
- gisteren
- deze_week
- vorige_week
- deze_maand
- vorige_maand
- dit_kwartaal
- vorig_kwartaal
- dit_jaar
- vorig_jaar
Voorbeelden
// Store-wide sales for this month: echo $stats->get_sales( 0, 'this_month' ); Returns an integer, the sum of sales in the given time span
// Store-wide earnings for August 2, 2013 echo $stats->get_earnings( 0, 'August 2, 2013' ); Returns an integer if earnings are a whole number, a float rounded to 2 if a fractional number, like 42.73
// Sales for download ID 44 from July 2 to August 5, 2013 echo $stats->get_sales( 44, 'July 2, 2013', 'August 5, 2013' );
// Earnings for download ID 52 for December 5, 2012 echo $stats->get_earnings( 52, '12-05-2012' )
$best_selling = $stats->get_best_selling( '10' );
Returns an array of the 10 best selling products, like this:
Array
(
[0] => stdClass Object
(
[download_id] => 68
[sales] => 3
)
[1] => stdClass Object
(
[download_id] => 120
[sales] => 2
)
)
