Sommaire

• Administration
• Les options
• Supprimer le duplicate du pager
• Désactiver les filtres vides
• Désactiver le filtre de catégorie
• Activer les liens sur les attributs
• Rechercher la catégorie du produit
• Ajouter la marque au nom du produit
• Canonical URL
• Activer les urls canoniques
• Url canonique par filtre de categorie
• Url canonique par page de categorie
• Url canonique sur la liste des commentaires de produit
• Url canonique sur la page du commentaire produit
• Les Optimisations Meta
• Les elements disponibles
• Définition de property
• Définition de option
• Utiliser la fonction de remplacement
• Exemples
• Optimisation des templates avec les masques
• Réécriture d'URL
• Réécriture de l'URL des tags
• Prefix de réécriture de l'URL des tags
• Réécriture de l'URL des filtres de catégorie
• Traduire les clés des filtres dans l'URL
• Traduire les valeurs des filtres dans l'URL
• Utiliser la fonction de remplacement des clé et valeurs de filtres
• Suffix d'URL des categories dans les URL des filtres
• Statistiques de ventes entre produits
• Activer l'agregation
• Attribut par defaut
• Remplacer le block de ventes incitatives

Administration

Pour accéder à l'administration du plugin Seogento, rendez-vous dans Système > Configuration, puis dans le menu de gauche vous trouvez l'onglet Seogento dans la section Catalogue.

Si vous obtenez une erreur ou une page blanche consultez les instructions d'installation

La configuration de l'extension Seogento ce divise en deux partie :
Les options : permet de régler les fonctionnalités générales
Les Optimisations Meta : permet de définir les balises meta pour les différents éléments (actuellement produits et categories)

Les options

Supprimer le duplicate du pager

Si cette option est activé, elle enlève le paramètre p=1 dans l'url du lien vers la page 1 sur un listing de produit. Cette option forcera la suppression du filtre par catégorie. Elle nécessite la surcharge (rewrite) de la classe Mage_Catalog_Block_Product_List_Toolbar.

Désactiver les filtres vides

Activez cette option pour supprimer les liens vers les filtres qui ne possèdent pas de produits (apparemment inutile dans les version de magento > 1.3, peut-être utile dans certains templates mal formés). Cette option nécéssite de surchargé (rewrite) la classe Mage_Catalog_Block_Layer_View.

Désactiver le filtre de catégorie

Le filtre par catégorie provoque un duplicate content. En effet il ne redirige pas sur la page de la sous-catégorie mais rajoute un paramètre cat dans l'url. Cette option forcera la suppression du filtre par catégorie. Elle nécessite la surcharge (rewrite) de la classe Mage_Catalog_Block_Layer_View.

Activer les liens sur les attributs

Cette option permet de rajouter des liens sur les attributs filtrables dans le section Information complémentaire d'une page produit. Votre client ainsi que les moteurs de recherche seront redirigé vers la catégorie parente avec un filtre préselectionné sur cette valeur. Cette option nécessite la surcharge (rewrite) de la classe Mage_Catalog_Block_Product_AttributesLink.

Rechercher la catégorie du produit

Ceci permet de régler le problème de la page de produit où la catégorie n'apparait pas.

Pour l'expliquer, Magento repère la catégorie d'une page produit seulement dans certains cas :

• L'url contient le nom de la catégorie (si les produits ne sont pas situé dans la catégorie racine)
• La session de client contient l'url précédemment visitée, et donc probablement le nom de la catégorie.
• L'entête http referrer envoyé par le client est disponible et contient donc aussi probablement le nom de la catégorie.

Aucune de ces informations n'est disponible lors du parcours du site par les robots des moteurs de recherche.

Il en résulte que votre page produit ne dispose d'aucune information concernant sa catégorie. Pour un bon référencement il est nécessaire d'activer cette option.

Ajouter la marque au nom du produit

Le nom du produit apparait dans un h2 par défaut sur Magento. Il est donc important d'avoir un nom significatif. Cette option vous permettra d'ajouter automatiquement la marque du produit (si elle existe) avant son nom lors de l'affichage (si cette marque n'est pas déjà présente dans le nom du produit). Elle nécessite la surcharge (rewrite) de la classe Core_Model_Catalog_Product.

Canonical URL

Activer les urls canoniques

Cette option active l'ajout de l'entête canonicals urls. Cela va permettre au moteur de se représenter différentes pages comme faisant partie d'une seule entité, d'un seul contenu. Les pages annexes d'un élément (comme un produit ou une categorie) seront rattachées à la page principale de l'élément.

