La
clase EDD_Payment_Stats está diseñada para proporcionar una forma sencilla de recuperar estadísticas de ganancias y ventas para toda la tienda, o productos específicos, para períodos de tiempo designados, como esta semana, el mes pasado, hoy, el año pasado, etc.
Para usar
EDD_Payment_Stats, debes instanciar una nueva instancia de la clase:
$stats = new EDD_Payment_Stats;
Una vez que la clase está instanciada, puedes usar cualquiera de las siguientes funciones miembro:
// 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 );
Tanto para
get_sales() como para get_earnings(), se pueden pasar los siguientes parámetros:
$download_id – El número ID del producto para el que se recuperarán las estadísticas. Si se pasa 0 o cualquier otro valor vacío, se recuperarán las estadísticas para toda la tienda.
$start_date – La fecha de inicio para la que se recuperarán las estadísticas. Si deseas recuperar estadísticas para uno de los períodos predefinidos, simplemente pasa el período, como "hoy" o "ayer". Este parámetro puede ser una cadena de fecha, una marca de tiempo o una fecha formateada en cualquier formato estándar.
$end_date – La fecha de finalización para la que se recuperarán las estadísticas. Si deseas recuperar estadísticas para uno de los períodos predefinidos, deja este campo en blanco. Este parámetro puede ser una cadena de fecha, una marca de tiempo o una fecha formateada en cualquier formato estándar.
Las estadísticas se pueden recuperar para cualquier período de tiempo predefinido. Estas opciones incluyen:
- hoy
- ayer
- esta_semana
- semana_pasada
- este_mes
- mes_pasado
- este_trimestre
- trimestre_pasado
- este_año
- año_pasado
Ejemplos
// 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
)
)
