# Gebruikersdocumentatie voor Statamic-Website ## Inhoud - [Inleiding](#inleiding) - [Installatie](#installatie) - [Aanvullende Richtlijnen voor Ontwikkelaars](#aanvullende-richtlijnen-voor-ontwikkelaars) --- ## Inleiding Welkom bij de gebruikersdocumentatie voor jouw Statamic-website. Deze gids is bedoeld voor ontwikkelaars die de site gaan installeren en onderhouden. Hier vind je stapsgewijze instructies en nuttige tips om een soepele installatie en configuratie te garanderen. --- ## Installatie ### Vereisten Zorg dat je server voldoet aan de volgende eisen: - PHP versie 7.4 of hoger - Composer geïnstalleerd (versie 2+ aanbevolen) - MySQL 5.7+ of een andere ondersteunde database - Webserver zoals Apache of Nginx ### Stap 1: Project downloaden Je kunt het Statamic-project op twee manieren verkrijgen: - **Via Composer:** ```bash composer create-project statamic/statamic my-site ``` - **Manueel downloaden:** Download de laatste release van [Statamic](https://statamic.com/download) en pak deze uit in je webroot. ### Stap 2: Dependencies installeren Ga naar de projectmap en voer uit: ```bash cd my-site composer install ``` ### Stap 3: Omgevingsbestanden configureren Maak een kopie van `.env.example` en noem deze `.env`. ```bash cp .env.example .env ``` Open `.env` en pas de database-informatie en andere instellingen aan. ### Stap 4: Database migraties uitvoeren Voer de migraties uit om de database op te zetten: ```bash php artisan migrate ``` ### Stap 5: Administrator account aanmaken Stel een wachtwoord in voor de beheerder: ```bash php artisan user:add --email=admin@jouwdomein.nl --name="Admin" --roles=super ``` ### Stap 6: Cache en assets opbouwen Voor productie-omgeving: ```bash php artisan statamic:stache:clear php artisan cache:clear php artisan assets:compile ``` ### Stap 7: Webserver configureren - **Apache:** Zorg dat de `.htaccess`-bestanden correct zijn ingesteld. - **Nginx:** Configureer de serverblokken volgens de [Statamic-documentatie](https://statamic.com/docs/installation/nginx). ### Stap 8: Toegang tot de beheerinterface Navigeer naar `http://jouwdomein.nl/cp` en log in met de beheerdersgegevens. --- ## Aanvullende Richtlijnen voor Ontwikkelaars - **Versiebeheer:** Gebruik Git voor versiecontrole en werk met feature-branches. - **Plugins & Add-ons:** Installeer officiële plugins via Composer en activeer ze via de control panel. - **Thema's en Views:** Pas de Blade-templates aan in de map `resources/views`. - **Asset Management:** Gebruik Laravel Mix of andere tools voor het beheren van CSS/JS. - **Back-ups:** Maak regelmatig back-ups van je database en bestanden. - **Veiligheid:** Houd je dependencies up-to-date en configureer HTTPS. --- ## Conclusie Met deze stappen en richtlijnen ben je in staat om jouw Statamic-website succesvol te installeren en te onderhouden. Voor verdere details en geavanceerde configuraties raadpleeg de [officiële documentatie](https://statamic.com/docs). --- Heeft u nog verdere vragen of hulp nodig?