Url canonique par filtre de categorie

Permet d'envoyer l'URL canonique de la page actuelle (avec le paramètre de filtre) au lieu de l'url de la categorie simple. Si cette option est activée, l'URL canonique sur une page de categorie sera l'url entière actuelle.

Url canonique par page de category

Permet d'envoyer l'URL canonique de la page actuelle (avec le paramètre p) au lieu de l'url de la categorie simple. Si cette option est activée, l'URL canonique sur une page de categorie sera l'url entière actuelle.

Url canonique sur la liste des commentaires de produit

Permet d'envoyer l'URL canonique du produit pour les pages de liste de commentaires produit. Si cette option est activée, l'URL canonique sur une page de liste de commentaires produit sera l'url du produit.

Url canonique sur la page du commentaire produit

Permet d'envoyer l'URL canonique du produit pour les pages de commentaire produit simple. Si cette option est activée, l'URL canonique sur une page de commentaire produit simple (où seul le commentaire est affiché) sera l'url du produit.

Les Optimisations Meta

Les balises title, meta keywords et meta description s'optimisent différemment suivant le type de page (page produit ou page de catégorie). Pour palier ce problème, un masque est paramètrable en fonctions des différents éléments de la page courante.

Une attention particulière est apporté à la balise title, pour lesquels vous pourrez définir deux masques différents. L'un si votre title originel existe déjà (title par defaut), et l'autre s'il est absent (title forcé). Cela vous permettra d'optimiser encore plus finement vos éléments. Si le masque devant être analyser est vide, le title originel par défault de Magento s'affichera.

La syntaxe du masque pour prendre en compte des éléments dynamiques est la suivante :
{{element/property[|property][...] [option="valeur"][...]}}

Les element disponibles

Définition de property :

Une property est une propriétés d'un élément. Chaque élément à ses propres propriétés.

category et categories dispose des property suivantes :

• name
• meta_title
• meta_keywords
• meta_description
• level
• product_count
• image_url
• ainsi que tout ce qui correspond au model Mage_Catalog_Model_Category

product dispose des property suivantes :

• name
• meta_title
• meta_keywords
• meta_description
• image_url
• weight
• sku
• price
• ainsi que les attributs définis dans l'administration (utilise les codes d'attributs de produit) donc tout ce qui correspond au model Mage_Catalog_Model_Product

attributes dispose des propriétés du model EAV pour le produit concerné et dans la locale courante (langue courante).

Ses property sont organisées suivant cette syntaxe :

• <product_attribute_code>_value
• <product_attribute_code>_label

filters dispose des property:

• name
• label
• request_var
• (tout ce qui correspond au model Mage_Catalog_Model_Layer_Filter_Item)

filter dispose, tout comme attributes, des propriétés du model EAV pour la collection de produits concernée.

Ses property sont organisées suivant cette syntaxe :

• <filter_request_var>_value
• <filter_request_var>_label

Définition de option

Les options permettent de personnaliser la sortie du masque courant grâce à des séparateurs, des préfix, des suffix... en voici la liste. La valeur entre parenthèse est la valeur par défaut encadrée de guillemets simple.

• separator (' - ')
  défini un séparateur de premier niveau
  exemple : {{categories/name separator=" ! " length="2"}}
  affichera : category1 ! category2
• prepend ('')
  ajoute un prefix au résultat du masque, si le masque à une valeur.
  exemple : {{filters/name prepend="*"}}
  affichera si il y a 1 filtre: *filter1
  et affichera si il y a 2 filtres : *filter1 - filter2
• append ('')
  Ajoute un suffix au résultat du masque, si le masque à une valeur.
  Exemple : {{filters/name append="*"}}
  affichera si il y a 1 filtre: filter1*
  et affichera si il y a 2 filtres : filter1 - filter2*
• default ('')
  Si le masque est indéfini, c'est la valeur de cette propriété qui sera affiché
  Exemple : {{category/meta_title default="cat"}}
  affichera, si la category n'est pas définie : cat
• offset ('0')
  Si le masque concerne un element qui peut être un tableau de valeur comme les categories ou les filters, le masque commencera à la offset-ième valeur. Si la offset est négatif alors il comptera les valeur à partir de la fin.
  Exemple : {{category/name offset="1"}}
  affichera : category2
• length ('1')
  Si le masque concerne un element qui peut être un tableau de valeur, le masque affichera length valeur. Si length est négatif, alors il ira justa la length-ième valeur en partant de la fin.
  Exemple : {{category/name length="3"}}
  affichera : category1 – category2 – category3
  Combiné avec l'option offset, cela est utile pour afficher les catégories et sous catégories ( {{category/name offset="-3" length="3"}} ), ou que la sous catégorie par exemple ( {{category/name offset="-1"}} )
