Store Locator

Votre licence est valide pour une durée illimitée sur une seule instance.

• Si vous utilisez plusieurs instances, il vous faudra acheter une licence supplémentaire pour chacune d'entre elles.
• Si vous gérez plusieurs sites sur la même instance, vous n’aurez besoin que d’une seule licence pour l’ensemble de vos domaines.

Bien que la période de validité de votre licence soit illimitée, celle de votre période de Support & Upgrade est quant à elle limitée à 12 mois (durée offerte à l’achat de votre licence). Passé ce délai, il vous faudra en acheter une nouvelle (voir FAQ: Prolonger sa période de Support)

Vous avez la possibilité de pré-enregistrer votre domaine de production à votre licence.

Grâce à cette option vous pourrez installer et activer votre domaine afin qu'il soit prêt à l'emploi avant son lancement en ligne.

Pour pré-enregistrer votre domaine :

1. Allez dans :
   mY account › Licenses & DOwnloads
2. Cliquez sur l'icone Settings à côté de l'extension pour laquelle vous souhaitez pré-enregistrer votre domaine.
3. En bas de la page, sous votre liste de domaine se trouve un lien. Cliquez sur :
   Do you want to pre-register your domain in order to be ready to go live?
   

   

4. Entrez votre nom de domaine puis cliquez sur  PRE-REGISTER NOW  pour finaliser votre pré-enregistrement.
   

   

   
   

Votre licence est valide pour une durée illimitée sur une seule interface. Il est possible, cependant, d'étendre ou de transférer votre licence dans deux cas : 

• Si vous désirez ajouter vos environnements de test à votre licence.
  Dans ce cas, vous pouvez étendre votre licence gratuitement, et ce, pour un nombre illimité de domaines (dev, staging, local..).
  Ex: mywebsite-staging.com ou mywebsite-dev.com
• Si vous souhaitez transférer votre licence sur un autre domain de production.
  Dans ce cas, la période de Support & Upgrade pour la licence doit être active.

Pour pouvoir utiliser Store Locator à la fois sur votre environnement de production et de test, suivez les étapes ci-dessous:

1. Téléchargez Store Locator depuis votre compte Wyomind.
   (voir FAQ: Téléchargement des modules)
2. Installez Store Locator sur votre environnement.
   (voir FAQ: Installation des modules sur Magento ou sur WooCommerce)
3. Activez la licence.
   (voir FAQ : Activation des licences en ligne de commande sur Magento ou sur WooCommerce)

Dans le cas où vous avez de nombreux domaines de staging ou si vous êtes une agence avec de nombreux domaines de pre-prod pour vos clients, contactez-nous afin de whitelister automatiquement tous vos domaines

Pour télécharger Store Locator, connectez-vous à votre compte Wyomind :

1. Allez dans :
   mon compte › Licenses & downloads  
2. Cliquez sur l'onglet paramètre en face de Store Locator.
   

   

   
   Une nouvelle fenêtre s'ouvre alors. 

3. Cliquez sur le bouton de téléchargement.
   

   

   
   

Seule la dernière version de l'extensiont publiée durant votre période de Support & Upgrade est disponible en téléchargement. Pour accéder à la toute dernière version de l'extension assurez vous de disposer d'une période de Support & Upgrade à jour

En achetant un module depuis wyomind.com, vous bénéficiez de 12 mois de mise à jour. Durant cette période vous pouvez à tout moment télécharger la dernière version du module directement depuis votre compte. 

Pour mettre à jour Store Locator, suivez les étapes suivantes :

1. Allez dans :
   mon compte › mes téléchargements
2. Cliquez sur l'icône paramètres en face de Store Locator.
3. Cliquez sur l'icône de téléchargement.
4. Installez la nouvelle version de Store Locator sur votre admin Magento ou WooCommerce.

Vous pouvez installer Store Locator manuellement.

1. Téléchargez Store Locator (fichier compressé) dans :
   mon compte › Licenses & Downloads
   Consultez la FAQ : Téléchargement des extensions
