Website voor Olympia Schaarbeek
  • PHP 53.5%
  • CSS 23.6%
  • Twig 15.5%
  • Shell 5.4%
  • JavaScript 1.4%
  • Other 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
bdu f516f75a1a
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
chore(renovate): bundle minor/patch updates into one weekly PR
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
2026-11-19 20:37:10 +00:00
.ddev updates 2026-09-12 18:07:56 +02:00
.setup nieuw seizoen starten 2026-10-14 19:47:36 +02:00
config/sync Agenda: abonneerknoppen + Google-uitleg onder de kalender, legende terug 2026-10-03 21:47:37 +02:00
deploy fix(www): 301 www→apex in nginx i.p.v. Traefik-middleware 2026-06-17 23:20:48 +02:00
docker refactor(deploy): move deploy steps into docker/deploy.sh 2026-10-21 19:11:12 +02:00
web revert(trash): remove deleted-field post-updates 2026-10-21 19:50:04 +02:00
.dockerignore deploying 2026-05-17 22:13:56 +02:00
.gitignore chore(git): negeer lokaal woodpecker-secretscript 2026-08-22 18:40:56 +02:00
.woodpecker.yml refactor(deploy): move deploy steps into docker/deploy.sh 2026-10-21 19:11:12 +02:00
CLAUDE.md Initial commit 2026-04-02 18:46:24 +02:00
composer.json fix(deps): update dependency drupal/add_content_by_bundle to v2 2026-10-14 18:25:35 +00:00
composer.lock upgrade 2026-11-19 18:22:23 +01:00
Dockerfile refactor(deploy): move deploy steps into docker/deploy.sh 2026-10-21 19:11:12 +02:00
README.md nieuw seizoen starten 2026-10-14 19:47:36 +02:00
renovate.json chore(renovate): bundle minor/patch updates into one weekly PR 2026-11-19 20:37:10 +00:00

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)
Mail 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 cim aangemaakt. Die wordt geseed via idempotente scripts in .setup/ (zie hieronder). Op een bestaande database draaien die seeds bewust niet opnieuw — zie "Deployment".

Content­model

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, handgeschreven css/olympia.css (geen globale Bootstrap-stijlen). Twig-templates onder templates/ per regio/bundle.
  • olympia.theme preprocesst 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 een hook_views_query_alter die 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 (sectie deploy_*). De generieke install-2..install-9-scripts zijn de stap-voor-stap-variant van install-olympia.sh.

Deployment

Een push naar staging of main triggert Woodpecker:

  1. Bouwt een Docker-image (olympia/drupal:staging of :prod).
  2. Kopieert de juiste compose-file naar /opt/stacks/<project>/compose.yaml en doet docker compose up -d.
  3. Eerste deploy op een lege DB: drush site:install --existing-config (profiel uit config/sync).
  4. Elke deploy: drush updatedb + drush cim + drush cr.
  5. 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.

  1. 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.
  2. Sluitingskalender maken. Kopieer het kalenderbestand van vorig seizoen:

    cp .setup/sluitingsdagen-2026-2027.php .setup/sluitingsdagen-2027-2028.php
    

    Pas 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 naar main.

  3. 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óór opnieuw.
    • 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.

    ⚠️ opnieuw vervangt 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.

  4. Controleren: /nl/agenda, /nl/agenda.ics en 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 opnieuw om 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>