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

30 lines
2.5 KiB
Markdown

# 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.