Joomla Slim Zoeken gebruiken

1. De basis

1.1 Wat is Smart Search?

Smart Search is Joomla's moderne zoekmachine voor websites. De component heet com_finder, daarom noemen ontwikkelaars het vaak Finder.

Smart Search:

• Wordt standaard meegeleverd sinds Joomla 2.5.
• Bouwt een zoekindex op in de database.
• Zoekt in die index in plaats van direct in contenttabellen.
• Geeft gerangschikte en filterbare resultaten terug.
• Vervangt de oude com_search, die in Joomla 4.0 uit de core is gehaald.

De oude Search voerde live een LIKE '%keyword%'-query uit op #__content. Smart Search bouwt een echte zoekindex die bij opslaan wordt bijgewerkt.

1.2 Twee zoeksystemen, ken het verschil

Als iemand het nog heeft over "de Search-module" in Joomla, bedoelen ze vrijwel zeker Smart Search. De twee systemen verschillen enorm:

1.3 Tijdlijn van Joomla-versies

Smart Search maakt al meer dan tien jaar deel uit van Joomla. De status van zoekfunctionaliteit per Joomla-versie:

1.4 Waar vind ik Smart Search?

In de Joomla 6-backend bevindt Smart Search zich op verschillende plekken:

Componenten → Slim Zoeken                   (beheer van geïndexeerde items + filters)
Componenten → Slim Zoeken → Inhoudsschema's (taxonomie-structuren & nodes)
Componenten → Smart Search → Filters        (opgeslagen filtersets)
Systeem     → Beheer → Plugins              (Smart Search contentplugins)
Systeem     → Beheer → Modules              (de zoekmodule)

De frontend-zoekpagina bevindt zich op /index.php?option=com_finder, meestal gekoppeld aan een menu-item van het type Smart Search → Zoeken.

1.5 De vier bouwstenen

Smart Search bestaat uit vier onderdelen. Begrijp deze vier en de rest is configuratie.

1.6 De vijf onderdelen van een werkende configuratie

Een complete Smart Search-installatie gebruikt vijf verschillende onderdelen. Elk onderdeel kan afzonderlijk worden ingeschakeld:

3. Binnen de index

3.1 De Smart Search-tabellen

Smart Search slaat zijn gegevens op in een kleine set speciale tabellen:

#__finder_links             één rij per geïndexeerd item (artikel, contact, ...)
#__finder_links_terms       link ↔ term, met gewicht en context
#__finder_terms             elke unieke term in de index
#__finder_terms_common      stopwoorden ("de", "het", "en", ...) per taal
#__finder_tokens            MEMORY-engine, tijdelijke tokens tijdens indexeren
#__finder_tokens_aggregate  MEMORY-engine, geaggregeerde tokens tijdens indexeren
#__finder_taxonomy          taxonomie-structuren (Type, Categorie, Taal, ...)
#__finder_taxonomy_map      link ↔ taxonomie-node
#__finder_types             register van geïndexeerde contenttypes
#__finder_filters           opgeslagen filtersets gekoppeld aan modules of menu-items
#__finder_logging           log van zoektermen (populaire zoekopdrachten)

Er zijn twee logische lagen:

• Links, wat geïndexeerd wordt.
• Terms, de doorzoekbare woordenschat die met gewichten teruggekoppeld wordt naar links.

De tabellen #__finder_tokens en #__finder_tokens_aggregate gebruiken de MEMORY-storage-engine van MySQL. Ze draaien in RAM en worden tussen indexeeracties gewist. Als het indexeren van een grote website tegen max_heap_table_size aanloopt, verhoog dan deze MySQL-instelling en wijzig niet de storage-engine.

3.2 De taxonomieboom

Smart Search bouwt automatisch een taxonomie op van elk geïndexeerd item. Deze taxonomie-structuren verschijnen voor bezoekers als filter-checkboxes op de resultatenpagina:

Tak             Voorbeelden
─────────────   ────────────────────────
Type            Artikel, Categorie, Contact, Nieuwsfeed, Tag
Categorie       Websitecategorieën (hiërarchisch)
Taal            nl-NL, en-GB, *
Auteur          Gebruiker die het item heeft gemaakt
Tag             Tags op het item

3.3 Gewogen velden

Wanneer Smart Search een item indexeert, valt elk veld onder een van vijf contexten, en elke context heeft een gewichtsvermenigvuldiger die je in de componentopties kunt aanpassen. Daarom scoort een overeenkomst in de titel hoger dan een overeenkomst in de hoofdtekst.

