5.1. Downloaden en installeren van Drupal Commerce.

Allereerst hebben we voor de installatie van Drupal Commerce Composer nodig:

https://getcomposer.org/download/

Composer is een pakketbeheerder voor PHP. Het stelt je in staat om de benodigde PHP-bibliotheken te installeren — oftewel, bibliotheken te downloaden en automatisch aan je project toe te voegen, in dit geval aan je Drupal 8-website. Drupal 8 bevat al veel externe bibliotheken, met name afkomstig van het Symfony-framework.

Meestal installeert Composer zonder problemen; vergeet alleen niet om Open Server of een andere lokale webserver in te schakelen vóór de installatie. Tijdens de installatie van Composer kun je gewoon steeds op ‘Volgende’ klikken — Composer installeert zichzelf verder automatisch.

Na de installatie voer je in de console het volgende commando uit om te controleren of Composer correct is geïnstalleerd:

composer --version

Je zou een bericht moeten zien dat aangeeft welke versie van Composer is geïnstalleerd.

$ composer --version
Composer version 1.4.1 2017-03-10 09:29:45

Je kunt zowel de ingebouwde Windows-console CMD gebruiken:

Als ook de console van Open Server:

Ik zal later een aparte les maken over het gebruik van de console. Voor nu kun je de video bekijken — daarin staan voldoende commando’s om Drupal Commerce te installeren.

Na de installatie van Composer moeten we Drush installeren. Drush is een commandoregeltool voor het beheren van Drupal via de terminal. Het is erg handig om modules via Drush te downloaden en in te schakelen, hoewel het eigenlijk beter is om modules eerst via Composer te downloaden en daarna via Drush te activeren.

Om Drush te installeren, voer het volgende commando uit:

composer global require drush/drush:8.*

In plaats van 8.* kun je ook 9.* of een andere actuele versie gebruiken. Controleer of Drush correct is geïnstalleerd met het commando:

drush version

Mijn huidige versie is 9.*:

$ drush version
 Drush version : 9.0-dev-g9ec6aa42

Als je problemen krijgt met de installatie van Drush of Composer op Windows, gebruik dan deze handleiding voor het instellen van Drush in Open Server:

12.1. Installatie van Drush 8 op Open Server.

Nu hebben we Drupal 8 nodig om Drupal Commerce te kunnen installeren. Als je al een werkende Drupal 8-site hebt, kun je deze stap overslaan en direct doorgaan naar de installatie van Drupal Commerce.

Ik download meestal handmatig de Drupal-core van drupal.org en maak een nieuwe site aan op Open Server:

Je kunt Drupal ook downloaden via Composer, maar dan moet je in de instellingen van Open Server een andere Document Root voor de site opgeven. Ik geef echter de voorkeur aan eenvoud en installeer liever een schone Drupal-versie rechtstreeks van drupal.org.

Installeer Drupal op de gebruikelijke manier. Je kunt ook Drush gebruiken voor een snellere installatie:

drush si --db-url=mysql://root:password@127.0.0.1/drupal --account-name=admin --account-pass=admin --site-mail=admin@example.com --site-name="Drupal 8" --locale=ru --yes

In ons geval is er geen wachtwoord, dus mijn commando ziet er zo uit:

drush si --db-url=mysql://root@127.0.0.1/commerce --account-name=admin --account-pass=admin --site-mail=admin@example.com --site-name="Drupal 8 Commerce" --locale=ru --yes

In de parameters geven we de gebruikersnaam, het wachtwoord en het e-mailadres van de beheerder op. Als de database commerce nog niet bestaat, zal Drush deze automatisch aanmaken of overschrijven en de Drupal-installatie erin plaatsen.

De installatie via de console duurt ongeveer 3 minuten, terwijl installatie via de browser (met het downloaden van vertalingen) wel 10 minuten kan duren. De console bespaart dus aanzienlijk tijd.

Herstart Open Server en controleer of de Drupal 8-site werkt:

Nu gaan we over tot de installatie van Drupal Commerce. We installeren Commerce via Composer. Open de console, navigeer naar de map van je site en voer het commando uit om de Commerce-module toe te voegen. Eerst voegen we het Drupal-pakketrepository toe aan Composer:

composer config repositories.drupal composer https://packages.drupal.org/8

Daarna voegen we Drupal Commerce zelf toe:

composer require "drupal/commerce 2.x-dev"

Composer zal automatisch de vereiste Drupal-modules downloaden:

En ook de nodige PHP-bibliotheken:

Nu kunnen we de modules Commerce, Commerce Cart, Commerce Checkout, Commerce Price, Commerce Product, Commerce Store en Commerce Order inschakelen:

drush en commerce commerce_cart commerce_checkout commerce_order commerce_price commerce_product commerce_store address entity inline_entity_form

Als sommige modules niet via Drush worden ingeschakeld, kun je dat ook via het beheerpaneel doen: