Die
EDD_Payment_Stats Klasse ist so konzipiert, dass sie eine einfache Möglichkeit bietet, Einnahmen und Verkaufsstatistiken für den gesamten Shop oder bestimmte Produkte für bestimmte Zeiträume abzurufen, z. B. diese Woche, letzten Monat, heute, letztes Jahr usw.
Um
EDD_Payment_Stats zu verwenden, müssen Sie eine neue Instanz der Klasse erstellen:
$stats = new EDD_Payment_Stats;
Sobald die Klasse instanziiert ist, können Sie jede der folgenden Member-Funktionen verwenden:
// 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 );
Sowohl für get_sales() als auch für get_earnings() können die folgenden Parameter übergeben werden:
$download_id – Die ID-Nummer des Produkts, für das Statistiken abgerufen werden sollen. Wenn 0 oder ein anderer leerer Wert übergeben wird, werden Statistiken für den gesamten Shop abgerufen.
$start_date – Das Anfangsdatum, für das Statistiken abgerufen werden sollen. Wenn Sie Statistiken für einen der vordefinierten Zeiträume abrufen möchten, übergeben Sie einfach den Zeitraum, z. B. „heute“ oder „gestern“. Dieser Parameter kann ein Datumsstring, ein Zeitstempel oder ein Datum in einem Standardformat sein.
$end_date – Das Enddatum, für das Statistiken abgerufen werden sollen. Wenn Sie Statistiken für einen der vordefinierten Zeiträume abrufen möchten, lassen Sie dieses Feld leer. Dieser Parameter kann ein Datumsstring, ein Zeitstempel oder ein Datum in einem Standardformat sein.
Statistiken können für jeden vordefinierten Zeitraum abgerufen werden. Diese Optionen umfassen:
- heute
- gestern
- diese_woche
- letzte_woche
- dieser_monat
- letzter_monat
- dieses_quartal
- letztes_quartal
- dieses_jahr
- letztes_jahr
Beispiele
// 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
)
)
