Template Oficial: Como Criar Artigos no LinkTudo sem Erros

Guia técnico completo sobre como criar artigos no LinkTudo usando a estrutura de template segura, evitando erros de redeclaração, warnings e garantindo que os anúncios sejam exibidos corretamente. 📘🔧

📋 Capítulo 1 — Visão Geral da Estrutura

1.1 O que é este template?

Este template é uma estrutura padronizada para criação de artigos no site LinkTudo. Ele foi desenvolvido para resolver problemas comuns como:

• Erros de redeclaração de funções e constantes
• Warnings no PHP (ex: "Constant already defined")
• Conflitos entre o artigo e os anúncios
• Perda de buffer que fazia os anúncios sumirem

1.2 Filosofia do template

A filosofia deste template segue a mesma do LinkTudo: "Tudo gira em torno do assunto". Cada artigo deve ser independente, mas seguir uma estrutura que garanta compatibilidade com o sistema como um todo.

🏗️ Capítulo 2 — Estrutura do Template (Bloco a Bloco)

2.1 BLOCO 1: Includes Obrigatórios

require_once $_SERVER['DOCUMENT_ROOT'] . '/configuracoes_gerais/configuracoes_gerais.php';

Este é o arquivo mais importante. Ele carrega todas as configurações do site:

• Constantes gerais (URLs, caminhos)
• Funções do sistema (autenticação, buffer, etc.)
• Configurações de sessão e banco de dados
• Meta tags e estrutura base

2.2 BLOCO 2: Flags de Configuração

$REQUER_AUTENTICACAO = false;    // Altere para true se precisar de login
$REQUER_ADMIN = false;           // Altere para true se for admin
$E_REQUISICAO_AJAX = isset($_GET['ajax']);

• $REQUER_AUTENTICACAO: Define se o artigo requer login para ser acessado
• $REQUER_ADMIN: Define se apenas administradores podem ver
• $E_REQUISICAO_AJAX: Detecta se a URL tem ?ajax=1 para resposta JSON

2.3 BLOCO 3: Resposta AJAX

if ($E_REQUISICAO_AJAX) {
    while (ob_get_level() > 0) {
        ob_end_clean();
    }
    header('Content-Type: application/json');
    echo json_encode([...]);
    exit;
}

Este bloco limpa o buffer e retorna um JSON puro quando a URL tem ?ajax=1. Isso é útil para IAs e sistemas que consomem APIs.

2.4 BLOCO 4: Capturar Anúncios (O SEGREDO!)

$conteudo_anuncios = '';
ob_start();
$caminho_anuncios = $_SERVER['DOCUMENT_ROOT'] . '/projetos/links_de_afiliados___04082026_1815/frontend_publico/links_de_afiliados___04082026_1815___frontend_publico.php';
if (file_exists($caminho_anuncios)) {
    require_once $caminho_anuncios;
}
$conteudo_anuncios = ob_get_clean();

Este é o segredo do template! Ele captura os anúncios antes do artigo ser renderizado:

• Inicia um buffer separado
• Inclui o arquivo de anúncios
• Captura a saída em uma variável
• Limpa o buffer

2.5 BLOCO 5: Buffer do Artigo

ob_start();

Inicia um buffer limpo para o artigo, garantindo que nada interfera na saída.

2.6 BLOCO 6: HTML do Artigo

Todo o conteúdo do artigo (HTML, CSS, JavaScript) vai aqui. Inclui:

• Head com meta tags e CSS
• Body com o conteúdo do artigo
• Área de anúncios no final (onde os anúncios capturados são exibidos)

2.7 BLOCO 7: Exibir Anúncios

if (!empty($conteudo_anuncios)) {
    echo '
';
    echo '
— Anúncios —
';
    echo $conteudo_anuncios;
    echo '
';
}

Exibe os anúncios capturados no BLOCO 4, dentro de uma área estilizada.

2.8 BLOCO 8: Finalizar Buffer

while (ob_get_level() > 0) {
    ob_end_flush();
}

Finaliza todos os buffers e envia o conteúdo completo para o navegador.

📊 Capítulo 3 — Problemas Resolvidos e Boas Práticas

Problema	Causa	Solução no Template
Cannot redeclare function	Função declarada duas vezes	O template NÃO declara funções. Usa as do sistema.
Constant already defined	Constante redefinida	O template NÃO define constantes. Usa as do sistema.
Anúncios sumindo	Buffer sendo limpo pelo arquivo de anúncios	Anúncios são capturados em buffer separado.
Artigo não aparece	Arquivo de anúncios interrompe a execução	Buffer separado garante que o artigo seja renderizado.
Warnings no PHP	Redefinição de constantes/funções	Uso de require_once e verificação de existência.

3.1 Boas Práticas ao Criar Artigos

• Nunca declare funções no artigo. Use as do sistema.
• Nunca defina constantes como CAMINHO_RAIZ. Use as existentes.
• Sempre use require_once para includes, nunca require ou include.
• Capture saídas de terceiros em buffers separados.
• Sempre verifique se arquivos existem antes de incluí-los (file_exists()).
• Use ob_start() e ob_get_clean() para controlar a saída.

📝 Capítulo 4 — Como Usar Este Template

Passo 1 — Copie o template

Copie todo o código do template e salve em um arquivo .php.

Passo 2 — Personalize o conteúdo

• Altere a variável $assunto para o título do seu artigo
• Substitua o conteúdo HTML pelos capítulos do seu artigo
• Atualize a meta description e outras tags SEO
• Altere autor e data

Passo 3 — Salve no local correto

O arquivo deve ser salvo em:

/pasta_do_site/artigos/sobre/assuntos/[SEU-ASSUNTO]/[nome-do-artigo].php

Passo 4 — Teste

• Acesse a URL do seu artigo no navegador
• Verifique se o artigo aparece completo
• Verifique se os anúncios aparecem no final
• Teste ?ajax=1 para ver o JSON
• Verifique se não há erros ou warnings

🔧 Capítulo 5 — Personalização Avançada

5.1 Alterar a posição dos anúncios

Para colocar os anúncios em outra posição, mova o BLOCO 7 para onde desejar no HTML.

5.2 Adicionar estilos próprios

Você pode adicionar CSS personalizado dentro do <style> existente ou criar um arquivo separado.

5.3 Adicionar scripts JavaScript

Adicione scripts no final do <body>, antes do fechamento de </html>.

5.4 Requerer autenticação

Altere $REQUER_AUTENTICACAO = true; para exigir login.

5.5 Criar artigos para administradores

Altere $REQUER_ADMIN = true; para restringir a administradores.

✅ Capítulo 6 — Checklist de Publicação

📖 Capítulo 7 — Conclusão

Este template resolve de forma definitiva os principais problemas enfrentados ao criar artigos no LinkTudo:

• Erros de redeclaração → eliminados ao não declarar funções/constantes
• Anúncios sumindo → capturados em buffer separado
• Warnings → eliminados com uso correto de require_once
• AJAX → funcionando com ?ajax=1

Ao seguir esta estrutura, você garante que seus artigos sejam publicados sem erros, mantenham a consistência visual e tenham os anúncios sempre no final.