Difference between revisions of "Extensions name"

From Joomla! Documentation

(17 intermediate revisions by 6 users not shown)
Line 5: Line 5:
 
Extension names will impact in the extension structure and URLs after installed, so plan ahead!
 
Extension names will impact in the extension structure and URLs after installed, so plan ahead!
  
== Choosing a name ==
+
== Choosing a name: recommendations==
 
=== Using a name similar to another extension? ===
 
=== Using a name similar to another extension? ===
 
* Users could be confused and send bad reports or reviews to your extension but that was intended to the other
 
* Users could be confused and send bad reports or reviews to your extension but that was intended to the other
 
* Security  reports for an extension with similar names could confuse users
 
* Security  reports for an extension with similar names could confuse users
* Just adding your company name couldn't be sufficient to make users aware of the differences
+
* Just adding your company name could be sufficient to make users aware of the differences
 
* You should stay away from brand disputes with other developers
 
* You should stay away from brand disputes with other developers
  
Line 19: Line 19:
 
* Avoid descriptive names as they are longer and more difficult to promote
 
* Avoid descriptive names as they are longer and more difficult to promote
 
* To make it easy to search use your description text at JED, not the name!
 
* To make it easy to search use your description text at JED, not the name!
 
  
 
== Extension names at JED ==
 
== Extension names at JED ==
Line 44: Line 43:
 
The alias (name) its created by a JED editor, using:
 
The alias (name) its created by a JED editor, using:
 
* Proposal of developer in the field called "name".
 
* Proposal of developer in the field called "name".
** The proposal should be the same to XML file tag "NAME" and MENU".
+
** The proposal must be the same to install name in the xml manifest tag "NAME".
* Some words are not allowed.
+
** To propose a name change, fist update the attached extension to reflect the new name, then open a support ticket and make your name change proposal.
 +
* Some words are not allowed. ie Refrain from using 'plugin' or 'module' in names.
 
* Some words can be added by JED editors, acting as tags.
 
* Some words can be added by JED editors, acting as tags.
  
Line 53: Line 53:
 
==== XML tags ====
 
==== XML tags ====
 
as in:
 
as in:
  * <name>Jedi Lightsaber</name>
+
  * <name>jedilightsaber</name>
 
  * <menu>Jedi Lightsaber</menu>
 
  * <menu>Jedi Lightsaber</menu>
 
==== File names ====
 
==== File names ====
Line 60: Line 60:
 
  * mod_jedilightsaber.php
 
  * mod_jedilightsaber.php
  
=== JED entry name: the Do's ===
+
==== Light and Pro versions ====
* XML file tag NAME needs to be the same as the extension entry name
+
The word "Light"and/or "Pro" can be added to differentiate two extensions from the same developer but with different features and distribution plans (as in non-commercial Lite version and commercial Pro version ) The word "Free" is considered promotional text and cannot be used.
* Components Admin menu (the tag MENU in the XML) needs to be the same as the Extension name
 
* The word "Free", "Light", "Pro" can be added to differentiate two extensions from the same developer but with different distribution plans (as in non-commercial Lite version and commercial Pro version )
 
 
 
=== JED entry name: the Don'ts ===
 
* Offensive words, political or religious statements.
 
* Extension types as they are not considered part of the extension name.
 
** This will be used only for the same developer extensions if required (module and plugin versions)
 
* Version number (there is a field for that)
 
* Price tags, commercial promotions or URL domains
 
* Company name or author name (there is a field for that)
 
  
 +
Where to add the LIGHT/PRO tag?
 +
* Components: in the XML name tag and file names or just to the menu tag name and JED Alias name.
 +
* Modules and plugins: in the XML name tag and file names or just at JED Alias name.
  
 
== Joomla as a word ==
 
== Joomla as a word ==
Line 83: Line 76:
 
* Extensions that use "Joomla" or a derivative of Joomla in the domain name need to be licensed by OSM.
 
* Extensions that use "Joomla" or a derivative of Joomla in the domain name need to be licensed by OSM.
 
Please note that extensions should not be named ''Joomla! XXX''. Rather they should be named ''XXX for Joomla!'' or some other similar variation that will not cause confusion with Joomla!.
 
Please note that extensions should not be named ''Joomla! XXX''. Rather they should be named ''XXX for Joomla!'' or some other similar variation that will not cause confusion with Joomla!.
Its a good practice to completely avoid the full word Joomla.
+
* Its a good practice to completely avoid the full word Joomla.
You can find more information about our policy: http://community.joomla.org/blogs/community/632-protecting-the-joomla-trademark-in-jed.html
+
 
 +
=== Derivative of Joomla string ===
 +
What are the  strings considered related with Joomla string?
 +
* please read: [[JED_Entries_Trademark_Checklist]]
  
 
=== Joomla! Licensed ===
 
=== Joomla! Licensed ===
To be licensed you need then to fill one of the following forms to OSM:
+
How can your extensions be licensed?
* Joomla! Name and Logo Use: http://opensourcematters.org/index.php?option=com_content&view=article&id=86
+
* please read: [[JED_Entries_Trademark_Checklist]]
* Domain Name Request: http://opensourcematters.org/domain-name-use-request.html
 
* Extension name request: http://opensourcematters.org/extension-name-request.html
 
  
  
 
== Special cases ==
 
== Special cases ==
=== Specific extensions ===
+
=== Extension Specific Extensions ===
Specific extensions are considered extensions that require another extension to be installed in order to run.
+
Extension Specific Extensions are considered extensions that require another extension to be installed in order to run.
* Specific extensions to an individual extension will have "for MAIN-EXTENSION-NAME" at the end of its name, even if not on XML file.
+
* Specific extensions to an individual extension will have "for MAIN-EXTENSION-NAME" at the end of its name, and included as part of the XML name.  
 +
Example: "Category filter for K2" or "Product search for Virtuemart"
  
 
=== Rebranding ===
 
=== Rebranding ===
Line 112: Line 107:
  
 
Please read: TOS - Extensions and Forks http://extensions.joomla.org/tos
 
Please read: TOS - Extensions and Forks http://extensions.joomla.org/tos
 +
Also read: Forked Extensions http://docs.joomla.org/Forked_Extensions
  
 
=== Tools ===
 
=== Tools ===
Line 123: Line 119:
  
  
== Alias Disclaimer ==
+
== JED entry name: Do's and donts ==
Alias (names) can be edited by Jed editors at any time if its considered necessary.
+
===The Do's ===
 +
* XML file tag NAME needs to be the same as the extension entry name
 +
* Components Admin menu (the tag MENU in the XML) needs to be the same as the Extension name
 +
 
 +
===The Don'ts ===
 +
* Offensive words, political or religious statements.
 +
* Extension types as they are not considered part of the extension name.
 +
** This will be used only for the same developer extensions if required (module and plugin versions)
 +
* Version number (there is a field for that)
 +
* Price tags, commercial promotions or URL domains
 +
* Company name or author name (there is a field for that)
  
JED will not be involved in trademarks disputes as they need to be addressed by the users.
 
  
 +
== Alias Disclaimer ==
 +
Alias (names) can be edited by Jed editors at any time if its considered necessary for the maintainance of the directory.
 +
*The alias names used at JED does not represent an endorsement of trademarks used by the product by Joomla.org or OSM
 +
*JED will not be involved in trademarks disputes as they need to be addressed by the users.
  
  
[[Category:JED]]
+
<noinclude>[[Category:JED]][[Category:FAQ]][[Category:Template Development]]
 +
[[Category:Module Development]]
 +
[[Category:Plugin Development]]
 +
[[Category:Component Development]]</noinclude>

Revision as of 11:58, 13 May 2013

To name your extension its an art and part of a marketing strategy. But you also need to stay away of name conflicts with extensions already listed at JED.

Extension names will impact in the extension structure and URLs after installed, so plan ahead!

Choosing a name: recommendations[edit]

Using a name similar to another extension?[edit]

  • Users could be confused and send bad reports or reviews to your extension but that was intended to the other
  • Security reports for an extension with similar names could confuse users
  • Just adding your company name could be sufficient to make users aware of the differences
  • You should stay away from brand disputes with other developers

How to create a good extension name?[edit]

Be creative and think on a brand: think about marketing for your extension, not for others brand!

  • Try to make up a new word for your brand name
  • Choose a name thats easy and cool to pronounce
  • Needs to be short as your XML and PHP files will be named after extension name. URLs on Joomla! sites will suffer too!
  • Avoid descriptive names as they are longer and more difficult to promote
  • To make it easy to search use your description text at JED, not the name!

Extension names at JED[edit]

JED its a directory and each submission gets its own ID (the number at the end of the URL on the edit page).

  • This ID its the single identifier for each entry at JED.
  • Each entry will get an alias, also called Name, to be easy to remember.

Different extensions, different names[edit]

The JED entry name its approved by JED Editors in a first-submitted, first-served system.

  • Your extension name needs to be different from any extension already submitted to JED (company names not included)
  • The extension name must be stated at the XML file tag NAME
  • You should use the same name in your site when referring to the extension, especially in the download page

Extension names conflict[edit]

An extension name will be considered in conflict when its too similar to other extension.

