sitemap.php library

Path in the Gestor bibliotecas/sitemap.php

Maintains the site's sitemap.xml and robots.txt. Both live in gestor/assets/ and are served by the arquivo-estatico controller at https://<domain>/sitemap.xml and /robots.txt, with no dependency on server rewrite rules. An old sitemap.xml at the Gestor root, if the core generated it, is deleted on the next write; a hand-made one is preserved.

Which pages go in

sitemap_pagina_elegivel($page) requires:

• status='A' and sem_permissao (public page; the whole admin panel stays out);

• a path that is not a Gestor system route nor a flow route (sitemap_caminho_nao_indexavel()): OAuth callbacks, signin-2fa, validate-user, form processors, pagina-de-impressao, any path starting with admin-, and outcome pages whose last segment is or ends in confirmation, success, error, failure, cancel, cancelled or canceled (contact-success, checkout/error), plus …/payment, …/checkout, …/processing and …/download in compound paths, and the purchase flow: last segment cart or checkout, or ending in -cart/-checkout (cart/, en/checkout/, subscription-checkout/, req-191);

• being inside the data_publicacao_inicio/fim window.

/signin/, /signup/ and /forgot-password/ are included. The URL carries the language prefix when it is not the default (/en/docs/), and lastmod is the page's data_modificacao.

When it is updated

• Incrementally, on every save, clone, delete or status change in admin-paginas, publisher-pages and Live Editor edits (sitemap_sincronizar_por_id(), which calls sitemap_sincronizar_pagina()): only that page's URL is added, changed or removed. If the path changed, the old URL goes out before the new one comes in.

• Fully (sitemap_gerar_completo()), only when the file does not exist, is corrupted or the edited page vanished from the database. A full generation also rewrites robots.txt.

robots.txt

sitemap_robots_montar() blocks the utility routes (/_gestor-cookie-verify, /oauth-callback, /signin-2fa, /forms-submissions-process…) and declares Sitemap: <url>/sitemap.xml. It accepts extra disallow entries.

XML functions

sitemap_xml_montar($urls), sitemap_xml_upsert($xml, $loc, $lastmod) and sitemap_xml_remover($xml, $loc) are pure (text → text); sitemap_data_w3c() formats lastmod. sitemap_url_da_pagina(), sitemap_caminho_arquivo(), sitemap_robots_caminho_arquivo(), sitemap_gravar(), sitemap_robots_gravar(), sitemap_conteudo_proprio() and sitemap_legado_remover() handle the URL and the disk.

Functions

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