De koppeling loopt niet per veld maar per context, en dat is belangrijk: velden die dezelfde context delen, hebben exact hetzelfde gewicht.

Uit die tabel volgen drie dingen die makkelijk verkeerd worden begrepen:

• Introtekst en volledige tekst wegen even zwaar. Beide vallen onder TEXT_CONTEXT. Een trefwoord boven de readmore zetten doet niets voor de ranking - het verandert alleen wat een bezoeker als eerste ziet.
• Meta-keywords en meta description wegen even zwaar, om dezelfde reden: het is allebei metadata.
• De URL-alias weegt zwaarder dan de titel. Met 2.0 tegen 1.7 is de path-context het zwaarste in de index. Een nette alias met je trefwoord erin is daarmee een van de goedkoopste ranking-winsten binnen Smart Search.

Tags staan niet in deze tabel. Het zijn geen gewogen velden: een adapter geeft ze door aan addTaxonomy(), waardoor ze een filtertak worden (sectie 3.2) in plaats van iets waartegen een term scoort.

3.4 Taal en stemming

Elke geïndexeerde term krijgt een taal toegewezen. Tijdens het zoeken:

• Bepaalt de actieve websitetaal welke stemmer wordt gebruikt.
• Wordt "running" teruggebracht naar de stam run en matcht het ook met "run", "runs" en "running".
• De stemmer werkt per taal, Nederlands, Engels, Frans, Duits en andere talen hebben allemaal hun eigen regels.

Stel de taal van een artikel correct in. Een Nederlands artikel dat in een Engelse index terechtkomt, gebruikt de verkeerde stemmer en krijgt daardoor een slechtere relevantiescore.

5. Onderhoud

5.1 De index actueel houden

Gebruik idealiter twee strategieën tegelijk:

1. Indexeren bij opslaan, plg_content_finder indexeert één item opnieuw bij opslaan of publiceren.
2. Geplande herindexering, een cronjob die periodiek alles opschoont en opnieuw indexeert.

Er is geen Smart Search-taakplugin in de core - plugins/task/ bevat negen plugins en geen daarvan indexeert. Het CLI-commando bestaat wel, dus stuur dat aan vanuit een systeem-cronjob:

# Elke nacht uitvoeren om 03:30
30 3 * * *  cd /var/www/site && php cli/joomla.php finder:index

5.2 Statistieken

Ga naar Componenten → Smart Search → Statistics. Deze pagina toont:

• Het totaal aantal geïndexeerde items per type.
• De grootte van de index.
• Het aantal termen.
• Recente zoekopdrachten (indien logging is ingeschakeld).

Een groeiende index gecombineerd met een dalend aantal termen wijst meestal op duplicaten of verwijderde items die nog steeds geïndexeerd zijn. Voer dan een Purge en herindexering uit.

5.3 Zoeklogging, waar bezoekers echt naar zoeken

Zet in de Smart Search-componentopties Gather Search Statistics op Yes. Joomla logt vervolgens elke zoekopdracht in #__finder_logging. Bekijk de populairste zoekopdrachten via Componenten → Smart Search → Search Terms.

Deze gegevens zijn goud waard voor SEO en contentstrategie:

• Veelgebruikte zoekopdrachten zonder resultaten wijzen op een content gap.
• Veelgebruikte zoekopdrachten waarbij bezoekers afhaken wijzen op slechte ranking van resultaten.

Behandel het zoeklogboek als een backlog. Elke populaire zoekopdracht zonder resultaten is een onderwerp waarover je content zou moeten schrijven.

5.4 De index optimaliseren

Ga naar Componenten → Smart Search → Maintenance → Optimise. Dit:

• Verwijdert kapotte links en verweesde koppelingen tussen termen en links.
• Telt opnieuw in hoeveel links elke term voorkomt en verwijdert daarna elke term die op nul uitkomt.
• Verwijdert verweesde taxonomie-koppelingen en -nodes.
• Voert OPTIMIZE TABLE uit op de finder-tabellen om ze te defragmenteren.

Voer Optimise uit na een grote bulkimport of een zware contentopschoning.

5.5 Synoniemen, en waarom Joomla ze niet heeft

Smart Search heeft geen ondersteuning voor synoniemen. Er is geen synoniemveld in de Smart Search-opties, geen synoniementabel in de database en geen synoniemstap in de query-parser. Een bezoeker die op CMS zoekt, vindt geen pagina die alleen maar content management system zegt.

