Esta función devuelve una matriz anidada de los artículos que se encuentran actualmente en el carrito. Cada artículo, por defecto, contiene los siguientes elementos:
- id – El ID de descarga del artículo del carrito
- options – Una matriz que contiene datos opcionales, como price_id (cuando los precios variables están habilitados para la descarga)
- quantity – El valor de la cantidad. Cuando las cantidades están deshabilitadas, esto siempre debería indicar 1
Los usos comunes de la matriz de opciones son cosas como precios variables, actualizaciones y renovaciones de licencias de software, y pagos recurrentes.
Ejemplo de uso
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Nota: En nuestro ejemplo, asignamos el contenido de edd_get_cart_contents() a una variable antes de comprobarla con la función `empty` en nuestra declaración condicional. Esto es para mantener la compatibilidad con PHP 5.2.
Información importante
Cuando se llama, esta función valida que cada artículo en el carrito cumpla dos requisitos.
- Que sea del tipo de publicación `download`.
- Que el artículo esté en un estado que permita su compra (los no editores no pueden comprar publicaciones que no estén publicadas).
Si un artículo no cumple con alguno de esos dos requisitos, se eliminará del carrito antes de devolver los resultados.
Filtros
Esta función contiene un filtro justo antes de devolver sus resultados. El nombre del filtro es:
return apply_filters( 'edd_cart_contents', $cart );
Pasa un argumento, que son los contenidos actuales del carrito, después de que se haya realizado toda la validación.
