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
This commit is contained in:
+99
-1
@@ -18,7 +18,7 @@ CodePress CMS is a lightweight, file-based content management system built with
|
||||
|
||||
### Content Types
|
||||
- **Markdown (.md)** - CommonMark support via `league/commonmark`
|
||||
- **PHP (.php)** - Dynamic content
|
||||
- **PHP (.php)** - Dynamic content with **Content API** (`$api` variable)
|
||||
- **HTML (.html)** - Static HTML pages
|
||||
- **Directory listings** - Automatic directory overviews
|
||||
- **Language-specific content** - `en.` and `nl.` prefixes
|
||||
@@ -63,6 +63,7 @@ CodePress CMS is a lightweight, file-based content management system built with
|
||||
- **Plugin management** - Overview, create, edit, configure, enable/disable and delete
|
||||
- **Media management** - Upload and delete media files in `content/-assets/`
|
||||
- **User management** - Add, remove users, change passwords
|
||||
- **Guide** - Built-in documentation with API reference
|
||||
- Session-based authentication with bcrypt hashing
|
||||
- CSRF protection, brute-force lockout (5 attempts, 15 min)
|
||||
- Default login: `admin` / `admin` (change immediately after installation)
|
||||
@@ -286,6 +287,7 @@ Media files (images, PDFs, video, audio) can be placed in any `content/` subdire
|
||||
| `media` | Media management (upload, delete) |
|
||||
| `media-list` | JSON list of all media (for editor modal) |
|
||||
| `users` | User management |
|
||||
| `guide` | Guide / documentation |
|
||||
|
||||
### Editor Features
|
||||
|
||||
@@ -491,6 +493,102 @@ class MyPlugin
|
||||
|
||||
The MQTTTracker plugin stores `broker_host`, `broker_port`, `client_id`, `username` and `password` in plain text in `plugins/MQTTTracker/config.json`. This is a known open security issue - in a production environment it is recommended to externalize these credentials to environment variables or a separate credential manager.
|
||||
|
||||
## Content API (for PHP content files)
|
||||
|
||||
PHP content files (`.php` in the `content/` directory) have access to an `$api` variable with the following methods:
|
||||
|
||||
### Getting pages
|
||||
|
||||
```php
|
||||
// Get all pages with titles
|
||||
$pages = $api->getAllPages();
|
||||
// Result: ['index' => 'Home', 'about' => 'About Us', ...]
|
||||
|
||||
// Get a specific page's content
|
||||
$page = $api->getPage('about');
|
||||
// $page['title'], $page['content'], $page['path'], $page['layout'], $page['metadata']
|
||||
|
||||
// Check if a page exists
|
||||
if ($api->pageExists('contact')) {
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
### Navigation
|
||||
|
||||
```php
|
||||
// Get menu structure
|
||||
$menu = $api->getMenu();
|
||||
// Nested array with 'title', 'path', 'url', 'children'
|
||||
```
|
||||
|
||||
### Configuration
|
||||
|
||||
```php
|
||||
// Get config value (dot notation)
|
||||
$title = $api->getConfig('site_title');
|
||||
$lang = $api->getConfig('language.default');
|
||||
$seoDesc = $api->getConfig('seo.description', 'Default description');
|
||||
```
|
||||
|
||||
### Current page
|
||||
|
||||
```php
|
||||
// Current page title
|
||||
$pageTitle = $api->getCurrentPageTitle();
|
||||
|
||||
// Current page path
|
||||
$pagePath = $api->getCurrentPagePath();
|
||||
|
||||
// Check if this is the homepage
|
||||
if ($api->isHomepage()) {
|
||||
echo 'Welcome!';
|
||||
}
|
||||
```
|
||||
|
||||
### URLs and language
|
||||
|
||||
```php
|
||||
// Build URL for a page
|
||||
$url = $api->buildUrl('about', 'en');
|
||||
|
||||
// Current language
|
||||
$lang = $api->getCurrentLanguage();
|
||||
|
||||
// Available languages
|
||||
$languages = $api->getAvailableLanguages();
|
||||
|
||||
// Site title
|
||||
$title = $api->getSiteTitle();
|
||||
```
|
||||
|
||||
### Translations and search
|
||||
|
||||
```php
|
||||
// Get translation
|
||||
$label = $api->t('home');
|
||||
|
||||
// Search results (if searching)
|
||||
if ($api->isSearching()) {
|
||||
$results = $api->getSearchResults();
|
||||
}
|
||||
```
|
||||
|
||||
### Example PHP content file
|
||||
|
||||
```php
|
||||
---
|
||||
title: Page Overview
|
||||
layout: content
|
||||
---
|
||||
<h1>All Pages</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
|
||||
|
||||
+99
-1
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user