• reverse ('0')
  si le masque concerne un element qui peut être un tableau de valeur, les valeurs seront rendu dans l'ordre inverse. Exemple : {{category/name reverse="1" length="2" separator=" in "}}
  affichera : category2 in category1
• subseparator (' : ')
  Si le masque concerne plusieurs attributs, ses attributs seront séparé par cette valeur.
  Exemple : {{filters/name|label subseparator=" > " length="2"}}
  affichera : filter1 > value1 – filter2 > value2
• subprepend ('')
  Si le masque concerne plusieurs attributs, cette valeur sera ajouté au début de chaque groupe d'attributs.
  Exemple : {{category/name subprepend="+" length="-2"}}
  affichera (si il y a 5 categories): +category1 +category2 +category3
• subappend ('')
  Si le masque concerne plusieurs elements, cette valeur sera ajouté à la fin de chaque groupe d'attributs.
  Exemple : {{filter/name|label subappend="/" offset="-2" length="2"}}
  affichera (si il y a 3 filters) : /filter2 : value2 - /filter3 : value3
• word_count ('0')
  Si cette valeur est supérieur à 0 et inférieur au nombre de mots du masque concerné, le masque sera raccourcie jusqu'à atteindre le nombre de mots indiqués.
  Exemple : {{product/name word_count="3"}}
  affichera : Sony VAIO VGN au lieu de Sony VAIO VGN-TXN27N/B 11.1" Notebook PC
• word_endcut ('')
  Si cette valeur est défini et que word_count est appliquée, le masque ce terminera par la valeur indiquée.
  Exemple : {{product/name word_count="3" word_endcut="..."}}
  affichera : Sony VAIO VGN... au lieu de Sony VAIO VGN-TXN27N/B 11.1" Notebook PC
• word_separator (' .,!?:;_\\/-')
  Cette valeur défini les caractères de séparation utilisés par le paramètre word_count pour couper les mots.
  Exemple : {{product/name word_count="3" word_separator=" A"}}
  affichera : Sony VAIO au lieu de Sony VAIO VGN-TXN27N/B 11.1" Notebook PC

Utiliser la fonction de remplacement

Cette fonction permet de remplacer des portions de texte à l'affichage de l'optimisation dynamique.

Vous pourrez ainsi envisager des phrases sensées plutôt qu'une suite d'expressions.

Par exemple le résultat de votre title donnera sur certaines pages : Category1 - Couleur : Noir.
Définissez une expression régulière de remplacement : "/couleur\s*:\s*/i" replacé par "couleur en ".
"Category1 - Couleur : Noir" deviendra alors "Category1 - couleur en Noir".

