Advertenties in Joomla

1. De basis

1.1 De drie bouwstenen

De hele component draait om drie eenvoudige concepten. Zodra je begrijpt hoe die met elkaar samenhangen, valt de rest op zijn plek.

De relatie is makkelijk te onthouden: een advertentie hoort bij één categorie en optioneel bij één adverteerder.

1.2 Hoe de onderdelen samenhangen

Dit is het denkmodel:

Client  ─┐
         ├─ Advertentie ─ Category
Volgen  ─┘   (creative)   (grouping)

• Advertentie is wat bezoekers daadwerkelijk zien.
• Adverteerder is voor wie de advertentie is en bevat de standaard trackinginstellingen.
• Categorie is hoe je advertenties groepeert, zodat een module ze daaruit kan ophalen.
• Volgen is het logboek van impressies en klikken.

1.3 Waar je het vindt

In de Joomla 6-backend vind je de component onder het menu Componenten:

Componenten → Advertenties → Advertenties  (de uitingen)
Componenten → Advertenties → Categorieën   (groepering)
Componenten → Advertenties → Adverteerders (adverteerders)
Componenten → Advertenties → Volgen        (impressie- / kliklog)

De weergave aan de voorkant wordt apart afgehandeld, via een module:

Systeem → Website-modules → Nieuw → Advertenties   (mod_banners)

Onthoud dit onderscheid: de component slaat de data op en beheert die, de module toont de advertenties op de website.

1.4 Twee soorten advertenties

Op het bewerkscherm van een advertentie bepaalt het veld Type de rest:

Bij een Afbeelding-advertentie bouwt Joomla de <a><img></a>-markup voor je. Bij een Aangepast-advertentie bepaal je de markup volledig zelf, wat ideaal is voor responsive advertenties of tags van derden. Zoals we in sectie 8 zullen zien, brengt die vrijheid ook een beveiligingsrisico met zich mee.

3. Advertenties tonen met mod_banners

3.1 De module is de aflevermotor

Dit is het belangrijkste om te begrijpen: een advertentie doet niets totdat een advertentie-module hem rendert. De component slaat de gegevens op, maar mod_banners selecteert en toont de advertentie.

Advertentie (data)  →  mod_banners (selectie + renderen)  →  modulepositie

Maak de module aan via Systeem → Website-modules → Nieuw → Advertenties en wijs hem vervolgens toe aan een positie en de menu-items waarop hij moet verschijnen.

3.2 Module-opties

De module-opties bepalen welke advertenties in aanmerking komen en hoe ze worden weergegeven:

3.3 Volgorde en rotatie

De selectiequery sorteert advertenties op twee manieren, afhankelijk van de instelling Willekeurige volgorde:

ORDER BY sticky DESC, ordering        -- "Sticky-volgorde"
ORDER BY sticky DESC, RAND()          -- "Sticky, willekeurig"

De logica is eenvoudig:

• Sticky-advertenties komen altijd eerst.
• Binnen hetzelfde sticky-niveau kies je een vaste of willekeurige volgorde.
• Aantal bepaalt vervolgens hoeveel van die advertenties daadwerkelijk worden weergegeven.

3.4 Trefwoordtargeting in de praktijk

Met trefwoordtargeting kun je relevante advertenties tonen per pagina zonder voor elke pagina een aparte module te maken. Dat werkt in drie stappen:

1. Vul bij de advertentie Trefwoorden in, bijvoorbeeld joomla, hosting.
2. Schakel Zoeken op trefwoorden in bij de module.
3. Op een pagina waarvan de meta-trefwoorden hosting bevatten, komt die advertentie in aanmerking voor weergave.

Eén module kan zo verschillende advertenties tonen op verschillende pagina's, afhankelijk van het onderwerp van de pagina.

3.5 Template-overrides

De module wordt geleverd met één layout die je volledig kunt overschrijven. Dit is de juiste plek om de weergave van advertenties aan te passen:

modules/mod_banners/tmpl/default.php                       ← de standaardlayout
templates/your_template/html/mod_banners/default.php       ← jouw override

Gebruik een override om zaken te bouwen die de standaardlayout niet biedt:

• Sponsoroverzichten of Bootstrap-cards.
• Sliders en carrousels.
• Lazy-loaded, responsieve <picture>-markup.

Het principe is hetzelfde als elders in Joomla: data en presentatie blijven gescheiden. Je overschrijft de weergave, niet het model. Eén tip: de standaardlayout voegt al rel="noopener noreferrer" toe aan links die in een nieuw tabblad openen. Behoud dat voor de veiligheid.

3.6 Caching versus nauwkeurige impressietelling

Dit is een subtiel maar belangrijk punt. Een impressie is een dynamische schrijfactie bij elke weergave. Caching voorkomt juist opnieuw renderen. Caching en nauwkeurige telling werken dus tegen elkaar in.