Zeker, hier is een uitgebreide gebruikersdocumentatie voor je Statamic-website in Markdown-formaat, specifiek gericht op ontwikkelaars. # Statamic Website Documentatie ## Inhoudsopgave 1. [Installatie](#installatie) 2. [Ontwikkelaarsrichtlijnen](#ontwikkelaarsrichtlijnen) 3. [Aanbevolen werkwijzen](#aanbevolen-werkwijzen) --- ## Installatie ### Vereisten Controleer of je systeem voldoet aan de volgende vereisten voordat je begint met de installatie: - PHP 8.1 of hoger - Composer 2.0 of hoger - Node.js 18 of hoger (voor front-end build tools) - NPM of Yarn package manager - Database (MySQL 5.7+, PostgreSQL 9.2+, SQLite 3.8.8+) ### Stapsgewijze installatie #### 1. Project aanmaken ```bash composer create-project statamic/statamic mijn-website cd mijn-website ``` #### 2. Environment configuratie Kopieer het `.env.example` bestand naar `.env` en pas de database configuratie aan: ```bash cp .env.example .env ``` Bewerk het `.env` bestand met je database gegevens: ```env DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=statamic_db DB_USERNAME=username DB_PASSWORD=password ``` #### 3. Applicatie-sleutel genereren ```bash php artisan key:generate ``` #### 4. Database migreren ```bash php artisan migrate ``` #### 5. Statamic installatie voltooien ```bash php please install ``` #### 6. Front-end dependencies installeren ```bash npm install ``` #### 7. Development server starten ```bash npm run dev # of voor productie npm run build ``` #### 8. Applicatie starten ```bash php artisan serve ``` De website is nu bereikbaar op `http://localhost:8000` --- ## Ontwikkelaarsrichtlijnen ### Projectstructuur ``` mijn-website/ ├── app/ ├── bootstrap/ ├── config/ │ └── statamic/ ├── content/ │ ├── collections/ │ ├── navigation/ │ ├── taxonomies/ │ └── globals/ ├── resources/ │ ├── views/ │ ├── css/ │ └── js/ ├── public/ ├── storage/ └── routes/ ``` ### Belangrijke configuratiebestanden - `config/statamic/cp.php` - Control Panel configuratie - `config/statamic/routes.php` - Route configuratie - `config/statamic/search.php` - Search configuratie - `config/statamic/stache.php` - Stache configuratie ### Custom code plaatsen - **Service Providers**: `app/Providers/` - **Middleware**: `app/Http/Middleware/` - **Commands**: `app/Console/Commands/` - **Listeners**: `app/Listeners/` ### Antlers templating ```html {{ title }} {{ content }} {{ collection:blog }} <article> <h2>{{ title }}</h2> <p>{{ excerpt }}</p> </article> {{ /collection:blog }} ``` --- ## Aanbevolen werkwijzen ### Versiebeheer - Gebruik Git voor versiebeheer - Commit nooit `.env` bestanden - Gebruik `.gitignore` voor Statamic specifieke bestanden ### Development workflow 1. Werk altijd op een feature branch 2. Test lokaal voordat je naar productie pusht 3. Gebruik migrations voor database wijzigingen 4. Documenteer custom functies en templates ### Performance optimalisatie - Gebruik Statamic's caching systeem - Optimaliseer afbeeldingen met Glide - Implementeer lazy loading waar mogelijk - Gebruik CDN voor statische assets ### Security - Houd Statamic en dependencies up-to-date - Gebruik environment variables voor gevoelige data - Implementeer rate limiting voor formulieren - Valideer gebruikersinput altijd ### Debugging ```php // Gebruik de debug helper dd($variable); // Of gebruik Statamic's log systeem \Log::debug('Debug message', ['data' => $data]); ``` ### Testing ```bash # Unit tests uitvoeren php artisan test # Specifieke test suite php artisan test --testsuite=Feature ``` --- ## Handige commando's ### Artisan commando's ```bash php artisan make:collection php artisan make:fieldset php artisan make:modifier php artisan make:scope php artisan make:tag ``` ### Statamic CLI commando's ```bash php please stache:clear php please stache:warm php please assets:generate-presets php please search:update php please update:run ``` ### Maintenance ```bash # Cache clearing php artisan cache:clear php artisan config:clear php artisan view:clear # Storage link php artisan storage:link ``` --- ## Troubleshooting ### Veelvoorkomende problemen **Probleem**: "Class not found" errors **Oplossing**: ```bash composer dump-autoload ``` **Probleem**: Control Panel laadt niet **Oplossing**: ```bash php artisan config:clear php artisan cache:clear ``` **Probleem**: Assets worden niet geladen **Oplossing**: ```bash npm run dev php artisan storage:link ``` --- ## Extra resources - [Statamic officiële documentatie](https://statamic.dev) - [Statamic Discord community](https://statamic.com/discord) - [Laravel documentatie](https://laravel.com/docs) Deze documentatie wordt bijgewerkt naarmate het project evolueert. Raadpleeg de `CHANGELOG.md` voor recente wijzigingen en updates.