Joomla Documenter Manual

Manual Index

Local wiki templates

Local wiki templatesLocal wiki extensionsLocal interwiki links

MediaWiki templates should not to be confused with Joomla! templates! MediaWiki templates are "boiler-plate" items that can be included in your wiki pages by inserting a simple reference.

Incomplete Content Notice

Use this notice to indicate a page or section is incomplete and missing key information. The {{incomplete}} or {{underconstruction}} are different. The {{underconstruction}} template is used to note the page is not finished, but a contributor will be completing the page in the very near future. Insert {{incomplete}} to obtain the following notice:

Quill icon.pngContent is Incomplete

This project page or section is incomplete, which means it may be lacking information. You are welcome to assist in its completion by editing it as well. If this project page or section has not been edited in several days, please consider helping complete the content.
This page was last edited by Franz.wohlkoenig (talk| contribs) 13 months ago. (Purge)

Page In Use Notice

Use this notice should be used during Doc Sprints or if you will be editing a page for an extended period of time, e.g. more than 30 minutes. Please don't forget to remove it when you are done. Insert {{inuse}} at the top of the page to obtain the following notice:

Quill icon.pngPage Actively Being Edited!

This project page is actively undergoing a major edit for a short while.
As a courtesy, please do not edit this page while this message is displayed. The user who added this notice will be listed in the page history. This message is intended to help reduce edit conflicts; please remove it between editing sessions to allow others to edit the page. If this page has not been edited for several hours, please remove this template, or replace it with {{underconstruction}} or {{incomplete}}.

Under Construction Notice

The {{underconstruction}} template is used to note the page is not finished, but a contributor will be completing the page in the very near future. Insert {{underconstruction}} to obtain the following notice:

Copyedit

Use: {{copyedit}}

Copyedit.pngThis Page Needs Copy Editing

This article has been tagged and requires copy editing for grammar, style, cohesion, tone, or spelling. Please help maintain and improve our documentation by editing it.

Article Reviews and Needs

Once you're done with editing please replace {{underconstruction}} and {{inuse}} with {{review}}. This will add your document to the Category:Needs review.

Copyedit.pngThis Page Needs Your Help

This page is tagged because it NEEDS REVIEW*. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.*

You can also use the {{page}} notice if the page needs review or something other than a review.
Examples are:{{page|needs more content}} which would add the article to the Category:Needs more content.

Copyedit.pngThis Page Needs Your Help

This page is tagged because it NEEDS MORE CONTENT*. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.*

Or use, {{page|needs images}} which would add the article to the Category:Needs images.

Copyedit.pngThis Page Needs Your Help

This page is tagged because it NEEDS IMAGES*. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.*

Joomla Version Icons

To indicate availability of a class, method or some piece of functionality in or from a particular version of Joomla, you can use the {{JVer}} template. Only certain specific version numbers are supported:

Version Short icon Long icon
CMS 1.0 {{JVer|1.0}}: Joomla 1.0 {{JVer|1.0|Joomla 1.0|long}}: Joomla 1.0
CMS 1.5 {{JVer|1.5}}: Joomla 1.5 {{JVer|1.5|Joomla 1.5|long}}: Joomla 1.5
CMS 1.6 {{JVer|1.6}}: Joomla 1.6 {{JVer|1.6|Joomla 1.6|long}}: Joomla 1.6
CMS 1.7 {{JVer|1.7}}: Joomla 1.7 {{JVer|1.7|Joomla 1.7|long}}: Joomla 1.7
CMS 2.5 {{JVer|2.5}}: Joomla 2.5 {{JVer|2,5|Joomla 2.5|long}}: Joomla 2.5
CMS 3.x {{JVer|3.x}}: Joomla 3.x {{JVer|3.x|Joomla 3.x|long}}: Joomla 3.x
CMS 3.0 {{JVer|3.0}}: Joomla 3.0 {{JVer|3.0|Joomla 3.0|long}}: Joomla 3.0
CMS 3.1 {{JVer|3.1}}: Joomla 3.1 {{JVer|3.1|Joomla 3.1|long}}: Joomla 3.1
CMS 3.2 {{JVer|3.2}}: Joomla 3.2 {{JVer|3.2|Joomla 3.2|long}}: Joomla 3.2
CMS 3.3 {{JVer|3.3}}: Joomla 3.3 {{JVer|3.3|Joomla 3.3|long}}: Joomla 3.3
CMS 3.4 {{JVer|3.4}}: Joomla 3.4 {{JVer|3.4|Joomla 3.4|long}}: Joomla 3.4
CMS 3.5 {{JVer|3.5}}: Joomla 3.5 {{JVer|3.5|Joomla 3.5|long}}: Joomla 3.5
CMS 3.6 {{JVer|3.6}}: Joomla 3.6 {{JVer|3.6|Joomla 3.6|long}}: Joomla 3.6
CMS 3.7 {{JVer|3.7}}: Joomla 3.7 {{JVer|3.7|Joomla 3.7|long}}: Joomla 3.7
CMS 3.8 {{JVer|3.8}}: Joomla 3.8 {{JVer|3.8|Joomla 3.8|long}}: Joomla 3.8
CMS 3.9 {{JVer|3.9}}: Joomla 3.9 {{JVer|3.9|Joomla 3.9|long}}: Joomla 3.9
CMS 4.x {{JVer|4.x}}: Joomla 4.x {{JVer|4.x|Joomla 4.x|long}}: Joomla 4.x
CMS 4.0 {{JVer|4.0}}: Joomla 4.0 {{JVer|4.0|Joomla 4.0|long}}: Joomla 4.0
CMS 4.1 {{JVer|4.1}}: Joomla 4.1 {{JVer|4.1|Joomla 4.1|long}}: Joomla 4.1
Platform {{JVer|Platform}}: Joomla Platform Not available
Platform 11.1 {{JVer|11.1}}: Joomla 11.1 Not available
Platform 11.2 {{JVer|11.2}}: Joomla 11.2 Not available
Platform 11.3 {{JVer|11.3}}: Joomla 11.3 Not available

