Cette extension fonctionne avec Magento Community Edition et Magento Enterprise Edition. Vous pouvez vérifier dans l'onglet Compatibility si Shop By Brand 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 Shop By Brand à la fois sur votre environnement de production et de test, suivez les étapes ci-dessous:

1. Téléchargez Shop By Brand depuis votre compte Wyomind.
   (voir FAQ: Téléchargement des modules)
2. Installez Shop By Brand 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 Shop By Brand, connectez-vous à votre compte Wyomind :

1. Allez dans :
   mon compte Licenses & downloads  
2. Cliquez sur l'onglet paramètre en face de Shop By Brand.
   

   
   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 Shop By Brand, suivez les étapes suivantes :

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

Vous pouvez installer Shop By Brand manuellement.

1. Téléchargez Shop By Brand (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 :
   

   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 Shop By Brand via Composer dans deux cas seulement :

• Si vous avez acheté Shop By Brand 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 [email protected]
• Si vous avez acheté Shop By Brand 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/shopbybrand

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

bin/magento module:disable Wyomind_ShopByBrand

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

  sh shopbybrand-uninstall.sh

   

• Installation via Composer
  

  Exécutez la ligne de commande suivante :

  composer remove wyomind/shopbybrand

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

Si vous avez acheté Shop By Brand 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 Shop By Brand 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 Shop By Brand.
   -  Dans votre compte Wyomind :My account Licenses & downloads
   Choisissez Shop By Brand 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 Shop By Brand.

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 Shop By Brand 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 Shop By Brand est installé, vous devez activer la licence.

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

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