- PHP 53.5%
- CSS 23.6%
- Twig 15.5%
- Shell 5.4%
- JavaScript 1.4%
- Other 0.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Group all minor and patch updates into a single PR, scheduled before 6am on Mondays alongside lock file maintenance. Majors still need dashboard approval; core majors stay grouped as "drupal core". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LKBdckmVM25yUD5aXmcQGX |
||
| .ddev | ||
| .setup | ||
| config/sync | ||
| deploy | ||
| docker | ||
| web | ||
| .dockerignore | ||
| .gitignore | ||
| .woodpecker.yml | ||
| CLAUDE.md | ||
| composer.json | ||
| composer.lock | ||
| Dockerfile | ||
| README.md | ||
| renovate.json | ||
Olympia Schaarbeek — website
Drupal 11 website voor Gymclub Olympia Schaarbeek, een turnclub in Schaarbeek (Brussel). De site toont het lesaanbod, het weekrooster, locaties, het team, nieuws en de agenda, met een contactformulier en inschrijflinks naar Gymfed.
Lokale ontwikkeling via DDEV; staging en productie via Woodpecker CI → Docker-image
→ docker compose achter Traefik.
Stack
| Onderdeel | Keuze |
|---|---|
| CMS | Drupal 11.3 (drupal/core-recommended ^11.3) |
| Runtime | PHP 8.4, nginx-fpm, MariaDB 11.8 |
| Admin-thema | Gin (+ gin_toolbar) |
| Front-thema | web/themes/custom/olympia — Bootstrap5-subthema, eigen CSS in css/olympia.css |
| Custom module | web/modules/custom/olympia_core — eigen hooks/helpers |
| Talen | Nederlands (standaard) + Engels, URL-prefixes /nl en /en |
| Front page | /aanbod (de Aanbod-view) |
| SMTP + HTML Mail + Mail System (postfix-relay → Brevo) | |
| CI/CD | Woodpecker → Docker-image → docker compose up op de host |
| Proxy | Traefik op het externe pangolin-netwerk, Let's Encrypt |
Belangrijke contrib-modules: Paragraphs, Smart Date + FullCalendar, Pathauto + Redirect, Webform + Honeypot, Media (+ Focal Point, PhotoSwipe), Content Moderation, Trash, Linkit, Simple Sitemap, Metatag, Address.
Lokale ontwikkeling (DDEV)
ddev start
ddev composer install
ddev import-db --file=dump.sql.gz # of bouw vers op (zie "Verse installatie")
ddev drush cr
ddev launch # opent https://olympia-website.ddev.site
Handig:
ddev drush uli # eenmalige login-link
ddev drush cr # cache rebuild
ddev ssh # shell in de web-container
Configuratie vs. content
Deze splitsing is centraal in het project:
- Config (content types, velden, displays, views, talen, …) leeft in
config/sync/en wordt versioneerd. Synchroniseer met:ddev drush cex -y # actieve config → config/sync/ ddev drush cim -y # config/sync/ → actieve config - Content (paragraphs, menu-links, redirects, het hero-blok, demo-nodes) is géén config
en wordt niet door
cimaangemaakt. Die wordt geseed via idempotente scripts in.setup/(zie hieronder). Op een bestaande database draaien die seeds bewust niet opnieuw — zie "Deployment".
Contentmodel
| Bundle | Pad | Kern |
|---|---|---|
| Les (lestype) | /aanbod/<titel> |
Emoji, leeftijd van–tot, omschrijving, hoofdfoto, prijs (€/jaar), inschrijfstatus (open/bijna volzet/volzet/wachtlijst), globale status (actief/tijdelijk inactief) |
| Lesmoment (roostermoment) | /uurrooster/<les>-<dag> |
Koppelt een Les aan locatie en Lesdagen (herhalende Smart Date, wekelijks over het seizoen); dag en begin-/eindtijd worden daaruit afgeleid. Prijs/inschrijfstatus erven van de Les. Zie "Start nieuw seizoen" |
| Locatie | /locaties/<titel> |
Adres (Address), parkeerinfo, OpenStreetMap-embed |
| Teamlid | /team/<titel> |
Bestuur + trainers, met rol-taxonomie |
| Nieuws | /nieuws/<jaar>/<titel> |
Nieuwsberichten, met categorie-taxonomie |
| Evenement | /agenda/<titel> |
Smart Date events, FullCalendar |
| Vacature | /vrijwilligers/<titel> |
Vrijwilligersoproepen |
| Pagina | /info/<titel> |
Info-pagina's opgebouwd uit Paragraphs-secties (tekstblok, links_lijst) |
| Landingpage | (handmatige alias) | Paragraph-gebaseerde paginabouwer |
De homepage (/aanbod) toont een bewerkbaar hero-blok (eigen bloktype hero, enkel op
<front>) gevolgd door de Aanbod-kaarten. Het hoofdmenu-item "Aanbod" scrollt via een anker
(#ons-aanbod) voorbij de hero.
Front-end & custom code
- Thema
olympia: Bootstrap5-subthema met eigen, handgeschrevencss/olympia.css(geen globale Bootstrap-stijlen). Twig-templates ondertemplates/per regio/bundle. olympia.themepreprocesst de les-/lesmoment-rendering: o.a. de statuspill-mapping (OLYMPIA_STATUS_*) en de weekdag-sortering van de lesmomenten op de les-detailpagina (_olympia_les_momenten()), en bubblet cache-tags van de gekoppelde Les zodat het rooster meteen meewijzigt.olympia_core(module) bevat eenhook_views_query_alterdie de Uurrooster-view in weekvolgorde (ma→zo) sorteert i.p.v. alfabetisch op de dagcode — op SQL-niveau, dus pagineringsveilig.
Verse installatie (vanaf nul)
De .setup/-map bevat genummerde scripts om de site van nul op te bouwen. Voor dit project:
# 1. Drupal core + install
bash .setup/install-1-base.sh
# 2. Modules + thema-stack (geconsolideerd voor Olympia)
bash .setup/install-olympia.sh
bash .setup/install-7-theme.sh # Bootstrap5-subthema + tooling
# 3. Config importeren
ddev drush cim -y
# 4. Content seeden (idempotent — volgorde telt)
ddev drush php:script .setup/setup-pathauto-menu.php
ddev drush php:script .setup/seed-demo.php
ddev drush php:script .setup/seed-info-pages.php
ddev drush php:script .setup/seed-contact-page.php
ddev drush php:script .setup/seed-trooper-page.php
ddev drush php:script .setup/setup-hero-block.php
ddev drush php:script .setup/seed-redirects.php
ddev drush cr
De canonieke seed-volgorde staat in
.woodpecker.yml(sectiedeploy_*). De generiekeinstall-2..install-9-scripts zijn de stap-voor-stap-variant vaninstall-olympia.sh.
Deployment
Een push naar staging of main triggert Woodpecker:
- Bouwt een Docker-image (
olympia/drupal:stagingof:prod). - Kopieert de juiste compose-file naar
/opt/stacks/<project>/compose.yamlen doetdocker compose up -d. - Eerste deploy op een lege DB:
drush site:install --existing-config(profiel uitconfig/sync). - Elke deploy:
drush updatedb+drush cim+drush cr. - Alleen op een verse DB: de content-seeds uit
.setup/. Op een bestaande omgeving draaien die niet, zodat ze geen door redacteurs bewerkte content overschrijven of dupliceren (FRESH-DB-guard in.woodpecker.yml).
Omdat menu-links content zijn, deployen wijzigingen eraan (zoals het #ons-aanbod-anker op
"Aanbod") niet mee — die pas je eenmalig aan in de UI of via een drush-eval op de
betreffende omgeving.
| Omgeving | URL | Branch |
|---|---|---|
| Staging | https://staging.olympiaschaarbeek.be | staging |
| Productie | https://olympiaschaarbeek.be (www → 301 apex) | main |
Vereiste Woodpecker-secrets (per omgeving): OLYMPIA_{STAGING,PROD}_DB_NAME,
…_DB_USER, …_DB_PASSWORD, …_HASH_SALT.
Start nieuw seizoen
Elk lesmoment heeft een veld Lesdagen: een wekelijkse reeks van de eerste tot de laatste
les van het seizoen, zonder vakanties en feestdagen. De agenda (/agenda), de iCal-feeds
(/agenda.ics, /les/<id>/agenda.ics) en de lespagina's lezen daaruit. Een reeks stopt aan
het einde van het seizoen, dus elk jaar moet er een nieuwe komen. Doe dit in de zomer, zodra
het nieuwe uurrooster vastligt en vóór de eerste les.
-
Uurrooster bijwerken (in de UI, door bestuur of redactie):
- Lessen en lesmomenten toevoegen, wijzigen of verwijderen.
- Dag of uur van een lesmoment wijzigen = de eerste les in Lesdagen aanpassen; dag en uren volgen daaruit. De rest van de reeks maakt stap 3 opnieuw.
- Een nieuw lesmoment heeft verplicht een eerste les nodig in Lesdagen, op de juiste weekdag en uren. Een herhaling instellen hoeft niet; dat doet stap 3.
- Optioneel: een term voor het nieuwe seizoen toevoegen (Structuur → Taxonomie → Seizoen) en op de lesmomenten zetten. Dat is puur administratief; er wordt nergens op gefilterd.
-
Sluitingskalender maken. Kopieer het kalenderbestand van vorig seizoen:
cp .setup/sluitingsdagen-2026-2027.php .setup/sluitingsdagen-2027-2028.phpPas daarin aan:
seizoen: eerste en laatste mogelijke lesdag.gesloten: alle schoolvakanties en feestdagen, als[van, tot](beide inclusief).
De club volgt de Vlaamse schoolkalender (vlaanderen.be — schoolvakanties) en sluit op alle feestdagen. Extra clubsluitingen (zaal niet beschikbaar, …) komen erbij. Commit en push naar
staging, daarna merge naarmain. -
Lesdagen vervangen, na de deploy, eerst op staging en dan op prod:
docker exec olympia-drupal-staging drush php:script .setup/backfill-lesdagen.php opnieuw docker exec olympia-drupal-prod drush php:script .setup/backfill-lesdagen.php opnieuw- Het script neemt automatisch het nieuwste
sluitingsdagen-*.php; een ander bestand geef je mee als argument vóóropnieuw. - Per lesmoment toont het hoeveel lesdagen er zijn en hoeveel er geschrapt werden.
- Lesmomenten zonder dag of uren worden overgeslagen en gemeld.
- Lokaal:
ddev drush php:script .setup/backfill-lesdagen.php opnieuw.
⚠️
opnieuwvervangt de lesdagen van álle lesmomenten. De lessen van het oude seizoen verdwijnen uit de agenda, net als handmatig geschrapte of verplaatste lessen (Instanties beheren). Gebruik het dus één keer, bij de seizoensstart, en niet midden in een seizoen. - Het script neemt automatisch het nieuwste
-
Controleren:
/nl/agenda,/nl/agenda.icsen de knoppen op een lespagina. Bestaande abonnees hoeven niets te doen: de feed-URL's blijven dezelfde. Apple Agenda en Infomaniak pikken de wijziging snel op; Google Agenda ververst pas na maximaal een dag.
Midden in een seizoen:
- Eén les valt uit of verschuift: open het lesmoment → Lesdagen → Instanties beheren → Remove Instance of Overschrijven. Standaard herstellen zet de les terug.
- Extra sluitingsdag voor de hele club: voeg hem toe aan het kalenderbestand, deploy, en
draai het script zonder
opnieuw. Dat schrapt de nieuwe dag bij alle lesmomenten en laat de rest ongemoeid; nogmaals draaien maakt geen dubbels. - Nieuw lesmoment: vul Lesdagen in met de eerste les en een wekelijkse herhaling tot de
laatste les. Draai daarna het script zonder
opnieuwom de vakanties eruit te halen, of schrap ze met de hand via Instanties beheren.
Projectstructuur
.setup/ install- en seed-scripts
config/sync/ Drupal-config (cex/cim)
deploy/ docker-compose per omgeving (prod, staging)
docker/ nginx, php.ini, supervisord, entrypoint, settings.docker.php
recipes/ Drupal-recipes
web/
modules/custom/olympia_core/ eigen hooks (o.a. uurrooster-sortering)
themes/custom/olympia/ Bootstrap5-subthema (CSS, Twig, preprocess)
sites/default/ settings.php (geen secrets; prod gebruikt docker/settings.docker.php)
.woodpecker.yml CI/CD-pijplijn (build + deploy + seeds)
CLAUDE.md werkinstructies voor Claude Code
Veelgebruikte commando's
ddev drush cr # cache rebuild
ddev drush cex -y / cim -y # config export / import
ddev drush updatedb -y # db-updates na module-/core-update
ddev drush uli # login-link
ddev composer require drupal/<module>