FernandoAcosta.Netdocs

Metadados utilizados

2 min de leituraAtualizado há 5 dias

Lista de todos os metadados e options usados pelo plugin. Útil para integrações, queries SQL diretas, exportações e implementações customizadas.

Metadados do produto

Chave Tipo Descrição
_wc_additional_days_per_product int Dias adicionais do produto ou variação
_wc_additional_days_per_product_<rule_id> int Dias adicionais para regras customizadas (ver Regras customizadas)

Acessar:

$days = get_post_meta( $product_id, '_wc_additional_days_per_product', true );

Para variações, use o ID da variação. Quando vazio, a string retornada é "".

Metadados de categoria (term meta)

Chave Tipo Descrição
additional_time int Dias adicionais da categoria

Acessar:

$days = get_term_meta( $category_id, 'additional_time', true );

Metadados do pedido

Chave Tipo Descrição
_wc_order_additional_days int Maior prazo adicional entre todos os itens do pedido

Acessar:

$days = $order->get_meta( '_wc_order_additional_days' );

Útil para automatizar processos no ERP/WMS — saber em quantos dias o pedido precisa estar pronto.

Metadados do item do pedido

Chave Tipo Visível ao cliente Descrição
_production_time array Não Estrutura interna com label e dias do item
Prazo de produção (rótulo configurado) string Sim (se opção ativa) Prazo individual exibido nos e-mails e detalhe do pedido
_Prazo de Produção string Não Prazo individual oculto, salvo para administração

A escolha entre exibir como Prazo de produção ou como _Prazo de Produção é determinada pela opção Carrinho, checkout e e-mails:

  • Ativa: o item exibe Prazo de produção: 5 dias úteis ao cliente.
  • Desativada: o prazo é salvo só administrativamente, oculto do cliente.

Acessar (em qualquer item de pedido):

$production_time = $item->get_meta( '_production_time' );

Options do WordPress

Configurações globais do plugin, todas em wp_options.

Opção Tipo Padrão Onde é configurada
wc_additional_days_label string Prazo de produção Texto sobre o prazo
wc_additional_days_sum string yes/no yes Somar prazo
wc_additional_days_show_in_cart string yes/no no Carrinho, checkout e e-mails
wc_additional_days_global int `` (vazio) Dias adicionais de entrega
wc_additional_days_cart_notice string `` (vazio) Mensagem geral no carrinho
wc_additional_days_debug string yes/no no Debug dos métodos
wc_additional_days_backorder_only string yes/no no Produtos sob encomenda

Acessar:

$label = get_option( 'wc_additional_days_label', 'Prazo de produção' );

Funções auxiliares

Quando você precisa do prazo calculado seguindo a hierarquia completa (variação > produto > global > categoria), use as funções nativas do plugin em vez de ler o metadado direto:

wc_adpp_get_product_additional_time( $product, $variation = null, $cart_item = null )

Retorna o número de dias adicionais aplicáveis ao produto, considerando hierarquia, regras customizadas e o filtro wc_adpp_additional_days.

$days = wc_adpp_get_product_additional_time( $product );

wc_adpp_get_product_message( $product = null )

Retorna o HTML da mensagem de prazo formatada. Quando o produto não é informado, usa o produto global.

echo wc_adpp_get_product_message( $product );

Hierarquia de leitura

Quando você precisa do prazo de um produto, prefira a função em vez do metadado direto. A função aplica:

  1. A hierarquia variação > produto > global > categoria.
  2. Os filtros wc_adpp_additional_days e wc_adpp_additional_days_custom_rules.
  3. A regra de modo sob encomenda quando ativa.
  4. A combinação de regras customizadas, se houver.

Ler _wc_additional_days_per_product direto pula tudo isso e pode resultar em prazo incorreto. Detalhes em Como o plugin escolhe o prazo.

Foi útil?