Zoeken naar Drupal-modules
Om modules te vinden, ga naar de hoofdpagina van de modules. Om thema’s te vinden, begin je op de hoofdpagina van de thema’s.
Zoals je kunt zien, zijn er veel zoekopties, maar de belangrijkste is de core-compatibiliteit. Stel deze in op “8.x” om modules voor Drupal 8 te tonen. Je kunt ook andere filters aanpassen of een of twee trefwoorden invullen in het veld “Search modules”. De standaardwaarde van “Sorteren op” is “Most installed” — dat betekent dat de resultaten gesorteerd zijn op populariteit.
Op de resultatenpagina is de “naam” van elke module (of thema) een link naar de projectpagina — de officiële homepage van dat project op drupal.org.
De projectpagina van een module
De projectpagina’s van modules verschillen in detailniveau, omdat de inhoud wordt opgesteld door de ontwikkelaar(s) van de module.
Het is meestal de moeite waard om de projectpagina zorgvuldig te lezen.
Als de module afhankelijk is van andere modules of extra “bibliotheken”, wordt die informatie op de pagina vermeld. Maar maak je geen zorgen als je een afhankelijkheid vergeet — wanneer je probeert de module in te schakelen of te gebruiken, zal Drupal je automatisch waarschuwen dat er iets ontbreekt.
Sectie “Downloads”
Elke projectpagina bevat altijd links naar de verschillende versies die beschikbaar zijn voor die module.
Sectie “Issues for …”
De projectpagina bevat ook links onder de kop “Issues for …”. Deze bevinden zich in de rechterkolom (of onderaan de pagina als je scherm smaller is). De links “Issues for …” leiden naar de issue queue van dat specifieke moduleproject. De issue queue is de officiële plaats voor alle bugrapporten, ondersteuningsverzoeken en functieverzoeken.
Dus als je problemen hebt met een module, bekijk dan de issue queue. Als je probleem nog niet is opgelost, plaats dan een nieuw bericht via de link “Create a new issue” — iemand zal proberen je te helpen.
Sectie “Resources”
Direct onder de sectie “Issues for …” staat “Resources”. Ik kijk daar altijd of er een link “Read documentation” is. Deze link is niet altijd aanwezig, maar als hij er is, verwijst hij naar de documentatie die de ontwikkelaars als meest nuttig beschouwen.
De link “Read documentation” kan verwijzen naar een pagina in de Drupal.org-documentatie, of naar een externe website.
Daarnaast bevat vrijwel elk contrib-project een bestand README.txt en/of INSTALL.txt in de hoofdmap, die je kunt bekijken nadat je de module hebt gedownload of geïnstalleerd.
De verschillende documentatiebronnen die voor een module of thema beschikbaar zijn, worden elders uitgebreider besproken. Voor nu kun je alvast weten dat je het bestand README.txt van elk project kunt bekijken of andere documentatie kunt raadplegen zonder iets te downloaden — zie daarvoor de sectie “Module-documentatie en hulp”.
De verschillende beschikbare versies van een module begrijpen
Op de projectpagina zie je onder de sectie “Downloads” de subkoppen “Recommended releases”, “Other releases” en “Development releases”.
De onderstaande afbeelding komt uit Drupal 7, maar het principe blijft hetzelfde.
Kies altijd een versie die compatibel is met jouw Drupal-versie. Omdat je Drupal 8 gebruikt, kun je alleen versies gebruiken die beginnen met “8.x–…”.
Aanbevolen releases
Zoek naar de bovenste “Versie” die beschikbaar is voor Drupal 8. Dat is meestal de versie die je als eerste moet proberen. Als ze onder de kop “Recommended releases” staan, betekent dit dat ze stabiel genoeg zijn voor gebruik op een live (productie)site.
Andere releases
Als er geen “Recommended releases” beschikbaar zijn, probeer dan een versie uit de sectie “Other releases”, als die er is. Deze versies bevinden zich meestal in de overgangsfase naar een aanbevolen release.
Soms bevat “Other releases” ook oudere, stabiele versies van een module die bewaard blijven voor compatibiliteit met andere modules die daarvan afhankelijk zijn.
Development releases
Een “Development release” is een versie die zich nog in ontwikkeling bevindt. Ontwikkelaars gebruiken deze om bugs te verhelpen of nieuwe functies toe te voegen. Wees voorzichtig — zulke versies zijn vaak minder stabiel.
Een ontwikkelversie kan ook bedoeld zijn voor een toekomstige Drupal-coreversie. Bijvoorbeeld: als Drupal 8.2 de huidige stabiele versie is, kan een module al een “ready release” hebben voor Drupal 8.3, die nog niet compatibel is met 8.1.
Kolom “Versie”
Deze kolom toont het versienummer van de module in die specifieke rij.
Voor meer informatie over de nummeringsconventies, zie “Wat betekenen versienummers voor modules en thema’s?”.
Kolom “Download”
Deze kolom bevat de downloadlinks die je gebruikt om de module daadwerkelijk op te halen.