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:

Direto ao ponto

Sem enrolação

Comercializamos plugins na esperança de que seja útil, porém, é importante observar que ele é fornecido SEM NENHUMA GARANTIA inclusive sem a garantia implícita de ADEQUAÇÃO A UM DETERMINADO FIM.

Estamos sempre prontos para aprimorar nosso plugin e personalizá-lo de acordo com suas necessidades específicas. Não hesite em nos contatar a qualquer momento, estamos aqui para ajudá-lo.