Deze functie retourneert een geneste array met items die momenteel in de winkelwagen zitten. Elk item bevat standaard de volgende gegevens:
- id – De download-ID van het winkelwagenitem
- options – Een array met optionele gegevens, zoals price_id (wanneer variabele prijzen zijn ingeschakeld voor de download)
- quantity – De hoeveelheidswaarde. Wanneer hoeveelheden zijn uitgeschakeld, moet dit altijd 1 zijn
Veelvoorkomende toepassingen van de opties-array zijn zaken als variabele prijzen, upgrades & vernieuwingen van softwarelicenties en terugkerende betalingen.
Voorbeeldgebruik
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Opmerking: In ons voorbeeld hebben we de inhoud van edd_get_cart_contents() toegewezen aan een variabele voordat we deze controleerden met de `empty`-functie in onze voorwaardelijke verklaring. Dit is om compatibiliteit met PHP 5.2 te behouden.
Belangrijke informatie
Wanneer deze functie wordt aangeroepen, valideert deze dat elk item in de winkelwagen aan twee vereisten voldoet.
- Dat het van het posttype `download` is.
- Dat het item zich in een status bevindt die aankoop toestaat (niet-redacteuren kunnen geen berichten kopen die niet gepubliceerd zijn).
Als een item niet aan een van deze twee vereisten voldoet, wordt het uit de winkelwagen verwijderd voordat de resultaten worden geretourneerd.
Filters
Deze functie bevat één filter net voordat de resultaten worden geretourneerd. De filternaam is:
return apply_filters( 'edd_cart_contents', $cart );
Het geeft één argument door, namelijk de huidige inhoud van de winkelwagen, nadat alle validatie is voltooid.