Hoe agressiever je cachet, hoe meer impmade de werkelijke weergaven onderschat. Heb je nauwkeurige cijfers nodig, sluit advertentiemodules dan uit van caching. Anders moet je accepteren dat de tellingen een minimum aangeven en niet het totale aantal weergaven.

5. Beveiliging van aangepaste advertenties

5.1 Aangepaste HTML wordt ongewijzigd opgeslagen

Deze sectie verdient speciale aandacht, omdat dit het punt is dat mensen het vaakst over het hoofd zien. Aangepaste HTML-advertenties worden precies opgeslagen zoals je ze invoert. Joomla filtert of ontsmet deze code niet.

custombannercode   →  filter="raw"     (in banner.xml)
clickurl           →  filter="url"     (URL-validatie)

De klik-URL wordt gevalideerd, maar de markup van een aangepaste advertentie niet.

5.2 Waarom dit belangrijk is

Omdat aangepaste code ongewijzigd wordt opgeslagen, kan een advertentiebeheerder die een <script>-tag invoegt, opgeslagen cross-site scripting (XSS) veroorzaken op elke pagina waarop de module verschijnt. De gevolgen zijn praktisch:

• Geef alleen vertrouwde gebruikersgroepen toestemming om aangepaste advertenties te maken. Regel dit via ACL (zie sectie 6).
• Gebruik bij voorkeur Afbeelding-advertenties voor advertenties die door adverteerders worden aangeleverd.
• Reserveer Aangepaste-advertenties voor je eigen medewerkers.

Een eenvoudige vuistregel: afbeeldingsadvertenties zijn veilig door hun opzet, terwijl aangepaste advertenties veiligheid inruilen voor volledige controle. De doorverwijzing controleert de doel-URL, maar de markup blijft jouw verantwoordelijkheid.

7. Onder de motorkap (voor ontwikkelaars)

7.1 Drie tabellen

De volledige component draait op drie specifieke tabellen:

#__banners          de advertenties + tellers + targeting
#__banner_clients   adverteerders + standaard tracking / aankooptype
#__banner_tracks    uurlijkse samenvatting van klikken / impressies

Daarnaast gebruikt de component records in de gedeelde tabel #__categories, waarbij extension = com_banners.

7.2 Belangrijke kolommen in #__banners

De hoofdtafel bevat de advertentieinhoud, de tellers en de targeting op één plek:

