Skip to content

Commit ccab897

Browse files
committed
Add more basic Dutch documentation, focusing on getting users up and running
1 parent e90be39 commit ccab897

11 files changed

Lines changed: 652 additions & 56 deletions

File tree

nl/aan-de-slag/index.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,17 @@
11
---
22
title: "Aan de slag"
3+
sortorder: 1
34
translation: "getting-started"
45
---
56

6-
Aan de slag met MODX!
7+
Welkom bij MODX. Deze sectie helpt je een site te installeren, Friendly URLs in te stellen, en upgrades uit te voeren.
78

8-
1. Controleer de [server vereisten](aan-de-slag/server-vereisten)
9-
2. [Installeer MODX](aan-de-slag/installatie)
10-
3. [Succesvolle installatie, wat nu?](aan-de-slag/succesvolle-installatie)
9+
1. [Wat is MODX?](aan-de-slag/wat-is-modx)
10+
2. [Server vereisten](aan-de-slag/server-vereisten)
11+
3. [Installatie](aan-de-slag/installatie)
12+
4. [Succesvolle installatie, wat nu?](aan-de-slag/succesvolle-installatie)
13+
5. [Vriendelijke URLs](aan-de-slag/vriendelijke-urls)
14+
6. [Upgraden](aan-de-slag/upgraden)
15+
7. [Upgraden van 2.x naar 3.0](aan-de-slag/upgraden-naar-3.0)
16+
17+
Meer detail (directorystructuur, glossary, troubleshooting) staat in de [Engelstalige Getting Started](/current/en/getting-started).

nl/aan-de-slag/installatie.md

Lines changed: 18 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -2,45 +2,31 @@
22
title: "Installatie"
33
sortorder: "3"
44
translation: "getting-started/installation"
5-
note: "Deze documentatie is nog niet compleet vertaald."
65
---
76

8-
Deze pagina gaat over nieuwe installaties. [Wil je MODX upgraden naar een nieuwe versie?](aan-de-slag/onderhoud/upgraden)
7+
Deze sectie is voor **nieuwe installaties**. Een bestaande site upgraden? Zie [Upgraden](aan-de-slag/upgraden).
98

10-
[Controleer hier de server vereisten voor MODX voor je begint](aan-de-slag/server-vereisten).
9+
Controleer eerst of de host voldoet aan de [server vereisten](aan-de-slag/server-vereisten) (PHP **8.1+** voor huidige 3.x-releases).
1110

12-
## Download MODX
11+
## Kies een installatiemethode
1312

14-
Globaal zijn er 2 keuzes om MODX te downloaden: van de MODX website, of via Git(Hub).
13+
| Methode | Voor wie | Handleiding |
14+
| ------- | -------- | ----------- |
15+
| Traditional zip | De meeste gebruikers; eenvoudigste pad | [Standaard installatie](aan-de-slag/installatie/standaard) |
16+
| Advanced zip | `manager/` en/of `connectors/` hernoemen tijdens setup | [Advanced Installation (EN)](/current/en/getting-started/installation/advanced) |
17+
| Git | Contributors en bleeding-edge | [Git Installation (EN)](/current/en/getting-started/installation/git) |
18+
| Composer | Developers die `create-project` prefereren | [Composer (EN)](/current/en/getting-started/installation/composer) |
19+
| CLI | Scripted / unattended setup | [Command Line Installation (EN)](/current/en/getting-started/installation/cli) |
1520

