Extensions name: Difference between revisions

From Joomla! Documentation

No edit summary
Line 1: Line 1:
{{RightTOC}}
{{RightTOC}}


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.
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 the JED. Extension names impact the extension structure and URLs that are displayed after the extension is installed, so plan ahead!


Extension names will impact in the extension structure and URLs after installed, so plan ahead!
This article contains a few recommendations for naming extensions derived from best practices in the Joomla community.


== Choosing a name: recommendations==
== 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 mix up the two extensions and report your extension or write a bad review for your extension even though it was intended for another
* Security reports for an extension with similar names could confuse users
*Security reports for an extension with similar names could confuse users
* You should stay away from brand disputes with other developers and products
*Simply adding a company name might not be sufficient enough change to make users aware of the differences
* Just adding your company name could be sufficient to make users aware of the differences but should be used as a last resort
*Try to avoid brand disputes with other developers.


=== How to create a good extension name? ===
=== How to create a good extension name? ===
Be creative and think on a brand: think about marketing for your extension, not for someone else brand!
Be creative and think on a brand: think about marketing for your extension, not for someone else brand!
* Try to make up a new word for your brand name
*Create an original brand name
* Names should be in English
*Choose a name that's easy 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!
*The name should be short as your XML and PHP files are named after the extension name. URLs on Joomla sites are also impacted by extension names.
* Avoid descriptive names as they are longer and more difficult to promote and will be flagged as an error.
*Avoid overly descriptive names
* The use of brand names will only be permitted when 'for' proceeds the brand (i.e. 'MyModule for Twitter') unless you hold the trademark for the brand.
*Make it easy to search for your extension based on functionality, not by name.


== Extension names at JED ==
== Extension names at JED ==
Line 25: Line 25:
* Each entry will get an ''alias'', also called ''Name'', to be easy to remember.
* Each entry will get an ''alias'', also called ''Name'', to be easy to remember.


=== Different extensions, different names ===
=== First Come, First Served ===
The JED entry name its approved by JED Editors in a ''first-submitted, first-served'' system.
The JED listing name is approved by JED Editors on a first come, first served basis.
* Your extension name needs to be different from any extension already submitted to JED (company names not included)
*Your extension name needs to be different from any extension already submitted to the JED (company names not included)
* The extension name must be stated at the XML file tag NAME
*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
*You should use the same name in your site and download page.


=== Extension names conflict ===
=== Extension names conflict ===
An extension name will be considered in conflict when its too similar to other extension.
An extension name will be considered in conflict when its too similar to other extension, at the discretion of JED Editors.
*When extension names are found to be in conflict, the JED will consider the first listing submitted, even if it's unpublished
*More recent listings are required to change their extension name
*Conflicts are considred on a case-by-case basis


This is a JED Editors call, but you are able to create a report for that.
== How is the name created at JED? ==
* When extension names are found in conflict, JED will consider the oldest extension submitted, even if not currently published.
The alias (name) is created by a JED editor, using the following pieces of information:
* The more recent ones will be required to change their names.
*Proposal of developer in the field called "name" (the proposal should be the same to XML file tag "NAME" and MENU")
* This will be done case by case with each extension developer.
*Some words are not allowed
*Some words may be added by JED editors, acting as tags.


 
===Alias Disclaimer===
== How is the name created at JED? ==
Alias (names) can be edited by JED editors at any time if it's considered necessary for the maintainance of the directory.
The alias (name) its created by a JED editor, using:
*The alias names used at the JED do not represent an endorsement of trademarks used by the product by Joomla.org or OSM
* Proposal of developer in the field called "name".
*The JED will not be involved in trademark disputes as they need to be addressed by the users.
** 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 ===
=== Name registered ===
Where will JED look for extension names?
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).
* In the XML tags and code file names. Some special tags need to be the same (spaces not included).
==== XML tags ====
==== XML tags example ====
as in:
as in:
  * <name>jedilightsaber</name>
  * <name>jedilightsaber</name>
  * <menu>Jedi Lightsaber</menu>
  * <menu>Jedi Lightsaber</menu>
==== File names ====
==== File names example ====
as in:
as in:
  * mod_jedilightsaber.xml
  * mod_jedilightsaber.xml
Line 61: Line 61:


==== Light and Pro versions ====
==== Light and Pro versions ====
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.
The words "Light" and "Pro" can be added to differentiate two extensions from the same developer, but the extensions must have different features and distribution plans (like a free Lite version and paid Pro version)The word "Free" is considered promotional text and cannot be used.


