=== CTT Correio Registado ===
Contributors: pedromigmartins
Tags: ctt, woocommerce, tracking, shipping, printing
Requires at least: 5.6
Tested up to: 7.1
Stable tag: 1.0.15
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
WC requires at least: 3.0
WC tested up to: 7.1

Imprima Talões de Aceitação CTT com dados do WooCommerce, sem preenchimento manual. Inclui rastreio de encomendas.

== Description ==

Imprima os dados dos destinatários nos Talões de Aceitação dos CTT a partir das encomendas WooCommerce, sem preenchimento manual. O CTT Correio Registado aproveita os dados já introduzidos na encomenda para evitar a cópia de nomes e moradas, poupar tempo e reduzir erros na preparação dos envios.

A versão gratuita permite imprimir o Talão de Aceitação de uma encomenda de cada vez. Inclui também a associação do número de rastreamento à encomenda e o envio desse número, com uma ligação para o acompanhamento no site dos CTT, no email de conclusão enviado ao cliente.

Para preparar várias encomendas num único local, a versão PRO, por 9,90 €, acrescenta um painel de expedição e a impressão em série dos Talões de Aceitação, evitando abrir encomenda a encomenda.

O plugin disponibiliza uma ligação para a página oficial de rastreamento dos CTT, com o número de rastreamento já preenchido sempre que suportado pela página dos CTT. Por motivos de segurança definidos pelos CTT, poderá ser necessário confirmar o reCAPTCHA antes de consultar o estado da encomenda.

= O que pode fazer com a versão gratuita =

* Imprimir os dados do destinatário no Talão de Aceitação em papel dos CTT, diretamente a partir de uma encomenda WooCommerce, sem os preencher manualmente. Basta colocar o talão na impressora e configurar o tamanho do papel para A5.
* Inserir o número de rastreamento diretamente na página de detalhe de cada encomenda, na administração do WooCommerce.
* Evitar espaços e quebras de linha acidentais no número de rastreamento, através da normalização automática.
* Aceder à ligação automática para rastreamento na página de detalhe da encomenda, na administração do WooCommerce.
* Enviar automaticamente ao cliente o número de rastreamento e a ligação para os CTT no email de conclusão da encomenda.
* Utilizar o plugin com HPOS (High-Performance Order Storage) do WooCommerce.

== Versão PRO ==

O CTT Correio Registado PRO, por 9,90 €, permite preparar vários envios num painel de expedição:

* Filtrar as encomendas por método de envio para facilitar a gestão.
* Preencher e gerir os números de rastreamento de várias encomendas num único local.
* Inserir o número de rastreamento diretamente na administração do WooCommerce.
* Imprimir em série os Talões de Aceitação, sem abrir encomenda a encomenda.
* Disponibilizar uma ligação automática para rastreamento na página de detalhe da encomenda do cliente.

A impressão individual dos talões e o envio do rastreamento no email de conclusão estão incluídos na versão gratuita. A PRO acrescenta a gestão de várias encomendas no painel, a impressão em série, a filtragem por método de envio e a ligação de rastreamento na página de detalhe da encomenda do cliente.

<a href="https://pedromartins.com/produto/ctt-correio-registado-pro/" target="_blank">Descarregar</a>.

== Instalação ==

1. Faça o upload dos ficheiros do plugin para o diretório /wp-content/plugins/ctt-correio-registado, ou instale o plugin diretamente através do painel do WordPress.
2. Ative o plugin através do menu “Plugins” no WordPress.
3. Certifique-se de que o WooCommerce está instalado e ativo.
4. O plugin está pronto para uso. Encontrará o campo para inserir o número de rastreamento na página de edição das encomendas.

== Instale também ==

* Imprimir Etiquetas para Envio de Encomendas: Imprima etiquetas de envio de encomendas diretamente do WooCommerce, com layout otimizado para folhas A4, cada uma com 12 etiquetas de 105 x 48 mm. <a href="https://wordpress.org/plugins/imprimir-etiquetas-para-envio-de-encomendas/" target="_blank">Descarregar</a>.
* Imprimir Etiquetas para Envio de Encomendas PRO: Inclui um painel próprio para impressão de múltiplas etiquetas de encomendas de uma só vez e a escolha de vários formatos de etiquetas. <a href="https://pedromartins.com/produto/imprimir-etiquetas-para-envio-de-encomendas-pro/" target="_blank">Descarregar</a>.
* Initial Stock for WooCommerce: Adiciona ao WooCommerce a capacidade de registar e guardar a quantidade inicial de stock e a data de stock inicial de cada produto e variação. <a href="https://wordpress.org/plugins/initial-stock-for-woocommerce" target="_blank">Descarregar</a>.
* Initial Stock for WooCommerce PRO: Expande o conceito base de simples registo de stock inicial para uma solução profissional de gestão, histórico e interoperabilidade de stock, pensada para lojas com necessidades reais de controlo e auditoria. <a href="https://pedromartins.com/produto/initial-stock-for-woocommerce-pro/" target="_blank">Descarregar</a>.
* Product Completion Emails for WooCommerce: Permite-lhe melhorar a experiência dos seus clientes através do envio de um email de conclusão personalizado para cada produto de uma encomenda. Assim que a encomenda atinge o estado “Completed”, este plugin envia ao cliente emails separados e personalizados para cada produto adquirido. <a href="https://wordpress.org/plugins/product-completion-emails-for-woocommerce/" target="_blank">Descarregar</a>.