16-
### MODX Website
21+
Download packages via [modx.com/download](https://modx.com/download/).
1722

18-
Voor de meeste gebruikers is het aan te raden om een [distributie te downloaden van MODX.com](https://modx.com/download/). Op de MODX website vind je de downloads voor verschillende versies van MODX.
23+
### Traditional vs Advanced
1924

20-
De downloads worden in verschillende varianten aangeboden. Dit zijn allemaal dezelfde versie van MODX, waarbij in de installatie enkele verschillen zitten:
25+
- **Traditional** - Volledig package, uitpakken en setup starten. Gebruik dit tenzij je een specifieke reden hebt om iets anders te kiezen.
26+
- **Advanced** - Kleinere download; setup bouwt/uitpakt het core-package en laat je custom locaties voor `manager/` en `connectors/` instellen. De **core-map kan in MODX 3 niet meer verplaatst of hernoemd worden**. Voor hernoemen van manager/connectors heb je SSH (of vergelijkbaar) en schrijfbare parent-directories nodig.
2127

22-
- **Traditional** is de standaard download.
23-
- **Advanced** maakt het mogelijk om tijdens de installatie de mappen te hernoemen. Dit is een geavanceerdere functie waarmee je MODX als het ware kunt verbergen, wat de veiligheid ten goede kan komen. Het hernoemen van de mappen kan je ook na de installatie doen voor een Traditional installatie ([zie "Securing MODX" (EN)](/current/en/getting-started/maintenance/securing-modx)).
24-
- **SDK** is een variant specifiek voor ontwikkelaars van uitbreiding; deze bevat namelijk een leesbare versie van de ExtJS code die de manager gebruikt, waardoor het debuggen makkelijker kan worden.
28+
## Speciale situaties
2529

26-
### Git(Hub)
27-
28-
Daarnaast is het mogelijk om MODX direct [vanuit de officiele broncode](https://github.com/modxcms/revolution) te installeren. Gemiddeld 6-10x per jaar komt er een update voor MODX via de website uit, maar via GitHub heb je altijd de allerlaatste versie.
29-
30-
De installatie via Git omvat wel een paar extra stappen. Lees daarvoor verder in [Git Installation (EN)](/current/en/getting-started/installation/git-installation "Git Installation").
31-
32-
## Bestanden uploaden
33-
34-
Nadat je MODX hebt gedownload, moet je alle bestanden uploaden naar je webserver. Je kan het zip bestand uploaden, en op de server (bijvoorbeeld via een control panel of via SSH) het bestand unzippen, of je kunt op je computer het bestand unzippen en de losse bestanden uploaden. Als je de toegang hebt is het aan te raden om het unzippen op de server te doen, omdat je daarmee het risico op corrupte uploads minimaliseert, en het is vaak nog een stuk sneller ook.
35-
36-
Het is aan te raden om MODX direct in de webroot te plaatsen (de `public_html` of `www` map) zodat je MODX na de installatie op `example.com` kunt benaderen. Als dat niet kan, bijvoorbeeld omdat daar een bestaande website draait of omdat de domein nog niet is geregistreerd, is het ook mogelijk om MODX in een submap of subdomein te installeren. Als je klaar bent om de site te verplaatsen naar de hoofdmap kan je de [Moving your site documentatie (EN)](/current/en/getting-started/maintenance/moving-your-site) nalezen voor de stappen die je moet nemen.
37-
38-
## Installeren
39-
40-
Bestanden geupload? Dan is het tijd om de setup uit te voeren. Dat kan via de browser, of via de [command line (EN)](/current/en/getting-started/installation/cli).
41-
42-
Navigeer naar `http://example.com/setup/` om de setup te beginnen.
43-
44-
Direct worden er enkele verificaties uitgevoerd om, onder andere, zeker te weten dat sessies en de tijdzone juist zijn geconfigureerd op de server. Als die checks mislukken krijg je daar een melding van te zien, en moet de server configuratie aangepast worden voor je verder kunt met de installatie. Neem hiervoor contact op met je server administrator of hosting partij.
45-
46-
[Lees hier verder in het Engels](/current/en/getting-started/installation/standard).
30+
- [Installeren naast een bestaande site (EN)](/current/en/getting-started/installation/existing-site) (submap, oude HTML/CMS, tijdelijke URL)
31+
- [Troubleshooting Installation (EN)](/current/en/getting-started/installation/troubleshooting)
32+
- Na een geslaagde installatie: [Succesvolle installatie, wat nu?](aan-de-slag/succesvolle-installatie)
Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: "Standaard installatie"
3+
sortorder: "1"
4+
translation: "getting-started/installation/standard"
5+
description: "Installeer MODX 3 vanaf het traditional zip-package"
6+
---
7+
8+
Deze handleiding beschrijft een normale nieuwe installatie vanaf de **traditional** zip-download. De meeste sites gebruiken dit pad.
9+
10+
- Bestaande site upgraden? Zie [Upgraden](aan-de-slag/upgraden).
11+
- `manager/` of `connectors/` hernoemen? Gebruik [Advanced Installation (EN)](/current/en/getting-started/installation/advanced).
12+
- Installeren via Git of Composer? Zie [Git (EN)](/current/en/getting-started/installation/git) of [Composer (EN)](/current/en/getting-started/installation/composer).
13+
14+
## 1. Controleer de vereisten
15+
16+
Controleer of je host voldoet aan de [server vereisten](aan-de-slag/server-vereisten). Huidige MODX 3.x (3.2+) heeft **PHP 8.1+** en MySQL/MariaDB nodig.
17+
18+
Je hebt nodig:
19+
20+
- Een webroot (of submap) waar de site komt
21+
- Een MySQL-database en een databasegebruiker met voldoende rechten
22+
- Mogelijkheid om bestanden te uploaden/uitpakken (file manager, SFTP of SSH)
23+
24+
## 2. Download en plaats de bestanden
25+
26+
1. Download het nieuwste **traditional**-package van [modx.com/download](https://modx.com/download/).
27+
2. Upload de zip naar je server.
28+
3. Pak uit **op de server** (hosting file manager of `unzip`). Dat is veiliger en sneller dan duizenden bestanden via FTP uploaden.
29+
4. Zet de uitgepakte bestanden in je webroot (of submap), zodat `index.php`, `core/`, `manager/`, `connectors/` en `setup/` daar staan.
30+
5. Verwijder daarna de zip en eventuele lege wrapper-map.
31+
32+
Installeren in de domeinroot is gebruikelijk voor productie. Een submap is prima om te testen. Speciale gevallen (bestaande HTML/CMS-site, tijdelijke hosting-URL): [Installing alongside an existing site (EN)](/current/en/getting-started/installation/existing-site).
33+
34+
Zorg dat PHP minstens kan schrijven in:
35+
36+
- `core/cache/`
37+
- `core/config/`
38+
- `core/packages/`
39+
- `core/import/`
40+
- `core/export/`
41+
42+
## 3. Maak de database
43+
44+
In de MySQL-tool van je host (phpMyAdmin, control panel, CLI, enz.):
45+
46+
1. Maak een lege database (utf8mb4 is een goede default als de host die aanbiedt).
47+
2. Maak een databasegebruiker en geef die alle rechten op die database. Een beperktere set rechten staat in [server vereisten](aan-de-slag/server-vereisten).
48+
3. Noteer hostname (vaak `localhost`), databasenaam, gebruikersnaam en wachtwoord. Sommige shared hosts prefixen namen (bijvoorbeeld `account_modx`); gebruik de volledige namen die setup verwacht.
49+
50+
## 4. Start setup
51+
52+
Open in je browser `https://jouwsite.example/setup/` om de installatiewizard te starten.
53+
54+
Gebruik je echte domein of lokale URL, inclusief submap als je daarin hebt geïnstalleerd.
55+
56+
### Taal en welkom
57+
58+
Kies je taal en ga door het welkomstscherm.
59+
60+
### Installatie-opties
61+
62+
Voor een nieuwe site laat je **Nieuwe installatie** geselecteerd. Bestands- en maprechten kun je meestal op de defaults laten. Klik **Volgende**.
63+
64+
### Databaseverbinding
65+
66+
Vul in:
67+
68+
- **Database hostname** - meestal `localhost`. Voor een andere poort: `host;port=3307`. Voor een Unix-socket bijvoorbeeld `;unix_socket=/pad/naar/mysql.sock`.
69+
- **Gebruikersnaam** en **wachtwoord**
70+
- **Databasenaam**
71+
- **Tabelprefix** - `modx_` is prima; wijzig alleen als je meerdere MODX-installaties in één database deelt
72+
73+
Klik **Test database server connection and view collations**. Los fouten op vóór je verdergaat (verkeerd wachtwoord, ontbrekende database, of gebruiker zonder rechten zijn de gebruikelijke oorzaken).
74+
75+
### Charset en collation
76+
77+
Gebruik doorgaans `utf8mb4` en `utf8mb4_general_ci` voor brede compatibiliteit. Met plain `utf8` kun je emoji's of bepaalde scripts niet opslaan. Houd charset en collation bij elkaar.
78+
79+
### Beheerder
80+
81+
Maak de hoofdgebruiker voor de Manager:
82+
83+
- Kies liever een andere gebruikersnaam dan `admin`
84+
- Gebruik een sterk wachtwoord
85+
- Gebruik een e-mailadres dat je beheert (setup gebruikt dit ook voor de initiële `emailsender`-instelling)
86+
87+
Klik **Volgende**.
88+
89+
### Pre-installatiechecks en installeren
90+
91+
Setup controleert PHP, extensies en schrijfbare paden. Los fouten op (zie [server vereisten](aan-de-slag/server-vereisten) en [Troubleshooting (EN)](/current/en/getting-started/installation/troubleshooting)), klik daarna **Installeren**.
92+
93+
### Setup verwijderen en inloggen
94+
95+
Vink aan dat de `setup/`-map verwijderd mag worden, en log in op de Manager.
96+
97+
Laat `setup/` alleen staan zolang je die nog nodig hebt. De installer is krachtig; verwijder hem zodra de installatie gelukt is.
98+
99+
## 5. Na de installatie
100+
101+
1. Controleer of je kunt inloggen en de frontend kunt openen.
102+
2. Werk [Succesvolle installatie, wat nu?](aan-de-slag/succesvolle-installatie) door.
103+
3. Schakel [vriendelijke URLs](aan-de-slag/vriendelijke-urls) in wanneer je klaar bent (met de juiste Apache/nginx-regels).
104+
4. Harden de installatie: [Securing MODX (EN)](/current/en/getting-started/maintenance/securing-modx) (blokkeer vooral webtoegang tot `core/`).
105+
5. Installeer Extras via Package Management wanneer nodig: [Transport packages (EN)](/current/en/extending-modx/transport-packages).
106+
107+
Werkt e-mail later niet? Controleer of [emailsender](/current/en/building-sites/settings/emailsender) een geldig adres voor je domein is.
108+
109+
## Als er iets misgaat
110+
111+
- Wit scherm of vastlopende installatie: [Troubleshooting Installation (EN)](/current/en/getting-started/installation/troubleshooting)
112+
- Nog steeds vast? Vraag hulp in de [MODX Community](https://community.modx.com) en vermeld PHP-versie, databasetype/-versie en de exacte setup-fout (check ook `core/cache/logs/error.log` als die bestaat).

nl/aan-de-slag/server-vereisten.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,57 @@
11
---
22
title: "Server vereisten"
3+
sortorder: "2"
34
translation: "getting-started/server-requirements"
45
---
56

6-
MODX werkt prima op de meeste shared/cloud servers, en ook VPS en dedicated servers zijn geen probleem. MODX is geschreven in PHP, gebruikt in de meeste configuraties een MySQL database, en heeft een webserver als Apache of nginx nodig om de web requests te behandelen.
7+
MODX draait prima op de meeste shared/cloud hosting, en ook op VPS en dedicated servers. MODX is geschreven in PHP, gebruikt meestal een MySQL-database, en heeft een webserver als Apache of nginx nodig.
78

8-
## PHP
9+
| Component | Minimum | Aanbevolen |
10+
| --------- | ------- | ---------- |
11+
| PHP | 8.1 | 8.2 of hoger |
12+
| Database | MySQL 5.7.x | MySQL 8.0+ / MariaDB 10.6+ / Percona Server 8.0+ |
13+
| Webserver | * | NGINX 1.18 of Apache 2.4 |
914

10-
MODX 2.x vereist een PHP versie van tenminste 5.3.3, maar het is aan te raden om minstens versie 7.1 te gebruiken. 7.2 en 7.3 zijn ook ondersteund.
15+
## PHP
1116

12-
In MODX 3.0 zal de minimale ondersteunde versie van PHP verhoogd worden, waarschijnlijk naar 7.1.
17+
Huidige MODX 3-releases vereisen **PHP 8.1 of hoger**. PHP 8.2+ wordt aangeraden.
1318

14-
(MODX 2.7.0 en 2.7.1 hebben PHP 5.4 nodig; in 2.7.2 is dat hersteld naar PHP 5.3.3)
19+
MODX 3.0 vroeg oorspronkelijk PHP 7.2. Het minimum ging naar **PHP 8.1 in MODX 3.2**. Upgraden naar 3.2 of later betekent dus dat je host PHP 8.1+ moet ondersteunen.
1520

16-
De volgende PHP extensies zijn voor MODX, of voor veelgebruikte extras, nodig: `zlib`, `json`, `gd`, `pdo` (met `pdo_mysql`), `imagick`, `simplexml`, `curl`, en `mbstring`. Dit zijn vrij standaard extensies die in de meeste gevallen standaard beschikbaar zijn.
21+
De volgende extensies zijn nodig voor MODX, of vaak voor extras: `zlib`, `json`, `gd`, `pdo` (met `pdo_mysql`), `imagick`, `simplexml` (`php-xml`), `curl` en `mbstring`. Dit zijn gangbare extensies die meestal standaard aan staan.
1722

18-
Een `memory_limit` waarde van tenminste 64M of hoger is aan te raden.
23+
Een `memory_limit` van minstens 64M of hoger wordt aangeraden.
1924

2025
## Database
2126

22-
Het is mogelijk om MODX met verschillende database types te gebruiken, waaronder `mysql`, `sqlsrv`, en ook een third-party `postgres` implementatie is beschikbaar. Het is wel belangrijk om te weten dat veel uitbreidingen mogelijk alleen `mysql` ondersteunen, dat is dan ook de meestgebruikte database met MODX.
27+
MODX ondersteunt `mysql`. Er bestaat ook een third-party `postgres`-implementatie. Extras ondersteunen vaak alleen `mysql`, dus dat is de veiligste keuze.
2328

24-
De minimale MySQL versie is 4.1.20, maar 5.7 of hoger is aan te raden. Ook clusters als Galera en MySQL alternatieven als MariaDB zijn mogelijk.
29+
> Let op: ondersteuning voor sqlsrv is verwijderd in MODX 3.0. Zie de [sqlsrv-migratienotes (EN)](/current/en/getting-started/upgrading-to-3.0/sqlsrv) als je een oudere site van SQL Server af moet.
2530
26-
Zowel MyISAM en InnoDB storage engines, en utf8 en utf8mb4 karaktersets zijn ondersteund.
31+
Minimale MySQL-versie is 5.7; MySQL 8.0+ of MariaDB 10.6+ wordt aangeraden. Clusters zoals Galera kunnen ook.
2732

28-
Voor normaal gebruik dient de database user `SELECT`, `INSERT`, `UPDATE`, en `DELETE` permissies te hebben, en `CREATE`, `ALTER`, `INDEX` en `DROP` zijn nodig voor het installeren/upgraden van de core en uitbreidingen. Enkele uitbreidingen hebben mogelijk meer permissies nodig.
33+
Zowel MyISAM als InnoDB worden ondersteund, evenals utf8 en utf8mb4. Gebruik bij voorkeur utf8mb4 voor de breedste UTF-8-ondersteuning.
2934

30-
## Web servers
35+
Benodigde rechten: `SELECT`, `INSERT`, `UPDATE`, `DELETE` voor normaal gebruik; `CREATE`, `ALTER`, `INDEX`, `DROP` voor installatie en upgrades van de core en extras; sommige extras vragen ook `CREATE TEMPORARY TABLES`.
3136

32-
Apache 2.4 of hoger, or nginx 1.x is aan te raden.
37+
## Webservers
3338

34-
Het is ook mogelijk om lighttpd, IIS, Zeus, Valet en andere webservers te gebruiken. Hiervoor is mogelijk wel meer configuratie nodig om zoekmachinevriendelijke URLs te ondersteunen.
39+
Apache 2.4+ of nginx 1.18.x worden aangeraden.
3540

36-
## Browser Support for the Manager
41+
Voor [vriendelijke URLs](aan-de-slag/vriendelijke-urls) kan extra configuratie nodig zijn. Instructies (EN): [Apache](/current/en/getting-started/friendly-urls/apache), [nginx](/current/en/getting-started/friendly-urls/nginx), [lighttpd](/current/en/getting-started/friendly-urls/lighttpd). Een beknopte Apache-uitleg staat ook in het Nederlands: [Vriendelijke URLs op Apache](aan-de-slag/vriendelijke-urls/apache).
3742

38-
De volgende browsers zijn ondersteund voor het gebruik van de back-end manager voor het beheren van de site:
43+
## Browserondersteuning voor de Manager
44+
45+
Desktop:
3946

4047
- Edge (laatste 2)
4148
- Chrome (laatste 2)
4249
- Firefox (laatste 2)
4350
- Safari (laatste 2)
4451

45-
Op mobiele/tablet apparaten:
52+
Mobiel/tablet:
4653

4754
- Chrome for Android (laatste)
4855
- Safari on iOS (laatste)
4956

50-
De manager werkt mogelijk prima op oudere/andere browsers, maar die zijn niet officieel ondersteund.
51-
52-
Denk erom dat deze vereisten alleen gelden voor de manager. Welke browsers je voor de site wilt ondersteunen hangt helemaal af van wat je daar zelf voor wilt.
57+
De manager kan op oudere of andere browsers werken, maar die zijn niet officieel ondersteund. Deze eisen gelden alleen voor de manager; welke browsers je frontend ondersteunt bepaal je zelf.

0 commit comments

Comments
 (0)