Les expressions régulières (ou expressions rationnelles) sont de type perl (elles sont utilisées dans la fonction preg_replace)
Elle doivent commencer par un / et finir par un / (si omis ils sont rajoutés) suivi optionnellement de la liste des options.
exemple : /abc/i (i : option d'insensibilité à la casse) trouvera toutes les chaines correspondant à abc, ABC,Abc, aBc, ABc, ...

Pour plus d'info sur les expressions régulières, consultez wikipedia ou le manuel php

Exemples d'utilisation

Quelques exemples de masques sur une page produit :

• {{categories/name offset="-2" length="2" reverse="1" separator=" <- "}}
  Affiche le nom des 2 dernières catégories du fil d’arianne en les séparant par «<-»
• {{attributes/color _value default="sans couleur" prepend="de couleur "}}
  Affiche la valeur de l’attribut color en la préfixant de « de couleur », ou si elle est vide affiche « sans couleur »

D'autres exemples de masques sur les pages de catégories :

• {{categories/name offset="-1" separator=", "}}
  Affiche le nom de la dernière catégorie du fil d’arianne (le séparateur ne sert à rien ici)
• {{categories/meta_title length="2" separator=" | "}}
  Affiche le meta title des 2 premières catégories en le séparant par |
• {{filter/label separator=" " length="3"}}
  Affiche les valeurs des trois premiers filtres en les séparant par « »
• {{filter/name|label subseparator=" : " separator=", " length="10"}}
  Affiche, pour les 10 premiers filtres sélectionnés, son nom et sa valeur séparé par « : », et chaque groupe nom-valeur sera séparé par « , »

Optimisation des templates avec les masques

Les masques utilisés pour optimiser les meta peuvent également être utilisé dans les templates. Il suffit simplement d'aller cette fonction avec le masque que vous souhaitez :
Mage::getSingleton('seogento/config_template_meta')->parse('a mask');

Réécriture d'URL

Réécriture de l'URL des tags

Réécrit l'URL de chaque tag et la remplace par tag/{nom_du_tag}. Par exemple l'url du tag "magento" sera /tag/magento. Cette option nécessite la surcharge (rewrite) de la classe Mage_Tag_Model_Tag.

Prefix de réécriture de l'URL des tags

Modifie le prefix par default ("tag/") de l'url réécrite des tags.

Réécriture de l'URL des filtres de catégorie

Active la réécriture des URL de filtre des categories. Permet de transformer les traditionnelles paramètres de filtre en répertoire.
Exemple : /category.html?color=2 se transformera en /category.html/color-2.

Attention : en se qui concerne le filtre de catégorie, il se transforme en sous-menu. Les liens pointeront donc sur les catégories enfants.

Les canonical urls sont bien sur modifiées en conséquence. Cette option nécessite la surcharge (rewrite) des classes Mage_Catalog_Model_Layer_Filter_Item et Mage_Catalog_Block_Layer_State.

Cette fonction ajoute un router qui sera appelé dans le controller frontal. Il tentera de trouver les paires clés-valeurs dans l'URL correspondant à des filtres de la categorie détectée. Le séparateur des pair clés-valeurs est le tiret ("-"). Vous pouvez inclure un tiret dans la partie valeur, mais tout tiret présent dans la partie clé sera remplacé par underscore ("_")

Traduire les clés des filtres dans l'URL

Si cette option est activée, les clés des filtres dans l'URL seront traduits dans la langue courante.
Exemple : /category.html?color=2 se transformera en /category.html/couleur-2.

Traduire les valeurs des filtres dans l'URL

Si cette option est activée, les valeurs des filtres dans l'URL seront traduits dans la langue courante.
Exemple : /category.html?color=2 se transformera en /category.html/color-noir.

Utiliser la fonction de remplacement des clé et valeurs de filtres

Tout comme sur les meta titles de produit et de categorie, vous pouvez remplacer une clé ou une valeur de filtre.

Suffix d'URL des categories dans les URL des filtres

Permet de supprimer ou de déplacer à la fin le suffix d'URL des categories dans une URL de filtre.
Exemple : /category.html?color=2 se transformera en /category/color-2 ou en /category/color-2.html.

Statistiques de ventes entre produits

Cette fonctionnalité permet d'afficher les produits en relation directe à un autre produit en se basant sur les statistiques de commande, de mise en panier, ou les visites, proposant ainsi à vos visiteurs des suggestions automatiques et ciblées et amméliorant en même temps la thématique des pages, optimisant donc votre positionnement.

Activer l'agregation

Active le calcul des statistiques de ventes produit. Toutes les 5 minutes, le cron effectuera un calcul sur les logs de visites et sur les ventes afin d'associer à chaque produits sa relation avec les autres produits, que se soit au niveau des visites (visits), des inclusions dans le panier (quotes), ou des ventes (orders).

Par default le block affichant ses relations ( Xorax_Seogento_Block_Catalog_Product_List_Statsell ) se base sur les ventes. Cette classe est distribué en open source, vous pouvez donc aussi vous baser sur les visites ou sur les mises en panier pour l'affichage de ses relations.

Vous pouvez assigner ou modifier les relations entre produits en allant sur la page d'édition d'un produit, puis dans l'onglet Statistique de vente.

L'agregation s'éxécute toutes les 5 minutes, sur les 5 minutes précédentes, cependant lorsque vous activez pour la première fois cette fonctionnalité, les données précédemment enregistré ne sont pas prises en compte.
Vous pouvez donc lancer l'agregation sur la période que vous voulez en utilisant le script disponible dans shell/statsell.php dans le répertoire Seogento. Ce script est en open-source. Pour le lancer, exécuter simplement la commande php -f shell/statsell.php, deux dates vous seront demandées, de départ et de fin, avant le lancement de l'agregation sur la période indiqué. Afin de ne pas rentrer en conflit avec un autre processus d'agregation, nous vous recommandons de désactiver l'option "Activer l'agregation" pendant le lancement de se script

Attribut par défaut

Permet de selectionner quel sera l'attribut utilisé pour afficher les résultats. Cette option peut être surchargé dans le block stat-sell ou dans le layout.

Remplacer le block de ventes incitatives

Si cette option est activée le block de ventes incitative sera remplacé par le block de statistiques de ventes