Where to add the LIGHT/PRO tag?
When adding the "Light" and "Pro" tags:
* Components: in the XML name tag and file names or just to the menu tag name and JED Alias name.
* 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.
* 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 ==
=== Word "Joomla" and the extensions name ===
=== Word "Joomla" and the extensions name ===
We at the Joomla Extensions Directory have a direct interest in maintaining the integrity of the Joomla brand.
The JED has a direct interest in maintaining the integrity of the Joomla brand. The JED team will not allow violations fo the Joomla trademark, logo, brand, etc. to be placed in or linked from the JED.  
 
*An extension name can't start with the word "Joomla"
As such, we cannot allow violations of the Joomla trademark, logo, brand, etc., to be placed in or linked from the Joomla Extensions Directory.
*Extensions that use "Joomla" or a derivative of Joomla in the extension name need to be licensed by OSM
* An extension name can't start with the word "Joomla".
*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 extension name need to be licensed by OSM.
*It's a best practice to completely avoid the full word Joomla.
* 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! x". Instead, they should be named "x for Joomla!" or something similar that will not be confused with Joomla. Review the [[S:MyLanguage/JED Entries Trademark Checklist|Trademark Checklist]] for more help.  
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 ===
=== Derivative of Joomla string ===
What are the strings considered related with Joomla string?
What are the strings considered related with Joomla string?
* please read: [[JED_Entries_Trademark_Checklist]]
* please read: [[S:MyLanguage/JED Entries Trademark Checklist|Trademark Checklist]]


=== Joomla! Licensed ===
=== Joomla! Licensed ===
How can your extensions be licensed?
How can your extensions be licensed?
* please read: [[JED_Entries_Trademark_Checklist]]
* please read: [[S:MyLanguage/JED Entries Trademark Checklist|Trademark Checklist]]
 


== Special cases ==
== Special cases ==
=== Extension Specific Extensions ===
=== Extension Specific Extensions ===
Extension Specific Extensions are considered extensions that require another extension to be installed in order to run.
Extension Specific Plugins are extensions that require another extension to be installed in order to run. These plugins must have "for MAIN-EXTENSION-NAME" at the end of the extension name, even if it's not in the 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 ===
If you need to re-brand an old extension and avoid conflicts in installed sites please talk with JED team first.
If you need to re-brand an old extension, but you want to avoid conflicts with sites where the older extension is already installed, please talk with JED Team first. After choosing the new name:
After choosing the new name:
# Update your XML file tags NAME and MENU
# Update your XML file tags NAME and MENU
# Rename your files to reflect the new extension name
# Rename your files to reflect the new extension name
# Repack and re-attach the file to your actual JED entry
# Repack and re-attach the file to your JED entry
# Revise the mentions to the extension at your website
# 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.
'''Note:''' If #1 or #2 are not possible in respects to compatibility issues with installed sites, please include the new name in the description tag or in a comments line at your XML file.