2. Ouvrez le dossier téléchargé et décompressez-le.
3. Copiez le contenu du dossier et collez-le dans le répertoire racine de votre site Magento 2.
4. Dans votre «Command Line Interface», exécutez :
   

   bin/magento setup:upgrade

   Si vous utilisez un mode production, exécutez également : 
   

   bin/magento setup:static-content:deploy 

   bin/magento setup:di:compile 

Vous pouvez installer Store Locator via Composer dans deux cas seulement :

• Si vous avez acheté Store Locator sur la place de marché de Magento ET que vous avez effectué une demande d’accès à notre dépôt d’extensions à notre support hello@syde.shop
• Si vous avez acheté Store Locator sur Wyomind.com 

1. Ajoutez le dépôt repo.wyomind.com à votre configuration composer :
   

   composer config repositories.wyomind composer https://repo.wyomind.com

   
   
2. Exécutez la commande Composer : 
   

   composer require wyomind/storelocator

3. Puis allez dans votre «Command Line Interface» et exécutez : 
   

   bin/magento setup:upgrade​

4. Si vous utilisez un mode production, exécutez également : 
   

   bin/magento setup:static-content:deploy ​

   bin/magento setup:di:compile

Pour désinstaller Store Locator, commencez par désactiver l'extension en exécutant la commande suivante :

bin/magento module:disable Wyomind_StoreLocator

Puis, vous avez deux moyens de désactiver l'extension, selon la méthode avec laquelle l'extension a été installée précédemment : 

