Contact­­ personen in Joomla

1. De basis

1.1 De twee bouwstenen

De component is gebaseerd op twee eenvoudige concepten. Zodra je begrijpt hoe ze met elkaar samenhangen, valt de rest vanzelf op zijn plaats.

De relatie is eenvoudig te onthouden: een contact hoort bij precies één categorie. Dit is dezelfde nested-set categorieboom die ook door artikelen wordt gebruikt.

1.2 Hoe de onderdelen samenwerken

Zie het als volgt:

Categorie ── Contact ──┬── Contactformulier → e-mail
                       ├── vCard           → download
                       └── Gekoppelde gebruiker → profiel + auteursartikelen

• Contact bevat de gegevens: wie iemand is, waar die zich bevindt en hoe je contact kunt opnemen.
• Categorie bepaalt hoe je contacten groepeert voor lijstweergaven en toegangsbeheer.
• Formulier is een optioneel e-mailformulier per contact.
• Gekoppelde gebruiker verbindt een contact aan een account in #__users.

Een handige manier om dit te onthouden: com_contact is een gestructureerd adresboek waarbij elke vermelding ook een werkend contactformulier kan zijn.

1.3 Waar vind je het?

In de Joomla 6-beheeromgeving beheer je contacten en categorieën hier:

Componenten → Contactpersonen → Contactpersonen  (de personen en locaties)
Componenten → Contactpersonen → Categorieën      (groepering)

De weergave aan de voorkant van de website wordt aangestuurd door menu-items:

Menu's → Nieuw → Contactpersonen → (Enkel contactpersoon / Lijst met contactpersonen in een categorie / Speciale contactpersonen / Lijst met alle categorieën in een contact categoriestructuur)

1.4 Welke gegevens bevat een contactpersoon?

Het scherm voor het bewerken van een contact verdeelt de velden over verschillende tabbladen:

Het adresblok bevat onder andere: functie, adres, plaats, provincie/staat, land, postcode, telefoon, mobiel, fax, e-mail en website.

3. Contacten weergeven

3.1 Een contact doet niets zonder een menu-item

Zoals de meeste Joomla-content is een contact slechts data totdat een menu-item (of een module of plugin) het weergeeft. Er zijn vier typen menu-items:

3.2 De weergave van een enkel contact

De weergave van een enkel contact wordt bepaald door het tabblad Weergave van het contact en de opties van het menu-item. Een typische lay-out ziet er zo uit:

[ afbeelding ]   Naam
                 Functie
                 Adresblok (elke regel afzonderlijk in- of uitschakelbaar)
                 Telefoon / Mobiel / Fax / E-mail / Website
                 Aanvullende informatie
                 Links (linka...linke)
                 Contactformulier

Voor elke regel bestaat een instelling Tonen / Verbergen / Globale instelling gebruiken. De standaardwaarden worden ingesteld in de Opties van de component.

3.3 De drie niveaus van overerving

Of een veld wordt weergegeven, wordt in deze volgorde bepaald, van meest specifiek naar meest algemeen:

Contact (tabblad Weergave)     Tonen / Verbergen / Globale instelling gebruiken
   └─ Opties van menu-item     Tonen / Verbergen / Globale instelling gebruiken
        └─ Componentopties     (globale standaardinstelling)

"Globale instelling gebruiken" vormt de verbindende schakel. Stel een waarde één keer in via Opties en overschrijf die alleen per menu-item of per contact waar dat echt nodig is.

3.4 Lijst- en categorieweergaven

• De Lijstweergave toont een sorteerbare tabel met onder andere naam, functie en telefoonnummer.
• Kolommen, zoekfilters en paginering zijn allemaal instelbaar via de opties van het menu-item.
• De Categorieweergave toont de categorieboom, waarbij elke categorie naar zijn eigen lijst verwijst.

3.5 vCard downloaden

Elk contact kan een downloadbare vCard aanbieden (een .vcf-bestand). Dit is het standaardformaat dat door vrijwel elk adresboek wordt ondersteund.

allow_vcard = 1   →   link "Contactgegevens downloaden" in de contactweergave

• Joomla bevat hiervoor een speciale weergave: src/View/Contact/VcfView.php.
• Deze zet naam, functie, adresgegevens, telefoonnummer, e-mail en website om naar een .vcf-bestand.
• Bezoekers hoeven slechts één keer te klikken om het contact rechtstreeks aan hun telefoon of e-mailprogramma toe te voegen.

Schakel vCard-download toestaan in via het tabblad Weergave (of globaal via Opties). Eén instelling, geen extra werk: een adresboek dat zichzelf kan exporteren.