type                0 = afbeelding, 1 = aangepaste HTML
custombannercode    ruwe markup voor aangepaste advertenties
params              JSON: imageurl, width, height, alt, ...
cid                 adverteerder-id  (→ #__banner_clients)
catid               categorie-id (→ #__categories)
imptotal / impmade  impressielimiet / aantal impressies
clicks              aantal klikken
sticky              altijd bovenaan in de rotatie
state               gepubliceerd / gedepubliceerd / gearchiveerd / verwijderd
metakey             trefwoorden voor targeting
own_prefix / metakey_prefix    aangepaste prefixmatching
track_clicks / track_impressions   -1 overnemen, 0 uit, 1 aan
purchase_type       -1 overnemen, anders factureringscyclus
reset               wanneer tellers worden gereset
language            '' = alle talen, of een taalcode

7.3 De MVC-structuur

De code is verdeeld over drie locaties volgens de standaard Joomla-structuur:

administrator/components/com_banners/   ← beheer van advertenties, adverteerders en tracking
   src/Model, src/Table, src/Controller, tmpl/, forms/

components/com_banners/                  ← frontend klikken + selectie
   src/Model/BannersModel.php   (selectie + impressies)
   src/Model/BannerModel.php    (enkele advertentie + kliktracking)
   src/Controller/DisplayController.php

modules/mod_banners/                     ← toont de geselecteerde advertenties
   src/Helper/BannersHelper.php
   tmpl/default.php

7.4 De selectiequery

BannersModel::getBannerQuery() bouwt ongeveer deze query om geschikte advertenties te selecteren:

SELECT a.*
FROM #__banners AS a
LEFT JOIN #__banner_clients AS cl ON cl.id = a.cid
LEFT JOIN #__categories     AS cat ON cat.id = a.catid
WHERE a.state = 1
  AND (a.publish_up   IS NULL OR a.publish_up   <= :now)
  AND (a.publish_down IS NULL OR a.publish_down >= :now)
  AND (a.imptotal = 0 OR a.impmade < a.imptotal)
  AND cl.state = 1
  [AND a.catid IN (:categories)]
  [AND keyword/metakey REGEXP conditions]
ORDER BY a.sticky DESC, a.ordering   -- of RAND()

Deze ene query verklaart het grootste deel van het gedrag dat eerder is beschreven: publicatiestatus, publicatieperiode, impressielimieten, adverteerderstatus en sortering worden hier allemaal bepaald.

7.5 Trefwoordmatching is echte SQL

Wanneer zoeken op trefwoorden is ingeschakeld, vergelijkt Joomla elk paginatrefwoord met een reguliere expressie tegen de metatrefwoorden van de advertentie, adverteerder én categorie:

$regexp = $db->getServerType() === 'mysql'
    ? '\\b' . $keyword . '\\b'                 // MySQL / MariaDB
    : '[[:<:]]' . $keyword . '[[:>:]]';        // PostgreSQL

Daarnaast bestaat de eigen-prefix-logica: een advertentie kan overeenkomen met een prefix van een trefwoord in plaats van met het volledige woord. Daarmee kun je zeer gericht targeten zonder exacte overeenkomsten te vereisen.

7.6 Tokens in aangepaste advertentiecode

Voor aangepaste advertenties kan custombannercode tijdelijke aanduidingen bevatten die mod_banners tijdens het renderen vervangt:

{CLICKURL}   → de getrackte klik-URL
{NAME}       → de advertentienaam

Dat is een handig detail: een handgeschreven <a>- of <script>-advertentie kan zo toch gebruikmaken van Joomla's kliktracking, zodat je statistieken behouden blijven.

7.7 Programmatic access

Dezelfde Categories API die artikelen ondersteunt, werkt ook voor advertenties:

use Joomla\CMS\Categories\Categories;

$categories = Categories::getInstance('Banners');
$node       = $categories->get('sponsors');   // via alias of ID
$children   = $node->getChildren();

De tabel- en modelklassen bevinden zich in voorspelbare namespaces:

Joomla\Component\Banners\Administrator\Table\BannerTable
Joomla\Component\Banners\Site\Model\BannersModel

7.8 Web Services API (headless)

De component bevat standaard een REST API, waardoor advertenties en adverteerders ook headless beschikbaar zijn:

api/components/com_banners/
   src/Controller/BannersController.php
   src/Controller/ClientsController.php
   src/View/Banners, src/View/Clients

GET  /api/index.php/v1/banners
GET  /api/index.php/v1/banners/clients

Dat maakt moderne architecturen mogelijk waarbij de gegevens in Joomla staan, maar de presentatie elders plaatsvindt:

Joomla API  →  React / Vue frontend  →  aangepaste advertentierendering

Let wel op: API-weergave omzeilt mod_banners, waardoor je impressies en klikken zelf moet registreren.

7.9 Gedrag op grote schaal

Het model is eenvoudig, maar bij grote installaties zijn er enkele aandachtspunten:

Tracking is bewust ontworpen om compact te blijven dankzij uurlijkse verzamelingen. Op lange termijn bestaat het belangrijkste onderhoudswerk uit het archiveren van gegevens in #__banner_tracks.

9. Best practices

Als je maar een paar dingen uit dit artikel onthoudt, laat het dan deze zijn:

• Maak eerst de adverteerder aan, daarna de advertentie en vervolgens de module die de advertentie toont.
• Gebruik afbeeldingsadvertenties voor advertentiemateriaal van adverteerders en reserveer aangepaste advertenties voor vertrouwde medewerkers.
• Gebruik de impressielimiet om exact het aantal weergaven te leveren waarvoor een adverteerder heeft betaald.
• Sluit advertentiemodules uit van caching als je nauwkeurige impressiecijfers nodig hebt.
• Gebruik categorieën om advertenties te groeperen in rotatiepools per campagne of sponsor.
• Archiveer #__banner_tracks regelmatig op drukbezochte websites.

11. Samenvatting

Joomla's Advertenties is een complete, zelfgehoste advertentieserver die zich verborgen houdt in Joomla. Zodra je het op die manier bekijkt, zie je de component niet langer als een eenvoudige afbeelding-uploader, maar als een compact en krachtig advertentiesysteem.

Het biedt onder andere:

• Weergave: rotatie, sticky-prioriteit, aantallen en willekeurige volgorde.
• Targeting: op trefwoord, categorie, adverteerder en taal.
• Limieten: impressielimieten, planning en factureringscycli.
• Analyse: first-party tracking van impressies en klikken.
• Integratie: de gedeelde categoriestructuur, ACL en een overzichtelijk MVC-model.
• Privacy: geen extern advertentienetwerk en standaard geen cookies.

De gegevens staan in Joomla, maar de weergave kan overal plaatsvinden, van een klassieke module tot een headless React-frontend. De belangrijkste regel om te onthouden is de scheiding van verantwoordelijkheden: de component beheert de gegevens, de module toont ze en de template-override bepaalt hoe ze eruitzien.

Als je betaalde advertenties, interne promoties of sponsorrotaties beheert en je wilt deze tellen, begrenzen en targeten zonder afhankelijk te zijn van een extern advertentienetwerk, dan heeft Joomla's Advertenties alles al in huis. De uitdaging zit niet in de functionaliteit. De uitdaging is weten dat die er is.