This is a JED Editors call, but you are able to create a report for that.

  • When extension names are found in conflict, JED will consider the oldest extension submitted, even if not currently published.
  • The more recent ones will be required to change their names.
  • This will be done case by case with each extension developer.


How is the name created at JED?[edit]

The alias (name) its created by a JED editor, using:

  • Proposal of developer in the field called "name".
    • The proposal must be the same to install name in the xml manifest tag "NAME".
    • To propose a name change, fist update the attached extension to reflect the new name, then open a support ticket and make your name change proposal.
  • Some words are not allowed. ie Refrain from using 'plugin' or 'module' in names.
  • Some words can be added by JED editors, acting as tags.

Name registered[edit]

Where will JED look for extension names?

  • In the XML tags and code file names. Some special tags need to be the same (spaces not included).

XML tags[edit]

as in:

* <name>jedilightsaber</name>
* <menu>Jedi Lightsaber</menu>

File names[edit]

as in:

* mod_jedilightsaber.xml
* mod_jedilightsaber.php

Light and Pro versions[edit]

The word "Light"and/or "Pro" can be added to differentiate two extensions from the same developer but with different features and distribution plans (as in non-commercial Lite version and commercial Pro version ) The word "Free" is considered promotional text and cannot be used.

Where to add the LIGHT/PRO tag?

  • Components: in the XML name tag and file names or just to the menu tag name and JED Alias name.
  • Modules and plugins: in the XML name tag and file names or just at JED Alias name.

Joomla as a word[edit]

Word "Joomla" and the extensions name[edit]

We at the Joomla Extensions Directory have a direct interest in maintaining the integrity of the Joomla brand.

As such, we cannot allow violations of the Joomla trademark, logo, brand, etc., to be placed in or linked from the Joomla Extensions Directory.

  • An extension name can't start with the word "Joomla".
  • Extensions that use "Joomla" or a derivative of Joomla in the extension name need to be licensed by OSM.
  • Extensions that use "Joomla" or a derivative of Joomla in the domain name need to be licensed by OSM.

Please note that extensions should not be named Joomla! XXX. Rather they should be named XXX for Joomla! or some other similar variation that will not cause confusion with Joomla!.

  • Its a good practice to completely avoid the full word Joomla.

Derivative of Joomla string[edit]

What are the strings considered related with Joomla string?

Joomla! Licensed[edit]

How can your extensions be licensed?


Special cases[edit]

Extension Specific Extensions[edit]

Extension Specific Extensions are considered extensions that require another extension to be installed in order to run.

  • Specific extensions to an individual extension will have "for MAIN-EXTENSION-NAME" at the end of its name, and included as part of the XML name.

Example: "Category filter for K2" or "Product search for Virtuemart"

Rebranding[edit]

If you need to re-brand an old extension and avoid conflicts in installed sites please talk with JED team first. After choosing the new name:

  1. Update your XML file tags NAME and MENU
  2. Rename your files to reflect the new extension name
  3. Repack and re-attach the file to your actual JED entry
  4. Revise the mentions to the extension at your website

Note: If #1 or #2 are not possible on compatibility with installed sites please include the new name in the description tag or in a comments line at your XML file.

Forks[edit]

Forked extensions have special rules to be listed at JED.

  • The extension name also needs to be changed and cannot use the old one so it is very clear that this is a separate project.

Please read: TOS - Extensions and Forks http://extensions.joomla.org/tos Also read: Forked Extensions http://docs.joomla.org/Forked_Extensions

Tools[edit]

The name must be included at the main or EXE file name.

  • A TXT file must be included with the tool name, copyright, license and URL to download

Scripts or libraries[edit]

The name must be included at the main file.

  • In the headers script you need to include comments with the script name, copyright and license
  • A TXT file must be included with the name, copyright, license and URL to download


JED entry name: Do's and donts[edit]

The Do's[edit]

  • XML file tag NAME needs to be the same as the extension entry name
  • Components Admin menu (the tag MENU in the XML) needs to be the same as the Extension name

The Don'ts[edit]

  • Offensive words, political or religious statements.
  • Extension types as they are not considered part of the extension name.
    • This will be used only for the same developer extensions if required (module and plugin versions)
  • Version number (there is a field for that)
  • Price tags, commercial promotions or URL domains
  • Company name or author name (there is a field for that)


Alias Disclaimer[edit]

Alias (names) can be edited by Jed editors at any time if its considered necessary for the maintainance of the directory.

  • The alias names used at JED does not represent an endorsement of trademarks used by the product by Joomla.org or OSM
  • JED will not be involved in trademarks disputes as they need to be addressed by the users.