Dat verrast mensen die Solr- of Elasticsearch-gedrag verwachten. Smart Search zoekt elke term op in #__finder_terms, en het enige dat de zoekopdracht verbreedt is de stemmer per taal plus de instelling Word Match.

Drie manieren om het gat te dichten met alleen core:

• Word Match, in Componenten → Smart Search → Options → Smart Search kies je Match exactly (de standaard), Match words beginning with the search term of Match words containing the search term anywhere. De ruimere instellingen zorgen ervoor dat menu ook menubar vindt, maar ze verbreden elke zoekopdracht op de website, waardoor de relevantie daalt en de query trager wordt.
• Meta Keywords, de contentplugin indexeert de Meta Keywords van een artikel in de meta-context, gewogen met Metadata Weight Multiplier (standaard 1.2). CMS, content management system in de Meta Keywords van één artikel zetten is de praktische synoniemtruc per item, en bij het opslaan van het artikel wordt het meteen opnieuw geïndexeerd.
• Schrijf de variant in de tekst, noem de afkorting één keer in de inleiding. Dat helpt ook menselijke lezers en zoekmachines.

Heb je echt synoniemgroepen, weging per term of tolerantie voor typefouten nodig, dan heb je een externe zoekextensie of zoekmachine nodig. Core gaat het je niet geven.

5.6 Veelvoorkomende termen (de Joomla-variant van stopwoorden)

Smart Search leest tijdens het draaien geen stopwoordenbestand. Het vergelijkt elke term met de tabel #__finder_terms_common, met daarin een term, een language en een custom-vlag.

Die tabel wordt op twee manieren gevuld:

• Bij de installatie van Smart Search worden 174 Engelse termen toegevoegd (i, me, my enzovoort) met custom = 0.
• Bij het installeren van een taalpakket komt de plugin Extension - Finder in actie. Die leest language/<tag>/com_finder.commonwords.txt en importeert de woorden daaruit voor die taal. Alles achter een ; op een regel geldt als commentaar.

Bij het opnieuw installeren of bijwerken van een taalpakket worden alleen de rijen met custom = 0 van die taal verwijderd en opnieuw geïmporteerd. Rijen die je zelf toevoegt met custom = 1 overleven een update dus.

Een veelvoorkomende term heeft twee gevolgen:

• Tijdens het indexeren wordt het gewicht van de term door 8 gedeeld, waardoor hij nog steeds matcht maar veel lager scoort.
• Tijdens het zoeken wordt de term volledig uit de zoekopdracht gehaald, maar alleen wanneer Filter Common Words op Yes staat.

In Componenten → Smart Search → Options → Index vind je twee schakelaars, beide standaard op No: Filter Common Words en Filter Numeric Terms. Er is geen drempelwaarde in procenten en geen beheerscherm voor de tabel met veelvoorkomende termen, dus eigen veelvoorkomende woorden toevoegen betekent SQL schrijven.

5.7 Er is geen module voor populaire zoekopdrachten

De core levert één Smart Search-module, mod_finder, het zoekvak. Er bestaat geen module die de meest gestelde zoekopdrachten uit #__finder_logging als aanklikbare suggesties toont, en er is ook geen taalstring voor.

De gegevens zijn er wel als je zo'n blok wilt: het zoeklog vult zich zodra Gather Search Statistics aanstaat (sectie 5.3), en een paar regels in een eigen module of template-override lezen de bovenste rijen uit #__finder_logging. Het is alleen niets wat de core je kant-en-klaar geeft.

7. Toegangsbeheer en privacy

7.1 Toegangsniveaus

Elke geïndexeerde link slaat het toegangsniveau van het item op. Tijdens het zoeken doet Smart Search het volgende:

1. Bepaalt de toegangsniveaus van de huidige gebruiker.
2. Filtert links weg die de gebruiker niet mag zien.
3. Filtert taxonomiefilters weg die alleen resultaten zouden opleveren waarvoor de gebruiker geen toegang heeft.

Een gastgebruiker ziet dus nooit artikelen die alleen toegankelijk zijn voor geregistreerde gebruikers. Dezelfde regels gelden overal binnen Joomla.

7.2 Niet gepubliceerd, gearchiveerd en verwijderd

Smart Search respecteert de publicatiestatus tijdens het indexeren en controleert deze opnieuw tijdens het zoeken:

