Documentation du plugin osCommerce

Documentation du plugin osCommerce

Plugin de recommandation pour osCommerce

Cette page décrit l’installation et l’utilisation du plugin de recommandation.

Description

Grace au moteur de recommandation EZ Personnalization 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

Merci de télécharger le plugin depuis ce lien download page, si vous ne l’avez pas encore.

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

1- Copier le contenu du répertoire catalog dans votre installation osCommerce.

  • Le répertoire ezreco doit être copié dans catalog/includes/modules
  • Le répertoire ezjs doit être copié dans catalog/ext

2- Configurer les paramètres dans ezreco/config.php

  • Url du serveur de recommandation à utiliser: EZ_RECO_SERVER_URL (valeur définie par défaut)
  • idsite (fourni par ezako): EZ_RECO_IDSITE
  • Code de sécurité (fourni par ezako sous le nom de private key): EZ_RECO_PRIVATE_TOKEN
  • Autoriser la mise à jour automatique au runtime: EZ_RECO_AUTO_UPDATE

Nouveau: Utiliser notre nouveau générateur automatique de configuration config.php

3- Tracker les comportements utilisateur

Copier la ligne de php suivante pour utiliser notre tracker de recommandation (améliore nos recommandations de façon continue en utilisant le feedback utilisateur) dans catalog/includes/footer.php à la fin du fichier:
<?php include(DIR_WS_MODULES . 'ezreco/eztracker.php'); ?>

Les 3 premières étapes peuvent être effectuée à l’avance, pour commencer à collecter des données dans le but d’améliorer rapidement les recommandations.

4- Ajouter les widgets de recommandation

Copier les lignes qui chargent notre widget de recommandation sur votre site. Vous pouvez les copier à l’endroit que vous désirez dans votre site. La façon la plus simple d’obtenir une recommandation est la suivante:
<?php include_once (DIR_WS_MODULES . 'ezreco/ezreco.php'); ezReco(); ?>
– Par exemple, vous pouvez la présenter sur une page produit, dans le fichier product_info.php sous le tag fermant </form> tag:
<?php include_once (DIR_WS_MODULES . 'ezreco/ezreco.php'); ezReco('PRODUCT'); ?>
– ou sur la page home, ligne 269 dans index.php:
<?php include_once (DIR_WS_MODULES . 'ezreco/ezreco.php'); ezReco('HOME'); ?>
– ou en colonne à droite dans template_bottom.php, dans le div ‘columnRight’: <?php include_once (DIR_WS_MODULES . 'ezreco/ezreco.php'); ezReco('OFFER','html_template_vertical',3); ?>

paramètres de la fonction ezReco:

  • Le premier paramètre correspond au type de recommandation utilisé (par défaut: ALL); les valeurs possibles sont: HOME, PRODUCT, ALL, OFFER, TOP, RANDOM
  • Le second paramètre vous permet de choisir un template spécifique pour le rendu graphique, ou de choisir un template que vous avez développé. Nous fournissons: html_template, html_template_vertical
  • Le 3ième paramètre est le nombre maximum de produit à montrer, par défaut: 6
  • Le 4ième paramètre est le nombre minimum de produits pour montrer la widget de recommandation, par défaut: 2.
  • Le 5ième paramètre est un titre custom pour la widget, à définir dans les fichiers de traduction pour l’internationnalisation.

5- Mise à jour automatique ou cron?

Nos systèmes ont besoin d’informations pour faire la meilleure recommandation possible. Aucune information personnelle du client n’est collectée

Deux possibilités sont disponibles:

  • Mise à jour automatique à la demande (plutôt déconseillée en production)
  • Cron job: Vous définissez des mises à jour périodiques de vos données (par exemple toutes les heures ou tous les jours, selon votre rythme de mise à jour de votre site).

Comment définir un cron job?

Un cron job est un script php qui peut tourner indépendament. Il est programmé pour tourner à horaire fixe. Cette configuration dépendra de votre plateforme serveur, mais la ligne suivante devrait fonctionner:
php catalog/includes/modules/ezreco/ezproduct_upload.php

6- Customisation

Le plugin est conçu pour être facilement customisable:

  • Le composant graphique principal est définit en tant que template html dans templates/
  • Il est conçu pour faciliter la modification des classes css, du rendu graphique et de l’organisation en blocks.
  • Dans la documentation du fichier source, les variables principales sont décrites.
  • N’hésitez pas à nous contacter pour plus de templates, car nous avons eu l’occasion d’intégrer de nombreux cas particuliers.