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
parent e85f6e91e1
commit 90253673ba
9 changed files with 452 additions and 25 deletions
@@ -18,7 +18,7 @@ CodePress CMS is een lichtgewicht, file-based content management systeem gebouwd

 ### Content Types
 - **Markdown (.md)** - CommonMark ondersteuning via `league/commonmark`
- **PHP (.php)** - Dynamische content
+- **PHP (.php)** - Dynamische content met **Content API** (`$api` variabele)
 - **HTML (.html)** - Statische HTML pagina's
 - **Directory listings** - Automatische directory overzichten
 - **Language-specific content** - `nl.` en `en.` prefix
@@ -63,6 +63,7 @@ CodePress CMS is een lichtgewicht, file-based content management systeem gebouwd
 - **Plugin beheer** - Overzicht, aanmaken, bewerken, configureren, in-/uitschakelen en verwijderen
 - **Media beheer** - Uploaden en verwijderen van mediabestanden in `content/-assets/`
 - **Gebruikersbeheer** - Gebruikers toevoegen, verwijderen, wachtwoorden wijzigen
+- **Handleiding** - Ingebouwde documentatie met API referentie
 - Session-based authenticatie met bcrypt hashing
 - CSRF-bescherming, brute-force lockout (5 pogingen, 15 min)
 - Standaard login: `admin` / `admin` (wijzig direct na installatie)
@@ -287,6 +288,7 @@ Media bestanden (afbeeldingen, PDFs, video, audio) kunnen in elke `content/` sub
 | `media` | Media beheer (uploaden, verwijderen) |
 | `media-list` | JSON lijst van alle media (voor editor modal) |
 | `users` | Gebruikersbeheer |
+| `guide` | Handleiding (deze documentatie) |

 ### Editor Functionaliteit

@@ -492,6 +494,102 @@ class MijnPlugin

 De MQTTTracker plugin slaat `broker_host`, `broker_port`, `client_id`, `username` en `password` op in plain text in `plugins/MQTTTracker/config.json`. Dit is een bekend openstaand security punt - bij een productieomgeving wordt aangeraden deze gegevens te externaliseren naar omgevingsvariabelen of een aparte credentials manager.

+## Content API (voor PHP content bestanden)
+
+PHP content bestanden (`.php` in de `content/` map) hebben toegang tot een `$api` variabele met de volgende methodes:
+
+### Pagina's opvragen
+
+```php
+// Alle pagina's met titels ophalen
+$pages = $api->getAllPages();
+// Resultaat: ['index' => 'Home', 'over-ons' => 'Over ons', ...]
+
+// specifieke pagina inhoud ophalen
+$page = $api->getPage('over-ons');
+// $page['title'], $page['content'], $page['path'], $page['layout'], $page['metadata']
+
+// Controleren of een pagina bestaat
+if ($api->pageExists('contact')) {
+    // ...
+}
+```
+
+### Navigatie
+
+```php
+// Menu structuur ophalen
+$menu = $api->getMenu();
+// Bevat geneste array met 'title', 'path', 'url', 'children'
+```
+
+### Configuratie
+
+```php
+// Configuratie waarde opvragen (punt-notatie)
+$title = $api->getConfig('site_title');
+$lang = $api->getConfig('language.default');
+$seoDesc = $api->getConfig('seo.description', 'Standaard beschrijving');
+```
+
+### Huidige pagina
+
+```php
+// Huidige pagina titel
+$pageTitle = $api->getCurrentPageTitle();
+
+// Huidige pagina pad
+$pagePath = $api->getCurrentPagePath();
+
+// Check of dit de homepage is
+if ($api->isHomepage()) {
+    echo 'Welkom!';
+}
+```
+
+### URLs en taal
+
+```php
+// URL bouwen voor een pagina
+$url = $api->buildUrl('over-ons', 'nl');
+
+// Huidige taal
+$lang = $api->getCurrentLanguage();
+
+// Beschikbare talen
+$languages = $api->getAvailableLanguages();
+
+// Site titel
+$title = $api->getSiteTitle();
+```
+
+### Vertalingen en zoeken
+
+```php
+// Vertaling ophalen
+$label = $api->t('home');
+
+// Zoekresultaten (als er gezocht wordt)
+if ($api->isSearching()) {
+    $results = $api->getSearchResults();
+}
+```
+
+### Voorbeeld PHP content bestand
+
+```php
+---
+title: Pagina Overzicht
+layout: content
+---
+<h1>Alle Pagina's</h1>
+<ul>
+<?php foreach ($api->getAllPages() as $path => $title): ?>
+    <li><a href="<?= $api->buildUrl($path) ?>"><?= htmlspecialchars($title) ?></a></li>
+<?php endforeach; ?>
+</ul>
+```
+
 ## Analytics & Tracking

 ### MQTT Tracker