Ta funkcja zwraca zagnieżdżoną tablicę elementów aktualnie znajdujących się w koszyku. Każdy element domyślnie zawiera następujące pozycje:
- id – Identyfikator pobierania elementu koszyka
- options – Tablica przechowująca opcjonalne dane, takie jak price_id (gdy dla pobierania włączono zmienne ceny)
- quantity – Wartość ilości. Gdy ilości są wyłączone, powinna ona zawsze wynosić 1
Częste zastosowania tablicy opcji to zmienne ceny, ulepszenia i odnowienia licencji oprogramowania oraz płatności cykliczne.
Przykład użycia
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Uwaga: W naszym przykładzie przypisaliśmy zawartość edd_get_cart_contents() do zmiennej przed sprawdzeniem jej za pomocą funkcji `empty` w naszym instrukcji warunkowej. Ma to na celu zachowanie zgodności z PHP 5.2.
Ważne informacje
Po wywołaniu ta funkcja sprawdza, czy każdy element w koszyku spełnia dwa wymagania.
- Że jest typu post `download`.
- Że element znajduje się w stanie, który pozwala na jego zakup (redaktorzy nie mogą kupować postów, które nie są opublikowane).
Jeśli element nie spełnia któregokolwiek z tych dwóch wymagań, zostanie usunięty z koszyka przed zwróceniem wyników.
Filtry
Ta funkcja zawiera jeden filtr tuż przed zwróceniem wyników. Nazwa filtra to:
return apply_filters( 'edd_cart_contents', $cart );
Przekazuje jeden argument, którym jest bieżąca zawartość koszyka, po wykonaniu wszystkich walidacji.
