Cette fonction renvoie un tableau imbriqué des articles actuellement dans le panier. Chaque article, par défaut, contient les éléments suivants :
- id – L'ID du téléchargement de l'article du panier
- options – Un tableau contenant des données facultatives, telles que price_id (lorsque la tarification variable est activée pour le téléchargement)
- quantity – La valeur de la quantité. Lorsque les quantités sont désactivées, celle-ci doit toujours être égale à 1
Les utilisations courantes du tableau d'options sont la tarification variable, les mises à niveau et renouvellements de licences logicielles, et les paiements récurrents.
Exemple d'utilisation
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Note : Dans notre exemple, nous avons attribué le contenu de edd_get_cart_contents() à une variable avant de la vérifier avec la fonction `empty` dans notre instruction conditionnelle. Ceci est fait pour maintenir la compatibilité avec PHP 5.2.
Informations importantes
Lorsqu'elle est appelée, cette fonction valide que chaque article du panier répond à deux exigences.
- Qu'il s'agisse du type de publication `download`.
- Que l'article soit dans un état qui permette son achat (les non-éditeurs ne peuvent pas acheter des publications qui ne sont pas publiées).
Si un article ne répond à l'une ou l'autre de ces deux exigences, il sera supprimé du panier avant le retour des résultats.
Filtres
Cette fonction contient un filtre juste avant de retourner ses résultats. Le nom du filtre est :
return apply_filters( 'edd_cart_contents', $cart );
Il passe un argument, qui est le contenu actuel du panier, après que toute validation a été effectuée.
