📁 Basis & template inheritance
Mappen, prosilver en de configuratie van je eigen child style.
Op deze pagina
1. 📁 De structuur van een phpBB-stijl
Alle stijlen bevinden zich in:
/styles/Een eenvoudige eigen stijl kan bijvoorbeeld deze structuur hebben:
styles/
└── mijnstijl/
├── template/
│ ├── overall_header.html
│ └── index_body.html
│
├── theme/
│ ├── images/
│ │ └── background.jpg
│ ├── stylesheet.css
│ └── custom.css
│
└── style.cfgDe belangrijkste onderdelen zijn:
template/ Bevat de HTML/Twig-templates waarmee phpBB zijn pagina's opbouwt.
theme/ Bevat de CSS-bestanden, afbeeldingen en andere onderdelen die het uiterlijk bepalen.
style.cfg Vertelt phpBB welke stijl dit is, welke versie hij heeft en eventueel van welke andere stijl hij overerft.
2. 🧱 Kies een goede basis
Voor een eerste stijl is prosilver bijna altijd de beste basis.
Waarom?
- prosilver wordt standaard met phpBB geleverd.
- De templates bevatten alle belangrijke phpBB-functies.
- De meeste extensies worden in eerste instantie voor prosilver ontwikkeld.
- De nodige template events zijn aanwezig.
- Nieuwe phpBB-functies worden eerst in prosilver verwerkt.
Je hoeft prosilver echter niet volledig te kopiëren.
Een veel betere oplossing is een zogenaamde child style.
Je eigen stijl gebruikt dan automatisch prosilver voor bestanden die je zelf niet hebt toegevoegd.
3. ⚙️ Het bestand style.cfg maken
Maak in:
styles/mijnstijl/een bestand:
style.cfgEen eenvoudige configuratie ziet er bijvoorbeeld zo uit:
#
# phpBB Style Configuration File
#
name = Mijn Stijl
copyright = © Jouw naam, 2026
style_version = 1.0.0
phpbb_version = 3.3.19
parent = prosilverBetekenis:
- name = naam die in het beheerderspaneel wordt weergegeven.
- copyright = auteur/copyrightinformatie.
- style_version = versie van jouw stijl.
- phpbb_version = phpBB-versie waarvoor de stijl bedoeld is.
- parent = de stijl waarvan je templates wilt overerven.
In ons voorbeeld:
parent = prosilverDat betekent dat phpBB eerst in jouw eigen stijl kijkt.
Bestaat een template daar niet?
Dan kijkt phpBB automatisch in:
styles/prosilver/template/4. 🌳 Hoe template inheritance werkt
Template inheritance is één van de handigste functies van het phpBB-stijlsysteem.
Stel dat je alleen de header wilt aanpassen.
Dan hoef je niet heel prosilver te kopiëren.
Je maakt alleen:
styles/mijnstijl/template/overall_header.htmlphpBB gebruikt vervolgens:
mijnstijl/template/overall_header.htmlvoor de header.
Voor alle andere templates die ontbreken gebruikt phpBB automatisch:
prosilver/template/Bijvoorbeeld:
Mijn Stijl
│
├── overall_header.html ← eigen bestand
│
├── index_body.html ← eigen bestand
│
└── overige templates
↓
prosilverDat maakt je stijl veel kleiner én eenvoudiger te onderhouden.
Kopieer alleen een template uit prosilver wanneer je die daadwerkelijk gaat aanpassen.
