# EDD_Payment_Stats
A classe [EDD\_Payment\_Stats](https://github.com/easydigitaldownloads/Easy-Digital-Downloads/blob/master/includes/payments/class-payment-stats.php) 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:
```
// Recuperar ganhos
$stats->get_earnings( $download_id = 0, $start_date = false, $end_date = false );
// Recuperar vendas
$stats->get_sales( $download_id = 0, $start_date = false, $end_date = false );
// Recuperar uma lista dos produtos de Download mais vendidos
$stats->get_best_selling( $number = 10 );
```
Para *get\_sales()* e *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 pré-definidos, 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 pré-definidos, 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 pré-definido. 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
```
// Vendas de toda a loja para este mês:
echo $stats->get_sales( 0, 'this_month' );
Retorna um inteiro, a soma das vendas no período de tempo fornecido
```
```
// Ganhos de toda a loja para 2 de agosto de 2013
echo $stats->get_earnings( 0, 'August 2, 2013' );
Retorna um inteiro se os ganhos forem um número inteiro, um float arredondado para 2 se um número fracionário, como 42.73
```
```
// Vendas para o ID de download 44 de 2 de julho a 5 de agosto de 2013
echo $stats->get_sales( 44, 'July 2, 2013', 'August 5, 2013' );
```
```
// Ganhos para o ID de download 52 para 5 de dezembro de 2012
echo $stats->get_earnings( 52, '12-05-2012' )
```
```
$best_selling = $stats->get_best_selling( '10' );
Retorna um array dos 10 produtos mais vendidos, assim:
Array
(
[0] => stdClass Object
(
[download_id] => 68
[sales] => 3
)
[1] => stdClass Object
(
[download_id] => 120
[sales] => 2
)
)
```