CodePress/plugins/README.md

CodePress CMS Plugins

Deze map bevat alle plugins voor de CodePress CMS. Elke plugin heeft zijn eigen submap.

Plugin overzicht

Plugin	Type	Essentieel	Beschrijving
Dashboard	system	ja	Site informatie, content statistieken en plugin overzicht op het dashboard
GeoIPInfo	system	nee	GeoIP-informatie (IP adres en land) in admin
HTMLBlock	content	nee	Custom HTML-blok in de sidebar van content-pagina's
Logs	system	nee	Admin activiteitlogs en front-end request logs met filter tabs
Navigation	content	ja	Navigatie voor handleidingen en content (beschermd)
Statistics	system	nee	Bezoekersstatistieken: views, unieke bezoekers, landen, top pagina's

Elke plugin heeft een eigen README.md met specifieke documentatie.

Plugin structuur (uniform)

Elke plugin-map heeft de volgende structuur:

PluginName/
├── PluginName.php          # Hoofd plugin class (naam = mapnaam)
├── plugin.json              # Plugin metadata + instellingen-schema
├── README.md                # Plugin documentatie
├── config.json              # Optionele runtime configuratie (overschrijft defaults)
├── assets/                  # Optionele CSS/JS/SCSS (.gitkeep als leeg)
│   ├── css/
│   └── scss/
└── language/                # Vertalingen
    ├── nl/
    │   ├── admin.php        # Admin labels (systeem plugins)
    │   └── site.php         # Front-end labels (content plugins)
    └── en/
        ├── admin.php
        └── site.php

plugin.json velden

Veld	Waarde	Beschrijving
name	string	Weergavenaam in admin
version	string	Versienummer
author	string	Auteur
description	string	Korte beschrijving
type	"system" of "content"	Systeem (blauwe badge) of content (groene badge)
essential	boolean	Essentiële plugins kunnen niet worden bewerkt/verwijderd
hasConfig	boolean	Toont een Config-knop in admin
default_language	string	Fallback taal voor plugin-vertalingen (bijv. nl)
settings	array	Instellingen-schema (zie hieronder)

Instellingen-schema

Elke instelling in settings ondersteunt:

Veld	Beschrijving
key	Instelling-sleutel (opgeslagen in config.json)
type	text, checkbox, number, select, multi-select
default	Standaardwaarde
label	Hardcoded label (fallback als geen label_key)
help	Hardcoded help-tekst (fallback als geen help_key)
label_key	Sleutel in plugin language/<lang>/admin.php voor vertaald label
help_key	Sleutel in plugin language/<lang>/admin.php voor vertaalde help-tekst
option_label_key	Sleutel naar een array met optie-labels voor select/multi-select
options	Opties voor select/multi-select ({waarde: label})

Taal support

• Systeem plugins volgen de geselecteerde admin taal (uit config.admin_language).
• Content plugins volgen de geselecteerde content taal (uit de URL of config.language.default).

Fallback chain voor plugin-vertalingen:

1. Geselecteerde taal (language/<lang>/admin.php of site.php)
2. Plugin default_language (plugin.json)
3. CMS language.default
4. Lege array (sleutel wordt ongewijzigd getoond)

Plugins halen hun vertalingen op via de API:

• Systeem plugins: $this->api->getPluginTranslations('PluginName') (AdminPluginAPI)
• Content plugins: $this->api->getPluginTranslations('PluginName') (CMSAPI)

Uitgebreide documentatie

Zie de handleiding voor uitgebreide plugin development documentatie:

• guide/nl/codepress-developer/plugin-development.md
• guide/en/codepress-developer/plugin-development.md

Installatie

1. Maak een nieuwe map in plugins/ (mapnaam = plugin class naam)
2. Voeg de hoofd plugin class toe als <Naam>.php
3. Maak een plugin.json met metadata en (optioneel) instellingen-schema
4. Voeg een README.md toe met plugin documentatie
5. Voeg language/<lang>/admin.php of site.php toe voor vertalingen
6. Schakel de plugin in via enabled_plugins in config.json (of via de admin Plugins-pagina)