Files
slp-modular-cms/aidlc-docs/features/website-seo/overview.md
SluijsensandClaude Sonnet 5.5 571aaf9cd2 ASF-injectie 5/5: end-to-end test op de master-host, ASF Website:AuthoredBaseUrl, rooktest-uitbreiding, docs
- ASF appsettings: Website:AuthoredBaseUrl=https://andreaslop.nl, PublicBaseUrl leeg (env).
- Api.Tests/AsfInjectionPipelineTests: pagina met markers, echte database; een CMS-wijziging is direct zichtbaar (ETag wijzigt), data-blok == publieke API, 304, sitemap-adres.
- smoke-site.sh: onverwerkte CMS-markers op / falen; data-blok moet siteUrl van deze host hebben.
- docs: asf-host-injection 'as built'.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 16:16:27 +01:00

2.5 KiB

Website SEO on the CMS host (website-seo)

  • Slug: website-seo
  • Type: Feature (small), built outside the AI-DLC flow and documented afterwards
  • Status: Commits a7460a0, 284ff1f (2026-11-11) and 32b98fe on feature/contact-forms-module; on the SLP test host (not merged, nothing in production)
  • Affected components: SlpModularCms.Core (Hosting/Website), SlpModularCms.Modules.Offerings (index markers), SlpModularCms.Api.SlpSoftware/appsettings.json
  • Documented: 2026-11-15
  • Documentation Language: English
  • Conversation Language: Dutch (user language)

Not run through the AI-DLC stages; this file records what the code does. There are no requirements, plans or audit.md.

Scope

Only hosts in WebsiteMode.SpaFallback (SlpSoftware). The ASF host (PrerenderedPages) registers none of this: that site builds its own canonical, og, JSON-LD and sitemap.

Behaviour (Website configuration section)

Setting Effect
NoIndex (default true, fail-safe) X-Robots-Tag: noindex, nofollow on every response; /robots.txt is Disallow: /; no sitemap. Production must set Website__NoIndex=false.
PublicBaseUrl Absolute address of the instance. With NoIndex=false: /robots.txt allows all and points to {PublicBaseUrl}/sitemap.xml; /sitemap.xml lists Sitemap:Paths (no lastmod). Production: https://slpsoftware.nl.
AuthoredBaseUrl The address the static index.html is written with. On a test instance with its own PublicBaseUrl, the host replaces the authored address by PublicBaseUrl in the served HTML (canonical, og, JSON-LD). Equal on production, so nothing changes. Only the configured value is used, never the request's Host header.
KnownPaths Only these paths are pages (200, the SPA shell); any other website path is a real 404 (still the shell). /api, /admin and assets keep working.
Sitemap:Paths Paths listed in the sitemap.

Index markers (HtmlMarkerInjector (until 2026-11-15 IndexHtmlInjector; generalised for the prerendered host, see asf-host-injection))

The host fills markers in index.html: <!--SLP:OFFERINGS-JSON-LD--> (schema.org ItemList of Offer) and <!--SLP:OFFERINGS-HTML--> (a static #packages-static list), rendered by OfferingsIndexMarkers from the live offerings. 60-second cache, invalidated directly by every offering change, ETag with 304 support; if a provider fails the plain page is still served. The markers must stay in <body> above #root; the website removes #packages-static on start-up.