Edwin Noorlander
a86809c243
- Remove sidebar and toggle functionality - Add Bootstrap navbar with dropdown menus - Move navigation to top between header and content - Update menu rendering for Bootstrap dropdowns - Clean up unused files (header.mustache, sidebar.mustache, sidebar.js) - Add guide link with book icon in footer - Simplify layout structure - Remove duplicate code and fix syntax errors - Add .gitignore for node_modules and other temp files
171 lines
3.8 KiB
Markdown
171 lines
3.8 KiB
Markdown
# 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.* |