• Installation manuelle
  

  Exécutez le fichier storelocator-uninstall.sh (vous pouvez le trouver dans le dossier zip de l'extension) depuis votre répertoire racine Magento :

  sh storelocator-uninstall.sh

• Installation via Composer
  

  Exécutez la ligne de commande suivante :

  composer remove wyomind/storelocator

Lorsque la désinstallation est terminée, pensez à nettoyer le cache et réactiver le compiler (si vous l'utilisez).

Si vous avez acheté Store Locator depuis la place de marché Magento, vous pouvez l’installer via Web Setup Wizard. 

Veuillez cliquer sur le lien ci-dessous pour vous renseignez sur comment procéder à l’installation : 
http://docs.magento.com/m2/ce/user_guide/system/component-manager.html

Votre extension installée, il ne vous reste plus qu’à activer votre licence :
Activation des extensions

Une fois que Store Locator est installé, vous devez activer la licence. Pour les anciennes versions, vous pouvez activer votre licence depuis le back-office :

1. Allez dans votre admin Magento. Un message apparaît en haut de la page.
   

   

   Si vous ne voyez rien apparaître, vérifiez les éléments suivants : 
      1. Les modules Adminhtml_Notifications et Wyomind_Core ne sont pas désactivés.
      2. La sortie HTML des modules Adminhtml_Notifications et Wyomind_Core ne sont pas désactivées dans :
   storesconfigurationadvanced advanced
      3. Assurez-vous que le fichier app/etc/env.php contient bien une clef d'encryptage :
   

   <?php
    return array(
    'backend' => array(
    'frontName' => 'admin'
    ),
    'crypt' => array(
    'key' => '1e8f3c6772b7a6a6689c3c8cefa4ccf0'
    ),
    /* ... */
    )
   ?>​​

    

1. Copiez votre clé d'activation.
   
   Vous pouvez trouver votre clé d'activation à 2 endroits :
   -  Dans l'email de confirmation que vous avez reçu suite à l'achat de Store Locator.
   -  Dans votre compte Wyomind :My account › Licenses & downloads
   Choisissez Store Locator et cliquez sur  .
   
   Une nouvelle page s'ouvre où sera affichée votre clé d'activation (voir ci-dessous).

   

2. Collez votre clé d'activation dans le champ Activation key dans :
   Stores › Configuration › Wyomind › Your extension     
   
   Choisissez une méthode d'activation entre Automatic (Yes) et Manual (No) :
   -  Si vous choisissez Yes : vous serez connecté automatiquement au serveur de licence de Wyomind.
   -  Si vous choisissez No : vous devez vous connecter avec votre navigateur au serveur de licence de Wyomind.
   

   

3. Sauvegardez les données en cliquant sur  Save Config .
4. Une notification apparaît en haut de votre admin. Cliquez sur ce lien : 
   Activate it now!
   

   

5. Copiez et collez le code de la licence dans le champ License code de votre admin ou cliquez simplement sur  Activate now! 
   

   

   
   

   

   
   
6. Pour finir, déconnectez-vous, nettoyez les caches et reconnectez-vous pour pouvoir utiliser Store Locator.

Ajoutez un autre domaine à votre licence

Pour activer votre licence sur un autre environnement (test, staging...) :

1. Une fois l'extension installée sur ce nouveau domaine, collez votre clé d'activation dans le champ Activation key dans :
   Stores › Configuration › Wyomind › Your extension
   
2. Sauvegardez la configuration. Une notification devrait apparaître. Cliquez sur Add this domain to my license.
   

   

3. Une demande de transfert sera envoyée directement à notre équipe (sous un délai d'une heure environ).
   Dès lors, que la demande de transfert est prise en charge par notre équipe, vous recevrez un mail de confirmation.
   Si votre demande est acceptée, vous pourrez aussitôt utiliser Store Locator sur vos deux domaines.

L'ordre d'activation de votre licence n'a aucune importance. Vous pouvez choisir d'activer d'abord votre licence sur votre environnement de production puis par la suite sur votre environnement de test, ou inversement. 

Une fois que Store Locator est installé, vous devez activer la licence.

Pour cela, vous pouvez utiliser la ligne de commande suivante :

bin/magento wyomind:license:activate Wyomind_StoreLocator <YOUR_ACTIVATION_KEY>

Afin de récupérer la liste des modules disponibles ainsi que le statut des licences, utilisez :

bin/magento wyomind:license:status

 Parmi les différents statuts : 

• registered = la licence a été enregistrée
• pending = vous devez exécuter la ligne de commande pour l'activation de la licence
• invalidated = la licence n'a pas été validée pour cause de mauvaise clé d'activation ou de violation de licence

Pour activer plusieurs licences à la fois, utilisez :

bin/magento wyomind:license:activate \
Wyomind_Extension1,Wyomind_Extension2 \
CLE_ACTIVATION_1,CLE_ACTIVATION_2

ou :

bin/magento wyomind:license:activate \
Extension1,Extension2 \
CLE_ACTIVATION_1,CLE_ACTIVATION_2

Ajoutez un autre domaine à votre licence.

Afin de pouvoir utiliser Store Locator, vous devez avoir une clé API Google renseignée dans la configuration de l'extension. 

Pour créer cette clé API :

1. Connectez-vous à https://console.developers.google.com. 
   Ici, vous devrez accepter les conditions d'utilisation avant de pouvoir cliquer sur  Agree and Continue . 
   

   

   
   
2. Vous devez dans un premier temps créer un nouveau projet en renseignant le nom, l'organisation et la situation.
   

   

3. A ce projet, vous devrez lier des API en cliquant sur  Enable APIs and services .
   

   

4. C'est depuis la bibliothèque que vous pouvez ajouter les services que vous souhaitez. 
   

   

5. Pour pouvoir utiliser Store Locator, vous devez activer les API suivantes en cliquant sur  Enable  : 
   

   - Maps JavaScript API
   - Geocoding API
   - Distance Matrix API
   - Directions API

   

6. Lorsqu'elles sont activées, vous pourrez voir le trafic, les erreurs et les latences pour chaque API. 
   

   

7. Vous devriez voir toutes les API activées depuis la section APIs. 
   

   

8. Depuis APIs & Services › Credentials, vous aurez la possibilité de créer des identifiants. 
   Cliquez sur  Create credentials  et choisissez API key.
   

   

9. Vous pourrez également restreindre votre clé API par sites, applications, adresses IP...
   

   

10. Une fois restreintes ou non, la clé API sera listée parmi les identifiants. 
    

    

11. La dernière étape consiste à lier votre compte à un compte de facturation depuis la section Billing sans quoi ça ne pourra fonctionner.