Joomla Documenter Manual
Manual Index
Local wiki templates
Local wiki templates • Local wiki extensions • Local 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:
Content 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:
Page 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}}
This 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.
This 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.
This 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.
This 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}}: | {{JVer|1.0|Joomla 1.0|long}}: |
CMS 1.5 | {{JVer|1.5}}: | {{JVer|1.5|Joomla 1.5|long}}: |
CMS 1.6 | {{JVer|1.6}}: | {{JVer|1.6|Joomla 1.6|long}}: |
CMS 1.7 | {{JVer|1.7}}: | {{JVer|1.7|Joomla 1.7|long}}: |
CMS 2.5 | {{JVer|2.5}}: | {{JVer|2,5|Joomla 2.5|long}}: |
CMS 3.x | {{JVer|3.x}}: | {{JVer|3.x|Joomla 3.x|long}}: |
CMS 3.0 | {{JVer|3.0}}: | {{JVer|3.0|Joomla 3.0|long}}: |
CMS 3.1 | {{JVer|3.1}}: | {{JVer|3.1|Joomla 3.1|long}}: |
CMS 3.2 | {{JVer|3.2}}: | {{JVer|3.2|Joomla 3.2|long}}: |
CMS 3.3 | {{JVer|3.3}}: | {{JVer|3.3|Joomla 3.3|long}}: |
CMS 3.4 | {{JVer|3.4}}: | {{JVer|3.4|Joomla 3.4|long}}: |
CMS 3.5 | {{JVer|3.5}}: | {{JVer|3.5|Joomla 3.5|long}}: |
CMS 3.6 | {{JVer|3.6}}: | {{JVer|3.6|Joomla 3.6|long}}: |
CMS 3.7 | {{JVer|3.7}}: | {{JVer|3.7|Joomla 3.7|long}}: |
CMS 3.8 | {{JVer|3.8}}: | {{JVer|3.8|Joomla 3.8|long}}: |
CMS 3.9 | {{JVer|3.9}}: | {{JVer|3.9|Joomla 3.9|long}}: |
CMS 4.x | {{JVer|4.x}}: | {{JVer|4.x|Joomla 4.x|long}}: |
CMS 4.0 | {{JVer|4.0}}: | {{JVer|4.0|Joomla 4.0|long}}: |
CMS 4.1 | {{JVer|4.1}}: | {{JVer|4.1|Joomla 4.1|long}}: |
Platform | {{JVer|Platform}}: | Not available |
Platform 11.1 | {{JVer|11.1}}: | Not available |
Platform 11.2 | {{JVer|11.2}}: | Not available |
Platform 11.3 | {{JVer|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:
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}}: | {{JVer/multi|1.6,1.7,2.5|Joomla Version|long}}: |
Platform | {{JVer/multi|11.1,11.2}}: | Not Available |
Mix CMS/Platform | {{JVer/multi|1.7,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.
This 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 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 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.
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:
- Category:Typing-aid templates
- Category:Wiki Templates for the big list