- 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>
30 lines
2.5 KiB
Markdown
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.
|