Postcode service 2

Installatiehandleiding

Inhoudsopgave


1. Inleiding

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

Uw klanten kunnen met deze extensie adresgegevens in het afrekenproces automatisch laten aanvullen op basis van het ingevulde postcode en huisnummer.

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

Postcode service contract
Om gebruik te kunnen maken van de extensie heeft u een postcodeservice contract nodig. Een contract sluit u al af vanaf €10 per maand. Alle benodigde gegevens kunt u aanvragen via deze link: https://tig.nl/postcode-service/api/

Indien er aanvullende vragen zijn over uw aanmelding neemt TIG telefonisch contact met u op.

2. Installatie

In dit hoofdstuk beschrijven wij de installatie van de Postcode service 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/postcode-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_Postcode

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/postcode-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. Configuratie

U dient de extensie te configureren voordat u de extensie in gebruik neemt.
Uitleg hierover kunt u vinden via de volgende link:

http://Linkje-naar-pagina 

5. Veelgestelde vragen

Zijn er testen in de code opgenomen?
Ja. Wij hebben integratie- en unittests in de code opgenomen. Bekijk ze op https://travis-ci.org/tig-nl/postcode-magento2

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 Postcode service 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