EDD_Payment_Stats

A classe 
EDD_Payment_Stats foi projetada para fornecer uma maneira simples de recuperar estatísticas de ganhos e vendas para toda a loja, ou produtos específicos, para períodos de tempo designados, como esta semana, mês passado, hoje, ano passado, etc.

Para usar 
EDD_Payment_Stats, você deve instanciar uma nova instância da classe:

$stats = new EDD_Payment_Stats;

Uma vez que a classe é instanciada, você pode usar qualquer uma das seguintes funções membro:

// 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() quanto para get_earnings(), os seguintes parâmetros podem ser passados:

$download_id – O número de ID do produto para o qual recuperar estatísticas. Se 0 ou qualquer outro valor vazio for passado, as estatísticas serão recuperadas para toda a loja.

$start_date – A data de início para recuperar estatísticas. Se você quiser recuperar estatísticas para um dos períodos predefinidos, simplesmente passe o período, como “hoje” ou “ontem”. Este parâmetro pode ser uma string de data, um timestamp ou uma data formatada em qualquer formato padrão.

$end_date – A data de término para recuperar estatísticas. Se você quiser recuperar estatísticas para um dos períodos predefinidos, deixe em branco. Este parâmetro pode ser uma string de data, um timestamp ou uma data formatada em qualquer formato padrão.

As estatísticas podem ser recuperadas para qualquer período de tempo predefinido. Essas opções incluem:

• hoje
• ontem
• esta_semana
• semana_passada
• este_mês
• mês_passado
• este_trimestre
• trimestre_passado
• este_ano
• ano_passado

Exemplos

// 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
        )
)