Décembre 2011

Réussir ses contributions

… et générer toujours plus de chiffre d’affaires

Chers contributeurs,

Vous avez créé un thème ou un module et souhaitez le mettre en ligne sur PrestaShop Addons ?

Félicitations !

Grâce à vous, de nouveaux e-commerçants trouveront réponse à leurs besoins !

Grâce à ce guide vous allez pouvoir optimiser le module ou thème que vous avez créé.

En suivant chaque étape détaillée, et en réalisant les tests depuis votre ordinateur avant de

soumettre votre contribution, vous vous assurez :

• une validation plus simple,

• une mise en ligne plus rapide,

• et un chiffre d’affaires plus important grâce à la satisfaction des e-commerçants qui le

téléchargeront.

Bonne lecture et bonnes ventes !

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

SOMMAIRE

I. Proposer un module sur PrestaShop Addons

PHASE 1 – Les éléments indispensables à envoyer lors d’une contribution pour un module

a. Le ZIP

b. Le fichier php

c. Le logo

d. La documentation

e. Les captures d’écran

PHASE 2 – La validation technique d’un module

f. Optimiser le module avant de l’envoyer en validation, en corrigeant les erreurs php et

sql.

g. N’utiliser aucun tracker, ni aucun code « malicieux »

h. La traduction des textes

i. L’installation du module et ses fonctionnalités

PHASE 3 – Le descriptif de votre module

j. Un nom court pour votre module

k. Lister les pays adaptés à votre module

l. 2 lignes pour comprendre l’utilité du module

m. Donner envie à l’e-marchand !

n. Les fonctionnalités du module

o. La démonstration du module

p. Être simple

q. Change log

Connaître les erreurs fréquentes pour optimiser sa contribution

1. Les erreurs php ou sql

2. Une documentation vague ou incomplète

3. Il manque une traduction du module

4. La description n’est pas conforme

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

II. Proposer un thème sur PrestaShop Addons

PHASE 1 – Les éléments indispensables à envoyer lors d’une contribution pour un thème

a. Le ZIP

b. Le fichier Preview

c. Les captures d’écran

d. La documentation

PHASE 2 – La validation technique d’un thème

e. Optimiser le thème avant de l’envoyer en validation

f. La sécurité du code

g. N’utiliser aucun tracker, ni aucun code « malicieux »

h. La traduction des textes

i. L’installation du thème et ses compatibilités

PHASE 3 – Le descriptif de votre thème

j. Un nom court pour votre thème

k. 2 lignes pour comprendre l’utilité du thème

l. Le nombre de colonnes

m. L’activité concernée par votre thème

n. Donner envie à l’e-marchand !

o. Les fichiers sources

p. La démonstration du thème

q. Être simple !

r. Change log

Connaître les erreurs fréquentes pour optimiser sa contribution

1. Les erreurs php ou sql

2. Une documentation vague ou incomplète

3. Il manque une traduction du thème

4. La description n’est pas conforme

5. La qualité graphique n’est pas optimale

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

I. Proposer un module sur PrestaShop Addons

PHASE 1 – Les éléments indispensables à envoyer lors d’une contribution pour un module

a. Le ZIP

Le module doit comprendre un zip formaté correctement : le nom du dossier zippé doit

porter le même nom que le dossier extrait. Ex : nom_du_module.zip doit comprendre le

dossier nom_du_module.

Par exemple, pour le module Nivo Slider, le zip envoyé se nomme « nivoslider.zip », et le

dossier que l’on trouve porte le nom « nivoslider ».

Aucune majuscule ni accent ne doit être utilisé pour nommer les dossiers ou fichiers.

En respectant ce premier point, vous êtes sûr que le zip ne connaîtra pas de problème lors de

son ouverture ou de son enregistrement.

b. Le fichier php

Le dossier nom_du_module doit comprendre un fichier nom_du_module.php

Si l’on reprend notre exemple, là encore, le fichier php est sous le nom « nivoslider.php ».

C’est ce fichier qui permet l’installation automatique du module dans le back office de la

boutique en ligne de vos clients.

c. Le logo

