Extensions name/fr
From Joomla! Documentation
< Extensions name
Le nommage de votre extension est un art et une partie d'une stratégie de marketing. Mais vous devez également éviter les conflits de noms avec des extensions déjà répertoriées sur le JED. Les noms d'extension ont un impact sur la structure de l'extension et sur les URL affichées après l'installation de l'extension est installée, alors anticipez bien cet élément important !
Cet article contient quelques recommandations pour nommer les extensions, résultat des meilleures pratiques de la communauté Joomla.
Choix d'un nom : recommandations[edit]
Utilisation d'un nom similaire à celui d'une autre extension ?[edit]
- Les utilisateurs peuvent confondre les deux extensions et signaler votre extension ou écrire un avis négatif sur votre extension alors que celui-ci était destiné à une autre extension.
- Les rapports de sécurité sur une extension ayant un nom similaire peuvent porter à confusion.
- Le simple ajout d'un nom de société pourrait ne pas être une modification suffisante pour permettre aux utilisateurs d'être conscients des différences.
- Essayez d'éviter tout conflit de marque avec d'autres développeurs.
Comment créer un bon nom pour une extension?[edit]
Soyez créatif et pensez marque : pensez au marketing de votre extension et non pas à la marque d'une autre personne !
- Créez un nom de marque original.
- Choisissez un nom facile à prononcer.
- Le nom doit être court, vos fichiers XML et PHP étant nommés après le nom de l'extension. Les URL sur les sites Joomla! sont également impactées par les noms d'extension.
- Évitez les noms trop descriptifs.
- Facilitez la recherche de votre extension en fonction de sa fonctionnalité et non pas en fonction de son nom.
Les noms d'extension sur le JED[edit]
Le JED est un répertoire et chaque soumission bénéficie de son propre identifiant - ID (le numéro à la fin de l'URL).
- Cet ID est un identifiant unique pour chaque entrée du JED.
- Chaque entrée aura un "alias", également appelée "Nom", afin de faciliter sa mémorisation.
Premier arrivé, premier servi[edit]
Le nom répertorié sur le JED est approuvé par les éditeurs du JED sur la base du "premier arrivé, premier servi".
- Le nom de votre extension doit être différent de toute autre extension déjà présenté sur le JED (noms de société non inclus).
- Le nom de l'extension doit être déclaré dans le fichier XML, au sein de la balise NAME.
- Vous devez utiliser le même nom sur votre site et page de téléchargement.
Conflit sur les noms d'extension[edit]
Un nom d'extension sera considéré en conflit lorsqu'il est trop similaire à d'autres extensions, à la discrétion des éditeurs du JED.
- Lors des noms d'extension se trouvent être en conflit, le JED va prendre en considération la première entrée soumise, même si celle-ci n'est pas publiée.
- Il est demandé aux entrées plus récentes de modifier le nom de leur extension.
- Les conflits sont étudiés au cas par cas.
Comment le nom est-il créé sur le JED ?[edit]
L'alias (nom) est créé par un éditeur du JED, en utilisant les éléments d'information suivants :
- Proposition du développeur dans le champ dénommé "name" (la proposition doit être la même dans les balises "NAME" et "MENU" du fichier XML).
- Certains mots ne sont pas autorisés
- Certains mots peuvent être ajoutés par les éditeurs du JED, agissant comme des balises.
Avertissement sur les alias[edit]
Les alias (noms) peuvent être modifiés par les éditeurs du JED, à tout moment, si cela est jugé nécessaire pour la maintenance du répertoire.
- Les noms d'alias utilisés sur le JED ne constituent pas une approbation de marques utilisées par le produit que ce soit par Joomla.org ou par OSM.
- Le JED ne s'impliquera pas dans des litiges en matière de marques, ils doivent être traités par les utilisateurs.
Nom enregistré[edit]
A quel endroit le JED regarde-t-il les noms d'extension ?
- Dans les balises XML et dans les noms de fichiers de code. Certaines balises spéciales doivent être identiques (espaces non compris).
Exemple de balises XML[edit]
Exemple :
* <name>jedilightsaber</name> * <menu>Jedi Lightsaber</menu>
Exemple de noms de fichiers[edit]
Exemple :
* mod_jedilightsaber.xml * mod_jedilightsaber.php
Versions allégées et versions pros[edit]
Les termes "Light" et "Pro" peuvent être ajoutés afin de différencier deux extensions d'un même développeur, mais les extensions doivent avoir des fonctionnalités et plans de distribution différents (comme une version gratuite allégée et une version Pro payante). Le terme "Free" (gratuit) est considéré comme étant un texte promotionnel et ne peut pas être utilisé.
Lors de l'ajout des balises "Light" et "Pro" :
- Composants : dans la balise nom du XML et dans les noms de fichier ou dans le nom de la balise menu et dans le nom de l'alias sur le JED.
- Modules et plugins : dans la balise nom du XML et dans les noms de fichier ou dans le nom de l'alias sur le JED.
Joomla! en tant que mot[edit]
Le terme Joomla! et le nom des extensions[edit]
Le JED a un intérêt direct dans le maintien direct de l'intégrité de la marque Joomla. L'équipe du JED n'autorisera aucune violation de la marque, du logo... Joomla! sur le site du JED ou lié à partir du JED.
- Le nom d'une extension ne peut pas commencer par le mot Joomla
- Les extensions utilisant dans le nom de l'extension le mot Joomla! ou un dérivé doivent être agréées par OSM.
- Les extensions utilisant dans le nom de domaine le mot Joomla ou un dérivé doivent être agréées par OSM.
- Il est recommandé d'éviter le mot complet Joomla.
Veuillez noter que les extensions ne doivent pas être nommées "Joomla! x". Veuillez plutôt les nommer "x for Joomla!" ou similaire afin d'éviter toute confusion avec Joomla. Consultez liste de vérification de l'utilisation de la marque pour plus d'informations.
Les dérivés du nom Joomla![edit]
Quels sont les noms considérés comme liés au nom Joomla ?
- Veuillez consulter : liste de vérification de l'utilisation de la marque.
Licence Joomla![edit]
Comment vos extensions peuvent-elles être titulaires d'une licence ?
- Veuillez consulter : liste de vérification de l'utilisation de la marque.
Cas particuliers[edit]
Extensions spécifiques à certaines extensions[edit]
Les plugins d'extensions spécifiques sont des extensions qui ont besoin qu'une autre extension soit installée pour pouvoir fonctionner. Ces plugins doivent mentionner à la fin du nom de l'extension : "for NOM-DE-L'EXTENSION-PRINCIPALE", même si ce n'est pas le cas dans le fichier XML.
Le changement de marque[edit]
Si vous avez besoin de changer le nom de la marque d'une ancienne extension mais que vous voulez éviter les conflits avec les sites où les versions plus anciennes sont déjà installées, veuillez en discuter avec l'équipe du JED. Après avoir choisi le nouveau nom :
- Mettre à jour les balises NAME et MENU de votre fichier XML.
- Renommer vos fichiers afin de refléter le nouveau nom de l'extension.
- Ré-empaqueter et joindre à nouveau le fichier à votre entrée sur le JED.
- Revoir les mentions à l'extension sur votre site web.
Remarque : si les points n°1 ou n°2 sont impossible à respecter au regard de problèmes de compatibilité avec des sites installés, veuillez inclure le nouveau nom dans la balise de description ou dans un des commentaires de votre fichier XML.
Les Forks ou dérivés[edit]
Les extensions dérivées doivent respecter des règles spécifiques pour être listées dans le JED
Veuillez consulter : CGU - les extensions et leurs dérivés
Egalement : Les extensions dérivées
Scripts ou bibliothèques[edit]
Le nom doit être inclus dans le fichier principal.
- Dans les scripts d'en-têtes, vous devez inclure des commentaires avec le nom du script, les mentions de droit d'auteur et de licence.
- Un fichier TXT doit être inclus avec le nom, les mentions de droit d'auteur, de licence ainsi que l'URL de téléchargement.
Nom de l'entrée sur le JED : à faire et à ne pas faire[edit]
A faire[edit]
- Nommez la balise NOM du fichier XML de la même façon que le nom de l'extension.
- Le nom du composant dans le menu administrateur (la balise MENU dans le fichier XML) doit être le même que le nom de l'extension.
A ne pas faire[edit]
- Utilisez des mots offensants, de nature politique ou religieuse.
- Utiliser le type d'extension comme partie du nom de l'extension (peut être utilisé uniquement pour les modules et plugins pour une même extension d'un même développeur)
- Utiliser le numéro de version dans le nom (il existe un champ pour cela).
- Utiliser les étiquettes de prix, de promotion commerciale ou une URL de domaine dans le nom.
- Utilisez le nom de l'auteur ou de la société dans le nom de l'extension (il existe un champ pour spécifier cela).
Informations complémentaires[edit]
- Consultez : Les noms d'extensions sur le site du JED