View source for Catjoomla/doc

This template is a categorisation workhorse. It adds a page to several categories at once and supports supplemental text to flag abandoned features that have been deprecated or removed from a specific version either if the Joomla! code base, the {{jf}}, or any of its [[Application]]s. 

Although it's best applied to and designed for pages related to the {{jfr}} it's also a valuable tool for other documents at this site.

== Usage ==
For example in articles about a concept or feature as well as in a [[:Category|Tutorial|]]:
<pre>
{{catjoomla|1.5.0}}
</pre>

Framework or feature specific:
<pre>
{{catjoomla
| since      = version
| package    = name
| class      = name
| deprecated = version
|   use      = pagename
| removed    = version
|   remark   = wiki text
}}
</pre>
<big>All <tt>version</tt> numbers MUST use the '''major.minor.release''' numbering scheme, ie. <tt>1.5.0</tt>, <tt>1.0.12</tt> etc.</big> 
<br />Don't drop the ''.release'' number just because you don't know the exact version. You may look at Joomla!s CHANGELOG.php however. 
If you are unsure about the exact version number a feature was introduced please ommit the <var>since</var> parameter alltogether, and ''don't'' add the unnamed 1. parameter as shown in the general syntax. This will place the document in the "unknown version" category where someone who ''does know'' can find the entry and possibly fix it.
;since (or <nowiki>{{{1}}}</nowiki>)
: Joomla! Version this feature was first introduced
;package
: Framework package name
:;class
:: Class name, can only be used if ''package'' name is given
;deprecated
: Joomla! Version the feature was deprecated
:;use
:: if ''deprecated'' is set, the page name of the replacing (new, alternative) feature, if applicable. See ''remark'' parameter.
;removed
: Joomla! Version the feature was removed (w/o adequated replacement)
;remark:
: Supplemental message, i.e. combined with ''removed''. ;This parameter may contain wiki text.
You cay "misuse" the ''remark'' parameter to apply additional categories not covered in the default set.

== Example ==
Documentation in a deprecated feature:
 <nowiki>{{</nowiki>catjoomla
 &#x7C; since      = 1.5.0
 &#x7C; package    = Whatever
 &#x7C; class      = JWhatever
 &#x7C; deprecated = 1.6.0
 &#x7C; use        = [[JAPI:Newpackage/JWhatelse]]
 }}
will assign the page to the following categories
 <nowiki>Framework, Whatever, JWhatever, Joomla! 1.5.0, Joomla! 1.6.0</nowiki>
and generate this text:
 Deprecated as of <nowiki>[[Framework:Joomla! 1.6.0]]</nowiki>. Please use <nowiki>[[JAPI:Newpackage/JWhatelse|]]</nowiki> instead.

 <nowiki>{{</nowiki>catjoomla
 &#x7C; since   = 1.0.6
 &#x7C; removed = 1.6.0
 &#x7C; remark = No alternative at time of writing.
 }}

== Issues ==
You can't use the literal pipe character in '''any''' parameter, i.e. to rename the link. A trailing <tt>|</tt> pipe is automatically added after the '''page name''' assigned to <tt><nowiki>{{{use}}}</nowiki></tt>. You may however try the {{tlp|!}} template instead.

If <tt><nowiki>{{{use}}}</nowiki></tt> is refering to a subpage via <tt>/Pagename/</tt> (note the trailing <tt>/</tt>), the link caption might look wrong but the link itself should work (provided the target page exists). This is hopefully going to be fixed soon.

Using the '''[[Help:ParserFunctions|#titleparts:]''' parser function instead of, or in combination with, the named parameters, is should be easier to place a subpage such as "Package/Application/Classes/JApplication" into all appropriate categories with a suitable sortorder key.

'''See also:''' 
* {{tlp|future}} to "flag" a feature of a future, yet unreleased version of Joomla! ... if you dare ;)
<includeonly>[[Category:Wiki Templates|{{PAGENAME}}]][[Category:Link templates|{{PAGENAME}}]]</includeonly>