Le dossier nom_du_module doit comprendre un fichier logo.gif (il s’agit du logo qui sera

affiché dans le back office).

La taille requise de ce logo pour un module concernant la version 1.4 de PrestaShop est de :

16x16 pixels .

Pour la version 1.5 de PrestaShop, la taille requise change. Elle sera de : 32x32 pixels.

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

d. La documentation

Le dossier nom_du_module doit comprendre un fichier readme_(code iso de la langue).pdf

qui explique comment installer et paramétrer le module que vous avez développé.

L’ iso « alpha 2 » est un code à 2 lettres qui correspond à chaque pays. Vous pouvez

retrouver la liste des codes ici.

Ex : readme_fr.pdf pour la documentation en français et readme_en.pdf pour la

documentation en anglais.

Signalez dans votre documentation si votre module utilise certaines librairies de type Curl,

Soap…

Idéalement, prévoyez un lien dans votre module sur lequel cliquer, qui permet de télécharger

la documentation. Ainsi, vos clients l’auront toujours à porter de main.

Cela vous permet de guider au mieux vos clients lors de l’installation du module ou de sa

configuration, et d’éviter quelques appels de SAV !

e. Les captures d’écran

3 captures d’écran minimum (front office et back office) sont nécessaires (sauf exception : il

peut y avoir moins de captures si le module ne comprend qu’une page en back-office).

PHASE 2 – La validation technique d’un module

f. Optimiser le module avant de l’envoyer en validation

Lors de validation, les erreurs php et sql sont affichées. Ces erreurs sont très fréquentes.

Pour voir les éventuelles erreurs de votre module et les corriger avant envoi, il vous suffit

d’activer dans le fichier /config/config.inc.php : ini_set('display_errors', 'On');

define('_PS_DEBUG_SQL_', true); error_reporting(E_ALL | E_STRICT).

De plus, assurez-vous que les librairies soient chargées si votre module utilise des fonctions

Curl, Soap… Si les librairies ne sont pas chargées, veuillez mettre un avertissement dans le

back-office de votre module.

g. La sécurité du code

Les failles xss sont recherchées lors de la validation pour proposer des modules sûrs sur

notre plateforme. Vérifier bien qu’il n’en reste aucune dans votre code.

h. N’utiliser aucun tracker, ni aucun code « malicieux »

• Il est interdit de placer des « trackers » dans les modules, qui appellent à une URL externe à

