Hoe installeer je de e-Boekhouden-extensie met Composer

Belangrijk: Als de plugin is aangeschaft via de Adobe Marketplace, is deze installatiemethode niet van toepassing. De onderstaande stappen gelden alleen voor bestellingen die rechtstreeks via onze site zijn geplaatst.

Het installeren van Magento-extensies via Composer heeft de voorkeur, omdat Composer afhankelijkheden beheert, versiecompatibiliteit waarborgt en het updateproces vereenvoudigt. Composer maakt het installeren en beheren van PHP-pakketten een stuk efficiënter en is daarmee een essentieel hulpmiddel binnen Magento-ontwikkeling.

Verkrijg de gegevens

Log in op je account om je Composer Authenticatiesleutels en Inloggegevens op te halen. Deze worden automatisch gegenereerd na aankoop van een van onze extensies. Je kunt ook nieuwe Composer-sleutels aanmaken met een beschrijving, bijvoorbeeld als je van omgeving of sleutels wilt wisselen.

Backup (optioneel maar aanbevolen)

We raden sterk aan om de installatie eerst in een ontwikkelomgeving te testen voordat je deze live zet. Zorg er ook voor dat je een volledige back-up van je webshop hebt, zodat je indien nodig kunt terugrollen.

De volgende stap is het toevoegen van de packages.magmodules.eu-repository aan je Composer-bestand.

Repository toevoegen via SSH

Via een SSH-verbinding hoef je alleen het onderstaande commando uit te voeren vanuit de Magento-installatiemap. Op deze manier maak je verbinding met onze privé-repository.

composer config repositories.magmodules composer https://packages.magmodules.eu/

Na het uitvoeren van dit commando verschijnt er een lege regel en zijn de repositories succesvol toegevoegd aan je composer.json-bestand.

Als je de Composer-repository handmatig wilt toevoegen, bekijk dan je account voor de exacte commando’s.

Zodra de repository is toegevoegd aan het composer.json bestand, kun je nu de beschikbare pakketten via deze repository installeren. Schakel indien gewenst de onderhoudsmodus in, zie het laatste deel van deze sectie.

Download extensie

Om de extensie naar je webshop te downloaden, voer je het volgende commando uit:

composer require magmodules/magento2-eboekhouden

Na het uitvoeren van dit commando wordt bij de eerste keer gevraagd om de gebruikersnaam en het wachtwoord van de Composer Auth Keys. Deze kunnen worden verkregen hier.

Installeer extensie

Wanneer de extensie succesvol is gedownload, start dan de setup van de E-boekhouden Boekhoud koppeling extensie door de volgende commando's uit te voeren:

php bin/magento module:enable Magmodules_Eboekhouden
php bin/magento module:enable Magmodules_AccountingBase 
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Nu je de juiste commando's succesvol hebt uitgevoerd en de extensie is geïnstalleerd, is deze klaar voor configuratie. Navigeer naar Stores ⇨ Configuration ⇨ Magmodules ⇨ E-boekhouden Boekhoud koppeling en Accounting om te beginnen met configureren.

Onderhoudsmodus

Je wilt misschien de onderhoudsmodus inschakelen bij het installeren of updaten van de module, vooral bij een live website. Voer hiervoor onderstaande commando's uit vóór en na het uitvoeren van de andere setup commando's:

php bin/magento maintenance:enable
# Andere setup commando's
php bin/magento maintenance:disable

Het is ook mogelijk om eenvoudig te verwijderen, bij te werken of bij te werken naar een specifieke versie met behulp van de volgende commando's:

Om de extensie bij te werken naar de nieuwste versie, gebruik je het commando:

composer update magmodules/magento2-eboekhouden
composer update magmodules/magento2-accounting-base

Als je een andere versie wilt bijwerken, niet de nieuwste versie van de extensie, gebruik dan het commando:

composer require magmodules/magento2-eboekhouden:version
composer update magmodules/magento2-accounting-base:version

Om de extensie te verwijderen, gebruik je het commando:

composer remove magmodules/magento2-eboekhouden
composer update magmodules/magento2-accounting-base