EDD_Payment_Stats

EDD_Payment_Stats クラスは、ストア全体または特定の商品の収益と売上の統計情報を、今週、先月、今日、昨年などの指定された期間で取得するための簡単な方法を提供するように設計されています。

EDD_Payment_Stats を使用するには、クラスの新しいインスタンスを作成する必要があります。

$stats = new EDD_Payment_Stats;

クラスがインスタンス化されたら、次のいずれかのメンバー関数を使用できます。

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

get_sales() と get_earnings() の両方で、次のパラメーターを渡すことができます。

$download_id – 統計情報を取得する商品の ID 番号。0 またはその他の空の値が渡された場合、ストア全体の統計情報が取得されます。

$start_date – 統計情報を取得する開始日。「今日」や「昨日」などの期間を指定する場合は、期間をそのまま渡します。このパラメーターは、日付文字列、タイムスタンプ、または標準形式の日付にすることができます。

$end_date – 統計情報を取得する終了日。定義済みの期間のいずれかの統計情報を取得したい場合は、これを空白のままにします。このパラメーターは、日付文字列、タイムスタンプ、または標準形式の日付にすることができます。

定義済みの任意の期間の統計情報を取得できます。これらのオプションには以下が含まれます。

• 今日
• 昨日
• 今週
• 先週
• 今月
• 先月
• 今四半期
• 前四半期
• 今年
• 昨年

例

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