AI Adendo para Indexação SEO com LLMO 2.1.4

O que mudou desde 3.1.0

Sem hashes.json → mais “N arquivos faltando” durante o instalador.
Melhorias no controller e serviço PHP (concatenação correta de ., array appends, .=, ternários corretos).
Espaço único na namespace Sylvain\LlmoproV311 para evitar colisões com versões anteriores.
Menor e válido routes.xml (evita “Por favor, insira um valor válido”).
Limpeza da Setup (tabelas xf_llmopro_document & xf_llmopro_log).

Estrutura

upload/src/addons/Sylvain/LlmoproV311/

addon.json (v3.1.1, requer XF ≥ 2.3.0 +)
Setup.php
_data/
options.xml
phrases.xml
template_modifications.xml
routes.xml → prefix llmopro
Entity/Document.php, Entity/Log.php
Service/Generator.php
Util/RateLimiter.php
Pub/Controller/Index.php, Pub/View/Json.php
Cron/Regenerate.php, Job/WebhookPing.php
README.txt, LISEZMOI.txt (no topo do zip)

Instalação (limpa)

Copie o conteúdo de upload/ para a raiz do XenForo (mesma camada que src/ e admin.php).
ACP → Adicionais → Instale LLMO Pro (Sylvain) — V3.
ACP → Ferramentas → Rebuild caches (comece de um estado limpo).

Endpoints

/llmopro — manifest/info
/llmopro/threads
/llmopro/thread?thread_id=123
/llmopro/search?q=...
/llmopro/sitemap
/llmopro/well-known

Se ainda falhar para o outro usuário

Verifique a exata caminho: src/addons/Sylvain/LlmoproV311/ (case-sensitive).
Garanta que não há subpasta upload no servidor.
Diretórios 755, arquivos 644.
Remova qualquer Llmopro / LlmoproV3 antigo para evitar fusão de arquivo acidental.

Se ainda quiser verificações de integridade mais tarde, posso fornecer um script do servidor para gerar hashes.json a partir dos arquivos presentes após a instalação.

Plano zero-sorriso de instalação limpa (XenForo 2.3.x) + nosso add-on

1) Requisitos do servidor

PHP ≥ 8.1 (OK 8.2/8.3), MySQL ≥ 5.7/MariaDB 10.3+
Extensões: mbstring, json, gd, curl, xml
Permissões: 755 diretórios / 644 arquivos

2) Instale o XenForo (limpo)

Descompacte XF → copie para a raiz do site.
Execute /install/ → crie DB → usuário admin.
No src/config.php, certifique-se de:

$config['enableAddOns'] = true;
$config['upgradePending'] = false;
$config['enableMaintenance'] = false;

ACP → Ferramentas → Rebuild caches (comece de um estado limpo).

3) Instale o add-on LLMO Pro (build corrigido)

Use a versão corrigida do pacote (sem hashes.json).
Copie o conteúdo de upload/ para a raiz XF (mesma camada que src/ e admin.php).
ACP → Adicionais → Instale LLMO Pro (Sylvain) — V3.
ACP → Ferramentas → Rebuild caches (Templates, Phrases, Routes).

Se quiser verificar integridade de ficheiros mais tarde, geraremos hashes.json após a instalação no servidor (não mais falsos “faltando arquivos”).

4) Testes de fumaça

Abra uma página de thread → você deve ver <script id="llmopro-seo" type="application/ld+json"> no HTML.
Endpoints públicos:
/llmopro
/llmopro/threads
/llmopro/thread?thread_id=1 (use um ID real)
/llmopro/search?q=test
/llmopro/sitemap

5) Opções úteis (ACP → Opções → LLMO Pro)

Habilitar/desabilitar injecção de JSON-LD
Tamanho da resumo
ETag / If-Modified-Since
Limite de acesso
Cobertura básica de anonimato pessoal
Webhook (opcional)

6) Práticas de teste melhores

Teste com o estilo padrão XF (sem sobrescritas de template) para isolar problemas.
Se a reconstrução mostrar “Por favor, insira um valor válido” para Routes:
Renomeie temporariamente _data/routes.xml como routes.off.xml, reconfigure.
Eu lhe darei um script pequeno para criar diretamente no DB (mais robusto), então reconfigure caches.