CodePress/docs/release-notes/v2.6.3.md

CodePress CMS v2.6.3 — Release Notes

Release datum: 2026-08-20
Codename: Lyra
Status: stable

---

Samenvatting

Deze release richt zich op content met meerdere bestandstypes en een duidelijkere Content API. Content bestanden die dezelfde naam delen maar een ander type hebben (test.md, test.php, test.html) worden nu correct afgehandeld: de frontend serveert per extensie het juiste bestand, en de admin accepteert en toont ze allemaal. Daarnaast is de getAllPages() API herschreven naar een rijkere array-structuur en zijn de verberg-prefixen voor mappen/bestanden gewijzigd (. vervangt _).

---

Nieuwe features & wijzigingen

1. Content bestanden met dezelfde naam, ander type

Eerder kon een content map niet twee bestanden bevatten met dezelfde naam maar een verschillend type (bijv. test.md + test.php). De frontend routeerde alleen op naam zonder extensie, waardoor slechts één bestand geserveerd werd.

Nu:

• URL met extensie (/nl/test.php) serveert exact dat bestand.
• URL zonder extensie (/nl/test) valt terug op het eerste bestaande bestand met prioriteit md > php > html (via de nieuwe resolveContentByType() helper).
• De admin content editor accepteert bestanden met dezelfde naam (ander type); de "bestaat al" check is per extensie. De melding is verduidelijkt naar "Bestand met dit type bestaat al."
• De admin preview-knop linkt per extensie (test.php → /nl/test.php) zodat elk type individueel te bekijken blijft.

2. Frontend navigatie tonen alle bestandstypes

scanDirectory() (menu), getDirectoryListing() (directory view) en searchInDirectory() (zoeken) tonen nu elk bestand apart met de extensie behouden in de URL. Bestanden met dezelfde naam maar ander type zijn niet meer samengevoegd tot één menu-item — elk type krijgt zijn eigen link.

3. getAllPages() array structuur

ContentAPI::getAllPages() (en CMSAPI::getAllPages() voor plugins) gaf eerder een associative array ['pad' => 'titel']. Nu is het een list van entry arrays:

[
    ['path' => 'test-map',        'title' => 'Test Map',       'type' => 'folder'],
    ['path' => 'test-map/test.md','title' => 'Nieuwe pagina', 'type' => 'md'],
    ['path' => 'test.md',         'title' => 'Test',          'type' => 'md'],
    ['path' => 'test.php',        'title' => 'Test.',         'type' => 'php'],
    ['path' => 'test.html',       'title' => 'Nieuwe pagina', 'type' => 'html'],
]

• type is md/php/html voor bestanden, folder voor mappen.
• Mappen krijgen hun eigen entry zodat de boom-structuur zichtbaar blijft.
• Bestanden met dezelfde naam maar ander type botsen niet meer (de extensie zit in het pad).

autoLinkPageTitles() is aangepast aan de nieuwe structuur en slaat mappen over.

4. Verberg-prefix logica: . i.p.v. _

Vooraf verborg de frontend mappen/bestanden die begonnen met ., - of _. Nu is _ geen verberg-prefix meer — alleen . (en -) verbergen aan de frontend. Dit maakt .map of .bak de standaard manier om content te verbergen.

De admin daarentegen toont wél alle . bestanden en mappen (.bak, .map), behalve .git/.gitkeep. De scanEditorFilesNode() functie heeft een nieuwe $scope parameter die bepaalt of dotfiles getoond worden (alleen voor content scope).

collectContentPages() (admin config default-page dropdown) toont nu ook . bestanden.

5. ContentAPI getPage()/pageExists() met extensie

ContentAPI::getPage('test.php') en pageExists('test.php') respecteren nu de expliciete extensie — ze openen dat specifieke bestand in plaats van terug te vallen op md-prioriteit.

6. Handleiding content-api.md herschreven

De handleiding guide/nl/content-beheerder/content-api.md en de Engelse tegenhanger zijn volledig herschreven:

• Hoe content naar Twig gaat: echo/print vs return mechanisme duidelijk uitgelegd met voorbeelden
• Wat je niet kunt: geen eigen Twig variabelen vanuit PHP; je voedt alleen {{ content }}
• Beschikbare variabelen in een .php bestand: $api en $pageMetadata
• Nieuwe getAllPages() structuur met type-veld en voorbeelden
• Layout kiezen: hoe de layout frontmatter key koppelt naar theme.json
• Veiligheidsrichtlijnen

---

Technische details

Nieuwe/gewijzigde functies (core)

• CodePressCMS::resolveContentByType(string $basePath, ?string $preferredExt = null): ?array — Nieuwe helper die het eerste bestaande bestand (md > php > html) serveert, of het bestand met de gevraagde extensie als $preferredExt opgegeven is.
• CodePressCMS::scanForPageTitles() — herschreven naar list van ['path','title','type'] entries; mappen als eigen entry; _ niet meer verborgen.
• CodePressCMS::scanDirectory() / searchInDirectory() / getDirectoryListing() — _ verwijderd uit verberg-logica; extensie behouden in URLs.
• CodePressCMS::autoLinkPageTitles() — aangepast aan nieuwe array structuur.
• ContentAPI::getPage() / pageExists() — respecteren expliciete extensie.
• ContentAPI::getAllPages() / CMSAPI::getAllPages() — docblocks bijgewerkt.
• scanEditorFilesNode() — nieuwe $scope parameter; content-scope toont dotfiles (behalve .git/.gitkeep).
• scanContentDir() / collectContentPages() — tonen nu . bestanden/mappen.

Gewijzigde bestanden

• cms/core/class/CodePressCMS.php — resolveContentByType, scanForPageTitles, scanDirectory, searchInDirectory, getDirectoryListing, autoLinkPageTitles, sanitizePageParam (punt toegestaan), getPage (explicitExt terug)
• cms/core/class/ContentAPI.php — getPage/pageExists met extensie, getAllPages docblock
• cms/core/plugin/CMSAPI.php — getAllPages docblock
• public/admin.php — scanContentDir, scanEditorFilesNode, collectContentPages, handleContentNew/handleContentFiles meldingen
• admin/theme/default/views/pages/content-files.twig — preview link per extensie
• admin/theme/default/views/pages/content-edit.twig — preview link per extensie
• guide/nl/content-beheerder/content-api.md — herschreven
• guide/en/content-beheerder/content-api.md — herschreven
• version.php — 2.6.3
• README.md / README.en.md — versie 2.6.3
• TODO.md — v2.6.3 sectie toegevoegd

---

Tests

• PHP lint: alle bestanden syntactisch correct (php -l)
• Live getest via Apache (development.codepress.noorlander.info):
  • /nl/test.php serveert test.php
  • /nl/test.html serveert test.html
  • /nl/test (zonder ext) serveert test.md (md prioriteit)
  • Admin content boom toont .bak, .map, _images en alle bestandstypes
  • Frontend navigatie verbergt .bak/.map, toont alle bestandstypes apart
  • $api->getAllPages() in test.php toont pad/titel/type structuur

---

Volgende stappen

Zie TODO.md voor openstaand werk (multidomein implementatie).