Atualizado em: 19 de setembro de 2025

Documentação: CCW

Contrato em PDF para WooCommerce (WooTatitas) — Guia de Integração para Desenvolvedores

Guia rápido para programadores que desejam usar este plugin como base em seus projetos.

Aviso importante

Este plugin pode mudar funcionalidades sem aviso prévio para acompanhar atualizações do WooCommerce.

Toda customização é de responsabilidade do desenvolvedor. Não edite os arquivos originais do plugin. Faça suas alterações em código externo:

  • um plugin próprio (preferencialmente must‑use),
  • um plugin adicional do seu projeto, ou
  • o functions.php de um tema filho.
  • Utilize hooks (actions/filters) documentados. Alterações diretas no plugin serão sobrescritas em atualizações.

1) Visão geral

O WooTatitas CCW provê uma camada de orquestração para contratos no ecossistema WooCommerce: geração de PDF, gestão de histórico, anexos em e-mail de pedido, disponibilidade de downloads e parâmetros de “contratado”. A proposta é plug-and-play: você consome funções utilitárias, acopla em actions/filters nativos e deixa o CCW operar o core da jornada.

2) Pontos de extensão (hooks)

O CCW conversa nativamente com WooCommerce e expõe filtros/alavancas para customização.

  • woocommerce_checkout_process
  • woocommerce_checkout_order_processed
  • woocommerce_order_status_changed
  • woocommerce_review_order_before_submit
  • woocommerce_review_order_after_submit
  • Ciclo WP/Admin: plugins_loaded, init, admin_init, admin_enqueue_scripts, admin_menu, etc.

3) Filters para customização

  • wootatitas_ccw_parametros_disponiveis — registre parâmetros extras para “contratado”.
  • wootatitas_ccw_storage_base — ajuste base de storage se seu plugin gerencia diretórios.
  • wootatitas_ccw_update_url, wootatitas_ccw_website_url — meta-infos de origem.
  • Integrações Woo: woocommerce_email_attachments, woocommerce_customer_get_downloadable_products.

4) Comportamento no checkout

No funil de conversão, o CCW opera de forma “smart, segura e silenciosa” para não friccionar a UX de pagamento, mas garantindo os insumos necessários para o contrato.

  • Validações leves (pré-envio): woocommerce_checkout_process
    Espaço para checar pré-requisitos de geração (ex.: presença de dados do “contratado”, produtos contratuais no carrinho). Não gere PDF aqui; mantenha o checkout performático.
  • Pós-criação do pedido: woocommerce_checkout_order_processed
    Dispara a lógica de geração/registro do contrato quando o pedido existe (ID disponível). Aqui é o momento certo para preparar PDF, histórico e disponibilização.
  • UI no botão/área de submissão:
    woocommerce_review_order_before_submit e woocommerce_review_order_after_submit
    Janela para avisos não-bloqueantes (termos, resumo do contrato, status de disponibilidade).

5) Logs & Debug

  • Pasta dedicada e blindada no plugin, com bloqueio webserver e permissões endurecidas.
  • Trate como dado sensível operacional: registre somente IDs (pedido, usuário, download), timestamps e flags de decisão. Evite PII.
  • Evento + nível (SUCCESS/ERROR) + timestamp.
  • Contexto JSON minimalista: order_id, user_id, download_id, modo, erro (quando houver) e métricas objetivas (ex.: tamanho_arquivo, data_geracao).
  • Mensagens recorrentes: checkout.preview.sucesso|falha, download.liberado.sucesso, pdf.gerado.falha.

6) Boas práticas de extensão

  • Encapsule toda a lógica de negócio em um plugin MU e evite OOP a menos que haja necessidade extrema (diretriz de engenharia da casa).
  • Não substitua classes/templates: prefira hooks.

7) Segurança & compliance

  • HTTPS no checkout sempre.
  • Logs fora do alcance público.
  • Atualizações: mantenha o plugin atualizado para garantir aderência a mudanças do WooCommerce.

Como instalar

Veja nosso guia de como instalar nosso plugin:

Compre nosso plugin

Gostou do que viu? Compre o nosso plugin:

0
    0
    Comprando...
    Nenhum plugin sendo comprado no momento.