5. Categorieën en toegangsbeheer

5.1 Contacten gebruiken het gedeelde categoriesysteem

Contactcategorieën zijn gewone Joomla-categorieën met extension = com_contact:

#__categories  WHERE extension = 'com_contact'

Dat betekent dat ze dezelfde categorieboom, dezelfde knop Opnieuw opbouwen en hetzelfde ACL-systeem gebruiken als artikelcategorieën.

5.2 Waarom categorieën hier belangrijk zijn

• Een menu-item van het type Lijst of Categorieën richt zich op een categorie, die vervolgens je contactoverzicht vormt.
• Je kunt contacten organiseren op afdeling, kantoor, regio of team.
• Rechten worden overgeërfd binnen de categorieboom (Aanmaken, Bewerken, Status wijzigen, Verwijderen).

Voor details over het nested-set-model met lft en rgt, zie het artikel "Focus op Categorieën".

5.3 Toegang en taal

• Het Toegangsniveau van een contact bepaalt wie het kan bekijken.
• Met de instelling Taal kun je een contact alleen laten verschijnen op de bijbehorende sitetaal.
• Combineer beide op een meertalige website: één structuur, waarbij personen worden gefilterd op taal.

7. Onder de motorkap (voor ontwikkelaars)

7.1 Eén hoofdtabel

De contacten zelf worden opgeslagen in één tabel:

#__contact_details   de contacten (personen/locaties) + formulier- en weergave-instellingen

Daarnaast zijn er records in de gedeelde tabel #__categories (met extension = com_contact) en in de tabellen #__fields* wanneer aangepaste velden worden gebruikt.

7.2 Belangrijke kolommen in #__contact_details

De belangrijkste kolommen zijn:

