edd_get_cart_contents()

Diese Funktion gibt ein verschachteltes Array von Elementen zurück, die sich derzeit im Warenkorb befinden. Jedes Element enthält standardmäßig die folgenden Elemente:

• id – Die Download-ID des Warenkorbelements
• options – Ein Array mit optionalen Daten, wie z. B. price_id (wenn variable Preise für den Download aktiviert sind)
• quantity – Der Mengenwert. Wenn Mengen deaktiviert sind, sollte hier immer 1 stehen

Häufige Verwendungen des options-Arrays sind variable Preise, Upgrades & Verlängerungen von Softwarelizenzen und wiederkehrende Zahlungen.

Beispielverwendung

$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
	foreach ( $cart_contents as $item ) {
		// Execute your code
	}
}

Hinweis: In unserem Beispiel haben wir den Inhalt von edd_get_cart_contents() einer Variablen zugewiesen, bevor wir ihn in unserer bedingten Anweisung mit der Funktion `empty` überprüft haben. Dies dient der Kompatibilität mit PHP 5.2.

Wichtige Informationen

Wenn diese Funktion aufgerufen wird, prüft sie, ob jedes Element im Warenkorb zwei Anforderungen erfüllt.

1. Dass es vom Post-Typ `download` ist.
2. Dass sich das Element in einem Status befindet, der den Kauf zulässt (Nicht-Redakteure können keine Beiträge kaufen, die nicht veröffentlicht sind).

Wenn ein Element eine dieser beiden Anforderungen nicht erfüllt, wird es vor der Rückgabe der Ergebnisse aus dem Warenkorb entfernt.

Filter

Diese Funktion enthält einen Filter, kurz bevor ihre Ergebnisse zurückgegeben werden. Der Filtername lautet:

return apply_filters( 'edd_cart_contents', $cart );

Er übergibt ein Argument, nämlich den aktuellen Warenkorbinhalt, nachdem alle Validierungen durchgeführt wurden.

Diese Funktion auf GitHub finden