Hoe installeer je de TradeTracker plugin met Composer
Op deze pagina vindt u gedetailleerde instructies over hoe u de extensie TradeTracker in uw Magento 2-omgeving installeert en configureert. Deze handleiding richt zich op het gebruik van Composer voor installatie, wat de aanbevolen methode is voor het beheren van afhankelijkheden in Magento.
U leert de noodzakelijke stappen om ervoor te zorgen dat de extensie correct is ingesteld, inclusief hoe u de installatie kunt verifiëren en de instellingen kunt configureren om aan uw specifieke behoeften te voldoen.
Stapsgewijze installatie van Magento 2-extensies via Composer
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.
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.
Installeer en activeer de extensie via Composer
Deze module is beschikbaar op Packagist, dus het is niet nodig om hiervoor een aparte repository toe te voegen.
Download Extensie
Om de extensie in je Magento-installatie te downloaden, voer je het volgende commando uit vanuit de Magento-rootmap:
composer require tradetracker-com/magento2
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 TradeTracker extensie door de volgende commando’s uit te voeren:
php bin/magento module:enable TradeTracker_Connect
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 → TradeTracker
Update of verwijder de extensie via Composer
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 tradetracker-com/magento2
Updaten naar een specifieke versie:
composer require tradetracker-com/magento2:x.y.z
Verwijderen van de extensie:
composer remove tradetracker-com/magento2
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
Veel voorkomende issues
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:
- Controleer de Magento error logs:
var/log/system.logenvar/log/exception.log. - Verifieer dat alle vereisten zijn voldaan (PHP versie, vereiste extensies, bestandsrechten).
- Controleer of alle module bestanden correct zijn geüpload (vergelijk met het originele zip-bestand).
- Neem contact op met Magmodules Support en vermeld:
- Uw Magento versie
- PHP versie
- Installatiemethode (FTP/SSH)
- Volledige foutmeldingen
- Stappen die u al heeft geprobeerd.