# EDD_Payment_Stats La classe [EDD\_Payment\_Stats](https://github.com/easydigitaldownloads/Easy-Digital-Downloads/blob/master/includes/payments/class-payment-stats.php) è progettata per fornire un modo semplice per recuperare statistiche di guadagni e vendite per l'intero negozio, o per prodotti specifici, per periodi di tempo designati, come questa settimana, il mese scorso, oggi, l'anno scorso, ecc. Per utilizzare *EDD\_Payment\_Stats*, devi creare una nuova istanza della classe: ``` $stats = new EDD_Payment_Stats; ``` Una volta che la classe è istanziata, puoi utilizzare una qualsiasi delle seguenti funzioni membro: ``` // Recupera guadagni $stats->get_earnings( $download_id = 0, $start_date = false, $end_date = false ); // Recupera vendite $stats->get_sales( $download_id = 0, $start_date = false, $end_date = false ); // Recupera un elenco dei prodotti Download più venduti $stats->get_best_selling( $number = 10 ); ``` Sia per *get\_sales()* che per *get\_earnings()*, è possibile passare i seguenti parametri: $download\_id – Il numero ID del prodotto per cui recuperare le statistiche. Se viene passato 0 o qualsiasi altro valore vuoto, le statistiche verranno recuperate per l'intero negozio. $start\_date – La data di inizio per recuperare le statistiche. Se si desidera recuperare le statistiche per uno dei periodi predefiniti, è sufficiente passare il periodo, come "oggi" o "ieri". Questo parametro può essere una stringa di data, un timestamp o una data formattata in qualsiasi formato standard. $end\_date – La data di fine per recuperare le statistiche. Se si desidera recuperare le statistiche per uno dei periodi predefiniti, lasciare vuoto. Questo parametro può essere una stringa di data, un timestamp o una data formattata in qualsiasi formato standard. Le statistiche possono essere recuperate per qualsiasi periodo di tempo predefinito. Queste opzioni includono: - oggi - ieri - questa\_settimana - settimana\_scorsa - questo\_mese - mese\_scorso - questo\_trimestre - trimestre\_scorso - quest'anno - anno\_scorso ### Esempi ``` // Vendite a livello di negozio per questo mese: echo $stats->get_sales( 0, 'this_month' ); Restituisce un intero, la somma delle vendite nel dato intervallo di tempo ``` ``` // Guadagni a livello di negozio per il 2 agosto 2013 echo $stats->get_earnings( 0, 'August 2, 2013' ); Restituisce un intero se i guadagni sono un numero intero, un float arrotondato a 2 se un numero frazionario, come 42.73 ``` ``` // Vendite per l'ID download 44 dal 2 luglio al 5 agosto 2013 echo $stats->get_sales( 44, 'July 2, 2013', 'August 5, 2013' ); ``` ``` // Guadagni per l'ID download 52 per il 5 dicembre 2012 echo $stats->get_earnings( 52, '12-05-2012' ) ``` ``` $best_selling = $stats->get_best_selling( '10' ); Restituisce un array dei 10 prodotti più venduti, come questo: Array ( [0] => stdClass Object ( [download_id] => 68 [sales] => 3 ) [1] => stdClass Object ( [download_id] => 120 [sales] => 2 ) ) ```