== Frequently Asked Questions ==

= Onde encontro o número de rastreamento? =

O número de rastreamento encontra-se no respetivo Talão de Aceitação em papel dos CTT, no canto superior direito, junto ao código de barras. Copie sem os espaços entre os números, como neste exemplo: “RL193378648PT”.

= O link de rastreamento abre diretamente o estado da encomenda? =

O plugin abre a página oficial de rastreamento dos CTT com o número de rastreamento já preenchido sempre que suportado pela página dos CTT.

No entanto, por motivos de segurança definidos pelos CTT, poderá ser necessário confirmar o reCAPTCHA antes de consultar o estado da encomenda. Este comportamento é controlado pelos CTT e não pelo plugin.

= Porque aparece um reCAPTCHA ao seguir a encomenda? =

O reCAPTCHA é um mecanismo de segurança dos CTT para proteger a consulta pública de objetos. O plugin não controla nem contorna essa validação. O cliente poderá ter de confirmar o reCAPTCHA para aceder ao estado da encomenda no site dos CTT.

= O cliente vê o número de rastreamento na página da encomenda? =

Na versão gratuita, o número de rastreamento é enviado ao cliente no email de conclusão da encomenda.

A apresentação do bloco de expedição com o número de rastreamento na página da encomenda do cliente é uma funcionalidade da versão PRO.

= Como configurar a impressão? =

No Windows:

No painel de impressão, configure o “Tamanho do papel” para A5 e desmarque a opção “Cabeçalhos e rodapés”. Em “Margens”, defina “Nenhum”. Verifique a orientação da folha na impressora, pois varia conforme a marca e o modelo.

No macOS:

No diálogo de impressão, selecione “A5” como tamanho do papel, desative cabeçalhos e rodapés e confirme que a escala está a 100%. Algumas impressoras ou drivers podem impor margens mínimas, mesmo quando o plugin define a margem da página como zero.

= A versão PRO usa o mesmo layout de impressão? =

Sim. A partir da versão 1.0.12, o layout de impressão do Talão de Aceitação foi preparado para ser reutilizado pela versão PRO, permitindo que a impressão individual e a impressão em série usem a mesma estrutura e o mesmo CSS.

= A versão PRO usa as mesmas funções de rastreamento da versão gratuita? =

Sim. A versão gratuita centraliza a normalização, validação e geração do URL de rastreamento. A versão PRO pode reutilizar essas funções para manter consistência entre os dois plugins e evitar duplicação de regras.

== Screenshots ==

1. Campo de inserção do número de rastreamento na página de administração da encomenda.
2. Exemplo de formulário preenchido automaticamente com os dados do cliente.
3. Talão de Aceitação de Correio Registado emitido pelos CTT.

== Changelog ==

= 1.0.15 =
* Alteração das informações do ficheiro readme.txt

= 1.0.14 =
* Correção de Tested up to para 7.1

= 1.0.13 =

* Centralização da geração do URL de rastreamento dos CTT numa única função interna.
* Atualização da ligação de rastreamento para abrir a página oficial de pesquisa de objetos dos CTT com o número de rastreamento preenchido.
* Normalização automática do número de rastreamento antes de guardar, validar e apresentar, removendo espaços e quebras de linha acidentais.
* Adição de função global de validação do número de rastreamento, permitindo reutilização pela versão PRO.
* Preparação da versão gratuita para servir como base funcional da versão PRO, evitando duplicação de regras de normalização, validação, URL de rastreamento e layout de impressão.
* Melhoria do texto do email de conclusão da encomenda para indicar que poderá ser necessário confirmar o reCAPTCHA no site dos CTT.
* Adição de informação nas FAQ sobre o comportamento do reCAPTCHA dos CTT.
* Clarificação da separação entre funcionalidades da versão gratuita e funcionalidades da versão PRO.
* Melhoria da manutenção futura da ligação aos CTT, evitando URLs repetidos no código.

