Clasa
EDD_Payment_Stats este concepută pentru a oferi o modalitate simplă de a prelua statistici de câștiguri și vânzări pentru întregul magazin sau pentru produse specifice, pentru perioade de timp desemnate, cum ar fi săptămâna aceasta, luna trecută, astăzi, anul trecut etc.
Pentru a utiliza
EDD_Payment_Stats, trebuie să instanțiați o nouă instanță a clasei:
$stats = new EDD_Payment_Stats;
Odată ce clasa este instanțiată, puteți utiliza oricare dintre următoarele funcții membru:
// 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 );
Atât pentru
get_sales() cât și pentru get_earnings(), pot fi transmisi următorii parametri:
$download_id – Numărul ID al produsului pentru care se preiau statisticile. Dacă se transmite 0 sau orice altă valoare goală, statisticile vor fi preluate pentru întregul magazin.
$start_date – Data de început pentru care se preiau statisticile. Dacă doriți să preluați statistici pentru una dintre perioadele predefinite, pur și simplu transmiteți perioada, cum ar fi „astăzi” sau „ieri”. Acest parametru poate fi un șir de caractere cu dată, un timestamp sau o dată formatată în orice format standard.
$end_date – Data de sfârșit pentru care se preiau statisticile. Dacă doriți să preluați statistici pentru una dintre perioadele predefinite, lăsați acest câmp gol. Acest parametru poate fi un șir de caractere cu dată, un timestamp sau o dată formatată în orice format standard.
Statisticile pot fi preluate pentru orice perioadă de timp predefinită. Aceste opțiuni includ:
- astăzi
- ieri
- săptămâna_curentă
- săptămâna_trecută
- luna_curentă
- luna_trecută
- trimestrul_curent
- trimestrul_trecut
- anul_curent
- anul_trecut
Exemple
// 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
)
)
