Magento extensies installeren: complete handleiding

Magento extensies breiden de functionaliteit van je webshop uit. In deze handleiding leer je hoe je extensies veilig installeert en beheert.

Extensies vinden

Magento Marketplace

De officiële bron voor Magento extensies:

1. Ga naar marketplace.magento.com
2. Filter op Magento versie en categorie
3. Bekijk reviews en compatibiliteit
4. Let op de laatste update datum

Andere bronnen

Naast de Marketplace vind je extensies op GitHub (open source) en bij externe leveranciers zoals Amasty en Mageworx. Pas de kwaliteitscriteria hieronder ook toe op extensies uit deze bronnen.

Kwaliteitscriteria

Let bij het kiezen van extensies op:

• Compatibility: Ondersteunt jouw Magento versie
• Reviews: Minimaal 4 sterren, meerdere reviews
• Updates: Recent bijgewerkt (binnen 6 maanden)
• Support: Actieve ontwikkelaar met support
• Documentatie: Goede installatie en configuratie docs

Risico van slechte extensies

Slechte extensies kunnen leiden tot:

• Security vulnerabilities
• Performance problemen
• Conflicten met andere extensies
• Update problemen bij Magento upgrades

Installatie via Composer (aanbevolen)

Composer is de standaard methode voor Magento 2 extensies.

Stap 1: Marketplace toegang configureren

1. Log in op marketplace.magento.com
2. Ga naar My Profile > Access Keys
3. Creeer een nieuwe key pair
4. Kopieer de public en private key

Stap 2: Auth configureren

Voeg de keys toe aan auth.json:

{
    "http-basic": {
        "repo.magento.com": {
            "username": "public_key_hier",
            "password": "private_key_hier"
        }
    }
}

Stap 3: Extensie installeren

# Navigeer naar Magento root
cd /pad/naar/magento

# Installeer de extensie
composer require vendor/module-name

# Registreer de module
bin/magento setup:upgrade

# Compileer dependency injection
bin/magento setup:di:compile

# Deploy static content
bin/magento setup:static-content:deploy nl_NL

# Leeg de cache
bin/magento cache:clean

Let op: staat je shop in developer- of default-modus, dan draait setup:static-content:deploy alleen met de optie -f (force): bin/magento setup:static-content:deploy -f nl_NL. In productiemodus is -f niet nodig.

Handmatige installatie

Voor extensies die niet via Composer beschikbaar zijn:

Stap 1: Download en upload

1. Download de extensie (ZIP bestand)
2. Pak uit op je computer
3. Upload naar app/code/Vendor/ModuleName/

Stap 2: Module registreren

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Structuur controleren

Een correct gestructureerde module heeft:

app/code/Vendor/ModuleName/
├── registration.php
├── etc/
│   └── module.xml
├── Block/
├── Controller/
├── Model/
└── view/

Extensies beheren

Overzicht van geïnstalleerde modules

bin/magento module:status

Dit toont alle enabled en disabled modules.

Module uitschakelen

bin/magento module:disable Vendor_ModuleName
bin/magento setup:upgrade
bin/magento cache:clean

Module inschakelen

bin/magento module:enable Vendor_ModuleName
bin/magento setup:upgrade
bin/magento cache:clean

Module verwijderen

# Via Composer (aanbevolen)
composer remove vendor/module-name
bin/magento setup:upgrade
bin/magento cache:clean

# Handmatige modules
bin/magento module:disable Vendor_ModuleName
# Verwijder de map uit app/code/
bin/magento setup:upgrade

Extensie configuratie

Na installatie moet je de meeste extensies configureren:

1. Ga naar Stores > Configuration
2. Zoek de extensie sectie (vaak onder eigen naam)
3. Configureer de instellingen
4. Klik op Save Config
5. Leeg de cache indien nodig

Veelgebruikte extensies per categorie

Betalingen

• Mollie Payments: iDEAL, creditcard, Bancontact
• MultiSafepay: Meerdere betaalmethodes
• Adyen: Enterprise betalingen

SEO

• Mageplaza SEO: Complete SEO suite
• Amasty SEO Toolkit: Geavanceerde SEO
• MageWorx SEO Suite: SEO optimalisatie

Performance

• LiteSpeed Cache: LiteMage caching
• Amasty Full Page Cache Warmer: Cache warming
• MageWorx Image Optimizer: Afbeelding optimalisatie

Marketing

• Mailchimp: E-mail marketing integratie
• Klaviyo: Marketing automation
• Google Shopping: Feed management

Troubleshooting

Logs controleren

Werkt een extensie niet zoals verwacht, kijk dan eerst in de logbestanden in var/log/, vooral exception.log en system.log:

tail -100 var/log/exception.log
tail -100 var/log/system.log

De foutmelding wijst vaak direct naar de extensie en het bestand dat het probleem veroorzaakt.

"Class not found" na installatie

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

"Cannot save" of permissions error

Controleer bestandspermissies:

find var generated vendor pub/static pub/media app/etc -type f -exec chmod 644 {} \;
find var generated vendor pub/static pub/media app/etc -type d -exec chmod 755 {} \;

Conflicten tussen extensies

1. Schakel extensies een voor een uit
2. Identificeer de conflicterende extensie
3. Neem contact op met de extensie ontwikkelaar
4. Overweeg een alternatieve extensie

Website werkt niet na installatie

# Schakel de module uit
bin/magento module:disable Vendor_ModuleName

# Als dat niet werkt, doe het via database
# Zoek module in setup_module tabel

Best practices

1. Test eerst op staging: Nooit direct op productie installeren
2. Backup maken: Altijd backup voor installatie
3. Een tegelijk: Installeer extensies een voor een
4. Documenteer: Houd bij welke extensies je hebt
5. Update regelmatig: Houd extensies up-to-date voor security
6. Minimaliseer extensies: Installeer alleen wat je echt nodig hebt. Elke extensie is extra code die onderhoud vraagt en de snelheid van je shop kan beïnvloeden