Cette extension fonctionne avec Magento Community Edition et Magento Enterprise Edition. Vous pouvez vérifier dans l'onglet Compatibility si Buy on Google est compatible avec votre version de Magento.

Magento propose désormais trois variantes de son produit.

Leurs noms ayant changé au cours des dernières années, voici un récapitulatif :

• Magento Open Source : anciennement Magento Community Edition (CE), est une plate-forme de commerce électronique gratuite.
• Magento Commerce : anciennement Magento Enterprise (EE), est la version payante de Magento et propose des services de support.
• Magento Commerce Cloud : est la version payante de Magento et propose des services de support et d'hébergement.

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.

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 accountLicenses & 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 Buy on Google à la fois sur votre environnement de production et de test, suivez les étapes ci-dessous:

1. Téléchargez Buy on Google depuis votre compte Wyomind.
   (voir FAQ: Téléchargement des modules)
2. Installez Buy on Google 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)

Pour télécharger Buy on Google, connectez-vous à votre compte Wyomind :

1. Allez dans :
   mon compte Licenses & downloads  
2. Cliquez sur l'onglet paramètre en face de Buy on Google.
   

   
   Une nouvelle fenêtre s'ouvre alors. 

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

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 Buy on Google, suivez les étapes suivantes :

1. Allez dans :
   mon comptemes téléchargements
2. Cliquez sur l'icône paramètres en face de Buy on Google.
3. Cliquez sur l'icône de téléchargement.
4. Installez la nouvelle version de Buy on Google sur votre admin Magento ou WooCommerce.

Vous pouvez installer Buy on Google via Composer dans deux cas seulement :

• Si vous avez acheté Buy on Google 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 contact@wyomind.com
• Si vous avez acheté Buy on Google 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/googleshoppingaction

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 Buy on Google, commencez par désactiver l'extension en exécutant la commande suivante :

bin/magento module:disable Wyomind_GoogleShoppingAction

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 googleshoppingaction-uninstall.sh (vous pouvez le trouver dans le dossier zip de l'extension) depuis votre répertoire racine Magento :

  sh googleshoppingaction-uninstall.sh

   

• Installation via Composer
  

  Exécutez la ligne de commande suivante :

  composer remove wyomind/googleshoppingaction

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

Vous pouvez installer Buy on Google manuellement.

1. Téléchargez Buy on Google (fichier compressé) dans :
   mon compteLicenses & 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 :
   

   composer require google/apiclient:^2.0​

     

5. Puis :

   bin/magento setup:upgrade

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

   bin/magento setup:static-content:deploy 

   bin/magento setup:di:compile 

Une fois que Buy on Google 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 Buy on Google.
   -  Dans votre compte Wyomind :My account Licenses & downloads
   Choisissez Buy on Google 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 :
   StoresConfiguration 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 Buy on Google.

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 Buy on Google 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 Buy on Google est installé, vous devez activer la licence.

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

bin/magento wyomind:license:activate Wyomind_GoogleShoppingAction <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

Si vous avec une notification comme ci-dessous dans votre admin Magento indiquant qu'il est impossible d'établir une connexion avec Google Merchant, vous devriez vérifier que vous avez ajouté votre identifiant Marchand ainsi que le fichier JSON pour l'API Google. Comment trouver votre identifiant Marchand ?

Le fichier JSON ainsi que votre identifiant doivent être ajouté dans Google Shopping API Settings depuis : 
StoresSettingsConfigurationWyomindGoogle Shopping Actions

Vous obtenez un message comme ci-dessous dans votre admin Magento lorsque vous essayez d'importer des commandes indiquant qu'il est impossible d'accéder aux commandes du compte.

Dans ce cas, vous devriez vérifier les droits de l'utilisateur API dans le compte Google Merchant depuis Outils et paramètres > Paramètres > Content API > Authentication.

L'utilisateur doit avoir accès à "Order manager" comme ci-dessous :

Vous pouvez retrouver votre identifiant dans votre compte Google Merchant Center, à côté du nom de votre entreprise (Entreprise : identifiant).