Această funcție returnează un array imbricat de articole aflate în prezent în coș. Fiecare articol, în mod implicit, conține următoarele elemente:
- id – ID-ul de descărcare al articolului din coș
- options – Un array care conține date opționale, cum ar fi price_id (când prețurile variabile sunt activate pentru descărcare)
- quantity – Valoarea cantității. Când cantitățile sunt dezactivate, aceasta ar trebui să fie întotdeauna 1
Utilizările comune ale array-ului options sunt prețuri variabile, upgrade-uri și reînnoiri de licențe software și plăți recurente.
Exemplu de utilizare
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Notă: În exemplul nostru, am atribuit conținutul edd_get_cart_contents() unei variabile înainte de a o verifica cu funcția `empty` în instrucțiunea noastră condițională. Acest lucru este pentru a menține compatibilitatea cu PHP 5.2.
Informații importante
Când este apelată, această funcție validează că fiecare articol din coș îndeplinește două cerințe.
- Că este de tipul post `download`.
- Că articolul se află într-un statut care îi permite să fie achiziționat (editorii nu pot achiziționa postări care nu sunt publicate).
Dacă un articol nu îndeplinește oricare dintre aceste două cerințe, acesta va fi eliminat din coș înainte de returnarea rezultatelor.
Filtre
Această funcție conține un filtru chiar înainte de a returna rezultatele sale. Numele filtrului este:
return apply_filters( 'edd_cart_contents', $cart );
Acesta transmite un singur argument, care sunt conținuturile curente ale coșului, după ce toată validarea a fost efectuată.
