Esta função retorna um array aninhado de itens atualmente no carrinho. Cada item, por padrão, contém os seguintes itens:
- id – O ID do download do item do carrinho
- options – Um array contendo dados opcionais, como price_id (quando preços variáveis estão habilitados para o download)
- quantity – O valor da quantidade. Quando as quantidades estão desabilitadas, este valor deve ser sempre 1
Usos comuns do array options são coisas como preços variáveis, upgrades e renovações de licenças de software e pagamentos recorrentes.
Exemplo de Uso
$cart_contents = edd_get_cart_contents();
if ( ! empty( $cart_contents ) ) {
foreach ( $cart_contents as $item ) {
// Execute your code
}
}
Observação: Em nosso exemplo, atribuímos o conteúdo de edd_get_cart_contents() a uma variável antes de verificá-la com a função `empty` em nossa declaração condicional. Isso é para manter a compatibilidade com o PHP 5.2.
Informações Importantes
Quando chamada, esta função valida que cada item no carrinho atende a dois requisitos.
- Que seja do tipo de postagem `download`.
- Que o item esteja em um status que permita sua compra (editores não podem comprar posts que não estão publicados).
Se um item falhar em atender a qualquer um desses dois requisitos, ele será removido do carrinho antes de retornar os resultados.
Filtros
Esta função contém um filtro logo antes de retornar seus resultados. O nome do filtro é:
return apply_filters( 'edd_cart_contents', $cart );
Ele passa um argumento, que são os conteúdos atuais do carrinho, após toda a validação ter sido feita.
