Documentation du plugin Magento

Documentation du plugin Magento

Plugin de recommandations Magento

Ce document décrit le processus d’installation et de configuration du plugin Ezako pour Magento.

Description

Grace au moteur de recommandation Ezako disponible dans le cloud, Ce plugin effectue des recommandations produit de haute qualité. Dans le but de fournir la meilleure recommandation pour chaque produit et chaque utilisateur, le plugin collecte de façon anonyme des informations à propos des pages vues, ventes et produits en stock. Aucune information personnelle client n’est conservée.

Installation

Important: Il se peut que les recommandations ne soient pas visibles dès la fin de l’installation. Cela est lié au temps d’initialisation du serveur, qui devrait être inférieur à une heure.

1) Télécharger le module

Si vous ne l’avez pas encore fait, merci de télécharger le plugin depuis ce lien :   télécharger

2) Installer le module

– Sur votre site rendez-vous dans la section “System” > “Magento Connect” > “Magento Connect Manager”magento connect

 

– Dans la section “Direct package file upload” dans “Browse” séléctionner l’endroit ou se trouve notre plugin Magento ‘Ezako_Reco’ et cliquez sur “Upload”magento file upload

 

– Dans la console vous pouvez voir apparaitre un message vous informant que l’installation c’est bien dérouler. Pour terminer cliquez sur “Refresh” pour voir désormais apparaitre notre module dans la liste de vos extensions et retournez dans votre interface admin.magento console

3) Configurer le module

– Une fois revenu dans votre interface d’admin, rendez-vous dans la section “System” > “Configuration”magento configuration

 

– Vous pouvez désormais voir apparaitre dans le menu “Configuration” sous l’onglet “SERVICES” la section “Ezako”. Cliquez dessus.magento ezako service

 

– Vous devez maintenant configurer votre interface. Notre configuration est séparée en trois sections:

Vous devez OBLIGATOIREMENT remplir la section 1 pour activer les recommandations.

–> Section 1: Vous devez renseigner l’id site que vous avez fournit lors de votre inscription sur le site ezako.com ainsi que la clé privée que nous vous avons fournit suite à cette inscription. Pour information, cette clé privée est disponible dans votre page de profil.

–> Section 2: La deuxième section concerne l’activation des recommandations. Par défaut les recommandations sur la page “Home” et sur les pages “Produits” sont activées. Vous pouvez donc personnaliser votre interface en activant ou désactivant certains types de recommandations.

–> Section 3: La troisième section concerne le nombre de recommandations affichées pour les différents types de recommandations (pouvant aller de 1 à 12). Par défaut les recommandations pour les pages “Home”, “Produits” et “Catégories” sont à 4 et celles pour les blocs droit et gauche de ces pages sont à 2. Vous pouvez donc personnaliser votre interface en choisissant le nombre de recommandations affichées.

magento ezako configuration

– ATTENTION : Vous risquez peut-être de voir apparaitre un “404 Page Not Found”magento 404 error

Si c’est effectivement le cas, vous devez suivre les étapes suivantes :

  • Déconnecter vous de votre interface admin
  • Vider le cache de votre navigateur
  • Reconnecter vous sur votre interface admin

Vous devez maintenant pouvoir accéder à la configuration de notre module.

4) Customiser le module

Comment adapter les templates graphiques?

Nous possédons deux types de templates : recoHorizontal.phtml et recoVertical.phtml, tous deux situés dans le dossier : /app/design/frontend/base/default/template/ezReco .

Le template recoHorizontal.phtml est utilisé au coeur des pages “Home”, “Catégories” ou “Produits” et le template recoVertical.phtml est utilisé pour les colonnes droites et gauches de ces pages.

Si vous souhaitez modifier le style de ces templates pour qu’ils correspondent au design de votre site, n’hésitez pas à le faire. Nous vous conseillons tout de même, de le mettre dans un fichier css à part, ainsi, lors de la sortie d’une nouvelle version de notre plugin il vous sera plus facile de remettre votre design en place.

Comment positionner un bloc de recommandations dans une page CMS?

Par défaut, nous avons positionner les blocs de recommandations en tout début des pages ou des colonnes ou à la toute fin. Vous avez la possibilité de modifier ce placement pour les pages CMS en suivant les indications suivantes :

– Dans l’interface admin, rendez-vous dans “CMS” > “Pages” et séléctionnez la page CMS qui vous intéresse.

– Dans le menu “Page Information” dans la section “Content” cliquez sur “Show / Hide Editor” et placer un code de type :

{{block type="ezReco/ezreco" name="NAME" eztype="TYPE" template="ezReco/recoHorizontal.phtml" }}

si vous souhaitez ajouter un bloc de type horizontal (conseillé si vous placer le bloc au coeur de la page)

ou placer un code de type :

{{block type="ezReco/ezreco" name="NAME" eztype="TYPE" template="ezReco/recoVertical.phtml" }}

si vous souhaitez ajouter un bloc de type vertical (conseillé si vous placer le bloc dans la colonne de droite ou de gauche)

Information importante :

* dans le name=“…” vous devez donner un nom au bloc, vous pouvez le nommé comme vous le souhaitez mais faites attention de ne pas lui donner le même nom qu’un autre bloc existant ce qui pourrait causer des problèmes à l’affichage de la page.

* dans le eztype= “…” faites attention vous avez un choix restreint en fonction de la page ou vous affichez le bloc de recommandation. Vous pouvez donc choisir le ezType parmis la liste suivante :

  • Home => pour la page d’accueil
  • Prod => pour les pages produits
  • Cat => pour les pages catégories
  • Left => pour la colonne de gauche
  • Right => pour la colonne de droite

– Enfin, pour éviter la répétition de ce bloc, rendez-vous dans le layout ezReco.xml situé dans le dossier /app/design/frontend/base/default/layout/ et commenter la partie concernant le bloc que vous avez déplacé (pour facilement le retrouver, regardez le ezType que vous avez choisi de déplacé).

Comment changer le positionnement des blocs de recommandations dans une page autre qu’une page CMS?

En fonction de ce que vous souhaitez faire, ou des pages dans lesquelles vous souhaitez déplacer le bloc, la solution ne sera pas forcément la même.

* La solution la plus simple et qui fonctionnera dans la plupart des cas est celle décrite ci-dessous :

Rendez-vous dans le layout ezReco.xml situé dans le dossier app/design/frontend/base/default/layout/ et modifier l’attribut “after” ou “before” des blocs que vous souhaitez repositionner comme préconisé par Magento : http://www.magentocommerce.com/knowledge-base/entry/controlling-block-order

* Dans certains cas spécifiques, cette approche ne fonctionnera pas et il faudra aller rajouter le code du bloc en question situé dans ezReco.xml dans le .xml spécifique à la page en question. Ajouter donc un code de type :

<block type="ezReco/ezreco" name="NAME" template="ezReco/recoHorizontal.phtml">
<action method="setData"><name>eztype</name><value>TYPE</value></action>
</block>

entre les blocs déjà présent sur la page et ainsi le bloc de recommandations s’affichera à l’endroit désiré. Attention, n’oubliez pas de commenter ce même bloc dans le fichier ezReco.xml pour éviter sa duplication.

5) Félicitations vous avez terminé l’installation du module !

Vous pouvez désormais voir des recommandations sur votre site !

Si vous avez activé des recommandations de type recoHorizontal.phtml vous verrez ce type de recommandations :magento horizontal recommendations

 

Si vous avez activé des recommandations de type recoVertical.phtml vous verrez ce type de recommandations :

magento vertical recommandations