Biblioteca sitemap.php

Caminho no Gestor bibliotecas/sitemap.php

Mantém o sitemap.xml e o robots.txt do site. Os dois ficam em gestor/assets/ e são servidos pelo controlador arquivo-estatico em https://<dominio>/sitemap.xml e /robots.txt, sem depender de regra de reescrita do servidor. Um sitemap.xml antigo na raiz do Gestor, se foi gerado pelo core, é apagado na próxima gravação; um feito à mão é preservado.

Que páginas entram

sitemap_pagina_elegivel($pagina) exige:

• status='A' e sem_permissao (página pública; o painel inteiro fica de fora);

• caminho que não seja rota de sistema do Gestor nem rota de fluxo (sitemap_caminho_nao_indexavel()): callbacks de OAuth, signin-2fa, validate-user, processadores de formulário, pagina-de-impressao, qualquer caminho começando por admin-, e páginas de desfecho cujo último segmento é ou termina em confirmation, success, error, failure, cancel, cancelled ou canceled (contato-success, checkout/error), além de …/payment, …/checkout, …/processing e …/download em caminhos compostos, e do fluxo de compra: último segmento cart ou checkout, ou terminado em -cart/-checkout (cart/, en/checkout/, subscription-checkout/, req-191);

• estar dentro da janela data_publicacao_inicio/fim.

/signin/, /signup/ e /forgot-password/ entram. A URL leva o prefixo do idioma quando ele não é o padrão (/en/docs/), e lastmod é a data_modificacao da página.

Quando é atualizado

• Incremental, a cada salvar, clonar, excluir ou trocar status no admin-paginas, no publisher-pages e na edição pelo Live Editor (sitemap_sincronizar_por_id(), que chama sitemap_sincronizar_pagina()): só a URL daquela página entra, muda ou sai. Se o caminho mudou, a URL antiga sai antes de a nova entrar.

• Completo (sitemap_gerar_completo()), só quando o arquivo não existe, está corrompido ou a página editada sumiu do banco. A geração completa também regrava o robots.txt.

robots.txt

sitemap_robots_montar() barra as rotas utilitárias (/_gestor-cookie-verify, /oauth-callback, /signin-2fa, /forms-submissions-process…) e declara Sitemap: <url>/sitemap.xml. Aceita disallow extras.

Funções do XML

sitemap_xml_montar($urls), sitemap_xml_upsert($xml, $loc, $lastmod) e sitemap_xml_remover($xml, $loc) são puras (texto → texto); sitemap_data_w3c() formata o lastmod. sitemap_url_da_pagina(), sitemap_caminho_arquivo(), sitemap_robots_caminho_arquivo(), sitemap_gravar(), sitemap_robots_gravar(), sitemap_conteudo_proprio() e sitemap_legado_remover() cuidam da URL e do disco.

Funções

sitemap_pagina_elegivel(array $pagina, int|null $agora = null): bool

sitemap_caminho_nao_indexavel(string $caminho): bool

sitemap_robots_montar(array $params = Array()): string

sitemap_robots_caminho_arquivo(): string

sitemap_robots_gravar(): bool

sitemap_xml_montar(array $urls = Array()): string

sitemap_data_w3c(string|null $data = null): string|null

sitemap_xml_upsert(string $xml, string $loc, string|null $lastmod = null): string

sitemap_xml_remover(string $xml, string $loc): string

sitemap_caminho_arquivo(): string

sitemap_url_da_pagina(array $pagina): string

sitemap_gravar(string $xml): bool

sitemap_conteudo_proprio(string $conteudo): bool

sitemap_legado_remover(): bool

sitemap_gerar_completo(): bool

sitemap_sincronizar_pagina(array $pagina, bool $remover = false, $caminhoAntigo = null): bool

sitemap_sincronizar_por_id(string $id, bool $remover = false, string|null $caminhoAntigo = null): bool