CodePress/README.md

# CodePress CMS

**[🇳🇱 Nederlands](#) | [🇬🇧 English](README.en.md)**

Een lichtgewicht, file-based content management systeem gebouwd met PHP (≥8.0).

**Versie:** 2.6.5 | **Licentie:** AGPL v3 / Commercial

## ✨ Features

- 📝 **Multi-format Content** - Markdown, PHP en HTML bestanden
- 🧭 **Dynamic Navigation** - Automatische menu generatie
- 🌍 **Multi-language** - NL/EN/DE ondersteuning
- 🔍 **Search** - Volledige tekst zoekfunctie
- 📱 **Responsive** - Bootstrap 5 thema's
- 🔒 **Security** - 100/100 pentest score
- 🛡️ **Admin Console** - CodeMirror editor, media beheer, thema's, plugins
- 👥 **Gebruikersrollen** - Admin, Content Beheerder, BI Beheerder, Site Admin
- 📊 **Analytics** - Bezoekersstatistieken met GeoIP
- 🤖 **BotGuard** - Bot/AI bescherming
- 📈 **Logging** - Uitgebreid logging systeem
- 🔌 **Plugin Systeem** - Sidebar plugins met eigen CSS/SCSS, Twig templates

## 🚀 Quick Start

```bash
# Installeer dependencies
composer install

# Start server met router voor schone URLs (alleen lokaal)
php -S localhost:8080 cms/router.php
```

**Website:** `http://localhost:8080`  
**Admin:** `http://localhost:8080/admin` (login: `admin` / `admin`)

## 📦 Installatie

### Vereisten

- **PHP** ≥ 8.0 met extensies: `json`, `mbstring`
- **Composer** (PHP dependency manager)
- Webserver: **Apache 2.4+** met `mod_rewrite` of **Nginx** met PHP-FPM
- Optioneel: `opcache` (aanbevolen voor performance), `git` (voor content versioning), `zip` extensie (voor ZIP backup/restore)

### Stap 1 — Code en dependencies

```bash
git clone <repository-url> codepress
cd codepress
composer install
```

### Stap 2 — Configuratie

```bash
cp config.json.example config.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.

### Stap 3a — Apache 2.4+

De webroot is de `public/` map. Voorbeeld vhost (`/etc/apache2/sites-available/codepress.conf`):

```apache
<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/codepress/public

    <Directory /var/www/codepress/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/codepress_error.log
    CustomLog ${APACHE_LOG_DIR}/codepress_access.log combined
</VirtualHost>
```

Benodigde Apache modules:

```bash
sudo a2enmod rewrite headers
sudo systemctl restart apache2
```

- `mod_rewrite` — voor clean URLs (`/nl/pagina`) en asset-serving
- `mod_headers` — voor security headers
- `AllowOverride All` — zodat `.htaccess` in `public/` wordt toegepast

### Stap 3b — Nginx

Voorbeeld server block (`/etc/nginx/sites-available/codepress`):

```nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/codepress/public;
    index index.php;

    # Clean URLs: taal-prefixed pagina's
    location ~ ^/(nl|en|de)(/(.+))?$ {
        try_files $uri /index.php?lang=$1&page=$2;
    }

    # Admin routes
    location /admin {
        try_files $uri /admin.php?$args;
    }

    # Asset-serving via asset.php (themes/plugins/admin buiten webroot)
    location ~ ^/(themes|plugins)/([^/]+)/assets/(.+)$ {
        try_files $uri /asset.php;
    }
    location ~ ^/admin/assets/(.+)$ {
        try_files $uri /asset.php;
    }

    # PHP via FPM
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.0-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Beveiliging: blokkeer toegang tot gevoelige mappen
    location ~ ^/(content|cms|admin/src|admin/config|admin/storage|var|vendor)/ {
        deny all;
        return 403;
    }

    location ~ /\.(git|htaccess) {
        deny all;
    }
}
```

**Let op:** Nginx gebruikt geen `.htaccess`. De security headers moeten in de Nginx config worden gezet:

```nginx
add_header X-Content-Type-Options nosniff;
add_header X-Frame-Options SAMEORIGIN;
add_header X-XSS-Protection "1; mode=block";
add_header Referrer-Policy strict-origin-when-cross-origin;
add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self';";
```

### Stap 4 — Mappen rechten

Zorg dat de webserver schrijfrechten heeft op de runtime mappen:

```bash
chown -R www-data:www-data var/ admin/storage/ content/
chmod -R 755 .
```

### Stap 5 — Test

Open de website in je browser. Bij een lege content-map zie je een welkomstpagina. De admin console is bereikbaar via `/admin` (login `admin`/`admin`).

## 📚 Handleidingen

Zie **[guide/](guide/)** voor uitgebreide documentatie per rol:

| Rol | Handleiding |
|-----|-------------|
| 📝 Redacteur | [Content Beheerder](guide/nl/content-beheerder.md) |
| ⚙️ Administrator | [Admin Beheerder](guide/nl/admin-beheerder.md) |
| 🎨 Theme bouwer | [Theme Developer](guide/nl/theme-developer.md) |
| 💻 Developer | [CodePress Developer](guide/nl/codepress-developer.md) |

Elke handleiding heeft sub-onderdelen in aparte mappen met een zijbalknavigatie.

## 👥 Gebruikersrollen

| Rol | Permissies |
|-----|-----------|
| **Admin** | Volledige toegang (alles) |
| **Content Beheerder** | Content beheer, handleiding |
| **BI Beheerder** | Statistieken, logs, handleiding |
| **Site Admin** | Thema, plugins, statistieken, logs, update, handleiding |

## 📁 Project Structuur

```
codepress/
├── cms/                        # Core CMS engine
│   ├── core/class/             # CMS classes (CodePressCMS, ThemeManager, etc.)
│   ├── core/plugin/            # Plugin systeem (PluginManager, CMSAPI)
│   └── router.php              # PHP dev server router (schone URLs)
├── language/                   # Taalbestanden (nl/, en/, de/ — elk met site.php + admin.php)
├── admin/                      # Admin console
│   ├── config/                 # Admin configuratie (admin.json)
│   ├── src/AdminAuth.php       # Authenticatie, rollen, permissies
│   ├── static/                 # Statische bestanden (404.html)
│   ├── storage/                # Logs, cache, geoip
│   └── theme/default/          # Admin thema
│       ├── assets/             # CSS, JS, fonts, codemirror
│       ├── views/              # Twig templates (layouts, pages)
│       └── theme.json          # Admin thema configuratie
├── themes/                     # Website thema's
│   ├── default/                # Standaard thema
│   │   ├── theme.json           # Layout mapping, kleuren
│   │   ├── base.twig           # Hoofd layout
│   │   ├── *.twig              # Layout templates
│   │   ├── partials/            # Header, navigation, footer
│   │   └── assets/             # SCSS, CSS, JS, img
├── plugins/                    # Plugins
│   ├── Dashboard/               # Systeem plugin (admin taal)
│   ├── HTMLBlock/               # Content plugin (content taal)
│   ├── Navigation/              # Essentiële navigatie plugin (beschermd)
│   └── Statistics/              # Systeem plugin (admin taal)
│       ├── Statistics.php       # Plugin code
│       ├── plugin.json          # Plugin metadata + instellingen
│       ├── README.md            # Plugin documentatie
│       ├── assets/              # Plugin CSS/JS/SCSS
│       └── language/           # Plugin vertalingen (nl/, en/)
├── content/                    # Website content (.md, .php, .html)
├── public/                     # Web root
│   ├── index.php               # Website entry point
│   └── admin.php               # Admin entry point + routing
├── guide/                      # Handleidingen (nl/en)
│   ├── nl/                     # Nederlandse handleidingen
│   └── en/                     # Engelse handleidingen
├── cli/test/                   # Test suites
├── var/                        # Cache (twig)
├── config.json                 # Site configuratie
├── composer.json               # PHP dependencies
└── version.php                 # Versie informatie
```

## ⚙️ Configuratie

### config.json

```json
{
    "site_title": "CodePress",
    "active_theme": "default",
    "default_page": "auto",
    "language": {
        "default": "nl",
        "available": ["nl", "en"]
    },
    "enabled_plugins": ["HTMLBlock", "Navigation"],
    "features": {
        "search_enabled": true,
        "breadcrumbs_enabled": true
    },
    "security": {
        "block_ai_bots": true,
        "rate_limit_enabled": true
    },
    "analytics": { "enabled": true },
    "logging": { "enabled": true }
}
```

## 🔧 Dependencies

- **PHP ≥8.0** met extensies: json, mbstring
- **Composer** packages:
  - twig/twig (templating)
  - scssphp/scssphp (SCSS compilatie)
  - league/commonmark (Markdown met HeadingPermalinks)
  - maxmind-db/reader (GeoIP)

## 🔐 Security

- ✅ XSS preventie (htmlspecialchars)
- ✅ CSRF tokens (admin formulieren)
- ✅ Path traversal preventie (realpath checks)
- ✅ Secure cookies (HttpOnly, SameSite)
- ✅ Security headers (X-Frame-Options, CSP)
- ✅ Bot/AI bescherming (BotGuard)
- ✅ Rate limiting per IP
- ✅ Role-based access control (RBAC)

## 🔌 Plugins

### Plugin structuur

Elke plugin heeft een uniforme structuur:

```
plugins/MijnPlugin/
├── MijnPlugin.php          # Plugin code (naam = pluginnaam)
├── plugin.json             # Plugin metadata + instellingen
├── README.md               # Plugin documentatie
├── assets/scss/            # Plugin SCSS bron
├── assets/css/             # Plugin CSS (na compilatie)
└── language/               # Plugin vertalingen (i18n)
    ├── nl/admin.php        # NL admin labels (systeem plugins)
    └── en/admin.php        # EN admin labels
