# CodePress CMS Handleiding

## Welkom bij CodePress CMS

CodePress is een lichtgewicht, op bestanden gebaseerd Content Management Systeem gebouwd met PHP en Bootstrap.

### Inhoudsopgave

1. [Getting Started](#getting-started)
2. [Content Management](#content-management)
3. [Templates](#templates)
4. [Configuration](#configuration)

---

## Getting Started

### Vereisten
- PHP 8.4+
- Webserver (Apache/Nginx)
- Modern web browser

### Installatie
1. Clone of download de CodePress bestanden
2. Upload naar je webserver
3. Zorg dat de `content/` map schrijfbaar is
4. Navigeer naar je website in de browser

### Basis Configuratie
De belangrijkste instellingen vind je in `engine/core/config.php`:

```php
$config = [
    'site_title' => 'Mijn Website',
    'default_page' => 'home',
    'content_dir' => __DIR__ . '/../../content',
    'templates_dir' => __DIR__ . '/../templates'
];
```

---

## Content Management

### Bestandsstructuur
```
content/
├── home.md              # Home pagina
├── blog/
│   ├── index.md         # Blog overzicht
│   ├── artikel-1.md     # Blog artikel
│   └── categorie/
│       └── artikel.md   # Artikel in categorie
└── over-ons/
    └── info.md          # Over ons pagina
```

### Content Types
CodePress ondersteunt drie content types:

#### Markdown (`.md`)
```markdown
# Pagina Titel

Dit is de inhoud van de pagina in **Markdown** formaat.

## Subsectie

- Lijst item 1
- Lijst item 2
```

#### PHP (`.php`)
```php
<?php
$title = "Dynamische Pagina";
?>
<h1><?php echo $title; ?></h1>
<p>Dit is dynamische content met PHP.</p>
```

#### HTML (`.html`)
```html
<h1>HTML Pagina</h1>
<p>Dit is statische HTML content.</p>
```

### Automatische Linking
CodePress maakt automatisch links naar andere pagina's wanneer je paginanamen in je content noemt.

---

## Templates

### Template Structuur
CodePress gebruikt Mustache-compatible templates:

- `layout.mustache` - Hoofdtemplate
- `assets/header.mustache` - Header component
- `assets/sidebar.mustache` - Sidebar navigatie
- `assets/footer.mustache` - Footer component

### Template Variabelen
Beschikbare variabelen in templates:
- `{{site_title}}` - Website titel
- `{{page_title}}` - Huidige pagina titel
- `{{content}}` - Pagina inhoud
- `{{menu}}` - Navigatie menu
- `{{breadcrumb}}` - Broodkruimel navigatie

---

## Configuration

### Basis Instellingen
Pas `engine/core/config.php` aan voor jouw website:

```php
$config = [
    'site_title' => 'Jouw Website Naam',
    'default_page' => 'home',           // Standaard startpagina
    'content_dir' => __DIR__ . '/../../content',
    'templates_dir' => __DIR__ . '/../templates'
];
```

### SEO Vriendelijke URLs
CodePress genereert automatisch schone URLs:
- `home.md` → `/home`
- `blog/artikel.md` → `/blog/artikel`

### Zoekfunctionaliteit
De ingebouwde zoekfunctie doorzoekt:
- Bestandsnamen
- Content van Markdown/PHP/HTML bestanden

---

## Tips en Tricks

### Pagina Organisatie
- Gebruik submappen voor categoriën
- Geef elke map een `index.md` voor een overzichtspagina
- Houd bestandsnamen kort en beschrijvend

### Content Optimalisatie
- Gebruik duidelijke koppen (H1, H2, H3)
- Voeg beschrijvende meta-informatie toe
- Gebruik interne links voor betere navigatie

### Veiligheid
- Houd je CodePress installatie bijgewerkt
- Beperk schrijfrechten op de `content/` map
- Gebruik HTTPS indien mogelijk

---

## Ondersteuning

### Problemen Oplossen
- **Lege pagina's**: Controleer bestandsrechten
- **Template fouten**: Verifieer template syntax
- **404 fouten**: Controleer bestandsnamen en paden

### Meer Informatie
- Documentatie: [CodePress GitHub](https://git.noorlander.info/E.Noorlander/CodePress.git)
- Issues en feature requests: GitHub Issues

---

*Deze handleiding is onderdeel van CodePress CMS en wordt automatisch getoond wanneer er geen content beschikbaar is.*