7.3 Privacy van het zoeklogboek

Wanneer zoeklogging is ingeschakeld, sla je zoekopdrachten van bezoekers op. Behandel dit logboek als persoonsgegevens:

• Anonimiseer IP-adressen op webserverniveau.
• Documenteer bewaartermijnen in je privacybeleid.
• Schakel logging uit op websites met gevoelige gegevens.

9. Veelgemaakte fouten en valkuilen

9.1 Zoeken geeft geen resultaten terug

• Heb je de index opgebouwd? Ga naar Componenten → Smart Search → Indexeren.
• Zijn de contentplugins ingeschakeld (plg_finder_content en vergelijkbare plugins)?
• Is het item gepubliceerd en ligt publish_up in het verleden?
• Staat de taal correct ingesteld? Een Nederlandse zoekopdracht tegen een uitsluitend Engelse index levert niets op.
• Staat er een woord met een accent in de zoekopdracht, of hoort dat er te staan? normandie matcht niet met de geïndexeerde term Normandië onder een binaire collatie. Zie paragraaf 6.4.

9.2 Zoeken is traag

Smart Search hoort snel te zijn. Als dat niet zo is:

• Voer Optimise uit.
• Controleer het aantal rijen in #__finder_links. Een extreem groot aantal wijst meestal op verouderde items, voer een Purge en herindexering uit.
• Schakel contenttype-plugins uit die je niet gebruikt.
• Controleer de MySQL-tuning, vooral innodb_buffer_pool_size.

9.3 Verouderde resultaten na wijzigingen

Dit betekent meestal dat plg_content_finder is uitgeschakeld of dat een artikel via een aangepaste opslagroute wordt verwerkt waarbij het event niet wordt uitgevoerd.

• Schakel de plugin Content - Smart Search in.
• Voer na bulkimports php cli/joomla.php finder:index uit.

9.4 Legacy Search verwarren met Smart Search

• com_search is de legacy-component, in Joomla 4.0 uit de core gehaald. Hij bleef bestaan als losse download, maar werd alleen ondersteund tot Joomla 5.0 uitkwam.
• com_finder is Smart Search, de enige core-zoekfunctie in Joomla 6.

Als een tutorial verwijst naar "de Search-component", controleer dan eerst de publicatiedatum voordat je de instructies volgt.

9.5 Custom Fields en Smart Search

Dit is een veelvoorkomende bron van verouderde informatie, in twee richtingen. Smart Search kan waarden van Custom Fields indexeren zonder extensie van derden, maar doet dat niet uit zichzelf: indexeren is opt-in per veld en staat standaard uit.

Je zet het aan tijdens het bewerken van het veld, onder Options → Smart Search → Search Index. Het is een keuzelijst met vier waarden, geen ja/nee-schakelaar:

Twee beperkingen zijn het waard om te kennen voordat je hierop gaat bouwen:

• Slechts twee adapters doen dit: artikelen en contacten. Custom Fields op categorieën of gebruikers worden niet geïndexeerd, wat je hier ook instelt.
• De optie Enable Custom Fields van de component zelf gaat er nog overheen. Staat die uit voor de component, dan wordt geen enkel veld geïndexeerd, ook niet als Search Index anders zegt.

Er is geen filter op veldtype. Wat het veld als waarde rendert, is wat geïndexeerd wordt. Een Text- of List-veld gedraagt zich dus zoals je verwacht, terwijl Media, Color en ruwe Subform-JSON waarden opleveren die technisch gezien wel geïndexeerd worden maar zelden nuttig zijn om op te zoeken.

9.6 De rechten-valkuil bij doorzoekbare velden

Dit deel verdient aandacht, want het is precies het omgekeerde van wat de meeste mensen aannemen.

Een doorzoekbaar Custom Field wordt geïndexeerd met de kijkrechten van het content-item, niet met het eigen toegangsniveau van het veld. Joomla zegt dat zelf, in de beschrijving onder de instelling:

Warning: When 'Make searchable' is selected, content from the field is indexed with the viewing permissions of the content item. This might lead to unexpected information disclosure.

Een veld dat is beperkt tot een groep op Special-niveau, gekoppeld aan een openbaar artikel, wordt dus vindbaar voor gasten zodra je het doorzoekbaar maakt. Het veld beperken beperkt het zoekresultaat niet. De taxonomie-tak gedraagt zich anders en draagt het toegangsniveau van het veld wél mee, waardoor dit verschil makkelijk over het hoofd wordt gezien.