id, name, alias            identiteit + SEF-slug
catid                      categorie-id (→ #__categories)
user_id                    gekoppelde Joomla-gebruiker (→ #__users), 0 = geen
con_position               functietitel / functie
address, suburb, state,
country, postcode          adresgegevens
telephone, mobile, fax     telefoonnummers
email_to                   ontvanger van formulierberichten
webpage                    website-URL
image                      foto / logo
misc                       vrij HTML-blok met aanvullende informatie
linka...linke / *_name     vijf generieke URL- en labelvelden
default_con                standaardcontact van de categorie
featured                   markering als uitgelicht
sortname1/2/3              velden voor aangepaste sortering (bijvoorbeeld achternaam)
params                     JSON: alle show_* instellingen + formulieropties
metakey/metadesc/metadata  SEO + robots
published, access, language, ordering, hits, version
publish_up / publish_down  publicatieperiode

7.3 De MVC-structuur

De component is opgesplitst in een beheerdersgedeelte en een sitegedeelte:

administrator/components/com_contact/   ← beheer van contacten + categorieën
   src/Model/ContactModel.php, ContactsModel.php
   src/Table, src/Controller, tmpl/, forms/contact.xml

components/com_contact/                  ← front-endweergaven
   src/Model/ContactModel.php     (enkel contact + formulierverwerking)
   src/Model/CategoryModel.php    (lijst binnen een categorie)
   src/Model/FeaturedModel.php    (lijst met uitgelichte contacten)
   src/Model/CategoriesModel.php  (categorieboom)
   src/Controller/ContactController.php  (verwerking van formulier-POST)

plugins/...                              ← de zes integraties

Opvallend is dat de vijf modellen aan de sitezijde vrijwel één-op-één overeenkomen met de vier typen menu-items, waarbij het contactmodel ook de formulierverwerking afhandelt.

7.4 De verwerking van formulierinzendingen

Wanneer een bezoeker een contactformulier verstuurt, volgt de aanvraag dit pad:

POST /index.php?option=com_contact&task=contact.submit&id=42
   → ContactController::submit()
   → valideren (sessiecontrole, geblokkeerde woorden, CAPTCHA)
   → e-mail opbouwen en verzenden (Joomla Mailer)
   → optionele kopie naar afzender
   → doorsturen (aangepaste URL of terug met melding)

De eigen controller van de component, niet een generieke formuliercomponent, is verantwoordelijk voor validatie en verzending van e-mails.

7.5 SEF-URL's en de router

Contact-URL's worden opgebouwd en verwerkt door de router van de component:

components/com_contact/src/Service/Router.php

Deze zet querystrings om in nette, leesbare URL's en vice versa:

index.php?option=com_contact&view=contact&id=7   ↔   /contact/support/peter-martin

De router heeft drie taken:

• Build: SEF-links genereren voor contacten, categorieën en uitgelichte weergaven.
• Parse: een inkomende SEF-URL vertalen naar de juiste weergave en ID.
• Menu-resolutie: waar mogelijk een bestaand menu-item gebruiken in plaats van een generiek pad.

Omdat de router onderdeel is van de component, blijven contactlinks werken wanneer categorieën worden verplaatst en sluiten ze automatisch aan op je menustructuur.

7.6 Web Services API (headless)

De component bevat REST-routes die worden geactiveerd door de webservices-plugin:

api/components/com_contact/src/Controller/ContactController.php

GET  /api/index.php/v1/contact/contacts
GET  /api/index.php/v1/contact/contacts/{id}
POST /api/index.php/v1/contact/contacts        (aanmaken)

Dit maakt moderne architecturen mogelijk:

Joomla API  →  React / Vue-directory  →  aangepaste contactweergave

De gegevens blijven in Joomla opgeslagen, terwijl de presentatie elders kan plaatsvinden. Houd er wel rekening mee dat API-gebruik de ingebouwde formuliermailer omzeilt, waardoor je formulierverwerking zelf moet afhandelen.

7.7 Programmatische toegang

Dezelfde nested-set Categories API werkt ook voor contacten:

use Joomla\CMS\Categories\Categories;

$categories = Categories::getInstance('Contact');
$node       = $categories->get('staff');   // via alias of id
$children   = $node->getChildren();

De tabel- en modelklassen bevinden zich in deze namespaces:

Joomla\Component\Contact\Administrator\Table\ContactTable
Joomla\Component\Contact\Site\Model\ContactModel

7.8 Template overrides

Elke weergave kan per template worden overschreven:

components/com_contact/tmpl/contact/default.php
templates/<jouw_template>/html/com_contact/contact/default.php   ← override

De weergave van een enkel contact is opgesplitst in sublayouts (_address, _user_custom_fields, _links enzovoort), zodat je alleen het adresblok of alleen het formulier kunt overschrijven zonder de volledige pagina aan te passen. De vuistregel: overschrijf de weergave, niet het model. Gegevens en presentatie blijven zo gescheiden.

7.9 Op grote schaal

Het datamodel is eenvoudig, maar bij directories met duizenden contacten zijn er enkele aandachtspunten:

Contacten worden veel gelezen en weinig gewijzigd. Cache de weergaven en indexeer de filterkolommen, dan schaalt de component probleemloos mee.

9. Best practices

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

• Maak eerst een categorie aan voordat je contacten toevoegt, elk contact moet aan een categorie gekoppeld zijn.
• De ontvanger van het formulier is email_to, niet het e-mailadres van de gekoppelde gebruiker.
• Beheers de drie niveaus van overerving met Tonen / Verbergen / Globale instelling gebruiken: stel standaardwaarden één keer in via Opties en overschrijf alleen waar nodig.
• Koppel contacten aan gebruikers om profielen, auteursblokken en één centrale identiteit mogelijk te maken.
• Schakel de Privacy-plugin in zodat contacten worden meegenomen in AVG-verzoeken voor export en verwijdering.
• Indexeer filterkolommen bij grote directories en houd de categorieboom zo ondiep mogelijk.

11. Samenvatting

Joomla Contacten is tegelijkertijd een gestructureerd adresboek en een contactformulier-engine, verborgen in het volle zicht. Zodra je het op die manier bekijkt, merk je dat je voor veel taken geen extra extensies nodig hebt omdat Joomla ze standaard al goed afhandelt.

Het biedt:

• Structuur: getypeerde velden, een adresblok, vijf linkvelden en aangepaste velden.
• Formulieren: e-mailformulieren per contact met ingebouwde bescherming tegen spam, zonder extra extensies.
• Identiteit: koppel contacten aan gebruikers, maak automatisch profielen aan en toon auteursblokken.
• Weergave: vier menuweergaven met overerving op drie niveaus via Tonen / Verbergen.
• Integratie: een gedeelde categorieboom, ACL, Smart Search, Privacy en een REST API.
• Privacy: e-mailafscherming plus AVG-export en verwijdering, standaard ingebouwd.

Of je nu een medewerkersoverzicht, een ledenlijst of gewoon een betrouwbare contactpagina wilt maken die berichten naar de juiste persoon stuurt, de component Contacten verdient een nieuwe blik. Het is het stille, degelijk gebouwde adresboek dat al die tijd onderdeel van Joomla is geweest.