= 1.0.12 =

* Reorganização interna do layout de impressão do Talão de Aceitação.
* Separação do CSS e da estrutura de impressão em funções reutilizáveis.
* Preparação da impressão individual para partilhar o mesmo layout com a impressão em série da versão PRO.
* Melhoria da manutenção entre a versão gratuita e a versão PRO, evitando duplicação de layout e CSS.
* Mantida a compatibilidade com HPOS (High-Performance Order Storage) do WooCommerce.
* Pequenas melhorias de consistência e organização do código.

= 1.0.11 =

* Verificação de compatibilidade com a versão 7 do WordPress e WooCommerce 10.
* Declaração formal de compatibilidade com HPOS (High-Performance Order Storage) do WooCommerce.
* Melhoria das verificações de segurança nas ações AJAX, com validação de nonce e permissões por encomenda.
* Remoção do acesso público ao endpoint de impressão do Talão de Aceitação, restringindo-o a utilizadores autorizados.
* Melhoria da validação e sanitização do número de rastreamento.
* Carregamento dos ficheiros JavaScript e CSS apenas nos ecrãs de encomendas do WooCommerce.
* Melhoria da compatibilidade da impressão com a configuração de país da loja e da morada de envio.
* Adição de instrução CSS @page para definir impressão em A5 sem margem do documento, mantendo a margem de alinhamento controlada pelo plugin.
* Revisão de textos e mensagens administrativas.

= 1.0.10 =

* Link com possibilidade de atualizar para a versão PRO.
* Exemplo de Talão de Aceitação de Correio Registado emitido pelos CTT.

= 1.0.9 =

* Verificação de compatibilidade com a versão 6.8 do WordPress e WooCommerce 10.

= 1.0.8 =

* Correção do Contributors.

= 1.0.7 =

* Verificação de compatibilidade com a versão 6.7.1 do WordPress.
* Melhoria na impressão dos campos do formulário, com ajustes de margens.
* Agora assinala na impressão os campos “Nacional” ou “Internacional” conforme o país definido na morada de entrega. Assinala, por defeito, a opção “Correio Registado”.

= 1.0.6 =

* Atualização do ficheiro readme.txt.

= 1.0.5 =

* Atualização do ficheiro readme.txt.

= 1.0.4 =

* Reposicionar o botão “Imprimir registo” para ficar dentro da div class=“cttcr”.

= 1.0.3 =

* Adição de botão “Guardar” junto ao campo do Número de Rastreamento. Permite guardar o número sem atualizar estado da encomenda.
* Melhoria à consistência do código.
* Correção do ficheiro JS da requisição AJAX para salvar o número de rastreamento.

= 1.0.2 =

* Correção da informação mostrada no email de Conclusão da encomenda.

= 1.0.1 =

* Correção da descrição.
* Correção na impressão do Código Postal.

= 1.0 =

* Lançamento inicial do plugin com funcionalidades de rastreamento e impressão de dados.

== Upgrade Notice ==

= 1.0.14 =
Correção de Tested up to para 7.1

= 1.0.13 =
Atualização recomendada. Esta versão melhora a ligação à página oficial de rastreamento dos CTT, centraliza a geração do URL de rastreamento, adiciona validação reutilizável para a versão PRO e clarifica que os CTT podem exigir confirmação por reCAPTCHA antes da consulta do estado da encomenda.

= 1.0.12 =
Atualização recomendada para quem utiliza ou pretende utilizar a versão PRO. Esta versão prepara o layout de impressão para ser reutilizado pela impressão em série, garantindo consistência com a impressão individual.

= 1.0 =
Primeira versão estável. Atualize para obter as funcionalidades de rastreamento de encomendas e impressão automática dos formulários dos CTT.

== Aviso Legal ==

Este plugin não é afiliado, patrocinado, aprovado ou de qualquer forma associado aos CTT – Correios de Portugal, S.A. “CTT”, “Correios de Portugal”, “Correio Registado” e outras marcas, nomes ou termos relacionados são propriedade dos CTT – Correios de Portugal, S.A. O uso desses termos no contexto deste plugin é meramente descritivo, com o propósito de identificar um serviço e funcionalidade relacionada ao rastreamento de encomendas, sem qualquer vínculo ou aprovação por parte da entidade titular das marcas.

== Notas ==

Este plugin foi testado com as versões mais recentes do WordPress e do WooCommerce para garantir compatibilidade.