=== Forks ===
=== Forks ===
Forked extensions have special rules to be listed at JED.
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: [http://extensions.joomla.org/tos TOS - Extensions and Forks]
 
Also read: [[S:MyLanguage/Forked_Extensions|Forked Extensions]]
Please read: TOS - Extensions and Forks http://extensions.joomla.org/tos
Also read: Forked Extensions http://docs.joomla.org/Forked_Extensions
 
=== Tools ===
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 ===
=== Scripts or libraries ===
The name must be included at the main file.
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
*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
*A TXT file must be included with the name, copyright, license and URL to download


 
== JED entry name: Do's and Don'ts ==
== JED entry name: Do's and donts ==
===The Do's ===
===The Do's ===
* XML file tag NAME needs to be the same as the extension entry name
*Name the XML file tag NAME the same as the extension name
* Components Admin menu (the tag MENU in the XML) needs to be the same as the Extension name
*Name the Component's admin menu (the tag MENU in the XML) the same as the extension name


===The Don'ts ===
===The Don'ts ===
* Offensive words, political or religious statements.
*Use offensive words, political or religious statements
* Extension types as they are not considered part of the extension name.
*Use extension types as part of the extension name (only used for the mobude and plugin versions of the same extension from the same developer)
** This will be used only for the same developer extensions if required (module and plugin versions)
*Use the version number in the name (there is a field for that)
* Version number (there is a field for that)
*Use price tags, commercial promotions or URL domains in the name
* Price tags, commercial promotions or URL domains
*Use the author or company name in the extension name (there is a field for that)
* Company name or author name (there is a field for that)
 
 
== 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.


==More information==
*See: [http://extensions.joomla.org/support/knowledgebase/item/extension-names Extension Names on the JED website]


<noinclude>[[Category:JED]][[Category:FAQ]][[Category:Template Development]]
<noinclude>[[Category:JED]][[Category:FAQ]][[Category:Template Development]]
Line 143: Line 125:
[[Category:Plugin Development]]
[[Category:Plugin Development]]
[[Category:Component Development]]</noinclude>
[[Category:Component Development]]</noinclude>
<noinclude>
[[Category:Needs to be marked for translation]]
</noinclude>

Revision as of 14:14, 11 August 2015

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 the JED. Extension names impact the extension structure and URLs that are displayed after the extension is installed, so plan ahead!

This article contains a few recommendations for naming extensions derived from best practices in the Joomla community.

Choosing a name: recommendations

Using a name similar to another extension?

  • Users could mix up the two extensions and report your extension or write a bad review for your extension even though it was intended for another
  • Security reports for an extension with similar names could confuse users
  • Simply adding a company name might not be sufficient enough change to make users aware of the differences
  • Try to avoid brand disputes with other developers.

How to create a good extension name?

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

  • Create an original brand name
  • Choose a name that's easy to pronounce
  • The name should be short as your XML and PHP files are named after the extension name. URLs on Joomla sites are also impacted by extension names.
  • Avoid overly descriptive names
  • Make it easy to search for your extension based on functionality, not by name.

Extension names at JED

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.

First Come, First Served

The JED listing name is approved by JED Editors on a first come, first served basis.

  • Your extension name needs to be different from any extension already submitted to the 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 and download page.

Extension names conflict

An extension name will be considered in conflict when its too similar to other extension, at the discretion of JED Editors.

  • When extension names are found to be in conflict, the JED will consider the first listing submitted, even if it's unpublished
  • More recent listings are required to change their extension name
  • Conflicts are considred on a case-by-case basis

How is the name created at JED?

The alias (name) is created by a JED editor, using the following pieces of information:

  • Proposal of developer in the field called "name" (the proposal should be the same to XML file tag "NAME" and MENU")
  • Some words are not allowed
  • Some words may be added by JED editors, acting as tags.

Alias Disclaimer

Alias (names) can be edited by JED editors at any time if it's considered necessary for the maintainance of the directory.

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

Name registered

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 example

as in:

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

File names example

as in:

* mod_jedilightsaber.xml
* mod_jedilightsaber.php

Light and Pro versions

The words "Light" and "Pro" can be added to differentiate two extensions from the same developer, but the extensions must have different features and distribution plans (like a free Lite version and paid Pro version). The word "Free" is considered promotional text and cannot be used.

When adding the "Light" and "Pro" tags:

  • 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

Word "Joomla" and the extensions name

The JED has a direct interest in maintaining the integrity of the Joomla brand. The JED team will not allow violations fo the Joomla trademark, logo, brand, etc. to be placed in or linked from the JED.

  • 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
  • It's a best practice to completely avoid the full word Joomla.

Please note that extensions should not be named "Joomla! x". Instead, they should be named "x for Joomla!" or something similar that will not be confused with Joomla. Review the Trademark Checklist for more help.

Derivative of Joomla string

What are the strings considered related with Joomla string?

Joomla! Licensed

How can your extensions be licensed?

Special cases

Extension Specific Extensions

Extension Specific Plugins are extensions that require another extension to be installed in order to run. These plugins must have "for MAIN-EXTENSION-NAME" at the end of the extension name, even if it's not in the XML file.

Rebranding

If you need to re-brand an old extension, but you want to avoid conflicts with sites where the older extension is already installed, 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 JED entry
  4. Revise the mentions to the extension at your website

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

Forks

Forked extensions have special rules to be listed at JED. Please read: TOS - Extensions and Forks Also read: Forked Extensions

Scripts or libraries

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 Don'ts

The Do's

  • Name the XML file tag NAME the same as the extension name
  • Name the Component's admin menu (the tag MENU in the XML) the same as the extension name

The Don'ts

  • Use offensive words, political or religious statements
  • Use extension types as part of the extension name (only used for the mobude and plugin versions of the same extension from the same developer)
  • Use the version number in the name (there is a field for that)
  • Use price tags, commercial promotions or URL domains in the name
  • Use the author or company name in the extension name (there is a field for that)

More information