MaxCDN Magento 2

Installatiehandleiding

Inhoudsopgave


1. Inleiding

Deze handleiding beschrijft de installatie van de MaxCDN Magento 2 extensie. De extensie is ontwikkeld door TIG.

Deze extensie zorgt ervoor dat Magento 2 en MaxCDN samenwerken.

Support, feedback & feature requests
Voor vragen en/of opmerkingen over de extensie kunt u contact opnemen met TIG.
Telefoon: 020–2181000
E-mail: servicedesk@tig.nl

2. Installatie

In dit hoofdstuk beschrijven wij de installatie van de MaxCDN extensie voor een Magento 2 webshop in Developer mode en cache aan op een staging omgeving. De installatie gaat via de packagemanager Composer.

2.1 backup 

Wij adviseren om vooraf een backup te maken van uw omgeving.

2.2 Omgeving gereed maken & bestanden downloaden

Login met SSH op uw server en navigeer naar de root van de Magento 2 installatie.
Voer onderstaande opdrachten uit om uw omgeving klaar te maken voor de installatie en de bestanden binnen te halen.

  • php bin/magento maintenance:enable
  • composer require tig/maxcdn-magento2

2.3 Extensie activeren & bijwerken

Voer onderstaande opdrachten uit.
Let op! Het is belangrijk om de volgorde aan te houden die hieronder staat beschreven.

  • php bin/magento module:enable TIG_MaxCDN

Leeg onderstaande mappen (als ze bestaan). Let op, niet verwijderen.

  • var/cache
  • var/page_cache
  • var/generation
  • var/di 
  • var/view_preprocessed

Flush uw cache.

  • php bin/magento cache:flush

Werk uw Magento 2 installatie bij.

  • php bin/magento setup:upgrade

Deploy uw static content voor Engels:

  • php bin/magento setup:static-content:deploy

Deploy uw static content voor uw eigen taal, bijvoorbeeld:

  • php bin/magento setup:static-content:deploy nl_NL

Voer een reindex uit.

  • php bin/magento indexer:reindex

De installatie op uw staging omgeving is nu afgerond.

3. Updaten 

Regelmatig dient u de extensie bij te werken zodat u gebruik maakt van de meest recente versie.
Voer onderstaande stappen hiervoor uit.

  • composer update tig/maxcdn-magento2

Flush uw cache.

  • php bin/magento cache:flush

Leeg onderstaande mappen. Let op, niet verwijderen.

  • var/cache
  • var/page_cache
  • var/generation
  • var/di (if this folder exists)
  • var/view_preprocessed

Werk uw Magento 2 installatie bij.

  • php bin/magento setup:upgrade

Deploy uw static content voor Engels:

  • php bin/magento setup:static-content:deploy

Deploy uw static content voor uw eigen taal, bijvoorbeeld:

  • php bin/magento setup:static-content:deploy nl_NL

Voer een reindex uit.

  • php bin/magento indexer:reindex

De update is nu afgerond. De maintenance mode kunt u weer uitschakelen:

  • php bin/magento maintenance:disable

4. Veelgestelde vragen

Waarom krijg ik steeds CORS-gerelateerde fouten in mijn console?
Ja. Wij hebben integratie- en unittests in de code opgenomen. Bekijk ze op https://travis-ci.org/tig-nl/postcode-magento2

Hoe maak ik de API-Application aan?

  • Zorg ervoor dat u bent ingelogd op uw MaxCDN-account en volg deze URL
  • Klik op Create Application
  • Voer een naam en beschrijving in voor uw API-toepassing, de applicatie-URL en callback-URL moeten uw winkel-URL repliceren
  • Vink Allow API key full permission to this account aan
  • Klik op Update en u krijgt de nodige inloggegevens om de extensie te configureren.
  • Vergeet niet het IP-adres van uw servers op de witte lijst te zetten!

Waar vind ik de extensie instellingen terug?

De configuratie van de extensie kan terug gevonden worden onder "Stores > Configuration > Advanced > MaxCDN".

Hoe configureer ik de extensie?


  • Noteer de Company Alias, de Consumer Key en de Consumer Secret en voer deze in de bijbehorende velden van de configuratiepagina van deze Magento 2-module in.
  • Ga naar Stores > Configuration > General > Web en voer de CDN-URL van uw Pull Zone in de velden (Secure) Base URL for Static View Files and (Secure) Base URL for User Media Files.
    • Zorg ervoor dat u elke URL toevoegt met respectievelijk /pub/static of /media/.
  • Ga binnen het MaxCDN-configuratiescherm naar Zones > Pull Zones,
  • Klik op Manage > Settings naast de corresponderende Pull Zone.
  • Controleer in de Instellingen of je de Add CORS Header-optie hebt aangevinkt en op Update hebt geklikt.
  • Je bent klaar! Geniet van MaxCDN op Magento 2!

Waarom beschrijft de handleiding uitsluitend de installatie op een staging omgeving?

Magento 2 werkt met drie verschillende modi. De staging webshop draait altijd in developer modus en de live omgeving in production modus.
De wijze waarop extensies op de productie omgeving worden geplaatst en beheerd is geen onderdeel van Magento zelf. Wij adviseren om GIT hiervoor te gebruiken.

Het proces dat wij adviseren:

  1. Installatie op staging webshop.
  2. Configuratie op staging webshop.
  3. Testen op staging webshop
  4. Composer.json en composer.lock via GIT overzetten naar live webshop
  5. Run de volgende opdracht via de command line: Composer install

Stappen Extensie activeren & bijwerken + Flush cache and reindex op live webshop.

6. Technische systeemvereisten

Om de MaxCDN Magento 2 handleiding te gebruiken dient uw omgeving te voldoen aan de systeemvereisten van Magento 2 te vinden op http://devdocs.magento.com/guides/v2.0/install-gde/system-requirements.html

Uitleg over de ondersteunde Magento 2 versie's kunt u vinden op https://confluence.tig.nl/x/2wHW