Modules installeren

Moeilijkheidsgraad

Modules (Uitbreidingen) zijn noodzakelijke tools omdat de kern (core) van Drupal eigenlijk te weinig middelen bevat om een knappe en veilige site te maken. Vergelijk het met een wagen waar alleen een stuur, gas en remmen op staan. Geen verwarming, GPS, cruise control,...

Sommige modules zijn wél met de kern meegekomen maar zijn nog niet geactiveerd. Zo zie je dat de responsive image (zorgt voor een responsive afbeeldingsstijl) reeds klaar staat. Je moet enkel het vinkje aanzetten. De telefoon module is ook zo één.

In alle andere gevallen...

Op het ogenblik van dit schrijven zijn 7697 modules voor Drupal 8 beschikbaar. Op deze site heb ik daar een selectie van gemaakt en besproken (450 op dit ogenblik).

Via de site drupal.org kan je de modules bekijken.

Je filtert op de Drupal 8 versie.

Je kunt nu naar een bepaalde module gaan via het zoekvenster op drupal.org, maar makkelijker is om in Google naar de module te zoeken. Zoeken op drupal.org is niet zo handig.

Als je de module gevonden hebt zie je onderaan de downloads, met indicatie van hun stabiliteit. Neem groen als het kan, maar ik neem altijd de laatste versie om te zien wat de mogelijkheden zijn...

Je kunt nu op verschillende manieren de module downloaden. Rechtsklikken op een tar.gz of zip link (beiden zijn mogelijk) en het linkadres kopiëren.

Op je site ga je nu een nieuwe module installeren.

Je plakt de link in het bovenste veld. De andere optie is om de module eerst te downloaden en dan via 'Bestand kiezen' te installeren. De eerst manier is sneller natuurlijk. In zeer zeldzame gevallen zijn er modules die niet via drupal.org beschikbaar zijn (GitHub). Deze moet je dan wel op de bestandsmanier installeren.


Na installeren (=eigenlijk enkel downloaden) moet je nog naar de modulelijst gaan en activeren wat je wenst. Modules kunnen zoals hier verschillende mogelijkheden aanbieden. Je vinkt enkel aan wat je nodig hebt. Wat je moet aanvinken staat telkens in de bespreking van de module. Dit verschilt dus van module tot module. In de Engelstalige drupal.org uitleg zijn ze nogal beknopt.. Drupal ontwerpers zijn geen grote redenaars... LOL Op deze site heb ik daar wat proberen aan te doen..

In sommige gevallen kan je de module niet aanvinken omdat die afhankelijk is van nog een andere module.. Zo is Focal Point afhankelijk van de Crop API module die niet in de kern zit. Deze moet je dus ook eerst downloaden, anders kan je de hoofdmodule niet aanvinken. 

Je ziet pas wat je nog moet installeren als je op het pijltje klikt! Goed verstopt als je het mij vraagt...

In sommige gevallen staat er geen tar of zip. Hieronder zie je een link naar een dev (development of ontwikkelingsversie). Je kunt hier de link niet kopiëren. Kies geen dev versie als er een alternatief is.

Bij klikken op de link kom je wel op de goede link terecht.


 

In sommige gevallen heb je een third party nodig. Een third party is een extra upload van mappen en bestanden die je niet met bovenstaande methode kunt installeren. Extra dus.

de Roundabout slider neem ik als voorbeeld https://www.drupal.org/project/roundabout

Bij de handleiding van de module staat telkens waar je je gerief moet halen. Dit moet je dan downloaden en op de server uploaden in de juist map. Je doet dit met FTP programma's zoals Filezilla of rechtstreeks met het Control Panel van je hosting. Het CP (Control Panel) heeft het voordeel dat je de zip of tar kunt uploaden en op de server uitpakken. Handig.

De map is de map libraries. Als deze nog niet bestaat moet je die map aanmaken op je server. De map zit in de root (naast bvb de map modules). Hieronder zie je dat ik nog andere third parties heb.. De schrijfwijze van de mappen is van groot belang en hoofdlettergevoelig. Er wordt door de module naar verwezen en dit moet kloppen natuurlijk. 

Modules die goed gemaakt zijn geven in het statusrapport weer of de third party goed geïnstalleerd is of niet. Altijd goed om eens te kijken (na flushen van de cash).

Professionals installeren modules met Linux commandos. Je moet daarvoor SSH access hebben tot je site. Een goede hosting heeft dat. Meer nog.. Drupal 8 kan niet meer draaien zonder deze SSH aangezien sommige modules enkel met composer kunnen geïnstalleerd worden. Dit bepaalt dus vanaf Drupal 8, je keuze van hosting.

Je kunt nu via Putty (extra programmaatje die je moet installeren) of via de Terminal op je hosting commands ingeven.


via de commando's: cd (change directory), ls (lijst van mappen en bestanden) kan je navigeren en zien waar je bent op je hosting. Kies de juist map als je subdomeinen hebt..

Daarna gaan we drush gebruiken. dit staat op een goede hosting reeds actief. We gaan Focal Point installeren. (machinenaam= focal_point)

drush en focal_point -y  (en= enable  -y = vraag niet telkens om yes, bevestiging). Merk op dat drush niet alleen de module download, maar ook de afhankelijke modules (Crop) én hij vinkt ze aan.

Je moet wel eens controleren of alles aangevinkt is. Als er meerdere submodules meekomen bij de installatie, zal drush enkel de hoofdmodule aanvinken.

Drush doets niet anders dan op een snelle manier de modules installeren, net zoals je ze manueel zou geïnstalleerd hebben. Drush kan nog voor veel andere zaken gebruikt worden zoals updates enz.. Hier hebben we het enkel over de installatie van modules. Je kunt meerdere modules tegelijkertijd installeren. Handig als je dus een lijstje hebt van je favoriete modules in het kladblok. Kopiëren en plakken en genieten..

In hetzelfde venster kan je ook composer gebruiken. Bij een goede hosting staat dit reeds klaar, anders moet je dit nog installeren. Daar is een bespreking voor op deze site.

Sommige modules zijn enkel met composer te installeren omdat ze ook in de Vendor map wijzigingen aanbrengen. Composer wordt aangeraden voor Drupal 8 als dé manier om modules te installeren.

Eigenaardig genoeg kan je met composer de modules niet standaard aanvinken. Je moet het manueel doen of via drush. Composer houdt wel een bestand bij wat je geïnstalleerd hebt. Op die manier heb je een overzicht van wat je gedaan hebt (in composer.json) en kan je daar ook de updates uitvoeren. Het is de bedoeling dat composer ook de third parties installeert. Dit is nog niet altijd zo. Je kan het wel manueel toevoegen aan je compser.json bestand. De modules zeggen dan wel wat je moet doen.

Bij wijze van voorbeeld installeer ik de knappe Leaflet module. Een alternatief voor de Google maps module die betalend wordt. 

composer require drupal/leaflet    (require=ik heb nodig=downloaden)

Zoals gezegd moet je zelf nog aanvinken wat je nodig hebt. Leaflet was afhankelijk van de Geofield module. Die werd tegelijkertijd geïnstalleerd, samen met tal van andere zaken zoals je kunt zien.

In het bestand composer.json staat dat leaflet werd geïnstalleerd:

Weet dat bij een upgrade van de kern van Drupal, het composer.json bestand wordt overschreven. Vooraleer je een upgrade doet moet je dus een kopie maken van dit bestand om na de update dit terug te kunnen zetten...