CodePress/docs/release-notes/v2.6.1d.md

CodePress CMS v2.6.1d — Release Notes

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

---

Samenvatting

Deze release richt zich volledig op plugin-verbeteringen: plugin internationalisatie (i18n), plugin uniformiteit, en een volledig vernieuwde plugin-editor met bestandsbrowser, uploaden, verwijderen en verplaatsen van bestanden binnen een plugin.

---

Nieuwe features

1. Plugin internationalisatie (i18n)

Plugins hebben nu hun eigen language/ map met vertalingen, geïntegreerd met de admin-taal en content-taal.

• Systeem plugins (type: "system") volgen de geselecteerde admin taal — vertalingen in language/<lang>/admin.php
• Content plugins (type: "content") volgen de geselecteerde content taal — vertalingen in language/<lang>/site.php
• Fallback chain: geselecteerde taal → plugin default_language (uit plugin.json) → CMS site default → lege array (sleutel wordt ongewijzigd getoond)

Core uitbreidingen:

• PluginManager: getPluginDefaultLanguage(), getPluginTranslations(), getAllPluginTranslations() met fallback chain
• PluginAPIInterface: getPluginTranslations() + t() toegevoegd (contract voor beide API's)
• AdminPluginAPI: getAdminLanguage(), getPluginTranslations(), t() (systeem plugins)
• CMSAPI: getPluginTranslations(), t() (content plugins)

Admin integratie:

• public/admin.php laadt alle plugin-vertalingen als Twig global ta_plugins + functions tap() en plugin_menu_label()
• handlePluginsConfig() resolveert label_key/help_key/option_label_key via plugin-vertalingen voor instellingen-labels
• Admin sidebar toont vertaalde plugin-menu labels via plugin_menu_label()

Alle 6 plugins bijgewerkt:

• Dashboard, GeoIPInfo, Logs, Statistics (systeem): language/nl/admin.php + language/en/admin.php
• HTMLBlock, Navigation (content): language/nl/site.php + language/en/site.php
• plugin.json: default_language: "nl" toegevoegd
• Logs en Statistics: instellingen-labels via label_key/help_key in plaats van hardcoded tekst
• Alle hardcoded Nederlandse strings in handleAdminRoute()/getSidebarContent() vervangen door vertaalde waarden

2. Plugin uniformiteit

Elke plugin heeft nu een uniforme structuur:

plugins/<Plugin>/
├── <Plugin>.php          # Hoofd plugin class
├── plugin.json            # Metadata + instellingen
├── README.md              # Plugin documentatie (uniform format)
├── assets/                # CSS/JS/SCSS (.gitkeep als leeg)
│   └── ...
└── language/              # Vertalingen
    ├── nl/
    └── en/

• Per plugin een README.md met uniform format: plugin type, bestandsstructuur, functies, instellingen, taal support
• plugins/README.md herschreven als korte algemene intro met plugin-overzicht tabel
• guide/nl|en/codepress-developer/plugin-development.md volledig herschreven (structuur, plugin.json velden incl. default_language, settings schema met label_key/help_key, API methodes incl. getPluginTranslations/t, admin integratie, taal support sectie)
• guide/nl|en/codepress-developer/architectuur.md bijgewerkt met plugin language/ map

3. Plugin editor volledig vernieuwd

De plugin-editor (/admin/plugins-edit) toonde alleen het <Plugin>.php bestand. Nu is het een volledige bestandsbeheer-omgeving.

Bestandsbrowser zijbalk

• Geneste, inklapbare boomstructuur van alle bestanden in de plugin-map (.php, .json, .md, .html, .css, .scss, .js) inclusief language/ en assets/ submappen
• Mappen die het actieve bestand bevatten worden automatisch uitgeklapt
• Iconen per bestandstype (PHP, JSON, MD, CSS, JS, HTML, mappen)
• Bootstrap collapse via <button> toggles met chevron-rotatie
• scanPluginFiles() helper — recursieve boom-opbouw met path-traversal bescherming
• editor-toolbar.js modeMap uitgebreid: css: 'css', scss: 'css', js: 'javascript', json: 'javascript'

Nieuw bestand aanmaken

• "Nieuw bestand" knop + modal met pad-invoer (bijv. helper.php of assets/css/extra.css)
• Submappen worden automatisch aangemaakt
• Stub-content per extensie (<?php\n voor PHP, {\n}\n voor JSON)
• Path-traversal bescherming: ..//..\\/./ stripping + ../. segment-guard + realpath prefix-check

Uploaden

• Upload-knop + inklapbaar upload-formulier dat bestanden opslaat in plugins/<naam>/assets/
• Toegestane extensies: afbeeldingen, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD
• Nieuwe route: plugins-file-upload
• Protected plugins (Navigation) geblokkeerd
• Path-traversal bescherming

Verwijderen

• Per-bestand prullenbak-icoon in de bestandsboom (altijd zichtbaar, met mouseover-tekst)
• Nieuwe route: plugins-file-delete
• Path-traversal bescherming + protected plugins geblokkeerd + dotfiles geweigerd (.gitkeep kan niet verwijderd worden)
• Na verwijderen valt de editor terug op het hoofd-bestand

Verplaatsen

• Per-bestand verplaats-icoon (pijlen) in de bestandsboom
• Nieuwe route: plugins-file-move + pages/plugins-move-form.twig
• Dropdown met alle mappen binnen de plugin (plugin root als optie, huidige map uitgesloten)
• rename() uitvoering met path-traversal bescherming voor zowel bron als doel
• Protected plugins geblokkeerd

4. Media invoegen in editor

De media-knop in de editor-toolbar was al die tijd stuk — het probeerde een niet-bestaand #mediaModal te openen.

• Nieuw JSON-endpoint /admin/media-list: retourneert media-bestanden (recursief), images eerst
• Nieuwe herbruikbare Twig include pages/_media-modal.twig: Bootstrap modal met zoekfilter en raster van media-bestanden
• Laadt media-lijst via fetch('/admin/media-list') bij openen
• Bij klik wordt een snippet in de CodeMirror-editor ingevoegd op de cursor:
  • Markdown: ![naam](url)
  • HTML/PHP: <img src="url" alt="naam"> / <a> / <video> / <audio>
  • CSS/SCSS/JS/JSON: ruwe URL
• Plugin-context: in de plugin-editor scant het endpoint plugins/<naam>/assets/ i.p.v. content-map (via ?plugin= parameter); URLs beginnen met /plugins/<naam>/assets/
• admin.twig includeert het modal wanneer needs_editor true is
• editor-toolbar.js media-case robuuster gemaakt

5. Plugin overzicht knoppen

De knoppen op de plugin-kaarten (/admin/plugins) tonen nu alleen iconen met mouseover-tekst (title + aria-label) in plaats van icoon + tekst, zodat ze netjes naast elkaar passen in de btn-group w-100.

---

Bug fixes

• Admin taal niet geïntegreerd met plugins — opgelost via plugin i18n systeem (zie boven)
• Plugin editor toonde alleen <Plugin>.php — opgelost via bestandsbrowser (zie boven)
• Media-knop in editor werkte niet — #mediaModal bestond niet; opgelost via nieuwe media-modal include
• Plugin editor uploaden/verwijderen/verplaatsen ontbrak — toegevoegd (zie boven)
• Plugin-kaart knoppen tekst liep niet goed — teksten verwijderd, alleen iconen met title

---

Technische details

Nieuwe routes

• media-list — JSON endpoint voor media-bestanden
• plugins-file-upload — bestanden uploaden naar plugin assets/
• plugins-file-delete — bestand verwijderen uit plugin
• plugins-file-move — bestand verplaatsen binnen plugin

Nieuwe bestanden

• admin/theme/default/views/pages/_media-modal.twig — herbruikbare media modal
• admin/theme/default/views/pages/plugins-move-form.twig — verplaats-pagina
• plugins/<Plugin>/language/{nl,en}/{admin,site}.php — plugin vertalingen (per plugin)
• plugins/<Plugin>/README.md — uniforme documentatie (per plugin)
• plugins/<Plugin>/assets/.gitkeep — lege assets map placeholder

Gewijzigde bestanden (core)

• cms/core/plugin/PluginManager.php — i18n methoden, site default language
• cms/core/plugin/PluginAPIInterface.php — getPluginTranslations(), t() contract
• cms/core/plugin/AdminPluginAPI.php — admin language, plugin translations
• cms/core/plugin/CMSAPI.php — content language plugin translations
• cms/core/class/CodePressCMS.php — PluginManager + CMSAPI wiring
• public/admin.php — media-list endpoint, plugin-file routes, plugin translations Twig globals, handlePluginsEdit herschreven, handlePluginsConfig label_key support, flash messages
• admin/theme/default/views/layouts/admin.twig — media modal include
• admin/theme/default/views/pages/plugins-edit.twig — bestandsbrowser, upload, verwijderen, verplaatsen
• admin/theme/default/views/pages/plugin-config.twig — vertaalde instellingen-labels
• admin/theme/default/views/pages/plugins.twig — icoon-only knoppen met titles
• admin/theme/default/assets/js/editor-toolbar.js — modeMap uitgebreid, media-case robuust
• language/{nl,en,de}/admin.php — nieuwe vertaalstrings

---

Tests

• Pentest: 30/30 tests geslaagd — 0 vulnerabilities
• WCAG 2.1 AA accessibility: 25/25 tests geslaagd — 100% compliance

---

Bestanden gewijzigd sinds v2.6.1c

40 bestanden gewijzigd, 2559 insertions(+), 369 deletions(-)