By default the alt tag generated will be the same as the version number, prefixed with the word "Joomla". You can override this default by adding a second parameter. For example, to get an alt tag of "Only available in Joomla 1.5" you should use {{JVer|1.5|Only available in Joomla 1.5}} which produces this: Only available in Joomla 1.5

Full documentation on the JVer template can be found here.

You can also use the {{JVer/multi}} Template to place multiple version icons.

Versions Short icon Long icon
CMS Versions {{JVer/multi|1.0,1.5}}:  Joomla 1.0 Joomla 1.5 {{JVer/multi|1.6,1.7,2.5|Joomla Version|long}}:  Joomla Version Joomla Version Joomla Version
Platform {{JVer/multi|11.1,11.2}}:   Joomla 11.2 Not Available
Mix CMS/Platform {{JVer/multi|1.7,11.2}}:  Joomla 1.7 Joomla 11.2 Not Available

For more information on use, specifically the long version icon use, please see, {{JVer/multi}}

Table of Contents

You will get a table of contents(TOC) box on each page by default as soon as you make 4 or more headings and subheadings on the page. As an example, please look at the one you see on this page. The default table of contents box is located on the right and text will flow around it.

  • You can force the table of contents in the location you add the text: __TOC__
  • Alternatively, you can suppress the table of contents box by adding anywhere on the page: __NOTOC__

Organisational Templates

Used to mark articles for deletion, merging or version splitting.

Delete

Use the template {{delete|}} on the very top of the page.

Delete-icon.pngThis Page is a Candidate for Deletion

This page is a candidate for deletion. The given reason is: This marker is just an example of use.

This notice should remain for a minimum of 1 week after it was placed on the page. If discussion is still ongoing, it should remain until a consensus is reached, after which the page will either be deleted or this notice removed. If you disagree with its deletion, please discuss your reasons on its associated talk page, as applicable.

Remember to check if anything links here and the page history before deleting.

Last edit by Franz.wohlkoenig (talk · contrib) · Last edited on Mon, 13 Jun 2022 00:35:53 +0000

Merge

Use the template {{merge|title of target page}} on the very top of the page.

Merge-icon.pngMerge Notice

It has been suggested that this article or section be merged with JDOC:Local wiki templates. (Discuss). Proposed since 13 months ago.

JSplit

Use the template {{JSplit}} on the very top of the page.

Split-icon.pngSplit Page into Specific Joomla! Versions - J2.5 and 3.x

It has been suggested that this article or section be split into specific version Namespaces. (Discuss). If version split is not obvious, please allow split request to remain for 1 week pending discussions. Proposed since 13 months ago.

Split

Use the template {{split|}} on the very top of the page.

Split-icon.png It has been suggested that this article or section be split into multiple pages. Reason: This page is too long and hard to follow. (Click to discuss) this split suggestion. If split is not obvious, please allow split request to remain for 1 week pending discussions. This page was last edited by Franz.wohlkoenig (talk| contribs) 13 months ago. (Purge)

Redirect

To create a redirect for an old page to a new page:

#REDIRECT [[new page URL]]

Version Notice

If an article is written for a specific Joomla! Version, please use the {{version}} template. It should be placed at the very top(first of all wiki markup) of an article so a person will see what version the page is relevant to. For example: {{version|1.6,1.7,2.5}} will place this:

If the article is a tutorial or part of a Tutorial Series, please use the {{version/tutor|1.5}} template, which will show this:

This helps readers know what version the information references and aids in version icon(s) inclusion in lists of articles and tutorials. For more information and how to use extended features of this template, please see {{version}} template documentation.

Standard License Notice

Insert {{license/en}} ('/{lang-code}')to obtain the following notice:

License

The contents of this wiki are subject to copyright law and are made available under the Joomla! Electronic Documentation License (JEDL) unless otherwise stated. You may find the JEDL Frequently Asked Questions useful in determining if your proposed use of this material is allowed. If you have any questions regarding licensing of this material please contact legal@opensourcematters.org. If you wish to report a possible violation of the license terms for the material on this site then please contact legal@opensourcematters.org.

Shortcuts, Links & Navigation

Some URLs can become utterly long, some are ugly, and some are just tedious to type over and over again. Adding categories to a page can become equally annoying.

To simplify your job try some of the following templates. Similar to the interwikis, they're true keystroke-savers:

  • {{jsite|keyword}}, for example:

{{jsite}} = www.joomla.org

{{jsite|forum}} = forum.joomla.org

{{jsite|ext}} = extensions.joomla.org. For more see {{jsite}}.

  • {{jforum|keyword}}, shortcuts for the many Working Group fora, i.e.

{{jforum}} = forum.joomla.org

{{jforum|doc}} = Documentation forum

{{jforum|devdoc}} = Developer Documentation forum. For more see {{jforum}}.

See also: