この関数は、現在カート内にあるアイテムのネストされた配列を返します。各アイテムは、デフォルトで次のアイテムを含みます。
- id – カートアイテムのダウンロードID
- options – price_id（ダウンロードで可変価格設定が有効になっている場合）などのオプションデータを保持する配列
- quantity – 数量の値。数量が無効になっている場合、これは常に1である必要があります
options配列の一般的な用途としては、可変価格設定、ソフトウェアライセンスのアップグレードと更新、定期支払いなどがあります。
使用例
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
注意：この例では、条件ステートメントで `empty` 関数を使用してチェックする前に、edd_get_cart_contents() の内容を変数に割り当てました。これは PHP 5.2 との互換性を維持するためです。
重要情報
呼び出された場合、この関数はカート内の各アイテムが2つの要件を満たしていることを検証します。
- それが `download` の投稿タイプであること。
- アイテムが購入可能なステータスであること（エディター以外は公開されていない投稿を購入できません）。
アイテムがいずれかの要件を満たさない場合、結果を返す前にカートから削除されます。
フィルター
この関数には、結果を返す直前に1つのフィルターが含まれています。フィルター名は次のとおりです。
return apply_filters( 'edd_cart_contents', $cart );
すべての検証が完了した後、現在のカートの内容である1つの引数を渡します。
