Hoe installeer je de Bol.com Integratie plugin 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 Magmodules-repository is toegevoegd aan je composer.json, kun je alle pakketten installeren die via deze repository beschikbaar zijn. Indien gewenst, kun je de onderhoudsmodus inschakelen voordat je verdergaat.

Download Extensie

Om de extensie in je Magento-installatie te downloaden, voer je het volgende commando uit vanuit de Magento-rootmap:

composer require magmodules/magento2-bol

Als er nog geen Composer-authenticatiesleutels zijn ingesteld, wordt je gevraagd om de gebruikersnaam en het wachtwoord in te voeren. Deze Composer Auth Keys kun je verkrijgen via je Magmodules-account:
Magmodules Auth Keys

Installeer Extensie

Nadat de extensie is gedownload, installeer en activeer je de Bol.com Integratie extensie door de volgende commando’s uit te voeren:

php bin/magento module:enable Magmodules_Bol
php bin/magento setup:upgrade

Als je Magento-winkel in productiemodus draait, moet je de code opnieuw compileren en statische content deployen:

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f

Het wordt aanbevolen om de Magento-cache te legen na de installatie:

php bin/magento cache:flush

Zodra deze commando’s succesvol zijn uitgevoerd, is de extensie geïnstalleerd en klaar voor configuratie. Je kunt de extensie configureren via: Stores → Configuration → Magmodules → Bol.com Integratie

Zodra de extensie via Composer is geïnstalleerd, kun je deze eenvoudig bijwerken, naar een specifieke versie wisselen of volledig verwijderen. Composer zorgt ervoor dat afhankelijkheden correct worden beheerd, waardoor updates veilig en consistent blijven.

Updaten naar de nieuwste versie:

composer update magmodules/magento2-bol

Updaten naar een specifieke versie:

composer require magmodules/magento2-bol:x.y.z

Verwijderen van de extensie:

composer remove magmodules/magento2-bol

Na het updaten of verwijderen, voer je de volgende commando's uit:

php bin/magento setup:upgrade
php bin/magento cache:flush

In productiemodus, gebruik je de volgende commando's:

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f

503 Service Temporarily Unavailable na installatie

Oorzaak: Onderhoudsmodus nog steeds actief.

Oplossing:

Schakel de onderhoudsmodus uit:

php bin/magento maintenance:disable

Of verwijder handmatig het onderhoudsbestand:

rm var/.maintenance.flag

Memory Limit fouten tijdens compilatie

Oorzaak: PHP memory limit te laag ingesteld.

Oplossing:

Verhoog de memory limit tijdelijk:

php -d memory_limit=2G bin/magento setup:di:compile

Of pas php.ini permanent aan:

memory_limit = 2G

Nog steeds problemen?

Als u problemen blijft ondervinden:

1. Controleer de Magento error logs: var/log/system.log en var/log/exception.log.
2. Verifieer dat alle vereisten zijn voldaan (PHP versie, vereiste extensies, bestandsrechten).
3. Controleer of alle module bestanden correct zijn geüpload (vergelijk met het originele zip-bestand).
4. Neem contact op met Magmodules Support en vermeld:
   • Uw Magento versie
   • PHP versie
   • Installatiemethode (FTP/SSH)
   • Volledige foutmeldingen
   • Stappen die u al heeft geprobeerd.