```

- **Systeem plugins** volgen de admin-taal (`language/<lang>/admin.php`)
- **Content plugins** volgen de content-taal (`language/<lang>/site.php`)
- Fallback chain: geselecteerde taal → plugin `default_language` → CMS site default

Zie `guide/nl/codepress-developer/plugin-development.md` voor uitgebreide documentatie.

### Plugin editor

De admin plugin-editor (`/admin/plugins-edit`) biedt een volledige bestandsbeheer-omgeving:
- Geneste bestandsbrowser zijbalk (alle bestanden in de plugin-map)
- Nieuw bestand aanmaken, uploaden naar assets/, verwijderen en verplaatsen
- CodeMirror editor voor .php, .json, .md, .html, .css, .scss, .js bestanden

### Essentiële plugins

De **Navigation** plugin is een essentiële plugin en kan niet worden gedeactiveerd, bewerkt of verwijderd. Deze plugin genereert automatisch de zijbalknavigatie voor handleidingen en content.

### Plugin CSS

Plugin CSS wordt automatisch geladen na thema CSS, zodat thema's plugin styling kunnen overschrijven.

## 📝 Content Voorbeelden

### Markdown met frontmatter

```markdown
---
layout: full_content
plugins: HTMLBlock, Navigation
---

# Pagina titel

Content in Markdown formaat...
```

### PHP content

```php
<?php
/** @var ContentAPI $api */
$pages = $api->getAllPages();
echo "<h1>Mijn Pagina</h1>";
echo "<p>Aantal pagina's: " . count($pages) . "</p>";
```

## 🧪 Testen

```bash
# Penetration tests
cli/test/pentest/security-test.sh

# Accessibility tests (WCAG 2.1 AA)
cli/test/accessibility.sh

# Functionele tests
cli/test/functional/*.sh
```

## 📞 Ondersteuning

- **Documentatie:** [guide/](guide/)
- **Issues:** Git repository
- **Contact:** commercial@noorlander.info

## 📄 Licentie

**Dual-licensed:**

- **AGPL v3** - Voor open-source projecten
- **Commercial** - Voor propriëtair gebruik

Zie [LICENSE](LICENSE) voor details.

---

**CodePress CMS** - Gebouwd door E.Noorlander / CodePress Development Team