Home ↗ Forum ↗
Stijlontwikkeling · phpBB 3.3.x · deel 2 van 4

🎨 CSS, templates & events

Vormgeving, templatebestanden, Twig, extensies en afbeeldingen.

Op deze pagina

5. 🎨 De CSS van je stijl

Templates worden automatisch overgeërfd.

Voor CSS werkt dat anders.

CSS-bestanden van een parent-style worden niet automatisch door phpBB geladen.

Je moet dus zelf bepalen welke stylesheets je gebruikt.

Een veelgebruikte oplossing is om vanuit je eigen:

theme/stylesheet.css

eerst de CSS van prosilver te laden en daarna je eigen wijzigingen. Een eenvoudige start ziet er zo uit:

/* theme/stylesheet.css */
@import url("../../prosilver/theme/stylesheet.css");
@import url("custom.css");

De volgorde is belangrijk: je eigen CSS komt na de basisstijl en kan daardoor eigenschappen overschrijven. Het tweede bestand heet bijvoorbeeld:

theme/custom.css

kan je vervolgens je eigen ontwerp plaatsen:

body {
    background: #11151b;
    color: #dce4ec;
}

.forabg,
.forumbg {
    border-radius: 8px;
}

a {
    color: #5dade2;
}
💡 Tip

Een apart bestand zoals custom.css maakt het veel makkelijker om later je eigen wijzigingen terug te vinden.

💡 Tip

Voor een volledig functionele child style kunnen ook extra bestanden en stylesheets nodig zijn, bijvoorbeeld voor printweergave, rechts-naar-links-talen of taalspecifieke onderdelen. Vergelijk de includes in prosilver en test alle phpBB-schermen.

6. 🧩 Belangrijke templates

phpBB bevat behoorlijk wat templates, maar een aantal kom je tijdens het ontwerpen veel vaker tegen.

overall_header.html

Bevat onder andere:

  • de HTML-header;
  • logo;
  • hoofdnavigatie;
  • stylesheets;
  • JavaScript;
  • begin van de pagina.

overall_footer.html

Bevat onder andere:

  • footer;
  • phpBB copyright;
  • JavaScript;
  • einde van de pagina.

index_body.html

Bepaalt grote delen van de forumindex.

viewforum_body.html

Wordt gebruikt bij het bekijken van een forum en de onderwerpenlijst.

viewtopic_body.html

Wordt gebruikt wanneer je een onderwerp bekijkt.

posting_layout.html

Bevat onderdelen van het scherm waarmee berichten worden geschreven of aangepast.

ucp_*.html

Templates van het gebruikerspaneel.

mcp_*.html

Templates van het moderatorpaneel.

7. 🧬 Template events niet verwijderen

Dit is erg belangrijk.

In phpBB-templates kom je regels tegen zoals:

<!-- EVENT overall_header_head_append -->

of:

<!-- EVENT overall_footer_after -->

Dit zijn template events.

Extensies gebruiken deze punten om automatisch HTML, JavaScript of andere onderdelen aan een pagina toe te voegen.

Verwijder je zo'n event, dan kan een extensie plots niet meer correct zichtbaar zijn in je stijl.

Daarom is prosilver zo'n goede basis: het bevat de officiële template events op de juiste plaatsen.

⚠️ Let op

Verwijder of verplaats template events alleen wanneer je precies weet wat de gevolgen zijn.

8. 🧠 phpBB-templatevariabelen

In templates kom je variabelen tegen zoals:

{SITENAME}
{USERNAME}
{PAGE_TITLE}

In moderne phpBB-versies kan je ook Twig-syntaxis tegenkomen:

{{ SITENAME }}
{{ USERNAME }}

Deze waarden worden door phpBB ingevuld.

Voorwaardelijke code kan bijvoorbeeld voorkomen als:

<!-- IF S_USER_LOGGED_IN -->
    Welkom terug!
<!-- ENDIF -->

Met Twig kan hetzelfde principe bijvoorbeeld worden geschreven als:

{% if S_USER_LOGGED_IN %}
    Welkom terug!
{% endif %}

phpBB gebruikt Twig als basis van zijn template-engine.

9. 🔌 Vergeet {$STYLESHEETS} niet

In de header van een stijl staat een belangrijk phpBB-onderdeel:

{$STYLESHEETS}

Extensies kunnen hiermee hun eigen CSS aan de pagina toevoegen.

Een extensie kan bijvoorbeeld gebruiken:

<!-- INCLUDECSS mijn_extensie.css -->

phpBB verzamelt deze bestanden en voegt ze via:

{$STYLESHEETS}

aan de uiteindelijke pagina toe.

⚠️ Let op

Verwijder {$STYLESHEETS} daarom nooit zomaar uit overall_header.html. Anders kunnen extensies hun CSS niet meer correct laden.

10. 🖼️ Afbeeldingen gebruiken

Afbeeldingen voor je stijl plaats je het best in:

styles/mijnstijl/theme/images/

Bijvoorbeeld:

theme/
└── images/
    ├── background.jpg
    ├── header.png
    └── pattern.png

Vanuit CSS kan je ze bijvoorbeeld gebruiken met:

body {
    background-image: url("./images/background.jpg");
}

Probeer afbeeldingen die bij je stijl horen ook daadwerkelijk in je stijlpakket te bewaren.

Zo is je stijl niet afhankelijk van externe websites.