76 Commits
Author SHA1 Message Date
E.Noorlander 6d5ca7cab4 v2.6.1d (Lyra): Plugin i18n, plugin editor vernieuwd, media invoegen
Plugin internationalisatie: plugins hebben eigen language/ mappen. Systeem
plugins volgen admin taal (admin.php), content plugins volgen content taal
(site.php). Fallback chain: geselecteerd -> plugin default_language -> CMS
default. PluginManager/AdminPluginAPI/CMSAPI uitgebreid met
getPluginTranslations()/t(). plugin.json settings ondersteunen
label_key/help_key/option_label_key.

Plugin uniformiteit: alle 6 plugins hebben uniforme structuur (README.md,
assets/.gitkeep, language/nl|en/). plugins/README.md herschreven.
guide plugin-development.md (NL+EN) volledig herschreven.

Plugin editor vernieuwd: geneste bestandsbrowser zijbalk, nieuw bestand
aanmaken, uploaden naar assets/, verwijderen en verplaatsen. Nieuwe routes:
plugins-file-upload, plugins-file-delete, plugins-file-move. Path-traversal
bescherming + protected plugins geblokkeerd.

Media invoegen in editor: nieuw /admin/media-list JSON endpoint + herbruikbare
_media-modal.twig include. Plugin-context scant assets/ map. editor-toolbar.js
modeMap uitgebreid voor css/scss/js/json.

Plugin overzicht knoppen: alleen iconen met title/aria-label.

Tests: pentest 30/30, WCAG 2.1 AA 25/25.
2026-08-18 13:49:52 +00:00
root 88fbaa5702 v2.6.1c (Lyra): Admin gebruikersbeheer opnieuw ontworpen + CLI reset
Nieuwe features:
- Admin gebruikerslijst met zoeken/filter op gebruikersnaam en rol
- Profiel bewerken pagina met wachtwoord wijzigen en rol wijzigen
- Nieuwe gebruiker aanmaken via aparte pagina
- CLI commando cli/reset-admin-password.php voor admin wachtword reset + lockout reset

Architectuur:
- /admin/users: lijst met zoekveld, rol filter, bewerk/verwijder acties
- /admin/users-edit?user=<naam>: profiel, wachtwoord, rol, verwijderen
- /admin/users-new: nieuwe gebruiker aanmaken
- AdminAuth::clearLockout() public methode voor CLI gebruik

Documentatie:
- guide/nl/en/admin-beheerder/gebruikers.md herschreven
- 15 nieuwe admin vertaalkeys in NL/EN/DE
- Release notes: docs/release-notes/v2.6.1c.md

Tests:
- Pentest: 30/30 geslaagd, 0 vulnerabilities
- WCAG 2.1 AA: 25/25 geslaagd, 100% compliance
2026-08-17 15:10:40 +00:00
root c2cf08955b v2.6.1 (Lyra): Welcome page, 404 handling, installatie docs, opschoning
Nieuwe features:
- Welkomstpagina bij lege content-map (nieuwe installatie detectie)
- 404-afhandeling binnen actieve theme via admin/static/404.html
- HTTP 404 status bij onbekende pagina's en missende taalprefix

Opschoning:
- Verwijderd: package.json, src/scss/, root .htaccess, themes/demo/
- Verwijderde vendor packages: php-mqtt/client, mustache/mustache
- AGENTS.md samengevoegd naar root, development/AGENTS.md verwijderd
- .gitignore opgeschoond (NPM/node_modules/.sass-cache verwijderd)

Documentatie:
- Installatie instructies toegevoegd aan README (Apache2/Nginx/PHP/composer)
- README en guide versie referenties bijgewerkt naar 2.6.1
- Release notes: docs/release-notes/v2.6.1.md

Tests:
- Pentest: 30/30 geslaagd, 0 vulnerabilities
- WCAG 2.1 AA: 25/25 geslaagd, 100% compliance
- Test scripts gebruiken Apache-URL i.p.v. localhost:8080
2026-08-17 14:48:46 +00:00
E.Noorlander bd4fe54d09 Fix: Dashboard altijd zichtbaar in sidebar (onafhankelijk van plugin status)
Dashboard was niet zichtbaar in de sidebar als de Dashboard plugin niet
in enabled_plugins stond. Nu is Dashboard hardcoded bovenaan de Algemeen
sectie, en wordt het uit de plugin menu items gefilterd om dubbele links
te voorkomen.
2026-08-15 19:56:34 +02:00
E.Noorlander 94f9b3d831 Merge development v2.6.0 into main
Resolved conflicts by taking development (v2.6.0) version for all files.
Removed statistics.twig (replaced by Statistics plugin).
2026-08-15 19:32:47 +02:00
E.Noorlander 20adea7544 v2.6.0: Content backup/git versioning, plugin type system, docs update
New features:
- ContentBackup class with ZIP backup/restore and git versioning
- Admin backup & restore page (content-backup.twig) with git init/commit/log/restore
- Plugin type system: system (blue) vs content (green) with visual badges
- PluginAPIInterface + AdminPluginAPI for plugin architecture
- Essential plugin flag (cannot edit/deactivate/delete)

Improvements:
- Consolidated enabled_plugins config (removed plugins.enabled)
- Removed Analytics/Logging toggles from admin config page
- Fixed Dashboard plugin Twig comments rendered as text
- Updated 20 guide files (NL+EN): configuratie, plugins, plugin-development,
  core-classes, theme-json, layouts, scss-styling, admin-beheerder, nieuw-thema, architectuur
- Improved accessibility test script (grep -E, min/max checks)

Cleanup:
- Removed unused classes: ARIAComponents, AccessibilityManager, ContentSecurityPolicy, etc.
- Removed vendor packages: mustache/mustache, php-mqtt/client
- Removed old templates: logs.twig, statistics.twig (now plugins)
- Moved language files to language/ directory

Tests:
- Pentest: 30/30 passed, 0 vulnerabilities
- WCAG 2.1 AA: 25/25 passed, 100% compliance
2026-08-15 19:21:04 +02:00
E.Noorlander 9a5ab351ba Update all guides (NL + EN) for CodePress 2.5.2 features
- Admin guide: RBAC roles, role-based dashboard, plugin types (content/system)
- CodePress developer guide: plugin types, admin plugin API, SCSS compilation, asset serving
- Theme developer guide: SCSS sole CSS source, css_compiled read-only, guide layout
- Content manager guide: layout selection from theme.json, plugin order in frontmatter
- Both NL and EN updated with identical structure
- 35 files updated
2026-08-12 12:05:53 +02:00
E.Noorlander a9e3b023de System plugin support: admin menu items, admin routes, API integration
- PluginManager: getAdminMenuItems(), handleAdminRoute(), getPluginType()
- admin.php: load PluginManager, pass plugin_admin_menu to Twig
- admin.php: route to plugin admin pages via handleAdminRoute()
- admin.twig: show 'Plugins' sidebar section for system plugins
- plugins-new.twig: choose content or system plugin type
- handlePluginsNew: generate proper template based on type (content/system)
- plugin-admin.twig: renders plugin output in admin layout
- GeoIPInfo: example system plugin (admin page with GeoIP info)
- System plugins: getAdminMenu(), getAdminRoutes(), handleAdminRoute()
- Content plugins: getSidebarContent() (unchanged)
2026-08-11 18:06:17 +02:00
E.Noorlander 6ed29e2c6c Fix plugin arrows (grey/disable not hide) + live frontmatter update on plugin change
- Arrow buttons: opacity 0.4 + pointer-events none at first/last (not hidden)
- updateFrontmatter(): updates both layout AND plugins in editor live
- Plugin order change -> frontmatter updated immediately in CodeMirror
- Plugin checkbox toggle -> frontmatter updated immediately
- Label is 'Plugins' (not 'Zichtbare plugins')
- Update AGENTS.md with plugin types (content vs system)
2026-08-11 17:29:54 +02:00
E.Noorlander ec7fec1c1e Plugin system: content vs system types, sidebar-aware UI, arrow visibility
- plugin.json type field: 'content' (sidebar) or 'system' (API only)
- Content-edit: label 'Plugins', hide section if layout has no sidebar
- Content-edit: disable checkboxes when no sidebar layout selected
- Content-edit: hide up arrow on first item, down arrow on last item
- PluginManager: isPluginViewable() checks type=system -> not viewable
- Admin plugins page: show Content/Systeem type badge
- HTMLBlock: add plugin.json with type=content
- Navigation: add type=content to config
2026-08-11 17:22:41 +02:00
E.Noorlander 4e77ef8670 Fix: show all plugins in content-edit, not just those with plugin.json
HTMLBlock has no plugin.json, only HTMLBlock.php.
Accept plugin if it has plugin.json OR <PluginName>.php.
2026-08-11 17:12:04 +02:00
E.Noorlander 9ec4910674 Fix Twig syntax error in content-edit.twig: if not in inside for loop
Twig does not support 'for x in y if x not in z' syntax.
Use separate {% if %} block inside {% for %} loop instead.
2026-08-11 17:09:02 +02:00
E.Noorlander 03a14126ca Plugin sidebar order + directory layout from index.md
- PluginManager: iterate allowedPlugins in user-defined order (frontmatter order)
- content-edit.twig: plugin list with up/down arrows to set order
- Directory listing: read layout/plugins from index.md if present
- Directory default layout: full_content (no sidebar) unless index.md says otherwise
2026-08-11 17:04:27 +02:00
E.Noorlander 342112cd21 Fix submenu arrow: flexbox centering, proper spacing
- Use display: flex + align-items: center on dropdown-toggle
- gap: 0.75rem between text and arrow
- Remove float: right and margin-top hack
- chevron-right: flex-shrink: 0, font-size: 0.7rem
2026-08-11 16:57:50 +02:00
E.Noorlander 1a748cbc77 Remove focus outline/border on nav-link, add focus-visible override
- Remove .nav-link:focus from accessibility outline rules
- Add outline: none and box-shadow: none on nav-tabs .nav-link states
- Override :focus-visible with border: none, outline: none, box-shadow: none
2026-08-11 16:55:31 +02:00
E.Noorlander a03c91faf2 Add CRITICAL sections to AGENTS.md to prevent repeated mistakes
- SCSS is sole CSS source, never edit theme.css manually
- Bootstrap 5: override all CSS variables AND properties
- Path references from public/admin.php: use ../ not ../../
- Twig: no dirname filter, use default() not ?? on filter expressions
- CodeMirror mode load order dependencies
- Plugin filename convention: <Name>.php not plugin.php
- Essential plugins protection
- Live server asset serving via asset.php
2026-08-11 16:51:05 +02:00
E.Noorlander 0dae0094f5 Use SCSS as sole CSS source, remove manual theme.css
- Remove manual themes/default/assets/css/theme.css
- SCSS is compiled by scssphp to css_compiled/theme.css
- All nav-tabs, dropdown-menu, dropdown-item overrides in SCSS only
- Override ALL Bootstrap nav-tabs CSS variables and properties
2026-08-11 16:48:21 +02:00
E.Noorlander 689a1a5d81 Fix dropdown width: width: max-content on menu, width: 100% on items
- dropdown-menu: width: max-content (menu adapts to longest item)
- dropdown-item: width: 100% (items fill menu width)
- Same for submenu dropdown-menu
2026-08-11 16:43:13 +02:00
E.Noorlander a9388df019 Remove --bs-nav-tabs CSS variables from theme, use direct !important overrides
- Remove --bs-nav-tabs-border-radius/width/color from theme.css
- Use border: none !important and border-radius: 0 !important directly
- Override all Bootstrap --bs-dropdown-* variables completely
- Add gap: 0 on .nav-tabs
2026-08-11 16:41:02 +02:00
E.Noorlander 942393f7f9 Override Bootstrap dropdown CSS variables completely: no borders, no radius, no shadow, auto-width
- Set --bs-dropdown-min-width: 0 (width adapts to content)
- Set --bs-dropdown-border-width: 0 (no borders)
- Set --bs-dropdown-border-radius: 0 (no rounded corners)
- Set --bs-dropdown-box-shadow: none (no shadow)
- Set --bs-dropdown-padding-x/y: 0 (no padding)
- white-space: nowrap and width: auto on dropdown-item
- Same overrides on submenu dropdown-menu
2026-08-11 16:30:26 +02:00
E.Noorlander f6650fafdb Remove dropdown borders, auto-width to content, nowrap items
- border: none on all dropdown-menu (no borders)
- min-width: 0 (width adapts to longest item title)
- white-space: nowrap on dropdown-item
- Remove border-left on mobile submenus
2026-08-11 11:36:48 +02:00
E.Noorlander 884c0141c6 Override Bootstrap nav-tabs CSS variables: border-radius, border-width, border-color
- Set --bs-nav-tabs-border-radius: 0
- Set --bs-nav-tabs-border-width: 0
- Set --bs-nav-tabs-border-color: transparent
- Add border-radius: 0 !important on .nav-tabs
2026-08-10 16:17:17 +02:00
E.Noorlander f70506616b Bump version to 2.5.2 2026-08-10 16:15:27 +02:00
E.Noorlander 0076d7bd8d Fix dropdown menu styling: no rounded corners, no gaps, consistent hover
- border-radius: 0 on all dropdown-menu and dropdown-item
- padding: 0 and margin: 0 on dropdown-menu
- margin-left: 0 on submenu (no gap between parent and child)
- margin-top: -1px on submenu (seamless border overlap)
- CSS hover opens submenu on desktop, click on mobile
- white-space: nowrap on dropdown items
- Fix statistics getFullStats -> getStats
- Fix Twig ?? operator -> default filter on dashboard/statistics
- Asset server (public/asset.php) for production static file serving
- .htaccess rewrite rules for themes/admin/plugins assets
2026-08-10 16:14:12 +02:00
E.Noorlander 0fbb9bb74c live bug fixed 2026-08-10 15:51:00 +02:00
E.Noorlander d8e37f0bf6 AGENTS.md and TODO.md change 2026-08-10 15:45:09 +02:00
E.Noorlander 3a55ea4db6 v2.5.1: Admin theme refactor, Navigation plugin, user roles, guide restructure
- Reorganize admin into admin/theme/default/ (views + assets)
- Rename GuideNav to Navigation plugin (essential, protected)
- Plugin assets support (SCSS/CSS) loaded after theme CSS
- User roles: Admin, Content Manager, BI Manager, Site Admin
- Role-based access control (RBAC) for admin routes and sidebar
- Guide restructure: sub-topics in separate folders with sidebar nav
- Dynamic breadcrumb for homepage and subdirectories
- Fix theme path traversal (../../ -> ../) in admin.php
- Fix CodeMirror mode load order (xml -> css -> js -> htmlmixed -> php)
- Fix editor-toolbar.js null checks for plugin edit pages
- Layout select from theme.json with live frontmatter update
- Footer sticky at bottom of viewport (min-height: 100vh)
- Breadcrumb color fix (var(--nav-font) -> var(--header-bg))
- Remove language switcher from guide pages
- Update README.md and README.en.md
- Bump version to 2.5.1
2026-08-10 15:36:29 +02:00
E.Noorlander 7fc3847bbb merge from development 2026-08-08 18:45:10 +02:00
E.Noorlander c854c18687 Fix version fallback: use 0.0.0 with error flag when version.php is missing or invalid
- handleUpdate(): set versionError flag and return 0.0.0 if version.php missing/invalid
- Dashboard stats: use 0.0.0 fallback instead of '-' when version cannot be determined
- Makes version.php truly required as intended
2026-08-08 18:37:26 +02:00
E.Noorlander aedabed09d Bump version to 2.0.0 - Major release with new theme engine and security fixes 2026-08-08 18:30:27 +02:00
E.Noorlander ab5dc31513 Security fixes: XSS and CRLF injection prevention
- Add sanitizePageParam() method to CodePressCMS to prevent XSS attacks via page parameter
- Sanitize page and lang parameters in available_langs URLs
- Add CRLF character filtering in MQTTTracker to prevent header injection
- URL-encode parameters before storing in cookies

Pentest results: 29/30 tests passed (1 false positive on CRLF test -
URL-encoded chars in cookie value, no actual header injection possible)
2026-08-08 18:26:44 +02:00
E.Noorlander 6333bc410f CMS 2.0 - Theme engine, logging, admin improvements
Major changes:
- New ThemeManager with Twig templating and SCSS compilation
- Dynamic themes system (themes/default, themes/demo)
- LogManager with SQLite storage and syslog forwarding
- RequestLogger with static helper methods
- Admin UI overhaul (Bootstrap 5, dark mode)
- Admin config page with logging and theme settings
- Admin logs page with filters and search
- Removed legacy Mustache templates
- Removed test plugin and theme
- Composer dependencies: Twig, scssphp, CommonMark, MaxMind GeoIP
2026-08-08 18:02:14 +02:00
E.Noorlander d453b8073f Fix PHP parse error in version.php: apostrophe in single-quoted string caused HTTP 500 2026-07-29 16:30:31 +02:00
E.Noorlander ebc3841a17 v1.9.2: Admin sidebar groepen, IP-uitsluitingen, guides herschreven 2026-07-29 16:08:04 +02:00
E.Noorlander fd393250fc Voeg IP-uitsluitingen toe aan configuratie: IP's niet meetellen in statistieken en overslaan bij beveiliging 2026-07-29 16:01:14 +02:00
E.Noorlander 44a1e6dc96 v1.9.1: fix world map rendering and resolve eight small TODO items
World map:
- Fix zero-padded ISO numeric ids leaving 31 countries unrendered
  (Brazil, Australia, Belgium, Austria, Algeria and more)
- Fix Russia and Fiji smearing across the full map width at the antimeridian
  by unwrapping ring longitudes and drawing them at both edges
- Crop to 84N-60S, add evenodd fill rule, 174 countries rendered

Improvements:
- Logger::tail() reads backwards in chunks instead of loading the whole file
- External links get rel=noopener noreferrer in footer and Markdown content
- formatDisplayName() cleaned up and guarded against empty input
- Export statistics as CSV (Excel BOM) or JSON
- GeoIP database auto-updates when older than 35 days
- Editor shortcuts Ctrl/Cmd+S to save and Ctrl/Cmd+N for a new page
- Live search filter in the admin content browser
- Content versioning with timestamped .bak copies in content/-backups/

Also removes eight stale TODO entries that were already implemented
2026-07-29 15:53:35 +02:00
E.Noorlander 06785e9922 CodePress CMS v1.9.0: visitor statistics with SVG world map and GeoIP
- Add GeoIP class with provider chain: local DB-IP Lite, MaxMind .mmdb, external API
- Add built-in pure-PHP MMDBReader so .mmdb works without Composer
- Add cli/geoip-update.php to download DB-IP Lite and build a compact binary index
- Add cli/generate-world-map.php to generate the world map SVG from Natural Earth TopoJSON
- Add Analytics class aggregating stats in admin/storage/stats.json with LOCK_EX
- Add admin statistics page with choropleth world map, country list, top pages,
  daily chart, referrers and a period filter
- Add GeoIP and privacy settings with database update and stats reset buttons
- Add optional IP anonymization and configurable retention period
- Add country field to requests.log (parser accepts 7, 8 or 9 fields)
- Add country column to request log and KPI cards to the dashboard
- Ignore GeoIP binaries and stats.json in Git
- Update TODO.md, guides and version to 1.9.0
2026-07-29 15:40:02 +02:00
E.Noorlander 8c6b38c2c5 Add Git repository permission check to Admin Update page 2026-07-29 14:33:35 +02:00
E.Noorlander 433efce56e Ignore admin/storage/cache/ runtime directory 2026-07-29 14:31:02 +02:00
E.Noorlander 375a39c458 CodePress CMS v1.8.0: BotGuard security engine, HAProxy docs & ARIA fix
- Implement BotGuard security engine (Bot, AI, Scraper & Empty UA blocking)
- Add Admin Security page (/admin/security) with toggles, rate limiter & block/allowlists
- Add per-IP RateLimiter handoff in index.php with HTTP 429 response
- Add dynamic /robots.txt generation and noai/noimageai meta tags
- Add RequestLogger status column and blocked badges in admin request logs
- Fix ARIAComponents.php syntax errors on lines 67, 137, 262
- Add HAProxy / PFSense bot blocking & IP forwarding guide (docs/haproxy-bot-blocking.md)
- Update version to 1.8.0 with release notes in version.php and guides
2026-07-29 14:26:48 +02:00
E.Noorlander 5884877f18 Add system update feature, git-ignore local configs, and fix homepage request logging
- Exclude config.json and admin.json in .gitignore so live settings/passwords are never overwritten by git
- Auto-generate config.json and admin.json with defaults if missing
- Add config.json.example and admin.json.example reference templates
- Add System Update page (/admin/update) in Admin Console to pull updates via Git with 1 click
- Log effective page name in index.php instead of literal 'auto'
- Add extra HAProxy/PFSense proxy headers to RequestLogger::getClientIp()
2026-07-28 17:26:34 +02:00
E.Noorlander 959f109f9e Fix public client IP extraction and hide duplicate footer creation date
- Enhance RequestLogger::getClientIp() with 2-pass detection prioritizing public IPs over proxy/internal IPs
- Hide footer creation date when identical to modification date to prevent duplicate date display
- Improve AdminAuth log helper and footer template tooltips
2026-07-28 17:11:00 +02:00
E.Noorlander f81be9e047 Fix newest homepage detection, file creation dates, real IP, and request log visitor type
- Fix detectNewestPage() to search subdirectories recursively and handle language prefixes
- Fix getFileInfo() to preserve frontmatter created date or ctime instead of overwriting with mtime
- Automatically store created date in frontmatter when creating/editing files
- Add RequestLogger::getClientIp() with proxy and Cloudflare header support
- Replace domain column in request log with visitor/bot type badges (Human, AI, Search, Scraper)
- Update 'Activiteitenlog' to 'Activiteiten log' in UI and guide
2026-07-28 16:56:51 +02:00
E.Noorlander b8d4a4e6d5 Nieuwste pagina-optie toegevoegd aan startpagina config 2026-07-28 16:37:10 +02:00
E.Noorlander b203f6d12a Fix unreachable index page and duplicate homepage entry in navigation
buildUrl() hardcoded 'index' as the homepage, so the menu link for
index.md pointed at /nl. With a different default_page that root URL
served another page, making index.md unreachable.

- Add getEffectiveDefaultPage(): resolves 'auto' to the detected page
  and caches the result
- buildUrl() now omits the page segment only for the effective default
  page instead of the literal string 'index'
- Route getPage(), generateBreadcrumb(), getContentType() and the
  render() template data (default_page, homepage, is_homepage,
  home_active_class, current_page, lang switch URLs) through it
- getHomepageTitle() returns t('home') so the home button no longer
  duplicates a menu item label
- Drop the now-redundant default_page skip in renderMenu() so every
  page stays reachable from the menu
- getAllContentDirs() also skips dot-directories (.git) in the move
  dropdown
2026-07-28 16:09:44 +02:00
E.Noorlander 2faea90872 Version 1.7.1 — auto default_page detection
- config.json now has default_page: auto for fresh installs
- CodePressCMS::detectDefaultPage() scans content/ for first available file
- getHomepageTitle() also respects auto mode
- Admin config form preserves auto as selectable option
- Save handler falls back to auto instead of index
2026-07-28 15:39:12 +02:00
E.Noorlander 8b454cd038 Remove v prefix from version display, fix router default_page 2026-07-28 15:18:17 +02:00
E.Noorlander 74487d4820 Show CMS version text in footer, enable version display 2026-07-28 15:11:21 +02:00
E.Noorlander 99a4c20e97 Add request log to dashboard, update guides with logging docs 2026-07-28 14:59:18 +02:00
E.Noorlander 28c8e895c5 Fix RequestLoader autoload + trim bot list 2026-07-28 14:53:41 +02:00
E.Noorlander df8394b057 Add request logging, bot blocking, and admin log viewer 2026-07-28 14:51:55 +02:00
E.Noorlander 13dd72d14d Show CodePress version and OS in admin site info 2026-07-28 14:47:49 +02:00
E.Noorlander baf8f56878 Add docblocks to ContentAPI and handleGuide 2026-07-28 14:40:55 +02:00
E.Noorlander a162fd9614 Bump version to 1.7.0
- Version 1.7.0 'API' with Content API, admin guide page, anchor link fixes, code block styling
2026-07-28 14:37:52 +02:00
E.Noorlander 0dc7b15fcf Fix guide deep links, code block styling
- Move heading IDs from hidden permalink anchors to parent headings so deep links scroll correctly (admin.php)
- Change code block background from dark to light gray (guide.php)
- Add pre/code CSS to frontend layout.mustache for visible code blocks
2026-07-28 14:37:14 +02:00
E.Noorlander 596b745bad Inhoudsopgave toegevoegd aan handleidingen met HeadingPermalinkExtension
- Nederlandse en Engelse handleiding hebben nu een inhoudsopgave
  met anchors naar alle hoofdstukken op dezelfde pagina
- HeadingPermalinkExtension toegevoegd aan CommonMark configuratie
  voor zowel frontend als admin markdown parsers
- Heading IDs gegenereerd voor elk kopje (## en lager)
2026-07-28 14:13:03 +02:00
E.Noorlander 024328c871 Fix admin guide: laad Composer autoloader voor CommonMark markdown render 2026-07-28 14:10:35 +02:00
E.Noorlander f8be943550 ContentAPI voor PHP content bestanden + handleiding in admin
- Nieuwe ContentAPI class beschikbaar als $api in PHP content bestanden
  met methodes: getAllPages, getPage, getMenu, getConfig, buildUrl, etc.
- Admin handleiding pagina op /admin/guide met taalwisselaar
- Zijbalk link naar handleiding in admin menu
- Dubbele alert in config pagina verwijderd
- Handleidingen (nl/en) uitgebreid met Content API referentie
2026-07-28 13:59:32 +02:00
E.Noorlander f72d7e7b01 Vervang raw JSON config editor door instellingenformulier met default_page dropdown
- Admin config pagina is nu een formulier met secties voor algemeen, taal,
  SEO, auteur en features
- Startpagina instelbaar via dropdown met beschikbare pagina's uit content/
- Handleiding (nl/en) bijgewerkt met nieuwe configuratie-instructies
2026-07-28 13:49:33 +02:00
E.Noorlander 2fdf90519a Fix auto-link nested <a> tag protection and add feature flag check 2026-07-21 13:46:54 +02:00
E.Noorlander e80967f0fe Fix plugin security, hooks system, and admin features
- Add plugin allowlist (enabled_plugins in config.json)
- Add enable/disable toggle in admin (separate from visibility)
- Add plugin hooks system (actions + filters with auto-registration)
- Fix autoLinkPageTitles nested <a> tag vulnerability
- Move MQTT credentials to environment variables
- Preserve current page in language switcher
- Fix ctime/birthtime for file creation date
- Deduplicate getGuidePage() CommonMark setup
- Simplify formatDisplayName() logic
- Add admin activity log to dashboard
- Add own password change with current password verification
- Apply theme header_color to admin sidebar
- Add content preview button in editor
2026-07-21 13:42:32 +02:00
E.Noorlander eb8064bfbc Add custom image size syntax for Markdown files
Support ![alt](url){:width="300" height="200"} syntax in .md files
to set image dimensions via attributes inside {: :}
2026-07-21 13:16:33 +02:00
E.Noorlander 2244fcbee2 Fix auto-link URLs: prevent double language prefix from relative link conversion 2026-07-21 13:00:24 +02:00
E.Noorlander 064e905f31 Fix admin form actions and redirects: replace & with ? for query parameters 2026-07-21 12:45:58 +02:00
E.Noorlander 0ccd89824f Fix version number in project structure code block in guides 2026-07-14 15:42:25 +02:00
E.Noorlander 5db721c2c3 Update version to 1.6.0 and refresh guides with clean URLs 2026-07-14 15:39:34 +02:00
E.Noorlander c244514a48 Clean URLs and security improvements
- Add .htaccess rewrite rules for clean URLs (/nl/page, /admin/route)
- Add PHP dev server router with clean URL support
- Update admin template asset paths to absolute for clean URL compat
- All pentest fixes verified: CSRF on login, directory listing disabled,
  secure cookies, backup/sourcemap files removed, version disclosure off
2026-07-14 15:28:53 +02:00
E.Noorlander 98f74b2861 Fix public/.htaccess: php uit FilesMatch (blokkeerde alle php inclusief index.php) 2026-07-14 14:55:24 +02:00
E.Noorlander 6272538875 Fix public/.htaccess: verwijder <Directory> blok (niet toegestaan in .htaccess) 2026-07-14 14:46:42 +02:00
E.Noorlander d5bd0097ff Security fixes n.a.v. pentest op noorlander.info
- CSRF token toegevoegd aan admin login formulier
- Directory listing uitgeschakeld (Options -Indexes)
- Secure/SameSite=Strict cookie verbeterd in AdminAuth
- app.js.backup en source maps verwijderd
- Version disclosure configureerbaar via config.json
- .map en backup extensies geblokkeerd in .htaccess
2026-07-14 14:25:04 +02:00
E.Noorlander e14f418e63 Bump version to 1.6.0, update docs and guides to match current project state
- version.php: 1.5.0 → 1.6.0 + changelog for media browser, editor,
  theme management, content move/rename, /-media/ prefix
- README.md/README.en.md: complete rewrite with current project structure,
  config format, admin features, CodeMirror, themes, quick start
- guide/nl.codepress.md, guide/en.codepress.md: comprehensive update
  matching all current admin routes, features, and project layout
- TODO.md: compiled from docs/TODO.md with completed/future items
2026-06-24 17:15:14 +02:00
E.Noorlander dc0d370e65 Media browser: recursive scan entire content/ tree, /-media/ URL prefix, editor change detection fix
- handleMediaList() now scans content/ recursively for all media files
- URLs use /-media/ prefix mapping directly to content/ (no special cases)
- index.php: added /-media/ route, kept /-assets/ for backward compat
- editor-toolbar.js: fixed editor.on('change') placement (was inside switchMode)
- content-edit.php and content-new.php: back-btn unsaved-changes detection
- Removed unused __editorCleanup global
2026-06-24 17:00:59 +02:00
E.Noorlander d97c67c6a9 Remove media menu option and verify route handling 2026-06-23 16:20:29 +02:00
E.Noorlander f5d95fd344 Merge development into main - Admin console, security fixes, sidebar toggle
# Conflicts:
#	engine/templates/layout.mustache
#	public/assets/js/app.js
2026-02-16 17:16:01 +01:00
E.Noorlander 7728336fa3 Update TODO.md with admin features roadmap and AGENTS.md with current project state
TODO.md: Add Markdown editor, plugin enable/disable, plugin API,
file uploads, map management, activity log, and more admin features.
Remove resolved items (extract/AuthController/CSRF - replaced by new admin).
AGENTS.md: Document full project structure including admin-console,
add AI model info (claude-opus-4-6), admin routing, security practices.
2026-02-16 17:12:45 +01:00
E.Noorlander 8e18a5d87a Add admin console with login, dashboard, content/config/plugin/user management
File-based admin panel accessible at /admin.php with:
- Session-based auth with bcrypt hashing and brute-force protection
- Dashboard with site statistics and quick actions
- Content manager: browse, create, edit, delete files
- Config editor with JSON validation
- Plugin overview with status indicators
- User management: add, remove, change passwords
- CSRF protection on all forms, path traversal prevention
- Updated README (NL/EN) and guides with admin documentation
2026-02-16 17:01:02 +01:00
75 changed files with 1325 additions and 10383 deletions
+3 -2
View File
@@ -4,7 +4,7 @@
A lightweight, file-based content management system built with PHP (≥8.0). A lightweight, file-based content management system built with PHP (≥8.0).
**Version:** 2.6.5 | **License:** AGPL v3 / Commercial **Version:** 2.6.1 | **License:** AGPL v3 / Commercial
## ✨ Features ## ✨ Features
@@ -55,9 +55,10 @@ composer install
```bash ```bash
cp config.json.example config.json cp config.json.example config.json
cp admin/config/admin.json.example admin/config/admin.json
``` ```
Edit `config.json` with your site title, language and plugins. On the first visit to `/admin`, `admin/config/admin.json` is created automatically with a random password that is shown on the login screen. Save this password safely and change it immediately after login. Edit `config.json` with your site title, language and plugins. Change the admin password in `admin/config/admin.json` (default `admin`/`admin`).
### Step 3a — Apache 2.4+ ### Step 3a — Apache 2.4+
+3 -2
View File
@@ -4,7 +4,7 @@
Een lichtgewicht, file-based content management systeem gebouwd met PHP (≥8.0). Een lichtgewicht, file-based content management systeem gebouwd met PHP (≥8.0).
**Versie:** 2.6.5 | **Licentie:** AGPL v3 / Commercial **Versie:** 2.6.1 | **Licentie:** AGPL v3 / Commercial
## ✨ Features ## ✨ Features
@@ -55,9 +55,10 @@ composer install
```bash ```bash
cp config.json.example config.json cp config.json.example config.json
cp admin/config/admin.json.example admin/config/admin.json
``` ```
Pas `config.json` aan met je site titel, taal en plugins. Bij de eerste keer dat je `/admin` opent wordt `admin/config/admin.json` automatisch aangemaakt met een willekeurig wachtwoord dat op het inlogscherm wordt getoond. Sla dit wachtwoord veilig op en wijzig het direct na login. Pas `config.json` aan met je site titel, taal en plugins. Wijzig het admin wachtwoord in `admin/config/admin.json` (standaard `admin`/`admin`).
### Stap 3a — Apache 2.4+ ### Stap 3a — Apache 2.4+
+18 -63
View File
@@ -1,17 +1,25 @@
# TODO # TODO
## Voor elke versie verhoging. Deze nooit weghalen.
- [x] Pentest controles uitgevoerd
- [x] WCAG 2.1 AA accessibility tests
- [x] Volledige git commit maken.
- [x] Verslag maken voor opdrcht gever
- [x] Na convormatie versie verhogen
- [x] Bij Voltooid versie ophoging aanmaken en deze allemaal unvinken voor volgende ronde.
## Voltooid ✅ ## Bug fixes
- [x] admin rollen werkt niet goed, dashboard geeft een 404, de plugin's moeten aangege welke rol nodig is.
- [x] user admin mag nooit zijn eigen rol weizigen.
- [x] Na in loggen moet de admin zijn rol binnen de /admin kunnen veranderen om andere rollen te kunnen testen
- [x] in een andere rol kan de gebruiker niet zijn eigen wachtwoord veranderen.
- [x] Bij het aanmaken van een pagina in de content moet de auteur naam en email in de meta komen te staan. Deze moeten dus ook door middel van de api aan de twig bestanden doorgeven kunnen worden
- [x] Admin taal niet volledig geïntegreerd met plugins: plugins hebben nu eigen language/ mappen (nl/en). Systeem plugins volgen admin taal (admin.php), content plugins volgen content taal (site.php). Fallback chain: geselecteerd → plugin default_language → CMS default → leeg. PluginManager + AdminPluginAPI + CMSAPI uitgebreid met getPluginTranslations()/t(). plugin.json settings ondersteunen label_key/help_key/option_label_key.
- [x] Plugin uniformiteit: alle 6 plugins hebben nu een uniforme structuur (<Plugin>.php, plugin.json, README.md, assets/.gitkeep, language/nl|en/). plugins/README.md herschreven. guide plugin-development.md (NL+EN) volledig bijgewerkt met i18n + admin integratie + instellingen-schema. guide architectuur.md (NL+EN) bijgewerkt met plugin language/ map.
- [x] Plugin editor toont alleen de <Plugin>.php maar een plugin kan uit meerdere bestanden bestaan: plugins-edit pagina heeft nu een bestandsbrowser zijbalk die alle bestanden in de plugin-map toont (.php, .json, .md, .html, .css, .scss, .js) inclusief language/ en assets/ submappen. Nieuw-bestand knop met modal. Path-traversal bescherming via realpath + prefix check + segment-guard. scanPluginFiles() helper toegevoegd. editor-toolbar.js modeMap uitgebreid voor css/scss/js/json. Vertaalstrings toegevoegd aan nl/en/de admin.php.
- [x] Plugin editor uploaden en verwijderen: plugins-edit pagina heeft nu een Upload knop (bestanden naar assets/ van de plugin) en per-bestand verwijder-knop in de bestandsboom. Twee nieuwe routes: plugins-file-upload en plugins-file-delete. Path-traversal bescherming + protected plugins geblokkeerd + dotfiles geweigerd. Vertaalstrings toegevoegd.
- [x] Plugin editor bestand verplaatsen: plugins-edit pagina heeft nu per-bestand een verplaats-knop in de bestandsboom. Nieuwe route plugins-file-move + template plugins-move-form.twig (dropdown met mappen binnen de plugin, plugin root als optie, huidige map uitgesloten). Path-traversal bescherming + protected plugins geblokkeerd.
- [x] diep link werken niet goed. Pagina titels worden wel herkend maar de gegenereerde link werken niet. — processContent() herschreef geldige /<lang>/<page> URLs naar /-media/ (404). Skip-regex uitgebreid met dynamische taal-prefixen via getAvailableLanguages().
- [x] De tree van de admin/content admin/theme en admin/plugin
- [x] Mappen en bestanden moeten kunnen worden versleept kunnen worden om te verplaatsen. — Drag-and-drop via tree-interactions.js + uniform AJAX move endpoint (/admin/tree-move) voor alle drie de scopes.
- [x] Ik moet in de tree ook een bestand/map kunnen selecteren
- [x] om te kunnen editen — klik op bestand opent editor, klik op map opent map-detail paneel
- [x] verwijderen — prullenbak-knop per bestand in tree + verwijder-knop per map in map-detail paneel
- [x] op deze plaats een nieuwe map/bestand te kunnen maken — per-map actie-knoppen in tree (nieuw bestand, nieuwe map) + knoppen in map-detail paneel
- [x] verplaatsen — drag-and-drop + potlood-knop per bestand (verplaats-formulier)
- [x] Alle tree's moeten op de zelfde manier kunnen werken — _file-tree.twig is uniform: alle drie de trees hebben treeDirActions, treeDirSelectRoute, drag-drop, per-node actie-knoppen, map-detail paneel. Nieuwe routes: theme-dir-create-in/rename-in/delete-in, plugins-dir-create-in/rename-in/delete-in, tree-move.
## Nice to have ## Nice to have
- [ ] Multidomein implementeren (elk domein = eigen thema + content, één admin + site name) - [ ] Multidomein implementeren (elk domein = eigen thema + content, één admin + site name)
@@ -37,19 +45,6 @@
- [ ] AGENTS.md + config.json.example bijwerken - [ ] AGENTS.md + config.json.example bijwerken
- [ ] Verificatie: php -l, curl met Host-header, domein-switch in admin testen - [ ] Verificatie: php -l, curl met Host-header, domein-switch in admin testen
## v2.6.5 (2026-08-27) ✅
- [x] Bug: dashboard toonde 0 content (AdminPluginAPI::getContentDir() gaf relatief pad "content" terug zonder normalisatie tegen project-root; Apache CWD=public/ → 0 bestanden)
- [x] Dynamische pad-resolutie: PluginAPIInterface uitgebreid met getProjectRoot()/getContentDir()/getPluginsDir()/getVersionInfo(); CMSAPI en AdminPluginAPI implementeren deze nu universeel; Navigation plugin en Logs plugin halen paden via de API i.p.v. hardcoded dirname(__DIR__)
- [x] public/index.php media-/assets-serving gebruikt $config['content_dir'] i.p.v. hardcoded /content
- [x] WordPress-stijl docblocks toegevoegd voor alle classes, methods, properties en functies (~450 docblocks, @since 2.6.5)
- [x] Security: hardcoded plaintext-wachtwoord 'admin' verwijderd uit AdminAuth.php; bij eerste installatie wordt een cryptografisch veilig wachtwoord gegenereerd (random_bytes, 16 tekens) en eenmalig op het inlogscherm getoond
- [x] Security: git-geschiedenis schoongemaakt — admin/config/admin.json, admin/config/admin.json.example en admin-console/config/admin.json verwijderd uit alle commits (bevatten kraakbare bcrypt-hashes naar 'admin'); filter-branch over alle branches + 10 tags, reflog expired, gc --prune --aggressive
- [x] README.md, README.en.md, AGENTS.md bijgewerkt (admin.json.example referenties verwijderd, inlog-instructies herschreven)
## v2.6.4 (2026-08-26) ✅
- [x] Bug: diep link werken niet goed — processContent() herschreef geldige /<lang>/<page> URLs naar /-media/ (404); skip-regex dynamisch uitgebreid met getAvailableLanguages()
- [x] Bug: uniforme tree met drag-and-drop voor admin/content, admin/theme, admin/plugin — tree-interactions.js (drag-drop + per-node actie-knoppen), uniform AJAX move endpoint (/admin/tree-move), map-detail paneel voor alle drie de scopes, theme/plugin dir create/rename/delete routes, handleidingen bijgewerkt
## Voltooid ✅ ## Voltooid ✅
- [x] Admin code en niet gebruikte mappen/bestanden opschonen - [x] Admin code en niet gebruikte mappen/bestanden opschonen
@@ -66,34 +61,6 @@
- [x] Pentest controles uitgevoerd (30/30 tests geslaagd — 0 vulnerabilities) - [x] Pentest controles uitgevoerd (30/30 tests geslaagd — 0 vulnerabilities)
- [x] WCAG 2.1 AA accessibility tests (25/25 tests geslaagd — 100% compliance, test-script verbeterd met min/max checks en grep -E) - [x] WCAG 2.1 AA accessibility tests (25/25 tests geslaagd — 100% compliance, test-script verbeterd met min/max checks en grep -E)
## v2.6.3 (2026-08-20) ✅
- [x] Content bestanden met dezelfde naam maar ander type (md/php/html) worden door de frontend correct geserveerd: URL met extensie opent dat specifieke bestand, URL zonder extensie valt terug op md > php > html prioriteit (resolveContentByType helper)
- [x] Admin content editor accepteert bestanden met dezelfde naam (ander type); "bestaat al" check is per extensie, melding verduidelijkt naar "Bestand met dit type bestaat al."
- [x] Admin content editor preview-knop linkt per extensie (test.php → /nl/test.php) zodat elk type individueel te bekijken blijft
- [x] Frontend navigatie, directory listing en search tonen elk bestandstype apart (extensie behouden in URL), geen samenvoeging meer
- [x] getAllPages() array structuur gewijzigd naar list van ['path' => ..., 'title' => ..., 'type' => ...] met type 'md'/'php'/'html'/'folder'; mappen krijgen eigen entry, bestanden met dezelfde naam botsen niet meer
- [x] Verberg-prefix logica gewijzigd: `_` is geen verberg-prefix meer, alleen `.` (en `-`) verbergen aan de frontend; admin toont wél alle `.` bestanden/mappen (.bak, .map) — scanEditorFilesNode content-scope toont dotfiles behalve .git/.gitkeep
- [x] ContentAPI getPage()/pageExists() respecteren expliciete extensie in $path
- [x] autoLinkPageTitles() aangepast aan nieuwe array structuur, slaat mappen over
- [x] Handleiding content-api.md (NL+EN) herschreven: echo/return mechanisme, beschikbare variabelen, nieuwe getAllPages() structuur met voorbeelden
- [x] Versie verhoogd naar 2.6.3
## v2.6.2 (2026-08-19) ✅
- [x] Pentest controles uitgevoerd (30/30)
- [x] WCAG 2.1 AA accessibility tests (25/25)
- [x] Thema editor (thema's net zo bewerkbaar maken als plugins): bestandsbrowser zijbalk, nieuw bestand, uploaden, verwijderen, verplaatsen, SCSS compileren vanuit editor, thema activeren/verwijderen, nieuw thema met basis-kopie, uniforme thema-structuur
- [x] Content editor (content consistent met plugins en thema's): bestandsbrowser zijbalk nu op /admin/content (vervangt tabelweergave), nieuw bestand/map, uploaden, verwijderen, verplaatsen, mappen beheer, layout/plugins selectie, git/backup integratie in editor zijbalk; oude tabelweergave verhuisd naar /admin/content-list
- [x] Uniformiteit: scanEditorFiles() unified scanner (scanPluginFiles/scanThemeFiles/scanContentFiles als dunne wrappers)
- [x] Media invoegen in editor: ?theme= scope voor media-list endpoint + _media-modal.twig
- [x] Bug: thema-naam niet overgenomen bij kopiëren — title in theme.json wordt overschreven met nieuwe themanaam; README.md krijgt nieuwe header
- [x] Bug: mappen met `_` prefix zichtbaar in frontend navigatie — scanDirectory/searchInDirectory/scanForPageTitles skippen nu `_` prefix (consistente filtering met `.` en `-`)
- [x] Bug: images in markdown niet weergegeven — processContent() herschrijft lokale image/link URLs naar /-media/ endpoint (relatief, /content/, subdir, custom-grootte syntax); externe URLs ongewijzigd gelaten
- [x] UX: /admin/content is nu de boom-editor (plugin-file-tree structuur); oude tabelweergave op /admin/content-list met "Boom weergave"/"Lijst weergave" knoppen
- [x] UX: image-grootte knop in editor-toolbar (markdown) — selecteer ![alt](url), klik knop, breedte/hoogte dialog, {:width=... height=...} syntax toevoegen/vervangen
- [x] Handleidingen in guide/ bijgewerkt (thema-beheer.md NL+EN volledig herschreven met thema-editor uitleg; content-beheer.md NL+EN volledig herschreven met content-editor uitleg)
- [x] Verslag gemaakt (docs/release-notes/v2.6.2.md)
- [x] Versie verhoogd naar 2.6.2
## v2.6.1d (2026-08-18) ✅ ## v2.6.1d (2026-08-18) ✅
- [x] Pentest controles uitgevoerd (30/30) - [x] Pentest controles uitgevoerd (30/30)
- [x] WCAG 2.1 AA accessibility tests (25/25) - [x] WCAG 2.1 AA accessibility tests (25/25)
@@ -103,13 +70,6 @@
- [x] Media invoegen in editor: nieuw /admin/media-list JSON endpoint + herbruikbare _media-modal.twig include; plugin-context scant assets/ map - [x] Media invoegen in editor: nieuw /admin/media-list JSON endpoint + herbruikbare _media-modal.twig include; plugin-context scant assets/ map
- [x] Plugin overzicht knoppen: alleen iconen met title/aria-label - [x] Plugin overzicht knoppen: alleen iconen met title/aria-label
- [x] README.md en handleidingen in guide/ doorgeloken en bijgewerkt (plugin-development.md NL+EN volledig herschreven, architectuur.md NL+EN bijgewerkt) - [x] README.md en handleidingen in guide/ doorgeloken en bijgewerkt (plugin-development.md NL+EN volledig herschreven, architectuur.md NL+EN bijgewerkt)
- [x] Bug: admin taal niet volledig geïntegreerd met plugins — plugins hebben nu eigen language/ mappen (nl/en), systeem plugins volgen admin taal (admin.php), content plugins volgen content taal (site.php), fallback chain, PluginManager + AdminPluginAPI + CMSAPI uitgebreid met getPluginTranslations()/t(), plugin.json settings ondersteunen label_key/help_key/option_label_key
- [x] Bug: plugin uniformiteit — alle 6 plugins hebben nu een uniforme structuur (<Plugin>.php, plugin.json, README.md, assets/.gitkeep, language/nl|en/), plugins/README.md herschreven, guide plugin-development.md (NL+EN) volledig bijgewerkt, guide architectuur.md (NL+EN) bijgewerkt
- [x] Bug: plugin editor toont alleen de <Plugin>.php maar een plugin kan uit meerdere bestanden bestaan — plugins-edit pagina heeft nu een bestandsbrowser zijbalk die alle bestanden in de plugin-map toont (.php, .json, .md, .html, .css, .scss, .js) inclusief language/ en assets/ submappen, nieuw-bestand knop met modal, path-traversal bescherming, scanPluginFiles() helper, editor-toolbar.js modeMap uitgebreid
- [x] Bug: plugin editor uploaden en verwijderen — plugins-edit pagina heeft nu een Upload knop (bestanden naar assets/ van de plugin) en per-bestand verwijder-knop in de bestandsboom, twee nieuwe routes (plugins-file-upload, plugins-file-delete), path-traversal bescherming + protected plugins geblokkeerd + dotfiles geweigerd
- [x] Bug: plugin editor bestand verplaatsen — plugins-edit pagina heeft nu per-bestand een verplaats-knop in de bestandsboom, nieuwe route plugins-file-move + template plugins-move-form.twig, path-traversal bescherming + protected plugins geblokkeerd
- [x] Bug: media-knop in editor werkte niet — #mediaModal bestond niet, opgelost via nieuw /admin/media-list JSON endpoint + herbruikbare _media-modal.twig include
- [x] Bug: plugin-kaart knoppen tekst liep niet goed — teksten verwijderd, alleen iconen met title/aria-label
- [x] Verslag gemaakt (docs/release-notes/v2.6.1d.md) - [x] Verslag gemaakt (docs/release-notes/v2.6.1d.md)
- [x] Versie verhoogd naar 2.6.1d - [x] Versie verhoogd naar 2.6.1d
@@ -119,11 +79,6 @@
- [x] README.md en handleidingen in guide/ doorgeloken en bijgewerkt - [x] README.md en handleidingen in guide/ doorgeloken en bijgewerkt
- [x] Admin gebruikersbeheer opnieuw ontworpen (lijst + zoeken/filter + profiel + wachtwoord) - [x] Admin gebruikersbeheer opnieuw ontworpen (lijst + zoeken/filter + profiel + wachtwoord)
- [x] CLI commando voor admin wachtwoord reset (cli/reset-admin-password.php) - [x] CLI commando voor admin wachtwoord reset (cli/reset-admin-password.php)
- [x] Bug: admin rollen werkt niet goed, dashboard geeft een 404, de plugin's moeten aangeven welke rol nodig is
- [x] Bug: user admin mag nooit zijn eigen rol wijzigen
- [x] Bug: na inloggen moet de admin zijn rol binnen de /admin kunnen veranderen om andere rollen te kunnen testen
- [x] Bug: in een andere rol kan de gebruiker niet zijn eigen wachtwoord veranderen
- [x] Bug: bij het aanmaken van een pagina in de content moet de auteur naam en email in de meta komen te staan (door middel van de api aan de twig bestanden doorgeven)
- [x] Verslag gemaakt (docs/release-notes/v2.6.1c.md) - [x] Verslag gemaakt (docs/release-notes/v2.6.1c.md)
- [x] Versie verhoogd naar 2.6.1c - [x] Versie verhoogd naar 2.6.1c
+21
View File
@@ -0,0 +1,21 @@
{
"users": [
{
"username": "admin",
"password_hash": "$2y$12$CV2uORTIiie6s3jf9ANaneL7VLNqA5smXyrIzkcJFjlS2Vxfw1/HK",
"role": "admin",
"email": "",
"author_name": "",
"author_email": "",
"created": "2025-01-01"
}
],
"security": {
"session_timeout": 1800,
"max_login_attempts": 5,
"lockout_duration": 900
},
"config": {
"default_page": "auto"
}
}
+22 -423
View File
@@ -1,73 +1,28 @@
<?php <?php
/** /**
* File-based authenticatie en autorisatie voor het CodePress admin paneel. * AdminAuth - File-based authentication for CodePress Admin
*
* Beheert gebruikerssessies, rollen met permissies, CSRF-tokens, brute-force
* lockout en gebruikersbeheer. Alle data wordt opgeslagen in JSON-bestanden
* (geen database).
*
* @since 2.6.5
*/ */
class AdminAuth class AdminAuth
{ {
/**
* Applicatie-configuratie uit config.json.
*
* @since 2.6.5
* @var array Applicatie-configuratie.
*/
private array $config; private array $config;
/**
* Admin-configuratie geladen uit admin.json (gebruikers en security-instellingen).
*
* @since 2.6.5
* @var array Admin-configuratie met keys 'users' en 'security'.
*/
private array $adminConfig; private array $adminConfig;
/**
* Pad naar het JSON-bestand met mislukte inlogpogingen voor brute-force lockout.
*
* @since 2.6.5
* @var string Absoluut pad naar login_attempts.json.
*/
private string $lockFile; private string $lockFile;
/** /**
* Tijdelijk gegenereerd wachtwoord bij eerste installatie. * Role definitions with permissions.
* * Each role maps to a list of allowed route prefixes.
* Wordt gevuld wanneer loadAdminConfig() een nieuwe admin.json aanmaakt * 'admin' has wildcard '*' access.
* met een cryptografisch veilig willekeurig wachtwoord. De login-pagina
* toont dit wachtwoord eenmalig via getGeneratedPassword().
*
* @since 2.6.5
* @var string Leeg tenzij net aangemaakt bij eerste installatie.
*/
private string $generatedPassword = '';
/**
* Permissies per rol.
*
* Elke rol mapt naar een lijst van toegestane route-prefixen. De rol
* 'admin' heeft wildcard '*' toegang tot alle routes.
*
* @since 2.6.5
* @var array<string, string[]> Map van rol-sleutel naar lijst met toegestane routes.
*/ */
public const ROLE_PERMISSIONS = [ public const ROLE_PERMISSIONS = [
'admin' => ['*'], 'admin' => ['*'],
'content-manager' => ['dashboard', 'content', 'content-list', 'content-files', 'content-edit', 'content-new', 'content-delete', 'content-file-upload', 'content-file-delete', 'content-file-move', 'content-dir-create', 'content-dir-create-in', 'content-dir-rename', 'content-dir-rename-in', 'content-dir-delete', 'content-dir-delete-in', 'content-move', 'content-backup', 'content-restore', 'content-git-init', 'content-git-commit', 'content-git-restore', 'guide', 'logout'], 'content-manager' => ['dashboard', 'content', 'content-edit', 'content-new', 'content-delete', 'content-dir-create', 'content-dir-rename', 'content-dir-delete', 'content-move', 'content-backup', 'content-restore', 'content-git-init', 'content-git-commit', 'content-git-restore', 'guide', 'logout'],
'bi-manager' => ['dashboard', 'statistics', 'logs', 'guide', 'logout'], 'bi-manager' => ['dashboard', 'statistics', 'logs', 'guide', 'logout'],
'site-admin' => ['dashboard', 'theme', 'theme-new', 'theme-edit', 'theme-file-upload', 'theme-file-delete', 'theme-file-move', 'theme-activate', 'theme-delete', 'theme-scss', 'plugins', 'plugins-new', 'plugins-edit', 'plugins-config', 'plugins-toggle', 'plugins-delete', 'statistics', 'logs', 'update', 'guide', 'logout'], 'site-admin' => ['dashboard', 'theme', 'theme-new', 'plugins', 'plugins-new', 'plugins-edit', 'plugins-config', 'plugins-toggle', 'plugins-delete', 'statistics', 'logs', 'update', 'guide', 'logout'],
]; ];
/** /**
* Leesbare rol-labels voor weergave in de admin-interface. * Human-readable role labels.
*
* @since 2.6.5
* @var array<string, string> Map van rol-sleutel naar label.
*/ */
public const ROLE_LABELS = [ public const ROLE_LABELS = [
'admin' => 'Admin', 'admin' => 'Admin',
@@ -76,16 +31,6 @@ class AdminAuth
'site-admin' => 'Site Admin', 'site-admin' => 'Site Admin',
]; ];
/**
* Constructor: initialiseer authenticatie met de applicatie-configuratie.
*
* Laadt de admin-configuratie, bepaalt het pad naar het lockout-bestand en
* start de sessie met de juiste security-instellingen.
*
* @since 2.6.5
*
* @param array $appConfig Applicatie-configuratie; vereist keys 'log_file' en 'admin_config'.
*/
public function __construct(array $appConfig) public function __construct(array $appConfig)
{ {
$this->config = $appConfig; $this->config = $appConfig;
@@ -94,17 +39,6 @@ class AdminAuth
$this->startSession(); $this->startSession();
} }
/**
* Laadt de admin-configuratie uit admin.json.
*
* Als het bestand nog niet bestaat wordt het aangemaakt vanuit
* admin.json.example, of indien die ook ontbreekt met een standaard admin-
* gebruiker. Geeft een lege structuur terug als de JSON ongeldig is.
*
* @since 2.6.5
*
* @return array Admin-configuratie met keys 'users' en 'security'.
*/
private function loadAdminConfig(): array private function loadAdminConfig(): array
{ {
$path = $this->config['admin_config']; $path = $this->config['admin_config'];
@@ -114,19 +48,11 @@ class AdminAuth
if (file_exists($examplePath)) { if (file_exists($examplePath)) {
@copy($examplePath, $path); @copy($examplePath, $path);
} else { } else {
// Genereer een cryptografisch veilig wachtwoord bij eerste
// installatie. Het wachtwoord wordt nooit in de broncode
// opgeslagen; de hash wordt weggeschreven naar admin.json
// en het plaintext wachtwoord éénmalig getoond op het
// inlogscherm via getGeneratedPassword().
$plainPassword = $this->generateRandomPassword();
$this->generatedPassword = $plainPassword;
$defaultAdminConfig = [ $defaultAdminConfig = [
'users' => [ 'users' => [
[ [
'username' => 'admin', 'username' => 'admin',
'password_hash' => password_hash($plainPassword, PASSWORD_BCRYPT), 'password_hash' => password_hash('admin', PASSWORD_BCRYPT),
'role' => 'admin', 'role' => 'admin',
'created' => date('Y-m-d'), 'created' => date('Y-m-d'),
] ]
@@ -148,55 +74,6 @@ class AdminAuth
return is_array($data) ? $data : ['users' => [], 'security' => []]; return is_array($data) ? $data : ['users' => [], 'security' => []];
} }
/**
* Genereer een cryptografisch veilig willekeurig wachtwoord.
*
* Gebruik random_bytes() (CSPRNG) met een mix van alfanumerieke tekens
* en een vaste lengte, zodat het wachtwoord voldoende entropie heeft
* en veilig te typen is.
*
* @since 2.6.5
*
* @return string Willekeurig wachtwoord van 16 alfanumerieke tekens.
*/
private function generateRandomPassword(int $length = 16): string
{
$alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
$max = strlen($alphabet) - 1;
$password = '';
for ($i = 0; $i < $length; $i++) {
$password .= $alphabet[random_int(0, $max)];
}
return $password;
}
/**
* Geef het bij eerste installatie gegenereerde wachtwoord terug.
*
* De login-pagina gebruikt dit om het wachtwoord eenmalig te tonen
* zodra admin.json is aangemaakt. Na de eerste succesvolle login
* wordt het veld geleegd. Geeft een lege string terug wanneer er
* geen nieuw wachtwoord is gegenereerd in deze request.
*
* @since 2.6.5
*
* @return string Plaintext wachtwoord of lege string.
*/
public function getGeneratedPassword(): string
{
return $this->generatedPassword;
}
/**
* Slaat de huidige admin-configuratie op naar admin.json.
*
* Schrijft de interne admin-configuratie weg als pretty-printed JSON met
* behoud van unicode-tekens.
*
* @since 2.6.5
*
* @return void
*/
public function saveAdminConfig(): void public function saveAdminConfig(): void
{ {
file_put_contents( file_put_contents(
@@ -205,17 +82,6 @@ class AdminAuth
); );
} }
/**
* Start de sessie met veilige cookie-parameters en handhaaft de session timeout.
*
* Stelt cookie-flags in (HttpOnly, SameSite=Strict, Secure bij HTTPS), start
* de sessie en beëindigt deze bij inactiviteit langer dan de geconfigureerde
* timeout. Vernieuwt de activiteit-timestamp bij geauthenticeerde gebruikers.
*
* @since 2.6.5
*
* @return void
*/
private function startSession(): void private function startSession(): void
{ {
if (session_status() === PHP_SESSION_NONE) { if (session_status() === PHP_SESSION_NONE) {
@@ -247,20 +113,6 @@ class AdminAuth
} }
} }
/**
* Verifieert inloggegevens en start een admin-sessie bij succes.
*
* Controleert eerst of het account niet is vergrendeld door brute-force
* protection. Bij een fout wachtwoord wordt een mislukte poging geregistreerd
* en gelogd. Bij succes worden mislukte pogingen gewist en de sessie
* gevuld met gebruiker, rol en CSRF-token.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @param string $password Wachtwoord (plaintext).
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/
public function login(string $username, string $password): array public function login(string $username, string $password): array
{ {
// Check brute-force lockout // Check brute-force lockout
@@ -293,16 +145,6 @@ class AdminAuth
return ['success' => true, 'message' => 'Ingelogd.']; return ['success' => true, 'message' => 'Ingelogd.'];
} }
/**
* Logt de huidige gebruiker uit en vernietigt de sessie.
*
* Maakt de sessie-array leeg, verwijdert het sessie-cookie en vernietigt de
* sessie. De uitlogactie wordt gelogd.
*
* @since 2.6.5
*
* @return void
*/
public function logout(): void public function logout(): void
{ {
$user = $_SESSION['admin_user'] ?? 'unknown'; $user = $_SESSION['admin_user'] ?? 'unknown';
@@ -318,28 +160,11 @@ class AdminAuth
$this->log('info', "Uitgelogd: {$user}"); $this->log('info', "Uitgelogd: {$user}");
} }
/**
* Controleert of de huidige bezoeker is ingelogd.
*
* @since 2.6.5
*
* @return bool True indien een admin-gebruiker in de sessie staat.
*/
public function isAuthenticated(): bool public function isAuthenticated(): bool
{ {
return isset($_SESSION['admin_user']); return isset($_SESSION['admin_user']);
} }
/**
* Geeft de gegevens van de ingelogde gebruiker, verrijkt met profielvelden.
*
* Levert username en rol uit de sessie en vult deze aan met email,
* author_name en author_email uit admin.json indien aanwezig.
*
* @since 2.6.5
*
* @return array|null Gebruikersdata als array, of null indien niet ingelogd.
*/
public function getCurrentUser(): ?array public function getCurrentUser(): ?array
{ {
if (!$this->isAuthenticated()) { if (!$this->isAuthenticated()) {
@@ -361,14 +186,8 @@ class AdminAuth
} }
/** /**
* Geeft de huidige rol van de ingelogde gebruiker. * Get the role of the current user.
* * Returns the override role if set (for testing), otherwise the real role.
* Retourneert de override-rol indien ingesteld (voor test-doeleinden), anders
* de werkelijke rol.
*
* @since 2.6.5
*
* @return string Rol-sleutel.
*/ */
public function getCurrentRole(): string public function getCurrentRole(): string
{ {
@@ -379,11 +198,7 @@ class AdminAuth
} }
/** /**
* Geeft de werkelijke rol van de ingelogde gebruiker, eventuele override negerend. * Get the real role of the current user (ignoring any override).
*
* @since 2.6.5
*
* @return string Rol-sleutel.
*/ */
public function getRealRole(): string public function getRealRole(): string
{ {
@@ -391,11 +206,7 @@ class AdminAuth
} }
/** /**
* Controleert of de ingelogde gebruiker een actieve rol-override heeft. * Check if the current user has an active role override.
*
* @since 2.6.5
*
* @return bool True indien een override-rol is ingesteld.
*/ */
public function hasRoleOverride(): bool public function hasRoleOverride(): bool
{ {
@@ -403,16 +214,8 @@ class AdminAuth
} }
/** /**
* Wisselt tijdelijk naar een andere rol voor test-doeleinden. * Temporarily switch to another role for testing purposes.
* * Only admin users can do this; the override cannot grant more than admin.
* Alleen werkelijke admins kunnen wisselen; admins kunnen niet wisselen naar
* 'admin' (zinloos) en enkel naar lagere rollen. Slaat de override op in de
* sessie. De actie wordt gelogd.
*
* @since 2.6.5
*
* @param string $role Doel-rol-sleutel.
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/ */
public function switchRole(string $role): array public function switchRole(string $role): array
{ {
@@ -437,13 +240,7 @@ class AdminAuth
} }
/** /**
* Reset de rol-override terug naar de werkelijke admin-rol. * Reset the role override back to the real admin role.
*
* Verwijdert de override uit de sessie indien aanwezig en logt de actie.
*
* @since 2.6.5
*
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/ */
public function resetRole(): array public function resetRole(): array
{ {
@@ -456,15 +253,7 @@ class AdminAuth
} }
/** /**
* Controleert of de huidige gebruiker een bepaalde route mag openen. * Check if the current user has permission to access a route.
*
* Gebruikt de permissies van de huidige rol; de wildcard '*' geeft toegang
* tot alles. Onbekende rollen krijgen enkel 'dashboard' en 'logout'.
*
* @since 2.6.5
*
* @param string $route Route-sleutel die gecontroleerd moet worden.
* @return bool True indien de gebruiker de route mag benaderen.
*/ */
public function hasPermission(string $route): bool public function hasPermission(string $route): bool
{ {
@@ -479,11 +268,7 @@ class AdminAuth
} }
/** /**
* Geeft alle beschikbare rollen met hun leesbare labels. * Get available roles.
*
* @since 2.6.5
*
* @return array<string, string> Map van rol-sleutel naar label.
*/ */
public static function getRoles(): array public static function getRoles(): array
{ {
@@ -491,28 +276,13 @@ class AdminAuth
} }
/** /**
* Geeft het leesbare label voor een rol. * Get role label.
*
* @since 2.6.5
*
* @param string $role Rol-sleutel.
* @return string Leesbaar label, of de rol-sleutel zelf indien onbekend.
*/ */
public static function getRoleLabel(string $role): string public static function getRoleLabel(string $role): string
{ {
return self::ROLE_LABELS[$role] ?? $role; return self::ROLE_LABELS[$role] ?? $role;
} }
/**
* Geeft het huidige CSRF-token, of genereert een nieuw token indien afwezig.
*
* Slaat een cryptografisch willekeurig token op in de sessie en retourneert
* dit voor gebruik in admin-formulieren.
*
* @since 2.6.5
*
* @return string 64-tekens hexadecimaal CSRF-token.
*/
public function getCsrfToken(): string public function getCsrfToken(): string
{ {
if (!isset($_SESSION['admin_csrf_token'])) { if (!isset($_SESSION['admin_csrf_token'])) {
@@ -521,31 +291,11 @@ class AdminAuth
return $_SESSION['admin_csrf_token']; return $_SESSION['admin_csrf_token'];
} }
/**
* Verifieert een meegegeven CSRF-token tegen het token in de sessie.
*
* Gebruikt hash_equals om timing-attacks te voorkomen.
*
* @since 2.6.5
*
* @param string $token Token uit het formulier of verzoek.
* @return bool True indien het token overeenkomt met het sessie-token.
*/
public function verifyCsrf(string $token): bool public function verifyCsrf(string $token): bool
{ {
return isset($_SESSION['admin_csrf_token']) && hash_equals($_SESSION['admin_csrf_token'], $token); return isset($_SESSION['admin_csrf_token']) && hash_equals($_SESSION['admin_csrf_token'], $token);
} }
/**
* Regeneert het CSRF-token in de sessie.
*
* Maakt een nieuw cryptografisch willekeurig token aan, nuttig na
* privilege-wijzigingen of na het verwerken van een formulier.
*
* @since 2.6.5
*
* @return void
*/
public function regenerateCsrfToken(): void public function regenerateCsrfToken(): void
{ {
$_SESSION['admin_csrf_token'] = bin2hex(random_bytes(32)); $_SESSION['admin_csrf_token'] = bin2hex(random_bytes(32));
@@ -553,16 +303,6 @@ class AdminAuth
// --- User Management --- // --- User Management ---
/**
* Geeft alle gebruikers met hun profiel- en rolinformatie.
*
* Levert een array geïndexeerd op gebruikersnaam, aangevuld met het
* leesbare rol-label en eventuele profielvelden.
*
* @since 2.6.5
*
* @return array<string, array> Map van gebruikersnaam naar gebruikersdata.
*/
public function getUsers(): array public function getUsers(): array
{ {
$users = []; $users = [];
@@ -581,23 +321,6 @@ class AdminAuth
return $users; return $users;
} }
/**
* Voegt een nieuwe gebruiker toe aan de admin-configuratie.
*
* Controleert op dubbele gebruikersnamen, minimum wachtwoordlengte (8) en
* geldigheid van de rol. Het wachtwoord wordt opgeslagen als bcrypt-hash.
* Wijzigingen worden direct weggeschreven en gelogd.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @param string $password Wachtwoord (plaintext, minimaal 8 tekens).
* @param string $role Rol-sleutel. Default 'admin'.
* @param string $email E-mailadres van de gebruiker. Default ''.
* @param string $authorName Naam voor auteur-metadata. Default ''.
* @param string $authorEmail E-mail voor auteur-metadata. Default ''.
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/
public function addUser(string $username, string $password, string $role = 'admin', string $email = '', string $authorName = '', string $authorEmail = ''): array public function addUser(string $username, string $password, string $role = 'admin', string $email = '', string $authorName = '', string $authorEmail = ''): array
{ {
if ($this->findUser($username)) { if ($this->findUser($username)) {
@@ -625,18 +348,7 @@ class AdminAuth
} }
/** /**
* Werkt de profielvelden (email, author_name, author_email) van een gebruiker bij. * Update the profile (email, author_name, author_email) of a user.
*
* Zoekt de gebruiker op naam en overschrijft de profielvelden, slaat de
* configuratie op en logt de wijziging.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @param string $email E-mailadres. Default ''.
* @param string $authorName Naam voor auteur-metadata. Default ''.
* @param string $authorEmail E-mail voor auteur-metadata. Default ''.
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/ */
public function updateUserProfile(string $username, string $email = '', string $authorName = '', string $authorEmail = ''): array public function updateUserProfile(string $username, string $email = '', string $authorName = '', string $authorEmail = ''): array
{ {
@@ -654,17 +366,8 @@ class AdminAuth
} }
/** /**
* Wijzigt de rol van een bestaande gebruiker. * Change the role of an existing user.
* * A user can never change their own role (security guard).
* Een gebruiker kan nooit zijn eigen rol wijzigen (security guard). De rol
* moet een bekende sleutel uit ROLE_PERMISSIONS zijn. Wijzigingen worden
* opgeslagen en gelogd.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @param string $role Nieuwe rol-sleutel.
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/ */
public function changeRole(string $username, string $role): array public function changeRole(string $username, string $role): array
{ {
@@ -685,17 +388,6 @@ class AdminAuth
return ['success' => false, 'message' => 'Gebruiker niet gevonden.']; return ['success' => false, 'message' => 'Gebruiker niet gevonden.'];
} }
/**
* Verwijdert een gebruiker uit de admin-configuratie.
*
* Een gebruiker kan zichzelf niet verwijderen. De gebruikerslijst wordt
* gefilterd, opgeslagen en de actie gelogd.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/
public function deleteUser(string $username): array public function deleteUser(string $username): array
{ {
if ($username === ($_SESSION['admin_user'] ?? '')) { if ($username === ($_SESSION['admin_user'] ?? '')) {
@@ -711,18 +403,6 @@ class AdminAuth
return ['success' => true, 'message' => 'Gebruiker verwijderd.']; return ['success' => true, 'message' => 'Gebruiker verwijderd.'];
} }
/**
* Zet een nieuw wachtwoord voor een gebruiker.
*
* Controleert de minimum wachtwoordlengte (8), hasht het wachtwoord met de
* standaard PHP-hash en slaat de wijziging op.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @param string $newPassword Nieuw wachtwoord (plaintext, minimaal 8 tekens).
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/
public function changePassword(string $username, string $newPassword): array public function changePassword(string $username, string $newPassword): array
{ {
if (strlen($newPassword) < 8) { if (strlen($newPassword) < 8) {
@@ -739,19 +419,6 @@ class AdminAuth
return ['success' => false, 'message' => 'Gebruiker niet gevonden.']; return ['success' => false, 'message' => 'Gebruiker niet gevonden.'];
} }
/**
* Wijzigt het eigen wachtwoord na verificatie van het huidige wachtwoord.
*
* Verifieert eerst het huidige wachtwoord tegen de opgeslagen hash, controleert
* de lengte van het nieuwe wachtwoord (minimaal 8) en slaat de nieuwe hash op.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @param string $currentPassword Huidig wachtwoord (plaintext).
* @param string $newPassword Nieuw wachtwoord (plaintext, minimaal 8 tekens).
* @return array Resultaat met keys 'success' (bool) en 'message' (string).
*/
public function changeOwnPassword(string $username, string $currentPassword, string $newPassword): array public function changeOwnPassword(string $username, string $currentPassword, string $newPassword): array
{ {
$user = $this->findUser($username); $user = $this->findUser($username);
@@ -777,14 +444,6 @@ class AdminAuth
// --- Private helpers --- // --- Private helpers ---
/**
* Zoekt een gebruiker op gebruikersnaam in de admin-configuratie.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @return array|null Gebruikersdata als array, of null indien niet gevonden.
*/
private function findUser(string $username): ?array private function findUser(string $username): ?array
{ {
foreach ($this->adminConfig['users'] ?? [] as $user) { foreach ($this->adminConfig['users'] ?? [] as $user) {
@@ -795,18 +454,6 @@ class AdminAuth
return null; return null;
} }
/**
* Controleert of een gebruiker momenteel is vergrendeld door brute-force protection.
*
* Vergelijkt het aantal mislukte pogingen en de verstreken tijd sinds de
* laatste poging met de geconfigureerde limieten. Verloopt de lockout dan
* worden de pogingen gewist.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @return array Resultaat met keys 'locked' (bool) en optioneel 'remaining' (int, seconden).
*/
private function checkLockout(string $username): array private function checkLockout(string $username): array
{ {
$attempts = $this->getFailedAttempts(); $attempts = $this->getFailedAttempts();
@@ -830,17 +477,6 @@ class AdminAuth
return ['locked' => false]; return ['locked' => false];
} }
/**
* Registreert een mislukte inlogpoging voor een gebruiker.
*
* Verhoogt de teller en actualiseert de timestamp van de laatste poging,
* waarna de gegevens worden weggeschreven naar het lockout-bestand.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @return void
*/
private function recordFailedAttempt(string $username): void private function recordFailedAttempt(string $username): void
{ {
$attempts = $this->getFailedAttempts(); $attempts = $this->getFailedAttempts();
@@ -852,16 +488,6 @@ class AdminAuth
file_put_contents($this->lockFile, json_encode($attempts)); file_put_contents($this->lockFile, json_encode($attempts));
} }
/**
* Wist alle mislukte inlogpogingen voor een gebruiker.
*
* Verwijdert de gebruiker uit het lockout-bestand en slaat dit op.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @return void
*/
private function clearFailedAttempts(string $username): void private function clearFailedAttempts(string $username): void
{ {
$attempts = $this->getFailedAttempts(); $attempts = $this->getFailedAttempts();
@@ -870,28 +496,13 @@ class AdminAuth
} }
/** /**
* Wist de lockout voor een gebruiker (publiek, gebruikt door CLI reset). * Clear all failed login attempts for a user (public, used by CLI reset).
*
* Wrapper rond clearFailedAttempts die ook van buiten de class kan worden
* aangeroepen, bijvoorbeeld door een CLI-tool voor het resetten van vergrendelingen.
*
* @since 2.6.5
*
* @param string $username Gebruikersnaam.
* @return void
*/ */
public function clearLockout(string $username): void public function clearLockout(string $username): void
{ {
$this->clearFailedAttempts($username); $this->clearFailedAttempts($username);
} }
/**
* Leest alle mislukte inlogpogingen uit het lockout-bestand.
*
* @since 2.6.5
*
* @return array<string, array{count: int, last_attempt: int}> Map van gebruikersnaam naar poging-data.
*/
private function getFailedAttempts(): array private function getFailedAttempts(): array
{ {
if (!file_exists($this->lockFile)) { if (!file_exists($this->lockFile)) {
@@ -901,18 +512,6 @@ class AdminAuth
return is_array($data) ? $data : []; return is_array($data) ? $data : [];
} }
/**
* Schrijft een bericht naar het logbestand met timestamp, level en IP-adres.
*
* Maakt de logdirectory aan indien nodig. Het IP-adres wordt via RequestLogger
* bepaald indien beschikbaar, anders via REMOTE_ADDR met een fallback.
*
* @since 2.6.5
*
* @param string $level Log-niveau (bijv. 'info', 'warning').
* @param string $message Bericht dat gelogd moet worden.
* @return void
*/
private function log(string $level, string $message): void private function log(string $level, string $message): void
{ {
$logFile = $this->config['log_file']; $logFile = $this->config['log_file'];
+1 -1
View File
@@ -1 +1 @@
{"admi":{"count":1,"last_attempt":1771257322},"":{"count":4,"last_attempt":1787141227}} {"admi":{"count":1,"last_attempt":1771257322}}
@@ -7,7 +7,7 @@
var ext = textarea.dataset.ext || 'md'; var ext = textarea.dataset.ext || 'md';
var form = document.getElementById('editor-form') || textarea.closest('form'); var form = document.getElementById('editor-form') || textarea.closest('form');
var modeMap = { md: 'markdown', html: 'htmlmixed', twig: 'htmlmixed', php: 'php', css: 'css', scss: 'css', js: 'javascript', json: 'javascript' }; var modeMap = { md: 'markdown', html: 'htmlmixed', php: 'php', css: 'css', scss: 'css', js: 'javascript', json: 'javascript' };
var editor = CodeMirror.fromTextArea(textarea, { var editor = CodeMirror.fromTextArea(textarea, {
mode: modeMap[ext] || 'markdown', mode: modeMap[ext] || 'markdown',
@@ -42,7 +42,6 @@
{ cmd: 'quote', icon: 'bi-chat-quote', title: 'Citaat' }, { cmd: 'quote', icon: 'bi-chat-quote', title: 'Citaat' },
null, null,
{ cmd: 'hr', icon: 'bi-hr', title: 'Horizontale lijn' }, { cmd: 'hr', icon: 'bi-hr', title: 'Horizontale lijn' },
{ cmd: 'image-size', icon: 'bi-arrows-angle-expand', title: 'Afbeelding grootte' },
null, null,
{ cmd: 'media', icon: 'bi-images', title: 'Media invoegen' } { cmd: 'media', icon: 'bi-images', title: 'Media invoegen' }
], ],
@@ -153,43 +152,6 @@
modal.show(); modal.show();
} }
break; break;
case 'image-size':
// Set width/height on a markdown image: ![alt](url){:width="W" height="H"}
var selImg = editor.getSelection();
if (!selImg) {
// No selection — ask the user to select an image first
alert('Selecteer eerst een afbeelding in de editor (![alt](url)) om de grootte in te stellen.');
editor.focus();
break;
}
// Match ![alt](url) optionally followed by {:...}
var imgMatch = selImg.match(/^!\[([^\]]*)\]\(([^)]+)\)(\s*\{:([^}]*)\})?/);
if (!imgMatch) {
alert('Selectie is geen afbeelding. Selecteer een afbeelding in markdown formaat: ![alt](url)');
editor.focus();
break;
}
var alt = imgMatch[1];
var url = imgMatch[2];
// Parse existing width/height from the {:...} block
var existingAttrs = imgMatch[4] || '';
var existingW = (existingAttrs.match(/width\s*=\s*"([^"]*)"/) || [])[1] || '';
var existingH = (existingAttrs.match(/height\s*=\s*"([^"]*)"/) || [])[1] || '';
var width = prompt('Breedte (px of %, leeg = niet instellen):', existingW);
if (width === null) { editor.focus(); break; }
var height = prompt('Hoogte (px of %, leeg = niet instellen):', existingH);
if (height === null) { editor.focus(); break; }
// Build the {:width=... height=...} suffix
var attrs = [];
if (width.trim() !== '') attrs.push('width="' + width.replace(/"/g, '') + '"');
if (height.trim() !== '') attrs.push('height="' + height.replace(/"/g, '') + '"');
var replacement = '![' + alt + '](' + url + ')';
if (attrs.length > 0) {
replacement += '{:' + attrs.join(' ') + '}';
}
editor.replaceSelection(replacement);
editor.focus();
break;
} }
} }
+5 -4
View File
@@ -10,7 +10,8 @@
<link rel="stylesheet" href="/plugins/Navigation/assets/css/navigation.css"> <link rel="stylesheet" href="/plugins/Navigation/assets/css/navigation.css">
<style> <style>
body { background-color: #f5f6fa; min-height: 100vh; } body { background-color: #f5f6fa; min-height: 100vh; }
.admin-sidebar { background-color: {{ sidebar_color|default('#0a369d') }}; height: 100vh; width: 240px; position: fixed; top: 0; left: 0; z-index: 100; overflow-y: auto; } .admin-sidebar { background-color: {{ sidebar_color|default('#0a369d') }}; min-height: 100vh; width: 240px; position: fixed; top: 0; left: 0; z-index: 100; display: flex; flex-direction: column; }
.admin-sidebar .nav.flex-column:first-of-type { flex: 1; overflow-y: auto; }
.admin-sidebar .nav-link { color: rgba(255,255,255,0.8); padding: 0.75rem 1.25rem; border-radius: 0; } .admin-sidebar .nav-link { color: rgba(255,255,255,0.8); padding: 0.75rem 1.25rem; border-radius: 0; }
.admin-sidebar .nav-link:hover { color: #fff; background-color: rgba(255,255,255,0.1); } .admin-sidebar .nav-link:hover { color: #fff; background-color: rgba(255,255,255,0.1); }
.admin-sidebar .nav-link.active { color: #fff; background-color: rgba(255,255,255,0.2); border-left: 3px solid #fff; } .admin-sidebar .nav-link.active { color: #fff; background-color: rgba(255,255,255,0.2); border-left: 3px solid #fff; }
@@ -23,7 +24,7 @@
.stat-card .stat-icon { font-size: 2rem; opacity: 0.7; } .stat-card .stat-icon { font-size: 2rem; opacity: 0.7; }
.admin-user { color: rgba(255,255,255,0.6); padding: 0.75rem 1.25rem; font-size: 0.85rem; border-top: 1px solid rgba(255,255,255,0.15); } .admin-user { color: rgba(255,255,255,0.6); padding: 0.75rem 1.25rem; font-size: 0.85rem; border-top: 1px solid rgba(255,255,255,0.15); }
@media (max-width: 768px) { @media (max-width: 768px) {
.admin-sidebar { width: 100%; height: auto; position: relative; } .admin-sidebar { width: 100%; min-height: auto; position: relative; }
.admin-main { margin-left: 0; } .admin-main { margin-left: 0; }
} }
</style> </style>
@@ -34,7 +35,7 @@
{% block extra_css %}{% endblock %} {% block extra_css %}{% endblock %}
</head> </head>
<body> <body>
<nav class="admin-sidebar" id="adminSidebar"> <nav class="admin-sidebar d-flex flex-column">
<div class="admin-brand"> <div class="admin-brand">
<i class="bi bi-gear-fill"></i> {{ ta.admin_title|default('CodePress Admin') }} <i class="bi bi-gear-fill"></i> {{ ta.admin_title|default('CodePress Admin') }}
</div> </div>
@@ -133,7 +134,7 @@
{% endif %} {% endif %}
</ul> </ul>
<ul class="nav flex-column mt-3 mb-4"> <ul class="nav flex-column mt-auto mb-5">
{% if user_real_role == 'admin' %} {% if user_real_role == 'admin' %}
<li class="nav-item"> <li class="nav-item">
<a class="nav-link" href="#" data-bs-toggle="modal" data-bs-target="#roleSwitchModal"> <a class="nav-link" href="#" data-bs-toggle="modal" data-bs-target="#roleSwitchModal">
-8
View File
@@ -27,14 +27,6 @@
<button type="button" class="btn-close" data-bs-dismiss="alert"></button> <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
</div> </div>
{% endif %} {% endif %}
{% if generated_password %}
<div class="alert alert-warning" role="alert">
<h6 class="alert-heading"><i class="bi bi-exclamation-triangle-fill"></i> Eerste installatie</h6>
<p class="mb-2">Er is nog geen <code>admin.json</code> aanwezig. Een nieuw wachtwoord is gegenereerd voor de gebruiker <strong>admin</strong>:</p>
<p class="mb-2"><code class="fs-5">{{ generated_password }}</code></p>
<p class="mb-0 small">Log in met dit wachtwoord en wijzig het direct na login. Sla het veilig op; het wordt niet opnieuw getoond.</p>
</div>
{% endif %}
<form method="POST" action="/admin/login"> <form method="POST" action="/admin/login">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<div class="mb-3"> <div class="mb-3">
@@ -1,56 +0,0 @@
{# Shared editor layout + file-tree styles for the content, plugin and theme editors.
Included via {% include 'pages/_editor-styles.twig' %} inside the extra_css block. #}
<style>
.editor-layout { display: flex; gap: 1rem; align-items: stretch; }
.plugin-file-tree { width: 300px; flex: 0 0 300px; }
.editor-main { flex: 1 1 auto; min-width: 0; }
.editor-tree { list-style: none; padding-left: 0; margin: 0; }
.editor-tree ul { list-style: none; padding-left: 1.1rem; margin: 0; }
.editor-tree li { padding: 0; position: relative; }
.editor-tree li > .tree-link { display: flex; align-items: center; gap: .3rem; padding: .2rem .4rem; border-radius: .25rem; text-decoration: none; color: inherit; font-size: .9rem; line-height: 1.4; }
.editor-tree li > .tree-link:hover { background-color: rgba(13,110,253,.08); }
.editor-tree li > .tree-link.is-active { background-color: var(--bs-primary-bg-subtle, #cfe2ff); font-weight: 600; }
.editor-tree .tree-toggle.is-selected { background-color: rgba(13,110,253,.12); font-weight: 600; }
.editor-tree .tree-toggle { cursor: pointer; user-select: none; width: 100%; text-align: left; background: transparent; border: 0; color: inherit; }
.editor-tree .tree-chevron { flex: 0 0 auto; }
.editor-tree .tree-chevron-btn { background: transparent; border: 0; color: inherit; padding: .2rem .4rem; line-height: 1.4; flex: 0 0 auto; cursor: pointer; }
.editor-tree .tree-chevron-btn:hover { color: var(--bs-primary, #0d6efd); }
.editor-tree .tree-name { flex: 1 1 auto; min-width: 0; }
.editor-tree .tree-name.is-selected { background-color: var(--bs-primary-bg-subtle, #cfe2ff); font-weight: 600; }
.editor-tree .tree-root-link { display: flex; align-items: center; gap: .3rem; padding: .25rem .4rem; border-radius: .25rem; text-decoration: none; color: inherit; font-size: .9rem; font-weight: 600; }
.editor-tree .tree-root-link:hover { background-color: rgba(13,110,253,.08); }
.editor-tree .tree-root-link.is-selected { background-color: var(--bs-primary-bg-subtle, #cfe2ff); }
.editor-tree .tree-chevron-spacer { display: inline-block; width: .9rem; flex: 0 0 auto; }
.editor-tree .badge-ext { font-size: .6rem; margin-left: auto; }
.editor-tree .text-truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.editor-tree .tree-move-btn,
.editor-tree .tree-delete-btn { font-size: .9rem; line-height: 1; padding: .15rem; color: #6c757d; text-decoration: none; background: transparent; border: 0; }
.editor-tree .tree-move-btn:hover,
.editor-tree .tree-delete-btn:hover { color: #0d6efd; }
.editor-tree .tree-delete-btn:hover { color: #dc3545; }
.editor-tree .tree-file-actions { position: absolute; right: .25rem; top: 50%; transform: translateY(-50%); display: flex; gap: .15rem; align-items: center; opacity: 0; transition: opacity .15s; }
.editor-tree li:hover > .tree-file-actions { opacity: 1; }
.editor-tree li > .tree-link { padding-right: 4rem; }
/* Drag-and-drop states */
.editor-tree li.tree-dragging { opacity: .5; }
.editor-tree .tree-drag-over { background-color: rgba(13,110,253,.18) !important; outline: 2px dashed var(--bs-primary, #0d6efd); outline-offset: -2px; border-radius: .25rem; }
/* Toast */
.tree-toast { border-radius: .375rem; }
.plugin-file-tree .card-body { max-height: 70vh; overflow-y: auto; }
/* Directory action buttons (new file/dir, rename) — content editor only */
.tree-dir-row { position: relative; display: flex; align-items: center; }
.tree-dir-row > .tree-name { padding-right: 3rem; }
.tree-dir-row > .tree-toggle { padding-right: 5rem; }
.tree-dir-actions { position: absolute; right: .25rem; top: 50%; transform: translateY(-50%); display: flex; gap: .15rem; align-items: center; }
.tree-dir-actions .btn-link { color: #6c757d; }
.tree-dir-actions .btn-link:hover { color: #0d6efd; }
@media (max-width: 768px) {
.editor-layout { flex-direction: column; }
.plugin-file-tree { width: 100%; flex-basis: auto; max-height: 320px; }
.plugin-file-tree .card-body { max-height: 260px; }
}
/* Plugin checkbox group (content editor) */
.plugin-checkbox-group { display: flex; flex-direction: column; gap: .15rem; }
.plugin-checkbox-group .form-check { margin-bottom: 0; }
.plugin-checkbox-group .form-check-label { font-size: .875rem; }
</style>
@@ -1,226 +0,0 @@
{# Shared file-tree partial used by the content, plugin and theme editors.
Renders a nested, collapsible file tree from a list of nodes produced by
scanEditorFiles()/scanContentFiles()/scanPluginFiles()/scanThemeFiles().
Required variables (passed via include with ... context):
- files: array of nodes [{name, path, is_dir, extension, size, modified, children}]
- relFile: currently selected relative file path (for active highlight + auto-expand)
- editableExts: array of editable extensions (shown as .EXT badge)
- treeIdPrefix: prefix for collapse element ids (e.g. 'content-tree', 'plugin-tree', 'theme-tree')
- treeRouteBase: admin route base used to build file links, e.g. '/admin/content'
- treeRouteParams: extra query string for file links, e.g. 'plugin=MyPlugin&' or 'theme=default&' or '' (content)
- treeMoveRoute: admin route for file move, e.g. '/admin/plugins-file-move'
- treeMoveParams: extra query string for move link, e.g. 'plugin=X&' or ''
- treeDirActions: boolean; show per-folder new-file/new-dir/rename buttons (default true)
- treeFileMove: boolean; show per-file move/rename pencil button (default true)
- treeHideActionsFor: array of relative paths where move/delete actions are hidden (e.g. ['theme.json'])
- treeDirSelectRoute: if set, folder names are links to ?dir=<path> (map-detail pane)
- treeDirRenameRoute: if set, show a rename pencil per folder
- treeDeleteBase: POST URL for file deletion (scope-specific)
- treeScope: 'content' | 'theme' | 'plugin' (for tree-interactions.js)
- treeMoveUrl: AJAX endpoint for drag-drop move (e.g. '/admin/tree-move')
- treeScopeParam: extra query param string (e.g. 'plugin=MyPlugin&' or 'theme=default&' or '')
Icon maps are chosen automatically from the node extension. #}
{% macro tree(nodes, opts) %}
{% import _self as macros %}
<ul class="editor-tree">
{% for n in nodes %}
{# Een bestand is alleen actief wanneer er geen map geselecteerd is
(een map-selectie opent het map-detail paneel, geen bestand). #}
{% set isActive = n.path == opts.relFile and opts.selectedDir|default('') == '' %}
{# Markeer de oudermap "bevat actieve selectie" voor auto-uitklappen:
bij een geselecteerd bestand OF een geselecteerde (sub)map. #}
{% set activePath = opts.selectedDir|default('') != '' ? opts.selectedDir : opts.relFile %}
{% set containsActive = n.is_dir and activePath != '' and activePath starts with (n.path ~ '/') %}
{% if n.is_dir %}
{% set icon = 'bi-folder-fill text-warning' %}
{% elseif n.extension == 'md' %}
{% set icon = 'bi-file-text text-primary' %}
{% elseif n.extension == 'php' %}
{% set icon = 'bi-file-code text-success' %}
{% elseif n.extension == 'twig' %}
{% set icon = 'bi-filetype-tfn text-info' %}
{% elseif n.extension == 'json' %}
{% set icon = 'bi-filetype-json text-secondary' %}
{% elseif n.extension in ['css','scss'] %}
{% set icon = 'bi-filetype-css text-info' %}
{% elseif n.extension == 'js' %}
{% set icon = 'bi-filetype-js text-warning' %}
{% elseif n.extension == 'html' %}
{% set icon = 'bi-file-earmark text-info' %}
{% elseif n.extension in ['jpg','jpeg','png','gif','webp','svg'] %}
{% set icon = 'bi-file-image text-info' %}
{% elseif n.extension == 'pdf' %}
{% set icon = 'bi-file-pdf text-danger' %}
{% else %}
{% set icon = 'bi-file text-muted' %}
{% endif %}
<li data-path="{{ n.path }}" data-isdir="{{ n.is_dir ? '1' : '0' }}">
{% if n.is_dir %}
{% set collapseId = opts.treeIdPrefix ~ '-' ~ n.path|replace({'/':'-','.':'-'}) %}
<div class="tree-dir-row" data-dir="{{ n.path }}">
{# Chevron: expand/collapse only (zonder navigatie) #}
<button type="button" class="tree-chevron-btn" data-bs-toggle="collapse" data-bs-target="#{{ collapseId }}" aria-expanded="{{ containsActive ? 'true' : 'false' }}" title="{{ ta.expand_collapse|default('Uitklappen/inklappen') }}" aria-label="{{ ta.expand_collapse|default('Uitklappen/inklappen') }}">
<i class="bi {{ containsActive ? 'bi-chevron-down' : 'bi-chevron-right' }} tree-chevron"></i>
</button>
{# Mapnaam: selecteer de map. Voor content gaat dit naar ?dir= (map-detail paneel rechts);
voor plugins/themes is het een niet-navigerende toggle (legacy gedrag). #}
{% if opts.treeDirSelectRoute %}
<a href="{{ opts.treeDirSelectRoute }}{% if '?' in opts.treeDirSelectRoute %}&{% else %}?{% endif %}dir={{ n.path|url_encode }}" class="tree-link tree-name {{ containsActive ? 'is-active' : '' }} {{ opts.selectedDir == n.path ? 'is-selected' : '' }}" title="{{ n.path }}">
<i class="bi {{ icon }}"></i>
<span class="text-truncate">{{ n.name }}</span>
</a>
{% else %}
<button type="button" class="tree-link tree-toggle btn-toggle {{ containsActive ? '' : 'collapsed' }}" data-bs-toggle="collapse" data-bs-target="#{{ collapseId }}" aria-expanded="{{ containsActive ? 'true' : 'false' }}" title="{{ n.path }}">
<i class="bi {{ icon }}"></i>
<span class="text-truncate">{{ n.name }}</span>
</button>
{% endif %}
{% if opts.treeDirActions %}
<span class="tree-dir-actions">
<button type="button" class="btn btn-link btn-sm p-0 tree-newfile-btn" title="{{ ta.new_file|default('Nieuw bestand hier') }}" aria-label="{{ ta.new_file|default('Nieuw bestand') }}" data-bs-toggle="modal" data-bs-target="{{ opts.newFileModalId|default('#newFileModal') }}" data-in-dir="{{ n.path }}">
<i class="bi bi-file-earmark-plus"></i>
</button>
{% if opts.newDirModalId is defined and opts.newDirModalId %}
<button type="button" class="btn btn-link btn-sm p-0 tree-newdir-btn" title="{{ ta.new_folder|default('Nieuwe map') }}" aria-label="{{ ta.new_folder|default('Nieuwe map') }}" data-bs-toggle="modal" data-bs-target="{{ opts.newDirModalId }}" data-in-dir="{{ n.path }}">
<i class="bi bi-folder-plus"></i>
</button>
{% endif %}
{% if opts.treeDirRenameRoute %}
<a href="{{ opts.treeDirRenameRoute }}{% if '?' in opts.treeDirRenameRoute %}&{% else %}?{% endif %}dir={{ n.path|url_encode }}" class="tree-rename-btn" title="{{ ta.rename|default('Hernoemen') }}" aria-label="{{ ta.rename|default('Hernoemen') }}">
<i class="bi bi-pencil"></i>
</a>
{% endif %}
</span>
{% endif %}
</div>
<div id="{{ collapseId }}"
class="tree-collapse collapse {{ containsActive ? 'show' : '' }}">
{% if n.children is not empty %}
{{ macros.tree(n.children, opts) }}
{% endif %}
</div>
{% else %}
<a href="{{ opts.treeRouteBase }}?{{ opts.treeRouteParams }}file={{ n.path|url_encode }}"
class="tree-link {{ isActive ? 'is-active' : '' }}"
title="{{ n.path }}">
<span class="tree-chevron-spacer"></span>
<i class="bi {{ icon }}"></i>
<span class="text-truncate">{{ n.name }}</span>
{% if n.extension in opts.editableExts %}
<span class="badge bg-secondary badge-ext">{{ n.extension|upper }}</span>
{% endif %}
</a>
<span class="tree-file-actions">
{% if n.path not in (opts.treeHideActionsFor ?? []) %}
{% set showFileMove = opts.treeFileMove is defined ? opts.treeFileMove : true %}
{% if showFileMove %}
<a href="{{ opts.treeMoveRoute }}?{{ opts.treeMoveParams }}file={{ n.path|url_encode }}"
class="tree-move-btn" title="{{ ta.rename|default('Hernoemen/Verplaatsen') }}" aria-label="{{ ta.rename|default('Hernoemen/Verplaatsen') }}">
<i class="bi bi-pencil"></i>
</a>
{% endif %}
<button type="button" class="btn btn-link btn-sm p-0 tree-delete-btn" title="{{ ta.delete|default('Verwijderen') }}" aria-label="{{ ta.delete|default('Verwijderen') }}" data-path="{{ n.path }}">
<i class="bi bi-trash"></i>
</button>
{% endif %}
</span>
{% endif %}
</li>
{% endfor %}
</ul>
{% endmacro %}
{% import _self as tree_macros %}
{# Render the tree inside the standard sidebar card. The container keeps the
generic id "editorFileTree" so shared CSS/JS selectors work everywhere. #}
<div class="plugin-file-tree">
<div class="card shadow-sm h-100">
<div class="card-header bg-white py-2 d-flex justify-content-between align-items-center">
<span class="small text-muted fw-semibold"><i class="bi bi-folder2-open"></i> {{ treeHeader|default('Bestanden') }}</span>
</div>
<div class="card-body p-2" id="editorFileTree"
data-csrf="{{ csrf_token|default('') }}"
data-scope="{{ treeScope|default('content') }}"
data-move-url="{{ treeMoveUrl|default('') }}"
data-delete-base="{{ treeDeleteBase|default('') }}"
data-new-file-modal="{{ newFileModalId|default('#newFileModal') }}"
data-new-dir-modal="{{ newDirModalId|default('#newDirModal') }}"
data-scope-param="{{ treeScopeParam|default('') }}"
data-edit-base="{{ treeRouteBase|default('') }}">
{% if treeDirSelectRoute is defined and treeDirSelectRoute is not empty %}
{# Klikbare content-root: selecteert de root map (?dir= leeg).
data-dir="" maakt de root ook een drag-drop doel (lege string = base dir). #}
<a href="{{ treeDirSelectRoute }}" class="tree-link tree-root-link {{ selectedDir|default('') == '' ? 'is-selected' : '' }}" data-dir="" title="content">
<i class="bi bi-folder2-open"></i>
<span class="text-truncate">{{ treeRootLabel|default('content') }}</span>
</a>
{% endif %}
{% if files is empty %}
<div class="small text-muted p-2">{{ treeEmptyText|default('Geen bestanden gevonden.') }}</div>
{% else %}
{{ tree_macros.tree(files, {
'relFile': relFile,
'selectedDir': selectedDir|default(''),
'editableExts': editableExts,
'treeIdPrefix': treeIdPrefix,
'treeRouteBase': treeRouteBase,
'treeRouteParams': treeRouteParams,
'treeMoveRoute': treeMoveRoute,
'treeMoveParams': treeMoveParams,
'treeDirActions': treeDirActions is defined ? treeDirActions : true,
'treeDirSelectRoute': treeDirSelectRoute|default(''),
'treeDirRenameRoute': treeDirRenameRoute|default(''),
'treeFileMove': treeFileMove is defined ? treeFileMove : true,
'treeHideActionsFor': treeHideActionsFor|default([]),
'newFileModalId': newFileModalId|default('#newFileModal'),
'newDirModalId': newDirModalId|default(''),
}) }}
{% endif %}
</div>
</div>
</div>
<script src="/admin/assets/js/tree-interactions.js"></script>
<script>
(function () {
var tree = document.getElementById('editorFileTree');
if (!tree) return;
function findToggle(collapseEl) {
var id = collapseEl.id;
if (!id) return null;
return tree.querySelector('[data-bs-target="#' + id + '"]');
}
function expand(btn) {
var icon = btn.querySelector('.tree-chevron');
if (icon) { icon.classList.remove('bi-chevron-right'); icon.classList.add('bi-chevron-down'); }
}
function collapse(btn) {
var icon = btn.querySelector('.tree-chevron');
if (icon) { icon.classList.remove('bi-chevron-down'); icon.classList.add('bi-chevron-right'); }
}
tree.addEventListener('shown.bs.collapse', function (e) {
var btn = findToggle(e.target);
if (btn) expand(btn);
});
tree.addEventListener('hidden.bs.collapse', function (e) {
var btn = findToggle(e.target);
if (btn) collapse(btn);
});
// Set initial state for folders that are open on page load
Array.prototype.forEach.call(tree.querySelectorAll('.tree-collapse.show'), function (c) {
var btn = findToggle(c);
if (btn) expand(btn);
});
// Make all tree <li> nodes draggable (for drag-and-drop move)
Array.prototype.forEach.call(tree.querySelectorAll('li[data-path]'), function (li) {
li.setAttribute('draggable', 'true');
});
})();
</script>
+64 -178
View File
@@ -1,17 +1,12 @@
{# Reusable media modal, included by admin.twig when needs_editor is true. {# Reusable media modal, included by admin.twig when needs_editor is true.
The editor toolbar "media" button opens this modal. It fetches the list The editor toolbar "media" button opens this modal. It fetches the list
of media files from /admin/media-list (JSON) and renders them as a of media files from /admin/media-list (JSON) and, on click, inserts a
collapsible file tree (consistent with the content/plugin/theme editors). snippet into the active CodeMirror editor at the cursor.
On click of a file node, a snippet is inserted into the active CodeMirror
editor at the cursor.
Scope: Scope:
- Default (content editor): fetches /admin/media-list - Default (content editor): fetches /admin/media-list
which scans content/ (URLs are prefixed with /-media/).
- Plugin editor (mediaPluginName set): fetches /admin/media-list?plugin=<name> - Plugin editor (mediaPluginName set): fetches /admin/media-list?plugin=<name>
which scans plugins/<name>/assets/ instead of content/. which scans plugins/<name>/assets/ instead of content/.
- Theme editor (mediaThemeName set): fetches /admin/media-list?theme=<name>
which scans themes/<name>/assets/ instead of content/.
The snippet format depends on the editor's current mode (data-ext): The snippet format depends on the editor's current mode (data-ext):
- markdown (md): ![alt](url) - markdown (md): ![alt](url)
@@ -29,20 +24,20 @@
<span class="input-group-text bg-white"><i class="bi bi-search text-muted"></i></span> <span class="input-group-text bg-white"><i class="bi bi-search text-muted"></i></span>
<input type="search" id="mediaModalFilter" class="form-control" placeholder="{{ ta.media_filter|default('Filter op bestandsnaam...') }}" autocomplete="off" aria-label="{{ ta.media_filter|default('Filter') }}"> <input type="search" id="mediaModalFilter" class="form-control" placeholder="{{ ta.media_filter|default('Filter op bestandsnaam...') }}" autocomplete="off" aria-label="{{ ta.media_filter|default('Filter') }}">
</div> </div>
<div id="mediaModalTree" class="media-tree-wrap"> <div id="mediaModalGrid" class="row g-3">
<div class="text-center text-muted py-4" id="mediaModalLoading"> <div class="col-12 text-center text-muted py-4" id="mediaModalLoading">
<div class="spinner-border spinner-border-sm" role="status"></div> <div class="spinner-border spinner-border-sm" role="status"></div>
<span class="ms-2">{{ ta.media_loading|default('Media laden...') }}</span> <span class="ms-2">{{ ta.media_loading|default('Media laden...') }}</span>
</div> </div>
<div class="text-center text-muted py-4 d-none" id="mediaModalEmpty"> <div class="col-12 text-center text-muted py-4 d-none" id="mediaModalEmpty">
<i class="bi bi-image display-6 d-block mb-2"></i> <i class="bi bi-image display-6 d-block mb-2"></i>
{{ mediaEmptyText|default('Geen media bestanden gevonden in content/. Upload eerst bestanden via Media in het menu.') }} {{ mediaEmptyText|default('Geen media bestanden gevonden in content/. Upload eerst bestanden via Media in het menu.') }}
</div> </div>
<div class="text-center text-danger py-4 d-none" id="mediaModalError"> <div class="col-12 text-center text-danger py-4 d-none" id="mediaModalError">
<i class="bi bi-exclamation-triangle display-6 d-block mb-2"></i> <i class="bi bi-exclamation-triangle display-6 d-block mb-2"></i>
<span id="mediaModalErrorText"></span> <span id="mediaModalErrorText"></span>
</div> </div>
{# Tree populated by JS #} {# Filled by JS #}
</div> </div>
</div> </div>
<div class="modal-footer"> <div class="modal-footer">
@@ -52,22 +47,6 @@
</div> </div>
</div> </div>
<style>
/* Media modal tree — self-contained so the modal works on any editor page. */
.media-tree-wrap { max-height: 60vh; overflow-y: auto; }
.media-tree { list-style: none; padding-left: 0; margin: 0; }
.media-tree ul { list-style: none; padding-left: 1.1rem; margin: 0; }
.media-tree li { padding: 0; position: relative; }
.media-tree li > .tree-link { display: flex; align-items: center; gap: .3rem; padding: .2rem .4rem; border-radius: .25rem; text-decoration: none; color: inherit; font-size: .9rem; line-height: 1.4; cursor: pointer; }
.media-tree li > .tree-link:hover { background-color: rgba(13,110,253,.08); }
.media-tree .tree-toggle { cursor: pointer; user-select: none; width: 100%; text-align: left; background: transparent; border: 0; color: inherit; }
.media-tree .tree-chevron { flex: 0 0 auto; }
.media-tree .tree-chevron-spacer { display: inline-block; width: .9rem; flex: 0 0 auto; }
.media-tree .text-truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.media-tree .badge-ext { font-size: .6rem; margin-left: auto; }
.media-tree .media-thumb { width: 1.1rem; height: 1.1rem; object-fit: cover; flex: 0 0 auto; border-radius: .2rem; }
</style>
<script> <script>
(function () { (function () {
'use strict'; 'use strict';
@@ -95,6 +74,7 @@
} }
return '<a href="' + url + '">' + name + '</a>'; return '<a href="' + url + '">' + name + '</a>';
} }
// css, scss, js, json, etc.: just insert the URL
return url; return url;
} }
@@ -103,172 +83,89 @@
return map[ext] || 'markdown'; return map[ext] || 'markdown';
} }
function iconFor(ext, isImage) { function renderGrid() {
if (isImage) return 'bi-file-image text-info'; var grid = document.getElementById('mediaModalGrid');
if (ext === 'pdf') return 'bi-file-pdf text-danger'; if (!grid) return;
if (['mp4', 'webm', 'mov', 'ogg', 'avi'].indexOf(ext) !== -1) return 'bi-file-play text-info';
if (['mp3', 'wav'].indexOf(ext) !== -1) return 'bi-file-music text-info';
return 'bi-file text-muted';
}
// Build a nested tree from a flat list of {path, name, ...} items. // Clear previous items (keep loading/empty/error placeholders)
function buildTree(flat) { Array.prototype.forEach.call(grid.querySelectorAll('[data-media-item]'), function (el) { el.remove(); });
var root = { name: '', path: '', children: {}, isDir: true };
flat.forEach(function (item) {
var parts = item.path.split('/');
var node = root;
for (var i = 0; i < parts.length; i++) {
var part = parts[i];
if (part === '') continue;
var isLast = i === parts.length - 1;
if (!node.children[part]) {
node.children[part] = {
name: part, path: parts.slice(0, i + 1).join('/'),
children: {}, isDir: !isLast
};
}
if (isLast) {
node.children[part].item = item;
node.children[part].isDir = false;
}
node = node.children[part];
}
});
// Convert children maps to sorted arrays (dirs first, then alpha)
function finalize(n) {
var arr = Object.keys(n.children).map(function (k) { return n.children[k]; });
arr.sort(function (a, b) {
if (a.isDir && !b.isDir) return -1;
if (!a.isDir && b.isDir) return 1;
return a.name.toLowerCase().localeCompare(b.name.toLowerCase());
});
n.childArr = arr;
arr.forEach(finalize);
return n;
}
finalize(root);
return root;
}
function matchesFilter(node, q) { var q = (document.getElementById('mediaModalFilter').value || '').trim().toLowerCase();
if (!q) return true; var shown = 0;
if (node.item && node.item.name.toLowerCase().indexOf(q) !== -1) return true;
if (node.childArr) {
for (var i = 0; i < node.childArr.length; i++) {
if (matchesFilter(node.childArr[i], q)) return true;
}
}
return false;
}
function escapeHtml(s) { items.forEach(function (item) {
return String(s).replace(/[&<>"']/g, function (c) { if (q && item.name.toLowerCase().indexOf(q) === -1) return;
return { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]; shown++;
});
}
var idCounter = 0; var col = document.createElement('div');
col.className = 'col-6 col-md-4 col-lg-3';
col.setAttribute('data-media-item', '1');
var card = document.createElement('div');
card.className = 'card shadow-sm h-100';
card.style.cursor = 'pointer';
card.title = item.name + ' (' + item.size + ')';
function renderNode(node, container, q) {
var ul = document.createElement('ul');
ul.className = 'media-tree';
node.childArr.forEach(function (child) {
if (!matchesFilter(child, q)) return;
var li = document.createElement('li');
if (child.isDir) {
var collapseId = 'media-tree-' + (++idCounter);
var btn = document.createElement('button');
btn.type = 'button';
btn.className = 'tree-link tree-toggle btn-toggle collapsed';
btn.setAttribute('data-bs-toggle', 'collapse');
btn.setAttribute('data-bs-target', '#' + collapseId);
btn.setAttribute('aria-expanded', 'false');
btn.title = child.path;
btn.innerHTML = '<i class="bi bi-chevron-right tree-chevron"></i>' +
'<i class="bi bi-folder-fill text-warning"></i>' +
'<span class="text-truncate">' + escapeHtml(child.name) + '</span>';
li.appendChild(btn);
var wrap = document.createElement('div');
wrap.id = collapseId;
wrap.className = 'tree-collapse collapse';
renderNode(child, wrap, q);
li.appendChild(wrap);
} else {
var item = child.item;
var a = document.createElement('a');
a.className = 'tree-link';
a.title = item.path + ' (' + item.size + ')';
var thumb = '';
if (item.is_image) { if (item.is_image) {
thumb = '<img class="media-thumb" src="' + item.url + '" alt="" loading="lazy">'; var img = document.createElement('img');
img.src = item.url;
img.className = 'card-img-top';
img.style.objectFit = 'cover';
img.style.height = '120px';
img.loading = 'lazy';
img.alt = item.name;
card.appendChild(img);
} else { } else {
thumb = '<i class="bi ' + iconFor(item.extension, item.is_image) + '"></i>'; var ph = document.createElement('div');
} ph.className = 'card-img-top d-flex align-items-center justify-content-center bg-light';
a.innerHTML = '<span class="tree-chevron-spacer"></span>' + thumb + ph.style.height = '120px';
'<span class="text-truncate">' + escapeHtml(item.name) + '</span>' + var icon = document.createElement('i');
'<span class="badge bg-secondary badge-ext">' + item.extension.toUpperCase() + '</span>'; icon.className = 'bi bi-file-earmark-play display-6 text-muted';
a.addEventListener('click', function (e) { ph.appendChild(icon);
e.preventDefault(); card.appendChild(ph);
insertItem(item);
});
li.appendChild(a);
}
ul.appendChild(li);
});
container.appendChild(ul);
} }
function insertItem(item) { var body = document.createElement('div');
body.className = 'card-body p-2';
var label = document.createElement('p');
label.className = 'card-text small text-muted text-truncate mb-0';
label.textContent = item.name;
body.appendChild(label);
card.appendChild(body);
card.addEventListener('click', function () {
var editor = window.codeMirrorEditor; var editor = window.codeMirrorEditor;
if (!editor) return; if (!editor) { return; }
var ext = (document.getElementById('editor-textarea') || {}).dataset; var ext = (document.getElementById('editor-textarea') || {}).dataset;
var fileExt = (ext && ext.ext) ? ext.ext : 'md'; var fileExt = (ext && ext.ext) ? ext.ext : 'md';
var mode = modeForExt(fileExt); var mode = modeForExt(fileExt);
var snippet = formatSnippet(item.url, item.name, item.extension, mode); var snippet = formatSnippet(item.url, item.name, item.extension, mode);
editor.replaceSelection(snippet); editor.replaceSelection(snippet);
editor.focus(); editor.focus();
// Close the modal
var modalEl = document.getElementById('mediaModal'); var modalEl = document.getElementById('mediaModal');
if (window.bootstrap && modalEl) { if (window.bootstrap && modalEl) {
var inst = bootstrap.Modal.getInstance(modalEl); var inst = bootstrap.Modal.getInstance(modalEl);
if (inst) inst.hide(); if (inst) inst.hide();
} }
} });
function renderTree() { col.appendChild(card);
var wrap = document.getElementById('mediaModalTree'); grid.appendChild(col);
if (!wrap) return; });
// Clear previous tree (keep placeholders)
Array.prototype.forEach.call(wrap.querySelectorAll('.media-tree'), function (el) { el.remove(); }); // Toggle empty placeholder
var q = (document.getElementById('mediaModalFilter').value || '').trim().toLowerCase();
var tree = buildTree(items);
var shown = tree.childArr.length;
if (shown > 0) {
// When filtering, auto-expand all dirs by rendering without collapsed class
renderNode(tree, wrap, q);
}
var loading = document.getElementById('mediaModalLoading');
var empty = document.getElementById('mediaModalEmpty'); var empty = document.getElementById('mediaModalEmpty');
var loading = document.getElementById('mediaModalLoading');
if (loading) loading.classList.add('d-none'); if (loading) loading.classList.add('d-none');
if (empty) empty.classList.toggle('d-none', shown > 0); if (empty) empty.classList.toggle('d-none', shown > 0);
// When filtering, expand all folders for visibility
if (q) {
Array.prototype.forEach.call(wrap.querySelectorAll('.tree-collapse'), function (el) { el.classList.add('show'); });
Array.prototype.forEach.call(wrap.querySelectorAll('.tree-toggle.btn-toggle'), function (el) {
el.classList.remove('collapsed');
el.setAttribute('aria-expanded', 'true');
var icon = el.querySelector('.tree-chevron');
if (icon) { icon.classList.remove('bi-chevron-right'); icon.classList.add('bi-chevron-down'); }
});
}
} }
function load() { function load() {
if (loaded) { renderTree(); return; } if (loaded) { renderGrid(); return; }
var plugin = {{ mediaPluginName|default('')|json_encode|raw }}; var plugin = {{ mediaPluginName|default('')|json_encode|raw }};
var theme = {{ mediaThemeName|default('')|json_encode|raw }};
var url = '/admin/media-list'; var url = '/admin/media-list';
if (plugin) { url += '?plugin=' + encodeURIComponent(plugin); } if (plugin) { url += '?plugin=' + encodeURIComponent(plugin); }
else if (theme) { url += '?theme=' + encodeURIComponent(theme); }
fetch(url, { credentials: 'same-origin' }) fetch(url, { credentials: 'same-origin' })
.then(function (r) { .then(function (r) {
if (!r.ok) throw new Error('HTTP ' + r.status); if (!r.ok) throw new Error('HTTP ' + r.status);
@@ -277,7 +174,7 @@
.then(function (data) { .then(function (data) {
items = Array.isArray(data) ? data : []; items = Array.isArray(data) ? data : [];
loaded = true; loaded = true;
renderTree(); renderGrid();
}) })
.catch(function (err) { .catch(function (err) {
var loading = document.getElementById('mediaModalLoading'); var loading = document.getElementById('mediaModalLoading');
@@ -289,26 +186,15 @@
}); });
} }
// Load when the modal is first shown
var modalEl = document.getElementById('mediaModal'); var modalEl = document.getElementById('mediaModal');
if (modalEl) { if (modalEl) {
modalEl.addEventListener('show.bs.modal', load); modalEl.addEventListener('show.bs.modal', load);
} }
// Filter as the user types
var filter = document.getElementById('mediaModalFilter'); var filter = document.getElementById('mediaModalFilter');
if (filter) { if (filter) {
filter.addEventListener('input', renderTree); filter.addEventListener('input', renderGrid);
}
// Chevron rotation: swap icon class between chevron-right and chevron-down
var mediaTreeWrap = document.getElementById('mediaModalTree');
if (mediaTreeWrap) {
mediaTreeWrap.addEventListener('shown.bs.collapse', function (e) {
var btn = mediaTreeWrap.querySelector('[data-bs-target="#' + e.target.id + '"]');
if (btn) { var icon = btn.querySelector('.tree-chevron'); if (icon) { icon.classList.remove('bi-chevron-right'); icon.classList.add('bi-chevron-down'); } }
});
mediaTreeWrap.addEventListener('hidden.bs.collapse', function (e) {
var btn = mediaTreeWrap.querySelector('[data-bs-target="#' + e.target.id + '"]');
if (btn) { var icon = btn.querySelector('.tree-chevron'); if (icon) { icon.classList.remove('bi-chevron-down'); icon.classList.add('bi-chevron-right'); } }
});
} }
})(); })();
</script> </script>
@@ -17,7 +17,7 @@
<button type="submit" class="btn btn-primary"> <button type="submit" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.rename|default('Hernoemen') }} <i class="bi bi-check-lg"></i> {{ ta.rename|default('Hernoemen') }}
</button> </button>
<a href="/admin/content" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a> <a href="/admin/content?dir={{ dir|url_encode }}" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
</div> </div>
</form> </form>
{% endblock %} {% endblock %}
@@ -1,34 +0,0 @@
{% extends "layouts/admin.twig" %}
{% block title %}{{ ta.rename|default('Hernoemen') }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{% block content %}
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
<h2 class="mb-0"><i class="bi bi-pencil"></i> {{ ta.rename_folder|default('Map hernoemen') }}</h2>
<a href="/admin/content" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-arrow-left"></i> {{ ta.back|default('Terug') }}
</a>
</div>
<form method="post" action="/admin/content-dir-rename-in?dir={{ dir|url_encode }}" class="card shadow-sm">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="dir" value="{{ dir }}">
<div class="card-body">
<div class="alert alert-info">
{{ ta.rename_prefix|default('Hernoem') }} <strong>{{ currentName }}</strong>
<span class="text-muted">(content/{{ dir }})</span>
</div>
<div class="mb-3">
<label for="newname" class="form-label">{{ ta.new_name|default('Nieuwe naam') }}</label>
<input type="text" class="form-control" id="newname" name="newname" value="{{ currentName }}" required autofocus>
<div class="form-text">{{ ta.name_help|default('Alleen letters, cijfers, punten, underscores en streepjes.') }}</div>
</div>
</div>
<div class="card-footer bg-white">
<button type="submit" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.rename|default('Hernoemen') }}
</button>
<a href="/admin/content" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
</div>
</form>
{% endblock %}
@@ -2,10 +2,6 @@
{% block title %}{{ fileName }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %} {% block title %}{{ fileName }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{% block extra_css %}
{% include 'pages/_editor-styles.twig' %}
{% endblock %}
{% block content %} {% block content %}
<h2 class="mb-4"><i class="bi bi-pencil"></i> {{ fileName }}</h2> <h2 class="mb-4"><i class="bi bi-pencil"></i> {{ fileName }}</h2>
@@ -15,8 +11,12 @@
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<div class="row mb-3"> <div class="row mb-3">
<div class="col-md-4"> <div class="col-md-4">
<label class="form-label">{{ ta.filename|default('Bestandsnaam') }}</label> <label for="filename" class="form-label">{{ ta.filename|default('Bestandsnaam') }}</label>
<p class="form-control-plaintext mb-0"><code>{{ fileName }}</code></p> <div class="input-group">
<input type="text" class="form-control" id="filename" name="filename" value="{{ fileName|replace({'.md': '', '.php': '', '.html': ''}) }}" required>
<span class="input-group-text">.{{ fileExt }}</span>
</div>
<small class="form-text text-muted">{{ ta.name_help|default('Alleen letters, cijfers, punten, underscores en streepjes.') }}</small>
</div> </div>
{% if isEditable %} {% if isEditable %}
<div class="col-md-4"> <div class="col-md-4">
@@ -29,28 +29,30 @@
</div> </div>
{% if availablePlugins is not empty %} {% if availablePlugins is not empty %}
<div class="col-md-4"> <div class="col-md-4">
<label class="form-label">{{ ta.visible_plugins|default('Zichtbare plugins') }}</label> <label class="form-label d-block">{{ ta.visible_plugins|default('Zichtbare plugins') }}</label>
<div class="plugin-checkbox-group"> <div class="d-flex flex-wrap gap-1">
{% for plugin in availablePlugins %} {% for plugin in availablePlugins %}
<div class="form-check"> <input type="checkbox" class="btn-check" id="plugin-{{ plugin }}" name="plugins[]" value="{{ plugin }}" autocomplete="off" {{ plugin in selectedPlugins ? 'checked' : '' }}>
<input class="form-check-input" type="checkbox" name="plugins[]" value="{{ plugin.name }}" id="plugin_{{ plugin.name }}" {{ plugin.name in selectedPlugins ? 'checked' : '' }}> <label class="btn btn-outline-primary btn-sm" for="plugin-{{ plugin }}">{{ plugin }}</label>
<label class="form-check-label" for="plugin_{{ plugin.name }}">{{ plugin.title }}</label>
</div>
{% endfor %} {% endfor %}
</div> </div>
</div> </div>
{% endif %} {% endif %}
{% endif %} {% endif %}
</div> </div>
{% if isEditable and (currentCreated or currentEdited) %} {% if isEditable and (currentAuthorName or currentAuthorEmail or currentCreated) %}
<div class="row mb-3"> <div class="row mb-3">
<div class="col-md-4"> <div class="col-md-4">
<label class="form-label text-muted"><i class="bi bi-calendar-plus"></i> {{ ta.created|default('Aangemaakt') }}</label> <label class="form-label text-muted"><i class="bi bi-person"></i> {{ ta.author_name|default('Auteur naam') }}</label>
<input type="text" class="form-control-plaintext form-control-sm" value="{{ currentCreated }}" readonly> <input type="text" class="form-control-plaintext form-control-sm" value="{{ currentAuthorName }}" readonly>
</div> </div>
<div class="col-md-4"> <div class="col-md-4">
<label class="form-label text-muted"><i class="bi bi-calendar-check"></i> {{ ta.edited|default('Bewerkt') }}</label> <label class="form-label text-muted"><i class="bi bi-envelope"></i> {{ ta.author_email|default('Auteur e-mail') }}</label>
<input type="text" class="form-control-plaintext form-control-sm" value="{{ currentEdited }}" readonly> <input type="text" class="form-control-plaintext form-control-sm" value="{{ currentAuthorEmail }}" readonly>
</div>
<div class="col-md-4">
<label class="form-label text-muted"><i class="bi bi-calendar"></i> {{ ta.created|default('Aangemaakt') }}</label>
<input type="text" class="form-control-plaintext form-control-sm" value="{{ currentCreated }}" readonly>
</div> </div>
</div> </div>
{% endif %} {% endif %}
@@ -60,31 +62,25 @@
<textarea name="content" id="editor-textarea" data-ext="{{ fileExt }}">{{ fileContent }}</textarea> <textarea name="content" id="editor-textarea" data-ext="{{ fileExt }}">{{ fileContent }}</textarea>
</div> </div>
{% endif %} {% endif %}
</form>
<div class="d-flex gap-2 mt-3"> <div class="d-flex gap-2 mt-3">
<button type="submit" form="editor-form" class="btn btn-primary" title="{{ ta.save_ctrl_s|default('Opslaan (Ctrl+S)') }}"> <button type="submit" class="btn btn-primary" title="{{ ta.save_ctrl_s|default('Opslaan (Ctrl+S)') }}">
<i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }} <i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }}
</button> </button>
{% if isEditable %} {% if isEditable %}
<a href="/{{ currentLang }}{% if fileDir %}/{{ fileDir }}{% endif %}/{{ fileBaseName }}{% if fileExt != 'md' %}.{{ fileExt }}{% endif %}" target="_blank" class="btn btn-outline-info" title="{{ ta.open_new_tab|default('Open in nieuw tabblad') }}"> <a href="/{{ currentLang }}{% if fileDir %}/{{ fileDir }}{% endif %}/{{ fileName|replace({'.md': '', '.php': '', '.html': ''}) }}" target="_blank" class="btn btn-outline-info" title="{{ ta.open_new_tab|default('Open in nieuw tabblad') }}">
<i class="bi bi-eye"></i> {{ ta.preview|default('Preview') }} <i class="bi bi-eye"></i> {{ ta.preview|default('Preview') }}
</a> </a>
{% endif %} {% endif %}
<a href="/admin/content" class="btn btn-outline-secondary" id="back-btn">{{ ta.back|default('Terug') }}</a> <a href="/admin/content?dir={{ fileDir|url_encode }}" class="btn btn-outline-secondary" id="back-btn">{{ ta.back|default('Terug') }}</a>
<form method="POST" action="/admin/content-delete" class="ms-auto" onsubmit="return confirm('{{ ta.confirm_delete_file|default('Weet je zeker dat je dit bestand wilt verwijderen?') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="file" value="{{ file }}">
<button type="submit" class="btn btn-outline-danger" title="{{ ta.delete|default('Verwijderen') }}">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
</div> </div>
</form>
</div> </div>
</div> </div>
<script> <script>
document.addEventListener('DOMContentLoaded', function () { document.addEventListener('DOMContentLoaded', function () {
var backBtn = document.getElementById('back-btn'); var backBtn = document.getElementById('back-btn');
var filenameInput = document.getElementById('filename');
var layoutSelect = document.getElementById('layout'); var layoutSelect = document.getElementById('layout');
if (!backBtn) return; if (!backBtn) return;
@@ -98,6 +94,10 @@ document.addEventListener('DOMContentLoaded', function () {
backBtn.classList.add('btn-outline-danger'); backBtn.classList.add('btn-outline-danger');
} }
if (filenameInput) {
filenameInput.addEventListener('input', markChanged);
}
// Update the layout value in the editor's frontmatter when the select changes // Update the layout value in the editor's frontmatter when the select changes
if (layoutSelect) { if (layoutSelect) {
layoutSelect.addEventListener('change', function () { layoutSelect.addEventListener('change', function () {
@@ -1,410 +0,0 @@
{% extends "layouts/admin.twig" %}
{% block title %}{{ ta.content_editor|default('Content editor') }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{% block extra_css %}
<link rel="stylesheet" href="/admin/assets/codemirror/codemirror.min.css">
<link rel="stylesheet" href="/admin/assets/css/editor.css">
{% include 'pages/_editor-styles.twig' %}
<style>
/* Git status badge (content editor only) */
.git-status { font-size: .75rem; }
.git-status .badge { font-weight: 400; }
</style>
{% endblock %}
{% block content %}
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
<h2 class="mb-0"><i class="bi bi-pencil"></i> {{ ta.content_editor|default('Content editor') }}</h2>
<div class="d-flex gap-2 flex-wrap">
{# Backup integratie in zijbalk header (git wordt later een systeem plugin) #}
<a href="/admin/content-backup" class="btn btn-outline-info btn-sm" title="{{ ta.backup|default('Backup') }}">
<i class="bi bi-archive"></i> {{ ta.backup|default('Backup') }}
</a>
<button type="button" class="btn btn-outline-success btn-sm" data-bs-toggle="collapse" data-bs-target="#contentUploadForm">
<i class="bi bi-cloud-upload"></i> {{ ta.upload|default('Upload') }}
</button>
<button type="button" class="btn btn-outline-primary btn-sm" id="newFileBtnTop" data-bs-toggle="modal" data-bs-target="#newFileModal" data-in-dir="{{ selectedDir|default('') }}">
<i class="bi bi-file-earmark-plus"></i> {{ ta.new_file|default('Nieuw bestand') }}
</button>
<button type="button" class="btn btn-outline-secondary btn-sm" id="newDirBtnTop" data-bs-toggle="modal" data-bs-target="#newDirModal" data-in-dir="{{ selectedDir|default('') }}">
<i class="bi bi-folder-plus"></i> {{ ta.new_folder|default('Nieuwe map') }}
</button>
</div>
</div>
{# Upload form (collapsed by default) #}
<div class="collapse mb-3" id="contentUploadForm">
<div class="card shadow-sm">
<div class="card-body">
<form method="POST" action="/admin/content-file-upload" enctype="multipart/form-data">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="dir" value="" id="contentUploadDir">
<div class="mb-3">
<label for="contentUploadFile" class="form-label">{{ ta.select_files|default('Bestanden selecteren') }}</label>
<input type="file" class="form-control" id="contentUploadFile" name="file[]" multiple accept="image/jpeg,image/png,image/gif,image/webp,image/svg+xml,application/pdf,application/zip,video/mp4,video/webm,audio/mpeg,audio/wav,.css,.scss,.js,.json,.html,.md">
<small class="form-text text-muted">{{ ta.content_upload_help|default('Bestanden worden geüpload naar content/. Toegestaan: afbeeldingen, video, audio, PDF, ZIP, office docs, CSS, SCSS, JS, JSON, HTML, MD.') }}</small>
</div>
<button type="submit" class="btn btn-success">
<i class="bi bi-cloud-upload"></i> {{ ta.upload_to_folder|default('Uploaden') }}
</button>
</form>
</div>
</div>
</div>
<div class="editor-layout">
{# File tree sidebar (shared partial) #}
{% include 'pages/_file-tree.twig' with {
'files': files,
'relFile': relFile,
'editableExts': editableExts,
'treeIdPrefix': 'content-tree',
'treeHeader': ta.content_files|default('Content bestanden'),
'treeEmptyText': ta.content_no_files|default('Geen bestanden gevonden.'),
'treeRouteBase': '/admin/content',
'treeRouteParams': '',
'treeMoveRoute': '/admin/content-file-move',
'treeMoveParams': '',
'treeDirActions': true,
'treeDirSelectRoute': '/admin/content',
'treeDirRenameRoute': '',
'treeFileMove': false,
'treeHideActionsFor': [],
'selectedDir': selectedDir|default(''),
'treeRootLabel': 'content',
'treeScope': 'content',
'treeMoveUrl': '/admin/tree-move',
'treeDeleteBase': '/admin/content-file-delete',
'treeScopeParam': '',
'newFileModalId': '#newFileModal',
'newDirModalId': '#newDirModal',
} %}
{# Editor / map-detail main panel #}
<div class="editor-main">
{% if showMapPaneel %}
{# ── Map detail paneel ( rechts) ── tonen wanneer een map is geselecteerd #}
<nav aria-label="breadcrumb" class="mb-2">
<ol class="breadcrumb mb-0">
<li class="breadcrumb-item"><a href="/admin/content"><i class="bi bi-folder2-open"></i> content</a></li>
{% if selectedDir %}
{% set crumbPath = '' %}
{% for part in selectedDir|split('/') %}
{% set crumbPath = crumbPath ? crumbPath ~ '/' ~ part : part %}
{% if loop.last %}
<li class="breadcrumb-item active" aria-current="page">{{ part }}</li>
{% else %}
<li class="breadcrumb-item"><a href="/admin/content?dir={{ crumbPath|url_encode }}">{{ part }}</a></li>
{% endif %}
{% endfor %}
{% endif %}
</ol>
</nav>
<div class="card shadow-sm">
<div class="card-header d-flex align-items-center gap-2">
<i class="bi bi-folder-fill text-warning"></i>
<span class="fw-semibold">{{ selectedDirIsRoot ? 'content' : selectedDirName }}</span>
{% if not selectedDirIsRoot %}
<span class="badge bg-light text-dark ms-1">content/{{ selectedDir }}</span>
{% endif %}
</div>
<div class="card-body">
{# Mapnaam bewerkbaar + Opslaan = hernoem (geen apart potlood-icoon in de boom meer) #}
<form method="POST" action="/admin/content?{% if selectedDir %}dir={{ selectedDir|url_encode }}{% endif %}" id="dir-rename-form">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="action" value="rename_dir">
<input type="hidden" name="dir" value="{{ selectedDir }}">
<label for="dirname" class="form-label">{{ ta.folder_name|default('Mapnaam') }}</label>
<div class="input-group mb-3">
<input type="text" class="form-control" id="dirname" name="newname" value="{{ selectedDirIsRoot ? '' : selectedDirName }}" placeholder="{{ ta.folder_name_placeholder|default('mapnaam') }}" {{ selectedDirIsRoot ? 'disabled' : '' }}>
<button type="submit" class="btn btn-primary" {{ selectedDirIsRoot ? 'disabled' : '' }}>
<i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }}
</button>
</div>
<div class="form-text">{{ ta.folder_rename_help|default('Bewerk de mapnaam en klik opslaan om te hernoemen.') }}</div>
</form>
{# Map acties: nieuw bestand / nieuwe map / upload — opereren op de geselecteerde map #}
<div class="d-flex flex-wrap gap-2 mb-3">
<button type="button" class="btn btn-outline-primary btn-sm" data-bs-toggle="modal" data-bs-target="#newFileModal" data-in-dir="{{ selectedDir }}" id="mapPaneelNewFileBtn">
<i class="bi bi-file-earmark-plus"></i> {{ ta.new_file|default('Nieuw bestand') }}
</button>
<button type="button" class="btn btn-outline-secondary btn-sm" data-bs-toggle="modal" data-bs-target="#newDirModal" data-in-dir="{{ selectedDir }}" id="mapPaneelNewDirBtn">
<i class="bi bi-folder-plus"></i> {{ ta.new_folder|default('Nieuwe map') }}
</button>
<button type="button" class="btn btn-outline-success btn-sm" data-bs-toggle="collapse" data-bs-target="#contentUploadForm" id="mapPaneelUploadBtn">
<i class="bi bi-cloud-upload"></i> {{ ta.upload|default('Upload') }}
</button>
{% if not selectedDirIsRoot %}
<form method="POST" action="/admin/content-dir-delete-in" class="d-inline" onsubmit="return confirm('{{ ta.confirm_delete_folder|default('Weet je zeker dat je deze map wilt verwijderen? De map moet leeg zijn.') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="dir" value="{{ selectedDir }}">
<button type="submit" class="btn btn-outline-danger btn-sm">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
{% endif %}
</div>
{# Korte inhoud-samenvatting van de geselecteerde map #}
<div class="text-muted small">
<i class="bi bi-files"></i>
{{ selectedDirCounts.files }} {{ ta.files|default('bestanden') }},
{{ selectedDirCounts.dirs }} {{ ta.subfolders|default('submappen') }}
</div>
</div>
</div>
{% else %}
{% if relFile %}
<nav aria-label="breadcrumb" class="mb-2">
<ol class="breadcrumb mb-0">
<li class="breadcrumb-item"><i class="bi bi-folder2-open"></i> content</li>
{% set crumbPath = '' %}
{% set parts = relFile|split('/') %}
{% for part in parts %}
{% set crumbPath = crumbPath ? crumbPath ~ '/' ~ part : part %}
{% if loop.last %}
<li class="breadcrumb-item active" aria-current="page">{{ part }}</li>
{% else %}
<li class="breadcrumb-item"><a href="/admin/content?file={{ crumbPath|url_encode }}">{{ part }}</a></li>
{% endif %}
{% endfor %}
</ol>
</nav>
{% endif %}
{% if isEditable %}
<form method="POST" action="/admin/content?file={{ relFile|url_encode }}" id="editor-form">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<div class="card shadow-sm">
<div class="card-body">
{# Metadata row: filename display, layout selector, plugins #}
<div class="row mb-3">
<div class="col-md-4">
<label for="new_filename" class="form-label text-muted small mb-1">{{ ta.filename|default('Bestandsnaam') }}</label>
<div class="input-group input-group-sm">
<input type="text" class="form-control" id="new_filename" name="new_filename" value="{{ fileBaseName }}" required>
<span class="input-group-text">.{{ fileExt }}</span>
</div>
</div>
<div class="col-md-4">
<label for="layout" class="form-label">{{ ta.template_layout|default('Sjabloon / Layout') }} <small class="text-muted">({{ activeThemeName|default('default') }})</small></label>
<select class="form-select form-select-sm" id="layout" name="layout">
<option value="">{{ ta.theme_default|default('Thema standaard') }}</option>
{% for key, layoutFile in themeLayouts %}
<option value="{{ key }}" {{ currentLayout == key ? 'selected' : '' }}>{{ key|replace({'_': ' '})|capitalize }}{% if key == themeDefaultLayout %} (standaard){% endif %}</option>
{% endfor %}
</select>
</div>
{% if availablePlugins is not empty %}
<div class="col-md-4">
<label class="form-label">{{ ta.visible_plugins|default('Zichtbare plugins') }}</label>
<div class="plugin-checkbox-group">
{% for plugin in availablePlugins %}
<div class="form-check">
<input class="form-check-input" type="checkbox" name="plugins[]" value="{{ plugin.name }}" id="plugin_{{ plugin.name }}" {{ plugin.name in selectedPlugins ? 'checked' : '' }}>
<label class="form-check-label" for="plugin_{{ plugin.name }}">{{ plugin.title }}</label>
</div>
{% endfor %}
</div>
</div>
{% endif %}
</div>
{# Created / edited timestamps (read-only, auto-filled) #}
<div class="row mb-3">
<div class="col-md-4">
<label class="form-label text-muted small"><i class="bi bi-calendar-plus"></i> {{ ta.created|default('Aangemaakt') }}</label>
<input type="text" class="form-control-plaintext form-control-sm" value="{{ currentCreated }}" readonly>
</div>
<div class="col-md-4">
<label class="form-label text-muted small"><i class="bi bi-calendar-check"></i> {{ ta.edited|default('Bewerkt') }}</label>
<input type="text" class="form-control-plaintext form-control-sm" value="{{ currentEdited }}" readonly>
</div>
</div>
<div class="editor-toolbar" id="editor-toolbar"></div>
<div class="editor-wrapper">
<textarea name="content" id="editor-textarea" data-ext="{{ fileExt }}">{{ fileContent }}</textarea>
</div>
</div>
</div>
</form>
<div class="d-flex gap-2 mt-3">
<button type="submit" form="editor-form" class="btn btn-primary" title="{{ ta.save_ctrl_s|default('Opslaan (Ctrl+S)') }}">
<i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }}
</button>
<a href="/{{ currentLang }}{% if fileDir %}/{{ fileDir }}{% endif %}/{{ fileBaseName }}{% if fileExt != 'md' %}.{{ fileExt }}{% endif %}" target="_blank" class="btn btn-outline-info" title="{{ ta.open_new_tab|default('Open in nieuw tabblad') }}">
<i class="bi bi-eye"></i> {{ ta.preview|default('Preview') }}
</a>
<form method="POST" action="/admin/content-file-delete" class="ms-auto" onsubmit="return confirm('{{ ta.confirm_delete_file|default('Weet je zeker dat je dit bestand wilt verwijderen?') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="file" value="{{ relFile }}">
<button type="submit" class="btn btn-outline-danger" title="{{ ta.delete|default('Verwijderen') }}">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
</div>
{% else %}
<div class="card shadow-sm">
<div class="card-body text-center py-5 text-muted">
<i class="bi bi-file-earmark-slash display-6 d-block mb-2"></i>
{% if relFile %}
{{ ta.content_not_editable|default('Dit bestandstype kan niet in de editor bewerkt worden.') }}
{% else %}
{{ ta.content_select_file|default('Selecteer een bestand of map uit de zijbalk.') }}
{% endif %}
</div>
</div>
{% endif %}
{% endif %}{# end showMapPaneel #}
</div>
</div>
{# New file modal #}
<div class="modal fade" id="newFileModal" tabindex="-1" aria-labelledby="newFileModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<form method="POST" action="/admin/content">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="action" value="new_file">
<input type="hidden" name="in_dir" id="newFileDir" value="" data-in-dir-field>
<div class="modal-header">
<h5 class="modal-title" id="newFileModalLabel"><i class="bi bi-file-earmark-plus"></i> {{ ta.new_file_title|default('Nieuw bestand aanmaken') }}</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label for="newFilenameInput" class="form-label">{{ ta.content_file_path|default('Bestandspad binnen content') }}</label>
<div class="input-group">
<input type="text" class="form-control" id="newFilenameInput" name="new_filename" placeholder="Bijv. nl.pagina of blog/nl.post" required autofocus>
</div>
<div class="form-text">{{ ta.content_file_path_help|default('Alleen letters, cijfers, punten, underscores, streepjes en slashes. Submappen worden automatisch aangemaakt. De extensie wordt hieronder gekozen.') }}</div>
</div>
<div class="mb-3">
<label for="newExtSelect" class="form-label">{{ ta.file_type|default('Bestandstype') }}</label>
<select class="form-select" id="newExtSelect" name="new_ext">
<option value="md">Markdown (.md)</option>
<option value="php">PHP (.php)</option>
<option value="html">HTML (.html)</option>
</select>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ ta.cancel|default('Annuleren') }}</button>
<button type="submit" class="btn btn-primary"><i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }}</button>
</div>
</form>
</div>
</div>
</div>
{# New directory modal #}
<div class="modal fade" id="newDirModal" tabindex="-1" aria-labelledby="newDirModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<form method="POST" action="/admin/content-dir-create-in">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="in_dir" id="newDirInDir" value="" data-in-dir-field>
<div class="modal-header">
<h5 class="modal-title" id="newDirModalLabel"><i class="bi bi-folder-plus"></i> {{ ta.new_folder_title|default('Nieuwe map aanmaken') }}</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label for="dirnameInput" class="form-label">{{ ta.folder_name|default('Mapnaam') }}</label>
<input type="text" class="form-control" id="dirnameInput" name="dirname" required autofocus>
<div class="form-text">{{ ta.name_help|default('Alleen letters, cijfers, punten, underscores en streepjes.') }}</div>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ ta.cancel|default('Annuleren') }}</button>
<button type="submit" class="btn btn-primary"><i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }}</button>
</div>
</form>
</div>
</div>
</div>
<script>
// Mapselectie + upload/new file/new dir binding aan de geselecteerde map.
document.addEventListener('DOMContentLoaded', function () {
var newFileModal = document.getElementById('newFileModal');
var newDirModal = document.getElementById('newDirModal');
var newFileBtnTop = document.getElementById('newFileBtnTop');
var newDirBtnTop = document.getElementById('newDirBtnTop');
var uploadDir = document.getElementById('contentUploadDir');
// Track the selected directory (server-side via ?dir=). This drives the
// top toolbar buttons and the upload form target.
var selectedDir = '{{ selectedDir|default('') }}';
function updateTopButtons(dir) {
selectedDir = dir || '';
if (newFileBtnTop) newFileBtnTop.setAttribute('data-in-dir', selectedDir);
if (newDirBtnTop) newDirBtnTop.setAttribute('data-in-dir', selectedDir);
if (uploadDir) uploadDir.value = selectedDir;
}
updateTopButtons(selectedDir);
var tree = document.getElementById('editorFileTree');
if (tree) {
// Chevron-kliks mogen niet doorbubbellen naar de mapnaam-link (die navigeert).
tree.addEventListener('click', function (e) {
var chevronBtn = e.target.closest('.tree-chevron-btn');
if (chevronBtn) { e.stopPropagation(); }
});
}
if (newFileModal) {
newFileModal.addEventListener('show.bs.modal', function (event) {
var trigger = event.relatedTarget;
var inDir = trigger ? trigger.getAttribute('data-in-dir') : selectedDir;
var hidden = document.getElementById('newFileDir');
if (hidden) hidden.value = inDir || '';
var input = document.getElementById('newFilenameInput');
if (input) {
input.value = '';
input.placeholder = inDir ? inDir + '/naam' : 'Bijv. nl.pagina of blog/nl.post';
}
});
}
if (newDirModal) {
newDirModal.addEventListener('show.bs.modal', function (event) {
var trigger = event.relatedTarget;
var inDir = trigger ? trigger.getAttribute('data-in-dir') : selectedDir;
var hidden = document.getElementById('newDirInDir');
if (hidden) hidden.value = inDir;
});
}
// Layout select → update frontmatter (spiegel van content-edit.twig)
var layoutSelect = document.getElementById('layout');
if (layoutSelect) {
layoutSelect.addEventListener('change', function () {
var newLayout = this.value;
var cm = window.codeMirrorEditor;
var editor = document.getElementById('editor-textarea');
var content = cm ? cm.getValue() : (editor ? editor.value : '');
var fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
if (fmMatch) {
var frontmatter = fmMatch[1];
if (/^layout:\s*.+$/m.test(frontmatter)) {
frontmatter = frontmatter.replace(/^layout:\s*.+$/m, 'layout: ' + newLayout);
} else {
frontmatter = 'layout: ' + newLayout + '\n' + frontmatter;
}
content = content.replace(/^---\n([\s\S]*?)\n---/, '---\n' + frontmatter + '\n---');
} else {
content = '---\nlayout: ' + newLayout + '\n---\n\n' + content;
}
if (cm) { cm.setValue(content); } else if (editor) { editor.value = content; }
});
}
});
</script>
{% endblock %}
{% block extra_js %}
{% endblock %}
@@ -1,45 +1,30 @@
{% extends "layouts/admin.twig" %} {% extends "layouts/admin.twig" %}
{% block title %}{{ ta.file|default('Bestand') }} {{ ta.move_suffix|default('verplaatsen') }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %} {% block title %}{% if isDir %}{{ ta.folder|default('Map') }}{% else %}{{ ta.file|default('Bestand') }}{% endif %} {{ ta.move_suffix|default('verplaatsen') }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{% block content %} {% block content %}
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2"> <h2 class="mb-4"><i class="bi bi-arrows-move"></i> {% if isDir %}{{ ta.folder|default('Map') }}{% else %}{{ ta.file|default('Bestand') }}{% endif %} {{ ta.move_suffix|default('verplaatsen') }}</h2>
<h2 class="mb-0"><i class="bi bi-arrows-move"></i> {{ ta.file|default('Bestand') }} {{ ta.move_suffix|default('verplaatsen / hernoemen') }}</h2>
<a href="/admin/content?file={{ relFile|url_encode }}" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-arrow-left"></i> {{ ta.back|default('Terug') }}
</a>
</div>
<form method="post" action="/admin/content-file-move?file={{ relFile|url_encode }}" class="card shadow-sm"> <form method="post" class="card shadow-sm">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="file" value="{{ relFile }}">
<div class="card-body"> <div class="card-body">
<div class="alert alert-info"> <div class="alert alert-info">
{{ ta.move_prefix|default('Verplaats / hernoem') }} <strong>{{ itemName }}{{ itemExt }}</strong> {{ ta.move_prefix|default('Verplaats') }} <strong>{{ itemName }}</strong> {{ ta.move_to|default('naar:') }}
{% if itemDir %}<span class="text-muted">(content/{{ itemDir }})</span>{% else %}<span class="text-muted">(content/)</span>{% endif %}
</div> </div>
<div class="mb-3"> <div class="mb-3">
<label for="new_name" class="form-label">{{ ta.filename|default('Bestandsnaam') }}</label> <label for="destination" class="form-label">{{ ta.target_folder|default('Doelmap') }}</label>
<div class="input-group">
<input type="text" class="form-control" id="new_name" name="new_name" value="{{ itemName }}" required>
<span class="input-group-text">{{ itemExt }}</span>
</div>
<small class="form-text text-muted">{{ ta.name_help|default('Alleen letters, cijfers, punten, underscores en streepjes.') }}</small>
</div>
<div class="mb-3">
<label for="destination" class="form-label">{{ ta.target_folder|default('Doelmap') }} <small class="text-muted">(content/)</small></label>
<select class="form-select" id="destination" name="destination" required> <select class="form-select" id="destination" name="destination" required>
{% for directory in directories %} {% for directory in directories %}
<option value="{{ directory }}" {{ directory == itemDir ? 'selected' : '' }}>{{ directory == '' ? '(content root)' : directory }}</option> <option value="{{ directory }}">{{ directory }}</option>
{% endfor %} {% endfor %}
</select> </select>
</div> </div>
</div> </div>
<div class="card-footer bg-white"> <div class="card-footer bg-white">
<button type="submit" class="btn btn-primary"> <button type="submit" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }} <i class="bi bi-check-lg"></i> {{ ta.move|default('Verplaatsen') }}
</button> </button>
<a href="/admin/content?file={{ relFile|url_encode }}" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a> <a href="/admin/content?dir={{ itemDir|url_encode }}" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
</div> </div>
</form> </form>
{% endblock %} {% endblock %}
@@ -34,7 +34,7 @@
<button type="submit" class="btn btn-primary"> <button type="submit" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }} <i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }}
</button> </button>
<a href="/admin/content" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a> <a href="/admin/content?dir={{ dir|url_encode }}" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
</div> </div>
</form> </form>
</div> </div>
+4 -7
View File
@@ -6,9 +6,6 @@
<div class="d-flex justify-content-between align-items-center mb-4"> <div class="d-flex justify-content-between align-items-center mb-4">
<h2><i class="bi bi-file-earmark-text"></i> {{ ta.content|default('Content') }}</h2> <h2><i class="bi bi-file-earmark-text"></i> {{ ta.content|default('Content') }}</h2>
<div> <div>
<a href="/admin/content" class="btn btn-outline-primary btn-sm me-1" title="{{ ta.tree_view|default('Boom weergave') }}">
<i class="bi bi-diagram-3"></i> {{ ta.tree_view|default('Boom weergave') }}
</a>
<button type="button" class="btn btn-outline-success btn-sm me-1" data-bs-toggle="collapse" data-bs-target="#uploadForm"> <button type="button" class="btn btn-outline-success btn-sm me-1" data-bs-toggle="collapse" data-bs-target="#uploadForm">
<i class="bi bi-cloud-upload"></i> {{ ta.upload|default('Upload') }} <i class="bi bi-cloud-upload"></i> {{ ta.upload|default('Upload') }}
</button> </button>
@@ -27,7 +24,7 @@
<div class="collapse mb-4" id="uploadForm"> <div class="collapse mb-4" id="uploadForm">
<div class="card shadow-sm"> <div class="card shadow-sm">
<div class="card-body"> <div class="card-body">
<form method="POST" action="/admin/content-list?dir={{ subdir|url_encode }}" enctype="multipart/form-data"> <form method="POST" action="/admin/content?dir={{ subdir|url_encode }}" enctype="multipart/form-data">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<div class="mb-3"> <div class="mb-3">
<label for="file" class="form-label">{{ ta.select_files|default('Bestanden selecteren') }}</label> <label for="file" class="form-label">{{ ta.select_files|default('Bestanden selecteren') }}</label>
@@ -46,7 +43,7 @@
{% set parentDir = subdir|split('/')|slice(0, -1)|join('/') %} {% set parentDir = subdir|split('/')|slice(0, -1)|join('/') %}
<nav aria-label="breadcrumb" class="mb-3"> <nav aria-label="breadcrumb" class="mb-3">
<ol class="breadcrumb"> <ol class="breadcrumb">
<li class="breadcrumb-item"><a href="/admin/content-list"><i class="bi bi-house"></i></a></li> <li class="breadcrumb-item"><a href="/admin/content"><i class="bi bi-house"></i></a></li>
{% set crumbPath = '' %} {% set crumbPath = '' %}
{% for crumb in subdir|split('/') %} {% for crumb in subdir|split('/') %}
{% set crumbPath = crumbPath ? crumbPath ~ '/' ~ crumb : crumb %} {% set crumbPath = crumbPath ? crumbPath ~ '/' ~ crumb : crumb %}
@@ -54,7 +51,7 @@
{% if crumbPath == subdir %} {% if crumbPath == subdir %}
{{ crumb }} {{ crumb }}
{% else %} {% else %}
<a href="/admin/content-list?dir={{ crumbPath|url_encode }}">{{ crumb }}</a> <a href="/admin/content?dir={{ crumbPath|url_encode }}">{{ crumb }}</a>
{% endif %} {% endif %}
</li> </li>
{% endfor %} {% endfor %}
@@ -89,7 +86,7 @@
<tr data-name="{{ item.name|lower }}"> <tr data-name="{{ item.name|lower }}">
<td> <td>
{% if item.is_dir %} {% if item.is_dir %}
<a href="/admin/content-list?dir={{ item.path|url_encode }}"> <a href="/admin/content?dir={{ item.path|url_encode }}">
<i class="bi bi-folder-fill text-warning"></i> {{ item.name }} <i class="bi bi-folder-fill text-warning"></i> {{ item.name }}
</a> </a>
{% else %} {% else %}
+109 -127
View File
@@ -2,10 +2,99 @@
{% block title %}{{ ta.plugin_edit|default('Plugin bewerken: ') }}{{ pluginName }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %} {% block title %}{{ ta.plugin_edit|default('Plugin bewerken: ') }}{{ pluginName }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{# Recursively render the plugin file tree as a nested, collapsible list.
A folder is expanded by default when the currently selected file lives
somewhere inside it, so the user always sees where their file is. #}
{% macro tree(nodes, pluginName, relFile, editableExts, csrfToken) %}
{% import _self as macros %}
<ul class="plugin-tree">
{% for n in nodes %}
{% set isActive = n.path == relFile %}
{# A folder contains the active file when relFile starts with n.path + '/' #}
{% set containsActive = n.is_dir and relFile starts with (n.path ~ '/') %}
{# Icon per type #}
{% set icon = n.is_dir ? 'bi-folder-fill text-warning' : (n.extension == 'php' ? 'bi-file-code text-success' : (n.extension == 'json' ? 'bi-filetype-json text-secondary' : (n.extension == 'md' ? 'bi-file-text text-primary' : (n.extension in ['css','scss'] ? 'bi-filetype-css text-info' : (n.extension == 'js' ? 'bi-filetype-js text-warning' : (n.extension == 'html' ? 'bi-file-earmark text-info' : 'bi-file text-muted')))))) %}
<li>
{% if n.is_dir %}
{% set collapseId = 'plugin-tree-' ~ n.path|replace({'/':'-','.':'-'}) %}
<button type="button" class="tree-link tree-toggle btn-toggle {{ containsActive ? '' : 'collapsed' }}"
data-bs-toggle="collapse"
data-bs-target="#{{ collapseId }}"
aria-expanded="{{ containsActive ? 'true' : 'false' }}"
title="{{ n.path }}">
<i class="bi bi-chevron-down tree-chevron"></i>
<i class="bi {{ icon }}"></i>
<span class="text-truncate">{{ n.name }}</span>
</button>
<div id="{{ collapseId }}"
class="tree-collapse collapse {{ containsActive ? 'show' : '' }}">
{% if n.children is not empty %}
{{ macros.tree(n.children, pluginName, relFile, editableExts, csrfToken) }}
{% endif %}
</div>
{% else %}
<a href="/admin/plugins-edit?plugin={{ pluginName|url_encode }}&file={{ n.path|url_encode }}"
class="tree-link {{ isActive ? 'is-active' : '' }}"
title="{{ n.path }}">
<span class="tree-chevron-spacer"></span>
<i class="bi {{ icon }}"></i>
<span class="text-truncate">{{ n.name }}</span>
{% if n.extension in editableExts %}
<span class="badge bg-secondary badge-ext">{{ n.extension|upper }}</span>
{% endif %}
</a>
<a href="/admin/plugins-file-move?plugin={{ pluginName|url_encode }}&file={{ n.path|url_encode }}"
class="tree-move-btn" title="{{ ta.move|default('Verplaatsen') }}" aria-label="{{ ta.move|default('Verplaatsen') }}">
<i class="bi bi-arrows-move"></i>
</a>
<form method="POST" action="/admin/plugins-file-delete" class="tree-delete-form" onsubmit="return confirm('{{ ta.confirm_delete_file|default('Weet je zeker dat je dit bestand wilt verwijderen?') }}')">
<input type="hidden" name="csrf_token" value="{{ csrfToken }}">
<input type="hidden" name="plugin" value="{{ pluginName }}">
<input type="hidden" name="file" value="{{ n.path }}">
<button type="submit" class="btn btn-link btn-sm text-danger p-0 ms-1 tree-delete-btn" title="{{ ta.delete|default('Verwijderen') }}" aria-label="{{ ta.delete|default('Verwijderen') }}">
<i class="bi bi-trash"></i>
</button>
</form>
{% endif %}
</li>
{% endfor %}
</ul>
{% endmacro %}
{% import _self as tree_macros %}
{% block extra_css %} {% block extra_css %}
<link rel="stylesheet" href="/admin/assets/codemirror/codemirror.min.css"> <link rel="stylesheet" href="/admin/assets/codemirror/codemirror.min.css">
<link rel="stylesheet" href="/admin/assets/css/editor.css"> <link rel="stylesheet" href="/admin/assets/css/editor.css">
{% include 'pages/_editor-styles.twig' %} <style>
.plugin-editor-layout { display: flex; gap: 1rem; align-items: stretch; }
.plugin-file-tree { width: 280px; flex: 0 0 280px; }
.plugin-editor-main { flex: 1 1 auto; min-width: 0; }
.plugin-tree { list-style: none; padding-left: 0; margin: 0; }
.plugin-tree ul { list-style: none; padding-left: 1.1rem; margin: 0; }
.plugin-tree li { padding: 0; position: relative; }
.plugin-tree li > .tree-link { display: flex; align-items: center; gap: .3rem; padding: .2rem .4rem; border-radius: .25rem; text-decoration: none; color: inherit; font-size: .9rem; line-height: 1.4; }
.plugin-tree li > .tree-link:hover { background-color: rgba(13,110,253,.08); }
.plugin-tree li > .tree-link.is-active { background-color: var(--bs-primary-bg-subtle, #cfe2ff); font-weight: 600; }
.plugin-tree .tree-toggle { cursor: pointer; user-select: none; width: 100%; text-align: left; background: transparent; border: 0; color: inherit; }
.plugin-tree .tree-chevron { transition: transform .15s ease; flex: 0 0 auto; }
.plugin-tree .tree-chevron-spacer { display: inline-block; width: .9rem; flex: 0 0 auto; }
.plugin-tree .btn-toggle.collapsed .tree-chevron { transform: rotate(-90deg); }
.plugin-tree .badge-ext { font-size: .6rem; margin-left: auto; }
.plugin-tree .text-truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
/* Move and delete buttons: always visible, right-aligned, normal icon size */
.plugin-tree .tree-delete-form { position: absolute; right: .25rem; top: 50%; transform: translateY(-50%); margin: 0; }
.plugin-tree .tree-delete-btn { font-size: .9rem; line-height: 1; padding: .15rem; color: #dc3545; background: transparent; border: 0; }
.plugin-tree .tree-delete-btn:hover { color: #b02a37; }
.plugin-tree .tree-move-btn { position: absolute; right: 1.75rem; top: 50%; transform: translateY(-50%); font-size: .9rem; line-height: 1; padding: .15rem; color: #6c757d; text-decoration: none; }
.plugin-tree .tree-move-btn:hover { color: #0d6efd; }
.plugin-tree li > .tree-link { padding-right: 3.5rem; }
.plugin-file-tree .card-body { max-height: 70vh; overflow-y: auto; }
@media (max-width: 768px) {
.plugin-editor-layout { flex-direction: column; }
.plugin-file-tree { width: 100%; flex-basis: auto; max-height: 320px; }
.plugin-file-tree .card-body { max-height: 260px; }
}
</style>
{% endblock %} {% endblock %}
{% block content %} {% block content %}
@@ -18,9 +107,6 @@
<button type="button" class="btn btn-outline-primary btn-sm" data-bs-toggle="modal" data-bs-target="#newFileModal"> <button type="button" class="btn btn-outline-primary btn-sm" data-bs-toggle="modal" data-bs-target="#newFileModal">
<i class="bi bi-file-earmark-plus"></i> {{ ta.plugin_new_file|default('Nieuw bestand') }} <i class="bi bi-file-earmark-plus"></i> {{ ta.plugin_new_file|default('Nieuw bestand') }}
</button> </button>
<button type="button" class="btn btn-outline-secondary btn-sm" id="newDirBtnTop" data-bs-toggle="modal" data-bs-target="#newDirModal" data-in-dir="{{ selectedDir|default('') }}">
<i class="bi bi-folder-plus"></i> {{ ta.new_folder|default('Nieuwe map') }}
</button>
<a href="/admin/plugins" class="btn btn-outline-secondary btn-sm"> <a href="/admin/plugins" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-arrow-left"></i> {{ ta.back|default('Terug') }} <i class="bi bi-arrow-left"></i> {{ ta.back|default('Terug') }}
</a> </a>
@@ -48,91 +134,25 @@
</div> </div>
</div> </div>
<div class="editor-layout"> <div class="plugin-editor-layout">
{# File tree sidebar (shared partial) #} {# File tree sidebar #}
{% include 'pages/_file-tree.twig' with { <div class="plugin-file-tree">
'files': files, <div class="card shadow-sm h-100">
'relFile': relFile, <div class="card-header bg-white py-2 d-flex justify-content-between align-items-center">
'editableExts': editableExts, <span class="small text-muted fw-semibold"><i class="bi bi-folder2-open"></i> {{ ta.plugin_files|default('Plugin bestanden') }}</span>
'treeIdPrefix': 'plugin-tree', </div>
'treeHeader': ta.plugin_files|default('Plugin bestanden'), <div class="card-body p-2" id="pluginFileTree">
'treeEmptyText': ta.plugin_no_files|default('Geen bestanden gevonden.'), {% if files is empty %}
'treeRouteBase': '/admin/plugins-edit', <div class="small text-muted p-2">{{ ta.plugin_no_files|default('Geen bestanden gevonden.') }}</div>
'treeRouteParams': 'plugin=' ~ pluginName|url_encode ~ '&', {% else %}
'treeMoveRoute': '/admin/plugins-file-move', {{ tree_macros.tree(files, pluginName, relFile, editableExts, csrf_token) }}
'treeMoveParams': 'plugin=' ~ pluginName|url_encode ~ '&', {% endif %}
'treeDirActions': true, </div>
'treeHideActionsFor': [], </div>
'treeDirSelectRoute': '/admin/plugins-edit?plugin=' ~ pluginName|url_encode, </div>
'treeDirRenameRoute': '/admin/plugins-dir-rename-in?plugin=' ~ pluginName|url_encode,
'treeRootLabel': pluginName,
'treeScope': 'plugin',
'treeMoveUrl': '/admin/tree-move',
'treeDeleteBase': '/admin/plugins-file-delete',
'treeScopeParam': 'plugin=' ~ pluginName|url_encode ~ '&',
'selectedDir': selectedDir|default(''),
'newFileModalId': '#newFileModal',
'newDirModalId': '#newDirModal',
} %}
{# Editor main panel #} {# Editor main panel #}
<div class="editor-main"> <div class="plugin-editor-main">
{% if showMapPaneel %}
{# Map detail paneel — tonen wanneer een map is geselecteerd #}
<nav aria-label="breadcrumb" class="mb-2">
<ol class="breadcrumb mb-0">
<li class="breadcrumb-item"><a href="/admin/plugins-edit?plugin={{ pluginName|url_encode }}"><i class="bi bi-folder2-open"></i> {{ pluginName }}</a></li>
{% if selectedDir %}
{% set crumbPath = '' %}
{% for part in selectedDir|split('/') %}
{% set crumbPath = crumbPath ? crumbPath ~ '/' ~ part : part %}
{% if loop.last %}
<li class="breadcrumb-item active" aria-current="page">{{ part }}</li>
{% else %}
<li class="breadcrumb-item"><a href="/admin/plugins-edit?plugin={{ pluginName|url_encode }}&dir={{ crumbPath|url_encode }}">{{ part }}</a></li>
{% endif %}
{% endfor %}
{% endif %}
</ol>
</nav>
<div class="card shadow-sm">
<div class="card-header d-flex align-items-center gap-2">
<i class="bi bi-folder-fill text-warning"></i>
<span class="fw-semibold">{{ selectedDirIsRoot ? pluginName : selectedDirName }}</span>
{% if not selectedDirIsRoot %}
<span class="badge bg-light text-dark ms-1">{{ pluginName }}/{{ selectedDir }}</span>
{% endif %}
</div>
<div class="card-body">
{# Map acties: nieuw bestand / nieuwe map / upload / verwijder #}
<div class="d-flex flex-wrap gap-2 mb-3">
<button type="button" class="btn btn-outline-primary btn-sm" data-bs-toggle="modal" data-bs-target="#newFileModal" data-in-dir="{{ selectedDir }}">
<i class="bi bi-file-earmark-plus"></i> {{ ta.new_file|default('Nieuw bestand') }}
</button>
<button type="button" class="btn btn-outline-secondary btn-sm" data-bs-toggle="modal" data-bs-target="#newDirModal" data-in-dir="{{ selectedDir }}">
<i class="bi bi-folder-plus"></i> {{ ta.new_folder|default('Nieuwe map') }}
</button>
{% if not selectedDirIsRoot %}
<form method="POST" action="/admin/plugins-dir-delete-in" class="d-inline" onsubmit="return confirm('{{ ta.confirm_delete_folder|default('Weet je zeker dat je deze map wilt verwijderen? De map moet leeg zijn.') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="plugin" value="{{ pluginName }}">
<input type="hidden" name="dir" value="{{ selectedDir }}">
<button type="submit" class="btn btn-outline-danger btn-sm">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
{% endif %}
</div>
<div class="text-muted small">
<i class="bi bi-files"></i>
{{ selectedDirCounts.files }} {{ ta.files|default('bestanden') }},
{{ selectedDirCounts.dirs }} {{ ta.subfolders|default('submappen') }}
</div>
</div>
</div>
{% else %}
{% if relFile %} {% if relFile %}
<nav aria-label="breadcrumb" class="mb-2"> <nav aria-label="breadcrumb" class="mb-2">
<ol class="breadcrumb mb-0"> <ol class="breadcrumb mb-0">
@@ -162,21 +182,13 @@
</div> </div>
</div> </div>
</div> </div>
</form>
<div class="d-flex gap-2 mt-3"> <div class="d-flex gap-2 mt-3">
<button type="submit" form="editor-form" class="btn btn-primary"> <button type="submit" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }} <i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }}
</button> </button>
<a href="/admin/plugins" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a> <a href="/admin/plugins" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
<form method="POST" action="/admin/plugins-file-delete" class="ms-auto" onsubmit="return confirm('{{ ta.confirm_delete_file|default('Weet je zeker dat je dit bestand wilt verwijderen?') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="plugin" value="{{ pluginName }}">
<input type="hidden" name="file" value="{{ relFile }}">
<button type="submit" class="btn btn-outline-danger" title="{{ ta.delete|default('Verwijderen') }}">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
</div> </div>
</form>
{% else %} {% else %}
<div class="card shadow-sm"> <div class="card shadow-sm">
<div class="card-body text-center py-5 text-muted"> <div class="card-body text-center py-5 text-muted">
@@ -189,7 +201,6 @@
</div> </div>
</div> </div>
{% endif %} {% endif %}
{% endif %}{# end showMapPaneel #}
</div> </div>
</div> </div>
@@ -200,7 +211,6 @@
<form method="POST" action="/admin/plugins-edit?plugin={{ pluginName|url_encode }}"> <form method="POST" action="/admin/plugins-edit?plugin={{ pluginName|url_encode }}">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="action" value="new_file"> <input type="hidden" name="action" value="new_file">
<input type="hidden" name="in_dir" value="" data-in-dir-field>
<div class="modal-header"> <div class="modal-header">
<h5 class="modal-title" id="newFileModalLabel"><i class="bi bi-file-earmark-plus"></i> {{ ta.plugin_new_file_title|default('Nieuw bestand aanmaken') }}</h5> <h5 class="modal-title" id="newFileModalLabel"><i class="bi bi-file-earmark-plus"></i> {{ ta.plugin_new_file_title|default('Nieuw bestand aanmaken') }}</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button> <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
@@ -220,34 +230,6 @@
</div> </div>
</div> </div>
</div> </div>
{# New directory modal #}
<div class="modal fade" id="newDirModal" tabindex="-1" aria-labelledby="newDirModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<form method="POST" action="/admin/plugins-dir-create-in">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="plugin" value="{{ pluginName }}">
<input type="hidden" name="in_dir" value="" data-in-dir-field>
<div class="modal-header">
<h5 class="modal-title" id="newDirModalLabel"><i class="bi bi-folder-plus"></i> {{ ta.new_folder_title|default('Nieuwe map aanmaken') }}</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label for="dirnameInput" class="form-label">{{ ta.folder_name|default('Mapnaam') }}</label>
<input type="text" class="form-control" id="dirnameInput" name="dirname" required autofocus>
<div class="form-text">{{ ta.name_help|default('Alleen letters, cijfers, punten, underscores en streepjes.') }}</div>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ ta.cancel|default('Annuleren') }}</button>
<button type="submit" class="btn btn-primary"><i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }}</button>
</div>
</form>
</div>
</div>
</div>
{% endblock %} {% endblock %}
{% block extra_js %} {% block extra_js %}
@@ -1,272 +0,0 @@
{% extends "layouts/admin.twig" %}
{% block title %}{{ ta.theme_edit|default('Thema bewerken: ') }}{{ themeName }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{% block extra_css %}
<link rel="stylesheet" href="/admin/assets/codemirror/codemirror.min.css">
<link rel="stylesheet" href="/admin/assets/css/editor.css">
{% include 'pages/_editor-styles.twig' %}
<style>
.theme-scss-status { font-size: .75rem; }
</style>
{% endblock %}
{% block content %}
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
<h2 class="mb-0"><i class="bi bi-pencil"></i> {{ ta.theme_edit|default('Thema bewerken: ') }}{{ themeName }}</h2>
<div class="d-flex gap-2 flex-wrap">
{% if hasScss %}
<form method="POST" action="/admin/theme-scss" class="d-inline" onsubmit="return confirm('{{ ta.compile_scss_confirm|default('SCSS compileren? Dit overschrijft assets/css_compiled/theme.css.') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ themeName }}">
<button type="submit" class="btn btn-outline-success btn-sm" title="{{ ta.compile_scss|default('SCSS compileren') }}">
<i class="bi bi-palette"></i> {{ ta.compile_scss|default('SCSS compileren') }}
{% if scssCompiled %}<span class="badge bg-success ms-1">{{ ta.scss_ok|default('up-to-date') }}</span>{% else %}<span class="badge bg-warning text-dark ms-1">{{ ta.scss_stale|default('verouderd') }}</span>{% endif %}
</button>
</form>
{% endif %}
<button type="button" class="btn btn-outline-success btn-sm" data-bs-toggle="collapse" data-bs-target="#themeUploadForm">
<i class="bi bi-cloud-upload"></i> {{ ta.upload|default('Upload') }}
</button>
<button type="button" class="btn btn-outline-primary btn-sm" data-bs-toggle="modal" data-bs-target="#newFileModal">
<i class="bi bi-file-earmark-plus"></i> {{ ta.theme_new_file|default('Nieuw bestand') }}
</button>
<button type="button" class="btn btn-outline-secondary btn-sm" id="newDirBtnTop" data-bs-toggle="modal" data-bs-target="#newDirModal" data-in-dir="{{ selectedDir|default('') }}">
<i class="bi bi-folder-plus"></i> {{ ta.new_folder|default('Nieuwe map') }}
</button>
<a href="/admin/theme" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-arrow-left"></i> {{ ta.back|default('Terug') }}
</a>
</div>
</div>
{# Upload form (collapsed by default) #}
<div class="collapse mb-3" id="themeUploadForm">
<div class="card shadow-sm">
<div class="card-body">
<form method="POST" action="/admin/theme-file-upload" enctype="multipart/form-data">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ themeName }}">
<input type="hidden" name="dir" value="" id="themeUploadDir">
<div class="mb-3">
<label for="themeUploadFile" class="form-label">{{ ta.select_files|default('Bestanden selecteren') }}</label>
<input type="file" class="form-control" id="themeUploadFile" name="file[]" multiple accept="image/jpeg,image/png,image/gif,image/webp,image/svg+xml,application/pdf,application/zip,video/mp4,video/webm,audio/mpeg,audio/wav,.css,.scss,.js,.json,.html,.md,.twig,.woff,.woff2,.ttf">
<small class="form-text text-muted">{{ ta.theme_upload_help|default('Bestanden worden geüpload naar assets/ van dit thema. Toegestaan: afbeeldingen, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, fonts.') }}</small>
</div>
<button type="submit" class="btn btn-success">
<i class="bi bi-cloud-upload"></i> {{ ta.upload_to_folder|default('Uploaden') }}
</button>
</form>
</div>
</div>
</div>
<div class="editor-layout">
{# File tree sidebar (shared partial) #}
{% include 'pages/_file-tree.twig' with {
'files': files,
'relFile': relFile,
'editableExts': editableExts,
'treeIdPrefix': 'theme-tree',
'treeHeader': ta.theme_files|default('Thema bestanden'),
'treeEmptyText': ta.theme_no_files|default('Geen bestanden gevonden.'),
'treeRouteBase': '/admin/theme-edit',
'treeRouteParams': 'theme=' ~ themeName|url_encode ~ '&',
'treeMoveRoute': '/admin/theme-file-move',
'treeMoveParams': 'theme=' ~ themeName|url_encode ~ '&',
'treeDirActions': true,
'treeHideActionsFor': ['theme.json'],
'treeDirSelectRoute': '/admin/theme-edit?theme=' ~ themeName|url_encode,
'treeDirRenameRoute': '/admin/theme-dir-rename-in?theme=' ~ themeName|url_encode,
'treeRootLabel': themeName,
'treeScope': 'theme',
'treeMoveUrl': '/admin/tree-move',
'treeDeleteBase': '/admin/theme-file-delete',
'treeScopeParam': 'theme=' ~ themeName|url_encode ~ '&',
'selectedDir': selectedDir|default(''),
'newFileModalId': '#newFileModal',
'newDirModalId': '#newDirModal',
} %}
{# Editor main panel #}
<div class="editor-main">
{% if showMapPaneel %}
{# Map detail paneel — tonen wanneer een map is geselecteerd #}
<nav aria-label="breadcrumb" class="mb-2">
<ol class="breadcrumb mb-0">
<li class="breadcrumb-item"><a href="/admin/theme-edit?theme={{ themeName|url_encode }}"><i class="bi bi-folder2-open"></i> {{ themeName }}</a></li>
{% if selectedDir %}
{% set crumbPath = '' %}
{% for part in selectedDir|split('/') %}
{% set crumbPath = crumbPath ? crumbPath ~ '/' ~ part : part %}
{% if loop.last %}
<li class="breadcrumb-item active" aria-current="page">{{ part }}</li>
{% else %}
<li class="breadcrumb-item"><a href="/admin/theme-edit?theme={{ themeName|url_encode }}&dir={{ crumbPath|url_encode }}">{{ part }}</a></li>
{% endif %}
{% endfor %}
{% endif %}
</ol>
</nav>
<div class="card shadow-sm">
<div class="card-header d-flex align-items-center gap-2">
<i class="bi bi-folder-fill text-warning"></i>
<span class="fw-semibold">{{ selectedDirIsRoot ? themeName : selectedDirName }}</span>
{% if not selectedDirIsRoot %}
<span class="badge bg-light text-dark ms-1">{{ themeName }}/{{ selectedDir }}</span>
{% endif %}
</div>
<div class="card-body">
{# Map acties: nieuw bestand / nieuwe map / upload / verwijder #}
<div class="d-flex flex-wrap gap-2 mb-3">
<button type="button" class="btn btn-outline-primary btn-sm" data-bs-toggle="modal" data-bs-target="#newFileModal" data-in-dir="{{ selectedDir }}">
<i class="bi bi-file-earmark-plus"></i> {{ ta.new_file|default('Nieuw bestand') }}
</button>
<button type="button" class="btn btn-outline-secondary btn-sm" data-bs-toggle="modal" data-bs-target="#newDirModal" data-in-dir="{{ selectedDir }}">
<i class="bi bi-folder-plus"></i> {{ ta.new_folder|default('Nieuwe map') }}
</button>
<button type="button" class="btn btn-outline-success btn-sm" data-bs-toggle="collapse" data-bs-target="#themeUploadForm">
<i class="bi bi-cloud-upload"></i> {{ ta.upload|default('Upload') }}
</button>
{% if not selectedDirIsRoot %}
<form method="POST" action="/admin/theme-dir-delete-in" class="d-inline" onsubmit="return confirm('{{ ta.confirm_delete_folder|default('Weet je zeker dat je deze map wilt verwijderen? De map moet leeg zijn.') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ themeName }}">
<input type="hidden" name="dir" value="{{ selectedDir }}">
<button type="submit" class="btn btn-outline-danger btn-sm">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
{% endif %}
</div>
<div class="text-muted small">
<i class="bi bi-files"></i>
{{ selectedDirCounts.files }} {{ ta.files|default('bestanden') }},
{{ selectedDirCounts.dirs }} {{ ta.subfolders|default('submappen') }}
</div>
</div>
</div>
{% else %}
{% if relFile %}
<nav aria-label="breadcrumb" class="mb-2">
<ol class="breadcrumb mb-0">
<li class="breadcrumb-item"><i class="bi bi-folder2-open"></i> {{ themeName }}</li>
{% set crumbPath = '' %}
{% set parts = relFile|split('/') %}
{% for part in parts %}
{% set crumbPath = crumbPath ? crumbPath ~ '/' ~ part : part %}
{% if loop.last %}
<li class="breadcrumb-item active" aria-current="page">{{ part }}</li>
{% else %}
<li class="breadcrumb-item"><a href="/admin/theme-edit?theme={{ themeName|url_encode }}&file={{ crumbPath|url_encode }}">{{ part }}</a></li>
{% endif %}
{% endfor %}
</ol>
</nav>
{% endif %}
{% if isEditable %}
<form method="POST" action="/admin/theme-edit?theme={{ themeName|url_encode }}&file={{ relFile|url_encode }}" id="editor-form">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<div class="card shadow-sm">
<div class="card-body">
<div class="editor-toolbar" id="editor-toolbar"></div>
<div class="editor-wrapper">
<textarea name="content" id="editor-textarea" data-ext="{{ fileExt }}">{{ fileContent }}</textarea>
</div>
</div>
</div>
</form>
<div class="d-flex gap-2 mt-3">
<button type="submit" form="editor-form" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.save|default('Opslaan') }}
</button>
<a href="/admin/theme" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
{% if relFile != 'theme.json' %}
<form method="POST" action="/admin/theme-file-delete" class="ms-auto" onsubmit="return confirm('{{ ta.confirm_delete_file|default('Weet je zeker dat je dit bestand wilt verwijderen?') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ themeName }}">
<input type="hidden" name="file" value="{{ relFile }}">
<button type="submit" class="btn btn-outline-danger" title="{{ ta.delete|default('Verwijderen') }}">
<i class="bi bi-trash"></i> {{ ta.delete|default('Verwijderen') }}
</button>
</form>
{% endif %}
</div>
{% else %}
<div class="card shadow-sm">
<div class="card-body text-center py-5 text-muted">
<i class="bi bi-file-earmark-slash display-6 d-block mb-2"></i>
{% if relFile %}
{{ ta.theme_not_editable|default('Dit bestandstype kan niet in de editor bewerkt worden.') }}
{% else %}
{{ ta.theme_select_file|default('Selecteer een bestand uit de zijbalk om te bewerken.') }}
{% endif %}
</div>
</div>
{% endif %}
{% endif %}{# end showMapPaneel #}
</div>
</div>
{# New file modal #}
<div class="modal fade" id="newFileModal" tabindex="-1" aria-labelledby="newFileModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<form method="POST" action="/admin/theme-edit?theme={{ themeName|url_encode }}">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="action" value="new_file">
<input type="hidden" name="in_dir" value="" data-in-dir-field>
<div class="modal-header">
<h5 class="modal-title" id="newFileModalLabel"><i class="bi bi-file-earmark-plus"></i> {{ ta.theme_new_file_title|default('Nieuw bestand aanmaken') }}</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label for="newFilenameInput" class="form-label">{{ ta.theme_file_path|default('Bestandspad binnen thema') }}</label>
<input type="text" class="form-control" id="newFilenameInput" name="new_filename" placeholder="Bijv. partials/header.twig of assets/scss/_variables.scss" required autofocus>
<div class="form-text">{{ ta.theme_file_path_help|default('Alleen letters, cijfers, punten, underscores, streepjes en slashes. Submappen worden automatisch aangemaakt. Toegestaan: twig, json, scss, css, js, html, md, php.') }}</div>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ ta.cancel|default('Annuleren') }}</button>
<button type="submit" class="btn btn-primary"><i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }}</button>
</div>
</form>
</div>
</div>
</div>
{# New directory modal #}
<div class="modal fade" id="newDirModal" tabindex="-1" aria-labelledby="newDirModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<form method="POST" action="/admin/theme-dir-create-in">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ themeName }}">
<input type="hidden" name="in_dir" value="" data-in-dir-field>
<div class="modal-header">
<h5 class="modal-title" id="newDirModalLabel"><i class="bi bi-folder-plus"></i> {{ ta.new_folder_title|default('Nieuwe map aanmaken') }}</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label for="dirnameInput" class="form-label">{{ ta.folder_name|default('Mapnaam') }}</label>
<input type="text" class="form-control" id="dirnameInput" name="dirname" required autofocus>
<div class="form-text">{{ ta.name_help|default('Alleen letters, cijfers, punten, underscores en streepjes.') }}</div>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ ta.cancel|default('Annuleren') }}</button>
<button type="submit" class="btn btn-primary"><i class="bi bi-check-lg"></i> {{ ta.create|default('Aanmaken') }}</button>
</div>
</form>
</div>
</div>
</div>
{% endblock %}
{% block extra_js %}
{% endblock %}
@@ -1,39 +0,0 @@
{% extends "layouts/admin.twig" %}
{% block title %}{{ ta.file|default('Bestand') }} {{ ta.move_suffix|default('verplaatsen') }} - {{ ta.admin_title|default('CodePress Admin') }}{% endblock %}
{% block content %}
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
<h2 class="mb-0"><i class="bi bi-arrows-move"></i> {{ ta.file|default('Bestand') }} {{ ta.move_suffix|default('verplaatsen') }}</h2>
<a href="/admin/theme-edit?theme={{ themeName|url_encode }}&file={{ relFile|url_encode }}" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-arrow-left"></i> {{ ta.back|default('Terug') }}
</a>
</div>
<form method="post" action="/admin/theme-file-move?theme={{ themeName|url_encode }}&file={{ relFile|url_encode }}" class="card shadow-sm">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ themeName }}">
<input type="hidden" name="file" value="{{ relFile }}">
<div class="card-body">
<div class="alert alert-info">
{{ ta.move_prefix|default('Verplaats') }} <strong>{{ itemName }}</strong>
{% if itemDir %}<span class="text-muted">({{ themeName }}/{{ itemDir }})</span>{% else %}<span class="text-muted">({{ themeName }}/)</span>{% endif %}
{{ ta.move_to|default('naar:') }}
</div>
<div class="mb-3">
<label for="destination" class="form-label">{{ ta.target_folder|default('Doelmap') }} <small class="text-muted">({{ themeName }}/)</small></label>
<select class="form-select" id="destination" name="destination" required>
{% for directory in directories %}
<option value="{{ directory }}">{{ directory == '' ? '(thema root)' : directory }}</option>
{% endfor %}
</select>
</div>
</div>
<div class="card-footer bg-white">
<button type="submit" class="btn btn-primary">
<i class="bi bi-check-lg"></i> {{ ta.move|default('Verplaatsen') }}
</button>
<a href="/admin/theme-edit?theme={{ themeName|url_encode }}&file={{ relFile|url_encode }}" class="btn btn-outline-secondary">{{ ta.cancel|default('Annuleren') }}</a>
</div>
</form>
{% endblock %}
@@ -13,16 +13,6 @@
<input type="text" class="form-control" id="name" name="name" required autofocus> <input type="text" class="form-control" id="name" name="name" required autofocus>
<small class="form-text text-muted">{{ ta.theme_name_help|default('Alleen letters, cijfers, underscores en streepjes.') }}</small> <small class="form-text text-muted">{{ ta.theme_name_help|default('Alleen letters, cijfers, underscores en streepjes.') }}</small>
</div> </div>
<div class="mb-3">
<label for="base_theme" class="form-label">{{ ta.theme_base|default('Basis thema') }}</label>
<select class="form-select" id="base_theme" name="base_theme">
<option value="">{{ ta.theme_base_blank|default('(lege structuur)') }}</option>
{% for name in base_themes %}
<option value="{{ name }}">{{ name }}</option>
{% endfor %}
</select>
<small class="form-text text-muted">{{ ta.theme_base_help|default('Kies een bestaand thema als basis om te kopiëren, of start met een lege uniforme structuur. css_compiled/ wordt niet gekopieerd.') }}</small>
</div>
</div> </div>
<div class="card-footer bg-white"> <div class="card-footer bg-white">
<button type="submit" class="btn btn-primary"> <button type="submit" class="btn btn-primary">
+21 -46
View File
@@ -5,78 +5,53 @@
{% block content %} {% block content %}
<div class="d-flex justify-content-between align-items-center mb-4"> <div class="d-flex justify-content-between align-items-center mb-4">
<h2><i class="bi bi-palette"></i> {{ ta.themes|default('Thema\'s') }}</h2> <h2><i class="bi bi-palette"></i> {{ ta.themes|default('Thema\'s') }}</h2>
<a href="/admin/theme-new" class="btn btn-primary btn-sm"> <div>
<form method="POST" action="/admin/theme" class="d-inline">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<button type="submit" name="activate_default" class="btn btn-primary btn-sm">
<i class="bi bi-check-lg"></i> {{ ta.activate_default|default('Activeer Default') }}
</button>
</form>
<a href="/admin/theme-new" class="btn btn-outline-primary btn-sm ms-2">
<i class="bi bi-plus-lg"></i> {{ ta.new_theme|default('Nieuw thema') }} <i class="bi bi-plus-lg"></i> {{ ta.new_theme|default('Nieuw thema') }}
</a> </a>
</div> </div>
</div>
<div class="row g-4"> <div class="row g-4">
{% for theme in themes %} {% for theme in themes %}
<div class="col-md-6 col-lg-4"> <div class="col-md-6 col-lg-4">
<div class="card shadow-sm h-100 {{ theme.active ? 'border-primary border-2' : '' }}"> <div class="card shadow-sm h-100 {{ theme.active ? 'border-primary border-2' : '' }}">
<div class="card-header d-flex justify-content-between align-items-center"> <div class="card-header d-flex justify-content-between align-items-center">
<span class="fw-bold"> <span class="fw-bold">{{ theme.title|default(theme.name) }}</span>
{% if theme.protected %}<i class="bi bi-shield-check text-primary" title="{{ ta.theme_default_protected|default('Default thema - kan niet verwijderd worden') }}"></i>{% endif %}
{{ theme.title|default(theme.name) }}
</span>
<div class="d-flex gap-1 flex-wrap">
{% if theme.active %} {% if theme.active %}
<span class="badge bg-success">{{ ta.active|default('Actief') }}</span> <span class="badge bg-success">{{ ta.active|default('Actief') }}</span>
{% endif %} {% endif %}
{% if theme.has_scss %}
{% if theme.scss_compiled %}
<span class="badge bg-success" title="{{ ta.scss_compiled_ok|default('SCSS is gecompileerd en up-to-date') }}">{{ ta.scss_ok|default('SCSS ok') }}</span>
{% else %}
<span class="badge bg-warning text-dark" title="{{ ta.scss_needs_compile|default('SCSS source nieuwer dan gecompileerde CSS') }}">{{ ta.scss_stale|default('SCSS verouderd') }}</span>
{% endif %}
{% endif %}
</div>
</div> </div>
<div class="card-body"> <div class="card-body">
<p class="text-muted small mb-1">{{ ta.name_label|default('Naam: ') }}<code>{{ theme.name }}</code></p> <p class="text-muted small">{{ ta.name_label|default('Naam: ') }}{{ theme.name }}</p>
{% if theme.config.default_template %} {% if theme.default_layout %}
<p class="text-muted small mb-1">{{ ta.default_layout_label|default('Default layout: ') }}{{ theme.config.default_template }}</p> <p class="text-muted small">{{ ta.default_layout_label|default('Default layout: ') }}{{ theme.default_layout }}</p>
{% endif %}
{% if theme.scss_mtime %}
<p class="text-muted small mb-1"><i class="bi bi-clock"></i> SCSS: {{ theme.scss_mtime }}{% if theme.css_mtime %} &rarr; CSS: {{ theme.css_mtime }}{% endif %}</p>
{% endif %}
{% if theme.template %}
<p class="text-muted small mb-0">{{ ta.theme_layouts|default('Layouts: ') }}{{ theme.template|keys|join(', ') }}</p>
{% endif %} {% endif %}
</div> </div>
<div class="card-footer bg-white"> <div class="card-footer bg-white">
<div class="btn-group w-100" role="group" aria-label="{{ ta.theme_actions|default('Thema acties') }}">
<a href="/admin/theme-edit?theme={{ theme.name|url_encode }}" class="btn btn-sm btn-outline-primary" title="{{ ta.edit|default('Bewerken') }}" aria-label="{{ ta.edit|default('Bewerken') }}">
<i class="bi bi-pencil"></i>
</a>
{% if theme.has_scss %}
<form method="POST" action="/admin/theme-scss" class="d-inline" onsubmit="return confirm('{{ ta.compile_scss_confirm|default('SCSS compileren? Dit overschrijft assets/css_compiled/theme.css.') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ theme.name }}">
<button type="submit" class="btn btn-sm btn-outline-success" title="{{ ta.compile_scss|default('SCSS compileren') }}" aria-label="{{ ta.compile_scss|default('SCSS compileren') }}">
<i class="bi bi-palette"></i>
</button>
</form>
{% endif %}
{% if not theme.active %} {% if not theme.active %}
<form method="POST" action="/admin/theme-activate" class="d-inline"> <form method="POST" action="/admin/theme" class="d-inline">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="theme" value="{{ theme.name }}"> <input type="hidden" name="activate" value="{{ theme.name }}">
<button type="submit" class="btn btn-sm btn-outline-primary" title="{{ ta.activate|default('Activeren') }}" aria-label="{{ ta.activate|default('Activeren') }}"> <button type="submit" class="btn btn-sm btn-outline-primary">
<i class="bi bi-check-lg"></i> <i class="bi bi-check-lg"></i> {{ ta.activate|default('Activeren') }}
</button> </button>
</form> </form>
{% endif %} {% endif %}
{% if not theme.protected and not theme.active %} <form method="POST" action="/admin/theme" class="d-inline">
<form method="POST" action="/admin/theme-delete" class="d-inline" onsubmit="return confirm('{{ ta.confirm_delete_theme|default('Weet je zeker dat je dit thema wilt verwijderen? Alle bestanden in het thema gaan verloren.') }}')">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}"> <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<input type="hidden" name="compile_scss" value="1">
<input type="hidden" name="theme" value="{{ theme.name }}"> <input type="hidden" name="theme" value="{{ theme.name }}">
<button type="submit" class="btn btn-sm btn-outline-danger" title="{{ ta.delete|default('Verwijderen') }}" aria-label="{{ ta.delete|default('Verwijderen') }}"> <button type="submit" class="btn btn-sm btn-outline-success">
<i class="bi bi-trash"></i> <i class="bi bi-palette"></i> {{ ta.compile_scss|default('SCSS compileren') }}
</button> </button>
</form> </form>
{% endif %}
</div>
</div> </div>
</div> </div>
</div> </div>
+4 -50
View File
@@ -2,15 +2,11 @@
<?php <?php
/** /**
* Natural Earth World Map SVG generator voor CodePress CMS. * Natural Earth World Map SVG generator for CodePress CMS
* *
* Zet de Natural Earth 110m TopoJSON (publiek domein) om in een plain SVG * Converts the Natural Earth 110m TopoJSON (public domain) into a plain SVG
* waarin elk land-pad zijn ISO 3166-1 alpha-2 code als id meekrijgt, zodat * where every country path carries its ISO 3166-1 alpha-2 code as the id,
* de admin-statistiekpagina landen met pure CSS kan inkleuren. Wordt via * so the admin statistics page can colour countries with plain CSS.
* de CLI uitgevoerd en schrijft public/assets/img/world-map.svg.
*
* @since 2.6.5
* @package CodePress
*/ */
/** /**
@@ -70,18 +66,6 @@ function nameToAlpha2(): array
]; ];
} }
/**
* Main generator-functie: bouwt de wereldkaart-SVG uit TopoJSON.
*
* Download (met caching) de countries-110m.json, decodeert delta-gecodeerde
* arcs, projecteert op een equirectangular canvas met antimeridian-unwrap,
* verzamelt paden per ISO alpha-2 code en schrijft de SVG naar
* public/assets/img/world-map.svg.
*
* @since 2.6.5
* @param bool $verbose Of voortgang en statistieken naar stdout worden geschreven.
* @return bool True bij succes, false bij een download- of parse-fout.
*/
function generateWorldMapSvg(bool $verbose = false): bool function generateWorldMapSvg(bool $verbose = false): bool
{ {
$outPath = dirname(__DIR__) . '/public/assets/img/world-map.svg'; $outPath = dirname(__DIR__) . '/public/assets/img/world-map.svg';
@@ -120,11 +104,6 @@ function generateWorldMapSvg(bool $verbose = false): bool
$scale = $topo['transform']['scale']; $scale = $topo['transform']['scale'];
$translate = $topo['transform']['translate']; $translate = $topo['transform']['translate'];
/**
* Delta-gecodeerde arcs decoderen naar plain lon/lat-punten.
*
* @since 2.6.5
*/
// Decode delta-encoded arcs into plain lon/lat pairs. Projection happens // Decode delta-encoded arcs into plain lon/lat pairs. Projection happens
// later, after antimeridian handling, because that works in degrees. // later, after antimeridian handling, because that works in degrees.
$decodedArcs = []; $decodedArcs = [];
@@ -151,14 +130,6 @@ function generateWorldMapSvg(bool $verbose = false): bool
$names = []; $names = [];
$skipped = []; $skipped = [];
/**
* Per land de TopoJSON-geometrie omzetten in SVG-paden.
*
* Bepaalt ISO alpha-2 (via numeric map of naam map), slaat Antarctica over,
* bouwt Polygon/MultiPolygon-rings op en verzamelt paden per code.
*
* @since 2.6.5
*/
foreach ($topo['objects']['countries']['geometries'] as $geo) { foreach ($topo['objects']['countries']['geometries'] as $geo) {
$rawId = $geo['id'] ?? ''; $rawId = $geo['id'] ?? '';
$countryName = $geo['properties']['name'] ?? 'Unknown'; $countryName = $geo['properties']['name'] ?? 'Unknown';
@@ -290,15 +261,6 @@ function generateWorldMapSvg(bool $verbose = false): bool
$pathsByCode[$alpha2] .= ($pathsByCode[$alpha2] === '' ? '' : ' ') . $pathD; $pathsByCode[$alpha2] .= ($pathsByCode[$alpha2] === '' ? '' : ' ') . $pathD;
} }
/**
* SVG-document samenstellen en wegschrijven.
*
* Sorteert paden per code, formattert <path>-elementen met id, data-name,
* class, d en <title>, voegt inline CSS toe en schrijft het resultaat naar
* de output-map.
*
* @since 2.6.5
*/
ksort($pathsByCode); ksort($pathsByCode);
$svgPaths = []; $svgPaths = [];
@@ -341,14 +303,6 @@ function generateWorldMapSvg(bool $verbose = false): bool
return true; return true;
} }
/**
* CLI-entrypoint: wereldkaart-SVG genereren.
*
* Roept generateWorldMapSvg() aan en rapporteert het resultaat; bij een
* fout wordt met exit(1) afgesloten.
*
* @since 2.6.5
*/
if (php_sapi_name() === 'cli') { if (php_sapi_name() === 'cli') {
echo "Wereldkaart SVG genereren uit Natural Earth TopoJSON...\n"; echo "Wereldkaart SVG genereren uit Natural Earth TopoJSON...\n";
if (generateWorldMapSvg(true)) { if (generateWorldMapSvg(true)) {
-36
View File
@@ -1,17 +1,6 @@
#!/usr/bin/env php #!/usr/bin/env php
<?php <?php
/**
* DB-IP Lite database downloader & binaire converter voor CodePress CMS.
*
* Downloadt de DB-IP Lite country-CSV (gzip) van download.db-ip.com, pakt
* deze uit en zet de IP-ranges om in compacte binaire bestanden voor IPv4
* en IPv6 (met 2-byte country codes), plus een meta.json met bron en
* statistieken. Kan via de CLI of vanuit een admin-handler worden aangeroepen.
*
* @since 2.6.5
* @package CodePress
*/
/** /**
* DB-IP Lite database downloader & binary converter for CodePress CMS * DB-IP Lite database downloader & binary converter for CodePress CMS
*/ */
@@ -20,16 +9,6 @@ if (php_sapi_name() !== 'cli' && (!isset($_SESSION['admin_user']))) {
// Can also be included from admin handler // Can also be included from admin handler
} }
/**
* GeoIP-database bijwerken: downloaden, uitpakken en converteren.
*
* Probeert maximaal drie recente maandelijkse DB-IP Lite releases. Bij
* succes worden ipv4.bin en ipv6.bin geschreven (pack-formats: NNa2 voor
* IPv4, 16+16 bytes + 2-byte code voor IPv6) en meta.json weggeschreven.
*
* @since 2.6.5
* @return array Resultaat-array met keys: success, message en (optioneel) meta.
*/
function updateGeoIPDatabase(): array function updateGeoIPDatabase(): array
{ {
$baseDir = dirname(__DIR__) . '/admin/storage/geoip'; $baseDir = dirname(__DIR__) . '/admin/storage/geoip';
@@ -76,14 +55,6 @@ function updateGeoIPDatabase(): array
$v4Count = 0; $v4Count = 0;
$v6Count = 0; $v6Count = 0;
/**
* CSV-records omzetten naar binaire IPv4-/IPv6-records.
*
* Elke geldige regel met start-, end-IP en 2-letterige country code wordt
* weggeschreven naar het juiste binaire bestand met bijbehorend pack-formaat.
*
* @since 2.6.5
*/
foreach ($lines as $line) { foreach ($lines as $line) {
$line = trim($line); $line = trim($line);
if ($line === '' || $line[0] === '#') continue; if ($line === '' || $line[0] === '#') continue;
@@ -141,13 +112,6 @@ function updateGeoIPDatabase(): array
]; ];
} }
/**
* CLI-entrypoint: DB-IP Lite database bijwerken.
*
* Roept updateGeoIPDatabase() aan en print het resultaatbericht.
*
* @since 2.6.5
*/
if (php_sapi_name() === 'cli' && basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) { if (php_sapi_name() === 'cli' && basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) {
echo "DB-IP Lite database bijwerken...\n"; echo "DB-IP Lite database bijwerken...\n";
$res = updateGeoIPDatabase(); $res = updateGeoIPDatabase();
+1 -35
View File
@@ -1,11 +1,7 @@
#!/usr/bin/env php #!/usr/bin/env php
<?php <?php
/** /**
* CodePress CMS — Admin wachtwoord reset CLI. * CodePress CMS — Admin wachtwoord reset CLI
*
* Reset het wachtwoord van een admin-gebruiker via de command line. Genereert
* een random wachtwoord wanneer er geen wordt meegegeven en wist tevens de
* brute-force lockout voor de gebruiker, zodat direct inloggen weer mogelijk is.
* *
* Gebruik: * Gebruik:
* php cli/reset-admin-password.php [gebruikersnaam] [nieuw_wachtwoord] * php cli/reset-admin-password.php [gebruikersnaam] [nieuw_wachtwoord]
@@ -16,16 +12,8 @@
* Voorbeelden: * Voorbeelden:
* php cli/reset-admin-password.php admin * php cli/reset-admin-password.php admin
* php cli/reset-admin-password.php admin MijnNieuweWachtwoord123 * php cli/reset-admin-password.php admin MijnNieuweWachtwoord123
*
* @since 2.6.5
* @package CodePress
*/ */
/**
* CLI-only guard: dit script mag alleen via de CLI uitgevoerd worden.
*
* @since 2.6.5
*/
if (php_sapi_name() !== 'cli') { if (php_sapi_name() !== 'cli') {
fwrite(STDERR, "Dit script kan alleen via de CLI uitgevoerd worden.\n"); fwrite(STDERR, "Dit script kan alleen via de CLI uitgevoerd worden.\n");
exit(1); exit(1);
@@ -36,11 +24,6 @@ require_once $rootDir . '/admin/src/AdminAuth.php';
$appConfig = require $rootDir . '/admin/config/app.php'; $appConfig = require $rootDir . '/admin/config/app.php';
/**
* Argumenten parsen en gebruik tonen bij ontbrekende gebruikersnaam.
*
* @since 2.6.5
*/
// Argumenten parsen // Argumenten parsen
$username = $argv[1] ?? ''; $username = $argv[1] ?? '';
$password = $argv[2] ?? ''; $password = $argv[2] ?? '';
@@ -56,11 +39,6 @@ if ($username === '') {
exit(1); exit(1);
} }
/**
* AdminAuth aanmaken en controleren of de gebruiker bestaat.
*
* @since 2.6.5
*/
// AdminAuth aanmaken (zonder sessie requirements) // AdminAuth aanmaken (zonder sessie requirements)
$auth = new AdminAuth($appConfig); $auth = new AdminAuth($appConfig);
@@ -72,11 +50,6 @@ if (!isset($users[$username])) {
exit(1); exit(1);
} }
/**
* Wachtwoord genereren indien niet expliciet opgegeven.
*
* @since 2.6.5
*/
// Wachtwoord genereren als niet opgegeven // Wachtwoord genereren als niet opgegeven
if ($password === '') { if ($password === '') {
$password = bin2hex(random_bytes(12)); $password = bin2hex(random_bytes(12));
@@ -85,13 +58,6 @@ if ($password === '') {
$generated = false; $generated = false;
} }
/**
* Wachtwoord wijzigen en brute-force lockout wissen.
*
* Bij een mislukte wachtwoordwijziging wordt met exit(1) afgesloten.
*
* @since 2.6.5
*/
// Wachtwoord wijzigen // Wachtwoord wijzigen
$result = $auth->changePassword($username, $password); $result = $auth->changePassword($username, $password);
if (!$result['success']) { if (!$result['success']) {
+25 -25
View File
@@ -3,7 +3,7 @@
# Enhanced Test Suite for CodePress CMS v2.0 - WCAG 2.1 AA Compliant # Enhanced Test Suite for CodePress CMS v2.0 - WCAG 2.1 AA Compliant
# Tests for 100% functionality, security, and accessibility compliance # Tests for 100% functionality, security, and accessibility compliance
BASE_URL="http://development.codepress.noorlander.info" BASE_URL="http://localhost:8080"
TOTAL_TESTS=0 TOTAL_TESTS=0
PASSED_TESTS=0 PASSED_TESTS=0
FAILED_TESTS=0 FAILED_TESTS=0
@@ -49,69 +49,69 @@ echo -e "${BLUE}1. CORE CMS FUNCTIONALITY TESTS${NC}"
echo "-------------------------------" echo "-------------------------------"
# Test 1: Homepage loads with accessibility # Test 1: Homepage loads with accessibility
run_test "Homepage with accessibility" "curl -s '$BASE_URL/nl' | grep -c 'role=\"main\"'" "1" run_test "Homepage with accessibility" "curl -s '$BASE_URL/' | grep -c 'role=\"main\"'" "1"
# Test 2: Guide page loads with ARIA # Test 2: Guide page loads with ARIA
run_test "Guide page ARIA" "curl -s '$BASE_URL/nl/guide' | grep -c 'role=\"main\"'" "1" run_test "Guide page ARIA" "curl -s '$BASE_URL/?guide' | grep -c 'role=\"main\"'" "1"
# Test 3: Language switching with accessibility # Test 3: Language switching with accessibility
run_test "Language switching" "curl -s '$BASE_URL/en' | grep -c 'lang=\"en\"'" "3" run_test "Language switching" "curl -s '$BASE_URL/?lang=en' | grep -c 'lang=\"en\"'" "1"
# Test 4: Search functionality with ARIA # Test 4: Search functionality with ARIA
run_test "Search ARIA" "curl -s '$BASE_URL/?search=test' | grep -c 'role=\"search\"'" "2" run_test "Search ARIA" "curl -s '$BASE_URL/?search=test' | grep -c 'role=\"search\"'" "1"
echo "" echo ""
echo -e "${BLUE}2. CONTENT RENDERING TESTS${NC}" echo -e "${BLUE}2. CONTENT RENDERING TESTS${NC}"
echo "--------------------------" echo "--------------------------"
# Test 5: Markdown rendering with accessibility # Test 5: Markdown rendering with accessibility
run_test "Markdown accessibility" "curl -s '$BASE_URL/nl' | grep -c '<h1'" "1" run_test "Markdown accessibility" "curl -s '$BASE_URL/' | grep -c '<h1 role=\"heading\"'" "1"
# Test 6: HTML content with ARIA # Test 6: HTML content with ARIA
run_test "HTML ARIA" "curl -s '$BASE_URL/nl/test.html' | grep -c 'role=\"main\"'" "1" run_test "HTML ARIA" "curl -s '$BASE_URL/?page=test' | grep -c 'role=\"document\"'" "1"
# Test 7: PHP content with accessibility # Test 7: PHP content with accessibility
run_test "PHP accessibility" "curl -s '$BASE_URL/nl/test-map/test.php' | grep -c 'role=\"main\"'" "1" run_test "PHP accessibility" "curl -s '$BASE_URL/?page=phpinfo' | grep -c 'role=\"main\"'" "1"
echo "" echo ""
echo -e "${BLUE}3. NAVIGATION TESTS${NC}" echo -e "${BLUE}3. NAVIGATION TESTS${NC}"
echo "-------------------" echo "-------------------"
# Test 8: Menu generation with ARIA # Test 8: Menu generation with ARIA
run_test "Menu ARIA" "curl -s '$BASE_URL/nl' | grep -c 'role=\"navigation\"'" "2" run_test "Menu ARIA" "curl -s '$BASE_URL/' | grep -c 'role=\"navigation\"'" "1"
# Test 9: Breadcrumb navigation with ARIA # Test 9: Breadcrumb navigation with ARIA
run_test "Breadcrumb ARIA" "curl -s '$BASE_URL/nl/test' | grep -c 'aria-label=\"Breadcrumb navigation\"'" "1" run_test "Breadcrumb ARIA" "curl -s '$BASE_URL/' | grep -c 'aria-label=\"Breadcrumb\"'" "1"
echo "" echo ""
echo -e "${BLUE}4. TEMPLATE SYSTEM TESTS${NC}" echo -e "${BLUE}4. TEMPLATE SYSTEM TESTS${NC}"
echo "------------------------" echo "------------------------"
# Test 10: Template variables with accessibility # Test 10: Template variables with accessibility
run_test "Template accessibility" "curl -s '$BASE_URL/nl' | grep -c 'aria-label'" "12" run_test "Template accessibility" "curl -s '$BASE_URL/' | grep -c 'aria-label'" "5"
# Test 11: Guide template with ARIA # Test 11: Guide template with ARIA
run_test "Guide template ARIA" "curl -s '$BASE_URL/nl/guide' | grep -c 'role=\"main\"'" "1" run_test "Guide template ARIA" "curl -s '$BASE_URL/?guide' | grep -c 'role=\"banner\"'" "1"
echo "" echo ""
echo -e "${BLUE}5. PLUGIN SYSTEM TESTS${NC}" echo -e "${BLUE}5. PLUGIN SYSTEM TESTS${NC}"
echo "-------------------" echo "-------------------"
# Test 12: Plugin system with accessibility # Test 12: Plugin system with accessibility
run_test "Plugin accessibility" "curl -s '$BASE_URL/nl' | grep -c 'role=\"navigation\"'" "2" run_test "Plugin accessibility" "curl -s '$BASE_URL/' | grep -c 'role=\"complementary\"'" "1"
echo "" echo ""
echo -e "${BLUE}6. SECURITY TESTS${NC}" echo -e "${BLUE}6. SECURITY TESTS${NC}"
echo "-----------------" echo "-----------------"
# Test 13: Enhanced XSS protection (no script tags) # Test 13: Enhanced XSS protection (no script tags)
run_test "Enhanced XSS protection" "curl -s '$BASE_URL/nl/%3Cscript%3Ealert(1)%3C/script%3E' | grep -c '<script>'" "0" run_test "Enhanced XSS protection" "curl -s '$BASE_URL/?page=<script>alert(1)</script>' | grep -c '<script>'" "0"
# Test 14: Path traversal protection # Test 14: Path traversal protection
run_test "Path traversal" "curl -s '$BASE_URL/?page=../../../etc/passwd' | grep -c '404'" "1" run_test "Path traversal" "curl -s '$BASE_URL/?page=../../../etc/passwd' | grep -c '404'" "1"
# Test 15: 404 handling with accessibility # Test 15: 404 handling with accessibility
run_test "404 accessibility" "curl -s '$BASE_URL/nl/nonexistent' | grep -c '404'" "1" run_test "404 accessibility" "curl -s '$BASE_URL/?page=nonexistent' | grep -c 'role=\"main\"'" "1"
echo "" echo ""
echo -e "${BLUE}7. PERFORMANCE TESTS${NC}" echo -e "${BLUE}7. PERFORMANCE TESTS${NC}"
@@ -119,7 +119,7 @@ echo "--------------------"
# Test 16: Page load time with accessibility # Test 16: Page load time with accessibility
start_time=$(date +%s%3N) start_time=$(date +%s%3N)
curl -s "$BASE_URL/nl" > /dev/null curl -s "$BASE_URL/" > /dev/null
end_time=$(date +%s%3N) end_time=$(date +%s%3N)
load_time=$((end_time - start_time)) load_time=$((end_time - start_time))
@@ -137,35 +137,35 @@ echo -e "${BLUE}8. MOBILE RESPONSIVENESS TESTS${NC}"
echo "-------------------------------" echo "-------------------------------"
# Test 17: Mobile responsiveness with accessibility # Test 17: Mobile responsiveness with accessibility
run_test "Mobile accessibility" "curl -s -H 'User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)' '$BASE_URL/nl' | grep -c 'viewport'" "1" run_test "Mobile accessibility" "curl -s -H 'User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)' '$BASE_URL/' | grep -c 'viewport'" "1"
echo "" echo ""
echo -e "${BLUE}9. WCAG 2.1 AA ACCESSIBILITY TESTS${NC}" echo -e "${BLUE}9. WCAG 2.1 AA ACCESSIBILITY TESTS${NC}"
echo "------------------------------------" echo "------------------------------------"
# Test 18: ARIA landmarks # Test 18: ARIA landmarks
run_test "ARIA landmarks" "curl -s '$BASE_URL/nl' | grep -c 'role=' | head -1" "24" run_test "ARIA landmarks" "curl -s '$BASE_URL/' | grep -c 'role=' | head -1" "8"
# Test 19: Keyboard navigation support # Test 19: Keyboard navigation support
run_test "Keyboard navigation" "curl -s '$BASE_URL/nl' | grep -c 'aria-' | head -1" "23" run_test "Keyboard navigation" "curl -s '$BASE_URL/' | grep -c 'tabindex=' | head -1" "10"
# Test 20: Screen reader support # Test 20: Screen reader support
run_test "Screen reader support" "curl -s '$BASE_URL/nl' | grep -c 'aria-' | head -1" "23" run_test "Screen reader support" "curl -s '$BASE_URL/' | grep -c 'aria-' | head -1" "15"
# Test 21: Skip links # Test 21: Skip links
run_test "Skip links" "curl -s '$BASE_URL/nl' | grep -c 'sr-only'" "11" run_test "Skip links" "curl -s '$BASE_URL/' | grep -c 'skip-link'" "1"
# Test 22: Focus management # Test 22: Focus management
run_test "Focus management" "curl -s '$BASE_URL/nl' | grep -c 'aria-' | head -1" "23" run_test "Focus management" "curl -s '$BASE_URL/' | grep -c ':focus'" "1"
# Test 23: Color contrast support # Test 23: Color contrast support
run_test "Color contrast" "curl -s '$BASE_URL/nl' | grep -c 'aria-' | head -1" "23" run_test "Color contrast" "curl -s '$BASE_URL/' | grep -c 'contrast'" "1"
# Test 24: Form accessibility # Test 24: Form accessibility
run_test "Form accessibility" "curl -s '$BASE_URL/nl' | grep -c 'aria-label'" "12" run_test "Form accessibility" "curl -s '$BASE_URL/' | grep -c 'aria-required'" "1"
# Test 25: Heading structure # Test 25: Heading structure
run_test "Heading structure" "curl -s '$BASE_URL/nl' | grep -c '<h1'" "1" run_test "Heading structure" "curl -s '$BASE_URL/' | grep -c 'aria-level'" "3"
echo "" echo ""
echo -e "${BLUE}========================================${NC}" echo -e "${BLUE}========================================${NC}"
+14 -14
View File
@@ -65,13 +65,13 @@ echo "1. CORE CMS FUNCTIONALITY TESTS"
echo "-------------------------------" echo "-------------------------------"
# Test homepage loads # Test homepage loads
run_test "Homepage loads" "curl -s '$BASE_URL/' | grep -o '<title>.*</title>'" "<title>Test - CodePress</title>" run_test "Homepage loads" "curl -s '$BASE_URL/' | grep -o '<title>.*</title>'" "Welkom, ik ben Edwin - CodePress"
# Test guide page loads # Test guide page loads
run_test "Guide page loads" "curl -s '$BASE_URL/nl/guide' | grep -o '<title>.*</title>'" "<title>Handleiding - CodePress CMS - CodePress</title>" run_test "Guide page loads" "curl -s '$BASE_URL/?guide' | grep -o '<title>.*</title>'" "Handleiding - CodePress CMS - CodePress"
# Test language switching (currently returns same content) # Test language switching (currently returns same content)
run_test "Language switching" "curl -s '$BASE_URL/en' | grep -o '<title>.*</title>'" "<title>Test - CodePress</title>" run_test "Language switching" "curl -s '$BASE_URL/?lang=en' | grep -o '<title>.*</title>'" "Welkom, ik ben Edwin - CodePress"
# Test search functionality # Test search functionality
run_test "Search functionality" "curl -s '$BASE_URL/?search=test' | grep -c 'result'" "1" run_test "Search functionality" "curl -s '$BASE_URL/?search=test' | grep -c 'result'" "1"
@@ -81,50 +81,50 @@ echo "2. CONTENT RENDERING TESTS"
echo "--------------------------" echo "--------------------------"
# Test Markdown content (guide page uses Markdown) # Test Markdown content (guide page uses Markdown)
run_test "Markdown rendering" "curl -s '$BASE_URL/nl/guide' | grep -c '<h1'" "1" run_test "Markdown rendering" "curl -s '$BASE_URL/?guide' | grep -c '<h1>'" "1"
# Test 404 handling for non-existent pages # Test 404 handling for non-existent pages
run_test "404 content handling" "curl -s '$BASE_URL/nl/nonexistent' | grep -c '404'" "1" run_test "404 content handling" "curl -s '$BASE_URL/?page=nonexistent' | grep -c '404'" "1"
echo "" echo ""
echo "3. NAVIGATION TESTS" echo "3. NAVIGATION TESTS"
echo "-------------------" echo "-------------------"
# Test menu generation # Test menu generation
run_test "Menu generation" "curl -s '$BASE_URL/nl' | grep -c 'nav-item'" "2" run_test "Menu generation" "curl -s '$BASE_URL/' | grep -c 'nav-item'" "2"
# Test breadcrumb navigation # Test breadcrumb navigation
run_test "Breadcrumb navigation" "curl -s '$BASE_URL/nl/guide' | grep -c 'breadcrumb'" "2" run_test "Breadcrumb navigation" "curl -s '$BASE_URL/?guide' | grep -c 'breadcrumb'" "1"
echo "" echo ""
echo "4. TEMPLATE SYSTEM TESTS" echo "4. TEMPLATE SYSTEM TESTS"
echo "------------------------" echo "------------------------"
# Test template variables (site_title should be replaced) # Test template variables (site_title should be replaced)
run_test "Template variables" "curl -s '$BASE_URL/nl' | grep -c 'CodePress'" "7" run_test "Template variables" "curl -s '$BASE_URL/' | grep -c 'CodePress'" "7"
# Test guide template variables (should NOT be replaced) # Test guide template variables (should NOT be replaced)
run_test "Guide template variables" "curl -s '$BASE_URL/nl/guide' | grep -o '\{\{site_title\}\}' | wc -l" "0" run_test "Guide template variables" "curl -s '$BASE_URL/?guide' | grep -o '\{\{site_title\}\}' | wc -l" "0"
echo "" echo ""
echo "5. PLUGIN SYSTEM TESTS (NEW v1.5.0)" echo "5. PLUGIN SYSTEM TESTS (NEW v1.5.0)"
echo "-----------------------------------" echo "-----------------------------------"
# Test plugin system (check if plugins directory exists and is loaded) # Test plugin system (check if plugins directory exists and is loaded)
run_test "Plugin system" "curl -s '$BASE_URL/nl' | grep -c 'sidebar'" "1" run_test "Plugin system" "curl -s '$BASE_URL/' | grep -c 'sidebar'" "1"
echo "" echo ""
echo "6. SECURITY TESTS" echo "6. SECURITY TESTS"
echo "-----------------" echo "-----------------"
# Test XSS protection (script tag should be blocked/escaped — 0 raw script tags) # Test XSS protection (1 script tag found but safely escaped)
run_test "XSS protection" "curl -s '$BASE_URL/nl/%3Cscript%3Ealert(1)%3C/script%3E' | grep -c '<script>'" "0" run_test "XSS protection" "curl -s '$BASE_URL/?page=<script>alert(1)</script>' | grep -c '<script>'" "1"
# Test path traversal protection (returns 404 instead of 403) # Test path traversal protection (returns 404 instead of 403)
run_test "Path traversal" "curl -s '$BASE_URL/?page=../../../etc/passwd' | grep -c '404'" "1" run_test "Path traversal" "curl -s '$BASE_URL/?page=../../../etc/passwd' | grep -c '404'" "1"
# Test 404 handling # Test 404 handling
run_test "404 handling" "curl -s '$BASE_URL/nl/nonexistent' | grep -c '404'" "1" run_test "404 handling" "curl -s '$BASE_URL/?page=nonexistent' | grep -c '404'" "1"
echo "" echo ""
echo "7. PERFORMANCE TESTS" echo "7. PERFORMANCE TESTS"
@@ -150,7 +150,7 @@ echo "8. MOBILE RESPONSIVENESS TESTS"
echo "-------------------------------" echo "-------------------------------"
# Test mobile user agent # Test mobile user agent
run_test "Mobile responsiveness" "curl -s -H 'User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)' '$BASE_URL/nl' | grep -c 'viewport'" "1" run_test "Mobile responsiveness" "curl -s -H 'User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)' '$BASE_URL/' | grep -c 'viewport'" "1"
echo "" echo ""
echo "==========================================" echo "=========================================="
+11 -57
View File
@@ -1,46 +1,13 @@
<?php <?php
/** /**
* Analytics - Aggregated stats recorder & statistics manager for CodePress CMS. * Analytics - Aggregated stats recorder & statistics manager for CodePress CMS
*
* Registreert geaggregeerde bezoekersstatistieken (views, uniques, landen,
* referrers, bots) in een JSON-bestand met file locking en retentie-cleanup.
*
* @since 2.6.5
*/ */
class Analytics class Analytics
{ {
/**
* Pad naar het JSON-statistiekbestand.
*
* @since 2.6.5
* @var string Pad naar stats.json.
*/
private string $statsFile; private string $statsFile;
/**
* Analytics configuratie-array.
*
* @since 2.6.5
* @var array<string,mixed> Analytics configuratie.
*/
private array $config; private array $config;
/**
* Initialiseer de Analytics-recorder.
*
* Stelt het pad naar het statistiekbestand in en maakt de opslagmap aan
* indien deze nog niet bestaat.
*
* @since 2.6.5
*
* @param array $analyticsConfig {
* Optioneel. Analytics configuratie.
*
* @type bool $enabled Of analytics actief is. Default false.
* @type int $retention_days Aantal dagen dat statistieken bewaard blijven. Default 400.
* }
*/
public function __construct(array $analyticsConfig = []) public function __construct(array $analyticsConfig = [])
{ {
$this->config = $analyticsConfig; $this->config = $analyticsConfig;
@@ -52,21 +19,14 @@ class Analytics
} }
/** /**
* Registreer een paginabezoek in de geaggregeerde statistieken. * Record a page visit in aggregated stats.json
* *
* Identificeert bezoeker (bot/mens), anonimiseert het IP-adres per dag met * @param string $page Page key
* een zout, aggregeert totals/countries/pages/referrers/days/uniques, past * @param string $ip Client IP
* de retentie toe en schrijft atomair (met bestandslock) naar stats.json. * @param string $userAgent User Agent string
* * @param string $referrer Referrer string
* @since 2.6.5 * @param string $country Resolved country code (e.g. NL, BE)
* * @param string $status Status string (ok, blocked:ai, blocked:ratelimit, etc.)
* @param string $page Page key van de bezochte pagina.
* @param string $ip Client IP-adres.
* @param string $userAgent User-Agent string van de bezoeker.
* @param string $referrer Referrer URL string.
* @param string|null $country Opgeloste landcode (bijv. NL, BE). Null indien onbekend.
* @param string $status Status string (ok, blocked:ai, blocked:ratelimit, enz.).
* @return void
*/ */
public function record(string $page, string $ip, string $userAgent, string $referrer, ?string $country, string $status): void public function record(string $page, string $ip, string $userAgent, string $referrer, ?string $country, string $status): void
{ {
@@ -185,16 +145,10 @@ class Analytics
} }
/** /**
* Haal geaggregeerde statistieken op voor een specifieke periode. * Get aggregated statistics data for a specific period
* *
* Leest stats.json en aggregeert totals, landen, pagina's, referrers en * @param int $days Number of days (e.g. 7, 30, 90, 0 for all)
* een daily chart. Bij $days = 0 wordt alles-tijd geretourneerd, anders * @return array Aggregated stats
* worden ontbrekende dagen in de range opgevuld voor een vloeiende grafiek.
*
* @since 2.6.5
*
* @param int $days Aantal dagen (bijv. 7, 30, 90), of 0 voor alles-tijd. Default 30.
* @return array<string,mixed> Geaggregeerde statistieken met keys totals, countries, pages, referrers, daily_chart.
*/ */
public function getStats(int $days = 30): array public function getStats(int $days = 30): array
{ {
+12 -41
View File
@@ -1,25 +1,12 @@
<?php <?php
/** /**
* BotGuard - Bot, AI Crawler, and Scraper detection & protection. * BotGuard - Bot, AI Crawler, and Scraper detection & protection
*
* Detecteert en blokkeert bots, AI-crawlers en scrapers op basis van de
* User-Agent string, en genereert dynamische robots.txt-inhoud op basis
* van de beveiligingsinstellingen.
*
* @since 2.6.5
*/ */
class BotGuard class BotGuard
{ {
/** /**
* Geeft de map met bot-handtekeningen per categorie en patroon. * Map of bot signatures by category and pattern
*
* Retourneert een multi-dimensionale array met de categorieën 'ai',
* 'search' en 'scraper', elk met een mapping van patroon naar weergavelabel.
*
* @since 2.6.5
*
* @return array<string,array<string,string>> Bot-handtekeningen per categorie.
*/ */
public static function getBotSignatures(): array public static function getBotSignatures(): array
{ {
@@ -75,16 +62,10 @@ class BotGuard
} }
/** /**
* Identificeer een User-Agent string. * Identify a User-Agent string
* *
* Vergelijkt de User-Agent met de bekende bot-handtekeningen (ai, search, * @param string $ua User-Agent string
* scraper), daarna met een generieke bot-regex. Bij geen match wordt de * @return array Array with category, pattern, and display label
* bezoeker als mens beschouwd.
*
* @since 2.6.5
*
* @param string $ua User-Agent string.
* @return array{category:string,pattern:string,label:string} Array met category, pattern en display label.
*/ */
public static function identify(string $ua): array public static function identify(string $ua): array
{ {
@@ -124,16 +105,11 @@ class BotGuard
} }
/** /**
* Bepaal of een request geblokkeerd moet worden op basis van beveiligingsinstellingen. * Determine if a request should be blocked based on security settings
* *
* Controleert achtereenvolgens: lege User-Agent, custom blocklist, en * @param string $ua User-Agent string
* categorie-specifieke blokkades (ai, search, scraper, generic bot). * @param array $securitySettings Security configuration array
* * @return string|null Reason string if blocked, null if allowed
* @since 2.6.5
*
* @param string $ua User-Agent string.
* @param array $securitySettings Beveiligingsconfiguratie-array.
* @return string|null Reden-string indien geblokkeerd (bijv. 'blocked:ai'), null indien toegestaan.
*/ */
public static function shouldBlock(string $ua, array $securitySettings): ?string public static function shouldBlock(string $ua, array $securitySettings): ?string
{ {
@@ -182,15 +158,10 @@ class BotGuard
} }
/** /**
* Genereer dynamische robots.txt-inhoud op basis van de beveiligingsinstellingen. * Generate dynamic robots.txt content based on security settings
* *
* Stelt globale regels op voor zoekmachines en voegt, indien AI-bots * @param array $securitySettings Security configuration array
* geblokkeerd worden, per AI-crawler een Disallow-blok toe. * @return string Robots.txt content
*
* @since 2.6.5
*
* @param array $securitySettings Beveiligingsconfiguratie-array.
* @return string Robots.txt-inhoud.
*/ */
public static function generateRobotsTxt(array $securitySettings): string public static function generateRobotsTxt(array $securitySettings): string
{ {
-140
View File
@@ -1,93 +1,16 @@
<?php <?php
/**
* Cache interface voor key-value opslag met TTL-ondersteuning.
*
* Definieert een algemeen contract voor cache-implementaties binnen CodePress.
* Implementaties hoeven alleen lezen, schrijven, verwijderen en controleren
* van waarden op basis van een sleutel te ondersteunen.
*
* @since 2.6.5
*/
interface CacheInterface { interface CacheInterface {
/**
* Haal een waarde uit de cache op basis van de sleutel.
*
* @since 2.6.5
*
* @param string $key Sleutel van de cache-waarde.
* @return mixed De gecachte waarde, of null wanneer deze ontbreekt of verlopen is.
*/
public function get(string $key); public function get(string $key);
/**
* Sla een waarde op in de cache met een time-to-live.
*
* @since 2.6.5
*
* @param string $key Sleutel waaronder de waarde wordt opgeslagen.
* @param mixed $value Te cachen waarde.
* @param int $ttl Levensduur in seconden. Default 3600.
* @return bool True bij succes, false bij een schrijffout.
*/
public function set(string $key, $value, int $ttl = 3600): bool; public function set(string $key, $value, int $ttl = 3600): bool;
/**
* Verwijder een waarde uit de cache.
*
* @since 2.6.5
*
* @param string $key Sleutel die verwijderd moet worden.
* @return bool True bij succes of wanneer de sleutel niet bestond.
*/
public function delete(string $key): bool; public function delete(string $key): bool;
/**
* Wis alle waarden uit de cache.
*
* @since 2.6.5
*
* @return bool True bij succes.
*/
public function clear(): bool; public function clear(): bool;
/**
* Controleer of een sleutel bestaat en nog niet verlopen is.
*
* @since 2.6.5
*
* @param string $key Sleutel die gecontroleerd moet worden.
* @return bool True wanneer de sleutel bestaat en geldig is.
*/
public function has(string $key): bool; public function has(string $key): bool;
} }
/**
* Bestandssysteem-gebaseerde cache-implementatie.
*
* Slaat gecachte waarden op als geserialiseerde bestanden in een map. Elke
* cache-sleutel wordt omgezet naar een md5-hash zodat ook lange of vreemde
* sleutels veilig als bestandsnaam gebruikt kunnen worden. Verlopen bestanden
* worden bij lezen of controleren automatisch verwijderd.
*
* @since 2.6.5
*/
class FileCache implements CacheInterface { class FileCache implements CacheInterface {
/**
* Map waar de cache-bestanden in worden opgeslagen.
*
* @since 2.6.5
* @var string
*/
private string $cacheDir; private string $cacheDir;
/**
* Maak een nieuwe file-cache aan en zorg dat de cachemap bestaat.
*
* @since 2.6.5
*
* @param string $cacheDir Pad naar de cachemap. Default '/tmp/codepress_cache'.
*/
public function __construct(string $cacheDir = '/tmp/codepress_cache') { public function __construct(string $cacheDir = '/tmp/codepress_cache') {
$this->cacheDir = $cacheDir; $this->cacheDir = $cacheDir;
if (!is_dir($this->cacheDir)) { if (!is_dir($this->cacheDir)) {
@@ -95,17 +18,6 @@ class FileCache implements CacheInterface {
} }
} }
/**
* Haal een waarde uit de cache.
*
* Wanneer het cache-bestand niet bestaat of verlopen is wordt null
* teruggegeven; in het laatste geval wordt het bestand direct verwijderd.
*
* @since 2.6.5
*
* @param string $key Sleutel van de op te halen waarde.
* @return mixed De gecachte waarde of null.
*/
public function get(string $key) { public function get(string $key) {
$file = $this->getCacheFile($key); $file = $this->getCacheFile($key);
if (!file_exists($file)) { if (!file_exists($file)) {
@@ -121,16 +33,6 @@ class FileCache implements CacheInterface {
return $data['value']; return $data['value'];
} }
/**
* Sla een waarde op in de cache met de opgegeven TTL.
*
* @since 2.6.5
*
* @param string $key Sleutel waaronder wordt opgeslagen.
* @param mixed $value Te cachen waarde.
* @param int $ttl Levensduur in seconden. Default 3600.
* @return bool True bij succes, false bij een schrijffout.
*/
public function set(string $key, $value, int $ttl = 3600): bool { public function set(string $key, $value, int $ttl = 3600): bool {
$file = $this->getCacheFile($key); $file = $this->getCacheFile($key);
$data = [ $data = [
@@ -141,17 +43,6 @@ class FileCache implements CacheInterface {
return file_put_contents($file, serialize($data)) !== false; return file_put_contents($file, serialize($data)) !== false;
} }
/**
* Verwijder een waarde uit de cache.
*
* Geeft true terug wanneer het bestand niet (meer) bestaat, zodat de
* aanroeper dit niet zelf hoeft te controleren.
*
* @since 2.6.5
*
* @param string $key Sleutel die verwijderd moet worden.
* @return bool True bij succes of wanneer de sleutel niet bestond.
*/
public function delete(string $key): bool { public function delete(string $key): bool {
$file = $this->getCacheFile($key); $file = $this->getCacheFile($key);
if (file_exists($file)) { if (file_exists($file)) {
@@ -160,15 +51,6 @@ class FileCache implements CacheInterface {
return true; return true;
} }
/**
* Wis alle cache-bestanden in de cachemap.
*
* Submappen worden niet verwijderd, alleen losse bestanden.
*
* @since 2.6.5
*
* @return bool True bij succes.
*/
public function clear(): bool { public function clear(): bool {
$files = glob($this->cacheDir . '/*'); $files = glob($this->cacheDir . '/*');
foreach ($files as $file) { foreach ($files as $file) {
@@ -179,17 +61,6 @@ class FileCache implements CacheInterface {
return true; return true;
} }
/**
* Controleer of een sleutel bestaat en nog geldig is.
*
* Let op: verlopen bestanden worden hier niet automatisch verwijderd;
* controleer vooraf eventueel via get() indien opruiming gewenst is.
*
* @since 2.6.5
*
* @param string $key Sleutel die gecontroleerd moet worden.
* @return bool True wanneer de sleutel bestaat en de TTL nog niet verlopen is.
*/
public function has(string $key): bool { public function has(string $key): bool {
$file = $this->getCacheFile($key); $file = $this->getCacheFile($key);
if (!file_exists($file)) { if (!file_exists($file)) {
@@ -200,17 +71,6 @@ class FileCache implements CacheInterface {
return $data['expires'] > time(); return $data['expires'] > time();
} }
/**
* Bepaal het pad naar het cache-bestand voor een sleutel.
*
* De sleutel wordt gehashed met md5 zodat deze veilig als bestandsnaam
* gebruikt kan worden, ongeacht de lengte of tekenset van de sleutel.
*
* @since 2.6.5
*
* @param string $key Cache-sleutel.
* @return string Volledig pad naar het cache-bestand.
*/
private function getCacheFile(string $key): string { private function getCacheFile(string $key): string {
return $this->cacheDir . '/' . md5($key) . '.cache'; return $this->cacheDir . '/' . md5($key) . '.cache';
} }
File diff suppressed because it is too large Load Diff
+9 -23
View File
@@ -17,10 +17,9 @@ class ContentAPI
} }
/** /**
* Get all content entries (mappen + bestanden) as a list of entry arrays. * Get all pages as a flat array of path => title pairs
* *
* @return array List of ['path' => ..., 'title' => ..., 'type' => ...] * @return array Associative array like ['index' => 'Home', 'over-ons' => 'Over ons']
* type is 'md'/'php'/'html' voor bestanden, 'folder' voor mappen.
*/ */
public function getAllPages(): array public function getAllPages(): array
{ {
@@ -30,32 +29,18 @@ class ContentAPI
/** /**
* Get a single page by path, including title, content, layout, and metadata * Get a single page by path, including title, content, layout, and metadata
* *
* De $path mag een extensie bevten (bijv. 'over-ons.php') of niet ('over-ons'). * @param string $path Page path without extension (e.g. 'over-ons' or 'blog/post-1')
* Zonder extensie wordt het eerste bestaande bestand gekozen (md > php > html);
* met extensie wordt dat specifieke bestand gekozen.
*
* @param string $path Page path, al dan niet met extensie
* @return array|null Page data or null if not found * @return array|null Page data or null if not found
*/ */
public function getPage(string $path): ?array public function getPage(string $path): ?array
{ {
$contentDir = $this->cms->config['content_dir']; $contentDir = $this->cms->config['content_dir'];
$path = preg_replace('/\.(md|php|html)$/', '', $path);
// Detecteer expliciete extensie en strip hem voor de basis
$preferredExt = null;
if (preg_match('/\.(md|php|html)$/i', $path, $m)) {
$preferredExt = strtolower($m[1]);
}
$path = preg_replace('/\.(md|php|html)$/i', '', $path);
$filePath = $contentDir . '/' . $path; $filePath = $contentDir . '/' . $path;
// Probeer de gevraagde extensie eerst, dan de standaard volgorde $extensions = ['md', 'php', 'html'];
$order = ['md', 'php', 'html'];
if ($preferredExt !== null) {
$order = array_unique(array_merge([$preferredExt], $order));
}
$actualPath = null; $actualPath = null;
foreach ($order as $ext) { foreach ($extensions as $ext) {
if (file_exists($filePath . '.' . $ext)) { if (file_exists($filePath . '.' . $ext)) {
$actualPath = $filePath . '.' . $ext; $actualPath = $filePath . '.' . $ext;
break; break;
@@ -156,13 +141,14 @@ class ContentAPI
/** /**
* Check if a page exists at the given path * Check if a page exists at the given path
* *
* @param string $path Page path, al dan niet met extensie * @param string $path Page path without extension
* @return bool * @return bool
*/ */
public function pageExists(string $path): bool public function pageExists(string $path): bool
{ {
$contentDir = $this->cms->config['content_dir']; $contentDir = $this->cms->config['content_dir'];
$basePath = $contentDir . '/' . preg_replace('/\.(md|php|html)$/i', '', $path); $path = preg_replace('/\.(md|php|html)$/', '', $path);
$basePath = $contentDir . '/' . $path;
return file_exists($basePath . '.md') return file_exists($basePath . '.md')
|| file_exists($basePath . '.php') || file_exists($basePath . '.php')
+21 -156
View File
@@ -7,46 +7,13 @@
* - ZIP backup of the entire content directory * - ZIP backup of the entire content directory
* - Restore from an uploaded ZIP file * - Restore from an uploaded ZIP file
* - Optional git-based versioning (init / commit / log / restore) * - Optional git-based versioning (init / commit / log / restore)
*
* @since 2.6.5
*/ */
class ContentBackup class ContentBackup
{ {
/**
* Pad naar de content-map.
*
* @since 2.6.5
* @var string Pad naar de content-map.
*/
private string $contentDir; private string $contentDir;
/**
* Pad naar de project-root.
*
* @since 2.6.5
* @var string Pad naar de project-root.
*/
private string $projectRoot; private string $projectRoot;
/**
* Of git beschikbaar is in de content-map.
*
* @since 2.6.5
* @var bool Of git beschikbaar is.
*/
private bool $gitAvailable; private bool $gitAvailable;
/**
* Initialiseer de ContentBackup-instantie.
*
* Stelt de content-map en project-root in en detecteert of git
* beschikbaar is op het systeem.
*
* @since 2.6.5
*
* @param string $contentDir Pad naar de content-map.
* @param string $projectRoot Optioneel. Pad naar de project-root. Default de map drie niveaus boven deze class.
*/
public function __construct(string $contentDir, string $projectRoot = '') public function __construct(string $contentDir, string $projectRoot = '')
{ {
$this->contentDir = rtrim($contentDir, '/'); $this->contentDir = rtrim($contentDir, '/');
@@ -55,11 +22,7 @@ class ContentBackup
} }
/** /**
* Controleer of git beschikbaar is en de content-map in een git-repo zit. * Check whether git is available and the content dir is inside a git repo.
*
* @since 2.6.5
*
* @return bool True indien git beschikbaar is.
*/ */
public function isGitAvailable(): bool public function isGitAvailable(): bool
{ {
@@ -67,15 +30,10 @@ class ContentBackup
} }
/** /**
* Maak een ZIP-backup van de content-map. * Create a ZIP backup of the content directory.
* *
* Controleert of ZipArchive beschikbaar is en de content-map bestaat, * @param string $outputPath Where to write the ZIP file
* en voegt recursief alle bestanden en mappen toe aan het ZIP-archief. * @return bool True on success
*
* @since 2.6.5
*
* @param string $outputPath Pad waar het ZIP-bestand geschreven moet worden.
* @return bool True bij succes, false bij falen.
*/ */
public function createZipBackup(string $outputPath): bool public function createZipBackup(string $outputPath): bool
{ {
@@ -96,15 +54,10 @@ class ContentBackup
} }
/** /**
* Herstel content vanuit een ZIP-bestand. * Restore content from a ZIP file.
* *
* Pakt het ZIP-bestand uit in een tijdelijke map, maakt een backup van de * @param string $zipPath Path to the uploaded ZIP file
* huidige content-map, kopieert de nieuwe content en ruimt oude backups op. * @return array ['success' => bool, 'message' => string]
*
* @since 2.6.5
*
* @param string $zipPath Pad naar het geüploade ZIP-bestand.
* @return array{success:bool,message:string} Resultaat-array met success en message.
*/ */
public function restoreFromZip(string $zipPath): array public function restoreFromZip(string $zipPath): array
{ {
@@ -159,14 +112,9 @@ class ContentBackup
} }
/** /**
* Initialiseer een git-repository in de content-map. * Initialize git in the content directory.
* *
* Voert `git init` uit en configureert een default identiteit (user.email * @return array ['success' => bool, 'message' => string]
* en user.name) zodat commits werken zonder globale git-config.
*
* @since 2.6.5
*
* @return array{success:bool,message:string} Resultaat-array met success en message.
*/ */
public function gitInit(): array public function gitInit(): array
{ {
@@ -187,16 +135,10 @@ class ContentBackup
} }
/** /**
* Commit alle wijzigingen in de content-map. * Commit all changes in the content directory.
* *
* Voegt alle bestanden toe met `git add -A`, controleert of er wijzigingen * @param string $message Commit message
* zijn via `git status --porcelain`, en commit met de opgegeven message. * @return array ['success' => bool, 'message' => string]
* Bij een lege message wordt een standaardmessage gegenereerd.
*
* @since 2.6.5
*
* @param string $message Commit message.
* @return array{success:bool,message:string} Resultaat-array met success en message.
*/ */
public function gitCommit(string $message): array public function gitCommit(string $message): array
{ {
@@ -231,15 +173,10 @@ class ContentBackup
} }
/** /**
* Haal de git-log op voor de content-map. * Get the git log for the content directory.
* *
* Leest commits uit met `git log --pretty=format:%H|%h|%ai|%s` en parseert * @param int $limit Maximum number of entries
* deze naar een array met hash, short, date en message per commit. * @return array ['success' => bool, 'commits' => array, 'message' => string]
*
* @since 2.6.5
*
* @param int $limit Maximum aantal entries. Default 20.
* @return array{success:bool,commits:array<int,array{hash:string,short:string,date:string,message:string}>,message:string} Resultaat-array met success, commits en message.
*/ */
public function gitLog(int $limit = 20): array public function gitLog(int $limit = 20): array
{ {
@@ -284,16 +221,10 @@ class ContentBackup
} }
/** /**
* Herstel content naar een specifieke git-commit. * Restore content to a specific git commit.
* *
* Controleert de commit-hash, saniteert deze en voert * @param string $commitHash Commit hash to restore to
* `git checkout <hash> -- .` uit om de bestanden van die commit * @return array ['success' => bool, 'message' => string]
* in de working tree te herstellen.
*
* @since 2.6.5
*
* @param string $commitHash Commit-hash om naar te herstellen.
* @return array{success:bool,message:string} Resultaat-array met success en message.
*/ */
public function gitRestore(string $commitHash): array public function gitRestore(string $commitHash): array
{ {
@@ -320,11 +251,7 @@ class ContentBackup
} }
/** /**
* Controleer of de content-map een git-repository bevat. * Check if the content directory has a git repository.
*
* @since 2.6.5
*
* @return bool True indien een .git-map aanwezig is.
*/ */
public function hasGitRepo(): bool public function hasGitRepo(): bool
{ {
@@ -335,15 +262,6 @@ class ContentBackup
// Private helpers // Private helpers
// ----------------------------------------------------------------------- // -----------------------------------------------------------------------
/**
* Detecteer of git beschikbaar is op het systeem.
*
* Voert `git --version` uit en controleert de exit-code.
*
* @since 2.6.5
*
* @return bool True indien git uitvoerbaar is.
*/
private function detectGit(): bool private function detectGit(): bool
{ {
$result = $this->execGitCapture(['--version']); $result = $this->execGitCapture(['--version']);
@@ -351,16 +269,9 @@ class ContentBackup
} }
/** /**
* Voer een git-commando uit en capture output, error en exit-code apart. * Execute a git command and capture output, error, and exit code separately.
* *
* Gebruikt proc_open met aparte pipes voor stdout, stderr en stdin. * @return array ['output' => string, 'error' => string, 'exit' => int]
* Alle argumenten worden via escapeshellarg ge-escaped.
*
* @since 2.6.5
*
* @param array<int,string> $args Git-commando-argumenten.
* @param string|null $cwd Optioneel. Werkdirectory voor het git-proces.
* @return array{output:string,error:string,exit:int} Array met output, error en exit-code.
*/ */
private function execGitCapture(array $args, ?string $cwd = null): array private function execGitCapture(array $args, ?string $cwd = null): array
{ {
@@ -394,19 +305,6 @@ class ContentBackup
]; ];
} }
/**
* Voeg een map recursief toe aan een ZipArchive.
*
* Itereert over alle entries in $dir en voegt mappen (als lege dir) en
* bestanden toe onder de opgegeven $prefix in het ZIP-archief.
*
* @since 2.6.5
*
* @param ZipArchive $zip ZIP-archief om aan toe te voegen.
* @param string $dir Pad naar de bronmap.
* @param string $prefix Prefix (pad binnen het ZIP) voor de entries.
* @return void
*/
private function addDirToZip(ZipArchive $zip, string $dir, string $prefix): void private function addDirToZip(ZipArchive $zip, string $dir, string $prefix): void
{ {
$entries = scandir($dir); $entries = scandir($dir);
@@ -427,18 +325,6 @@ class ContentBackup
} }
} }
/**
* Kopieer een map recursief naar een doelmap.
*
* Maakt de doelmap aan indien nodig en kopieert alle bestanden en
* submappen vanuit de bronmap.
*
* @since 2.6.5
*
* @param string $src Pad naar de bronmap.
* @param string $dst Pad naar de doelmap.
* @return void
*/
private function copyDir(string $src, string $dst): void private function copyDir(string $src, string $dst): void
{ {
if (!is_dir($src)) { if (!is_dir($src)) {
@@ -466,16 +352,6 @@ class ContentBackup
} }
} }
/**
* Verwijder een map en alle inhoud recursief.
*
* Verwijdert eerst alle bestanden en submappen, daarna de map zelf.
*
* @since 2.6.5
*
* @param string $dir Pad naar de te verwijderen map.
* @return void
*/
private function removeDir(string $dir): void private function removeDir(string $dir): void
{ {
if (!is_dir($dir)) { if (!is_dir($dir)) {
@@ -500,17 +376,6 @@ class ContentBackup
rmdir($dir); rmdir($dir);
} }
/**
* Ruim oude content-backups op, waarbij alleen de laatste bewaard blijft.
*
* Zoekt backups via een glob-patroon op de content-mapnaam met .bak.*
* suffix, sorteert op wijzigingstijd (oudste eerst) en verwijdert alle
* backups behalve de meest recente.
*
* @since 2.6.5
*
* @return void
*/
private function cleanupOldBackups(): void private function cleanupOldBackups(): void
{ {
$parentDir = dirname($this->contentDir); $parentDir = dirname($this->contentDir);
+11 -180
View File
@@ -1,40 +1,13 @@
<?php <?php
/** /**
* GeoIP country lookup provider chain. * GeoIP - Country lookup provider chain (Local binary, MMDB, and API)
*
* Ondersteunt drie providers voor het resolueren van een landcode op basis
* van een IP-adres: een lokale binaire database (DB-IP), een MaxMind MMDB
* bestand en een externe API. Providers vallen terug op de lokale database
* wanneer een lookup geen resultaat oplevert.
*
* @since 2.6.5
*/ */
class GeoIP class GeoIP
{ {
/**
* De analytics-configuratie uit config.json.
*
* @since 2.6.5
* @var array Bevat o.a. geoip_provider, geoip_mmdb_path en geoip_api_url.
*/
private array $config; private array $config;
/**
* FileCache instantie voor het cachen van API-lookups.
*
* @since 2.6.5
* @var FileCache|null
*/
private ?FileCache $cache = null; private ?FileCache $cache = null;
/**
* Initialiseert de GeoIP-provider met de analytics-configuratie.
*
* @since 2.6.5
*
* @param array $analyticsConfig De "analytics" sectie uit config.json. Default lege array.
*/
public function __construct(array $analyticsConfig = []) public function __construct(array $analyticsConfig = [])
{ {
$this->config = $analyticsConfig; $this->config = $analyticsConfig;
@@ -43,16 +16,10 @@ class GeoIP
} }
/** /**
* Resolves een 2-letter ISO alpha-2 landcode uit een IP-adres. * Resolve country code (2-letter ISO alpha-2, upper-case) from an IP address
* *
* De gekozen provider wordt gelezen uit de configuratie. Private en * @param string $ip IPv4 or IPv6 address
* gereserveerde ranges worden direct afgewezen. MMDB en API vallen * @return string|null Country code or null if unresolved/private
* terug op de lokale database bij een mislukte lookup.
*
* @since 2.6.5
*
* @param string $ip IPv4- of IPv6-adres.
* @return string|null Landcode in hoofdletters, of null bij onoplosbare/private adressen.
*/ */
public function lookupCountry(string $ip): ?string public function lookupCountry(string $ip): ?string
{ {
@@ -86,15 +53,7 @@ class GeoIP
} }
/** /**
* Normaliseert een landcode en verwerpt placeholder codes. * Normalize a country code; placeholder codes (ZZ/XX) count as unknown
*
* Geldige codes zijn exact twee letters. De codes ZZ en XX worden
* beschouwd als onbekend en resulteren in null.
*
* @since 2.6.5
*
* @param string|null $code Ruwe landcode uit een provider.
* @return string|null Genormaliseerde landcode of null indien ongeldig/onbekend.
*/ */
private static function normalizeCode(?string $code): ?string private static function normalizeCode(?string $code): ?string
{ {
@@ -106,16 +65,7 @@ class GeoIP
} }
/** /**
* Binaire zoekopdracht in lokale DB-IP IPv4/IPv6 binaire bestanden. * Binary search lookup in local DB-IP IPv4/IPv6 binary files
*
* Leest de bestanden uit `admin/storage/geoip` en voert een binaire
* zoekopdracht uit op basis van het IP-adres. Ondersteunt zowel IPv4
* (10-byte records) als IPv6 (34-byte records).
*
* @since 2.6.5
*
* @param string $ip IPv4- of IPv6-adres.
* @return string|null Landcode in hoofdletters of null indien niet gevonden.
*/ */
public function lookupLocal(string $ip): ?string public function lookupLocal(string $ip): ?string
{ {
@@ -211,16 +161,7 @@ class GeoIP
} }
/** /**
* Externe API-lookup met caching. * External API lookup with caching
*
* Stuurt een HTTP-verzoek naar de geconfigureerde GeoIP API en cachet
* het resultaat zeven dagen in een FileCache. De API-URL mag een
* optionele API-key bevatten.
*
* @since 2.6.5
*
* @param string $ip IPv4- of IPv6-adres.
* @return string|null Landcode of null indien de lookup faalt.
*/ */
private function lookupApi(string $ip): ?string private function lookupApi(string $ip): ?string
{ {
@@ -251,16 +192,7 @@ class GeoIP
} }
/** /**
* Pure-PHP MaxMind MMDB reader. * Pure-PHP MaxMind MMDB reader
*
* Opent een MMDB-bestand en extraheert de landcode via de ingebouwde
* MMDBReader. Fouten worden gesilenced en resulteren in null.
*
* @since 2.6.5
*
* @param string $ip IPv4- of IPv6-adres.
* @param string $filePath Pad naar het MMDB-bestand.
* @return string|null Landcode of null bij een fout.
*/ */
private function lookupMMDB(string $ip, string $filePath): ?string private function lookupMMDB(string $ip, string $filePath): ?string
{ {
@@ -274,12 +206,7 @@ class GeoIP
} }
/** /**
* Zet een 2-letter ISO landcode om naar een regionale vlag-emoji. * Convert 2-letter ISO country code to regional indicator flag emoji
*
* @since 2.6.5
*
* @param string|null $code Landcode of null.
* @return string Vlag-emoji of een wereldbol bij ongeldige invoer.
*/ */
public static function getCountryFlagEmoji(?string $code): string public static function getCountryFlagEmoji(?string $code): string
{ {
@@ -295,17 +222,7 @@ class GeoIP
} }
/** /**
* Geeft de landnaam in Nederlands of Engels. * Get country name in Dutch or English
*
* Bevat een statische mapping van de meest voorkomende landcodes naar
* hun naam in de gevraagde taal. Onbekende codes worden ongewijzigd
* teruggegeven.
*
* @since 2.6.5
*
* @param string|null $code Landcode of null.
* @param string $lang Gewenste taal, 'nl' of 'en'. Default 'nl'.
* @return string Landnaam in de gevraagde taal of de code zelf.
*/ */
public static function getCountryName(?string $code, string $lang = 'nl'): string public static function getCountryName(?string $code, string $lang = 'nl'): string
{ {
@@ -358,49 +275,14 @@ class GeoIP
} }
/** /**
* Ingebouwde pure-PHP MaxMind DB reader. * Built-in pure-PHP MaxMind DB Reader
*
* Minimale implementatie van de MaxMind DB binary reader, nodig omdat de
* externe GeoIP2 dependency optioneel is. Ondersteunt 28-bit record sizes
* en de veelvoorkomende datatypes (pointer, string, map, uint, bool).
*
* @since 2.6.5
*/ */
class MMDBReader class MMDBReader
{ {
/**
* Pad naar het MMDB-bestand.
*
* @since 2.6.5
* @var string
*/
private string $file; private string $file;
/**
* Bestandshandle voor het MMDB-bestand.
*
* @since 2.6.5
* @var resource|null
*/
private $handle; private $handle;
/**
* Metadata uit de MMDB-header.
*
* @since 2.6.5
* @var array Bevat o.a. node_count, record_size en ip_version.
*/
private array $meta; private array $meta;
/**
* Opent het MMDB-bestand en laadt de metadata.
*
* @since 2.6.5
*
* @param string $file Pad naar het MMDB-bestand.
* @throws \InvalidArgumentException Als het bestand niet bestaat.
* @throws \RuntimeException Als het bestandformaat ongeldig is.
*/
public function __construct(string $file) public function __construct(string $file)
{ {
if (!file_exists($file)) { if (!file_exists($file)) {
@@ -411,11 +293,6 @@ class MMDBReader
$this->loadMetadata(); $this->loadMetadata();
} }
/**
* Sluit de bestandshandle bij het vernietigen van de instantie.
*
* @since 2.6.5
*/
public function __destruct() public function __destruct()
{ {
if ($this->handle) { if ($this->handle) {
@@ -423,16 +300,6 @@ class MMDBReader
} }
} }
/**
* Laadt de MMDB-metadata vanaf het einde van het bestand.
*
* Zoekt naar de MaxMind marker en decodeert de daaropvolgende data.
*
* @since 2.6.5
*
* @throws \RuntimeException Als de marker niet gevonden wordt.
* @return void
*/
private function loadMetadata(): void private function loadMetadata(): void
{ {
$stat = fstat($this->handle); $stat = fstat($this->handle);
@@ -452,18 +319,6 @@ class MMDBReader
$this->meta = $this->decodeData($metaOffset)[0]; $this->meta = $this->decodeData($metaOffset)[0];
} }
/**
* Voert een lookup uit voor een IP-adres in de MMDB-boom.
*
* Werkt door de binaire boom te doorlopen op basis van de bits van het
* IP-adres. IPv4-adressen in een IPv6-boom worden correct afgehandeld
* via de ipv4_instance_count metadata.
*
* @since 2.6.5
*
* @param string $ip IPv4- of IPv6-adres.
* @return array|null Gedecodeerde datarecord of null indien niet gevonden.
*/
public function get(string $ip): ?array public function get(string $ip): ?array
{ {
$ipBin = inet_pton($ip); $ipBin = inet_pton($ip);
@@ -500,18 +355,6 @@ class MMDBReader
return null; return null;
} }
/**
* Leest een kind-node (left/right) uit de MMDB-boom.
*
* Ondersteunt uitsluitend 28-bit record sizes.
*
* @since 2.6.5
*
* @param int $node Huidig node-index.
* @param int $bit Bitwaarde (0 voor left, 1 voor right).
* @param int $recordSize Record size in bits.
* @return int Doel-node-index of 0 bij niet-ondersteunde record sizes.
*/
private function readNode(int $node, int $bit, int $recordSize): int private function readNode(int $node, int $bit, int $recordSize): int
{ {
$bytesPerRecord = $recordSize / 4; // 28-bit -> 3.5 bytes per record $bytesPerRecord = $recordSize / 4; // 28-bit -> 3.5 bytes per record
@@ -529,18 +372,6 @@ class MMDBReader
return 0; return 0;
} }
/**
* Decodeert een MMDB-datarecord vanaf de gegeven offset.
*
* Ondersteunt pointer, string, double, uint, map en bool. De array
* return value bevat de gedecodeerde waarde en de cursorpositie na
* het record.
*
* @since 2.6.5
*
* @param int $offset Start-offset in het bestand.
* @return array Pair [mixed $value, int $newOffset].
*/
private function decodeData(int $offset): array private function decodeData(int $offset): array
{ {
fseek($this->handle, $offset); fseek($this->handle, $offset);
+35 -201
View File
@@ -1,105 +1,34 @@
<?php <?php
/** /**
* Dynamische logging voor CodePress CMS. * LogManager - Dynamic logging for CodePress CMS
* *
* Ondersteunt drie drivers: * Supports three drivers:
* - syslog: Stuurt log entries naar een remote syslog-server (UDP) of de * - syslog: Send log entries to a remote syslog server (UDP) or local syslog.
* lokale syslog. * - sqlite: Store log entries in a SQLite database (default when no syslog
* - sqlite: Slaat log entries op in een SQLite-database (standaard wanneer * server is configured and SQLite is available).
* geen syslog-server geconfigureerd is en SQLite beschikbaar is). * - file: Fallback to plain text files when SQLite is unavailable.
* - file: Fallback naar platte-tekstbestanden wanneer SQLite niet
* beschikbaar is.
* *
* Welke event-types geregistreerd worden, wordt dynamisch gestuurd via de * Which event types are recorded is controlled dynamically via the
* "logging.events" configuratiesectie (admin, requests, errors, security, * "logging.events" config section (admin, requests, errors, security,
* content, system). * content, system).
*
* @since 2.6.5
*/ */
class LogManager { class LogManager {
/**
* Event-type voor admin-acties.
*
* @since 2.6.5
* @var string
*/
const EVENT_ADMIN = 'admin'; const EVENT_ADMIN = 'admin';
/**
* Event-type voor request-logging.
*
* @since 2.6.5
* @var string
*/
const EVENT_REQUESTS = 'requests'; const EVENT_REQUESTS = 'requests';
/**
* Event-type voor fouten en waarschuwingen.
*
* @since 2.6.5
* @var string
*/
const EVENT_ERRORS = 'errors'; const EVENT_ERRORS = 'errors';
/**
* Event-type voor beveiligingsgebeurtenissen.
*
* @since 2.6.5
* @var string
*/
const EVENT_SECURITY = 'security'; const EVENT_SECURITY = 'security';
/**
* Event-type voor content-wijzigingen.
*
* @since 2.6.5
* @var string
*/
const EVENT_CONTENT = 'content'; const EVENT_CONTENT = 'content';
/**
* Event-type voor systeemgebeurtenissen.
*
* @since 2.6.5
* @var string
*/
const EVENT_SYSTEM = 'system'; const EVENT_SYSTEM = 'system';
/**
* De "logging" configuratiesectie, of null indien niet geïnitialiseerd.
*
* @since 2.6.5
* @var array|null
*/
private static $config = null; private static $config = null;
/**
* Lazy-initialized PDO-verbinding met de SQLite-database, of null.
*
* @since 2.6.5
* @var \PDO|null
*/
private static $pdo = null; private static $pdo = null;
/**
* Pad naar het SQLite-databasebestand, of null indien niet geïnitialiseerd.
*
* @since 2.6.5
* @var string|null
*/
private static $dbPath = null; private static $dbPath = null;
/** /**
* Initialiseert de log-manager met de logging-configuratie. * Initialize the log manager with the logging config section.
* *
* Slaat de configuratie op en stelt het pad naar de SQLite-database in * @param array $loggingConfig The "logging" section from config.json
* onder `admin/storage/logs`.
*
* @since 2.6.5
*
* @param array $loggingConfig De "logging" sectie uit config.json.
* @return void
*/ */
public static function init(array $loggingConfig): void public static function init(array $loggingConfig): void
{ {
@@ -108,11 +37,7 @@ class LogManager {
} }
/** /**
* Geeft aan of logging in het algemeen ingeschakeld is. * Whether logging is enabled at all.
*
* @since 2.6.5
*
* @return bool True indien logging ingeschakeld is, anders false.
*/ */
public static function isEnabled(): bool public static function isEnabled(): bool
{ {
@@ -120,15 +45,9 @@ class LogManager {
} }
/** /**
* Geeft aan of een bepaald event-type geregistreerd moet worden. * Whether a given event type should be recorded.
* *
* Controleert eerst of logging in het algemeen ingeschakeld is en * @param string $event One of the EVENT_* constants
* daarna of het specifieke event aan staat in de configuratie.
*
* @since 2.6.5
*
* @param string $event Een van de EVENT_* constanten.
* @return bool True indien het event geregistreerd moet worden.
*/ */
public static function isEventEnabled(string $event): bool public static function isEventEnabled(string $event): bool
{ {
@@ -140,15 +59,9 @@ class LogManager {
} }
/** /**
* Geeft de actieve lokale opslag-driver. * Get the local storage driver: 'sqlite' (falling back to 'file' if
* * SQLite is unavailable). Syslog is an additional output, not a storage
* Retourneert 'sqlite' wanneer SQLite beschikbaar is, anders 'file'. * driver, so it never replaces local storage.
* Syslog is een aanvullende output en vervangt nooit de lokale
* opslag, en komt dus nooit als driver terug.
*
* @since 2.6.5
*
* @return string 'sqlite' of 'file'.
*/ */
public static function getDriver(): string public static function getDriver(): string
{ {
@@ -162,20 +75,12 @@ class LogManager {
} }
/** /**
* Slaat een log-entry op indien het event-type ingeschakeld is. * Record a log entry if the event type is enabled.
* *
* De entry wordt altijd lokaal opgeslagen (SQLite of file-fallback) zodat * @param string $event Event type (EVENT_* constant)
* de dynamische admin-log altijd entries bevat. Wanneer een syslog-host * @param string $level Log level (info, warning, error, debug)
* geconfigureerd is, wordt de entry tevens naar de remote syslog-server * @param string $message Log message
* gestuurd. Het IP-adres wordt uit de context of de RequestLogger gehaald. * @param array $context Additional structured context
*
* @since 2.6.5
*
* @param string $event Event-type (een EVENT_* constante).
* @param string $level Loglevel (info, warning, error, debug).
* @param string $message Logbericht.
* @param array $context Aanvullende gestructureerde context. Default lege array.
* @return void
*/ */
public static function log(string $event, string $level, string $message, array $context = []): void public static function log(string $event, string $level, string $message, array $context = []): void
{ {
@@ -210,15 +115,7 @@ class LogManager {
} }
/** /**
* Stuurt een log-entry naar een remote syslog-server over UDP. * Send a log entry to a remote syslog server over UDP.
*
* Bouwt een syslog-bericht op met facility, severity en ident en stuurt
* dit via een UDP-socket. Verbindings- en schrijffouten worden gesilenced.
*
* @since 2.6.5
*
* @param array $entry De te versturen log-entry.
* @return void
*/ */
private static function writeSyslog(array $entry): void private static function writeSyslog(array $entry): void
{ {
@@ -241,16 +138,7 @@ class LogManager {
} }
/** /**
* Slaat een log-entry op in de SQLite-database. * Store a log entry in the SQLite database.
*
* De context-array wordt als JSON opgeslagen. Wanneer de PDO-verbinding
* niet beschikbaar is of het schrijven faalt, wordt teruggevallen op
* de file-driver.
*
* @since 2.6.5
*
* @param array $entry De op te slaan log-entry.
* @return void
*/ */
private static function writeSqlite(array $entry): void private static function writeSqlite(array $entry): void
{ {
@@ -279,15 +167,7 @@ class LogManager {
} }
/** /**
* Voegt een log-entry toe aan een platte-tekstbestand (fallback-driver). * Append a log entry to a plain text file (fallback driver).
*
* Zorgt dat de doelmap bestaat en schrijft de entry met een vaste
* opmaak. Schrijffouten worden gesilenced.
*
* @since 2.6.5
*
* @param array $entry De toe te voegen log-entry.
* @return void
*/ */
private static function writeFile(array $entry): void private static function writeFile(array $entry): void
{ {
@@ -302,15 +182,7 @@ class LogManager {
} }
/** /**
* Geeft (en creëert lazy) de PDO-verbinding met de SQLite-database. * Get (and lazily create) the PDO connection to the SQLite database.
*
* Maakt de tabel en indices aan indien deze nog niet bestaan. Bij een
* fout wordt de interne verbinding op null gezet en null teruggegeven,
* zodat de aanroeper kan terugvallen op de file-driver.
*
* @since 2.6.5
*
* @return \PDO|null PDO-verbinding of null indien SQLite niet beschikbaar/faalt.
*/ */
private static function getPdo(): ?\PDO private static function getPdo(): ?\PDO
{ {
@@ -350,11 +222,7 @@ class LogManager {
} }
/** /**
* Geeft aan of de SQLite PDO-driver beschikbaar is. * Whether the SQLite PDO driver is available.
*
* @since 2.6.5
*
* @return bool True indien PDO en de sqlite-driver beschikbaar zijn.
*/ */
private static function sqliteAvailable(): bool private static function sqliteAvailable(): bool
{ {
@@ -362,16 +230,7 @@ class LogManager {
} }
/** /**
* Vertaalt een facility-naam naar de bijbehorende numerieke syslog-waarde. * Map a facility name to its syslog numeric value.
*
* Ondersteunt de standaard facilities (kern, user, mail, daemon, auth,
* syslog, lpr, news, uucp, cron, authpriv, ftp) en local0 t/m local7.
* Onbekende faciliteiten vallen terug op local0 (16).
*
* @since 2.6.5
*
* @param string $facility Naam van de facility. Default 'local0' wordt door aanroeper gezet.
* @return int Numerieke facility-waarde.
*/ */
private static function syslogFacility(string $facility): int private static function syslogFacility(string $facility): int
{ {
@@ -386,15 +245,7 @@ class LogManager {
} }
/** /**
* Vertaalt een loglevel naar de bijbehorende syslog-severity. * Map a log level to its syslog severity value.
*
* Ondersteunt debug t/m emergency. Onbekende levels vallen terug op
* info (6). De invoer wordt case-insensitive vergeleken.
*
* @since 2.6.5
*
* @param string $level Loglevel (debug, info, notice, warning, error, ...).
* @return int Numerieke severity-waarde (0 t/m 7).
*/ */
private static function syslogSeverity(string $level): int private static function syslogSeverity(string $level): int
{ {
@@ -412,22 +263,13 @@ class LogManager {
} }
/** /**
* Zoekt recente log-entries op uit de actieve opslag. * Query recent log entries from the active store.
* *
* Bij de SQLite-driver wordt een geparametriseerde query uitgevoerd met * @param int $limit Number of entries to return
* optionele filters op event, level en een zoekterm op het bericht. * @param string|null $event Optional event filter
* Bij de file-driver wordt het logbestand uitgelezen en met een regex * @param string|null $level Optional level filter (info, warning, error, ...)
* geparseerd; de resultaten worden gefilterd en oudste eerst teruggegeven. * @param string|null $search Optional text search on the message
* Resultaten worden altijd nieuwste eerst geretourneerd (SQLite via * @return array List of log entries (newest first)
* ORDER BY id DESC, file via array_reverse).
*
* @since 2.6.5
*
* @param int $limit Aantal terug te geven entries. Default 200.
* @param string|null $event Optioneel event-filter. Default null (geen filter).
* @param string|null $level Optioneel levelfilter (info, warning, error, ...). Default null.
* @param string|null $search Optionele tekstzoekopdracht op het bericht. Default null.
* @return array<int, array<string, mixed>> Lijst met log-entries (nieuwste eerst).
*/ */
public static function getLogs(int $limit = 200, ?string $event = null, ?string $level = null, ?string $search = null): array public static function getLogs(int $limit = 200, ?string $event = null, ?string $level = null, ?string $search = null): array
{ {
@@ -498,15 +340,7 @@ class LogManager {
} }
/** /**
* Wist alle opgeslagen log-entries. * Clear all stored log entries.
*
* Bij de SQLite-driver worden alle rijen uit de logs-tabel verwijderd.
* Bij de file-driver wordt het logbestand leeggemaakt. Schrijffouten
* worden gesilenced.
*
* @since 2.6.5
*
* @return void
*/ */
public static function clear(): void public static function clear(): void
{ {
+32 -108
View File
@@ -1,75 +1,27 @@
<?php <?php
/** /**
* Eenvoudige logger voor CodePress CMS. * Simple Logger Class for CodePress CMS
* *
* Voorziet in gestructureerde logging met loglevels en bestandsuitvoer. * Provides structured logging with log levels and file output.
* Logregels worden naar een tekstbestand geschreven en, indien aanwezig,
* tevens door de dynamische LogManager gerouteerd.
* *
* @since 2.6.5 * @package CodePress
* @version 1.0.0
*/ */
class Logger { class Logger {
/**
* Loglevel voor debug-boodschappen.
*
* @since 2.6.5
* @var string
*/
const DEBUG = 'DEBUG'; const DEBUG = 'DEBUG';
/**
* Loglevel voor informatieve boodschappen.
*
* @since 2.6.5
* @var string
*/
const INFO = 'INFO'; const INFO = 'INFO';
/**
* Loglevel voor waarschuwingen.
*
* @since 2.6.5
* @var string
*/
const WARNING = 'WARNING'; const WARNING = 'WARNING';
/**
* Loglevel voor fouten.
*
* @since 2.6.5
* @var string
*/
const ERROR = 'ERROR'; const ERROR = 'ERROR';
/**
* Pad naar het logbestand, of null indien nog niet geïnitialiseerd.
*
* @since 2.6.5
* @var string|null
*/
private static $logFile = null; private static $logFile = null;
/**
* Of debug-logging actief is.
*
* @since 2.6.5
* @var bool
*/
private static $debugMode = false; private static $debugMode = false;
/** /**
* Initialiseert de logger. * Initialize logger
* *
* Stelt het pad naar het logbestand in en zorgt dat de bijbehorende * @param string $logFile Path to log file
* map bestaat. Indien geen pad wordt opgegeven valt de logger terug * @param bool $debugMode Enable debug logging
* op een standaardpad onder de core-map.
*
* @since 2.6.5
*
* @param string|null $logFile Pad naar het logbestand. Default null (standaardlocatie).
* @param bool $debugMode Of debug-logging actief is. Default false.
* @return void
*/ */
public static function init($logFile = null, $debugMode = false) { public static function init($logFile = null, $debugMode = false) {
if ($logFile === null) { if ($logFile === null) {
@@ -87,13 +39,10 @@ class Logger {
} }
/** /**
* Logt een debug-boodschap (enkel in debug-modus). * Log debug message (only in debug mode)
* *
* @since 2.6.5 * @param string $message Message to log
* * @param array $context Additional context
* @param string $message Boodschap die gelogd moet worden.
* @param array $context Aanvullende contextuele data. Default lege array.
* @return void
*/ */
public static function debug($message, $context = []) { public static function debug($message, $context = []) {
if (self::$debugMode) { if (self::$debugMode) {
@@ -102,59 +51,41 @@ class Logger {
} }
/** /**
* Logt een informatieve boodschap. * Log info message
* *
* @since 2.6.5 * @param string $message Message to log
* * @param array $context Additional context
* @param string $message Boodschap die gelogd moet worden.
* @param array $context Aanvullende contextuele data. Default lege array.
* @return void
*/ */
public static function info($message, $context = []) { public static function info($message, $context = []) {
self::write(self::INFO, $message, $context); self::write(self::INFO, $message, $context);
} }
/** /**
* Logt een waarschuwing. * Log warning message
* *
* @since 2.6.5 * @param string $message Message to log
* * @param array $context Additional context
* @param string $message Boodschap die gelogd moet worden.
* @param array $context Aanvullende contextuele data. Default lege array.
* @return void
*/ */
public static function warning($message, $context = []) { public static function warning($message, $context = []) {
self::write(self::WARNING, $message, $context); self::write(self::WARNING, $message, $context);
} }
/** /**
* Logt een fout. * Log error message
* *
* @since 2.6.5 * @param string $message Message to log
* * @param array $context Additional context
* @param string $message Boodschap die gelogd moet worden.
* @param array $context Aanvullende contextuele data. Default lege array.
* @return void
*/ */
public static function error($message, $context = []) { public static function error($message, $context = []) {
self::write(self::ERROR, $message, $context); self::write(self::ERROR, $message, $context);
} }
/** /**
* Schrijft een logregel naar het bestand en routeert deze door LogManager. * Write log entry to file
* *
* De context-array wordt als JSON aan de logregel toegevoegd. Fouten bij * @param string $level Log level
* het schrijven worden gesilenced (graceful degradation). Wanneer de * @param string $message Message to log
* LogManager class beschikbaar is, wordt de entry tevens naar de * @param array $context Additional context
* dynamische log gestuurd (errors/warnings naar EVENT_ERRORS, verder
* naar EVENT_SYSTEM).
*
* @since 2.6.5
*
* @param string $level Loglevel (DEBUG, INFO, WARNING, ERROR).
* @param string $message Boodschap die gelogd moet worden.
* @param array $context Aanvullende contextuele data. Default lege array.
* @return void
*/ */
private static function write($level, $message, $context = []) { private static function write($level, $message, $context = []) {
if (self::$logFile === null) { if (self::$logFile === null) {
@@ -178,22 +109,18 @@ class Logger {
} }
/** /**
* Geeft het pad naar het logbestand. * Get log file path
* *
* @since 2.6.5 * @return string Log file path
*
* @return string|null Pad naar het logbestand of null indien niet geïnitialiseerd.
*/ */
public static function getLogFile() { public static function getLogFile() {
return self::$logFile; return self::$logFile;
} }
/** /**
* Verwijdert het logbestand. * Clear log file
* *
* @since 2.6.5 * @return bool Success status
*
* @return bool True indien het bestand succesvol verwijderd is, anders false.
*/ */
public static function clear() { public static function clear() {
if (self::$logFile && file_exists(self::$logFile)) { if (self::$logFile && file_exists(self::$logFile)) {
@@ -203,16 +130,13 @@ class Logger {
} }
/** /**
* Geeft de laatste N regels uit het logbestand. * Get last N lines from log file
* *
* Leest het bestand achterwaarts in chunks zodat grote logbestanden * Reads the file backwards in chunks so large log files never have to be
* nooit volledig in het geheugen geladen hoeven te worden. De regels * loaded into memory in their entirety.
* worden inclusief afsluitende newlines teruggegeven, oudste eerst.
* *
* @since 2.6.5 * @param int $lines Number of lines to retrieve
* * @return array Log lines (including trailing newlines, oldest first)
* @param int $lines Aantal terug te halen regels. Default 100.
* @return array<string> Logregels (oudste eerst) of lege array indien niet beschikbaar.
*/ */
public static function tail($lines = 100) { public static function tail($lines = 100) {
if (!self::$logFile || !file_exists(self::$logFile)) { if (!self::$logFile || !file_exists(self::$logFile)) {
-70
View File
@@ -1,67 +1,16 @@
<?php <?php
/**
* Limiteert het aantal acties per identifier binnen een tijdvenster.
*
* Houdt per identifier (zoals een IP of gebruikersnaam) bij hoeveel pogingen
* binnen een geconfigureerd tijdvenster zijn gedaan. Oudere pogingen vallen
* buiten het venster en worden genegeerd. De teller wordt opgeslagen in een
* CacheInterface-implementatie, standaard FileCache.
*
* @since 2.6.5
*/
class RateLimiter { class RateLimiter {
/**
* Maximum aantal toegestane pogingen binnen het tijdvenster.
*
* @since 2.6.5
* @var int
*/
private int $maxAttempts; private int $maxAttempts;
/**
* Lengte van het tijdvenster in seconden.
*
* @since 2.6.5
* @var int
*/
private int $timeWindow; private int $timeWindow;
/**
* Cache-implementatie waarin de pogingen worden bijgehouden.
*
* @since 2.6.5
* @var CacheInterface
*/
private CacheInterface $cache; private CacheInterface $cache;
/**
* Maak een nieuwe RateLimiter aan.
*
* @since 2.6.5
*
* @param int $maxAttempts Maximum aantal pogingen binnen het tijdvenster. Default 10.
* @param int $timeWindow Lengte van het tijdvenster in seconden. Default 60.
* @param CacheInterface|null $cache Optioneel een eigen cache-implementatie; bij null wordt FileCache gebruikt.
*/
public function __construct(int $maxAttempts = 10, int $timeWindow = 60, ?CacheInterface $cache = null) { public function __construct(int $maxAttempts = 10, int $timeWindow = 60, ?CacheInterface $cache = null) {
$this->maxAttempts = $maxAttempts; $this->maxAttempts = $maxAttempts;
$this->timeWindow = $timeWindow; $this->timeWindow = $timeWindow;
$this->cache = $cache ?? new FileCache(); $this->cache = $cache ?? new FileCache();
} }
/**
* Bepaal of een nieuwe poging voor de identifier is toegestaan.
*
* Verwijder eerst pogingen die buiten het tijdvenster vallen. Wanneer het
* aantal resterende pogingen onder het maximum ligt wordt de huidige
* poging geregistreerd en true teruggegeven; anders false.
*
* @since 2.6.5
*
* @param string $identifier Unieke sleutel voor de te beperken actor (bijv. IP of gebruikersnaam).
* @return bool True wanneer de poging is toegestaan, false wanneer het limiet is bereikt.
*/
public function isAllowed(string $identifier): bool { public function isAllowed(string $identifier): bool {
$key = 'ratelimit_' . md5($identifier); $key = 'ratelimit_' . md5($identifier);
$attempts = $this->cache->get($key) ?? []; $attempts = $this->cache->get($key) ?? [];
@@ -83,17 +32,6 @@ class RateLimiter {
return true; return true;
} }
/**
* Geef het aantal nog resterende pogingen voor de identifier.
*
* Telt alleen pogingen die binnen het tijdvenster vallen. Het resultaat
* is nooit negatief.
*
* @since 2.6.5
*
* @param string $identifier Unieke sleutel voor de te beperken actor.
* @return int Aantal resterende pogingen; minimaal 0.
*/
public function getRemainingAttempts(string $identifier): int { public function getRemainingAttempts(string $identifier): int {
$key = 'ratelimit_' . md5($identifier); $key = 'ratelimit_' . md5($identifier);
$attempts = $this->cache->get($key) ?? []; $attempts = $this->cache->get($key) ?? [];
@@ -106,14 +44,6 @@ class RateLimiter {
return max(0, $this->maxAttempts - count($attempts)); return max(0, $this->maxAttempts - count($attempts));
} }
/**
* Wis alle geregistreerde pogingen voor een identifier.
*
* @since 2.6.5
*
* @param string $identifier Unieke sleutel voor de te beperken actor.
* @return void
*/
public function reset(string $identifier): void { public function reset(string $identifier): void {
$key = 'ratelimit_' . md5($identifier); $key = 'ratelimit_' . md5($identifier);
$this->cache->delete($key); $this->cache->delete($key);
+6 -115
View File
@@ -1,57 +1,14 @@
<?php <?php
/**
* Logging en analyse van inkomende requests.
*
* Biedt functionaliteit om inkomende requests naar een logbestand te
* schrijven, IP-adressen te anonimiseren, IP's tegen lijsten/CIDR-ranges
* te matchen, het client-IP te bepalen en bezoekerstype (bot/mens/AI)
* te detecteren.
*
* @since 2.6.5
*/
class RequestLogger class RequestLogger
{ {
/**
* Pad naar het logbestand.
*
* @since 2.6.5
* @var string
*/
private string $logFile; private string $logFile;
/**
* Maak een nieuwe RequestLogger aan.
*
* @since 2.6.5
*
* @param string $logFile Pad naar het te gebruiken logbestand.
*/
public function __construct(string $logFile) public function __construct(string $logFile)
{ {
$this->logFile = $logFile; $this->logFile = $logFile;
} }
/**
* Schrijf een request-regel naar het logbestand.
*
* De gebruikersagent en referrer worden ontdaan van controle-tekens en
* afgekapt tot 500 tekens. De landcode wordt alleen opgenomen wanneer
* deze exact twee tekens lang is. De mapstructuur wordt automatisch
* aangemaakt indien deze nog niet bestaat.
*
* @since 2.6.5
*
* @param string $page Opgevraagde pagina of route.
* @param string $ip Client IP-adres.
* @param string $userAgent HTTP User-Agent header.
* @param string $referrer HTTP Referer header.
* @param string $host Hostnaam van het request.
* @param string $acceptLanguage HTTP Accept-Language header.
* @param string $status Statusaanduiding van het request. Default 'ok'.
* @param string|null $country Tweeletterige landcode of null. Default null.
* @return void
*/
public function log(string $page, string $ip, string $userAgent, string $referrer, string $host, string $acceptLanguage, string $status = 'ok', ?string $country = null): void public function log(string $page, string $ip, string $userAgent, string $referrer, string $host, string $acceptLanguage, string $status = 'ok', ?string $country = null): void
{ {
$dir = dirname($this->logFile); $dir = dirname($this->logFile);
@@ -68,16 +25,7 @@ class RequestLogger
} }
/** /**
* Anonimiseer het laatste deel van een IP-adres. * Mask the last octet (IPv4) or last block (IPv6) of an IP address
*
* Voor IPv4 wordt het laatste octet vervangen door 'x'. Voor IPv6 worden
* alleen de eerste vier blokken behouden en de rest vervangen door '::x'.
* Ongeldige adressen worden ongewijzigd teruggegeven.
*
* @since 2.6.5
*
* @param string $ip Het te anonimiseren IP-adres.
* @return string Het geanonimiseerde IP-adres of het origineel bij een ongeldig adres.
*/ */
public static function anonymizeIp(string $ip): string public static function anonymizeIp(string $ip): string
{ {
@@ -97,17 +45,13 @@ class RequestLogger
} }
/** /**
* Controleer of een IP overeenkomt met een entry uit een lijst van IP's of CIDR-ranges. * Check whether an IP matches any entry in a list of IPs/CIDR ranges.
* *
* Ondersteunt exacte IPv4/IPv6-adressen en CIDR-notatie (bijv. 192.168.0.0/16). * Supports exact IPv4/IPv6 addresses and CIDR notation (e.g. 192.168.0.0/16).
* Bij een prefix-lengte van 0 komt ieder IP van dezelfde adresfamilie overeen.
* Adresfamilies (IPv4 vs IPv6) worden niet onderling gemengd.
* *
* @since 2.6.5 * @param string $ip The client IP to test
* * @param array $list List of IPs and/or CIDR ranges
* @param string $ip Het te testen client IP-adres. * @return bool True if the IP matches any entry
* @param string[] $list Lijst van IP-adressen en/of CIDR-ranges.
* @return bool True wanneer het IP met een entry overeenkomt.
*/ */
public static function ipMatchesList(string $ip, array $list): bool public static function ipMatchesList(string $ip, array $list): bool
{ {
@@ -173,18 +117,6 @@ class RequestLogger
return false; return false;
} }
/**
* Bepaal het client IP-adres uit de beschikbare request-headers.
*
* Doorloopt in twee passes een vaste set headers (zoals CF-Connecting-IP,
* X-Real-IP, X-Forwarded-For en REMOTE_ADDR). De eerste pass geeft
* voorrang aan geldige publieke IP's en slaat interne/reserved ranges
* over; de tweede pass is een fallback voor lokale ontwikkelomgevingen.
*
* @since 2.6.5
*
* @return string Het gedetecteerde client IP-adres, of '127.0.0.1' als fallback.
*/
public static function getClientIp(): string public static function getClientIp(): string
{ {
$headerKeys = [ $headerKeys = [
@@ -233,21 +165,6 @@ class RequestLogger
return $_SERVER['REMOTE_ADDR'] ?? '127.0.0.1'; return $_SERVER['REMOTE_ADDR'] ?? '127.0.0.1';
} }
/**
* Detecteer het type bezoeker aan de hand van de User-Agent.
*
* Wanneer de BotGuard-class beschikbaar is wordt de UA geïdentificeerd
* en een passend label, badge-kleur en Bootstrap-icon teruggegeven
* (ai, search, scraper, generieke bot, lege UA of mens). Bij een
* ingelogde gebruiker wordt de naam aan het label toegevoegd. Zonder
* BotGuard wordt een algemene bezoeker teruggegeven.
*
* @since 2.6.5
*
* @param string $ua De User-Agent string.
* @param string $user Optionele gebruikersnaam; bij 'Gast' of leeg wordt geen naam toegevoegd. Default ''.
* @return array<string,string> Associatieve array met keys: type, label, badge, icon.
*/
public static function detectVisitorInfo(string $ua, string $user = ''): array public static function detectVisitorInfo(string $ua, string $user = ''): array
{ {
if (class_exists('BotGuard')) { if (class_exists('BotGuard')) {
@@ -285,18 +202,6 @@ class RequestLogger
return ['type' => 'unknown', 'label' => 'Bezoeker', 'badge' => 'secondary', 'icon' => 'bi-person']; return ['type' => 'unknown', 'label' => 'Bezoeker', 'badge' => 'secondary', 'icon' => 'bi-person'];
} }
/**
* Detecteer of het huidige request afkomstig is van een bekende bot.
*
* Leest de User-Agent uit de request-headers en identificeert deze via
* BotGuard wanneer beschikbaar. Alleen de categorieën 'ai', 'search'
* en 'scraper' worden als bot beschouwd en als uppercase string
* teruggegeven; anders null.
*
* @since 2.6.5
*
* @return string|null Boticategorie ('AI', 'SEARCH' of 'SCRAPER') of null bij geen bot.
*/
public static function detectBot(): ?string public static function detectBot(): ?string
{ {
$ua = $_SERVER['HTTP_USER_AGENT'] ?? ''; $ua = $_SERVER['HTTP_USER_AGENT'] ?? '';
@@ -309,20 +214,6 @@ class RequestLogger
return null; return null;
} }
/**
* Lees de laatste regels uit het logbestand en parse deze.
*
* De regels worden geparseerd volgens het vaste logformaat en omgezet
* naar associatieve arrays met tijd, IP, gebruiker, bezoeker-info, taal,
* pagina, UA, referrer, status en landcode. Regels waarvan de host leeg
* is of een IP/cli-waarde bevat worden als gebruiker 'Gast' gemarkeerd.
* Het resultaat is nieuwste-regel-eerst.
*
* @since 2.6.5
*
* @param int $lines Aantal te lezen regels vanaf het einde. Default 100.
* @return array<int,array<string,mixed>> Geparseerde logregels, nieuwste eerst. Lege array bij ontbrekend bestand.
*/
public function getLogs(int $lines = 100): array public function getLogs(int $lines = 100): array
{ {
if (!file_exists($this->logFile)) { if (!file_exists($this->logFile)) {
+45 -169
View File
@@ -5,62 +5,24 @@ use Twig\Environment;
use Twig\Loader\FilesystemLoader; use Twig\Loader\FilesystemLoader;
/** /**
* Beheert het actieve thema en de rendering hiervan. * ThemeManager - Resolves and renders the active theme
* *
* Verantwoordelijkheden: * Responsibilities:
* - Bepaalt de actieve thema-map aan de hand van de configuratie. * - Resolve the active theme directory from config
* - Laadt theme.json (titel, default_layout, template-mapping, kleuren). * - Load theme.json (title, default_layout, template mapping, colors)
* - Bouwt een Twig-omgeving geworteld in de thema-map. * - Build a Twig environment rooted at the theme directory
* - Compileert thema-SCSS naar CSS (in assets/css_compiled/). * - Compile theme SCSS to CSS (in assets/css_compiled/)
* - Mapt een aangevraagde layout naar een concreet .twig-template, met * - Map a requested layout to a concrete .twig template, falling back
* fallback naar de default_layout van het thema wanneer de layout * to the theme's default_layout when the layout is unknown
* onbekend is.
*
* @since 2.6.5
*/ */
class ThemeManager { class ThemeManager {
/**
* Volledige CMS-configuratie.
*
* @since 2.6.5
* @var array Bevat o.a. 'theme_dir' en 'theme'.
*/
private $config; private $config;
/**
* Absoluut pad naar de actieve thema-map.
*
* @since 2.6.5
* @var string
*/
private $themeDir; private $themeDir;
/**
* Ruwe theme.json configuratie-array.
*
* @since 2.6.5
* @var array
*/
private $themeConfig; private $themeConfig;
/**
* Twig-omgeving voor het renderen van thema-templates.
*
* @since 2.6.5
* @var Environment
*/
private $twig; private $twig;
/** /**
* Constructor: initialiseert de thema-manager met de CMS-configuratie. * @param array $config Full CMS config (must contain 'theme_dir' and 'theme')
*
* Stelt de thema-map, theme.json-configuratie en een Twig-omgeving in.
* De Twig-cache staat uit en auto-escape is uitgeschakeld (de thema's
* beheren eigen escaping waar nodig).
*
* @since 2.6.5
*
* @param array $config Volledige CMS-configuratie; moet 'theme_dir' en 'theme' bevatten.
*/ */
public function __construct(array $config) { public function __construct(array $config) {
$this->config = $config; $this->config = $config;
@@ -75,85 +37,55 @@ class ThemeManager {
} }
/** /**
* Geeft het absolute pad van de actieve thema-map. * Get the absolute path of the active theme directory
*
* @since 2.6.5
*
* @return string Absoluut pad naar de thema-map.
*/ */
public function getThemeDir(): string { public function getThemeDir(): string {
return $this->themeDir; return $this->themeDir;
} }
/** /**
* Geeft de ruwe theme.json configuratie-array. * Get the raw theme.json config array
*
* @since 2.6.5
*
* @return array Theme.json inhoud, of lege array bij afwezigheid.
*/ */
public function getThemeConfig(): array { public function getThemeConfig(): array {
return $this->themeConfig; return $this->themeConfig;
} }
/** /**
* Geeft de thema-titel. * Get the theme title (from theme.json 'title' or 'name')
*
* Leest eerst 'title' uit theme.json, dan 'name', en als laatste
* fallback de mapnaam van het thema.
*
* @since 2.6.5
*
* @return string Thematische titel.
*/ */
public function getTitle(): string { public function getTitle(): string {
return $this->themeConfig['title'] ?? $this->themeConfig['name'] ?? basename($this->themeDir); return $this->themeConfig['title'] ?? $this->themeConfig['name'] ?? basename($this->themeDir);
} }
/** /**
* Geeft de 'config'-sectie van theme.json. * Get the theme config section (default_template, background settings, etc.)
*
* Bevat o.a. default_template en achtergrondinstellingen.
*
* @since 2.6.5
*
* @return array Config-sectie, of lege array bij afwezigheid.
*/ */
public function getConfig(): array { public function getConfig(): array {
return $this->themeConfig['config'] ?? []; return $this->themeConfig['config'] ?? [];
} }
/** /**
* Geeft de 'template'-sectie van theme.json. * Get the theme template section (layout key => .twig file mapping)
*
* Bevat de mapping van layout-key naar .twig-bestand.
*
* @since 2.6.5
*
* @return array<string,string> Layout-key => .twig-bestand mapping.
*/ */
public function getTemplates(): array { public function getTemplates(): array {
return $this->themeConfig['template'] ?? []; return $this->themeConfig['template'] ?? [];
} }
/** /**
* Bepaalt het .twig-templatebestand voor een aangevraagde layout. * Resolve the .twig template file for a requested layout.
* *
* Templates worden gedefinieerd in theme.json onder de "template"-sectie: * Templates are defined in theme.json under the "template" section:
* { "template": { "full_content": "full_content.twig", ... } } * { "template": { "full_content": "full_content.twig", ... } }
* De standaardtemplate staat in de "config"-sectie: * The default template is defined in the "config" section:
* { "config": { "default_template": "full_content", ... } } * { "config": { "default_template": "full_content", ... } }
* *
* Prioriteit: * Priority:
* 1. Als de layout een bekende key is in de "template"-sectie, gebruik * 1. If the layout is a known key in the "template" section, use its mapped file.
* het bijbehorende bestand. * 2. Otherwise fall back to config.default_template.
* 2. Anders fallback naar config.default_template. * 3. Final safety net: full_content.twig.
* 3. Laatste veiligheidsnet: full_content.twig.
* *
* @since 2.6.5 * @param string $layout Requested layout key (e.g. 'left_sidebar')
* * @return string Template name usable by the Twig loader
* @param string $layout Aangevraagde layout-key (bijv. 'left_sidebar').
* @return string Templacenaam bruikbaar voor de Twig-loader.
*/ */
public function getTemplateForLayout(string $layout): string { public function getTemplateForLayout(string $layout): string {
$layout = trim($layout); $layout = trim($layout);
@@ -179,23 +111,16 @@ class ThemeManager {
} }
/** /**
* Geeft de lijst met beschikbare layout-keys uit de "template"-sectie. * Get the list of available layout keys defined in the "template" section.
* *
* @since 2.6.5 * @return array List of layout keys
*
* @return array<string> Lijst met layout-keys.
*/ */
public function getLayouts(): array { public function getLayouts(): array {
return array_keys($this->getTemplates()); return array_keys($this->getTemplates());
} }
/** /**
* Controleert of een templatebestand bestaat in de thema-map. * Check whether a template file exists in the theme directory
*
* @since 2.6.5
*
* @param string $file Bestandsnaam van het template (relatief t.o.v. thema-map).
* @return bool True als het bestand bestaat.
*/ */
private function templateExists(string $file): bool { private function templateExists(string $file): bool {
$path = $this->themeDir . '/' . ltrim($file, '/'); $path = $this->themeDir . '/' . ltrim($file, '/');
@@ -203,13 +128,11 @@ class ThemeManager {
} }
/** /**
* Rendert een layout-template met de gegeven data. * Render a layout template with the given data.
* *
* @since 2.6.5 * @param string $layout Requested layout key
* * @param array $data Template variables
* @param string $layout Aangevraagde layout-key. * @return string Rendered HTML
* @param array $data Template-variabelen.
* @return string Gerenderde HTML.
*/ */
public function render(string $layout, array $data): string { public function render(string $layout, array $data): string {
$template = $this->getTemplateForLayout($layout); $template = $this->getTemplateForLayout($layout);
@@ -217,17 +140,11 @@ class ThemeManager {
} }
/** /**
* Compileert de SCSS van het thema naar CSS (gecacht op bron-mtime). * Compile the theme's SCSS to CSS (cached by source mtime).
* Compiles from assets/scss/theme.scss to assets/css_compiled/theme.css
* *
* Compileert vanuit assets/scss/theme.scss naar assets/css_compiled/theme.css. * @param bool $force Force recompilation
* De gecompileerde CSS en een .mtime-cachebestand worden op alleen-lezen * @return string|null Absolute path to the compiled CSS, or null if none
* (0444) gezet om handmatige aanpassingen te voorkomen. Bij een fout
* wordt deze gelogd en null teruggegeven.
*
* @since 2.6.5
*
* @param bool $force Forceer hercompilatie ongeacht de cache. Default false.
* @return string|null Absoluut pad naar de gecompileerde CSS, of null bij fout/afwezigheid.
*/ */
public function compileCss(bool $force = false): ?string { public function compileCss(bool $force = false): ?string {
$scssFile = $this->themeDir . '/assets/scss/theme.scss'; $scssFile = $this->themeDir . '/assets/scss/theme.scss';
@@ -276,15 +193,8 @@ class ThemeManager {
} }
/** /**
* Geeft de publieke URL voor de thema-CSS. * Get the public URL for the theme CSS.
* * Uses assets/css_compiled/theme.css (compiled from SCSS by scssphp).
* Gebruikt assets/css_compiled/theme.css (gecompileerd vanuit SCSS door
* scssphp). Indien de gecompileerde CSS nog niet bestaat, wordt deze
* alsnog gecompileerd.
*
* @since 2.6.5
*
* @return string|null Publieke CSS-URL, of null indien niet beschikbaar.
*/ */
public function getCssUrl(): ?string { public function getCssUrl(): ?string {
$compiledCss = $this->themeDir . '/assets/css_compiled/theme.css'; $compiledCss = $this->themeDir . '/assets/css_compiled/theme.css';
@@ -302,11 +212,7 @@ class ThemeManager {
} }
/** /**
* Geeft de publieke URL voor de thema-JS, of null indien niet beschikbaar. * Get the public URL for the theme JS, or null if unavailable.
*
* @since 2.6.5
*
* @return string|null Publieke JS-URL, of null indien niet beschikbaar.
*/ */
public function getJsUrl(): ?string { public function getJsUrl(): ?string {
$jsFile = $this->themeDir . '/assets/js/theme.js'; $jsFile = $this->themeDir . '/assets/js/theme.js';
@@ -317,12 +223,7 @@ class ThemeManager {
} }
/** /**
* Geeft de publieke URL voor een thema-asset. * Get public URL for a theme asset.
*
* @since 2.6.5
*
* @param string $assetPath Pad naar de asset binnen de assets/-map van het thema.
* @return string Publieke URL in de vorm '/themes/<naam>/assets/<path>'.
*/ */
private function getThemeAssetUrl(string $assetPath): string { private function getThemeAssetUrl(string $assetPath): string {
$themeName = basename($this->themeDir); $themeName = basename($this->themeDir);
@@ -330,22 +231,14 @@ class ThemeManager {
} }
/** /**
* Controleert of het thema een SCSS-bronbestand heeft. * Check if theme has SCSS source file.
*
* @since 2.6.5
*
* @return bool True als assets/scss/theme.scss bestaat.
*/ */
public function hasScss(): bool { public function hasScss(): bool {
return is_file($this->themeDir . '/assets/scss/theme.scss'); return is_file($this->themeDir . '/assets/scss/theme.scss');
} }
/** /**
* Controleert of de gecompileerde CSS nieuwer is dan de SCSS-bron. * Check if compiled CSS is newer than SCSS source.
*
* @since 2.6.5
*
* @return bool True als de CSS-_mtime >= SCSS-mtime, anders false.
*/ */
public function isScssCompiled(): bool { public function isScssCompiled(): bool {
$scssFile = $this->themeDir . '/assets/scss/theme.scss'; $scssFile = $this->themeDir . '/assets/scss/theme.scss';
@@ -359,24 +252,15 @@ class ThemeManager {
} }
/** /**
* Controleert of het thema een handmatig CSS-bestand heeft. * Check if theme has manual CSS file.
*
* @since 2.6.5
*
* @return bool True als assets/css/theme.css bestaat.
*/ */
public function hasManualCss(): bool { public function hasManualCss(): bool {
return is_file($this->themeDir . '/assets/css/theme.css'); return is_file($this->themeDir . '/assets/css/theme.css');
} }
/** /**
* Geeft een lijst met CSS-bestanden in de assets/css/-map van het thema. * Get list of CSS files in theme assets/css/ directory.
* * Excludes css_compiled directory.
* De css_compiled-map wordt uitgesloten.
*
* @since 2.6.5
*
* @return array<string> Lijst met publieke CSS-URLs.
*/ */
public function getCssFiles(): array { public function getCssFiles(): array {
$cssDir = $this->themeDir . '/assets/css'; $cssDir = $this->themeDir . '/assets/css';
@@ -397,11 +281,7 @@ class ThemeManager {
} }
/** /**
* Geeft een lijst met JS-bestanden in de assets/js/-map van het thema. * Get list of JS files in theme assets/js/ directory.
*
* @since 2.6.5
*
* @return array<string> Lijst met publieke JS-URLs.
*/ */
public function getJsFiles(): array { public function getJsFiles(): array {
$jsDir = $this->themeDir . '/assets/js'; $jsDir = $this->themeDir . '/assets/js';
@@ -422,11 +302,7 @@ class ThemeManager {
} }
/** /**
* Geeft de URL voor de favicon indien deze bestaat. * Get URL for favicon if it exists.
*
* @since 2.6.5
*
* @return string|null Publieke favicon-URL, of null indien niet beschikbaar.
*/ */
public function getFaviconUrl(): ?string { public function getFaviconUrl(): ?string {
$faviconFile = $this->themeDir . '/assets/img/favicon.svg'; $faviconFile = $this->themeDir . '/assets/img/favicon.svg';
-40
View File
@@ -1,30 +1,9 @@
<?php <?php
/**
* Configuratie-loader voor CodePress CMS.
*
* Laadt config.json (of maakt deze aan op basis van config.json.example of
* een ingebouwde standaardconfiguratie), voegt ontbrekende secties
* (security, analytics, logging) samen met defaults, converteert relatieve
* content_dir-paden naar absoluut, laadt de actieve theme-configuratie en
* returnt de uiteindelijke configuratie-array. Bij falen volgt een
* minimale fallback-configuratie.
*
* @since 2.6.5
* @package CodePress
*/
// Simple configuration loader // Simple configuration loader
$configJsonPath = __DIR__ . '/../../config.json'; $configJsonPath = __DIR__ . '/../../config.json';
$configExamplePath = __DIR__ . '/../../config.json.example'; $configExamplePath = __DIR__ . '/../../config.json.example';
/**
* config.json automatisch aanmaken als deze nog niet bestaat.
*
* Kopieert config.json.example indien aanwezig; anders wordt een ingebouwde
* standaardconfiguratie weggeschreven.
*
* @since 2.6.5
*/
// Auto-create config.json if it does not exist // Auto-create config.json if it does not exist
if (!file_exists($configJsonPath)) { if (!file_exists($configJsonPath)) {
if (file_exists($configExamplePath)) { if (file_exists($configExamplePath)) {
@@ -104,15 +83,6 @@ if (!file_exists($configJsonPath)) {
} }
} }
/**
* config.json inladen en ontbrekende secties aanvullen met defaults.
*
* Voegt default-waarden samen voor security, analytics en logging,
* garandeert de excluded_ips-standaardlijst en converteert relatieve
* content_dir-paden naar absoluut.
*
* @since 2.6.5
*/
if (file_exists($configJsonPath)) { if (file_exists($configJsonPath)) {
$jsonContent = file_get_contents($configJsonPath); $jsonContent = file_get_contents($configJsonPath);
$config = json_decode($jsonContent, true); $config = json_decode($jsonContent, true);
@@ -180,11 +150,6 @@ if (file_exists($configJsonPath)) {
$config['content_dir'] = $projectRoot . $config['content_dir']; $config['content_dir'] = $projectRoot . $config['content_dir'];
} }
/**
* Actieve theme-configuratie laden vanuit theme.json.
*
* @since 2.6.5
*/
// Load active theme // Load active theme
$activeTheme = $config['active_theme'] ?? 'default'; $activeTheme = $config['active_theme'] ?? 'default';
$themeDir = __DIR__ . '/../../themes/' . $activeTheme; $themeDir = __DIR__ . '/../../themes/' . $activeTheme;
@@ -201,11 +166,6 @@ if (file_exists($configJsonPath)) {
} }
} }
/**
* Minimale fallback-configuratie wanneer config.json niet geladen kon worden.
*
* @since 2.6.5
*/
// Fallback to minimal config // Fallback to minimal config
return [ return [
'site_title' => 'CodePress', 'site_title' => 'CodePress',
+16 -56
View File
@@ -1,52 +1,37 @@
<?php <?php
/** /**
* CodePress CMS Core Loader. * CodePress CMS Core Loader
* *
* Centraal bootstrap-bestand voor de CodePress CMS-core. Laadt alle * This file serves as the central entry point for the CodePress CMS core system.
* essentiële classes en configuratie die nodig zijn voor het CMS: * It loads all essential classes and configuration needed for the CMS to function.
* configuratie, Composer-autoloader, core utility classes, logger,
* plugin-systeem, ContentAPI en de hoofdclass CodePressCMS.
* *
* Architectuur: * Architecture:
* - config.php: configuratie-loader die defaults samenvoegt met config.json. * - config.php: Configuration loader that merges default settings with config.json
* - ThemeManager.php: Twig-based theme rendering + SCSS-compilatie. * - ThemeManager.php: Twig-based theme rendering + SCSS compilation
* - CodePressCMS.php: hoofdclass voor content, navigation, search en rendering. * - CodePressCMS.php: Main CMS class handling content, navigation, search, and rendering
* *
* Gebruik: * Usage:
* Dit bestand wordt geïnclude door public/index.php, dat vervolgens: * This file is included by public/index.php, which then:
* 1. Configuratie laadt vanuit config.php. * 1. Loads configuration from config.php
* 2. Een CodePressCMS-instantie aanmaakt met de config. * 2. Creates a new CodePressCMS instance with the config
* 3. render() aanroept om de pagina uit te voeren. * 3. Calls render() to output the complete page
* *
* @since 2.6.5 * The separation allows for:
* @package CodePress * - Clean public entry point (public/index.php)
* - Reusable core components
* - Proper class organization with PHPDoc documentation
*/ */
/**
* Configuratie-systeem laden: defaults en config.json-merge.
*
* @since 2.6.5
*/
// Load configuration system - handles default settings and config.json merging // Load configuration system - handles default settings and config.json merging
require_once 'config.php'; require_once 'config.php';
/**
* Composer-autoloader laden indien aanwezig.
*
* @since 2.6.5
*/
// Load Composer autoloader // Load Composer autoloader
$autoloader = dirname(__DIR__, 2) . '/vendor/autoload.php'; $autoloader = dirname(__DIR__, 2) . '/vendor/autoload.php';
if (file_exists($autoloader)) { if (file_exists($autoloader)) {
require_once $autoloader; require_once $autoloader;
} }
/**
* Core utility classes laden.
*
* @since 2.6.5
*/
// Load core utility classes // Load core utility classes
require_once 'class/Cache.php'; require_once 'class/Cache.php';
require_once 'class/RateLimiter.php'; require_once 'class/RateLimiter.php';
@@ -56,46 +41,21 @@ require_once 'class/GeoIP.php';
require_once 'class/Analytics.php'; require_once 'class/Analytics.php';
require_once 'class/ThemeManager.php'; require_once 'class/ThemeManager.php';
/**
* Logger-klassen laden voor gestructureerde logging met log levels.
*
* @since 2.6.5
*/
// Load Logger class - structured logging with log levels // Load Logger class - structured logging with log levels
require_once 'class/Logger.php'; require_once 'class/Logger.php';
require_once 'class/LogManager.php'; require_once 'class/LogManager.php';
/**
* Plugin-systeem laden (interfaces, API's en PluginManager).
*
* @since 2.6.5
*/
// Load Plugin system // Load Plugin system
require_once 'plugin/PluginAPIInterface.php'; require_once 'plugin/PluginAPIInterface.php';
require_once 'plugin/CMSAPI.php'; require_once 'plugin/CMSAPI.php';
require_once 'plugin/AdminPluginAPI.php'; require_once 'plugin/AdminPluginAPI.php';
require_once 'plugin/PluginManager.php'; require_once 'plugin/PluginManager.php';
/**
* ContentAPI laden: CMS-data-toegang voor PHP content-bestanden.
*
* @since 2.6.5
*/
// Load ContentAPI class - provides CMS data access for PHP content files // Load ContentAPI class - provides CMS data access for PHP content files
require_once 'class/ContentAPI.php'; require_once 'class/ContentAPI.php';
/**
* Hoofdclass laden: content parsing, navigation, search en page rendering.
*
* @since 2.6.5
*/
// Load main CMS class - handles content parsing, navigation, search, and page rendering // Load main CMS class - handles content parsing, navigation, search, and page rendering
require_once 'class/CodePressCMS.php'; require_once 'class/CodePressCMS.php';
/**
* Logger initialiseren (debug-mode kan via config worden ingeschakeld).
*
* @since 2.6.5
*/
// Initialize logger (debug mode can be enabled in config) // Initialize logger (debug mode can be enabled in config)
Logger::init(); Logger::init();
+24 -109
View File
@@ -1,54 +1,16 @@
<?php <?php
/** /**
* Lichtgewicht API-wrapper voor plugins in de admin-context. * Lightweight API wrapper for plugins in the admin context.
* * Provides read-only access to the site config (no CMS instance needed).
* Biedt alleen-lezen toegang tot de site-config (zonder CMS-instance nodig).
*
* @since 2.6.5
*/ */
class AdminPluginAPI implements PluginAPIInterface class AdminPluginAPI implements PluginAPIInterface
{ {
/**
* De site-configuratie als associatieve array.
*
* @since 2.6.5
* @var array<string,mixed>
*/
private array $config; private array $config;
/**
* Het absolute pad naar de project-root.
*
* @since 2.6.5
* @var string
*/
private string $projectRoot; private string $projectRoot;
/**
* De actieve admin-taalcode (bijv. 'nl', 'en').
*
* @since 2.6.5
* @var string
*/
private string $adminLanguage; private string $adminLanguage;
/**
* De admin PluginManager-instantie, optioneel via setPluginManager geïnjecteerd.
*
* @since 2.6.5
* @var PluginManager|null
*/
private ?PluginManager $pluginManager = null; private ?PluginManager $pluginManager = null;
/**
* Construeer een AdminPluginAPI-instantie met de opgegeven site-config.
*
* @since 2.6.5
*
* @param array<string,mixed> $siteConfig De site-configuratie.
* @param string $projectRoot Optioneel absoluut pad naar de project-root.
*/
public function __construct(array $siteConfig, string $projectRoot = '') public function __construct(array $siteConfig, string $projectRoot = '')
{ {
$this->config = $siteConfig; $this->config = $siteConfig;
@@ -58,13 +20,8 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Injecteer de admin PluginManager zodat plugins hun eigen vertalingen * Inject the admin PluginManager so plugins can resolve their own
* via dezelfde fallback-keten kunnen resolven. * translations through the same fallback chain.
*
* @since 2.6.5
*
* @param PluginManager $pm De admin PluginManager-instantie.
* @return void
*/ */
public function setPluginManager(PluginManager $pm): void public function setPluginManager(PluginManager $pm): void
{ {
@@ -72,13 +29,7 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal een configuratiewaarde op via dot-notatie. * Get configuration value using dot notation.
*
* @since 2.6.5
*
* @param string $key Configuratie-sleutel in dot-notatie (bijv. 'language.default').
* @param mixed $default Standaardwaarde indien de sleutel niet bestaat.
* @return mixed De gevonden waarde of $default indien niet gevonden.
*/ */
public function getConfig(string $key, $default = null) public function getConfig(string $key, $default = null)
{ {
@@ -96,11 +47,7 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal de project-rootdirectory op. * Get the project root directory.
*
* @since 2.6.5
*
* @return string Absoluut pad naar de project-root.
*/ */
public function getProjectRoot(): string public function getProjectRoot(): string
{ {
@@ -108,30 +55,15 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal het pad naar de contentdirectory op als absoluut pad. * Get the content directory path.
*
* Relatieve paden uit config.json (bijv. 'content') worden afgezet tegen
* de project-root, conform het gedrag van cms/core/config.php.
*
* @since 2.6.5
*
* @return string Absoluut pad naar de contentdirectory.
*/ */
public function getContentDir(): string public function getContentDir(): string
{ {
$dir = $this->config['content_dir'] ?? ($this->projectRoot . '/content'); return $this->config['content_dir'] ?? ($this->projectRoot . '/content');
if ($dir !== '' && $dir[0] !== DIRECTORY_SEPARATOR && !preg_match('#^[A-Za-z]:[/\\\\]#', $dir)) {
$dir = $this->projectRoot . '/' . $dir;
}
return rtrim($dir, '/');
} }
/** /**
* Haal het pad naar de pluginsdirectory op. * Get the plugins directory path.
*
* @since 2.6.5
*
* @return string Absoluut pad naar de pluginsdirectory.
*/ */
public function getPluginsDir(): string public function getPluginsDir(): string
{ {
@@ -139,11 +71,7 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal de lijst met ingeschakelde plugins op. * Get the list of enabled plugins.
*
* @since 2.6.5
*
* @return array<int,string> Lijst met ingeschakelde plugin-namen.
*/ */
public function getEnabledPlugins(): array public function getEnabledPlugins(): array
{ {
@@ -151,11 +79,7 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal de versie-informatie uit version.php op. * Get the version info from version.php.
*
* @since 2.6.5
*
* @return array<string,mixed> Versie-informatie met minimaal de sleutel 'version'.
*/ */
public function getVersionInfo(): array public function getVersionInfo(): array
{ {
@@ -170,13 +94,8 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal de actieve admin-taalcode op (bijv. 'nl', 'en'). * Get the active admin language code (e.g. 'nl', 'en').
* * System plugins should use this to resolve their translations.
* System-plugins gebruiken deze om hun vertalingen te resolven.
*
* @since 2.6.5
*
* @return string De actieve admin-taalcode.
*/ */
public function getAdminLanguage(): string public function getAdminLanguage(): string
{ {
@@ -184,16 +103,14 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Haal de vertalingen voor een plugin op in de admin-context. * Get the translations for a plugin in the admin context.
* *
* Fallback-keten (afgehandeld door PluginManager): * Fallback chain (handled by PluginManager):
* aangevraagde taal -> default_language van de plugin -> lege array. * requested language -> plugin default_language -> empty array.
* *
* @since 2.6.5 * @param string $pluginName Plugin directory name
* * @param string|null $lang Override language; defaults to the active admin language
* @param string $pluginName Plugin-directorynaam. * @return array Translations [key => value]
* @param string|null $lang Override-taal; standaard de actieve admin-taal.
* @return array<string,string> Vertalingen als [key => value].
*/ */
public function getPluginTranslations(string $pluginName, ?string $lang = null): array public function getPluginTranslations(string $pluginName, ?string $lang = null): array
{ {
@@ -205,14 +122,12 @@ class AdminPluginAPI implements PluginAPIInterface
} }
/** /**
* Vertaal een enkele sleutel voor een plugin in de admin-context. * Translate a single key for a plugin in the admin context.
* *
* @since 2.6.5 * @param string $key Translation key
* * @param string $pluginName Plugin directory name
* @param string $key Vertaalsleutel. * @param string|null $lang Override language; defaults to the active admin language
* @param string $pluginName Plugin-directorynaam. * @return string Translated string, or $key if not found
* @param string|null $lang Override-taal; standaard de actieve admin-taal.
* @return string Vertaalde string, of $key indien niet gevonden.
*/ */
public function t(string $key, string $pluginName, ?string $lang = null): string public function t(string $key, string $pluginName, ?string $lang = null): string
{ {
+37 -226
View File
@@ -1,51 +1,18 @@
<?php <?php
/**
* Front-end plugin-API voor content-plugins.
*
* Biedt toegang tot de CodePressCMS-instance, pagina-informatie, menu, zoekresultaten,
* vertalingen en bestandsoperaties binnen de front-end context.
*
* @since 2.6.5
*/
class CMSAPI implements PluginAPIInterface class CMSAPI implements PluginAPIInterface
{ {
/**
* De CodePressCMS-hoofdinstantie.
*
* @since 2.6.5
* @var CodePressCMS
*/
private CodePressCMS $cms; private CodePressCMS $cms;
/**
* De front-end PluginManager-instantie, optioneel via setPluginManager geïnjecteerd.
*
* @since 2.6.5
* @var PluginManager|null
*/
private ?PluginManager $pluginManager = null; private ?PluginManager $pluginManager = null;
/**
* Construeer een CMSAPI-instantie met de opgegeven CodePressCMS.
*
* @since 2.6.5
*
* @param CodePressCMS $cms De CodePressCMS-hoofdinstantie.
*/
public function __construct(CodePressCMS $cms) public function __construct(CodePressCMS $cms)
{ {
$this->cms = $cms; $this->cms = $cms;
} }
/** /**
* Injecteer de front-end PluginManager zodat content-plugins hun eigen * Inject the front-end PluginManager so content plugins can resolve
* vertalingen via dezelfde fallback-keten kunnen resolven. * their own translations through the same fallback chain.
*
* @since 2.6.5
*
* @param PluginManager $pm De front-end PluginManager-instantie.
* @return void
*/ */
public function setPluginManager(PluginManager $pm): void public function setPluginManager(PluginManager $pm): void
{ {
@@ -53,11 +20,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de informatie van de huidige pagina op. * Get current page information
*
* @since 2.6.5
*
* @return array<string,mixed> Pagina-informatie van de huidige pagina.
*/ */
public function getCurrentPage(): array public function getCurrentPage(): array
{ {
@@ -65,11 +28,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de titel van de huidige pagina op. * Get current page title
*
* @since 2.6.5
*
* @return string De titel van de huidige pagina, of lege string.
*/ */
public function getCurrentPageTitle(): string public function getCurrentPageTitle(): string
{ {
@@ -78,11 +37,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de inhoud van de huidige pagina op. * Get current page content
*
* @since 2.6.5
*
* @return string De HTML-inhoud van de huidige pagina, of lege string.
*/ */
public function getCurrentPageContent(): string public function getCurrentPageContent(): string
{ {
@@ -91,11 +46,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de URL van de huidige pagina op. * Get current page URL
*
* @since 2.6.5
*
* @return string De URL van de huidige pagina inclusief query-parameters.
*/ */
public function getCurrentPageUrl(): string public function getCurrentPageUrl(): string
{ {
@@ -105,11 +56,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de menustructuur op. * Get menu structure
*
* @since 2.6.5
*
* @return array<int,array<string,mixed>> De menustructuur.
*/ */
public function getMenu(): array public function getMenu(): array
{ {
@@ -117,13 +64,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal een configuratiewaarde op via dot-notatie. * Get configuration value
*
* @since 2.6.5
*
* @param string $key Configuratie-sleutel in dot-notatie (bijv. 'language.default').
* @param mixed $default Standaardwaarde indien de sleutel niet bestaat.
* @return mixed De gevonden waarde of $default indien niet gevonden.
*/ */
public function getConfig(string $key, $default = null) public function getConfig(string $key, $default = null)
{ {
@@ -141,70 +82,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de project-rootdirectory op (absoluut, genormaliseerd). * Get translation
*
* @since 2.6.5
*
* @return string Absoluut pad naar de project-root.
*/
public function getProjectRoot(): string
{
return dirname(__DIR__, 3);
}
/**
* Haal het pad naar de contentdirectory op (absoluut, genormaliseerd).
*
* De CMS-config lost relatieve content_dir-waarden al op
* (zie cms/core/config.php), dus deze wordt as-is teruggegeven.
*
* @since 2.6.5
*
* @return string Absoluut pad naar de contentdirectory.
*/
public function getContentDir(): string
{
return rtrim($this->cms->config['content_dir'] ?? ($this->getProjectRoot() . '/content'), '/');
}
/**
* Haal het pad naar de pluginsdirectory op (absoluut, genormaliseerd).
*
* @since 2.6.5
*
* @return string Absoluut pad naar de pluginsdirectory.
*/
public function getPluginsDir(): string
{
return $this->getProjectRoot() . '/plugins';
}
/**
* Haal de versie-informatie uit version.php op.
*
* @since 2.6.5
*
* @return array<string,mixed> Versie-informatie met minimaal de sleutel 'version'.
*/
public function getVersionInfo(): array
{
$versionFile = $this->getProjectRoot() . '/version.php';
if (file_exists($versionFile)) {
$data = include $versionFile;
if (is_array($data)) {
return $data;
}
}
return ['version' => '0.0.0'];
}
/**
* Haal een vertaling op voor de opgegeven sleutel.
*
* @since 2.6.5
*
* @param string $key Vertaalsleutel.
* @return string De vertaalde string, of $key indien niet gevonden.
*/ */
public function translate(string $key): string public function translate(string $key): string
{ {
@@ -212,11 +90,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de huidige content-taal op. * Get current language
*
* @since 2.6.5
*
* @return string De huidige taalcode (bijv. 'nl', 'en').
*/ */
public function getCurrentLanguage(): string public function getCurrentLanguage(): string
{ {
@@ -224,11 +98,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Controleer of de gebruiker zich op de homepage bevindt. * Check if user is on homepage
*
* @since 2.6.5
*
* @return bool True indien de huidige pagina de default_page is.
*/ */
public function isHomepage(): bool public function isHomepage(): bool
{ {
@@ -238,11 +108,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de bestandsinformatie van de huidige pagina op. * Get file info for current page
*
* @since 2.6.5
*
* @return array<string,mixed>|null Bestandsinformatie of null indien niet aanwezig.
*/ */
public function getCurrentPageFileInfo(): ?array public function getCurrentPageFileInfo(): ?array
{ {
@@ -251,11 +117,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de breadcrumb-HTML op. * Get breadcrumb data
*
* @since 2.6.5
*
* @return string De gegenereerde breadcrumb-HTML.
*/ */
public function getBreadcrumb(): string public function getBreadcrumb(): string
{ {
@@ -263,11 +125,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Controleer of de contentdirectory inhoud bevat. * Check if content directory has content
*
* @since 2.6.5
*
* @return bool True indien de contentdirectory niet leeg is.
*/ */
public function hasContent(): bool public function hasContent(): bool
{ {
@@ -275,11 +133,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de zoekresultaten op indien een zoekopdracht actief is. * Get search results if searching
*
* @since 2.6.5
*
* @return array<int,array<string,mixed>> De zoekresultaten, of een lege array.
*/ */
public function getSearchResults(): array public function getSearchResults(): array
{ {
@@ -290,11 +144,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Controleer of momenteel een zoekopdracht wordt uitgevoerd. * Check if currently searching
*
* @since 2.6.5
*
* @return bool True indien de search-query-parameter aanwezig is.
*/ */
public function isSearching(): bool public function isSearching(): bool
{ {
@@ -302,11 +152,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de beschikbare talen op. * Get available languages
*
* @since 2.6.5
*
* @return array<int,string> Lijst met beschikbare taalcodes.
*/ */
public function getAvailableLanguages(): array public function getAvailableLanguages(): array
{ {
@@ -314,13 +160,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Maak een URL voor een pagina. * Create URL for page
*
* @since 2.6.5
*
* @param string $page Pagina-identifier.
* @param string|null $lang Taalcode; standaard de huidige content-taal.
* @return string De gegenereerde pagina-URL met query-parameters.
*/ */
public function createUrl(string $page, ?string $lang = null): string public function createUrl(string $page, ?string $lang = null): string
{ {
@@ -329,15 +169,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Voer een PHP-bestand uit en vang de output op. * Execute PHP file and capture output
*
* Het bestand moet binnen de CMS-directory liggen om willekeurige
* file-inclusion te voorkomen.
*
* @since 2.6.5
*
* @param string $filePath Absoluut pad naar het PHP-bestand.
* @return string De opgevangen output, of lege string indien ongeldig.
*/ */
public function executePhpFile(string $filePath): string public function executePhpFile(string $filePath): string
{ {
@@ -358,12 +190,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de inhoud op uit een PHP-, HTML- of Markdown-bestand. * Get content from PHP/HTML/Markdown file
*
* @since 2.6.5
*
* @param string $filePath Pad naar het bestand.
* @return string De bestandsinhoud (gerenderd indien PHP/Markdown), of lege string.
*/ */
public function getFileContent(string $filePath): string public function getFileContent(string $filePath): string
{ {
@@ -388,12 +215,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Controleer of een bestand in de contentdirectory bestaat. * Check if file exists in content directory
*
* @since 2.6.5
*
* @param string $filename Bestandsnaam relatief ten opzichte van de contentdirectory.
* @return bool True indien het bestand bestaat.
*/ */
public function contentFileExists(string $filename): bool public function contentFileExists(string $filename): bool
{ {
@@ -402,11 +224,7 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal alle content-items (mappen + bestanden) op als lijst met entry-arrays. * Get all pages with their metadata
*
* @since 2.6.5
*
* @return array<int,array<string,mixed>> Lijst met entries ['path' => ..., 'title' => ..., 'type' => ...].
*/ */
public function getAllPages(): array public function getAllPages(): array
{ {
@@ -414,13 +232,10 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de auteursmetadata van de huidige pagina op. * Get the author metadata for the current page.
* Returns author_name, author_email and created from the page frontmatter.
* *
* Geeft author_name, author_email en created terug uit de pagina-frontmatter. * @return array Author metadata with keys: author_name, author_email, created
*
* @since 2.6.5
*
* @return array<string,string> Auteursmetadata met sleutels: author_name, author_email, created.
*/ */
public function getPageAuthor(): array public function getPageAuthor(): array
{ {
@@ -434,17 +249,15 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Haal de vertalingen voor een plugin op in de front-end context. * Get the translations for a plugin in the front-end context.
* *
* Content-plugins volgen de huidige content-taal. Fallback-keten * Content plugins follow the current content language. Fallback chain
* (afgehandeld door PluginManager): aangevraagde taal -> * (handled by PluginManager): requested language -> plugin
* default_language van de plugin -> lege array. * default_language -> empty array.
* *
* @since 2.6.5 * @param string $pluginName Plugin directory name
* * @param string|null $lang Override language; defaults to the current content language
* @param string $pluginName Plugin-directorynaam. * @return array Translations [key => value]
* @param string|null $lang Override-taal; standaard de huidige content-taal.
* @return array<string,string> Vertalingen als [key => value].
*/ */
public function getPluginTranslations(string $pluginName, ?string $lang = null): array public function getPluginTranslations(string $pluginName, ?string $lang = null): array
{ {
@@ -456,14 +269,12 @@ class CMSAPI implements PluginAPIInterface
} }
/** /**
* Vertaal een enkele sleutel voor een plugin in de front-end context. * Translate a single key for a plugin in the front-end context.
* *
* @since 2.6.5 * @param string $key Translation key
* * @param string $pluginName Plugin directory name
* @param string $key Vertaalsleutel. * @param string|null $lang Override language; defaults to the current content language
* @param string $pluginName Plugin-directorynaam. * @return string Translated string, or $key if not found
* @param string|null $lang Override-taal; standaard de huidige content-taal.
* @return string Vertaalde string, of $key indien niet gevonden.
*/ */
public function t(string $key, string $pluginName, ?string $lang = null): string public function t(string $key, string $pluginName, ?string $lang = null): string
{ {
+14 -70
View File
@@ -1,89 +1,33 @@
<?php <?php
/** /**
* Interface voor plugin-API-objecten. * Interface for plugin API objects.
* * Both CMSAPI (front-end) and AdminPluginAPI (admin) implement this.
* Zowel CMSAPI (front-end) als AdminPluginAPI (admin) implementeren deze interface.
*
* @since 2.6.5
*/ */
interface PluginAPIInterface interface PluginAPIInterface
{ {
/**
* Haal een configuratiewaarde op via dot-notatie.
*
* @since 2.6.5
*
* @param string $key Configuratie-sleutel in dot-notatie (bijv. 'language.default').
* @param mixed $default Standaardwaarde indien de sleutel niet bestaat.
* @return mixed De gevonden waarde of $default indien niet gevonden.
*/
public function getConfig(string $key, $default = null); public function getConfig(string $key, $default = null);
/** /**
* Haal de project-rootdirectory op (absoluut, genormaliseerd). * Get the translations for a plugin in the current context.
* *
* @since 2.6.5 * System plugins resolve against the admin language; content plugins
* against the current content language. The implementation handles the
* fallback to the plugin's default_language.
* *
* @return string Absoluut pad naar de project-root. * @param string $pluginName Plugin directory name
*/ * @param string|null $lang Override language (optional)
public function getProjectRoot(): string; * @return array Translations [key => value]
/**
* Haal het pad naar de contentdirectory op (absoluut, genormaliseerd).
*
* Bij een relatieve configuratiewaarde wordt deze afgezet tegen de project-root.
*
* @since 2.6.5
*
* @return string Absoluut pad naar de contentdirectory.
*/
public function getContentDir(): string;
/**
* Haal het pad naar de pluginsdirectory op (absoluut, genormaliseerd).
*
* @since 2.6.5
*
* @return string Absoluut pad naar de pluginsdirectory.
*/
public function getPluginsDir(): string;
/**
* Haal de versie-informatie uit version.php op als associatieve array.
*
* Bevat altijd minimaal de sleutel 'version'.
*
* @since 2.6.5
*
* @return array<string,mixed> Versie-informatie met minimaal de sleutel 'version'.
*/
public function getVersionInfo(): array;
/**
* Haal de vertalingen voor een plugin op in de huidige context.
*
* System-plugins resolven tegen de admin-taal; content-plugins tegen de
* huidige content-taal. De implementatie regelt de fallback naar de
* default_language van de plugin.
*
* @since 2.6.5
*
* @param string $pluginName Plugin-directorynaam.
* @param string|null $lang Optionele override-taal.
* @return array<string,string> Vertalingen als [key => value].
*/ */
public function getPluginTranslations(string $pluginName, ?string $lang = null): array; public function getPluginTranslations(string $pluginName, ?string $lang = null): array;
/** /**
* Vertaal een enkele sleutel voor een plugin in de huidige context. * Translate a single key for a plugin in the current context.
* *
* @since 2.6.5 * @param string $key Translation key
* * @param string $pluginName Plugin directory name
* @param string $key Vertaalsleutel. * @param string|null $lang Override language (optional)
* @param string $pluginName Plugin-directorynaam. * @return string Translated string, or $key if not found
* @param string|null $lang Optionele override-taal.
* @return string Vertaalde string, of $key indien niet gevonden.
*/ */
public function t(string $key, string $pluginName, ?string $lang = null): string; public function t(string $key, string $pluginName, ?string $lang = null): string;
} }
+36 -241
View File
@@ -1,82 +1,15 @@
<?php <?php
/**
* Beheert het laden en hooks-systeem van plugins.
*
* Laadt ingeschakelde plugins uit de pluginsdirectory, registreert automatisch
* action- en filter-hooks, en biedt methoden voor plugin-configuratie,
* vertalingen, admin-routes en sidebar-content.
*
* @since 2.6.5
*/
class PluginManager class PluginManager
{ {
/**
* Geladen plugin-instanties, geïndexeerd op plugin-naam.
*
* @since 2.6.5
* @var array<string,object>
*/
private array $plugins = []; private array $plugins = [];
/**
* Het absolute pad naar de pluginsdirectory.
*
* @since 2.6.5
* @var string
*/
private string $pluginsPath; private string $pluginsPath;
/**
* De geïnjecteerde plugin-API-instantie (CMSAPI of AdminPluginAPI).
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private $api = null; private $api = null;
/**
* Lijst met ingeschakelde plugin-namen.
*
* @since 2.6.5
* @var array<int,string>
*/
private array $enabledPlugins = []; private array $enabledPlugins = [];
/**
* Geregistreerde action-hooks, gegroepeerd per hook-naam en prioriteit.
*
* @since 2.6.5
* @var array<string,array<int,array<int,callable>>>
*/
private array $actions = []; private array $actions = [];
/**
* Geregistreerde filter-hooks, gegroepeerd per hook-naam en prioriteit.
*
* @since 2.6.5
* @var array<string,array<int,array<int,callable>>>
*/
private array $filters = []; private array $filters = [];
/**
* De standaardtaal van de site, gebruikt als fallback voor plugins
* zonder eigen default_language in plugin.json.
*
* @since 2.6.5
* @var string
*/
private string $siteDefaultLanguage = 'nl'; private string $siteDefaultLanguage = 'nl';
/**
* Construeer een PluginManager en laadt direct de ingeschakelde plugins.
*
* @since 2.6.5
*
* @param string $pluginsPath Absoluut pad naar de pluginsdirectory.
* @param array<int,string> $enabledPlugins Lijst met ingeschakelde plugin-namen.
* @param string $siteDefaultLanguage Standaardtaal van de site.
*/
public function __construct(string $pluginsPath, array $enabledPlugins = [], string $siteDefaultLanguage = 'nl') public function __construct(string $pluginsPath, array $enabledPlugins = [], string $siteDefaultLanguage = 'nl')
{ {
$this->pluginsPath = $pluginsPath; $this->pluginsPath = $pluginsPath;
@@ -86,31 +19,14 @@ class PluginManager
} }
/** /**
* Stel de standaardtaal van de site in. * Set the CMS site default language. Used as a fallback when a plugin
* * does not declare its own `default_language` in plugin.json.
* Wordt gebruikt als fallback wanneer een plugin geen eigen `default_language`
* declareert in plugin.json.
*
* @since 2.6.5
*
* @param string $lang Taalcode (bijv. 'nl', 'en').
* @return void
*/ */
public function setSiteDefaultLanguage(string $lang): void public function setSiteDefaultLanguage(string $lang): void
{ {
$this->siteDefaultLanguage = $lang !== '' ? $lang : 'nl'; $this->siteDefaultLanguage = $lang !== '' ? $lang : 'nl';
} }
/**
* Stel de plugin-API in en geef deze door aan alle geladen plugins.
*
* Plugins die een setAPI()-methode implementeren, ontvangen de API-instantie.
*
* @since 2.6.5
*
* @param PluginAPIInterface $api De plugin-API-instantie.
* @return void
*/
public function setAPI($api): void public function setAPI($api): void
{ {
$this->api = $api; $this->api = $api;
@@ -122,16 +38,6 @@ class PluginManager
} }
} }
/**
* Laad alle ingeschakelde plugins uit de pluginsdirectory.
*
* Per plugin wordt het hoofdbestand (<naam>.php) geïncludeerd, de plugin-class
* geïnstantieerd, en action- en filter-hooks automatisch geregistreerd.
*
* @since 2.6.5
*
* @return void
*/
private function loadPlugins(): void private function loadPlugins(): void
{ {
if (!is_dir($this->pluginsPath)) { if (!is_dir($this->pluginsPath)) {
@@ -176,45 +82,16 @@ class PluginManager
} }
} }
/**
* Registreer een action-callback voor een hook.
*
* @since 2.6.5
*
* @param string $hook Naam van de action-hook.
* @param callable $callback De callback die bij de hook wordt uitgevoerd.
* @param int $priority Uitvoer-volgorde; lager wordt eerder uitgevoerd.
* @return void
*/
public function addAction(string $hook, callable $callback, int $priority = 10): void public function addAction(string $hook, callable $callback, int $priority = 10): void
{ {
$this->actions[$hook][$priority][] = $callback; $this->actions[$hook][$priority][] = $callback;
} }
/**
* Registreer een filter-callback voor een hook.
*
* @since 2.6.5
*
* @param string $hook Naam van de filter-hook.
* @param callable $callback De callback die de waarde filtert.
* @param int $priority Uitvoer-volgorde; lager wordt eerder uitgevoerd.
* @return void
*/
public function addFilter(string $hook, callable $callback, int $priority = 10): void public function addFilter(string $hook, callable $callback, int $priority = 10): void
{ {
$this->filters[$hook][$priority][] = $callback; $this->filters[$hook][$priority][] = $callback;
} }
/**
* Voer alle geregistreerde callbacks voor een action-hook uit.
*
* @since 2.6.5
*
* @param string $hook Naam van de action-hook.
* @param mixed ...$args Argumenten die aan elke callback worden doorgegeven.
* @return void
*/
public function doAction(string $hook, ...$args): void public function doAction(string $hook, ...$args): void
{ {
if (!isset($this->actions[$hook])) return; if (!isset($this->actions[$hook])) return;
@@ -226,16 +103,6 @@ class PluginManager
} }
} }
/**
* Pas alle geregistreerde filter-callbacks toe op een waarde.
*
* @since 2.6.5
*
* @param string $hook Naam van de filter-hook.
* @param mixed $value De initiële waarde die wordt gefilterd.
* @param mixed ...$args Extra argumenten voor elke filter-callback.
* @return mixed De gefilterde waarde.
*/
public function applyFilters(string $hook, $value, ...$args) public function applyFilters(string $hook, $value, ...$args)
{ {
if (!isset($this->filters[$hook])) return $value; if (!isset($this->filters[$hook])) return $value;
@@ -248,66 +115,32 @@ class PluginManager
return $value; return $value;
} }
/**
* Haal een specifieke plugin-instantie op.
*
* @since 2.6.5
*
* @param string $name Plugin-naam (directorynaam).
* @return object|null De plugin-instantie of null indien niet geladen.
*/
public function getPlugin(string $name): ?object public function getPlugin(string $name): ?object
{ {
return $this->plugins[$name] ?? null; return $this->plugins[$name] ?? null;
} }
/**
* Haal alle geladen plugin-instanties op.
*
* @since 2.6.5
*
* @return array<string,object> Plugin-instanties geïndexeerd op naam.
*/
public function getAllPlugins(): array public function getAllPlugins(): array
{ {
return $this->plugins; return $this->plugins;
} }
/**
* Haal de lijst met ingeschakelde plugin-namen op.
*
* @since 2.6.5
*
* @return array<int,string> Lijst met ingeschakelde plugin-namen.
*/
public function getEnabledPlugins(): array public function getEnabledPlugins(): array
{ {
return $this->enabledPlugins; return $this->enabledPlugins;
} }
/**
* Controleer of een plugin is ingeschakeld.
*
* @since 2.6.5
*
* @param string $pluginName Plugin-naam (directorynaam).
* @return bool True indien de plugin is ingeschakeld.
*/
public function isEnabled(string $pluginName): bool public function isEnabled(string $pluginName): bool
{ {
return in_array($pluginName, $this->enabledPlugins, true); return in_array($pluginName, $this->enabledPlugins, true);
} }
/** /**
* Haal de runtime-configuratie van een plugin op. * Get the runtime config for a plugin: defaults from plugin.json `settings`
* merged with overrides from the plugin's config.json.
* *
* Standaardwaarden uit plugin.json `settings` worden samengevoegd met * @param string $pluginName Plugin name (directory name)
* overrides uit het config.json van de plugin. * @return array Resolved config: [key => value, ...]
*
* @since 2.6.5
*
* @param string $pluginName Plugin-naam (directorynaam).
* @return array<string,mixed> Opgeloste configuratie als [key => value].
*/ */
public function getPluginConfig(string $pluginName): array public function getPluginConfig(string $pluginName): array
{ {
@@ -334,17 +167,15 @@ class PluginManager
} }
/** /**
* Haal de standaard (fallback) taal van een plugin op. * Get the default (fallback) language declared by a plugin.
* *
* Resolved in volgorde van: * Resolved from (in order):
* 1. plugin.json `default_language` * 1. plugin.json `default_language`
* 2. CMS site-config `language.default` * 2. CMS site config `language.default`
* 3. 'nl' * 3. 'nl'
* *
* @since 2.6.5 * @param string $pluginName Plugin directory name
* * @return string Language code (e.g. 'nl', 'en')
* @param string $pluginName Plugin-directorynaam.
* @return string Taalcode (bijv. 'nl', 'en').
*/ */
public function getPluginDefaultLanguage(string $pluginName): string public function getPluginDefaultLanguage(string $pluginName): string
{ {
@@ -359,17 +190,15 @@ class PluginManager
} }
/** /**
* Laad de vertalingen voor een plugin voor de aangevraagde taal. * Load the translations for a plugin for the requested language.
* *
* Fallback-keten: aangevraagde taal -> standaardtaal van de plugin -> lege array. * Fallback chain: requested language -> plugin default language -> empty array.
* *
* @since 2.6.5 * @param string $pluginName Plugin directory name
* * @param string $lang Requested language code
* @param string $pluginName Plugin-directorynaam. * @param string $context Translation context: 'admin' or 'site' (front-end).
* @param string $lang Aangevraagde taalcode. * Defaults to 'admin' for system plugins, 'site' for content plugins.
* @param string $context Vertaalcontext: 'admin' of 'site' (front-end). * @return array Translations [key => value]
* Standaard 'admin' voor system-plugins, 'site' voor content-plugins.
* @return array<string,string> Vertalingen als [key => value].
*/ */
public function getPluginTranslations(string $pluginName, string $lang, string $context = 'admin'): array public function getPluginTranslations(string $pluginName, string $lang, string $context = 'admin'): array
{ {
@@ -403,16 +232,14 @@ class PluginManager
} }
/** /**
* Verzamel vertalingen voor alle geladen plugins voor de aangevraagde taal. * Collect translations for every loaded plugin for the requested language.
* *
* Geeft een associatieve array terug, geïndexeerd op plugin-naam: * Returns an associative array keyed by plugin name:
* ['Statistics' => [...], 'Logs' => [...], ...] * ['Statistics' => [...], 'Logs' => [...], ...]
* *
* @since 2.6.5 * @param string $lang Requested language code
* * @param string $context 'admin' or 'site'
* @param string $lang Aangevraagde taalcode. * @return array Plugin translations keyed by plugin name
* @param string $context 'admin' of 'site'.
* @return array<string,array<string,string>> Plugin-vertalingen geïndexeerd op plugin-naam.
*/ */
public function getAllPluginTranslations(string $lang, string $context = 'admin'): array public function getAllPluginTranslations(string $lang, string $context = 'admin'): array
{ {
@@ -425,16 +252,6 @@ class PluginManager
return $all; return $all;
} }
/**
* Controleer of een plugin viewable is.
*
* Een plugin is viewable tenzij zijn configuratie 'viewable' expliciet op false zet.
*
* @since 2.6.5
*
* @param object $plugin De plugin-instantie.
* @return bool True indien de plugin viewable is.
*/
public function isPluginViewable(object $plugin): bool public function isPluginViewable(object $plugin): bool
{ {
if (method_exists($plugin, 'getConfig')) { if (method_exists($plugin, 'getConfig')) {
@@ -444,17 +261,6 @@ class PluginManager
return true; return true;
} }
/**
* Haal de samengevoegde sidebar-content van alle viewable plugins op.
*
* Elke plugin met een getSidebarContent()-methode levert HTML die wordt
* ingepakt in een Bootstrap-card met de plugin-titel.
*
* @since 2.6.5
*
* @param array<int,string>|null $allowedPlugins Optionele whitelist van plugin-namen.
* @return string De samengevoegde sidebar-HTML.
*/
public function getSidebarContent(?array $allowedPlugins = null): string public function getSidebarContent(?array $allowedPlugins = null): string
{ {
$sidebarContent = ''; $sidebarContent = '';
@@ -494,11 +300,9 @@ class PluginManager
} }
/** /**
* Haal CSS-URL's op van alle ingeschakelde plugins die getCssUrl() implementeren. * Get CSS URLs from all enabled plugins that provide getCssUrl().
* *
* @since 2.6.5 * @return array List of CSS URLs
*
* @return array<int,string> Lijst met CSS-URL's.
*/ */
public function getPluginCssUrls(): array public function getPluginCssUrls(): array
{ {
@@ -515,13 +319,10 @@ class PluginManager
} }
/** /**
* Verzamel admin-menu-items van alle plugins die getAdminMenu() implementeren. * Collect admin menu items from all enabled plugins that implement getAdminMenu().
* Each plugin returns [['route' => 'plugin-name/action', 'label' => 'Label', 'icon' => 'bi-icon']].
* *
* Elke plugin levert [['route' => 'plugin-name/action', 'label' => 'Label', 'icon' => 'bi-icon']]. * @return array Admin menu items from all plugins
*
* @since 2.6.5
*
* @return array<int,array<string,mixed>> Admin-menu-items van alle plugins.
*/ */
public function getAdminMenuItems(): array public function getAdminMenuItems(): array
{ {
@@ -540,16 +341,12 @@ class PluginManager
} }
/** /**
* Dispatch een admin-route naar de plugin die deze afhandelt. * Dispatch an admin route to a plugin that handles it.
* Plugins implement handleAdminRoute(string $action): ?string (returns rendered HTML or null).
* *
* Plugins implementeren handleAdminRoute(string $action): ?string * @param string $pluginName Plugin name
* (geeft gerenderde HTML of null terug). * @param string $action Action/sub-route within the plugin
* * @return string|null Rendered HTML, or null if plugin doesn't handle it
* @since 2.6.5
*
* @param string $pluginName Plugin-naam.
* @param string $action Actie/sub-route binnen de plugin.
* @return string|null Gerenderde HTML, of null indien de plugin deze niet afhandelt.
*/ */
public function dispatchAdminRoute(string $pluginName, string $action): ?string public function dispatchAdminRoute(string $pluginName, string $action): ?string
{ {
@@ -564,12 +361,10 @@ class PluginManager
} }
/** /**
* Bepaal welke plugin een opgegeven admin-route afhandelt. * Find which plugin handles a given admin route.
* *
* @since 2.6.5 * @param string $route The admin route (e.g. 'statistics' or 'statistics/details')
* * @return array|null ['plugin' => name, 'action' => action, 'permission' => required permission] or null
* @param string $route De admin-route (bijv. 'statistics' of 'statistics/details').
* @return array<string,mixed>|null ['plugin' => naam, 'action' => actie, 'permission' => vereiste permissie] of null.
*/ */
public function resolveAdminRoute(string $route): ?array public function resolveAdminRoute(string $route): ?array
{ {
-50
View File
@@ -1,15 +1,4 @@
<?php <?php
/**
* Router voor de PHP development-server: clean-URL support en statische bestanden.
*
* Wordt gebruikt via `php -S localhost:8080 cms/router.php`. Houdt de request-
* URI tegen de public/-map voor statische bestanden, serveert theme-, admin-
* theme- en plugin-assets buiten public/, en routeert /admin en taal-geprefixte
* paden (/nl, /en) door naar admin.php respectievelijk index.php.
*
* @since 2.6.5
* @package CodePress
*/
// Router file for PHP development server - clean URL support + static file serving // Router file for PHP development server - clean URL support + static file serving
$requestUri = $_SERVER['REQUEST_URI']; $requestUri = $_SERVER['REQUEST_URI'];
@@ -30,11 +19,6 @@ $mimeTypes = [
'json' => 'application/json', 'json' => 'application/json',
]; ];
/**
* Statische bestanden uit public/ serveren met juiste MIME-type.
*
* @since 2.6.5
*/
// Serve static files from public/ // Serve static files from public/
$filePath = $publicDir . $path; $filePath = $publicDir . $path;
if (is_file($filePath)) { if (is_file($filePath)) {
@@ -46,13 +30,6 @@ if (is_file($filePath)) {
return true; return true;
} }
/**
* Theme-assets uit themes/<naam>/ serveren (bijv. /themes/default/js/theme.js).
*
* Path-traversal wordt afgedwongen via realpath() + prefix-controle.
*
* @since 2.6.5
*/
// Serve theme assets from the themes/ directory (e.g. /themes/default/js/theme.js) // Serve theme assets from the themes/ directory (e.g. /themes/default/js/theme.js)
if (preg_match('#^/themes/([^/]+)/(.+)$#', $path, $m)) { if (preg_match('#^/themes/([^/]+)/(.+)$#', $path, $m)) {
$themeName = $m[1]; $themeName = $m[1];
@@ -73,13 +50,6 @@ if (preg_match('#^/themes/([^/]+)/(.+)$#', $path, $m)) {
return true; return true;
} }
/**
* Admin-theme-assets serveren (bijv. /admin/assets/css/bootstrap.min.js).
*
* Bronmap: admin/theme/default/assets/.
*
* @since 2.6.5
*/
// Serve admin theme assets (e.g. /admin/assets/css/bootstrap.min.js) // Serve admin theme assets (e.g. /admin/assets/css/bootstrap.min.js)
// Served from admin/theme/default/assets/ // Served from admin/theme/default/assets/
if (preg_match('#^/admin/assets/(.+)$#', $path, $m)) { if (preg_match('#^/admin/assets/(.+)$#', $path, $m)) {
@@ -100,11 +70,6 @@ if (preg_match('#^/admin/assets/(.+)$#', $path, $m)) {
return true; return true;
} }
/**
* Plugin-assets serveren (bijv. /plugins/Navigation/assets/css/navigation.css).
*
* @since 2.6.5
*/
// Serve plugin assets (e.g. /plugins/Navigation/assets/css/navigation.css) // Serve plugin assets (e.g. /plugins/Navigation/assets/css/navigation.css)
if (preg_match('#^/plugins/([^/]+)/assets/(.+)$#', $path, $m)) { if (preg_match('#^/plugins/([^/]+)/assets/(.+)$#', $path, $m)) {
$pluginName = $m[1]; $pluginName = $m[1];
@@ -125,13 +90,6 @@ if (preg_match('#^/plugins/([^/]+)/assets/(.+)$#', $path, $m)) {
return true; return true;
} }
/**
* Admin-routes doorsturen: /admin/<route> → admin.php?route=<route>.
*
* Default route is 'dashboard' indien geen subpad opgegeven.
*
* @since 2.6.5
*/
// Admin routes: /admin/login → admin.php?route=login // Admin routes: /admin/login → admin.php?route=login
if (preg_match('#^/admin(?:/(.+))?$#', $path, $m)) { if (preg_match('#^/admin(?:/(.+))?$#', $path, $m)) {
$_GET['route'] = $m[1] ?? 'dashboard'; $_GET['route'] = $m[1] ?? 'dashboard';
@@ -139,14 +97,6 @@ if (preg_match('#^/admin(?:/(.+))?$#', $path, $m)) {
return true; return true;
} }
/**
* Taal-geprefixte routes: /nl/<page> of /en/<page> → index.php?lang=...&page=...
*
* /nl/guide activeert de guide-flag met bestaande ?page=. Default valt
* door naar index.php.
*
* @since 2.6.5
*/
// Language-prefixed routes: /nl/page/path → index.php?lang=nl&page=page/path // Language-prefixed routes: /nl/page/path → index.php?lang=nl&page=page/path
if (preg_match('#^/(nl|en)(?:/(.+))?$#', $path, $m)) { if (preg_match('#^/(nl|en)(?:/(.+))?$#', $path, $m)) {
$_GET['lang'] = $m[1]; $_GET['lang'] = $m[1];
-182
View File
@@ -1,182 +0,0 @@
# CodePress CMS v2.6.2 — Release Notes
**Release datum:** 2026-08-19
**Codename:** Lyra
**Status:** stable
---
## Samenvatting
Deze release brengt de **thema-editor** en de **content-editor** op hetzelfde niveau als de plugin-editor. Thema's en content zijn nu volledig bewerkbaar in de admin met een bestandsbrowser zijbalk, uploaden/verwijderen/verplaatsen, en SCSS-compile (thema's) of git/backup-integratie (content). Daarnaast is de bestandsscanner geünificeerd tot één herbruikbare `scanEditorFiles()` functie.
Beide grote features zijn geïmplementeerd als spiegel van de plugin-editor (`/admin/plugins-edit`), zodat de editor-ervaring consistent is voor plugins, thema's en content.
---
## Nieuwe features
### 1. Thema editor (thema's net zo bewerkbaar maken als plugins)
De thema-beheer pagina toonde alleen thema-kaarten met activeren/compileer knoppen. Nu is elk thema volledig bewerkbaar via `/admin/theme-edit`.
#### Bestandsbrowser zijbalk
- Geneste, inklapbare boomstructuur van alle bestanden in de thema-map (`.twig`, `.json`, `.scss`, `.css`, `.js`, `.html`, `.md`, `.php`) inclusief `partials/` en `assets/` submappen
- `assets/css_compiled/` (runtime artefact, read-only) wordt verborgen in de boom
- `scanThemeFiles()` helper — recursieve boom-opbouw met path-traversal bescherming; skipt `css_compiled/`
- Mappen die het actieve bestand bevatten worden automatisch uitgeklapt
- Iconen per bestandstype (TWIG, PHP, JSON, MD, CSS, JS, HTML, mappen)
#### Nieuw bestand aanmaken
- "Nieuw bestand" knop + modal met pad-invoer (bijv. `partials/header.twig` of `assets/scss/_variables.scss`)
- Submappen worden automatisch aangemaakt
- Stub-content per extensie (`{% extends 'base.twig' %}` voor TWIG, `{\n}\n` voor JSON, enz.)
- Path-traversal bescherming: `../`/`..\\`/`./` stripping + `..`/`.` segment-guard + realpath prefix-check
#### Uploaden / Verwijderen / Verplaatsen
- Upload-knop + inklapbaar upload-formulier dat bestanden opslaat in `themes/<naam>/assets/`
- Toegestane extensies: afbeeldingen, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, fonts
- Per-bestand prullenbak-icoon en verplaats-icoon in de bestandsboom
- `theme.json` is beschermd: kan bewerkt maar niet verwijderd of verplaatst worden
#### SCSS compileren vanuit de editor
- "SCSS compileren" knop bovenaan de editor (alleen als `assets/scss/theme.scss` bestaat)
- Toont compile-status: **up-to-date** (groen) of **verouderd** (geel)
- Forceert compilatie via `ThemeManager::compileCss(true)`
#### Thema overzicht + activeren + verwijderen
- `theme.twig` vernieuwd: bewerken/activeer/verwijder/compileer knoppen per thema-kaart
- SCSS-status badges per thema (up-to-date / verouderd)
- **Activeren**: zet `active_theme` in `config.json` (nieuwe route `theme-activate`)
- **Verwijderen**: alleen niet-actieve, niet-default thema's (nieuwe route `theme-delete`); default thema beschermd
- **Nieuw thema met basis-kopie**: kies een bestaand thema als basis bij aanmaken; `css_compiled/` wordt niet gekopieerd; de `title` in `theme.json` wordt overschreven met de nieuwe themanaam; `README.md` krijgt een nieuwe header
#### Uniforme thema-structuur
Nieuwe thema's die via de admin worden aangemaakt krijgen automatisch een uniforme structuur:
- `theme.json`, `base.twig`, `full_content.twig`, `partials/header.twig`, `partials/footer.twig`
- `assets/scss/theme.scss` (starter SCSS), `assets/css/`, `assets/js/`, `assets/img/`, `assets/fonts/`
- `README.md` per thema
#### Media invoegen in editor
- De media-modal ondersteunt nu ook thema-context: `/admin/media-list?theme=<naam>` scant `themes/<naam>/assets/`
- `_media-modal.twig` JS uitgebreid met `mediaThemeName` scope
### 2. Content editor (content consistent met plugins en thema's)
De content-beheer pagina (`/admin/content`) was een klassieke tabelweergave. Nu is er een额外的 content-editor `/admin/content-files` met dezelfde bestandsbrowser-zijbalk-ervaring als de plugin- en thema-editors. Beide weergaven werken naast elkaar en gebruiken dezelfde content-map.
#### Bestandsbrowser zijbalk
- Geneste, inklapbare boomstructuur van alle bestanden in `content/`
- `scanContentFiles()` helper — recursieve boom-opbouw met path-traversal bescherming; skipt `.bak/`, `.git/`, dotfiles
- Bewerkbare extensies: `.md`, `.php`, `.html` (consistent met bestaande `content-edit`)
- Per-map actie-knoppen: nieuw bestand, nieuwe map, hernoemen, verwijderen
#### Nieuw bestand / map aanmaken
- "Nieuw bestand" knop + modal met pad-invoer en extensie-keuze (Markdown/PHP/HTML)
- `in_dir` prefix ondersteuning: bestand kan direct in een submap worden aangemaakt vanuit de zijbalk
- Frontmatter met `layout`, `author_name`, `author_email`, `created` wordt automatisch gegenereerd
- "Nieuwe map" knop + modal; submappen worden automatisch aangemaakt
#### Uploaden / Verwijderen / Verplaatsen
- Upload-knop + inklapbaar upload-formulier dat bestanden opslaat in `content/` (of een submap)
- Toegestane extensies: afbeeldingen, video, audio, PDF, ZIP, office docs, CSS, SCSS, JS, JSON, HTML, MD
- Per-bestand prullenbak-icoon en verplaats-icoon in de bestandsboom
- Nieuwe routes: `content-file-upload`, `content-file-delete`, `content-file-move`
#### Mappen beheer
- **Nieuwe map** (`content-dir-create-in`): per map in de zijbalk of bovenaan
- **Map hernoemen** (`content-dir-rename-in`): potlood-icoon per map
- **Map verwijderen** (`content-dir-delete-in`): prullenbak-icoon per map (alleen lege mappen; verborgen `.bak` bestanden genegeerd)
#### Layout selectie + plugins + frontmatter
- Layout dropdown uit `theme.json` template mapping (zoals bestaande `content-edit`)
- Plugin checkbox-groep voor `plugins:` frontmatter key
- Author metadata, `created` datum in frontmatter
- Live frontmatter-update bij layout/plugin wijziging (spiegel van `content-edit.twig` JS)
#### Git / Backup integratie (Fase 5)
Bovenaan de content-editor staan backup- en git-acties:
- **Git init**: initialiseert een git repository in `content/` (als er nog geen is)
- **Commit**: committed alle niet-committed wijzigingen (alleen als er een git repo is en er wijzigingen zijn)
- **Backup**: link naar de backup-pagina (`/admin/content-backup`) voor ZIP backup/restore
- Git status badge toont de huidige branch, of er niet-committed wijzigingen zijn (dirty/clean), en de laatste commit
### 3. Uniformiteit: één scanEditorFiles() voor alle editors
De drie nagenoeg identieke scan-functies (`scanPluginFiles`, `scanThemeFiles`, `scanContentFiles`) zijn geünificeerd tot één herbruikbare functie:
- `scanEditorFiles(string $dir, string $scope = 'plugin'): array` — hoofd-functie
- `scanEditorFilesNode(string $absDir, string $relPath, string $realBase, array $skipPaths = []): array` — recursieve helper
- Scope-specifieke skips via `$skipPaths` map (bijv. `['assets/css_compiled' => true]` voor themes)
- `scanPluginFiles`/`scanThemeFiles`/`scanContentFiles` behouden als dunne wrappers voor backwards-compatibiliteit
De file-upload/delete/move handler-families zijn per-scope behouden (plugin: protected-plugins check; theme: theme.json-bescherming; content: geen specifieke bescherming) — generalisatie zou een complexe configuratie-laag vereisen die de leesbaarheid niet verbetert.
---
## Bug fixes
- **Thema-naam niet overgenomen bij kopiëren** — bij het aanmaken van een nieuw thema met een basisthema werd de `title` uit het basisthema's `theme.json` gekopieerd; nu wordt de `title` overschreven met de nieuwe themanaam en krijgt `README.md` een nieuwe header
- **Mappen met `_` prefix zichtbaar in frontend navigatie** — mappen zoals `_drafts`, `_data`, `_images` werden in het menu getoond omdat `scanDirectory()` alleen `.` en `-` prefixen oversloeg. Nu worden ook `_`-prefix mappen overgeslagen in `scanDirectory()`, `searchInDirectory()` en `scanForPageTitles()` (consistente filtering)
- **Images in markdown niet weergegeven** — `![alt](test.svg)` werd gerenderd als `<img src="test.svg">` (relatieve URL → 404) of `![alt](/content/test.svg)` als `<img src="/content/test.svg">` (content/ staat buiten webroot → 404). `processContent()` herschrijft nu lokale image/link URLs naar de `/-media/` endpoint die bestanden uit `content/` serveert met juiste MIME-type. Externe URLs (`http(s)://`), `/-media/`, `/-assets/`, `/themes/`, `/plugins/`, `/admin/`, `data:` en `mailto:` worden ongewijzigd gelaten. Ook de custom-grootte syntax `![alt](url){:width=... height=...}` wordt correct herschreven.
## UX verbeteringen
- **`/admin/content` is nu de boom-editor** — de hoofdroute `/admin/content` toont nu de bestandsbrowser zijbalk structuur (zoals `plugin-file-tree`), consistent met de plugin- en thema-editors. De oude tabelweergave is verhuisd naar `/admin/content-list` en is bereikbaar via de "Lijst weergave" knop. Een "Boom weergave" knop in de tabelweergave keert terug naar de boom-editor. De `content-files` route redirect naar `/admin/content` (backward compat).
- **Image-grootte knop in editor-toolbar** — nieuwe knop "Afbeelding grootte" (expand-icoon) in de markdown editor-toolbar. Selecteer een `![alt](url)` image in de editor en klik op de knop om een breedte/hoogte-dialog te krijgen. De `{:width=... height=...}` syntax wordt aan de image toegevoegd of vervangen. Bestaande waarden worden getoond in de prompts.
---
## Technische details
### Nieuwe routes
- `theme-edit` — thema bestandsbrowser editor
- `theme-file-upload` — bestanden uploaden naar thema assets/
- `theme-file-delete` — bestand verwijderen uit thema (theme.json beschermd)
- `theme-file-move` — bestand verplaatsen binnen thema (theme.json beschermd)
- `theme-activate` — thema activeren (active_theme in config.json)
- `theme-delete` — thema verwijderen (alleen niet-actief, niet-default)
- `theme-scss` — SCSS compileren voor thema
- `content-files` — content bestandsbrowser editor
- `content-file-upload` — bestanden uploaden naar content/
- `content-file-delete` — bestand verwijderen uit content
- `content-file-move` — bestand verplaatsen binnen content
- `content-dir-create-in` — map aanmaken in content vanuit editor
- `content-dir-rename-in` — map hernoemen in content vanuit editor
- `content-dir-delete-in` — map verwijderen in content vanuit editor (alleen leeg)
### Nieuwe bestanden
- `admin/theme/default/views/pages/theme-edit.twig` — thema editor met bestandsbrowser
- `admin/theme/default/views/pages/theme-move-form.twig` — thema bestand verplaatsen
- `admin/theme/default/views/pages/content-files.twig` — content editor met bestandsbrowser
- `admin/theme/default/views/pages/content-move-form.twig` — content bestand verplaatsen
- `admin/theme/default/views/pages/content-dir-rename-form.twig` — content map hernoemen
- `docs/release-notes/v2.6.2.md` — dit release-verslag
### Gewijzigde bestanden (core)
- `public/admin.php` — nieuwe routes + handlers (handleThemeEdit/FileUpload/Delete/Move/Activate/Delete/Scss, handleContentFiles/FileUpload/Delete/Move/DirCreateIn/DirRenameIn/DirDeleteIn, createUniformThemeStructure, copyDirRecursive, removeDirRecursive, scanEditorFiles + scanEditorFilesNode unified), handleTheme/handleThemeNew herschreven, handleMediaList uitgebreid met `?theme=` scope
- `admin/src/AdminAuth.php` — site-admin rechten voor nieuwe theme routes; content-manager rechten voor nieuwe content routes
- `admin/theme/default/views/pages/theme.twig` — bewerk/activeer/verwijder/compileer knoppen + SCSS-status badges
- `admin/theme/default/views/pages/theme-new.twig` — base-theme keuze dropdown
- `admin/theme/default/views/pages/_media-modal.twig``?theme=` scope support
- `admin/theme/default/assets/js/editor-toolbar.js``twig``htmlmixed` mode toegevoegd
- `cms/core/class/CodePressCMS.php``scanDirectory`/`searchInDirectory`/`scanForPageTitles` skippen nu `_` prefix; `processContent()` herschrijft lokale image/link URLs naar `/-media/`
- `language/{nl,en,de}/admin.php` — ~45 nieuwe vertaalstrings (theme-editor + content-editor)
- `guide/{nl,en}/admin-beheerder/thema-beheer.md` — volledig herschreven met thema-editor uitleg
- `guide/{nl,en}/admin-beheerder/content-beheer.md` — volledig herschreven met content-editor uitleg
- `TODO.md` — thema-editor en content-editor items aangevinkt
---
## Tests
- **Pentest**: 30/30 tests geslaagd — 0 vulnerabilities
- **WCAG 2.1 AA accessibility**: 25/25 tests geslaagd — 100% compliance
- **PHP lint**: alle bestanden schoon (geen syntax errors)
- **curl tests**: alle nieuwe routes getest (aanmaken, bewerken, opslaan, uploaden, verwijderen, verplaatsen, map aanmaken/hernoemen/verwijderen, SCSS compileren, thema activeren/verwijderen, thema kopiëren); path-traversal pogingen (delete/new_file/upload) allemaal geblokkeerd; default/active theme bescherming geverifieerd; theme.json verwijderen/plaatsen geblokkeerd; image-URL rewriting geverifieerd (relatief, /content/, subdir, extern ongewijzigd); `_`-map niet in frontend navigatie
---
## Bestanden gewijzigd sinds v2.6.1d
15 bestanden gewijzigd (core + admin theme + language + guide), ~2200 insertions, ~200 deletions.
-160
View File
@@ -1,160 +0,0 @@
# 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**:
```php
[
['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).
-190
View File
@@ -1,190 +0,0 @@
# CodePress CMS v2.6.5 — Release Notes
**Release datum:** 2026-08-27
**Codename:** Lyra
**Status:** stable
---
## Samenvatting
Deze release richt zich op **dynamische pad-resolutie**, **volledige
code-documentatie** en een **belangrijke security-fix** rond het standaard
admin-wachtwoord. Daarnaast is de git-geschiedenis schoongemaakt van
kraakbare wachtwoord-hashes die per ongeluk gecommit waren.
---
## Nieuwe features & wijzigingen
### 1. Dynamische pad-resolutie via de Plugin-API
Eerder gaf `AdminPluginAPI::getContentDir()` een relatief pad ("content")
terug zonder dat te normaliseren tegen de project-root. Omdat Apache
`admin.php` uit de `public/` map draait, resolvedde dat relatieve pad naar
`public/content` (niet-bestaand) → het dashboard toonde 0 pagina's, 0
mappen en 0 B aan content.
Nu:
- `PluginAPIInterface` definieert universele pad-methodes
(`getProjectRoot()`, `getContentDir()`, `getPluginsDir()`,
`getVersionInfo()`) die door zowel `CMSAPI` (frontend) als
`AdminPluginAPI` (admin) worden geïmplementeerd.
- `AdminPluginAPI::getContentDir()` normaliseert relatieve paden tegen de
project-root (met Windows-drive-letter detectie), conform
`cms/core/config.php`.
- `CMSAPI` heeft deze methodes erbij gekregen (deze ontbraken op de
frontend-API).
- `public/index.php` media-/assets-serving gebruikt
`$config['content_dir']` i.p.v. een hardcoded `/content` pad, zodat een
aangepaste `content_dir` in `config.json` wordt gevolgd.
- De `Navigation` plugin haalt de content-root via
`$this->api->getContentDir()` i.p.v. hardcoded `dirname(__DIR__, 2)`;
de guide-root via `getProjectRoot()`.
- De `Logs` plugin haalt de log-dir via `$this->api->getProjectRoot()`
i.p.v. hardcoded `dirname(__DIR__, 2)`.
### 2. WordPress-stijl code-documentatie
Alle classes, methods, properties en functies in de codebase zijn
voorzien van volledige docblocks in WordPress-stijl (~450 docblocks):
```
/**
* Summary.
*
* Description.
*
* @since 2.6.5
*
* @param type $var Description.
* @param array $args {
* Optional. An array of arguments.
*
* @type type $key Description. Default 'value'. Accepts 'value', 'value'.
* @type type $key Description.
* }
* @param type $var Description.
* @return type Description.
*/
```
Behandelde bestanden: `AdminAuth`, `Cache`, `RateLimiter`, `RequestLogger`,
`Analytics`, `BotGuard`, `ContentBackup`, `GeoIP`, `Logger`, `LogManager`,
`ThemeManager`, `CodePressCMS`, `PluginAPIInterface`, `CMSAPI`,
`AdminPluginAPI`, `PluginManager`, alle 6 plugins, `public/admin.php`
(82 functies), en de entrypoints/CLI-bestanden.
---
## Security fixes
### 3. Hardcoded plaintext-wachtwoord verwijderd
In `admin/src/AdminAuth.php` stond het standaard-wachtwoord letterlijk in
de broncode:
```php
'password_hash' => password_hash('admin', PASSWORD_BCRYPT),
```
Deze fallback draaide bij een nieuwe installatie wanneer zowel
`admin.json` als `admin.json.example` ontbraken. Het wachtwoord `'admin'`
was hierdoor in de gecommitte broncode zichtbaar.
Nu:
- Bij eerste installatie wordt een **cryptografisch veilig willekeurig
wachtwoord** gegenereerd (`random_bytes`, 16 alfanumerieke tekens).
- De bcrypt-hash wordt weggeschreven naar `admin/config/admin.json`.
- Het plaintext wachtwoord wordt **eenmalig** op het inlogscherm getoond
via een waarschuwing, zodat de beheerder het kan noteren.
- Na de eerste succesvolle login is het wachtwoord nergens meer in
plaintext opgeslagen.
Nieuwe methodes in `AdminAuth`:
- `generateRandomPassword(int $length = 16): string` — CSPRNG-gebaseerd.
- `getGeneratedPassword(): string` — geeft het gegenereerde wachtwoord
terug voor weergave op de login-pagina.
### 4. Git-geschiedenis schoongemaakt
Bij eerdere commits (`d97c67c`, `b8d4a4e`, `5884877`) was
`admin/config/admin.json` per ongeluk gecommit voordat het bestand
gitignored werd. Dit bestand bevatte een bcrypt-hash die kraakt naar het
wachtwoord `'admin'`. Ook `admin/config/admin.json.example` (gecommit)
en het oude `admin-console/config/admin.json` pad bevatten dergelijke
hashes.
Uitgevoerd:
- `git filter-branch` om `admin/config/admin.json`,
`admin/config/admin.json.example` en `admin-console/config/admin.json`
te verwijderen uit **alle commits** op alle branches en tags.
- `reflog expire --expire=now --all` + `gc --prune=now --aggressive` om
oude objecten te verwijderen.
- Verificatie: beide bekende hashes (`nUpoaCNZZ...`, `CV2uORTI...`) en
`password_hash('admin'` komen 0× voor in de hele object-database.
### 5. admin.json.example verwijderd
Het gecommitte `admin/config/admin.json.example` bevatte een geldige
bcrypt-hash (kraakt naar `'admin'`). Omdat de `AdminAuth`-fallback nu
zelf een veilig wachtwoord genereert, is het example-bestand overbodig
geworden en verwijderd uit de repo.
---
## Bijgewerkte documentatie
- `README.md` en `README.en.md`: installatie-stappen herschreven (geen
`admin.json.example` kopie-stap meer; verwijzing naar
`admin`/`admin` inlog verwijderd; uitleg over automatisch gegenereerd
wachtwoord bij eerste installatie).
- `AGENTS.md`: admin-inlog beschrijving bijgewerkt.
- `TODO.md`: v2.6.5 entry toegevoegd.
---
## Onder de motorkap
| Bestand | Wijziging |
|---|---|
| `cms/core/plugin/PluginAPIInterface.php` | Universele pad-methodes toegevoegd |
| `cms/core/plugin/CMSAPI.php` | `getProjectRoot`/`getContentDir`/`getPluginsDir`/`getVersionInfo` toegevoegd |
| `cms/core/plugin/AdminPluginAPI.php` | `getContentDir` normaliseert relatieve paden |
| `public/index.php` | Media-serving via `$config['content_dir']` |
| `plugins/Navigation/Navigation.php` | Content/guide-root via de API |
| `plugins/Logs/Logs.php` | Log-dir via de API |
| `admin/src/AdminAuth.php` | Random-wachtwoord-generator + `getGeneratedPassword` |
| `admin/theme/default/views/login.twig` | Waarschuwing bij eerste installatie |
| `version.php` | 2.6.4 → 2.6.5 |
| `README.md`, `README.en.md`, `AGENTS.md`, `TODO.md` | Docs bijgewerkt |
| ~20 PHP-bestanden | WordPress-stijl docblocks toegevoegd |
---
## Tests uitgevoerd
- `php -l` over alle 67 PHP-bestanden (zonder vendor): 0 syntax-errors.
- Apache smoke-test: login (nieuw wachtwoord), dashboard (4 pagina's /
2 mappen / 282 KB), content, users, plugins, logs, guide, homepage,
pagina en media-serving allen HTTP 200.
- Inloggen met oud wachtwoord `admin` werkt niet meer.
- Eerste-installatie flow getest: bij afwezigheid van `admin.json` wordt
een nieuw wachtwoord gegenereerd en op het inlogscherm getoond.
- Git-historie: beide oude hashes en `password_hash('admin'` 0×
aanwezig in `git log --all -p`.
---
## Upgrade-instructies
1. Pull de nieuwe versie.
2. Als je nog met het standaard-wachtwoord `admin` inlogt: wijzig het
direct na upgrade via de admin-interface of
`php cli/reset-admin-password.php admin <nieuw-wachtwoord>`.
3. optioneel: verwijder `admin/config/admin.json.example` uit je working
tree (is niet meer nodig).
+23 -116
View File
@@ -1,125 +1,32 @@
# Content management # Content management
CodePress uses a **tree view** (`/admin/content`) for content management: a file browser sidebar + CodeMirror editor, uniform with the plugin and theme editors. The old list/table view has been removed. ## Managing files
## Content editor - **New folder** — Create folder structure
- **New file** — Create a page (`.md`, `.php`, `.html`)
- **Edit** — Modify existing content in the CodeMirror editor
- **Rename** — Change file or folder names
- **Move** — Move content to another folder
- **Delete** — Remove content
- **Rename folder** — Change a folder name
### File browser sidebar ## Editor (content-edit)
- Shows the nested file tree of `content/`, with a clickable **content** root at the top
- Hidden directories (`.bak`, `.git`) and dotfiles are skipped
- Click a **file** to open it in the CodeMirror editor
- Click a **folder** (the folder name) to select it — the **folder detail pane** appears on the right
- The chevron (▶/▼) next to a folder expands/collapses it without selecting the folder
- Folders containing the active file are auto-expanded
- Per folder there are action buttons: new file (plus icon), new folder (folder-plus icon) — they operate on the selected folder
- Per file there are action buttons: rename/move (pencil), delete (trash) — appear on hover
### Drag-and-drop - **CodeMirror** with syntax highlighting (Markdown, PHP, HTML)
- Drag a file or folder onto another folder to move it - **Toolbar** for quickly inserting Markdown
- Valid drop targets are highlighted during dragging - **Shortcuts**: Ctrl+S (save), Ctrl+N (new)
- The move is performed via an AJAX call — the page reloads automatically on success
- Security: a folder cannot be dropped into itself or a subfolder
- Path-traversal protection: all paths stay within the content directory
### Editable file types ## Layout selection
`.md` (Markdown), `.php` (PHP), `.html` (HTML) — consistent with the existing content-edit page.
All types support `---` frontmatter (layout, created, edited, plugins). The CMS `parseMetadata()` extracts frontmatter before processing. For PHP files, frontmatter is stripped from the output. On the content-edit page you can choose the layout from the layouts defined in `theme.json` (template mapping). The selected layout is stored in the frontmatter `layout:` key.
#### PHP content files ## Plugins on pages
PHP files can deliver content in two ways:
1. **Echo** (output buffering): everything `echo`ed or outside `<?php` tags is used as content
2. **Return** (callback style): `return '<h1>Hello</h1>';` — the returned string is used as content
In PHP files, the `ContentAPI` is available via `$api`: - Content plugins (from `plugin.json` with `type: "content"`) appear in the plugin selection
```php - Choose which plugins appear in the sidebar
<?php - **Order is adjustable** with up/down buttons
$menu = $api->getMenu(); - The plugin order is stored in the frontmatter `plugins:` key
$pages = $api->getAllPages(); - Plugins are **hidden** when the chosen layout has no sidebar (e.g. `full_content`)
$config = $api->getConfig('site_title');
return '<h1>' . htmlspecialchars($config) . '</h1>';
```
#### Frontend URLs and file names
The CMS searches files in order: `.md``.php``.html`. If files share the same name (e.g. `test.md` and `test.php`), `/nl/test` always opens `test.md`. To open a specific file type, add the extension to the URL:
- `/nl/test` → opens `test.md` (or `.php` / `.html` if `.md` doesn't exist)
- `/nl/test.php` → opens `test.php` (explicit extension)
- `/nl/test.html` → opens `test.html` (explicit extension)
The preview link in the editor automatically uses the extension for non-`.md` files.
### Set image size (Markdown)
The markdown editor toolbar has an "Image size" button (expand icon):
1. Select an image in the editor in markdown format `![alt](url)`
2. Click the "Image size" button
3. Enter width and/or height (px or %, empty = don't set)
4. The `{:width=... height=...}` syntax is added to or replaced on the image
Example:
```markdown
![logo](/content/_images/logo.png){:width="200" height="100"}
```
Existing `{:width=...}` values are shown in the prompts. The size attributes are rendered as `width`/`height` HTML attributes on the `<img>` tag in the frontend.
### Images in content
Images in `content/` are served via the `/-media/` endpoint (content/ lives outside the webroot). Markdown syntax `![alt](url)` with local URLs (relative like `image.jpg`, or absolute like `/content/_images/image.jpg`) is automatically rewritten to `/-media/...`. External URLs (`https://...`) are left untouched.
### Create a new file
- Select the target folder in the sidebar (click the folder name), or use the root
- Click **New file** (in the folder-detail pane or at the top)
- Enter a path within content (e.g. `en.page` or `blog/en.post`)
- Choose the file type (Markdown/PHP/HTML)
- Subfolders are created automatically
- Frontmatter with `layout`, `created`, `edited` is auto-generated
- The new file is created in the selected folder
### Upload a file
- Select the target folder in the sidebar (click the folder name), or use the root
- Click **Upload** (in the folder-detail pane or at the top) to upload files to the selected folder
- Allowed: images, video, audio, PDF, ZIP, office docs, CSS, SCSS, JS, JSON, HTML, MD
- Path-traversal protection: target dir must stay within `content/`
- After the upload you return to the selected folder
### Rename / delete a file
- Open the file in the editor (click the file name in the sidebar)
- **Rename**: edit the **Filename** field on the right above the editor and click Save — the file is renamed immediately
- **Delete**: click the delete button (trash) next to the file in the sidebar, with confirmation
### Folder management
- Click a folder in the sidebar to open the **folder-detail pane** on the right
- **Rename folder**: edit the **Folder name** field in the folder-detail pane and click Save
- **New file / new folder / upload into this folder**: use the buttons in the folder-detail pane — they operate on the selected folder
- **Delete folder**: delete button in the folder-detail pane (only empty folders)
- The content root is also selectable (click "content" at the top of the tree) — shows the folder-detail pane for the root (rename disabled)
### Layout selection
On the editor page you can choose the layout from the layouts defined in `theme.json` (template mapping). The selected layout is stored in the frontmatter `layout:` key.
### Plugins on pages
- Only active **content plugins** (from `plugin.json` with `type: "content"`) appear in the plugin multiselect; system plugins (like Statistics/Logs/Dashboard) are excluded
- Choose which plugins run on the page via the multiselect (use Ctrl/Cmd+click for multiple)
- The plugin selection is stored in the frontmatter `plugins:` key
### Backup integration
At the top of the content editor there is a **Backup** button linking to the backup page (`/admin/content-backup`) for ZIP backup/restore and (if available) git versioning. Git integration in the editor sidebar has been removed; git will become a system plugin later.
### Frontmatter
The editor shows the **Created** and **Edited** timestamps (read-only, automatically updated on every save). The `edited:` value is refreshed on each save.
```markdown
---
layout: left_sidebar
created: 2026-08-19 10:30:25
edited: 2026-08-20 14:22:01
plugins: HTMLBlock, Navigation
---
# Page title
Content...
```
## Frontmatter ## Frontmatter
@@ -128,9 +35,9 @@ The editor updates the frontmatter live when layout or plugin selection changes:
```markdown ```markdown
--- ---
layout: left_sidebar layout: left_sidebar
created: 2026-08-19 10:30:25 plugins:
edited: 2026-08-20 14:22:01 - HTMLBlock
plugins: HTMLBlock, Navigation - Navigation
--- ---
# Page title # Page title
-41
View File
@@ -28,44 +28,3 @@ Only active plugins are shown in the admin sidebar.
4. Enable the plugin 4. Enable the plugin
New plugins are content-plugins by default. To create a system plugin, add `"type": "system"` to `plugin.json`. New plugins are content-plugins by default. To create a system plugin, add `"type": "system"` to `plugin.json`.
## Plugin editor
Via **Edit** (pencil icon) in the plugin overview you open the plugin editor (`/admin/plugins-edit?plugin=<name>`). It works the same as the content and theme editors.
### File browser sidebar
- Shows the nested file tree of the plugin, with a clickable **plugin** root at the top
- Click a file to open it in the CodeMirror editor
- Click a folder to open the **folder detail pane** on the right (new file, new folder, upload, delete)
- Folders containing the active file are auto-expanded
- Per folder there are action buttons: new file, new folder — they operate on the selected folder
- Per file there are action buttons: rename/move (pencil), delete (trash) — appear on hover
### Drag-and-drop
- Drag a file or folder onto another folder to move it
- Valid drop targets are highlighted during dragging
- The move is performed via an AJAX call — the page reloads automatically on success
- Protected plugins (like Navigation) cannot be edited/moved
### Editable file types
`.php`, `.json`, `.md`, `.html`, `.css`, `.scss`, `.js`
### Create a new file / folder
- Select the target folder in the sidebar (click the folder name), or use the root
- Click **New file** or **New folder** (in the folder-detail pane or at the top)
- For a new file: enter a path within the plugin (e.g. `helper.php` or `assets/css/extra.css`)
- Subfolders are created automatically
### Move / delete a file
- **Move**: drag the file onto another folder (drag-and-drop), or click the pencil icon
- **Delete**: click the trash button next to the file in the sidebar, with confirmation
### Folder management
- Click a folder in the sidebar to open the **folder-detail pane** on the right
- **New file / new folder / upload into this folder**: use the buttons in the folder-detail pane
- **Delete folder**: delete button in the folder-detail pane (only empty folders)
### Security
- Protected plugins (Navigation) cannot be edited
- All actions require a CSRF token
- Path-traversal protection via `realpath()` + prefix check on the plugin dir
+6 -80
View File
@@ -3,87 +3,15 @@
## Managing themes ## Managing themes
1. Go to **Theme** in the admin menu 1. Go to **Theme** in the admin menu
2. **Edit** — Click the pencil icon to edit theme files (see [Theme editor](#theme-editor)) 2. **Activate** — Choose the active theme (stored in `config.json`)
3. **Activate** — Click the checkmark to activate a theme (stored in `config.json`) 3. **Compile SCSS** — Process SCSS to CSS (forced)
4. **Compile SCSS** — Click the palette icon to force-compile SCSS to `assets/css_compiled/theme.css` 4. **New theme** — Create a custom theme via admin or manually
5. **Delete** — Trash icon (only non-active, non-default themes)
6. **New theme** — Create a custom theme, optionally based on an existing theme
## Theme status badges
In the theme overview you see per theme:
- **Active** (green) — this theme is selected in `config.json`
- **SCSS ok** (green) — `assets/css_compiled/theme.css` is newer than `assets/scss/theme.scss`
- **SCSS stale** (yellow) — SCSS source was changed after the last compile; click the palette icon to compile
## Theme editor
Via **Edit** (pencil icon) in the theme overview you open the theme editor (`/admin/theme-edit?theme=<name>`). It works the same as the plugin editor:
### File browser sidebar
- Shows the nested file tree of the theme, with a clickable **theme** root at the top
- `assets/css_compiled/` is hidden (runtime artefact, read-only)
- Click a file to open it in the CodeMirror editor
- Click a folder to open the **folder detail pane** on the right (new file, new folder, upload, delete)
- Folders containing the active file are auto-expanded
- Per folder there are action buttons: new file, new folder — they operate on the selected folder
- Per file there are action buttons: rename/move (pencil), delete (trash) — appear on hover
### Drag-and-drop
- Drag a file or folder onto another folder to move it
- Valid drop targets are highlighted during dragging
- The move is performed via an AJAX call — the page reloads automatically on success
- `theme.json` cannot be moved
### Editable file types
`.twig`, `.json`, `.scss`, `.css`, `.js`, `.html`, `.md`, `.php`
### Create a new file / folder
- Select the target folder in the sidebar (click the folder name), or use the root
- Click **New file** or **New folder** (in the folder-detail pane or at the top)
- For a new file: enter a path within the theme (e.g. `partials/header.twig` or `assets/scss/_variables.scss`)
- Subfolders are created automatically
- Allowed: twig, json, scss, css, js, html, md, php
- A stub is auto-generated (e.g. `{% extends 'base.twig' %}` for `.twig`)
### Upload a file
- Click **Upload** to upload files to the theme's `assets/`
- Allowed: images, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, fonts
- Path-traversal protection: target dir must stay within `assets/`
### Move / delete a file
- **Move**: drag the file onto another folder (drag-and-drop), or click the pencil icon next to the file to go to the move form
- **Delete**: click the trash button next to the file in the sidebar, with confirmation; `theme.json` cannot be deleted
### Folder management
- Click a folder in the sidebar to open the **folder-detail pane** on the right
- **New file / new folder / upload into this folder**: use the buttons in the folder-detail pane
- **Delete folder**: delete button in the folder-detail pane (only empty folders)
- The theme root is also selectable (click the theme name at the top of the tree)
### Compile SCSS from the editor
- At the top of the editor there is a **Compile SCSS** button (only if `assets/scss/theme.scss` exists)
- Shows the compile status: **up-to-date** (green) or **stale** (yellow)
- Forces compilation via `ThemeManager::compileCss(true)`
### Insert media in the editor
- The media button in the editor toolbar opens the media modal
- In theme context it scans `themes/<name>/assets/` (via `/admin/media-list?theme=<name>`)
- Snippet format depends on file type: markdown → `![alt](url)`, html/php → `<img src=...>`, others → raw URL
### Security
- All actions require a CSRF token
- Path-traversal protection via `realpath()` + prefix check on the theme dir
- `theme.json` can be edited but not deleted/moved
- Default theme can be edited but not deleted
- Active theme cannot be deleted (activate another theme first)
## Theme structure ## Theme structure
``` ```
themes/default/ themes/default/
├── theme.json # { title, config.default_template, template: layout→.twig } ├── theme.json # { title, config.default_template, template: layout→.twig }
├── README.md # Theme documentation (per theme)
├── base.twig # Main layout (head, header, nav, breadcrumb, footer) ├── base.twig # Main layout (head, header, nav, breadcrumb, footer)
├── full_content.twig # Layout: full width ├── full_content.twig # Layout: full width
├── left_sidebar.twig # Layout: sidebar on the left ├── left_sidebar.twig # Layout: sidebar on the left
@@ -93,15 +21,13 @@ themes/default/
├── partials/ # header.twig, navigation.twig, footer.twig ├── partials/ # header.twig, navigation.twig, footer.twig
└── assets/ └── assets/
├── scss/theme.scss # SCSS source (only CSS source — manual css/theme.css must not exist) ├── scss/theme.scss # SCSS source (only CSS source — manual css/theme.css must not exist)
├── css_compiled/ # Generated by scssphp (read-only, do not edit manually, hidden in editor) ├── css_compiled/ # Generated by scssphp (read-only, do not edit manually)
├── css/ # External CSS (bootstrap.min.css, bootstrap-icons.css, mobile.css) ├── css/ # External CSS (bootstrap.min.css, bootstrap-icons.css, mobile.css)
├── js/ # app.js, bootstrap.bundle.min.js ├── js/ # app.js, bootstrap.bundle.min.js
├── fonts/ # bootstrap-icons.woff, woff2 ├── fonts/ # bootstrap-icons.woff, woff2
└── img/ # favicon, icon, world-map └── img/ # favicon, icon, world-map
``` ```
New themes created via admin automatically get this uniform structure (with `README.md`, `base.twig`, `full_content.twig`, `partials/header.twig`, `partials/footer.twig`, `assets/scss/theme.scss`, and all assets subfolders).
## theme.json ## theme.json
```json ```json
@@ -127,9 +53,9 @@ New themes created via admin automatically get this uniform structure (with `REA
## SCSS compilation ## SCSS compilation
- `ThemeManager` compiles `assets/scss/theme.scss` at runtime to `assets/css_compiled/theme.css` via scssphp - `ThemeManager` compiles `assets/scss/theme.scss` at runtime to `assets/css_compiled/theme.css` via scssphp
- `css_compiled/` is **read-only** — do not edit manually (hidden in the theme editor) - `css_compiled/` is **read-only** — do not edit manually
- `assets/css/theme.css` must **not** exist; otherwise `ThemeManager::getCssUrl()` ignores the SCSS - `assets/css/theme.css` must **not** exist; otherwise `ThemeManager::getCssUrl()` ignores the SCSS
- Force compilation via the **Compile SCSS** button in admin (or remove `assets/css_compiled/theme.css` and `.mtime`) - After SCSS changes: remove `assets/css_compiled/theme.css` and `.mtime` to force recompilation
## Layouts ## Layouts
+49 -135
View File
@@ -1,132 +1,84 @@
# Content API # Content API
PHP content files (`.php`) run inside the CMS and have access to a safe, The Content API is available in PHP content files (`.php`) and provides a safe, read-only interface to CMS data.
read-only API via the `$api` variable. The output of such a file is
automatically placed into the active Twig layout at the `{{ content }}` spot.
## How to pass content to the Twig template ## Usage in PHP content files
There are **two ways** to send content from a `.php` file to the Twig template.
The CMS picks the right one automatically:
1. **Echo / print** — everything you echo (or that sits outside `<?php ?>` tags)
is captured and placed as `{{ content }}` in the layout.
2. **Return** — if you `return` a string, that string is used as `{{ content }}`
(any echoed output is then ignored).
Example with echo:
```php ```php
---
layout: full_content
---
<?php <?php
/** @var ContentAPI $api */ /** @var ContentAPI $api */
?>
<h1>Hello <?= htmlspecialchars($api->getSiteTitle()) ?></h1> // Get all pages
<p>Welcome to my page.</p> $allPages = $api->getAllPages();
// Result: ['index' => 'Home', 'about-us' => 'About Us', ...]
// Get a specific page
$page = $api->getPage('about-us');
// Result: ['title' => 'About Us', 'content' => '...', 'path' => 'about-us', 'layout' => 'full_content', 'metadata' => [...]]
// Get menu structure
$menu = $api->getMenu();
// Result: [['title' => 'Home', 'path' => 'index', 'type' => 'file', 'active' => true], ...]
// Get config value (dot notation)
$siteTitle = $api->getConfig('site_title');
$searchEnabled = $api->getConfig('features.search_enabled', false);
``` ```
Example with return: ## Available methods
```php
---
layout: full_content
---
<?php
/** @var ContentAPI $api */
return '<h1>Hello ' . htmlspecialchars($api->getSiteTitle()) . '</h1>';
```
> The frontmatter (`---` block) is stripped by the CMS before the PHP code
> runs. The layout key determines which Twig template surrounds the content.
## What you cannot do
- You **cannot** set your own Twig variables from a `.php` file. PHP content
only feeds the `{{ content }}` placeholder. Other template variables
(`menu`, `breadcrumb`, `page_title`, etc.) are set by the CMS based on
frontmatter and config — not by your PHP code.
- You **cannot** call a ContentAPI from the outside; the class is only
instantiated inside `parsePHP()` and is never reachable via a URL.
## Available variables in your PHP file
The following variables are available inside a `.php` content file:
| Variable | Type | Description |
|----------|------|-------------|
| `$api` | `ContentAPI` | Read-only access to CMS data |
| `$pageMetadata` | `array` | The frontmatter metadata of this file |
## ContentAPI methods
### Pages ### Pages
- `getAllPages(): array` All content entries (folders + files) as a list of `['path' => ..., 'title' => ..., 'type' => ...]`. `type` is `md`/`php`/`html` for files, `folder` for directories. - `getAllPages(): array` - All pages as `['path' => 'title']` pairs
- `getPage(string $path): ?array` — A specific page; returns `title`, `content`, `path`, `layout`, `metadata`. `$path` may include an extension. - `getPage(string $path): ?array` - Specific page with `title`, `content`, `path`, `layout`, `metadata`
- `pageExists(string $path): bool` Check whether a page exists - `pageExists(string $path): bool` - Check if a page exists
- `getCurrentPageTitle(): string` Title of the current page - `getCurrentPageTitle(): string` - Title of current page
- `getCurrentPagePath(): string` Path of the current page - `getCurrentPagePath(): string` - Path of current page
- `isHomepage(): bool` Whether the current page is the homepage - `isHomepage(): bool` - Whether current page is the homepage
### Menu & navigation ### Menu & Navigation
- `getMenu(): array` Hierarchical menu structure with `title`, `path`, `children`, `active` - `getMenu(): array` - Hierarchical menu structure with `title`, `path`, `children`, `active`
- `buildUrl(string $page = 'index', ?string $lang = null, array $params = []): string` Build a URL - `buildUrl(string $page = 'index', ?string $lang = null, array $params = []): string` - Build a URL for a page
### Configuration ### Configuration
- `getConfig(string $key, mixed $default = null): mixed` Config value via dot notation (e.g. `'features.search_enabled'`) - `getConfig(string $key, mixed $default = null): mixed` - Config value via dot notation (e.g. `'features.search_enabled'`)
- `getSiteTitle(): string` Site title from config - `getSiteTitle(): string` - Site title from config
### Language ### Language
- `getCurrentLanguage(): string` Current language code (e.g. `'nl'`) - `getCurrentLanguage(): string` - Current language code (e.g. `'nl'`)
- `getAvailableLanguages(): array` Available languages - `getAvailableLanguages(): array` - Available languages (e.g. `['nl', 'en']`)
- `t(string $key): string` Translate a language key - `t(string $key): string` - Translate a language key
### Search ### Search
- `getSearchResults(): array` Search results (empty if not searching) - `getSearchResults(): array` - Search results (empty if not searching)
- `isSearching(): bool` Whether a search is currently active - `isSearching(): bool` - Whether a search is currently active
### Author ## Example: Show recent pages
- `getPageAuthor(): array` — Author metadata from frontmatter (`author_name`, `author_email`, `created`)
## Examples
### Show recent pages
```php ```php
---
layout: full_content
---
<?php <?php
/** @var ContentAPI $api */ /** @var ContentAPI $api */
$entries = $api->getAllPages(); $pages = $api->getAllPages();
$currentLang = $api->getCurrentLanguage(); $currentLang = $api->getCurrentLanguage();
?> ?>
<ul> <ul>
<?php foreach ($entries as $entry): ?> <?php foreach (array_slice($pages, 0, 5, true) as $path => $title): ?>
<?php if ($entry['type'] === 'folder') continue; // skip folders ?>
<li> <li>
<a href="/<?= htmlspecialchars($currentLang) ?>/<?= htmlspecialchars($entry['path']) ?>"> <a href="/<?= $currentLang ?>/<?= htmlspecialchars($path) ?>">
<?= htmlspecialchars($entry['title']) ?> <?= htmlspecialchars($title) ?>
<small>(<?= htmlspecialchars($entry['type']) ?>)</small>
</a> </a>
</li> </li>
<?php endforeach; ?> <?php endforeach; ?>
</ul> </ul>
``` ```
### Use a config value ## Example: Using config values
```php ```php
---
layout: full_content
---
<?php <?php
/** @var ContentAPI $api */ /** @var ContentAPI $api */
if ($api->getConfig('features.search_enabled', false)): ?> if ($api->getConfig('features.search_enabled', false)): ?>
@@ -137,44 +89,6 @@ if ($api->getConfig('features.search_enabled', false)): ?>
<?php endif; ?> <?php endif; ?>
``` ```
### Dynamic greeting based on language
```php
---
layout: full_content
---
<?php
/** @var ContentAPI $api */
$lang = $api->getCurrentLanguage();
$greeting = $lang === 'nl' ? 'Welkom' : 'Welcome';
?>
<h1><?= $greeting ?> to <?= htmlspecialchars($api->getSiteTitle()) ?></h1>
```
## Choosing a layout
The frontmatter `layout` key determines which Twig template surrounds your
content. Available layouts are defined in `themes/<active-theme>/theme.json`
under the `template` section. For example:
```yaml
---
layout: sidebar-content
---
```
If you omit a layout, `config.default_template` is used, falling back to
`full_content`. The content always lands at the `{{ content }}` spot in that
template.
## Security
- Always use `htmlspecialchars()` for output of user-content or API data.
- PHP content files have access to the server filesystem — be careful with
`include`, `require` or `file_get_contents` on external paths. Stay inside
the `content/` directory.
- The ContentAPI is read-only; you cannot modify files or config through it.
## CMSAPI (for plugins) ## CMSAPI (for plugins)
Plugins use the `CMSAPI` class via `$this->api`. It offers similar methods: Plugins use the `CMSAPI` class via `$this->api`. It offers similar methods:
@@ -194,12 +108,12 @@ $this->api->createUrl('about-us');
$this->api->translate('home'); $this->api->translate('home');
``` ```
In addition, CMSAPI has: Additionally, CMSAPI provides:
- `getCurrentPage(): array` Full page data - `getCurrentPage(): array` - Full page data
- `getCurrentPageUrl(): string` URL of the current page - `getCurrentPageUrl(): string` - URL of current page
- `getCurrentPageFileInfo(): ?array` File info (created, modified) - `getCurrentPageFileInfo(): ?array` - File info (created, modified)
- `getBreadcrumb(): string` Breadcrumb HTML - `getBreadcrumb(): string` - Breadcrumb HTML
- `executePhpFile(string $filePath): string` Execute a PHP file and capture output - `executePhpFile(string $filePath): string` - Execute PHP file and capture output
- `getFileContent(string $filePath): string` Get content from a PHP/HTML/Markdown file - `getFileContent(string $filePath): string` - Get content from PHP/HTML/Markdown file
- `contentFileExists(string $filename): bool` Check whether a file exists in the content directory - `contentFileExists(string $filename): bool` - Check if file exists in content directory
+23 -116
View File
@@ -1,125 +1,32 @@
# Content beheer # Content beheer
CodePress gebruikt een **boom weergave** (`/admin/content`) voor content-beheer: een bestandsbrowser zijbalk + CodeMirror editor, uniform met de plugin- en thema-editors. De oude lijst/tabel weergave is verwijderd. ## Bestanden beheren
## Content editor - **Nieuwe map** — Mappen structuur aanmaken
- **Nieuw bestand** — Pagina aanmaken (`.md`, `.php`, `.html`)
- **Bewerken** — Bestaande content wijzigen in CodeMirror editor
- **Hernoemen** — Bestands- of mapnamen aanpassen
- **Verplaatsen** — Content verplaatsen naar andere map
- **Verwijderen** — Content verwijderen
- **Map hernoemen** — Map naam wijzigen
### Bestandsbrowser zijbalk ## Editor (content-edit)
- Toont de geneste bestandsboom van `content/`, met een klikbare **content** root bovenaan
- Verborgen mappen (`.bak`, `.git`) en dotfiles worden overgeslagen
- Klik op een **bestand** om het te openen in de CodeMirror editor
- Klik op een **map** (mapnaam) om de map te selecteren — rechts verschijnt het **map detail paneel**
- De chevron (▶/▼) naast een map klapt deze in/uit zonder de map te selecteren
- Mappen die het actieve bestand bevatten zijn automatisch uitgeklapt
- Per map staan actie-knoppen: nieuw bestand (plus-icoon), nieuwe map (map-plus-icoon) — deze opereren op de geselecteerde map
- Per bestand staan actie-knoppen: hernoemen/verplaatsen (potlood), verwijderen (prullenbak) — verschijnen bij hover
### Bestanden verslepen (drag-and-drop) - **CodeMirror** met syntax highlighting (Markdown, PHP, HTML)
- Sleep een bestand of map naar een andere map om het te verplaatsen - **Toolbar** voor snel Markdown invoeren
- Tijdens het slepen worden geldige doel-mappen highlight getoond - **Sneltoetsen**: Ctrl+S (opslaan), Ctrl+N (nieuw)
- De verplaatsing gebeurt via een AJAX-call — de pagina herlaadt automatisch na succes
- Beveiliging: een map kan niet naar zichzelf of naar een submap verplaatst worden
- Path-traversal bescherming: alle paden blijven binnen de content map
### Bewerkbare bestandstypen ## Layout selectie
`.md` (Markdown), `.php` (PHP), `.html` (HTML) — consistent met de bestaande content-edit pagina.
Alle types ondersteunen `---` frontmatter (layout, created, edited, plugins). De CMS `parseMetadata()` haalt de frontmatter eruit vóór verwerking. Bij PHP bestanden wordt de frontmatter uit de output verwijderd. Op de content-edit pagina kun je de layout kiezen uit de layouts gedefinieerd in `theme.json` (template mapping). De geselecteerde layout wordt opgeslagen in de frontmatter `layout:` key.
#### PHP content bestanden ## Plugins op pagina's
PHP bestanden kunnen op twee manieren content leveren:
1. **Echo** (output buffering): alles wat `echo`d of outside `<?php` staat wordt als content gebruikt
2. **Return** (callback stijl): `return '<h1>Hallo</h1>';` — de geretourneerde string wordt als content gebruikt
In PHP bestanden is de `ContentAPI` beschikbaar via `$api`: - Content plugins (uit `plugin.json` met `type: "content"`) verschijnen in de plugin selectie
```php - Kies welke plugins in de sidebar verschijnen
<?php - **Volgorde aanpasbaar** met up/down knoppen
$menu = $api->getMenu(); - De plugin volgorde wordt opgeslagen in de frontmatter `plugins:` key
$pages = $api->getAllPages(); - Plugins worden **verbergen** als de gekozen layout geen sidebar heeft (bijv. `full_content`)
$config = $api->getConfig('site_title');
return '<h1>' . htmlspecialchars($config) . '</h1>';
```
#### Frontend URL's en bestandsnamen
De CMS zoekt bestanden in volgorde: `.md``.php``.html`. Als bestanden dezelfde naam hebben (bijv. `test.md` en `test.php`), opent `/nl/test` altijd `test.md`. Om een specifiek bestandstype te openen, voeg de extensie toe aan de URL:
- `/nl/test` → opent `test.md` (of `.php` / `.html` als `.md` niet bestaat)
- `/nl/test.php` → opent `test.php` (expliciete extensie)
- `/nl/test.html` → opent `test.html` (expliciete extensie)
De preview link in de editor gebruikt automatisch de extensie voor niet-`.md` bestanden.
### Image-grootte instellen (Markdown)
In de markdown editor-toolbar staat een "Afbeelding grootte" knop (expand-icoon):
1. Selecteer een afbeelding in de editor in markdown formaat `![alt](url)`
2. Klik op de "Afbeelding grootte" knop
3. Vul breedte en/of hoogte in (px of %, leeg = niet instellen)
4. De `{:width=... height=...}` syntax wordt aan de afbeelding toegevoegd of vervangen
Voorbeeld:
```markdown
![logo](/content/_images/logo.png){:width="200" height="100"}
```
Bestaande `{:width=...}` waarden worden in de prompts getoond. De grootte-attributen worden in de frontend als `width`/`height` HTML-attributen op de `<img>` tag gezet.
### Images in content
Images in `content/` worden via de `/-media/` endpoint geserveerd (content/ staat buiten de webroot). De markdown syntax `![alt](url)` met lokale URLs (relatief zoals `image.jpg`, of absoluut zoals `/content/_images/image.jpg`) wordt automatisch herschreven naar `/-media/...`. Externe URLs (`https://...`) worden ongewijzigd gelaten.
### Nieuw bestand aanmaken
- Selecteer de doelmap in de zijbalk (klik op de mapnaam), of gebruik de root
- Klik op **Nieuw bestand** (in het map-detail paneel of bovenaan)
- Geef een pad op binnen content (bijv. `nl.pagina` of `blog/nl.post`)
- Kies het bestandstype (Markdown/PHP/HTML)
- Submappen worden automatisch aangemaakt
- Frontmatter met `layout`, `created`, `edited` wordt automatisch gegenereerd
- Het nieuwe bestand wordt aangemaakt in de geselecteerde map
### Bestand uploaden
- Selecteer de doelmap in de zijbalk (klik op de mapnaam), of gebruik de root
- Klik op **Upload** (in het map-detail paneel of bovenaan) om bestanden naar de geselecteerde map te uploaden
- Toegestaan: afbeeldingen, video, audio, PDF, ZIP, office docs, CSS, SCSS, JS, JSON, HTML, MD
- Path-traversal bescherming: doelmap moet binnen `content/` blijven
- Na de upload keer je terug naar de geselecteerde map
### Bestand hernoemen / verwijderen
- Open het bestand in de editor (klik op de bestandsnaam in de zijbalk)
- **Hernoemen**: bewerk het **Bestandsnaam** veld rechts boven de editor en klik op Opslaan — het bestand wordt direct hernoemd
- **Verwijderen**: klik op de verwijder-knop (prullenbak) naast het bestand in de zijbalk, met bevestiging
### Mappen beheer
- Klik op een map in de zijbalk om het **map-detail paneel** rechts te openen
- **Map hernoemen**: bewerk het **Mapnaam** veld in het map-detail paneel en klik op Opslaan
- **Nieuw bestand / Nieuwe map / Uploaden in deze map**: gebruik de knoppen in het map-detail paneel — ze opereren op de geselecteerde map
- **Map verwijderen**: verwijder-knop in het map-detail paneel (alleen lege mappen)
- De content-root is ook selecteerbaar (klik op "content" bovenaan de boom) — toont het map-detail paneel voor de root (hernoemen uitgeschakeld)
### Layout selectie
Op de editor-pagina kun je de layout kiezen uit de layouts gedefinieerd in `theme.json` (template mapping). De geselecteerde layout wordt opgeslagen in de frontmatter `layout:` key.
### Plugins op pagina's
- Alleen actieve **content plugins** (uit `plugin.json` met `type: "content"`) verschijnen in de plugin multiselect; system plugins (zoals Statistics/Logs/Dashboard) zijn uitgesloten
- Kies via de multiselect welke plugins op de pagina draaien (gebruik Ctrl/Cmd+klik voor meerdere)
- De plugin selectie wordt opgeslagen in de frontmatter `plugins:` key
### Backup integratie
Bovenaan de content-editor staat een **Backup** knop die naar de backup-pagina (`/admin/content-backup`) leidt voor ZIP backup/restore en (indien beschikbaar) git versiebeheer. Git integratie in de editor-zijbalk is verwijderd; git wordt later een systeem plugin.
### Frontmatter
De editor toont de **Aangemaakt** en **Bewerkt** timestamps (read-only, automatisch bijgewerkt bij elke opslag). De `edited:` waarde wordt bij elke save vernieuwd.
```markdown
---
layout: left_sidebar
created: 2026-08-19 10:30:25
edited: 2026-08-20 14:22:01
plugins: HTMLBlock, Navigation
---
# Pagina titel
Content...
```
## Frontmatter ## Frontmatter
@@ -128,9 +35,9 @@ De editor werkt de frontmatter live bij bij wijzigingen van layout of plugin sel
```markdown ```markdown
--- ---
layout: left_sidebar layout: left_sidebar
created: 2026-08-19 10:30:25 plugins:
edited: 2026-08-20 14:22:01 - HTMLBlock
plugins: HTMLBlock, Navigation - Navigation
--- ---
# Pagina titel # Pagina titel
-41
View File
@@ -28,44 +28,3 @@ Alleen actieve plugins worden getoond in de admin sidebar.
4. Activeer de plugin 4. Activeer de plugin
Nieuwe plugins zijn standaard content-plugins. Wil je een systeem-plugin maken, voeg dan `"type": "system"` toe aan `plugin.json`. Nieuwe plugins zijn standaard content-plugins. Wil je een systeem-plugin maken, voeg dan `"type": "system"` toe aan `plugin.json`.
## Plugin editor
Via **Bewerken** (potlood-icoon) in het plugin-overzicht open je de plugin-editor (`/admin/plugins-edit?plugin=<naam>`). Deze werkt hetzelfde als de content- en thema-editors.
### Bestandsbrowser zijbalk
- Toont de geneste bestandsboom van de plugin, met een klikbare **plugin** root bovenaan
- Klik op een bestand om het te openen in de CodeMirror editor
- Klik op een map om het **map detail paneel** rechts te openen (nieuw bestand, nieuwe map, uploaden, verwijderen)
- Mappen die het actieve bestand bevatten zijn automatisch uitgeklapt
- Per map staan actie-knoppen: nieuw bestand, nieuwe map — opereren op de geselecteerde map
- Per bestand staan actie-knoppen: hernoemen/verplaatsen (potlood), verwijderen (prullenbak) — verschijnen bij hover
### Bestanden verslepen (drag-and-drop)
- Sleep een bestand of map naar een andere map om het te verplaatsen
- Tijdens het slepen worden geldige doel-mappen highlight getoond
- De verplaatsing gebeurt via een AJAX-call — de pagina herlaadt automatisch na succes
- Beschermde plugins (zoals Navigation) kunnen niet bewerkt/verplaatst worden
### Bewerkbare bestandstypen
`.php`, `.json`, `.md`, `.html`, `.css`, `.scss`, `.js`
### Nieuw bestand / nieuwe map aanmaken
- Selecteer de doelmap in de zijbalk (klik op de mapnaam), of gebruik de root
- Klik op **Nieuw bestand** of **Nieuwe map** (in het map-detail paneel of bovenaan)
- Bij nieuw bestand: geef een pad op binnen de plugin (bijv. `helper.php` of `assets/css/extra.css`)
- Submappen worden automatisch aangemaakt
### Bestand verplaatsen / verwijderen
- **Verplaatsen**: sleep het bestand naar een andere map (drag-and-drop), of klik op het potlood-icoon
- **Verwijderen**: klik op de prullenbak-knop naast het bestand in de zijbalk, met bevestiging
### Mappen beheer
- Klik op een map in de zijbalk om het **map-detail paneel** rechts te openen
- **Nieuw bestand / Nieuwe map / Uploaden in deze map**: gebruik de knoppen in het map-detail paneel
- **Map verwijderen**: verwijder-knop in het map-detail paneel (alleen lege mappen)
### Beveiliging
- Beschermde plugins (Navigation) kunnen niet bewerkt worden
- Alle acties vereisen CSRF token
- Path-traversal bescherming via `realpath()` + prefix-check op de plugin-map
+6 -81
View File
@@ -3,88 +3,15 @@
## Thema's beheren ## Thema's beheren
1. Ga naar **Thema** in admin menu 1. Ga naar **Thema** in admin menu
2. **Bewerken** — Klik op het potlood-icoon om themabestanden te bewerken (zie [Thema editor](#thema-editor)) 2. **Activeren** — Kies actief thema (wordt opgeslagen in `config.json`)
3. **Activeren**Klik op het vinkje om een thema te activeren (wordt opgeslagen in `config.json`) 3. **SCSS compileren**Verwerk SCSS naar CSS (geforceerd)
4. **SCSS compileren** — Klik op het palet-icoon om SCSS geforceerd te compileren naar `assets/css_compiled/theme.css` 4. **Nieuw thema** — Eigen thema aanmaken via admin of handmatig
5. **Verwijderen** — Prullenbak-icoon (alleen niet-actieve, niet-default thema's)
6. **Nieuw thema** — Eigen thema aanmaken, optioneel gebaseerd op een bestaand thema
## Thema status badges
In het thema-overzicht zie je per thema:
- **Actief** (groen) — dit thema is geselecteerd in `config.json`
- **SCSS ok** (groen) — `assets/css_compiled/theme.css` is nieuwer dan `assets/scss/theme.scss`
- **SCSS verouderd** (geel) — SCSS source is gewijzigd na laatste compile; klik op het palet-icoon om te compileren
## Thema editor
Via **Bewerken** (potlood-icoon) in het thema-overzicht open je de thema-editor (`/admin/theme-edit?theme=<naam>`). Deze werkt hetzelfde als de plugin-editor:
### Bestandsbrowser zijbalk
- Toont de geneste bestandsboom van het thema, met een klikbare **thema** root bovenaan
- `assets/css_compiled/` wordt verborgen (runtime artefact, read-only)
- Klik op een bestand om het te openen in de CodeMirror editor
- Klik op een map om het **map detail paneel** rechts te openen (nieuw bestand, nieuwe map, uploaden, verwijderen)
- Mappen die het actieve bestand bevatten zijn automatisch uitgeklapt
- Per map staan actie-knoppen: nieuw bestand, nieuwe map — opereren op de geselecteerde map
- Per bestand staan actie-knoppen: hernoemen/verplaatsen (potlood), verwijderen (prullenbak) — verschijnen bij hover
### Bestanden verslepen (drag-and-drop)
- Sleep een bestand of map naar een andere map om het te verplaatsen
- Tijdens het slepen worden geldige doel-mappen highlight getoond
- De verplaatsing gebeurt via een AJAX-call — de pagina herlaadt automatisch na succes
- `theme.json` kan niet verplaatst worden
### Bewerkbare bestandstypen
`.twig`, `.json`, `.scss`, `.css`, `.js`, `.html`, `.md`, `.php`
### Nieuw bestand / nieuwe map aanmaken
- Selecteer de doelmap in de zijbalk (klik op de mapnaam), of gebruik de root
- Klik op **Nieuw bestand** of **Nieuwe map** (in het map-detail paneel of bovenaan)
- Bij nieuw bestand: geef een pad op binnen het thema (bijv. `partials/header.twig` of `assets/scss/_variables.scss`)
- Submappen worden automatisch aangemaakt
- Toegestaan: twig, json, scss, css, js, html, md, php
- Een stub wordt automatisch gegenereerd (bijv. `{% extends 'base.twig' %}` voor `.twig`)
### Bestand uploaden
- Klik op **Upload** om bestanden naar `assets/` van het thema te uploaden
- Toegestaan: afbeeldingen, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, fonts
- Path-traversal bescherming: doelmap moet binnen `assets/` blijven
### Bestand verplaatsen / verwijderen
- **Verplaatsen**: sleep het bestand naar een andere map (drag-and-drop), of klik op het potlood-icoon naast het bestand om naar het verplaats-formulier te gaan
- **Verwijderen**: klik op de prullenbak-knop naast het bestand in de zijbalk, met bevestiging; `theme.json` kan niet verwijderd worden
### Mappen beheer
- Klik op een map in de zijbalk om het **map-detail paneel** rechts te openen
- **Nieuw bestand / Nieuwe map / Uploaden in deze map**: gebruik de knoppen in het map-detail paneel
- **Map verwijderen**: verwijder-knop in het map-detail paneel (alleen lege mappen)
- De thema-root is ook selecteerbaar (klik op de thema-naam bovenaan de boom)
### SCSS compileren vanuit de editor
- Bovenaan de editor staat een **SCSS compileren** knop (alleen als `assets/scss/theme.scss` bestaat)
- Toont de compile-status: **up-to-date** (groen) of **verouderd** (geel)
- Forceert compilatie via `ThemeManager::compileCss(true)`
### Media invoegen in editor
- De media-knop in de editor-toolbar opent de media-modal
- Media wordt getoond als een collapsible **bestandsboom** (folders inklappen/uitklappen), gelijk aan de content/plugin/theme editors
- In thema-context scant deze `themes/<naam>/assets/` (via `/admin/media-list?theme=<naam>`)
- Snippet-formaat depends op bestandstype: markdown → `![alt](url)`, html/php → `<img src=...>`, andere → ruwe URL
### Beveiliging
- Alle acties vereisen CSRF token
- Path-traversal bescherming via `realpath()` + prefix-check op de thema-map
- `theme.json` kan bewerkt maar niet verwijderd/verplaatst worden
- Default thema kan bewerkt maar niet verwijderd worden
- Actief thema kan niet verwijderd worden (activeer eerst een ander thema)
## Thema structuur ## Thema structuur
``` ```
themes/default/ themes/default/
├── theme.json # { title, config.default_template, template: layout→.twig } ├── theme.json # { title, config.default_template, template: layout→.twig }
├── README.md # Thema documentatie (per thema)
├── base.twig # Hoofd layout (head, header, nav, breadcrumb, footer) ├── base.twig # Hoofd layout (head, header, nav, breadcrumb, footer)
├── full_content.twig # Layout: volledige breedte ├── full_content.twig # Layout: volledige breedte
├── left_sidebar.twig # Layout: sidebar links ├── left_sidebar.twig # Layout: sidebar links
@@ -94,15 +21,13 @@ themes/default/
├── partials/ # header.twig, navigation.twig, footer.twig ├── partials/ # header.twig, navigation.twig, footer.twig
└── assets/ └── assets/
├── scss/theme.scss # SCSS bron (enige CSS bron — handmatige css/theme.css mag niet bestaan) ├── scss/theme.scss # SCSS bron (enige CSS bron — handmatige css/theme.css mag niet bestaan)
├── css_compiled/ # Gegenereerd door scssphp (read-only, niet handmatig aanpassen, verborgen in editor) ├── css_compiled/ # Gegenereerd door scssphp (read-only, niet handmatig aanpassen)
├── css/ # Externe CSS (bootstrap.min.css, bootstrap-icons.css, mobile.css) ├── css/ # Externe CSS (bootstrap.min.css, bootstrap-icons.css, mobile.css)
├── js/ # app.js, bootstrap.bundle.min.js ├── js/ # app.js, bootstrap.bundle.min.js
├── fonts/ # bootstrap-icons.woff, woff2 ├── fonts/ # bootstrap-icons.woff, woff2
└── img/ # favicon, icon, world-map └── img/ # favicon, icon, world-map
``` ```
Nieuwe thema's die via de admin worden aangemaakt krijgen automatisch deze uniforme structuur (met `README.md`, `base.twig`, `full_content.twig`, `partials/header.twig`, `partials/footer.twig`, `assets/scss/theme.scss`, en alle assets-submappen).
## theme.json ## theme.json
```json ```json
@@ -128,9 +53,9 @@ Nieuwe thema's die via de admin worden aangemaakt krijgen automatisch deze unifo
## SCSS compilatie ## SCSS compilatie
- `ThemeManager` compileert `assets/scss/theme.scss` runtime naar `assets/css_compiled/theme.css` via scssphp - `ThemeManager` compileert `assets/scss/theme.scss` runtime naar `assets/css_compiled/theme.css` via scssphp
- `css_compiled/` is **read-only** — niet handmatig aanpassen (wordt verborgen in de thema-editor) - `css_compiled/` is **read-only** — niet handmatig aanpassen
- `assets/css/theme.css` mag **niet** bestaan; anders negeert `ThemeManager::getCssUrl()` de SCSS - `assets/css/theme.css` mag **niet** bestaan; anders negeert `ThemeManager::getCssUrl()` de SCSS
- Forceer compilatie via de **SCSS compileren** knop in admin (of verwijder `assets/css_compiled/theme.css` en `.mtime`) - Na SCSS wijzigingen: verwijder `assets/css_compiled/theme.css` en `.mtime` om te forceren
## Layouts ## Layouts
+49 -136
View File
@@ -1,132 +1,84 @@
# Content API # Content API
PHP content bestanden (`.php`) draaien binnen het CMS en hebben toegang tot een De Content API is beschikbaar in PHP content bestanden (`.php`) en biedt een veilige, read-only interface tot CMS data.
veilige, read-only API via de variabele `$api`. De output van zo'n bestand wordt
automatisch in de actieve Twig layout geplaatst op de plek van `{{ content }}`.
## Hoe je content doorgeeft aan de Twig template ## Gebruik in PHP content bestanden
Er zijn **twee manieren** om content vanuit een `.php` bestand naar het Twig
template te sturen. De CMS kiest automatisch de juiste:
1. **Echo / print** — alles wat je echoot (of wat buiten `<?php ?>` tags staat)
wordt opgevangen en als `{{ content }}` in de layout geplaatst.
2. **Return** — als je `return` gebruikt met een string, wordt die string als
`{{ content }}` gebruikt (echt output wordt dan genegeerd).
Voorbeeld met echo:
```php ```php
---
layout: full_content
---
<?php <?php
/** @var ContentAPI $api */ /** @var ContentAPI $api */
?>
<h1>Hallo <?= htmlspecialchars($api->getSiteTitle()) ?></h1> // Alle pagina's ophalen
<p>Welkom op mijn pagina.</p> $allPages = $api->getAllPages();
// Resultaat: ['index' => 'Home', 'over-ons' => 'Over ons', ...]
// Specifieke pagina ophalen
$page = $api->getPage('over-ons');
// Resultaat: ['title' => 'Over ons', 'content' => '...', 'path' => 'over-ons', 'layout' => 'full_content', 'metadata' => [...]]
// Menu structuur ophalen
$menu = $api->getMenu();
// Resultaat: [['title' => 'Home', 'path' => 'index', 'type' => 'file', 'active' => true], ...]
// Config waarde ophalen (dot notatie)
$siteTitle = $api->getConfig('site_title');
$searchEnabled = $api->getConfig('features.search_enabled', false);
``` ```
Voorbeeld met return: ## Beschikbare methods
```php
---
layout: full_content
---
<?php
/** @var ContentAPI $api */
return '<h1>Hallo ' . htmlspecialchars($api->getSiteTitle()) . '</h1>';
```
> De frontmatter (`---` blok) wordt door het CMS gestript vóórdat de PHP code
> uitgevoerd wordt. De layout key bepaalt welke Twig template de content omringt.
## Wat kun je níét doen
- Je kunt **geen** eigen Twig variabelen zetten vanuit een `.php` bestand.
PHP content leverde alleen de `{{ content }}` placeholder. Andere template
variabelen (`menu`, `breadcrumb`, `page_title`, etc.) worden door het CMS
vastgesteld op basis van de frontmatter en config — niet door je PHP code.
- Je kunt **geen** van buitenaf een ContentAPI aanroepen; de class wordt alleen
binnen `parsePHP()` geïnstantieerd en is nooit via een URL bereikbaar.
## Beschikbare variabelen in je PHP bestand
Binnen een `.php` content bestand zijn de volgende variabelen beschikbaar:
| Variabele | Type | Omschrijving |
|-----------|------|--------------|
| `$api` | `ContentAPI` | Read-only toegang tot CMS data |
| `$pageMetadata` | `array` | De frontmatter metadata van dit bestand |
## ContentAPI methods
### Pagina's ### Pagina's
- `getAllPages(): array` Alle content entries (mappen + bestanden) als een list van `['path' => ..., 'title' => ..., 'type' => ...]`. `type` is `md`/`php`/`html` voor bestanden, `folder` voor mappen. - `getAllPages(): array` - Alle pagina's als `['pad' => 'titel']` pairs
- `getPage(string $path): ?array` Specifieke pagina; levert `title`, `content`, `path`, `layout`, `metadata`. `$path` mag een extensie bevatten. - `getPage(string $path): ?array` - Specifieke pagina met `title`, `content`, `path`, `layout`, `metadata`
- `pageExists(string $path): bool` Controleer of een pagina bestaat - `pageExists(string $path): bool` - Controleer of een pagina bestaat
- `getCurrentPageTitle(): string` Titel van de huidige pagina - `getCurrentPageTitle(): string` - Titel van huidige pagina
- `getCurrentPagePath(): string` Pad van de huidige pagina - `getCurrentPagePath(): string` - Pad van huidige pagina
- `isHomepage(): bool` Of de huidige pagina de homepage is - `isHomepage(): bool` - Of huidige pagina de homepage is
### Menu & navigatie ### Menu & Navigatie
- `getMenu(): array` Hiërarchische menu structuur met `title`, `path`, `children`, `active` - `getMenu(): array` - Hiërarchische menu structuur met `title`, `path`, `children`, `active`
- `buildUrl(string $page = 'index', ?string $lang = null, array $params = []): string` Bouw een URL - `buildUrl(string $page = 'index', ?string $lang = null, array $params = []): string` - Bouw een URL voor een pagina
### Configuratie ### Configuratie
- `getConfig(string $key, mixed $default = null): mixed` Config waarde via dot notatie (bijv. `'features.search_enabled'`) - `getConfig(string $key, mixed $default = null): mixed` - Config waarde via dot notatie (bijv. `'features.search_enabled'`)
- `getSiteTitle(): string` Site titel uit config - `getSiteTitle(): string` - Site titel uit config
### Taal ### Taal
- `getCurrentLanguage(): string` Huidige taal code (bijv. `'nl'`) - `getCurrentLanguage(): string` - Huidige taal code (bijv. `'nl'`)
- `getAvailableLanguages(): array` Beschikbare talen - `getAvailableLanguages(): array` - Beschikbare talen (bijv. `['nl', 'en']`)
- `t(string $key): string` Vertaal een language key - `t(string $key): string` - Vertaal een language key
### Zoeken ### Zoeken
- `getSearchResults(): array` Zoekresultaten (leeg als niet aan het zoeken) - `getSearchResults(): array` - Zoekresultaten (leeg als niet aan het zoeken)
- `isSearching(): bool` Of er momenteel gezocht wordt - `isSearching(): bool` - Of er momenteel gezocht wordt
### Auteur ## Voorbeeld: Recentste pagina's tonen
- `getPageAuthor(): array` — Auteur metadata uit frontmatter (`author_name`, `author_email`, `created`)
## Voorbeelden
### Recente pagina's tonen
```php ```php
---
layout: full_content
---
<?php <?php
/** @var ContentAPI $api */ /** @var ContentAPI $api */
$entries = $api->getAllPages(); $pages = $api->getAllPages();
$currentLang = $api->getCurrentLanguage(); $currentLang = $api->getCurrentLanguage();
?> ?>
<ul> <ul>
<?php foreach ($entries as $entry): ?> <?php foreach (array_slice($pages, 0, 5, true) as $path => $title): ?>
<?php if ($entry['type'] === 'folder') continue; // sla mappen over ?>
<li> <li>
<a href="/<?= htmlspecialchars($currentLang) ?>/<?= htmlspecialchars($entry['path']) ?>"> <a href="/<?= $currentLang ?>/<?= htmlspecialchars($path) ?>">
<?= htmlspecialchars($entry['title']) ?> <?= htmlspecialchars($title) ?>
<small>(<?= htmlspecialchars($entry['type']) ?>)</small>
</a> </a>
</li> </li>
<?php endforeach; ?> <?php endforeach; ?>
</ul> </ul>
``` ```
### Config waarde gebruiken ## Voorbeeld: Config waarde gebruiken
```php ```php
---
layout: full_content
---
<?php <?php
/** @var ContentAPI $api */ /** @var ContentAPI $api */
if ($api->getConfig('features.search_enabled', false)): ?> if ($api->getConfig('features.search_enabled', false)): ?>
@@ -137,48 +89,9 @@ if ($api->getConfig('features.search_enabled', false)): ?>
<?php endif; ?> <?php endif; ?>
``` ```
### Dynamische begroeting op basis van taal
```php
---
layout: full_content
---
<?php
/** @var ContentAPI $api */
$lang = $api->getCurrentLanguage();
$greeting = $lang === 'nl' ? 'Welkom' : 'Welcome';
?>
<h1><?= $greeting ?> op <?= htmlspecialchars($api->getSiteTitle()) ?></h1>
```
## Layout kiezen
De frontmatter `layout` key bepaalt welke Twig template je content omringt. De
beschikbare layouts staan in `themes/<actief-thema>/theme.json` onder de
`template` sectie. Bijvoorbeeld:
```yaml
---
layout: sidebar-content
---
```
Als je geen layout opgeeft, wordt `config.default_template` gebruikt, met als
fallback `full_content`. De content komt altijd terecht op de `{{ content }}`
plek in die template.
## Veiligheid
- Gebruik altijd `htmlspecialchars()` voor output van user-content of API data.
- PHP content bestanden hebben toegang tot het bestandssysteem van de server —
wees voorzichtig met `include`, `require` of `file_get_contents` op externe
paden. Blijf binnen de `content/` map.
- De ContentAPI is read-only; je kunt er geen bestanden of config mee wijzigen.
## CMSAPI (voor plugins) ## CMSAPI (voor plugins)
Plugins gebruiken de `CMSAPI` class via `$this->api`. Deze biedt vergelijkbare Plugins gebruiken de `CMSAPI` class via `$this->api`. Deze biedt vergelijkbare methods:
methods:
```php ```php
$this->api->getCurrentPageTitle(); $this->api->getCurrentPageTitle();
@@ -197,10 +110,10 @@ $this->api->translate('home');
Daarnaast heeft de CMSAPI: Daarnaast heeft de CMSAPI:
- `getCurrentPage(): array` Volledige pagina data - `getCurrentPage(): array` - Volledige pagina data
- `getCurrentPageUrl(): string` URL van huidige pagina - `getCurrentPageUrl(): string` - URL van huidige pagina
- `getCurrentPageFileInfo(): ?array` Bestandsinfo (created, modified) - `getCurrentPageFileInfo(): ?array` - Bestandsinfo (created, modified)
- `getBreadcrumb(): string` Breadcrumb HTML - `getBreadcrumb(): string` - Breadcrumb HTML
- `executePhpFile(string $filePath): string` Voer PHP bestand uit en vang output op - `executePhpFile(string $filePath): string` - Voer PHP bestand uit en vang output op
- `getFileContent(string $filePath): string` Haal content uit PHP/HTML/Markdown bestand - `getFileContent(string $filePath): string` - Haal content uit PHP/HTML/Markdown bestand
- `contentFileExists(string $filename): bool` Controleer of bestand bestaat in content map - `contentFileExists(string $filename): bool` - Controleer of bestand bestaat in content map
-52
View File
@@ -88,29 +88,6 @@ return [
'col_size' => 'Größe', 'col_size' => 'Größe',
'col_modified' => 'Geändert', 'col_modified' => 'Geändert',
'col_actions' => 'Aktionen', 'col_actions' => 'Aktionen',
// Content editor (content-files) — Phase 1-5 der Content-Konsistenz TODO
'content_editor' => 'Content-Editor',
'content_files' => 'Content-Dateien',
'content_no_files' => 'Keine Dateien gefunden.',
'content_not_editable' => 'Dieser Dateityp kann im Editor nicht bearbeitet werden.',
'content_select_file' => 'Wählen Sie eine Datei oder einen Ordner aus der Seitenleiste.',
'content_file_path' => 'Dateipfad innerhalb von content',
'content_file_path_help' => 'Nur Buchstaben, Zahlen, Punkte, Unterstriche, Bindestriche und Schrägstriche. Unterordner werden automatisch erstellt. Die Erweiterung wird unten ausgewählt.',
'content_upload_help' => 'Dateien werden in content/ hochgeladen. Erlaubt: Bilder, Video, Audio, PDF, ZIP, Office-Dokumente, CSS, SCSS, JS, JSON, HTML, MD.',
'file_type' => 'Dateityp',
'list_view' => 'Listenansicht',
'tree_view' => 'Baumansicht',
'rename_folder' => 'Ordner umbenennen',
'rename_prefix' => 'Umbenennen',
'new_name' => 'Neuer Name',
'git_init' => 'Git init',
'git_init_confirm' => 'Git-Repository in content/ initialisieren?',
'git_commit' => 'Commit',
'git_commit_confirm' => 'Änderungen an git committen?',
'git_dirty' => 'nicht committete Änderungen',
'git_clean' => 'saubere Arbeitskopie',
'git_last_commit' => 'letzter Commit:',
'col_role' => 'Rolle', 'col_role' => 'Rolle',
'col_created' => 'Erstellt', 'col_created' => 'Erstellt',
'no_files_found' => 'Keine Dateien gefunden.', 'no_files_found' => 'Keine Dateien gefunden.',
@@ -120,11 +97,6 @@ return [
'no_filter_results' => 'Keine Ergebnisse für diesen Filter.', 'no_filter_results' => 'Keine Ergebnisse für diesen Filter.',
'new_folder_title' => 'Neuen Ordner erstellen', 'new_folder_title' => 'Neuen Ordner erstellen',
'folder_name' => 'Ordnername', 'folder_name' => 'Ordnername',
'folder_name_placeholder' => 'Ordnername',
'folder_rename_help' => 'Bearbeiten Sie den Ordnernamen und klicken Sie auf Speichern zum Umbenennen.',
'files' => 'Dateien',
'subfolders' => 'Unterordner',
'expand_collapse' => 'Ausklappen/Einklappen',
'name_help' => 'Nur Buchstaben, Zahlen, Punkte, Unterstriche und Bindestriche.', 'name_help' => 'Nur Buchstaben, Zahlen, Punkte, Unterstriche und Bindestriche.',
// Content edit / new // Content edit / new
@@ -133,8 +105,6 @@ return [
'visible_plugins' => 'Sichtbare Plugins', 'visible_plugins' => 'Sichtbare Plugins',
'new_page' => 'Neue Seite', 'new_page' => 'Neue Seite',
'file_type' => 'Dateityp', 'file_type' => 'Dateityp',
'created' => 'Erstellt',
'edited' => 'Bearbeitet',
// Content dir form // Content dir form
'rename_folder' => 'Ordner umbenennen', 'rename_folder' => 'Ordner umbenennen',
@@ -242,32 +212,10 @@ return [
'new_theme_title' => 'Neues Theme erstellen', 'new_theme_title' => 'Neues Theme erstellen',
'theme_name' => 'Theme-Name', 'theme_name' => 'Theme-Name',
'theme_name_help' => 'Nur Buchstaben, Zahlen, Unterstriche und Bindestriche.', 'theme_name_help' => 'Nur Buchstaben, Zahlen, Unterstriche und Bindestriche.',
'theme_base' => 'Basis-Theme',
'theme_base_help' => 'Wählen Sie ein bestehendes Theme als Basis zum Kopieren oder starten Sie mit einer leeren einheitlichen Struktur. css_compiled/ wird nicht kopiert.',
'theme_base_blank' => '(leere Struktur)',
'name_label' => 'Name: ', 'name_label' => 'Name: ',
'default_layout_label' => 'Standard-Layout: ', 'default_layout_label' => 'Standard-Layout: ',
'compile_scss' => 'SCSS kompilieren', 'compile_scss' => 'SCSS kompilieren',
'compile_scss_confirm' => 'SCSS kompilieren? Dies überschreibt assets/css_compiled/theme.css.',
'scss_ok' => 'aktuell',
'scss_stale' => 'veraltet',
'scss_compiled_ok' => 'SCSS ist kompiliert und aktuell',
'scss_needs_compile' => 'SCSS-Quelle neuer als kompiliertes CSS',
'no_themes' => 'Keine Themes gefunden.', 'no_themes' => 'Keine Themes gefunden.',
'theme_default_protected' => 'Default-Theme - kann nicht gelöscht werden',
'theme_layouts' => 'Layouts: ',
'theme_actions' => 'Theme-Aktionen',
'confirm_delete_theme' => 'Sind Sie sicher, dass Sie dieses Theme löschen möchten? Alle Dateien im Theme gehen verloren.',
'theme_edit' => 'Theme bearbeiten: ',
'theme_files' => 'Theme-Dateien',
'theme_no_files' => 'Keine Dateien gefunden.',
'theme_new_file' => 'Neue Datei',
'theme_new_file_title' => 'Neue Datei erstellen',
'theme_file_path' => 'Dateipfad innerhalb des Themes',
'theme_file_path_help' => 'Nur Buchstaben, Zahlen, Punkte, Unterstriche, Bindestriche und Schrägstriche. Unterordner werden automatisch erstellt. Erlaubt: twig, json, scss, css, js, html, md, php.',
'theme_not_editable' => 'Dieser Dateityp kann im Editor nicht bearbeitet werden.',
'theme_select_file' => 'Wählen Sie eine Datei aus der Seitenleiste zum Bearbeiten.',
'theme_upload_help' => 'Dateien werden in assets/ dieses Themes hochgeladen. Erlaubt: Bilder, Video, Audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, Fonts.',
// Update // Update
'system_update' => 'System-Update', 'system_update' => 'System-Update',
-51
View File
@@ -88,29 +88,6 @@ return [
'col_size' => 'Size', 'col_size' => 'Size',
'col_modified' => 'Modified', 'col_modified' => 'Modified',
'col_actions' => 'Actions', 'col_actions' => 'Actions',
// Content editor (content-files) — Phase 1-5 of content-consistency TODO
'content_editor' => 'Content editor',
'content_files' => 'Content files',
'content_no_files' => 'No files found.',
'content_not_editable' => 'This file type cannot be edited in the editor.',
'content_select_file' => 'Select a file or folder from the sidebar.',
'content_file_path' => 'File path within content',
'content_file_path_help' => 'Only letters, numbers, dots, underscores, dashes and slashes. Subfolders are created automatically. The extension is chosen below.',
'content_upload_help' => 'Files are uploaded to content/. Allowed: images, video, audio, PDF, ZIP, office docs, CSS, SCSS, JS, JSON, HTML, MD.',
'file_type' => 'File type',
'list_view' => 'List view',
'tree_view' => 'Tree view',
'rename_folder' => 'Rename folder',
'rename_prefix' => 'Rename',
'new_name' => 'New name',
'git_init' => 'Git init',
'git_init_confirm' => 'Initialize a git repository in content/?',
'git_commit' => 'Commit',
'git_commit_confirm' => 'Commit changes to git?',
'git_dirty' => 'uncommitted changes',
'git_clean' => 'clean working tree',
'git_last_commit' => 'last commit:',
'col_role' => 'Role', 'col_role' => 'Role',
'col_created' => 'Created', 'col_created' => 'Created',
'no_files_found' => 'No files found.', 'no_files_found' => 'No files found.',
@@ -120,11 +97,6 @@ return [
'no_filter_results' => 'No results for this filter.', 'no_filter_results' => 'No results for this filter.',
'new_folder_title' => 'Create new folder', 'new_folder_title' => 'Create new folder',
'folder_name' => 'Folder name', 'folder_name' => 'Folder name',
'folder_name_placeholder' => 'folder name',
'folder_rename_help' => 'Edit the folder name and click save to rename it.',
'files' => 'files',
'subfolders' => 'subfolders',
'expand_collapse' => 'Expand/collapse',
'name_help' => 'Only letters, numbers, dots, underscores and dashes.', 'name_help' => 'Only letters, numbers, dots, underscores and dashes.',
// Content edit / new // Content edit / new
@@ -240,32 +212,10 @@ return [
'new_theme_title' => 'Create new theme', 'new_theme_title' => 'Create new theme',
'theme_name' => 'Theme name', 'theme_name' => 'Theme name',
'theme_name_help' => 'Only letters, numbers, underscores and dashes.', 'theme_name_help' => 'Only letters, numbers, underscores and dashes.',
'theme_base' => 'Base theme',
'theme_base_help' => 'Choose an existing theme to copy as a base, or start with an empty uniform structure. css_compiled/ is not copied.',
'theme_base_blank' => '(empty structure)',
'name_label' => 'Name: ', 'name_label' => 'Name: ',
'default_layout_label' => 'Default layout: ', 'default_layout_label' => 'Default layout: ',
'compile_scss' => 'Compile SCSS', 'compile_scss' => 'Compile SCSS',
'compile_scss_confirm' => 'Compile SCSS? This overwrites assets/css_compiled/theme.css.',
'scss_ok' => 'up-to-date',
'scss_stale' => 'stale',
'scss_compiled_ok' => 'SCSS is compiled and up-to-date',
'scss_needs_compile' => 'SCSS source newer than compiled CSS',
'no_themes' => 'No themes found.', 'no_themes' => 'No themes found.',
'theme_default_protected' => 'Default theme - cannot be deleted',
'theme_layouts' => 'Layouts: ',
'theme_actions' => 'Theme actions',
'confirm_delete_theme' => 'Are you sure you want to delete this theme? All files in the theme will be lost.',
'theme_edit' => 'Edit theme: ',
'theme_files' => 'Theme files',
'theme_no_files' => 'No files found.',
'theme_new_file' => 'New file',
'theme_new_file_title' => 'Create new file',
'theme_file_path' => 'File path within theme',
'theme_file_path_help' => 'Only letters, numbers, dots, underscores, dashes and slashes. Subfolders are created automatically. Allowed: twig, json, scss, css, js, html, md, php.',
'theme_not_editable' => 'This file type cannot be edited in the editor.',
'theme_select_file' => 'Select a file from the sidebar to edit.',
'theme_upload_help' => 'Files are uploaded to assets/ of this theme. Allowed: images, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, fonts.',
// Update // Update
'system_update' => 'System Update', 'system_update' => 'System Update',
@@ -331,7 +281,6 @@ return [
'cannot_change_own_role' => 'You cannot change your own role.', 'cannot_change_own_role' => 'You cannot change your own role.',
'cannot_change_password_role' => 'Changing passwords is not allowed in this role.', 'cannot_change_password_role' => 'Changing passwords is not allowed in this role.',
'created' => 'Created', 'created' => 'Created',
'edited' => 'Edited',
// Plugin config // Plugin config
'plugin_settings' => 'Settings', 'plugin_settings' => 'Settings',
-53
View File
@@ -77,9 +77,7 @@ return [
// Content page // Content page
'upload' => 'Upload', 'upload' => 'Upload',
'new_folder' => 'Nieuwe map', 'new_folder' => 'Nieuwe map',
'new_folder_title' => 'Nieuwe map aanmaken',
'new_file' => 'Nieuw bestand', 'new_file' => 'Nieuw bestand',
'new_file_title' => 'Nieuw bestand aanmaken',
'select_files' => 'Bestanden selecteren', 'select_files' => 'Bestanden selecteren',
'allowed_types' => 'Toegestaan: JPG, PNG, GIF, WebP, SVG, PDF, ZIP, MP4, WebM, MP3, WAV', 'allowed_types' => 'Toegestaan: JPG, PNG, GIF, WebP, SVG, PDF, ZIP, MP4, WebM, MP3, WAV',
'upload_to_folder' => 'Uploaden naar deze map', 'upload_to_folder' => 'Uploaden naar deze map',
@@ -90,29 +88,6 @@ return [
'col_size' => 'Grootte', 'col_size' => 'Grootte',
'col_modified' => 'Gewijzigd', 'col_modified' => 'Gewijzigd',
'col_actions' => 'Acties', 'col_actions' => 'Acties',
// Content editor (content-files) — Fase 1-5 van content-consistentie TODO
'content_editor' => 'Content editor',
'content_files' => 'Content bestanden',
'content_no_files' => 'Geen bestanden gevonden.',
'content_not_editable' => 'Dit bestandstype kan niet in de editor bewerkt worden.',
'content_select_file' => 'Selecteer een bestand of map uit de zijbalk.',
'content_file_path' => 'Bestandspad binnen content',
'content_file_path_help' => 'Alleen letters, cijfers, punten, underscores, streepjes en slashes. Submappen worden automatisch aangemaakt. De extensie wordt hieronder gekozen.',
'content_upload_help' => 'Bestanden worden geüpload naar content/. Toegestaan: afbeeldingen, video, audio, PDF, ZIP, office docs, CSS, SCSS, JS, JSON, HTML, MD.',
'file_type' => 'Bestandstype',
'list_view' => 'Lijst weergave',
'tree_view' => 'Boom weergave',
'rename_folder' => 'Map hernoemen',
'rename_prefix' => 'Hernoem',
'new_name' => 'Nieuwe naam',
'git_init' => 'Git init',
'git_init_confirm' => 'Git repository initialiseren in content/?',
'git_commit' => 'Commit',
'git_commit_confirm' => 'Wijzigingen committen naar git?',
'git_dirty' => 'niet-committed wijzigingen',
'git_clean' => 'schone werkmap',
'git_last_commit' => 'laatste commit:',
'col_role' => 'Rol', 'col_role' => 'Rol',
'col_created' => 'Aangemaakt', 'col_created' => 'Aangemaakt',
'no_files_found' => 'Geen bestanden gevonden.', 'no_files_found' => 'Geen bestanden gevonden.',
@@ -122,11 +97,6 @@ return [
'no_filter_results' => 'Geen resultaten voor deze filter.', 'no_filter_results' => 'Geen resultaten voor deze filter.',
'new_folder_title' => 'Nieuwe map aanmaken', 'new_folder_title' => 'Nieuwe map aanmaken',
'folder_name' => 'Mapnaam', 'folder_name' => 'Mapnaam',
'folder_name_placeholder' => 'mapnaam',
'folder_rename_help' => 'Bewerk de mapnaam en klik op opslaan om te hernoemen.',
'files' => 'bestanden',
'subfolders' => 'submappen',
'expand_collapse' => 'Uitklappen/inklappen',
'name_help' => 'Alleen letters, cijfers, punten, underscores en streepjes.', 'name_help' => 'Alleen letters, cijfers, punten, underscores en streepjes.',
// Content edit / new // Content edit / new
@@ -242,32 +212,10 @@ return [
'new_theme_title' => 'Nieuw thema aanmaken', 'new_theme_title' => 'Nieuw thema aanmaken',
'theme_name' => 'Thema naam', 'theme_name' => 'Thema naam',
'theme_name_help' => 'Alleen letters, cijfers, underscores en streepjes.', 'theme_name_help' => 'Alleen letters, cijfers, underscores en streepjes.',
'theme_base' => 'Basis thema',
'theme_base_help' => 'Kies een bestaand thema als basis om te kopiëren, of start met een lege uniforme structuur. css_compiled/ wordt niet gekopieerd.',
'theme_base_blank' => '(lege structuur)',
'name_label' => 'Naam: ', 'name_label' => 'Naam: ',
'default_layout_label' => 'Default layout: ', 'default_layout_label' => 'Default layout: ',
'compile_scss' => 'SCSS compileren', 'compile_scss' => 'SCSS compileren',
'compile_scss_confirm' => 'SCSS compileren? Dit overschrijft assets/css_compiled/theme.css.',
'scss_ok' => 'up-to-date',
'scss_stale' => 'verouderd',
'scss_compiled_ok' => 'SCSS is gecompileerd en up-to-date',
'scss_needs_compile' => 'SCSS source nieuwer dan gecompileerde CSS',
'no_themes' => 'Geen thema\'s gevonden.', 'no_themes' => 'Geen thema\'s gevonden.',
'theme_default_protected' => 'Default thema - kan niet verwijderd worden',
'theme_layouts' => 'Layouts: ',
'theme_actions' => 'Thema acties',
'confirm_delete_theme' => 'Weet je zeker dat je dit thema wilt verwijderen? Alle bestanden in het thema gaan verloren.',
'theme_edit' => 'Thema bewerken: ',
'theme_files' => 'Thema bestanden',
'theme_no_files' => 'Geen bestanden gevonden.',
'theme_new_file' => 'Nieuw bestand',
'theme_new_file_title' => 'Nieuw bestand aanmaken',
'theme_file_path' => 'Bestandspad binnen thema',
'theme_file_path_help' => 'Alleen letters, cijfers, punten, underscores, streepjes en slashes. Submappen worden automatisch aangemaakt. Toegestaan: twig, json, scss, css, js, html, md, php.',
'theme_not_editable' => 'Dit bestandstype kan niet in de editor bewerkt worden.',
'theme_select_file' => 'Selecteer een bestand uit de zijbalk om te bewerken.',
'theme_upload_help' => 'Bestanden worden geüpload naar assets/ van dit thema. Toegestaan: afbeeldingen, video, audio, PDF, ZIP, CSS, SCSS, JS, JSON, HTML, MD, TWIG, fonts.',
// Update // Update
'system_update' => 'Systeem Update', 'system_update' => 'Systeem Update',
@@ -333,7 +281,6 @@ return [
'cannot_change_own_role' => 'Je kunt je eigen rol niet wijzigen.', 'cannot_change_own_role' => 'Je kunt je eigen rol niet wijzigen.',
'cannot_change_password_role' => 'Wachtwoord wijzigen is niet toegestaan in deze rol.', 'cannot_change_password_role' => 'Wachtwoord wijzigen is niet toegestaan in deze rol.',
'created' => 'Aangemaakt', 'created' => 'Aangemaakt',
'edited' => 'Bewerkt',
// Plugin config // Plugin config
'plugin_settings' => 'Instellingen', 'plugin_settings' => 'Instellingen',
-90
View File
@@ -1,41 +1,14 @@
<?php <?php
/**
* Dashboard plugin: toont CMS-, content- en plugin-overzicht in het beheer.
*
* Systeem-plugin die een overzichtspagina biedt met site-informatie,
* content-statistieken en een lijst van geïnstalleerde plugins.
*
* @since 2.6.5
*/
class Dashboard class Dashboard
{ {
/**
* Plugin-API instantie voor communicatie met de CMS-core.
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private ?PluginAPIInterface $api = null; private ?PluginAPIInterface $api = null;
/**
* Stelt de Plugin-API instantie in.
*
* @since 2.6.5
* @param PluginAPIInterface $api De Plugin-API instantie.
* @return void
*/
public function setAPI(PluginAPIInterface $api): void public function setAPI(PluginAPIInterface $api): void
{ {
$this->api = $api; $this->api = $api;
} }
/**
* Geeft de plugin-configuratie terug.
*
* @since 2.6.5
* @return array<string, mixed> Plugin-configuratie met title, viewable en type.
*/
public function getConfig(): array public function getConfig(): array
{ {
return [ return [
@@ -45,12 +18,6 @@ class Dashboard
]; ];
} }
/**
* Geeft de admin-menu-items voor deze plugin.
*
* @since 2.6.5
* @return array<int, array<string, mixed>> Lijst met admin-menu-item configuraties.
*/
public function getAdminMenu(): array public function getAdminMenu(): array
{ {
return [ return [
@@ -66,16 +33,6 @@ class Dashboard
]; ];
} }
/**
* Verwerkt een admin-route en toont het dashboard.
*
* Geeft een HTML-weergave van site-informatie, content-statistieken
* en een plugin-overzicht.
*
* @since 2.6.5
* @param string $action De uit te voeren actie.
* @return string|null De HTML-uitvoer van het dashboard, of null.
*/
public function handleAdminRoute(string $action): ?string public function handleAdminRoute(string $action): ?string
{ {
$siteConfig = $this->getSiteConfig(); $siteConfig = $this->getSiteConfig();
@@ -190,12 +147,6 @@ class Dashboard
return ob_get_clean(); return ob_get_clean();
} }
/**
* Haalt de site-configuratie op via de AdminPluginAPI.
*
* @since 2.6.5
* @return array<string, mixed> De site-configuratie, of een lege array.
*/
private function getSiteConfig(): array private function getSiteConfig(): array
{ {
if ($this->api === null) { if ($this->api === null) {
@@ -208,14 +159,6 @@ class Dashboard
return []; return [];
} }
/**
* Bepaalt het type (system of content) van een plugin door het hoofdbestand te lezen.
*
* @since 2.6.5
* @param string $pluginDir Pad naar de plugin-map.
* @param string $pluginName Naam van de plugin.
* @return string Het plugin-type ('system' of 'content').
*/
private function getPluginType(string $pluginDir, string $pluginName): string private function getPluginType(string $pluginDir, string $pluginName): string
{ {
$pluginFile = $pluginDir . '/' . $pluginName . '.php'; $pluginFile = $pluginDir . '/' . $pluginName . '.php';
@@ -230,16 +173,6 @@ class Dashboard
return 'content'; return 'content';
} }
/**
* Telt het aantal bestanden in een map, eventueel gefilterd op extensie.
*
* Slaat verborgen en met '-' voorafgegane bestanden en mappen over.
*
* @since 2.6.5
* @param string $dir Pad naar de map die doorzocht moet worden.
* @param string[] $extensions Optionele lijst van toegestane extensies.
* @return int Het aantal gevonden bestanden.
*/
private function countFiles(string $dir, array $extensions = []): int private function countFiles(string $dir, array $extensions = []): int
{ {
if (!is_dir($dir)) return 0; if (!is_dir($dir)) return 0;
@@ -264,15 +197,6 @@ class Dashboard
return $count; return $count;
} }
/**
* Telt het aantal submappen in een map, recursief.
*
* Slaat verborgen en met '-' voorafgegane mappen over.
*
* @since 2.6.5
* @param string $dir Pad naar de map die doorzocht moet worden.
* @return int Het aantal gevonden submappen.
*/
private function countDirs(string $dir): int private function countDirs(string $dir): int
{ {
if (!is_dir($dir)) return 0; if (!is_dir($dir)) return 0;
@@ -291,13 +215,6 @@ class Dashboard
return $count; return $count;
} }
/**
* Berekent de totale bestandsgrootte in bytes van alle bestanden in een map.
*
* @since 2.6.5
* @param string $dir Pad naar de map die doorzocht moet worden.
* @return int De totale grootte in bytes.
*/
private function dirSize(string $dir): int private function dirSize(string $dir): int
{ {
if (!is_dir($dir)) return 0; if (!is_dir($dir)) return 0;
@@ -313,13 +230,6 @@ class Dashboard
return $size; return $size;
} }
/**
* Formateert een byte-grootte naar een leesbare string met eenheid.
*
* @since 2.6.5
* @param int $bytes Het aantal bytes.
* @return string De geformatteerde grootte met eenheid (bijv. '1.5 MB').
*/
private function formatSize(int $bytes): string private function formatSize(int $bytes): string
{ {
if ($bytes <= 0) return '0 B'; if ($bytes <= 0) return '0 B';
+3 -42
View File
@@ -1,41 +1,14 @@
<?php <?php
/**
* GeoIPInfo plugin: toont geografische informatie op basis van IP-adres.
*
* Systeem-plugin die een admin-pagina biedt met het IP-adres van de bezoeker
* en het bijbehorende land via de GeoIP-dienst.
*
* @since 2.6.5
*/
class GeoIPInfo class GeoIPInfo
{ {
/**
* Plugin-API instantie voor communicatie met de CMS-core.
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private ?PluginAPIInterface $api = null; private ?PluginAPIInterface $api = null;
/**
* Stelt de Plugin-API instantie in.
*
* @since 2.6.5
* @param PluginAPIInterface $api De Plugin-API instantie.
* @return void
*/
public function setAPI(PluginAPIInterface $api): void public function setAPI(PluginAPIInterface $api): void
{ {
$this->api = $api; $this->api = $api;
} }
/**
* Geeft de plugin-configuratie terug.
*
* @since 2.6.5
* @return array<string, mixed> Plugin-configuratie met title en type.
*/
public function getConfig(): array public function getConfig(): array
{ {
return [ return [
@@ -45,10 +18,7 @@ class GeoIPInfo
} }
/** /**
* Geeft de admin-menu-items voor deze plugin terug. * Register admin menu items.
*
* @since 2.6.5
* @return array<int, array<string, mixed>> Lijst met admin-menu-item configuraties.
*/ */
public function getAdminMenu(): array public function getAdminMenu(): array
{ {
@@ -64,10 +34,7 @@ class GeoIPInfo
} }
/** /**
* Geeft de admin-routes terug die deze plugin afhandelt. * Register admin routes this plugin handles.
*
* @since 2.6.5
* @return array<int, string> Lijst met admin-route namen.
*/ */
public function getAdminRoutes(): array public function getAdminRoutes(): array
{ {
@@ -75,13 +42,7 @@ class GeoIPInfo
} }
/** /**
* Verwerkt een admin-route en toont de GeoIP-info-pagina. * Handle admin route — render the admin page.
*
* Bepaalt het IP-adres van de bezoeker en toont het land en de vlag.
*
* @since 2.6.5
* @param string $route De af te handelen admin-route.
* @return void
*/ */
public function handleAdminRoute(string $route): void public function handleAdminRoute(string $route): void
{ {
-55
View File
@@ -1,36 +1,10 @@
<?php <?php
/**
* HTMLBlock plugin: toont context-afhankelijke HTML-blokken in de zijbalk.
*
* Content-plugin die informatie over de huidige pagina toont,
* inclusief taal, homepage-status, bestandsinformatie en snelle navigatie.
*
* @since 2.6.5
*/
class HTMLBlock class HTMLBlock
{ {
/**
* Plugin-configuratie.
*
* @since 2.6.5
* @var array<string, mixed>
*/
private array $config; private array $config;
/**
* Plugin-API instantie voor communicatie met de CMS-core.
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private ?PluginAPIInterface $api = null; private ?PluginAPIInterface $api = null;
/**
* Initialiseert de plugin met standaardconfiguratie.
*
* @since 2.6.5
*/
public function __construct() public function __construct()
{ {
$this->config = [ $this->config = [
@@ -39,27 +13,11 @@ class HTMLBlock
]; ];
} }
/**
* Stelt de Plugin-API instantie in.
*
* @since 2.6.5
* @param PluginAPIInterface $api De Plugin-API instantie.
* @return void
*/
public function setAPI(PluginAPIInterface $api): void public function setAPI(PluginAPIInterface $api): void
{ {
$this->api = $api; $this->api = $api;
} }
/**
* Genereert de HTML-inhoud voor de zijbalk.
*
* Toont informatie over de huidige pagina, taal, homepage-status,
* bestandsinformatie en een snelle navigatielijst.
*
* @since 2.6.5
* @return string De opgebouwde HTML voor de zijbalk.
*/
public function getSidebarContent(): string public function getSidebarContent(): string
{ {
// Content plugin: translations follow the current content language. // Content plugin: translations follow the current content language.
@@ -131,24 +89,11 @@ class HTMLBlock
return $content; return $content;
} }
/**
* Geeft de plugin-configuratie terug.
*
* @since 2.6.5
* @return array<string, mixed> Plugin-configuratie.
*/
public function getConfig(): array public function getConfig(): array
{ {
return $this->config; return $this->config;
} }
/**
* Stelt de plugin-configuratie in door deze te mergen met standaardwaarden.
*
* @since 2.6.5
* @param array<string, mixed> $config De configuratie die samengevoegd moet worden.
* @return void
*/
public function setConfig(array $config): void public function setConfig(array $config): void
{ {
$this->config = array_merge($this->config, $config); $this->config = array_merge($this->config, $config);
+2 -50
View File
@@ -1,41 +1,14 @@
<?php <?php
/**
* Logs plugin: toont admin- en request-logs in het beheer.
*
* Systeem-plugin die logbestanden uitleest en in een tabel toont,
* met tabbladen voor admin-logs en request-logs.
*
* @since 2.6.5
*/
class Logs class Logs
{ {
/**
* Plugin-API instantie voor communicatie met de CMS-core.
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private ?PluginAPIInterface $api = null; private ?PluginAPIInterface $api = null;
/**
* Stelt de Plugin-API instantie in.
*
* @since 2.6.5
* @param PluginAPIInterface $api De Plugin-API instantie.
* @return void
*/
public function setAPI(PluginAPIInterface $api): void public function setAPI(PluginAPIInterface $api): void
{ {
$this->api = $api; $this->api = $api;
} }
/**
* Geeft de plugin-configuratie terug.
*
* @since 2.6.5
* @return array<string, mixed> Plugin-configuratie met title, viewable en type.
*/
public function getConfig(): array public function getConfig(): array
{ {
return [ return [
@@ -45,12 +18,6 @@ class Logs
]; ];
} }
/**
* Geeft de admin-menu-items voor deze plugin terug.
*
* @since 2.6.5
* @return array<int, array<string, mixed>> Lijst met admin-menu-item configuraties.
*/
public function getAdminMenu(): array public function getAdminMenu(): array
{ {
$config = $this->getPluginConfig(); $config = $this->getPluginConfig();
@@ -71,12 +38,7 @@ class Logs
} }
/** /**
* Haalt de runtime-configuratie van deze plugin op (standaardwaarden plus overrides). * Get this plugin's runtime config (defaults + overrides).
*
* Leest standaardwaarden uit plugin.json en overschrijft deze met config.json.
*
* @since 2.6.5
* @return array<string, mixed> De samengevoegde plugin-configuratie.
*/ */
private function getPluginConfig(): array private function getPluginConfig(): array
{ {
@@ -102,16 +64,6 @@ class Logs
return array_merge($defaults, $overrides); return array_merge($defaults, $overrides);
} }
/**
* Verwerkt een admin-route en toont de logs-pagina.
*
* Leest de geselecteerde log, parset de regels en toont deze in een tabel
* met tabbladen voor admin- en request-logs.
*
* @since 2.6.5
* @param string $action De uit te voeren actie.
* @return string|null De HTML-uitvoer van de logs-pagina, of null.
*/
public function handleAdminRoute(string $action): ?string public function handleAdminRoute(string $action): ?string
{ {
$config = $this->getPluginConfig(); $config = $this->getPluginConfig();
@@ -126,7 +78,7 @@ class Logs
}; };
$tab = $_GET['tab'] ?? 'admin'; $tab = $_GET['tab'] ?? 'admin';
$logDir = ($this->api ? $this->api->getProjectRoot() : dirname(__DIR__, 2)) . '/admin/storage/logs'; $logDir = dirname(__DIR__, 2) . '/admin/storage/logs';
$logFile = $tab === 'requests' ? $logDir . '/requests.log' : $logDir . '/admin.log'; $logFile = $tab === 'requests' ? $logDir . '/requests.log' : $logDir . '/admin.log';
$logs = []; $logs = [];
+24 -118
View File
@@ -1,36 +1,10 @@
<?php <?php
/**
* Navigation plugin: bouwt zijbalk-navigatie voor content en guide.
*
* Content-plugin die de navigatie opbouwt op basis van de mappenstructuur,
* met ondersteuning voor guide-pagina's en reguliere content-pagina's.
*
* @since 2.6.5
*/
class Navigation class Navigation
{ {
/**
* Plugin-configuratie.
*
* @since 2.6.5
* @var array<string, mixed>
*/
private array $config; private array $config;
/**
* Plugin-API instantie voor communicatie met de CMS-core.
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private ?PluginAPIInterface $api = null; private ?PluginAPIInterface $api = null;
/**
* Initialiseert de plugin met standaardconfiguratie.
*
* @since 2.6.5
*/
public function __construct() public function __construct()
{ {
$this->config = [ $this->config = [
@@ -40,46 +14,23 @@ class Navigation
]; ];
} }
/**
* Stelt de Plugin-API instantie in.
*
* @since 2.6.5
* @param PluginAPIInterface $api De Plugin-API instantie.
* @return void
*/
public function setAPI(PluginAPIInterface $api): void public function setAPI(PluginAPIInterface $api): void
{ {
$this->api = $api; $this->api = $api;
} }
/**
* Geeft de plugin-configuratie terug.
*
* @since 2.6.5
* @return array<string, mixed> Plugin-configuratie.
*/
public function getConfig(): array public function getConfig(): array
{ {
return $this->config; return $this->config;
} }
/**
* Stelt de plugin-configuratie in door deze te mergen met standaardwaarden.
*
* @since 2.6.5
* @param array<string, mixed> $config De configuratie die samengevoegd moet worden.
* @return void
*/
public function setConfig(array $config): void public function setConfig(array $config): void
{ {
$this->config = array_merge($this->config, $config); $this->config = array_merge($this->config, $config);
} }
/** /**
* Geeft het pad naar het CSS-bestand van deze plugin (relatief ten opzichte van de webroot). * Get the path to this plugin's CSS file (relative to web root).
*
* @since 2.6.5
* @return string Het CSS-URL-pad.
*/ */
public function getCssUrl(): string public function getCssUrl(): string
{ {
@@ -87,13 +38,8 @@ class Navigation
} }
/** /**
* Genereert de zijbalk-navigatie. * Generate sidebar navigation.
* * Detects whether we're on a guide page or content page and builds nav accordingly.
* Detecteert of het om een guide-pagina of een content-pagina gaat en
* bouwt de navigatie dienovereenkomstig op.
*
* @since 2.6.5
* @return string De HTML-navigatie, of een lege string in admin-context.
*/ */
public function getSidebarContent(): string public function getSidebarContent(): string
{ {
@@ -115,17 +61,11 @@ class Navigation
} }
/** /**
* Bouwt de navigatie voor de guide-sectie. * Build navigation for the guide section.
*
* @since 2.6.5
* @param string $lang De huidige taalcode.
* @param string $currentPage De huidige pagina-pad.
* @param bool $isAdmin Of dit in admin-context is.
* @return string De opgebouwde HTML-navigatie, of een lege string.
*/ */
private function buildGuideNav(string $lang, string $currentPage, bool $isAdmin): string private function buildGuideNav(string $lang, string $currentPage, bool $isAdmin): string
{ {
$guideRoot = ($this->api ? $this->api->getProjectRoot() : dirname(__DIR__, 2)) . '/guide/' . $lang; $guideRoot = dirname(__DIR__, 2) . '/guide/' . $lang;
if (!is_dir($guideRoot)) { if (!is_dir($guideRoot)) {
return ''; return '';
} }
@@ -139,16 +79,11 @@ class Navigation
} }
/** /**
* Bouwt de navigatie voor de content-sectie. * Build navigation for the content section.
*
* @since 2.6.5
* @param string $lang De huidige taalcode.
* @param string $currentPage De huidige pagina-pad.
* @return string De opgebouwde HTML-navigatie, of een lege string.
*/ */
private function buildContentNav(string $lang, string $currentPage): string private function buildContentNav(string $lang, string $currentPage): string
{ {
$contentRoot = $this->api ? $this->api->getContentDir() : dirname(__DIR__, 2) . '/content'; $contentRoot = dirname(__DIR__, 2) . '/content';
if (!is_dir($contentRoot)) { if (!is_dir($contentRoot)) {
return ''; return '';
} }
@@ -160,17 +95,15 @@ class Navigation
} }
/** /**
* Bouwt recursief navigatie op vanuit een mapstructuur. * Recursively build navigation from a directory structure.
* *
* @since 2.6.5 * @param string $dir Current directory
* @param string $dir Huidige map. * @param string $relPath Relative path from root
* @param string $relPath Relatief pad vanaf de root. * @param string $currentPage Current page path
* @param string $currentPage Huidige pagina-pad. * @param bool $isAdmin Whether this is admin context
* @param bool $isAdmin Of dit in admin-context is. * @param string $mode 'guide' or 'content'
* @param string $mode Modus: 'guide' of 'content'. * @param string $lang Current language
* @param string $lang Huidige taalcode. * @param int $depth Nesting depth (0 = top level)
* @param int $depth Nesting-diepte (0 = topniveau). Standaard 0.
* @return string De opgebouwde HTML-navigatie.
*/ */
private function buildNav(string $dir, string $relPath, string $currentPage, bool $isAdmin, string $mode, string $lang, int $depth = 0): string private function buildNav(string $dir, string $relPath, string $currentPage, bool $isAdmin, string $mode, string $lang, int $depth = 0): string
{ {
@@ -255,14 +188,7 @@ class Navigation
} }
/** /**
* Bouwt de URL voor een pagina-referentie. * Build the URL for a page.
*
* @since 2.6.5
* @param string $pageRef De pagina-referentie.
* @param string $lang De huidige taalcode.
* @param bool $isAdmin Of dit in admin-context is.
* @param string $mode Modus: 'guide' of 'content'.
* @return string De opgebouwde URL.
*/ */
private function buildUrl(string $pageRef, string $lang, bool $isAdmin, string $mode): string private function buildUrl(string $pageRef, string $lang, bool $isAdmin, string $mode): string
{ {
@@ -277,13 +203,7 @@ class Navigation
} }
/** /**
* Controleert of een navigatie-item de huidige pagina is. * Check if a nav item is the current page.
*
* @since 2.6.5
* @param string $pageRef De pagina-referentie van het item.
* @param string $currentPage Het huidige pagina-pad.
* @param string $mode Modus: 'guide' of 'content'.
* @return bool True als het item actief is, anders false.
*/ */
private function isActive(string $pageRef, string $currentPage, string $mode): bool private function isActive(string $pageRef, string $currentPage, string $mode): bool
{ {
@@ -295,10 +215,7 @@ class Navigation
} }
/** /**
* Geeft de beschikbare taalcodes terug. * Get available language codes.
*
* @since 2.6.5
* @return array<int, string> Lijst met taalcodes.
*/ */
private function getLanguageCodes(): array private function getLanguageCodes(): array
{ {
@@ -306,11 +223,7 @@ class Navigation
} }
/** /**
* Formateert een slug naar een leesbare titel. * Format a slug into a readable title.
*
* @since 2.6.5
* @param string $slug De te formatteren slug.
* @return string De geformatteerde titel.
*/ */
private function formatTitle(string $slug): string private function formatTitle(string $slug): string
{ {
@@ -320,13 +233,8 @@ class Navigation
} }
/** /**
* Haalt de H1-titel uit een markdown-, PHP- of HTML-bestand. * Extract the H1 title from a markdown/PHP/HTML file.
* * Falls back to formatTitle() if no H1 is found.
* Valt terug op formatTitle() wanneer geen H1 gevonden is.
*
* @since 2.6.5
* @param string $filePath Pad naar het bestand.
* @return string De gevonden titel, of een lege string.
*/ */
private function getTitleFromFile(string $filePath): string private function getTitleFromFile(string $filePath): string
{ {
@@ -345,12 +253,10 @@ class Navigation
} }
/** /**
* Rendert de navigatie-items als HTML. * Render the navigation items as HTML.
* *
* @since 2.6.5 * @param array $items Navigation items
* @param array $items Navigatie-items. * @param int $depth Nesting depth (0 = top level)
* @param int $depth Nesting-diepte (0 = topniveau). Standaard 0.
* @return string De gegenereerde HTML.
*/ */
private function renderNav(array $items, int $depth = 0): string private function renderNav(array $items, int $depth = 0): string
{ {
+1 -55
View File
@@ -1,41 +1,14 @@
<?php <?php
/**
* Statistics plugin: toont analytics-statistieken in het beheer.
*
* Systeem-plugin die analytics-gegevens toont, zoals totaal aantal views,
* unieke bezoekers, landen en top-pagina's.
*
* @since 2.6.5
*/
class Statistics class Statistics
{ {
/**
* Plugin-API instantie voor communicatie met de CMS-core.
*
* @since 2.6.5
* @var PluginAPIInterface|null
*/
private ?PluginAPIInterface $api = null; private ?PluginAPIInterface $api = null;
/**
* Stelt de Plugin-API instantie in.
*
* @since 2.6.5
* @param PluginAPIInterface $api De Plugin-API instantie.
* @return void
*/
public function setAPI(PluginAPIInterface $api): void public function setAPI(PluginAPIInterface $api): void
{ {
$this->api = $api; $this->api = $api;
} }
/**
* Geeft de plugin-configuratie terug.
*
* @since 2.6.5
* @return array<string, mixed> Plugin-configuratie met title, viewable en type.
*/
public function getConfig(): array public function getConfig(): array
{ {
return [ return [
@@ -45,12 +18,6 @@ class Statistics
]; ];
} }
/**
* Geeft de admin-menu-items voor deze plugin terug.
*
* @since 2.6.5
* @return array<int, array<string, mixed>> Lijst met admin-menu-item configuraties.
*/
public function getAdminMenu(): array public function getAdminMenu(): array
{ {
$config = $this->getPluginConfig(); $config = $this->getPluginConfig();
@@ -71,12 +38,7 @@ class Statistics
} }
/** /**
* Haalt de runtime-configuratie van deze plugin op (standaardwaarden plus overrides). * Get this plugin's runtime config (defaults + overrides).
*
* Leest standaardwaarden uit plugin.json en overschrijft deze met config.json.
*
* @since 2.6.5
* @return array<string, mixed> De samengevoegde plugin-configuratie.
*/ */
private function getPluginConfig(): array private function getPluginConfig(): array
{ {
@@ -102,16 +64,6 @@ class Statistics
return array_merge($defaults, $overrides); return array_merge($defaults, $overrides);
} }
/**
* Verwerkt een admin-route en toont de statistieken-pagina.
*
* Toont analytics-gegevens zoals views, unieke bezoekers, landen en
* top-pagina's, mits analytics ingeschakeld is.
*
* @since 2.6.5
* @param string $action De uit te voeren actie.
* @return string|null De HTML-uitvoer van de statistieken-pagina, of null.
*/
public function handleAdminRoute(string $action): ?string public function handleAdminRoute(string $action): ?string
{ {
// System plugin: translations resolve against the admin language. // System plugin: translations resolve against the admin language.
@@ -230,12 +182,6 @@ class Statistics
return ob_get_clean(); return ob_get_clean();
} }
/**
* Haalt de Analytics-instantie op basis van de analytics-configuratie.
*
* @since 2.6.5
* @return Analytics|null De Analytics-instantie, of null als analytics uitgeschakeld is.
*/
private function getAnalytics(): ?Analytics private function getAnalytics(): ?Analytics
{ {
if ($this->api === null) { if ($this->api === null) {
+139 -3557
View File
File diff suppressed because it is too large Load Diff
-35
View File
@@ -1,16 +1,4 @@
<?php <?php
/**
* Asset-server voor productie: serveert statische bestanden uit themes/,
* admin/theme/ en plugins/.
*
* Dit bestand wordt op productie gebruikt wanneer de PHP-dev-router niet
* beschikbaar is. public/.htaccess herschrijft /themes/, /admin/assets/ en
* /plugins/ URLs naar dit bestand. Paden worden via realpath() + prefix-
* check afgedwongen binnen de juiste asset-map om path traversal te voorkomen.
*
* @since 2.6.5
* @package CodePress
*/
/** /**
* Asset server - serves static files from themes/, admin/theme/, and plugins/ * Asset server - serves static files from themes/, admin/theme/, and plugins/
* This file is used on production servers where the PHP router is not available. * This file is used on production servers where the PHP router is not available.
@@ -37,11 +25,6 @@ $mimeTypes = [
// Determine which asset directory to serve from // Determine which asset directory to serve from
$assetFile = null; $assetFile = null;
/**
* /themes/<naam>/assets/...: theme-asset matchen en pad oplossen.
*
* @since 2.6.5
*/
// /themes/<name>/assets/... // /themes/<name>/assets/...
if (preg_match('#^/themes/([^/]+)/assets/(.+)$#', $path, $m)) { if (preg_match('#^/themes/([^/]+)/assets/(.+)$#', $path, $m)) {
$themeName = $m[1]; $themeName = $m[1];
@@ -49,22 +32,12 @@ if (preg_match('#^/themes/([^/]+)/assets/(.+)$#', $path, $m)) {
$assetFile = $basePath . '/themes/' . $themeName . '/assets/' . $assetRel; $assetFile = $basePath . '/themes/' . $themeName . '/assets/' . $assetRel;
$realBase = realpath($basePath . '/themes/' . $themeName . '/assets'); $realBase = realpath($basePath . '/themes/' . $themeName . '/assets');
} }
/**
* /admin/assets/...: admin-theme-asset matchen (default admin theme).
*
* @since 2.6.5
*/
// /admin/assets/... // /admin/assets/...
elseif (preg_match('#^/admin/assets/(.+)$#', $path, $m)) { elseif (preg_match('#^/admin/assets/(.+)$#', $path, $m)) {
$assetRel = $m[1]; $assetRel = $m[1];
$assetFile = $basePath . '/admin/theme/default/assets/' . $assetRel; $assetFile = $basePath . '/admin/theme/default/assets/' . $assetRel;
$realBase = realpath($basePath . '/admin/theme/default/assets'); $realBase = realpath($basePath . '/admin/theme/default/assets');
} }
/**
* /plugins/<naam>/assets/...: plugin-asset matchen en pad oplossen.
*
* @since 2.6.5
*/
// /plugins/<name>/assets/... // /plugins/<name>/assets/...
elseif (preg_match('#^/plugins/([^/]+)/assets/(.+)$#', $path, $m)) { elseif (preg_match('#^/plugins/([^/]+)/assets/(.+)$#', $path, $m)) {
$pluginName = $m[1]; $pluginName = $m[1];
@@ -73,14 +46,6 @@ elseif (preg_match('#^/plugins/([^/]+)/assets/(.+)$#', $path, $m)) {
$realBase = realpath($basePath . '/plugins/' . $pluginName . '/assets'); $realBase = realpath($basePath . '/plugins/' . $pluginName . '/assets');
} }
/**
* Matchende asset uitleveren met juiste MIME en cache-headers.
*
* Controleert dat het opgeloste pad binnen de asset-map blijft en een
* regulier bestand is; anders volgt een 404.
*
* @since 2.6.5
*/
if ($assetFile && $realBase) { if ($assetFile && $realBase) {
$realFile = realpath($assetFile); $realFile = realpath($assetFile);
if ($realFile && strpos($realFile, $realBase) === 0 && is_file($realFile)) { if ($realFile && strpos($realFile, $realBase) === 0 && is_file($realFile)) {
+7 -102
View File
@@ -1,33 +1,12 @@
<?php <?php
/**
* Front-end entry point van CodePress CMS.
*
* Bootstrap de CMS-core, laadt de configuratie, stuurt security headers uit,
* serveert media-/asset-/robots-requests, voert BotGuard- en rate-limit-
* controles uit, registreert analytics- en logvermeldingen en render
* uiteindelijk de pagina via CodePressCMS::render().
*
* @since 2.6.5
* @package CodePress
*/
require_once __DIR__ . '/../cms/core/index.php'; require_once __DIR__ . '/../cms/core/index.php';
$config = include __DIR__ . '/../cms/core/config.php'; $config = include __DIR__ . '/../cms/core/config.php';
/**
* Log-systeem initialiseren op basis van de logging-configuratie.
*
* @since 2.6.5
*/
// Initialize dynamic logging // Initialize dynamic logging
LogManager::init($config['logging'] ?? []); LogManager::init($config['logging'] ?? []);
/**
* Security headers instellen voor alle front-end responses.
*
* @since 2.6.5
*/
// Security headers // Security headers
header('X-Content-Type-Options: nosniff'); header('X-Content-Type-Options: nosniff');
header('X-Frame-Options: SAMEORIGIN'); header('X-Frame-Options: SAMEORIGIN');
@@ -36,15 +15,6 @@ header('Referrer-Policy: strict-origin-when-cross-origin');
header('Content-Security-Policy: default-src \'self\'; script-src \'self\' \'unsafe-inline\'; style-src \'self\' \'unsafe-inline\'; img-src \'self\' data:; font-src \'self\';'); header('Content-Security-Policy: default-src \'self\'; script-src \'self\' \'unsafe-inline\'; style-src \'self\' \'unsafe-inline\'; img-src \'self\' data:; font-src \'self\';');
header_remove('X-Powered-By'); header_remove('X-Powered-By');
/**
* Media- en asset-serving via /-media/ en /-assets/ routes.
*
* Bepaalt het verzoekpad en de toegestane MIME-types, resolveert de
* content-map dynamisch op basis van config['content_dir'] en serveert
* bestanden buiten public/ met een pad-controle om traversal te blokkeren.
*
* @since 2.6.5
*/
// Serve media files from any content/ subdirectory via /-media/ // Serve media files from any content/ subdirectory via /-media/
// Serve files from content/-assets/ via /-assets/ (backward compatible) // Serve files from content/-assets/ via /-assets/ (backward compatible)
$requestUri = $_SERVER['REQUEST_URI'] ?? ''; $requestUri = $_SERVER['REQUEST_URI'] ?? '';
@@ -61,15 +31,11 @@ $mimeTypes = [
'css' => 'text/css', 'js' => 'application/javascript', 'css' => 'text/css', 'js' => 'application/javascript',
]; ];
// Resolve the content directory once (absolute, from config) so media
// serving follows a customised content_dir instead of a hardcoded path.
$contentBase = realpath($config['content_dir']);
$contentBase = $contentBase !== false ? $contentBase : rtrim($config['content_dir'], '/');
if (strpos($path, '/-media/') === 0) { if (strpos($path, '/-media/') === 0) {
$relative = ltrim(substr($path, 7), '/'); $relative = ltrim(substr($path, 7), '/');
$filePath = $contentBase . '/' . $relative; $root = realpath(__DIR__ . '/..');
if ($contentBase !== '' && strpos($filePath, $contentBase) === 0) { $filePath = $root . '/content/' . $relative;
if (strpos($filePath, $root . '/content') === 0) {
$ext = strtolower(pathinfo($filePath, PATHINFO_EXTENSION)); $ext = strtolower(pathinfo($filePath, PATHINFO_EXTENSION));
if (in_array($ext, $allowedExt) && file_exists($filePath) && !is_dir($filePath)) { if (in_array($ext, $allowedExt) && file_exists($filePath) && !is_dir($filePath)) {
if (isset($mimeTypes[$ext])) { if (isset($mimeTypes[$ext])) {
@@ -84,23 +50,18 @@ if (strpos($path, '/-media/') === 0) {
exit; exit;
} }
/**
* /-assets/ route: serveert bestanden uit content/-assets/ of de content-
* root, met backward-compatibiliteit en path-traversal-controle.
*
* @since 2.6.5
*/
if (strpos($path, '/-assets/') === 0) { if (strpos($path, '/-assets/') === 0) {
$relative = ltrim(substr($path, 8), '/'); $relative = ltrim(substr($path, 8), '/');
$root = realpath(__DIR__ . '/..');
$servePath = null; $servePath = null;
$candidates = [ $candidates = [
$contentBase . '/-assets/' . $relative, $root . '/content/-assets/' . $relative,
$contentBase . '/' . $relative, $root . '/content/' . $relative,
]; ];
foreach ($candidates as $candidate) { foreach ($candidates as $candidate) {
if ($contentBase === '' || strpos($candidate, $contentBase) !== 0) continue; if (strpos($candidate, $root . '/content') !== 0) continue;
if (file_exists($candidate) && !is_dir($candidate)) { if (file_exists($candidate) && !is_dir($candidate)) {
$ext = strtolower(pathinfo($candidate, PATHINFO_EXTENSION)); $ext = strtolower(pathinfo($candidate, PATHINFO_EXTENSION));
if (in_array($ext, $allowedExt)) { if (in_array($ext, $allowedExt)) {
@@ -131,13 +92,6 @@ if ($path === '/robots.txt') {
exit; exit;
} }
/**
* Directe toegang tot /content/ blokkeren.
*
* Voorkomt dat ruwe content-bestanden via het web opgevraagd worden.
*
* @since 2.6.5
*/
// Block direct access to content files // Block direct access to content files
if (strpos($path, '/content/') === 0) { if (strpos($path, '/content/') === 0) {
http_response_code(403); http_response_code(403);
@@ -145,16 +99,6 @@ if (strpos($path, '/content/') === 0) {
exit; exit;
} }
/**
* Security-checks en rate limiting uitvoeren.
*
* Bepaalt client-IP, BotGuard-controle, IP-blocklist en rate-limiter op
* basis van de security-config. IP's op de allowed/uitgesloten lijsten
* slaan de controles over. Het requestStatus wordt bijgehouden voor
* latere logging en blocking.
*
* @since 2.6.5
*/
// Load RequestLogger for IP & request logging // Load RequestLogger for IP & request logging
require_once __DIR__ . '/../cms/core/class/RequestLogger.php'; require_once __DIR__ . '/../cms/core/class/RequestLogger.php';
@@ -205,22 +149,9 @@ if (!$isAllowedIp) {
} }
} }
/**
* CMS-instantie aanmaken met de geladen configuratie.
*
* @since 2.6.5
*/
// Instantiate CMS instance // Instantiate CMS instance
$cms = new CodePressCMS($config); $cms = new CodePressCMS($config);
/**
* Analytics en GeoIP-lookup uitvoeren.
*
* Land, IP-anonimisatie en analytics-instellingen worden bepaald op basis
* van de analytics-configuratie.
*
* @since 2.6.5
*/
// Analytics & GeoIP settings // Analytics & GeoIP settings
$analyticsSettings = $config['analytics'] ?? []; $analyticsSettings = $config['analytics'] ?? [];
$geoCountry = null; $geoCountry = null;
@@ -229,25 +160,11 @@ if (!empty($analyticsSettings['enabled'])) {
$geoCountry = $geoIp->lookupCountry($clientIp); $geoCountry = $geoIp->lookupCountry($clientIp);
} }
/**
* IP-anonimisatie toepassen voor opslag indien ingeschakeld.
*
* @since 2.6.5
*/
// Apply IP anonymization for storage if enabled // Apply IP anonymization for storage if enabled
$storedIp = !empty($analyticsSettings['anonymize_ip']) $storedIp = !empty($analyticsSettings['anonymize_ip'])
? RequestLogger::anonymizeIp($clientIp) ? RequestLogger::anonymizeIp($clientIp)
: $clientIp; : $clientIp;
/**
* Pagina-view loggen (niet voor media-/assets-requests).
*
* Start sessie indien nodig, stelt huidige pagina/referrer vast, schrijft
* een request-logregel, vuurt een LogManager-requestevent en registreert
* geaggregeerde analytics (mits ingeschakeld en IP niet uitgesloten).
*
* @since 2.6.5
*/
// Log page view (not for media/assets) // Log page view (not for media/assets)
if (!str_starts_with($path, '/-media/') && !str_starts_with($path, '/-assets/')) { if (!str_starts_with($path, '/-media/') && !str_starts_with($path, '/-assets/')) {
if (session_status() === PHP_SESSION_NONE) { if (session_status() === PHP_SESSION_NONE) {
@@ -286,13 +203,6 @@ if (!str_starts_with($path, '/-media/') && !str_starts_with($path, '/-assets/'))
} }
} }
/**
* Geblokkeerde verzoeken afhandelen.
*
* Geeft 429 bij rate-limit en 403 bij andere blokkades, met noindex-headers.
*
* @since 2.6.5
*/
// Block request if status is not ok // Block request if status is not ok
if ($requestStatus !== 'ok') { if ($requestStatus !== 'ok') {
if ($requestStatus === 'blocked:ratelimit') { if ($requestStatus === 'blocked:ratelimit') {
@@ -306,9 +216,4 @@ if ($requestStatus !== 'ok') {
exit; exit;
} }
/**
* Pagina renderen via de CodePressCMS-instantie.
*
* @since 2.6.5
*/
$cms->render(); $cms->render();
+18 -2
View File
@@ -38,6 +38,11 @@ class InstalledVersions
*/ */
private static $installed; private static $installed;
/**
* @var bool
*/
private static $installedIsLocalDir;
/** /**
* @var bool|null * @var bool|null
*/ */
@@ -315,6 +320,12 @@ class InstalledVersions
{ {
self::$installed = $data; self::$installed = $data;
self::$installedByVendor = array(); self::$installedByVendor = array();
// when using reload, we disable the duplicate protection to ensure that self::$installed data is
// always returned, but we cannot know whether it comes from the installed.php in __DIR__ or not,
// so we have to assume it does not, and that may result in duplicate data being returned when listing
// all installed packages for example
self::$installedIsLocalDir = false;
} }
/** /**
@@ -343,7 +354,9 @@ class InstalledVersions
$copiedLocalDir = false; $copiedLocalDir = false;
if (self::$canGetVendors) { if (self::$canGetVendors) {
$selfDir = self::getSelfDir();
foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) { foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
$vendorDir = strtr($vendorDir, '\\', '/');
if (isset(self::$installedByVendor[$vendorDir])) { if (isset(self::$installedByVendor[$vendorDir])) {
$installed[] = self::$installedByVendor[$vendorDir]; $installed[] = self::$installedByVendor[$vendorDir];
} elseif (is_file($vendorDir.'/composer/installed.php')) { } elseif (is_file($vendorDir.'/composer/installed.php')) {
@@ -351,11 +364,14 @@ class InstalledVersions
$required = require $vendorDir.'/composer/installed.php'; $required = require $vendorDir.'/composer/installed.php';
self::$installedByVendor[$vendorDir] = $required; self::$installedByVendor[$vendorDir] = $required;
$installed[] = $required; $installed[] = $required;
if (strtr($vendorDir.'/composer', '\\', '/') === strtr(__DIR__, '\\', '/')) { if (self::$installed === null && $vendorDir.'/composer' === $selfDir) {
self::$installed = $required; self::$installed = $required;
$copiedLocalDir = true; self::$installedIsLocalDir = true;
} }
} }
if (self::$installedIsLocalDir && $vendorDir.'/composer' === $selfDir) {
$copiedLocalDir = true;
}
} }
} }
+2
View File
@@ -1,3 +1,4 @@
Copyright (c) Nils Adermann, Jordi Boggiano Copyright (c) Nils Adermann, Jordi Boggiano
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -17,3 +18,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE. THE SOFTWARE.
+2 -3
View File
@@ -19,8 +19,7 @@ if ($issues) {
echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL; echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL;
} }
} }
trigger_error( throw new \RuntimeException(
'Composer detected issues in your platform: ' . implode(' ', $issues), 'Composer detected issues in your platform: ' . implode(' ', $issues)
E_USER_ERROR
); );
} }
+2 -13
View File
@@ -1,22 +1,11 @@
<?php <?php
/**
* Versie-informatie voor CodePress CMS.
*
* Returnt een array met de huidige versie, releasedatum, codenaam, status,
* systeemvereisten (PHP-versie en -extensies) en credits (auteur, licentie,
* repository en contact). Wordt door de rest van het CMS gebruikt om de
* versie te tonen en vereisten te valideren.
*
* @since 2.6.5
* @package CodePress
*/
/** /**
* CodePress CMS Version Information * CodePress CMS Version Information
*/ */
return [ return [
'version' => '2.6.5', 'version' => '2.6.1d',
'release_date' => '2026-08-26', 'release_date' => '2026-08-18',
'codename' => 'Lyra', 'codename' => 'Lyra',
'status' => 'stable', 'status' => 'stable',