Âncora Link PRO

=== Âncora Link PRO === Contributors: seuusername Tags: tiktok, ads, pixel, integration, marketing, hotmart Requires at least: 5.8 Tested up to: 6.4 Stable tag: 1.0.0 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Plugin para integração com TikTok Ads via bloco Gutenberg no frontend - permite configurar pixels e eventos sem acessar o painel administrativo.

== Description ==

O Âncora Link PRO oferece uma solução completa para integração com TikTok for Business, permitindo que usuários não técnicos configurem pixels e eventos diretamente no frontend através de um bloco Gutenberg intuitivo.

✨ Principais Recursos

• Formulário Guiado em 4 Etapas: Interface visual intuitiva para configuração completa
• Autenticação OAuth2: Conexão segura com TikTok for Business API
• Gerenciamento de Pixels: Criação e configuração de pixels diretamente no frontend
• Eventos de Teste: Envio automático de eventos de teste para validação
• Integração Hotmart: Instruções específicas para implementação na plataforma
• Segurança Avançada: Tokens únicos por usuário e validação de nonce
• Conformidade LGPD/GDPR: Remoção completa de dados na desinstalação

🎯 Etapas do Processo

1. Autenticação TikTok for Business

   • Login OAuth2 seguro
   • Autorização com escopos específicos
   • Armazenamento seguro de tokens

2. Gerenciamento de Pixel e Evento de Teste

   • Listagem de contas de anunciante
   • Criação ou seleção de pixels existentes
   • Envio automático de evento de teste (Purchase R$ 0,01)

3. Instruções para Hotmart

   • Exibição do código do pixel
   • Instruções passo a passo
   • Botão de cópia para facilitar implementação

4. Conclusão

   • Confirmação da integração
   • Link direto para painel TikTok Ads
   • Informações sobre tempo de processamento

🔧 Configuração

1. Instale e ative o plugin
2. Vá em Configurações > Âncora Link PRO
3. Configure as credenciais do TikTok for Business:
   • App ID
   • App Secret
   • Redirect URI
4. Adicione o bloco "TikTok Ads Integration" em qualquer página/post

🛡️ Segurança

• Validação e sanitização de todos os dados de entrada
• Tokens únicos por usuário para autenticação da API
• Verificação de nonce em todas as requisições
• Bloqueio de acesso direto aos arquivos PHP
• Hash SHA-256 dos dados do usuário

🌐 Conformidade

• LGPD/GDPR: Remoção completa de dados pessoais na desinstalação
• Privacidade: Dados sensíveis nunca expostos no frontend
• Transparência: Log opcional das operações para auditoria

== Installation ==

Instalação Automática

1. No painel do WordPress, vá em Plugins > Adicionar Novo
2. Pesquise por "Âncora Link PRO"
3. Clique em Instalar Agora e depois Ativar

Instalação Manual

1. Faça download do arquivo ZIP do plugin
2. No painel do WordPress, vá em Plugins > Adicionar Novo > Enviar Plugin
3. Selecione o arquivo ZIP e clique em Instalar Agora
4. Ative o plugin após a instalação

Configuração Inicial

1. Acesse Configurações > Âncora Link PRO
2. Configure as credenciais do TikTok for Business
3. O Redirect URI deve ser: https://seusite.com/alink-pro-callback

== Frequently Asked Questions ==

= É necessário ter conhecimento técnico para usar o plugin? =

Não! O plugin foi desenvolvido especificamente para usuários não técnicos, com interface visual intuitiva e instruções passo a passo.

= Onde obtenho as credenciais do TikTok for Business? =

1. Acesse https://ads.tiktok.com/
2. Vá em "Tools" > "TikTok for Business" > "Developer Tools"
3. Crie uma aplicação ou use uma existente
4. Configure o Redirect URI conforme instruções do plugin

= O plugin funciona com outros além da Hotmart? =

Sim! O código do pixel pode ser usado em qualquer plataforma que aceite códigos de rastreamento personalizados.

= Os dados dos usuários ficam seguros? =

Sim! O plugin segue as melhores práticas de segurança, usando tokens únicos, hashing SHA-256 e conformidade total com LGPD/GDPR.

= Posso usar em sites multisite? =

Sim, o plugin é compatível com WordPress multisite.

= Quanto tempo leva para os eventos aparecerem no TikTok? =

Os eventos podem levar até 24 horas para aparecer no painel do TikTok Ads, conforme documentação oficial da plataforma.

== Screenshots ==

1. Bloco Gutenberg no editor com preview das 4 etapas
2. Etapa 1: Tela de autenticação com TikTok for Business
3. Etapa 2: Seleção de conta e gerenciamento de pixels
4. Etapa 3: Código do pixel e instruções para Hotmart
5. Etapa 4: Conclusão com link para painel TikTok
6. Página de configurações no painel administrativo

== Changelog ==

= 1.0.0 =

• Lançamento inicial
• Implementação completa das 4 etapas de integração
• Autenticação OAuth2 com TikTok for Business API
• Gerenciamento de pixels e eventos de teste
• Interface responsiva e intuitiva
• Conformidade LGPD/GDPR
• Documentação completa

== Upgrade Notice ==

= 1.0.0 = Primeira versão do plugin. Instale para começar a usar a integração com TikTok Ads.

== Technical Details ==

Requisitos do Sistema

• WordPress 5.8+
• PHP 7.4+
• cURL extension
• JSON extension

APIs Utilizadas

• TikTok for Business API v1.3
• WordPress REST API
• Gutenberg Block API

Estrutura de Arquivos

ancora-link-pro/
├── ancora-link-pro.php (arquivo principal)
├── admin/
│   └── admin-page.php
├── assets/
│   ├── css/
│   │   ├── style.css
│   │   └── editor.css
│   └── js/
│       ├── frontend.js
│       └── editor.js
├── includes/
│   ├── api-routes.php
│   └── tiktok-callback.php
├── languages/
├── uninstall.php
└── readme.txt

Hooks e Filtros Disponíveis

• ancora_link_pro_before_auth - Executado antes da autenticação
• ancora_link_pro_after_auth - Executado após autenticação bem-sucedida
• ancora_link_pro_pixel_created - Executado quando pixel é criado
• ancora_link_pro_test_event_sent - Executado após envio de evento teste

Para mais informações técnicas, consulte a documentação completa no GitHub.