l’insu du marchand (Ex : file_get_contents (« http ://monsite.com/tracker.php »)) ou que des

données soient envoyées vers site externe à l’insu du marchand (Ex : e-mail envoyé à chaque

commande…).

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

• Attention également à la fiabilité des codes existants repris : il arrive que certaines librairies

comprennent des codes malicieux. Soyez sûrs des codes que vous recopiez.

i. La traduction des textes

• Tous les textes de votre contribution doivent être traduisibles en utilisant la fonction

l(string text) de PrestaShop.

• Toutes les langues que vous avez spécifiées pour l’utilisation du module sont testées.

Si votre module peut s’adapter aux besoins d’e-commerçants de nombreux pays,

n’hésitez pas à le faire traduire dans plusieurs langues : vous optimisez ainsi le nombre

de ventes de votre module !

j. L’installation du module et ses fonctionnalités

• Le module doit correctement s’installer, se désinstaller et se réinitialiser sur les versions de

PrestaShop que vous avez spécifiées.

• Toutes les fonctionnalités du module sont testées.

• Si la documentation n’est pas assez claire, ce test ne peut être effectué correctement, tout

comme vos clients auront des difficultés à installer votre module.

(Ex : « Ce module comporte des modifications cœur. Pour cela, allez dans le fichier

Contact.tpl ». Cette mention n’est pas assez claire pour le client qui téléchargera votre

contribution. Nous vous invitons à rédiger la notice à l’aide de captures d’écran ou de

chemins complets).

Pour cette phase de test, notre équipe technique se met totalement à la place du client.

N’oubliez pas que les e-commerçants sont tous différents et n’ont pas le même niveau

technique. En proposant un module clair et simple, vous vous assurez de bonnes ventes et

peu de SAV !

PHASE 3 – Le descriptif de votre module

k. Un nom court pour votre module

Donnez un nom court à votre module (mois de 30 caractères) et très clair, afin qu’à la lecture

du nom du module, le visiteur sache immédiatement de quoi il s’agit.

Ex : « Advanced Top Menu » ou « Big Footer ». Évitez d’y ajouter « PrestaShop » ou

« Module ».

l. Lister les pays adaptés à votre module

Si votre module concerne un ou plusieurs pays précis, n’hésitez pas à le spécifier dans le

descriptif pour mieux guider vos clients, et vous éviter des remboursements.

Ex : « Purolator » est un module de Transport & Logistique uniquement pour le Canada et les

Etats-Unis. Ceci est précisé dans le descriptif.

Ainsi, lors de la mise en ligne du module, nous faisons en sorte qu’il n’apparaisse que pour les

pays « Canada » et « USA », afin que d’autres clients ne l’achètent pas par erreur.

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

m. 2 lignes pour comprendre l’utilité du module

Dans le descriptif, présentez tout d’abord en une ou deux phrases les fonctionnalités

premières du module, afin que vos acheteurs éventuels comprennent directement l’utilité

du module (environ 200 caractères).

Ex : "Envoyez à vos clients un rappel de leur panier abandonné, avec message personnalisé

avec ce module. Suivez la performance de vos relances grâce aux statistiques détaillées."

n. Donner envie à l’e-marchand !

Présentez les avantages pour l’e-commerçant

Ex : "Envoyez à vos clients un rappel de leur panier abandonné, avec message personnalisé

avec ce module. Suivez la performance de vos relances grâce aux statistiques détaillées."

puis pour ses clients

Ex : "Les clients qui n'ont pas pu finaliser leur commande gagnent du temps en retrouvant

directement les produits qu'ils avaient mis de côté."

o. Les fonctionnalités du module

Lister les fonctionnalités proposées par le module afin de montrer toutes les possibilités que ce produit apporte aux e-commerçants Ex : " Ce module très simple d'utilisation vous permet :

o De créer en toute facilité des templates adaptés à votre site marchand pour vos mails

de relance

o D'envoyer un ou plusieurs mails automatiques personnalisés à vos clients pour leur

rappeler le contenu des articles qu'ils avaient mis de côté sur votre boutique en ligne

et les inviter à terminer leur commande

o D'inciter vos clients à commander sur votre site ecommerce grâce à un code promo

joint à l'email de relance

o De suivre le taux de transformation de vos différents e-mails grâce aux statistiques

détaillées que vous pouvez suivre dans le back-office

o Les contenus des mails en français et anglais sont à votre disposition pour vous guider

dans la création de vos templates. Vous n'avez plus qu'à les personnaliser !".

p. La démonstration du module

Ajoutez une URL de démonstration pour vos clients. Qu’il s’agisse d’une vidéo ou d’un site

réservé à cet effet pour que les e-marchands testent votre module, une démonstration sera

toujours beaucoup plus convaincante que de longs discours !

Ex : Démo : URL du site de démonstration (+ identifiants si besoin pour le back-office) ou URL

de la démo sur Youtube.

L’URL ainsi que l’identifiant e-mail ou le mot de passe doivent être neutres.

Ces démonstrations ne peuvent pas se trouver sur des sites concurrents ou faisant la

promotion de concurrents, sans quoi l’URL de démonstration peut être supprimée de la fiche

produit.

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

q. Être simple

Si vous souhaitez préciser que l’installation se fait en un clic, ou que la configuration du

module ne prend pas plus de 5 minutes, n’hésitez pas à le préciser. Soyez simple !

• Le descriptif d’installation du module n’est pas nécessaire dans la description du module.

Le pdf d’installation que vous joignez au dossier du module est réservé à cet effet, il est donc

inutile de surcharger l’e-marchand d’informations complexes avant qu’il n’ait acheté le

module.

• De même, si des recommandations sont nécessaires, une seule ligne suffit (Ex : "Attention,

avant d'installer ce module, vérifiez que … est bien configuré").

r. Change log

Lorsque vous ajoutez un Change log à votre descriptif, assurez-vous qu’il soit identifiable

rapidement par vos clients. Précisez également la date à laquelle il est effectué pour éviter

toute confusion.

Ex : « Change log le 17.12.2011 : Dans cette nouvelle version, le nom des catégories est

automatiquement mis à jour ».

Connaître les erreurs fréquentes pour optimiser sa contribution

Les erreurs présentées ci-dessous sont très fréquentes, et retardent la mise en ligne des

contributions. N’hésitez pas à vérifier chacun de ces points sur votre thème pour optimiser votre

contribution !

Voici les raisons les plus fréquentes qui font que vous pouvez rencontrer un refus :

1. Les erreurs php ou sql

Des erreurs PHP ou SQL sont visibles lors de l’utilisation du module.

Une copie d’écran vous est alors envoyée, ainsi que le chemin réalisé qui a permis de

découvrir ce bug.

2. Une documentation vague ou incomplète

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

La documentation n’est pas assez claire et ne permet pas de configurer ou de tester le

module.

Un e-mail vous est alors envoyé, notifiant le point bloquant.

3. Il manque une traduction du module

Si vous avez saisi plusieurs langues dans la fiche d’envoi du module, et que ces langues ne

correspondent pas à ce qui existe dans le module, alors celui-ci peut être refusé.

Par exemple, vous avez spécifié que votre module était traduit en anglais, français et

espagnol. Or, aucune traduction n’est disponible en espagnol.

Un e-mail vous est alors envoyé, notifiant qu’une traduction est manquante, afin que vous

supprimiez la langue spécifiée ou ajoutiez la traduction dans la langue spécifiée.

4. La description n’est pas conforme

Les fonctionnalités présentées dans le descriptif doivent être présentes dans le module.

Si la description du module ne correspond pas à ce qui est testé, votre module peut être

refusé.

Un e-mail vous est alors envoyé, spécifiant d’ajouter certains champs dans votre description.

Mettez-vous à la portée de tout client, avec un module propre, clair et simple.

Avec ce guide, vous avez toutes les clés en main

pour proposer un module qui sera mis en ligne très rapidement !

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

II. Proposer un thème sur PrestaShop Addons

PHASE 1 – Les éléments indispensables à envoyer lors d’une contribution pour un thème

a. Le ZIP

• Le thème doit comprendre un zip formaté correctement .

Une fois dézippé, il doit comprendre plusieurs dossiers : « themes », « modules » et « doc ».

Les fichiers du thème doivent se situer dans le dossier « themes ». (ex : img, css, js…)

Les modules additionnels doivent se situer dans le dossier « module ». (ex : slider)

La documentation d’installation doit se situer dans le dossier « doc ».

Pour info, le module Installeur de thèmes (en natif dans PrestaShop, ou téléchargeable sur

PrestaShop Addons) permet de génèrer automatiquement un dossier zippé au format requis.

Aucune majuscule ni accent ne doit être utilisé pour nommer les dossiers ou fichiers.

Ainsi vous êtes sûr que le zip ne connaîtra pas de problème lors de son ouverture ou de son

enregistrement.

b. Le fichier Preview

Le dossier doit comprendre un fichier preview.jpg

C’est ce visuel qui sera repris dans le back office de vos clients lorsqu’ils configureront leur

thème.

c. Les captures d’écran

3 captures d’écran minimum (front office et back office) sont nécessaires.

Elles permettent à l’e-marchand d’apprécier le rendu graphique de votre template en page

d’accueil, en page produit et sur la page de votre choix (catégorie, promo…).

Le thème doit être qualitatif graphiquement (il doit donner envie aux visiteurs de le

télécharger pour optimiser les ventes de leur site ecommerce), fonctionnel, stable et

ergonomique.

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

PHASE 2 – La validation technique d’un thème

d. Optimiser le thème avant de l’envoyer en validation, en corrigeant les erreurs php et sql.

Lors de validation, les erreurs php et sql sont affichées. Ces erreurs sont très fréquentes.

Pour voir les éventuelles erreurs de votre module et les corriger avant envoi, il vous suffit

d’activer dans le fichier /config/config.inc.php : ini_set('display_errors', 'On');

define('_PS_DEBUG_SQL_', true); error_reporting(E_ALL | E_STRICT).

Toutes les fonctionnalités de votre thème sont testées comme autant de modules

indépendants. C’est-à-dire que chaque fonctionnalité proposée subit les mêmes tests que s’il

s’agit d’un module proposé pour la mise en ligne.

e. N’utiliser aucun tracker, aucun code « malicieux », ni fonction EXEC

• Il est interdit de placer des « trackers » dans les modules, qui appellent à une URL

externe à l’insu du marchand (Ex : file_get_contents

(« http ://monsite.com/tracker.php »)) ou que des données soient envoyées vers site

externe à l’insu du marchand (Ex : e-mail envoyé à chaque commande…).

• Attention également à la fiabilité des codes existants repris : il arrive que certaines

librairies comprennent des codes malicieux. Soyez sûrs des codes que vous recopiez.

• Eviter toutes les fonctions impactées par le safe mode, comme les fonctions système

EXEC, SHELL_EXEC… (et autres fonctions systèmes).

f. La traduction des textes

• Tous les textes de votre contribution doivent être traduisibles en utilisant la fonction l(string

text) de PrestaShop.

• Toutes les langues que vous avez spécifiées pour l’utilisation du thème sont testées.

Si votre thème peut s’adapter aux besoins d’e-commerçants de nombreux pays, n’hésitez pas

à le faire traduire dans plusieurs langues : vous optimisez ainsi ses ventes !

g. L’installation du thème et ses compatibilités

• Le thème doit correctement s’installer avec l’installeur de thème sur les versions de

PrestaShop que vous avez spécifiées.

• Le thème doit fonctionner avec les 2 processus de paiement : en 5 étapes ou en une seule

étape (one page check-out).

• Votre thème doit être impérativement compatible avec les navigateurs Internet Explorer

7/ 8/ 9, Chrome, Firefox, Safari et Opera.

• Toutes les pages du thème sont testées avec les différentes devises (euro, dollar…) et

langues.

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

PHASE 3 – Le descriptif de votre thème

h. Un nom court pour votre thème

Donnez un nom court à votre thème (mois de 30 caractères), et différent des noms des

thèmes déjà présents dans le catalogue Addons.

Evitez d’utiliser « thème » ou « PrestaShop » dans l’intitulé.

Ex : « Design Furniture».

i. 2 lignes pour comprendre l’utilité du thème

Dans le descriptif, présentez tout d’abord en une ou deux phrases (environ 200 caractères)

pour qui ce thème sera pertinent, ainsi que les fonctionnalités principales proposées, afin

que vos acheteurs éventuels comprennent puissent, dès la page catégorie de PrestaShop

Addons, voir si ce thème correspond à leur besoin.

Ex : « Ce thème à 2 colonnes est idéal pour les e-marchands souhaitant accroître leurs ventes

sur des produits de bien-être…"

j. Le nombre de colonnes

Précisez bien le nombre de colonnes que propose votre thème (Ex : "2 colonnes en page

d’accueil, 3 colonnes en pages produits").

Ce critère important pour de nombreux e-marchands fait partie de la navigation à facette

proposée sur PrestaShop Addons, il est donc très important de le préciser.

i. L’activité concernée par votre thème

Guidez les internautes en leur indiquant le type de boutique en ligne qui pourrait être

intéressées par ce thème (Ex : "Conçu pour les sites ecommerce de produits d'intérieurs, de

déco et services associés au bien-être." ou "tout type de boutiques" pour un thème neutre).

j. Donnez envie à l’e-marchand !

Listez les fonctionnalités proposées par le template afin de montrer toutes les possibilités

qu’il apporte aux e-commerçants.

Ex : «

a. Entièrement personnalisable : Tous les blocs, panier et processus de paiement, pages

produits catalogue et comptes clients peuvent être personnalisés

b. Optimisé pour un chargement rapide, grâce à des sprites et une compatibilité CCC

c. Permet d’accroître le trafic de votre boutique en ligne grâce au bouton de partage

Facebook positionnable sur toutes les pages produits. »

k. Les fichiers sources

Indiquez les fichiers joints avec le thème dans le descriptif.

Le fait de fournir les fichiers sources peut représenter un argument de vente supplémentaire

(Ex : "Fichiers sources joints : PSD, PHP").

l. La démonstration du thème

Ajoutez une URL de démonstration pour vos clients. Qu’il s’agisse d’une vidéo ou d’un site

réservé à cet effet pour que les e-marchands testent votre template, une démonstration sera

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

toujours beaucoup plus convaincante que de longs discours !

(Ex : Démo : URL du site de démonstration (+ identifiants si besoin pour le back-office) ou

URL de la démo sur Youtube).

L’URL ainsi que l’identifiant e-mail ou le mot de passe doivent être neutres.

Ces démonstrations ne peuvent pas se trouver sur des sites concurrents ou faisant la

promotion de concurrents, sans quoi l’URL de démonstration peut être supprimée de la fiche

produit.

s. Être simple !

• N’hésitez pas à préciser que l’installation du template se fait en un clic, ou que sa

configuration ne prend pas plus de 5 minutes. Soyez simple !

• Le descriptif d’installation du thème n’est pas nécessaire dans le description.

Le pdf d’installation que vous joignez au dossier du thème est réservé à cet effet, il est donc

inutile de surcharger l’e-marchand d’informations complexes avant qu’il n’ait acheté le

module.

• De même, si des recommandations sont nécessaires, une seule ligne suffit (Ex : "Attention,

avant d'installer ce thème, vérifiez que … est bien configuré").

t. Change log

Lorsque vous ajoutez un Change log à votre descriptif, assurez-vous qu’il soit identifiable

rapidement par vos clients. Précisez également la date à laquelle il est effectué pour éviter

toute confusion.

Connaître les erreurs fréquentes pour optimiser sa contribution

Les erreurs présentées ci-dessous sont très fréquentes, et retardent la mise en ligne des

contributions. N’hésitez pas à vérifier chacun de ces points sur votre thème pour optimiser votre

contribution !

Voici les raisons les plus fréquentes qui font que vous pouvez rencontrer un refus :

1. Les erreurs php ou sql

Des erreurs PHP ou SQL sont visibles lors de l’utilisation du module.

Une copie d’écran vous est alors envoyée, ainsi que le chemin réalisé qui a permis de

découvrir ce bug.

2. Une documentation vague ou incomplète

La documentation n’est pas assez claire et ne permet pas de configurer ou de tester le

thème.

Un e-mail vous est alors envoyé, notifiant le point bloquant.

3. Il manque une traduction du thème

Réussir ses contributions… et générer toujours plus de chiffre d’affaires

12.2011

Si vous avez saisi plusieurs langues dans la fiche d’envoi du thème, et que ces langues ne

correspondent pas à ce qui existe dans le thème, alors celui-ci peut être refusé.

Par exemple, vous avez spécifié que votre thème était traduit en anglais, français et

espagnol. Or, aucune traduction n’est disponible en espagnol.

Un e-mail vous est alors envoyé, notifiant qu’une traduction est manquante, afin que vous

supprimiez la langue spécifiée ou ajoutiez la traduction dans la langue spécifiée.

4. La description n’est pas conforme

Les fonctionnalités présentées dans le descriptif doivent être présentes dans le thème.

Si la description du thème ne correspond pas à ce qui est testé, il peut être refusé.

Un e-mail vous est alors envoyé, spécifiant d’ajouter certains champs dans votre description.

5. La qualité graphique n’est pas optimale

Le thème ne respecte pas les standards de qualité attendus par nos visiteurs.

Un e-mail vous est envoyé, spécifiant d’améliorer la qualité graphique de votre thème.

Avec ce guide, vous avez toutes les clés en main

pour proposer un thème qui sera mis en ligne très rapidement !