Klasa
EDD_Payment_Stats została zaprojektowana, aby zapewnić prosty sposób pobierania statystyk zarobków i sprzedaży dla całego sklepu lub konkretnych produktów, dla wyznaczonych okresów czasu, takich jak ten tydzień, ostatni miesiąc, dzisiaj, zeszły rok itp.
Aby użyć
EDD_Payment_Stats, musisz utworzyć nową instancję klasy:
$stats = new EDD_Payment_Stats;
Po utworzeniu instancji klasy możesz użyć dowolnej z poniższych funkcji składowych:
// 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 );
Dla obu
get_sales() i get_earnings(), można przekazać następujące parametry:
$download_id – Numer identyfikacyjny produktu, dla którego mają być pobrane statystyki. Jeśli zostanie przekazana wartość 0 lub inna pusta wartość, statystyki zostaną pobrane dla całego sklepu.
$start_date – Data początkowa, dla której mają być pobrane statystyki. Jeśli chcesz pobrać statystyki dla jednego z predefiniowanych okresów, po prostu przekaż okres, taki jak „dzisiaj” lub „wczoraj”. Ten parametr może być ciągiem znaków daty, znacznikiem czasu lub datą sformatowaną w dowolnym standardowym formacie.
$end_date – Data końcowa, dla której mają być pobrane statystyki. Jeśli chcesz pobrać statystyki dla jednego z predefiniowanych okresów, pozostaw to pole puste. Ten parametr może być ciągiem znaków daty, znacznikiem czasu lub datą sformatowaną w dowolnym standardowym formacie.
Statystyki można pobierać dla dowolnego predefiniowanego okresu czasu. Te opcje obejmują:
- dzisiaj
- wczoraj
- ten_tydzień
- ostatni_tydzień
- ten_miesiąc
- ostatni_miesiąc
- ten_kwartał
- ostatni_kwartał
- ten_rok
- ostatni_rok
Przykłady
// 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
)
)