Hetzelfde mechanisme verklaart de oudere waarschuwing over SQL Custom Fields: wat de query teruggeeft wordt geïndexeerd onder de rechten van het artikel. Een query die over tenants heen reikt of in privétabellen kijkt, lekt daardoor naar de zoekfunctie van iedereen die het artikel mag lezen.

Controleer elk doorzoekbaar Custom Field en elk SQL Custom Field voordat je op Smart Search vertrouwt op een site met afgeschermde content.

Praktische aandachtspunten:

• Search Index wijzigen op een bestaand veld doet niets totdat de betrokken items opnieuw geïndexeerd zijn. Voer Indexeren opnieuw uit, of doe een Purge en bouw opnieuw op.
• Een Subform-waarde wordt als JSON opgeslagen. Alleen de gerenderde output wordt geïndexeerd - override subform.php als je een andere vorm nodig hebt.
• Websites die vanaf Joomla 3 zijn gemigreerd hebben soms nog een plugin van derden staan die Custom Fields indexeerde voordat de core dat kon. Kijk of je die nog nodig hebt zodra je Search Index hebt ingesteld op de velden waarop je echt zoekt.

9.7 De indexering wordt nooit voltooid

Symptomen: de indexeerpagina loopt vast of de voortgangsbalk blijft hangen.

• Verhoog max_execution_time en memory_limit tijdens het indexeren.
• Indexeer via de CLI, daar geldt geen PHP-time-out.
• Werk per contenttype, schakel alle plugins uit behalve één, indexeer en herhaal dit proces.

9.8 Inregelopties voor grote websites

Op websites met tienduizenden items zijn de standaardinstellingen meestal eerder te voorzichtig dan te agressief. Joomla levert een kleine batchgrootte, laat het indexeren van woordgroepen uitstaan, en laat de limiet voor de MEMORY-tabel volgen wat MySQL toevallig toestaat. Dit zijn de instellingen die het bekijken waard zijn:

11. Best practices

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

• Schakel alleen de contenttype-plugins in die je echt gebruikt, zo blijft de index compacter.
• Voer altijd een volledige herindexering uit na migraties, contentopschoningen of pluginwijzigingen.
• Plan een nachtelijke CLI-herindexering voor grote websites.
• Schakel zoeklogging in, het is je eerlijkste rapport over ontbrekende content.
• Stel de taal van artikelen correct in zodat de juiste stemmer gebruikt wordt.
• Gebruik opgeslagen filters om zoekresultaten per sectie of taal af te bakenen.
• Override default_result.php in je template in plaats van de core te wijzigen.
• Custom Fields indexeren is opt-in per veld, en een doorzoekbaar veld erft de rechten van het artikel, niet zijn eigen. Controleer doorzoekbare en SQL Custom Fields voordat je op Smart Search vertrouwt.

13. Samenvatting

Smart Search verandert de zoekfunctie van Joomla van een trage LIKE-query in een echte, gerangschikte, gefacetteerde en meertalige zoekmachine. Het zit standaard in elke Joomla-installatie, maar de meeste site-eigenaren schakelen het nooit echt goed in.

Smart Search biedt:

• Snelheid, een vooraf opgebouwde index en zoekopdrachten in milliseconden.
• Relevantie, gewogen velden, stemming en taalbewust zoeken.
• Filters, taxonomie-filters direct uit de doos.
• Inzicht, zoeklogs die ontbrekende content blootleggen.
• Uitbreidbaarheid, plugins voor elk contenttype, inclusief je eigen componenten.
• Scriptbaar: de query-engine is een gewoon model dat je vanuit PHP kunt aanroepen, dus een headless frontend is een kleine plugin verderop.

Een goede zoekfunctie is een van de goedkoopste manieren om een Joomla-website professioneler te laten aanvoelen. Bezoekers die snel vinden wat ze zoeken blijven langer, converteren vaker en komen sneller terug. Een paar uur investeren in een goede Smart Search-configuratie, de juiste plugins, een geplande herindexering, een slimme resultatenpagina en zoeklogging, betaalt zich jarenlang terug.

Als je zoekfunctie momenteel weinig bruikbare resultaten geeft, of je vermoedt dat Smart Search nooit correct is ingesteld, dan is dit een van de eerste onderdelen die je op elke Joomla-website zou moeten verbeteren.