Questa funzione restituisce un array nidificato di articoli attualmente nel carrello. Ogni articolo, per impostazione predefinita, contiene i seguenti elementi:
- id – L'ID del download dell'articolo del carrello
- options – Un array che contiene dati opzionali, come price_id (quando i prezzi variabili sono abilitati per il download)
- quantity – Il valore della quantità. Quando le quantità sono disabilitate, questo dovrebbe sempre essere 1
Gli usi comuni dell'array options sono cose come prezzi variabili, aggiornamenti e rinnovi delle licenze software e pagamenti ricorrenti.
Esempio di utilizzo
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Nota: Nel nostro esempio abbiamo assegnato il contenuto di edd_get_cart_contents() a una variabile prima di controllarla con la funzione `empty` nella nostra istruzione condizionale. Questo serve a mantenere la compatibilità con PHP 5.2.
Informazioni importanti
Quando viene chiamata, questa funzione convalida che ogni articolo nel carrello soddisfi due requisiti.
- Che sia del tipo di post `download`.
- Che l'articolo sia in uno stato che ne consenta l'acquisto (i non editor non possono acquistare post non pubblicati).
Se un articolo non soddisfa uno di questi due requisiti, verrà rimosso dal carrello prima di restituire i risultati.
Filtri
Questa funzione contiene un filtro appena prima di restituire i suoi risultati. Il nome del filtro è:
return apply_filters( 'edd_cart_contents', $cart );
Passa un argomento, che sono i contenuti attuali del carrello, dopo che tutta la validazione è stata eseguita.
