Joomla! Documentation - User contributions [en]

JDOC:How to Contribute to Joomla! Documentation

2025-01-23T20:15:42Z

HermanPeeren:

<noinclude><languages /></noinclude>
<translate>

Joomla! Documentation is powered by [https://www.mediawiki.org/wiki/MediaWiki MediaWiki]. Its growth and success is dependent on [[Special:ActiveUsers|individuals like you]]. Thank you for taking the first step towards contributing to the Joomla! Project. This page will show you how to get started and several ways of helping the documentation effort.
</translate>

{{amboxNew|image=notice|style=notice|title={{{title|<translate>New Documentation</translate>}}}|text=<translate>We are currently developing new documentation based on Joomla! to demonstrate the power of our CMS.</translate></br><translate>Please don't add your contributions to this wiki anymore; the information on this page is obsolete.</translate></br>
<translate>'''Your help with the update is very welcome and appreciated! Please report your suggestions, improvements or offer for assistence on [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''</translate>}}

<translate>
==Getting Started!== 
</translate>

<translate>

There are a few things you will need to do first.</translate>

<translate>
====Read the Wiki Policy==== 
</translate>
<translate>

You need to review the Joomla! Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki policy]]''' before you start editing.</translate>

<translate>
====Create a User Account==== 
</translate>
<translate>

To edit the Joomla! Documentation Wiki, you will need a user account. You may '''{{strikethrough|register for one here}}'''. Afterwards make sure to confirm your email address. Confirmation of your e-mail address will give you permission to edit any page except for a few that are protected.</translate>

<translate>

''Note: If you do not do any edit within 5 days following the creation of your account, your account will be automatically deleted for security reasons.''</translate>

<translate>
====Create a User Page==== 
</translate>
<translate>

After you have created an account, confirmed your email address and logged in, we recommend you take a few moments to create a User page.</translate>
<translate>

Creating a user page serves a few purposes:
* It lets users find out more about you.
* It lets you make some initial edits so that the [[User:Abuse filter|Wiki spammer and abuse filter]] can see that you're not a fake user. Note that for your first few edits, don't include external links as that will be what is most likely to trigger the filters.</translate>
<translate>

A quick cheat to start your user page:
*On the user menu, go to your '''Username''' page (or use first menu item on far right dropdown)
*Click the actions drop down button</translate>{{-}}[[File:JDOCS-actions-create-page-<translate>
en</translate>.png]]
<translate>
*Click Create
*Add the code to editor</translate> <code><nowiki>{{subst:Newuser}}</nowiki></code>
<translate>
*Fill in summary (e.g. ''This is my new user page'')</translate>{{-}}[[File:JDOCS-summary-form-input-<translate>
en</translate>.png]]
<translate>
*Click the Save button</translate>

<translate>
====Join the Documentation Communication Channels==== 
</translate>
<translate>

Joomla's official communication tool is [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. [[Mattermost|See this page]] for information on how to join the conversation and once you're in there, join the [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation] channel to join the discussion on Joomla! Documentation.</translate>

<translate>
==What Should I Do First?== 
</translate>
<translate>

There are several areas of documentation which always need attention. You can start by picking the one which is the most comfortable for you to work on or you may get more involved by working on several at a time. Once you have a Wiki account, you are free to work on any aspect of the documentation that takes your fancy. Even the simplest contributions such as spelling corrections and grammar fixes are a tremendous help!</translate>
<translate>

#[[#Help Manage Our Content|Help with documentation content]].
#[[#Wiki Maintenance|Maintenance Tasks]].
#[[#Documentation Project|Join or start documentation project]].
#[[#Help Screens|Help with Help Screens]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]]
</translate>

<translate>
===Help Manage Our Content=== 
</translate>

<translate>

#Editing, rewriting and reorganising pages. Check our [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs pages]] for areas needing immediate help. They are called ''Needs pages'' because they are in need of small tasks to complete them. Some of them are as simple as reviewing content or adding an image. Others require more content or improvements. Pick a few, give them a little love. This is a tremendous help to Joomla! users who rely on our documentation.
</translate>
<translate>

#Have some fun and browse for articles which are redundant, out of version (i.e. 1.0 and 1.5), or need to be split up because of version specific information. Then feel free to make use of the {{tl|delete}}, {{tl|merge}} or {{tl|JSplit}} templates on the articles. ''Click the previous template links to see how to use and apply them to articles you think need these marker templates. Add them to the very top of a page and the page is marked.''
</translate>
<translate>

#'''Create a new page or tutorial.''' If you want to start a new page, do some extensive research first. Don't to create a new article if one already exists. Use the [[Special:Search|search feature]] of the Docs Wiki to see if your topic is already in an article. '''Duplication will be merged and/or deleted'''. Don't be afraid to modify, reformat or improve someone else's work on the Joomla! Docs Wiki! This is a collaborative documentation Wiki. Just make sure you are following our [[S:MyLanguage/JDOC:Policies and guidelines|policy and guidelines]].</translate>
<translate>

##''Using Wikilinks.'' It's very easy to link pages using a standard syntax. If you create a link to an article that doesn't exist yet, the link will be colored red. Clicking a red link will take you to the edit page for the new article. Simply type your text, click save and the new page will be created. Once the page has been created, the link will change from red to blue indicating that the article now exists.</translate>
<translate>

##''Using the URL.'' To use when you want to create a page from scratch. You can use the Wiki's URL for creating a new page. The URL to an article of the Wiki is usually something like this: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. If you replace YOURTITLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. Clicking the ''Create this page'' link will take you to the edit page for that article, where you can create the new page by typing your text, and clicking ''Submit''.</translate>
<translate>

#'''Help update images in articles.''' Check the category [[S:MyLanguage/:Category:Needs image updating|Needs image updating]] for a list of pages which need their images updated. Our suggested guidelines to help you are found in the article, [[S:MyLanguage/JDOC:Image naming guidelines|Image naming guidelines]].
</translate>

<translate>
===Wiki Maintenance=== 
</translate>
<translate>

:Maintaining a Wiki and keeping it organised takes a lot of continuous work on the part of administrators, editors and users. There are always tasks needing attention such as: [[Special:UncategorizedPages|Categorisation]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|attending to pages with needs]], that are [[S:MyLanguage/Category:Article_under_construction|under construction]], or by marking pages for [[Template:Delete|deletion]], [[Template:Merge|merging]] or [[Template:JSplit|splitting]]. For all maintenance tasks and ideas of how you can help, please visit our [[S:MyLanguage/JDOC:Maintenance Tasks|Documentation Maintenance page]].
</translate>

<translate>
===Documentation Projects=== 
</translate>
<translate>

*The Docs team is working on [[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]. Our goal is to make them easy to understand and navigate, something a Beginner can follow easily and learn basic concepts. Think back to when you were new to Joomla! and add a topic about something you struggled with as a beginner to the page. Better yet, join the [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Beginner Tutorials Project]].
</translate>
<translate>

*Join the [[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]] and share your knowledge. Sign your name using 4 tildes ( <nowiki>~~~~</nowiki> ) on the [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] page and list what you might be able to do. Feel free to add some [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|tutorial topics]] to the suggested topics list.
</translate>

<translate>
===Help Screens=== 
</translate>

<translate>

Unknown to many, all [[S:MyLanguage/Help screens|Help Screen]] pages are created and served to every Joomla! installation worldwide from this Wiki! They are necessary for beginners and even those with intermediate knowledge of Joomla!
</translate>

<translate>
'''The Joomla! 4.x Help Screens need to be reviewed and updated'''. Any contribution you give to them will be appreciated by many users worldwide and we're looking for volunteers to help with this important task. A matrix needs to be put in place as well as an action plan.</translate>

<translate>
==Things to Remember== 
</translate>
<translate>

Here are a few things to remember as a Joomla! Docs contributor.
</translate>

<translate>

*Don't be afraid to break a page, if you do and something has gone really wrong, revert your edit. Click the page's '''History''' tab and you will see links to undo and revert.
*Write articles with a sense they will be translated to another language. Using slang or local dialect may not translate to another language or its inferences be understood. Find out more about [[JDOC:Documentation Translators|Translating Joomla Documentation]].
</translate>
<translate>

*Don't be afraid to download and read the general [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] that applies to all Joomla! Documentation. There are helpful hints on how to write for Joomla! Documentation.
</translate>
<translate>

*Words to watch when writing for instant feedback use Google Chrome or Mozilla Firefox browsers. They both have built-in spell checking which underlines a misspelled word.
*Don't forget to add the {{tl|inuse}} template to an article you are going to be working on it for a long period of time, more than a minute. It helps to prevent editing conflicts.
</translate>

<translate>
==Help, I Don't Know Wiki Markup!== 
</translate>
<translate>

If you are new to the use of Wikis and the simple markup to create pages, then use the following for help.
</translate>
<translate>

*New WikiEditor contains buttons and quick links to make building pages easier. Click the word ''Advanced'' for a drop down of more buttons and quick formatting links.
*Use the [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] to learn the basic syntax commands. There is also a drop down of the common markup in the editor. Just click the word ''Help'' once and it will appear.
</translate>
<translate>

*Still afraid? Try these tools to help you create great Wiki pages.
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], save Word Docs in Wiki Markup.
:*'''OpenOffice.org versions 2.4 and later''' have a MediaWiki export filter built in. Just open a Writer document and click File - Export. Then, change File format to MediaWiki.
:*Here is a [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|list of tools]] available to convert other formats to Wiki markup, e.g. HTML, Excel, CSV. Some of them are online converters, cut and paste HTML for an output in Wiki markup.
</translate>
<translate>

*Get help on [https://joomlacommunity.cloud.mattermost.com/ Mattermost] (We have a lot of channels there. E.g. one for the JDocs Translation Group and one for the JDocs Working group).
*Post a question on an [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 administrator's] or [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 editor's] talk page.
</translate>

<translate>
[[Category:Documentation Wiki Information]]
[[Category:Volunteer Engagement{{#translation:}}]]
</translate>

JDOC:How to Contribute to Joomla! Documentation

2025-01-23T20:14:43Z

HermanPeeren: Added a pointer to Mattermost and deleted the link to the register-page.

<noinclude><languages /></noinclude>
<translate>

Joomla! Documentation is powered by [https://www.mediawiki.org/wiki/MediaWiki MediaWiki]. Its growth and success is dependent on [[Special:ActiveUsers|individuals like you]]. Thank you for taking the first step towards contributing to the Joomla! Project. This page will show you how to get started and several ways of helping the documentation effort.
</translate>

{{amboxNew|image=notice|style=notice|title={{{title|<translate>New Documentation</translate>}}}|text=<translate>We are currently developing new documentation based on Joomla! to demonstrate the power of our CMS.</translate></br><translate>Please don't add your contributions to this wiki anymore; the information on this page is obsolete.</translate></br>
<translate>'''Your help with the update is very welcome and appreciated! Please report your suggestions, improvements or or offer for assistence on [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''</translate>}}

<translate>
==Getting Started!== 
</translate>

<translate>

There are a few things you will need to do first.</translate>

<translate>
====Read the Wiki Policy==== 
</translate>
<translate>

You need to review the Joomla! Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki policy]]''' before you start editing.</translate>

<translate>
====Create a User Account==== 
</translate>
<translate>

To edit the Joomla! Documentation Wiki, you will need a user account. You may '''{{strikethrough|register for one here}}'''. Afterwards make sure to confirm your email address. Confirmation of your e-mail address will give you permission to edit any page except for a few that are protected.</translate>

<translate>

''Note: If you do not do any edit within 5 days following the creation of your account, your account will be automatically deleted for security reasons.''</translate>

<translate>
====Create a User Page==== 
</translate>
<translate>

After you have created an account, confirmed your email address and logged in, we recommend you take a few moments to create a User page.</translate>
<translate>

Creating a user page serves a few purposes:
* It lets users find out more about you.
* It lets you make some initial edits so that the [[User:Abuse filter|Wiki spammer and abuse filter]] can see that you're not a fake user. Note that for your first few edits, don't include external links as that will be what is most likely to trigger the filters.</translate>
<translate>

A quick cheat to start your user page:
*On the user menu, go to your '''Username''' page (or use first menu item on far right dropdown)
*Click the actions drop down button</translate>{{-}}[[File:JDOCS-actions-create-page-<translate>
en</translate>.png]]
<translate>
*Click Create
*Add the code to editor</translate> <code><nowiki>{{subst:Newuser}}</nowiki></code>
<translate>
*Fill in summary (e.g. ''This is my new user page'')</translate>{{-}}[[File:JDOCS-summary-form-input-<translate>
en</translate>.png]]
<translate>
*Click the Save button</translate>

<translate>
====Join the Documentation Communication Channels==== 
</translate>
<translate>

Joomla's official communication tool is [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. [[Mattermost|See this page]] for information on how to join the conversation and once you're in there, join the [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation] channel to join the discussion on Joomla! Documentation.</translate>

<translate>
==What Should I Do First?== 
</translate>
<translate>

There are several areas of documentation which always need attention. You can start by picking the one which is the most comfortable for you to work on or you may get more involved by working on several at a time. Once you have a Wiki account, you are free to work on any aspect of the documentation that takes your fancy. Even the simplest contributions such as spelling corrections and grammar fixes are a tremendous help!</translate>
<translate>

#[[#Help Manage Our Content|Help with documentation content]].
#[[#Wiki Maintenance|Maintenance Tasks]].
#[[#Documentation Project|Join or start documentation project]].
#[[#Help Screens|Help with Help Screens]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]]
</translate>

<translate>
===Help Manage Our Content=== 
</translate>

<translate>

#Editing, rewriting and reorganising pages. Check our [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs pages]] for areas needing immediate help. They are called ''Needs pages'' because they are in need of small tasks to complete them. Some of them are as simple as reviewing content or adding an image. Others require more content or improvements. Pick a few, give them a little love. This is a tremendous help to Joomla! users who rely on our documentation.
</translate>
<translate>

#Have some fun and browse for articles which are redundant, out of version (i.e. 1.0 and 1.5), or need to be split up because of version specific information. Then feel free to make use of the {{tl|delete}}, {{tl|merge}} or {{tl|JSplit}} templates on the articles. ''Click the previous template links to see how to use and apply them to articles you think need these marker templates. Add them to the very top of a page and the page is marked.''
</translate>
<translate>

#'''Create a new page or tutorial.''' If you want to start a new page, do some extensive research first. Don't to create a new article if one already exists. Use the [[Special:Search|search feature]] of the Docs Wiki to see if your topic is already in an article. '''Duplication will be merged and/or deleted'''. Don't be afraid to modify, reformat or improve someone else's work on the Joomla! Docs Wiki! This is a collaborative documentation Wiki. Just make sure you are following our [[S:MyLanguage/JDOC:Policies and guidelines|policy and guidelines]].</translate>
<translate>

##''Using Wikilinks.'' It's very easy to link pages using a standard syntax. If you create a link to an article that doesn't exist yet, the link will be colored red. Clicking a red link will take you to the edit page for the new article. Simply type your text, click save and the new page will be created. Once the page has been created, the link will change from red to blue indicating that the article now exists.</translate>
<translate>

##''Using the URL.'' To use when you want to create a page from scratch. You can use the Wiki's URL for creating a new page. The URL to an article of the Wiki is usually something like this: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. If you replace YOURTITLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. Clicking the ''Create this page'' link will take you to the edit page for that article, where you can create the new page by typing your text, and clicking ''Submit''.</translate>
<translate>

#'''Help update images in articles.''' Check the category [[S:MyLanguage/:Category:Needs image updating|Needs image updating]] for a list of pages which need their images updated. Our suggested guidelines to help you are found in the article, [[S:MyLanguage/JDOC:Image naming guidelines|Image naming guidelines]].
</translate>

<translate>
===Wiki Maintenance=== 
</translate>
<translate>

:Maintaining a Wiki and keeping it organised takes a lot of continuous work on the part of administrators, editors and users. There are always tasks needing attention such as: [[Special:UncategorizedPages|Categorisation]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|attending to pages with needs]], that are [[S:MyLanguage/Category:Article_under_construction|under construction]], or by marking pages for [[Template:Delete|deletion]], [[Template:Merge|merging]] or [[Template:JSplit|splitting]]. For all maintenance tasks and ideas of how you can help, please visit our [[S:MyLanguage/JDOC:Maintenance Tasks|Documentation Maintenance page]].
</translate>

<translate>
===Documentation Projects=== 
</translate>
<translate>

*The Docs team is working on [[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]. Our goal is to make them easy to understand and navigate, something a Beginner can follow easily and learn basic concepts. Think back to when you were new to Joomla! and add a topic about something you struggled with as a beginner to the page. Better yet, join the [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Beginner Tutorials Project]].
</translate>
<translate>

*Join the [[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]] and share your knowledge. Sign your name using 4 tildes ( <nowiki>~~~~</nowiki> ) on the [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] page and list what you might be able to do. Feel free to add some [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|tutorial topics]] to the suggested topics list.
</translate>

<translate>
===Help Screens=== 
</translate>

<translate>

Unknown to many, all [[S:MyLanguage/Help screens|Help Screen]] pages are created and served to every Joomla! installation worldwide from this Wiki! They are necessary for beginners and even those with intermediate knowledge of Joomla!
</translate>

<translate>
'''The Joomla! 4.x Help Screens need to be reviewed and updated'''. Any contribution you give to them will be appreciated by many users worldwide and we're looking for volunteers to help with this important task. A matrix needs to be put in place as well as an action plan.</translate>

<translate>
==Things to Remember== 
</translate>
<translate>

Here are a few things to remember as a Joomla! Docs contributor.
</translate>

<translate>

*Don't be afraid to break a page, if you do and something has gone really wrong, revert your edit. Click the page's '''History''' tab and you will see links to undo and revert.
*Write articles with a sense they will be translated to another language. Using slang or local dialect may not translate to another language or its inferences be understood. Find out more about [[JDOC:Documentation Translators|Translating Joomla Documentation]].
</translate>
<translate>

*Don't be afraid to download and read the general [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] that applies to all Joomla! Documentation. There are helpful hints on how to write for Joomla! Documentation.
</translate>
<translate>

*Words to watch when writing for instant feedback use Google Chrome or Mozilla Firefox browsers. They both have built-in spell checking which underlines a misspelled word.
*Don't forget to add the {{tl|inuse}} template to an article you are going to be working on it for a long period of time, more than a minute. It helps to prevent editing conflicts.
</translate>

<translate>
==Help, I Don't Know Wiki Markup!== 
</translate>
<translate>

If you are new to the use of Wikis and the simple markup to create pages, then use the following for help.
</translate>
<translate>

*New WikiEditor contains buttons and quick links to make building pages easier. Click the word ''Advanced'' for a drop down of more buttons and quick formatting links.
*Use the [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] to learn the basic syntax commands. There is also a drop down of the common markup in the editor. Just click the word ''Help'' once and it will appear.
</translate>
<translate>

*Still afraid? Try these tools to help you create great Wiki pages.
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], save Word Docs in Wiki Markup.
:*'''OpenOffice.org versions 2.4 and later''' have a MediaWiki export filter built in. Just open a Writer document and click File - Export. Then, change File format to MediaWiki.
:*Here is a [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|list of tools]] available to convert other formats to Wiki markup, e.g. HTML, Excel, CSV. Some of them are online converters, cut and paste HTML for an output in Wiki markup.
</translate>
<translate>

*Get help on [https://joomlacommunity.cloud.mattermost.com/ Mattermost] (We have a lot of channels there. E.g. one for the JDocs Translation Group and one for the JDocs Working group).
*Post a question on an [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 administrator's] or [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 editor's] talk page.
</translate>

<translate>
[[Category:Documentation Wiki Information]]
[[Category:Volunteer Engagement{{#translation:}}]]
</translate>

Template:CurrentSTSVer5

2025-01-14T20:24:00Z

HermanPeeren: updated 5.2.0. to 5.2.3

{{#switch:{{{1}}}|
1|
major=5|
2|
minor=5.2|
4|
#default|
maintenance=5.2.3
}}<noinclude></noinclude>

Template:CurrentSTSVer4

2025-01-14T20:21:57Z

HermanPeeren: update 4.4.9 to 4.4.10

{{#switch:{{{1}}}|
1|
major=4|
2|
minor=4.4|
4|
#default|
maintenance=4.4.10
}}<noinclude></noinclude>

Tutorials:Beginners

2025-01-14T19:43:23Z

HermanPeeren: removed a 3

<noinclude><languages /></noinclude>

<noinclude><translate>
This page is a Portal to a list Tutorials aimed at Beginning Joomla! Users.</translate></noinclude>

<translate>

If you have any ideas, please create redlinks to topics you would like covered under '''Wanted Topics''' below.
</translate>

<translate>
==Topics== 
</translate>
<translate>
*[[S:MyLanguage/J4.x:Getting_Started_with_Joomla!|Getting Started with Joomla!]]
**[[S:MyLanguage/J3.0:Getting Started with Templates|Getting Started with Templates]]
**[[S:MyLanguage/J3.0:Getting Started with Categories|Getting Started with Categories]]
**[[S:MyLanguage/J3.0:Getting Started with Articles|Getting Started with Articles]]
**[[S:MyLanguage/J3.0:Getting Started with Menus|Getting Started with Menus]]
**[[S:MyLanguage/J3.0:Getting Started Modules|Getting Started with Modules]]
*[[S:MyLanguage/J3.1:How To Use Content Tags in Joomla!|How To Use Content Tags in Joomla!]]</translate>
<translate>
*[[S:MyLanguage/Content_editors|Editing with TinyMCE]]</translate>

<translate>
==Wanted Topics== 
</translate>

<translate>
==Video Resources== 
</translate>
<translate>

In addition to the over 700 tutorials in the Joomla Documentation, there's a wide variety of video resources available to help you with learning Joomla.</translate>
<translate>

Thanks to the [https://magazine.joomla.org/all-issues/october-2020/where-to-find-the-best-joomla-tutorial-videos Joomla Magazine] there ar a lot of them found. If you know more please add them.</translate>

<translate>
=== Joomla's own YouTube channel === 
</translate>

<translate> The first thing you can do is head over to Joomla’s official YouTube channel, where all tutorials are neatly listed in [https://www.youtube.com/c/joomla/playlists multiple playlists]. Here you’ll find tutorials on all kinds of subjects, from customizing Joomla to patch testing. </translate>

<translate>
Examples are [https://www.youtube.com/playlist?list=PL0Lg2fzcJu1TqH4iC8sfZby_0F02Ib56p Joomla Tutorials] playlist,
[https://www.youtube.com/watch?v=22RXppJjXf8&list=PL0Lg2fzcJu1R3q6aYKX-olfGQm_o6uXyq How to patch test] playlist and
[https://www.youtube.com/watch?v=4JDsdfnlOhE&list=PL0Lg2fzcJu1R8PCZi0wVNE6QYZUqATvpE How to develop an MVC component] playlist.</translate>

<translate>
=== Joomla training videos from OSTraining === 
</translate>

<translate> OS Training provides online training to teach people how to build websites. For Joomla, they developed free classes on five topics: a beginners guide, maintenance, security, creating multilingual sites, and SEO. Each class contains multiple videos. With over 80 videos suitable for various skill levels, the official Joomla training covers most of the tasks you could possibly want to do with Joomla. The videos have been there for quite some time now and some of them may seem outdated, but the basics have remained the same so these tutorials are still a useful resource.</translate>

<translate> Find the free videos [https://www.youtube.com/watch?v=XpBGeHkfXpc&list=PLtaXuX0nEZk_4XIvoPA7O0xT_sYRKnTos here on Youtube].</translate>

<translate> More (paid) Videos on [https://www.ostraining.com/joomla-classes/ OS Training] and there partner [https://www.joomlashack.com/classes/joomla/ Joomlashack].</translate>

<translate>
=== Cloud Access === 
</translate>

<translate> Cloud Access is our partner and service provider for the free joomla.com domains. On their website, they have loads of free tutorials, both video and written.</translate>
<translate> You can find them [https://www.cloudaccess.net/joomla-knowledgebase/92-joomla-3-1.html here] or their [https://www.youtube.com/playlist?list=PLn5i4hx3TuLENWOYNe47PSmbDivJV_Lr_ YouTube Channel]</translate>

<translate>
===Tim Davis Basic Joomla Tutorials=== 
</translate>

<translate> The Basic Joomla Tutorials channel on YouTube features Joomla tutorials and live streams that help Joomla fans and users get more success and enjoyment out of their Joomla sites. Tim Davis, the host, is very experienced in creating videos (his company provides video tutorials for their clients) and good at explaining complex things. The videos look professional and are [https://www.youtube.com/basicjoomla fun to watch].</translate>

<translate>
===Eoin Oliver’s Joomla Tutorials=== 
</translate>

<translate> OK, this one is a true hidden gem and we are really glad we found it: Eoin Oliver provides tips for professional web designers. If you are looking for ways to make your job easier, Eoin Oliver’s channel is the place to go! Eoin has great tips that can save you a lot of work and reduce the number of support requests. [https://www.youtube.com/channel/UCDMDQomkFd-3x-8l2UT3JPg Very interesting]!</translate>

<translate>
===Videos from JUGs and Joomla Events=== 
</translate>

<translate> Several Joomla User Groups have their own video channels where they share the videos from their meetings. Not really how-to’s, but interesting nevertheless.</translate>

<translate>
Various Joomla User Groups, for example Joomla Australia and Joomla London, organise virtual meetups you can join.


* Joomla Australia’s channel has a number of sessions from both JoomlaDay Australia and more recently their virtual Joomla User Group sessions. [https://www.youtube.com/c/JoomlaAustralia Visit Joomla Australia's Youtube Channel].</translate>

* <translate> Parlez-vous Français? Check out the videos from [https://www.youtube.com/channel/UCNTe8CGmY4U_Qpj8YfGQ5qQ/videos JoomlaDay France].</translate>

* <translate> Hablas español? Podcast-channel [https://www.youtube.com/channel/UCBc-rjWEkjTjJegZ2f08hnA Mastermind Joomla] has videos as well.</translate>

* <translate> Spreek je Nederlands? Check out the videos from [https://www.youtube.com/user/JoomlaDagen JoomlaDays The Netherlands].</translate>

* <translate> Parli italiano? On Joomla.it there is a free video course on the [https://www.joomla.it/guide/corso-joomla-3-start.html basics of Joomla] 3.x</translate>

* <translate> J and Beyond, the annual European international Joomla Conference, has made hundreds of interesting videos, [https://www.youtube.com/user/jandbeyondev/videos from presentations and talks on all kinds of topics].</translate>

* <translate> [https://www.youtube.com/c/JoomlalondonUk Joomla! London have a comprehensive range of video session] from their user group over the years. Their sessions often go into an in depth level of detail on technical topics.</translate>

<translate>
[https://community.joomla.org/user-groups.html Joomla User Groups] around the world hold a range of events locally and internationally. Check out the [https://community.joomla.org/events.html Joomla Events Calendar] for events that are coming up near you, or follow various groups to find out more about resources they may publish after the event.

===More=== 


Extension developers often have tutorial videos on their website as well. Akeeba, the developer of Akeeba Backup and Admin Tools, has great videos on [https://www.akeeba.com/videos.html how to use their extensions].


These are just a few of the tutorial videos available. If you type in [https://www.youtube.com/results?search_query=joomla+training “Joomla training”] on YouTube, you’ll find there are many more to choose from, for all levels: beginner tutorials, developers guides, one-time explanations on how to fix certain errors, and complete crash courses.


More can be find in the category below.</translate>
<noinclude>
[[Category:video]]
[[Category:Beginners]]
</noinclude>

Adding changelog to your manifest file

2024-11-12T16:36:11Z

HermanPeeren: update URL to refer to manual (install -> installation)

<noinclude><languages /></noinclude>

{{Warning|This page has been superseded and is no longer maintained. Please go to [https://manual.joomla.org/docs/building-extensions/install-update/installation/change-log Joomla Manual Changelogs section] instead}}

{{Joomla version|version=4.x|comment=><translate> Tutorial</translate>}}

<translate> Since Joomla 4.0, extension developers can leverage the ability of Joomla to read a changelog file and give a visual representation of the changelog. If a given version is not found in the changelog, the changelog button will not be shown.</translate>

<translate> The changes in a release will be presented in this manner:</translate>

[[File:Changelog modal-<translate> en</translate>.png|700px|Changelog modal]]

<translate> The changelog is used in two different places.</translate>

<translate>
=== Update View === 
</translate>
<translate> The installer will show the changelog of the version that can be installed if available.</translate>

[[File:Update view changelog button-<translate> en</translate>.png|700px|Changelog button on the Update View]]

<translate> Clicking the '''Changelog''' button here will show the changelog of the new available version.</translate>

<translate>
=== Manage View === 
</translate>
<translate> The extension manager will show the changelog of the currently installed extension if available.</translate>

[[File:Manage view changelog link-<translate> en</translate>.png|700px|Version number is a link to the changelog modal]]

<translate> Clicking the version number here will show the changelog of the current installed version.</translate>

<translate>
== Add changelogurl Tag to Manifest Files == 
</translate>
<translate> The first step is to update your manifest files that tell Joomla where to find the changelog details. Add the following node to your manifest XML files:</translate>
<syntaxhighlight lang="XML">
<changelogurl>https://example.com/updates/changelog.xml</changelogurl>
</syntaxhighlight>
<translate>

Please note: The URL in the <code>changelogurl</code> tag must not have any spaces or line breaks before or after it. See code examples.
</translate>
<translate>
=== Update Server Manifest === 
</translate>
<translate> See this example for an update server manifest file that informs Joomla about an update of a component named "com_lists". Thus you will see the Changelog button in the update view.</translate>

<syntaxhighlight lang="XML">
<?xml version="1.0" encoding="utf-8"?>
<updates>
<update>
<name>Student List</name>
<description>List of students</description>
<element>com_lists</element>
<type>component</type>
<version>4.0.0</version>

<changelogurl>https://example.com/updates/changelog.xml</changelogurl>

<tags>
<tag>stable</tag>
</tags>
<maintainer>Example Miller</maintainer>
<maintainerurl>https://example.com/</maintainerurl>
<section>Updates</section>
<targetplatform name="joomla" version="4.?" />
<client>1</client>
<folder></folder>
</update>
</updates>
</syntaxhighlight>

<translate>
=== Extension Manifest === 
</translate>
<translate>

Additionally add the changelogurl tag to the extension manifest XML. Thus the extension version will be linked to the changelogs in the manage view.
</translate>

<syntaxhighlight lang="XML">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" method="upgrade">
<name>COM_LISTS</name>

... Other stuff ...

<changelogurl>https://example.com/updates/changelog.xml</changelogurl>

<updateservers>
<server type="extension" name="My Extension's Updates">https://example.com/lists-updates.xml</server>
</updateservers>
</extension>
</syntaxhighlight>
<translate>

== Create ''changelog'' File == 
</translate>
<translate> The changelog file must have the following 3 nodes:</translate>
<translate>
* element
* type
* version</translate>

<translate>
This information is used to identify the correct changelog for a given extension.


A <code>version</code> node inside any <code>changelog</code> node is always mandatory. Otherwise you will see an error message like ''SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data''.
</translate>

<syntaxhighlight lang="XML">
<element>com_lists</element>
<type>component</type>
<version>4.0.0</version>
</syntaxhighlight>

<translate> Further the changelog is filled with one or more change types. The following change types are supported:</translate>
<translate> * '''security''': Any security issues that have been fixed</translate>
<translate> * '''fix''': Any bugs that have been fixed</translate>
<translate> * '''language''': This is for language changes</translate>
<translate> * '''addition''': Any new features added</translate>
<translate> * '''change''': Any changes</translate>
<translate> * '''remove''': Any features removed</translate>
<translate> * '''note''': Any extra information to inform the user</translate>

<translate> Each node can be repeated as many times as needed.</translate>

<translate> The format of the text can be plain text or HTML but in case of HTML, it must be enclosed in CDATA tags as shown in the example.</translate>

<syntaxhighlight lang="XML">
<changelogs>
<changelog>
<element>com_lists</element>
<type>component</type>
<version>4.0.0</version>
<security>
<item>Item A</item>
<item><![CDATA[<h2>You MUST replace this file</h2>]]></item>
</security>
<fix>
<item>Item A</item>
<item>Item b</item>
</fix>
<language>
<item>Item A</item>
<item>Item b</item>
</language>
<addition>
<item>Item A</item>
<item>Item b</item>
</addition>
<change>
<item>Item A</item>
<item>Item b</item>
</change>
<remove>
<item>Item A</item>
<item>Item b</item>
</remove>
<note>
<item>Item A</item>
<item>Item b</item>
</note>
</changelog>
<changelog>
<element>com_lists</element>
<type>component</type>
<version>0.0.2</version>
<security>
<item>Big issue</item>
</security>
</changelog>
</changelogs>
</syntaxhighlight>

<translate> This file contains 2 changelogs:</translate>
<translate> * Version 0.0.2 (for testing the manage view)</translate>
<translate> * Version 4.0.0 (for testing the update view)</translate>

<translate> A changelog can have as many versions as needed.</translate>

<noinclude>
[[Category:Beginner Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Development{{#translation:}}]]
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Joomla! 4.0{{#translation:}}]]
</noinclude>

Category:Magazine/nl

2024-11-12T16:15:50Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het Joomla Community Magazine is uitgegroeid tot een waardevolle bron van informatie - veel dank aan het Joomla Community Magazine Team en de vele auteurs die hebben bijgedragen.

Het magazine biedt een breed aanbod aan Joomla-gerelateerde onderwerpen in elke nieuwe editie.

<noinclude>[[Category:Magazine]]</noinclude>

Category:Magazine/nl

2024-11-12T16:15:16Z

HermanPeeren:

<noinclude><languages /></noinclude>
<div class="mw-translate-fuzzy">
Het Joomla Community Magazine is uitgegroeid tot een waardevolle bron van informatie - veel dank aan het Joomla Community Magazine Team en de vele auteurs die hebben bijgedragen.
</div>

Het magazine biedt een breed aanbod aan Joomla-gerelateerde onderwerpen in elke nieuwe editie.

<noinclude>[[Category:Magazine]]</noinclude>

Translations:Category:Magazine/2/nl

2024-11-12T16:15:15Z

HermanPeeren:

Het magazine biedt een breed aanbod aan Joomla-gerelateerde onderwerpen in elke nieuwe editie.

Manifest files

2024-10-02T15:09:07Z

HermanPeeren: Corrected URL that refers to the manual: "install" changed to "installation".

<noinclude><languages /></noinclude>
<noinclude>

{{Warning|This page has been superseded and is no longer maintained. Please go to [https://manual.joomla.org/docs/building-extensions/install-update/installation/manifest Joomla manual Manifest Files] instead}}

{{Joomla version|version=4.x}} {{Joomla version|version=3.x}} {{Joomla version|version=2.5|status=eos}}
</noinclude>
<translate>
Within Joomla there are manifest files for all of the extensions. These files include the general installation information as well as parameters for the configuration of the [[S:MyLanguage/extension|extension]] itself. Since Joomla! 2.5, there are very few differences between the manifest file formats for the different [[S:MyLanguage/Extension types (technical definitions)|types of extensions]], allowing each type to access the full power of the Joomla! installer.</translate>

<translate>
==Naming conventions== 
</translate>
<translate>
The file must be named <tt>manifest.xml</tt> (only Joomla versions 2.5 and 3!) or <tt><extension_name>.xml</tt> (Joomla versions 2.5, 3 and 4) and located in the root directory of the installation package.</translate>

<translate> Joomla 4.x: Automatic namespace mapping will fail if a manifest file named <tt>manifest.xml</tt> is used. See: https://github.com/joomla/joomla-cms/issues/37750</translate>

<translate>

==Syntax== 
</translate>

<translate>
=== Root element === 
</translate>
<translate>
{{notice|title=General Information|The new tag <code><extension></code> replaces the old <code><install></install></code> from Joomla {{JVer|1.5}}</translate>}}

<translate>
The primary tag of the installation file is:</translate>
<source lang=xml><extension></extension></source>

<translate>
This starting and closing tag is the same for all extensions. The following attributes are allowed within the tag:</translate>

{|class="wikitable"
|-
! style="width: 150px" | <translate>
Attribute</translate> || style="width: 150px" | <translate>
Values</translate> || <translate>
Applicable to</translate> || <translate>
Description</translate>
|-
| type || <code>component</code><br /><code>file</code><br /><code>language</code><br /><code>library</code><br /><code>module</code><br /><code>package</code><br /><code>plugin</code><br /><code>template</code><br/><code>element</code> || <translate>
All extensions</translate>
| <translate>
This attribute describes the type of the extension for the installer. Based on this type further requirements to sub-tags apply.</translate>
|-
| version
| <code>2.5</code><br /><code>3.0</code> || <translate>
All extensions</translate>
| <translate>
String that identifies the version of Joomla for which this extension is developed. This is not used in {{JVer|3.x}} and has been removed from {{JVer|4.0}} and higher.</translate>
|-
| method
| <code>install</code><br /><code>upgrade</code> || <translate>
All extensions</translate>
| <translate>
The default value <code>install</code> will be also used if the method attribute is not used. The <code>install</code> value means the installer will gracefully stop if it finds any existing file/folder of the new extension.</translate>
|-
| client
| <code>site</code><br /><code>administrator</code> || <translate>
Modules</translate>
| <translate>
The client attribute allows you to specify for which application client the new module is available.</translate>
|-
| group
| ''string'' || <translate>
Plugins</translate>
| <translate>
The group name specifies for which group of plugins the new plugin is available. The existing groups are the folder names within the directory <tt>/plugins</tt>. The installer will create new folder names for group names that do not exist yet.</translate>
|}

<translate>
=== Metadata === 
</translate>

<translate>
The following elements can be used to insert metadata. None of these elements are required; if they are present, they must be a child of the root element.</translate>

<pre>
<name> – raw component name (e.g. com_banners).
<author> – author's name (e.g. Joomla! Project)
<creationDate> – date of creation or release (e.g. April 2006)
<copyright> – a copyright statement (e.g. (C) 2005 - 2011 Open Source Matters. All rights reserved.)
<license> – a license statement (e.g. NU General Public License version 2 or later; see LICENSE.txt)
<authorEmail> – author's email address (e.g. admin@joomla.org)
<authorUrl> – URL to the author's website (e.g. www.joomla.org)
<version> – the version number of the extension (e.g. 1.6.0)
<description> – the description of the component. This is a translatable field. (e.g. COM_BANNERS_XML_DESCRIPTION)
<element> – the internal name of the component. If omitted, name will be cleaned and used
</pre>

<translate>
Note: The <name> and <description> tags are also translatable fields so that the name and description of the extension can be shown to the user in their native language.</translate>

<translate>=== Front-end files === </translate>

<source lang="xml">
<files folder="from-folder">
<filename>example.php</filename>
<folder>examples</folder>
</files>
</source>

<translate>
Files to copy to the front-end directory should be placed in the <code><files></code> element. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from'''. Each file to copy must be represented by a <code><filename></code> element. If you want to copy an entire folder at once, you can define it as a <code><folder></code>.</translate>

<translate>

For '''plugins''', the raw name of the plugin should be placed in the <code>plugin</code> attribute on the <code><filename></code> element that points to the file containing the plugin's class. For example, in the case of a system plugin called "example" (full name <code>plg_system_example</code>), use <code><filename plugin="example">example.php</filename></code>.</translate>

<translate>=== Media files === </translate>

<source lang="xml>
<media folder="media" destination="com_example">
<filename>com_example_logo.png</filename>
<folder>css</folder>
<folder>js</folder>
</media>
</source>

<translate>
This example will copy the file(s) (<tt>/media/com_example_logo.png</tt>) and folders ( <tt>/media/css/</tt> and <tt>/media/js/</tt> ) listed to <tt>/media/com_example/</tt>, creating the <tt>com_example</tt> folder if required. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from''' (in this case, <tt>media</tt>).</translate>

<translate>
Extensions should be storing assets they need to be web accessible (JS, CSS, images etc) in <code>media</code>. Amongst other things this feature was added as step in the progression to multi-site support and the eventual move of code files (PHP) out of the web accessible areas of the server.<br />
Note: the media section is not parsed for 'package' type extensions.</translate>

Ref:
* [https://groups.google.com/forum/#!msg/joomla-dev-cms/4CAASJqFY-k/PvPj14gP29EJ Google Groups - joomla-dev-cms thread]
* [https://groups.google.com/forum/#!msg/joomla-dev-cms/uNmhX98sKbE/p8p68Jke680J Google Groups - joomla-dev-cms thread]

<translate>
=== Administration section === 
</translate>

<source lang="xml">
<administration>

</administration>
</source>

<translate>
The administration section is defined in the <code><administration></code> element. Since only [[S:MyLanguage/Component|components]] apply to both the [[S:MyLanguage/Site (Application)|site]] and the [[S:MyLanguage/Administrator (Application)|administrator]], '''only component manifests can include this element'''.</translate>

<translate>
==== Back-end Files ==== 
</translate>

<translate>
Files to copy to the back-end directory should be placed in the <code><files></code> element under the <code><administration></code>. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from'''. See ''Front-end files'' for further rules.</translate>

<translate>
==== Menu Links and Submenus ==== 
</translate>
{{dablink|<translate>
'''Version Note:''' Prior to Joomla 3.4, not having a <code><nowiki><menu></nowiki></code> tag in your manifest XML file still led to a menu item being created. This bug was fixed in Joomla 3.4, so if there is no <code><nowiki><menu></nowiki></code> tag in your manifest file, then no admin menu item is created for the component.</translate>}}

<source lang="xml">
<menu>COM_EXAMPLE</menu>
<submenu>

<menu link="anoption=avalue&anoption1=avalue1">COM_EXAMPLE_SUBMENU_ANOPTION</menu>
<menu view="viewname">COM_EXAMPLE_SUBMENU_VIEWNAME</menu>
</submenu>
</source>

<translate>
The text for the main menu item for the component is defined in the <code><menu></code> item, a child of <code><administration></code>. A <code><submenu></code> element may also be present (also a child of <code><administration></code>), which may contain more menu items defined by <code><menu></code>.</translate>

<translate>
Additionally, each <code><menu></code> item can define the following attributes:</translate>

{| class="wikitable"
! style="width: 150px" | <translate>
Attribute</translate> || <translate>
Description</translate>
|-
| link || <translate>
A link to send the user to when the menu item is clicked. You can use "view" instead.</translate>
|-
| img || <translate>
The (relative) path to an image (16x16 pixels) to appear beside the menu item.
<u>Must be an url compatible as a file too (e.g. no spaces) !</u></translate>
|-
| alt ||
|-
| view || <translate>
An URL parameter to add to the link. For example, <code><menu view="cpanel">COM_EXAMPLE</menu></code> in com_example's XML manifest would cause the URL of the menu item to be <tt>index.php?option=com_example&view=cpanel</tt>. You can use "link" instead.</translate>
|-
|}

<translate>
The value inside the tag is the menu's label. Unlike Joomla! 1.5, you can not use a natural language string. For example, if you would enter "Example Component" instead of COM_EXAMPLE, it would result in your component name appearing as example-component in the menu and you would be unable to provide a translation. In order to provide a translation you need to create a file named en-GB.com_example.sys.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation) or in administrator/components/com_example/language/en-GB. In the latter case, you must not include the translation file in the <code><languages></code> tag. As long as you have placed the language directory in your <code><files></code> tag, it will be copied along when the component is being installed.</translate>

<translate>
The contents of that file should be:</translate>

<source lang="ini">
COM_EXAMPLE="Example Component"
COM_EXAMPLE_SUBMENU_ANOPTION="Another Option"
COM_EXAMPLE_SUBMENU_VIEWNAME="Another View"
</source>

<translate> Please note that the language string must be enclosed in double quotes, as per Joomla!'s translation standards.</translate>

{{note|<translate> Joomla! 1.6 and later sorts the Component menu items based on the actual translation of the key you supply in your XML manifest. This means that the sorting order is correct no matter what you call your translation key and no matter which language the site is being displayed in. Essentially, Joomla! 1.6 fixed the wrong sorting of the Components menu experienced under Joomla! 1.5 for the majority (non-English speaking!) of Joomla! users.</translate>}}

<translate>
=== Dashboards ===  </translate>
<translate>
{{notice|title=General Information|This code only works in {{JVer|4.0}} and later</translate>}}

<translate> Specifies the details for displaying a dashboard for the component in the Administrator area for the site.</translate>
<translate>

* It will make a dashboard icon appear next to the administrator menu item for the component
* The dashboard icon will click through to display modules assigned to the cpanel-example administrator module position
* The title and icon defined in the XML file will be used as the header and icon at the top of the component's dashboard page.</translate>

<source lang="xml">
<dashboards>
<dashboard title="COM_EXAMPLE_DASHBOARD_TITLE" icon="icon-lock">example</dashboard>
</dashboards>
</source>

<translate>
=== Configuration === 
</translate>
<translate>
{{warning|title=Warning!|Components '''do not support''' configuration definitions '''in the manifest'''. This was a way implemented in Joomla! 1.5. They can define configuration options for multiple levels using the config.xml file. For how to add this to your component read the [[S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_configuration|Developing an MVC Component tutorial]].</translate>}}
<translate>
The <code><config></code> element, a child of the root, describes the configuration options for the extension. If applicable, the options will be shown by the appropriate Manager (Plugin Manager, Module Manager or Template Manager). '''Configuration options for Components are defined in a separate file named <code>config.xml</code>. Its root element should be <code><config></code>, plugins and modules use the <code><config></code> section in the extension manifest file.'''</translate>

<translate>
Each fieldset must contain one or more <code><field></code> elements, each representing a single [[S:MyLanguage/form field|form field]] with a label. See [[S:MyLanguage/Standard form field types|Standard form field types]] for a list of allowed form field types and example XML form field definitions.</translate>

<translate>
=== Namespace ===  </translate>
<translate>
{{notice|title=General Information|This code only works in {{JVer|4.0}} and later</translate>}}

<translate> Specify the namespace to be used for autoloading the plugin. The given namespace will autoload to the root directory of your extension by default however you can optionally add a "path" attribute to the namespace element to specify a subpath within your extensions root directory.</translate>

<translate>
=== SQL === 
</translate>

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">sql/example.install.sql</file>
</sql>
</install>
<uninstall>
<sql>
<file driver="mysql" charset="utf8">sql/example.uninstall.sql</file>
</sql>
</uninstall>
</source>

<translate>
In the above example, we put the SQL files in the <tt>admin/sql</tt> folder of the installation package. You have to include the <tt>sql</tt> folder in the administration files (as described in ''Back-end files'').</translate>

<translate>
You can execute SQL during the installation and/or uninstallation using the <code><install></code> and <code><uninstall></code> elements, respectively. A <code><sql></code> element should appear as a child of these elements. <code><sql></code> can contain any number of <code><file></code> elements, each defining a single SQL file to execute. Their database driver types are described by the <code>driver</code> attribute, their character sets by the <code>charset</code> attribute.</translate>

<translate>
==== Update of the SQL Schema ==== 
</translate>

<translate>
Since 1.6, there is also an <code><update></code> tag, which allows you to provide a series of SQL files to update the current schema.</translate>

<source lang="xml">
<update>
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
<schemapath type="sqlsrv">sql/updates/sqlsrv</schemapath>
</schemas>
</update>
</source>

<translate>
For example, in order to go from version <code>1.0.0</code> to version <code>1.0.1</code> in a '''MySQL''' database, a <code>1.0.1.sql</code> file must be created inside the <code>sql/updates/mysql</code> folder and the <code><version></code> tag of the manifest must be updated to</translate>
<source lang="xml">
<version>1.0.1</version></source>

<translate>
The final structure of the sql folder will look like this (assuming a '''MySQL''' database)</translate>
<source lang="xml">
sql
|-->example.install.sql
|-->example.uninstall.sql
|-->updates
|-->mysql
|-->1.0.1.sql</source>

<translate>
Similar files must be created for subsequent versions.</translate>

<translate>
=== Language Files === 
</translate>
<translate>
Since Joomla! 1.5, extension developers had to put extension language files in the Joomla! main language folder using the <languages>...</languages> tag as shown below. '''This method can still be used all Joomla! versions'''.</translate>

<source lang="xml">

<languages folder="langfiles">
<language tag="en-GB">en-GB.com_example.ini</language>
</languages>
</source>

<translate>
However since Joomla! 1.6 it is recommended that you place your extension's language files in your extension folder. Joomla! will then automatically load your extension's language files.</translate>

<translate>
By storing extension language files in the extension folder, you benefit by isolating and protecting your extension's language files. For example, an administrator removes a language from their Joomla! installation. Your extension's language files will not be removed. They will remain in place and will be available if the language is installed again.</translate>

<translate>
The structure of the language folder for frontend and backend is the same. You put them in the language tag (e.g. '''en-GB''' ) of each language in your language folder, i.e. '''language/en-GB/'''. You have to specify those folders in the front-end and back-end files too.</translate>

<translate>
In your manifest, simply include the ''''language'''' folder in your files section. The sub-directories for each language will automatically be copied. Inside the <files> group, add a <folder> element alongside the items in the '''<files>''' group as shown in this example:</translate>

<source lang="xml">
<files>
<filename plugin="alpha">alpha.php</filename>
<folder>sql</folder>
<folder>language</folder>
</files>
</source>

<translate>
Note that both ways can work together. Here is an example from core:</translate>

<source lang="xml">
<files>
<filename plugin="languagecode">languagecode.php</filename>
<filename>index.html</filename>
<folder>language</folder>
</files>
<languages>
<language tag="en-GB">language/en-GB/en-GB.plg_system_languagecode.ini</language>
<language tag="en-GB">language/en-GB/en-GB.plg_system_languagecode.sys.ini</language>
</languages>
</source>

<translate>
The advantages of this solution are the following:</translate>

<translate>
All ''.ini'' files present in the core folder have precedence over the files in the extension ''language/'' folder.
For example, a ''.sys.ini'' file will always be loaded from core folders in the back-end if it exists, except when installing an extension which contains a ''.sys.ini'' file in a language folder. In that case and only that case, the ''.sys.ini'' file in the extension folder will display its translated content at install time. This is very handy. As a developer can have two ''.sys.ini'' files with different contents.</translate>

<translate>
Also, it is much easier for a user needing an ''.ini'' file for an extension that does not provide it in the language desired to add it in the main folders. There is no risk that it will be deleted in case of uninstalling the extension by mistake or any other reason.</translate>

<translate>
See also:
*[[S:MyLanguage/J2.5:Making non-core language packs|Making non-core language packs]]
*[[S:MyLanguage/Creating language packs for extensions in Joomla 2.5|Creating language packs for extensions in Joomla 2.5]]</translate>

<translate>
During development you can turn on language debugging in the Joomla! global configuration. You can investigate if a problem arises. As of 3.2, this is necessary to help debug as en-GB is '''always''' loaded first when not in debug mode to prevent displaying Constants.</translate>

<translate>
=== Script file === 
</translate>

<source lang="xml">
<scriptfile>example.script.php</scriptfile>
</source>

<translate>
An optional '''script file''' (PHP code that is run before, during and/or after installation, uninstallation and upgrading) can be defined using a <code><scriptfile></code> element.</translate>

<translate>
This file should contain a class named "<element_name>InstallerScript" where <element_name> is the name of your extension (e.g. com_componentname, mod_modulename, etc.). Plugins must state the group (e.g. plgsystempluginname).</translate>

<translate>
In {{JVer|4.0}} and later the structure of the class is as follows:</translate>

<source lang="php">

<?php

use Joomla\CMS\Installer\InstallerAdapter;

class com_componentnameInstallerScript
{
/**
* Constructor
*
* @param InstallerAdapter $adapter The object responsible for running this script
*/
public function __construct(InstallerAdapter $adapter)
{
}

/**
* Called before any type of action
*
* @param string $route Which action is happening (install|uninstall|discover_install|update)
* @param InstallerAdapter $adapter The object responsible for running this script
*
* @return boolean True on success
*/
public function preflight($route, InstallerAdapter $adapter)
{
return true;
}

/**
* Called after any type of action
*
* @param string $route Which action is happening (install|uninstall|discover_install|update)
* @param InstallerAdapter $adapter The object responsible for running this script
*
* @return boolean True on success
*/
public function postflight($route, $adapter)
{
return true;
}

/**
* Called on installation
*
* @param InstallerAdapter $adapter The object responsible for running this script
*
* @return boolean True on success
*/
public function install(InstallerAdapter $adapter)
{
return true;
}

/**
* Called on update
*
* @param InstallerAdapter $adapter The object responsible for running this script
*
* @return boolean True on success
*/
public function update(InstallerAdapter $adapter)
{
return true;
}

/**
* Called on uninstallation
*
* @param InstallerAdapter $adapter The object responsible for running this script
*/
public function uninstall(InstallerAdapter $adapter)
{
return true;
}
}

?>
</source>

<translate> Note that since Joomla 3.6 Joomla has shipped a basic script that you can use instead of shipping your own from scratch '''JInstallerScript''' which contains various helper methods commonly used through the community.</translate>

<translate>
=== Library Manifests ===  </translate>
<translate>
{{notice|title=General Information|The section is based on {{JVer|4.0}} and later</translate>}}

<translate> A simple library manifest might look like this:</translate>
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension type="library" method="upgrade" version="4.0">
<name>My Test library.</name>
<libraryname>mytest</libraryname>
<files>
<folder>Classes</folder>
<folder>language</folder>
<filename>mytest.php</filename>
</files>
</extension></source>

<translate> This will install the library into the <tt>JPATH_SITE/libraries/mytest</tt> folder.</translate>

<translate> What if your company has several libraries and you want to group them together under folder <tt>JPATH_SITE/libraries/mycompany</tt>?</translate>

<translate> Simple - include your company name in the <tt>libraryname</tt> property of each library like this:</translate>

<source lang="xml">
<libraryname>mycompany/mylibrary1</libraryname>
</source>

<source lang="xml">
<libraryname>mycompany/mylibrary2</libraryname>
</source>

<translate> These libraries will then be installed in the <tt>JPATH_SITE/libraries/mycompany/mylibrary1</tt> and <tt>JPATH_SITE/libraries/mycompany/mylibrary2</tt> folders.</translate>

<translate> Uninstalling <tt>mylibrary1</tt> will still leave <tt>mylibrary2</tt> installed on your site.</translate>

<translate> When using <tt>script files</tt> with such company libraries the installer class name should look like this:</translate>
<source lang="php">
class mycompanymylibrary1InstallerScript
</source>
<source lang="php">
class mycompanymylibrary2InstallerScript
</source>

<translate>
=== Update Servers === 
</translate>

<source lang="xml">
<updateservers>
<server type="extension" priority="1" name="Extension Update Site">http://example.com/extension.xml</server>
<server type="collection" priority="2" name="Collection Update Site">http://example.com/collection.xml</server>
</updateservers>
</source>

<translate>
Update servers can be defined in the <code><updateservers></code> element, a child of the root. This element may contain one or more <code><server></code> element, each describing the location from which to download updates. Each <code><server></code> item can define the following attributes:</translate>

{| class="wikitable"
! style="width: 150px" | <translate>
Attribute</translate> || style="width: 150px" | <translate>
Values</translate> || <translate>
Description</translate>
|-
| type || <code>extension</code><br /><code>collection</code> || <translate>
The update server type</translate>
|-
| priority || ''integer'' || <translate>
The priority of the update server</translate>
|-
| name || ''string'' || <translate>
The name of the update server</translate>
|}

<translate>
More info:
* [[S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_an_update_server|Building a Joomla! Extension - Adding an update server]]
* [[S:MyLanguage/J2.5:Managing Component Updates|Managing Component Updates in Joomla 2.5]]</translate>

<translate>=== Supporting Download Keys === </translate>

<translate> As of Joomla 4.0.0 users can enter their download keys in the Update Sites list. This gives them a single place to manage the download keys. When a user is going to update an extension, Joomla will check if there is a download key. If there is a download key, Joomla will add the download key to the update URL.</translate>

<translate> To support download keys you must include the <tt>dlid</tt> tag in the manifest file. The <tt>dlid</tt> tag takes 2 arguments:</translate>
<translate>

* prefix
* suffix
</translate>

<translate> The <tt>dlid</tt> tag will look like this in your manifest file:</translate>
<source lang="xml">
<dlid prefix="dlid=" suffix="&dummy=my.zip"/>
</source>

<translate> The prefix will be added before the download key and the suffix after the download key. Using the example above the full query added to the download link will be:</translate>
<source lang="php">
dlid=KEY&dummy=my.zip
</source>

<translate> The key is added before the <tt>onInstallerBeforePackageDownload</tt> event is triggered, so the full URL will be passed to the event.</translate>

<translate>
== Examples == 
</translate>
<translate>
For a real-life example, see [https://github.com/joomla/joomla-cms/blob/3.9.16/administrator/components/com_banners/banners.xml the manifest of the Banner component in the latest version of Joomla! 3.9.16].</translate>

<translate>
Some more examples can be found in the standalone weblinks repo:</translate>

<translate>
* [https://github.com/joomla-extensions/weblinks/blob/master/src/administrator/components/com_weblinks/weblinks.xml com_weblinks manifest]
* [https://github.com/joomla-extensions/weblinks/blob/master/src/modules/mod_weblinks/mod_weblinks.xml mod_weblinks manifest]
* [https://github.com/joomla-extensions/weblinks/blob/master/src/plugins/search/weblinks/weblinks.xml plg_search_weblinks manifest]
* [https://github.com/joomla/joomla-cms/blob/3.9.16/templates/protostar/templateDetails.xml tpl_protostar manifest (3.9.16)]
* [https://github.com/joomla/joomla-cms/blob/3.9.16/administrator/language/en-GB/en-GB.xml en-GB manifest (3.9.16)]</translate>

<noinclude>
[[Category:Development{{#translation:}}]]
[[Category:Extension development{{#translation:}}]]
[[Category:Specifications{{#translation:}}]]
</noinclude>

J3.x:Using the JToolbar class in the frontend

2016-12-06T10:17:25Z

HermanPeeren: added components/com_content/views/form/tmpl/edit.php as example of defining buttons in frontend view-template

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div>
</source>

This is how it is done with frontend editing in com_content at the moment, see https://github.com/joomla/joomla-cms/blob/staging/components/com_content/views/form/tmpl/edit.php#L151-L167

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

== Routing and SEF URLs ==

Usually in the frontend Search Engine Friendly (SEF) URLs are used. This is different from the backend and can give some bugs. You'll have to adjust the router.php of your component.

ToDo: give an example problem and solution.
{{underconstruction}}

== Include some stylesheets and language files from the backend ==
To properly horizontally align the buttons and to get translations of buttons as defined in backend.
{{underconstruction}}

== Custom frontend buttons ==
{{underconstruction}}

[[Category:Development]]
[[Category:Joomla!_3.x]]
[[Category:Component_Development]]
[[Category:Extension_development]]

J3.x:Using the JToolbar class in the frontend

2016-12-06T10:08:03Z

HermanPeeren: also add some language files

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div>
</source>

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

== Routing and SEF URLs ==

Usually in the frontend Search Engine Friendly (SEF) URLs are used. This is different from the backend and can give some bugs. You'll have to adjust the router.php of your component.

ToDo: give an example problem and solution.
{{underconstruction}}

== Include some stylesheets and language files from the backend ==
To properly horizontally align the buttons and to get translations of buttons as defined in backend.
{{underconstruction}}

== Custom frontend buttons ==
{{underconstruction}}

[[Category:Development]]
[[Category:Joomla!_3.x]]
[[Category:Component_Development]]
[[Category:Extension_development]]

J3.x:Using the JToolbar class in the frontend

2016-12-04T15:38:03Z

HermanPeeren: /* Routing and SEF URLs */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div>
</source>

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

== Routing and SEF URLs ==

Usually in the frontend Search Engine Friendly (SEF) URLs are used. This is different from the backend and can give some bugs. You'll have to adjust the router.php of your component.

ToDo: give an example problem and solution.
{{underconstruction}}

== Include some stylesheets from the backend ==
To properly horizontally align the buttons.
{{underconstruction}}

== Custom frontend buttons ==
{{underconstruction}}

[[Category:Development]]
[[Category:Joomla!_3.x]]
[[Category:Component_Development]]
[[Category:Extension_development]]

J3.x:Using the JToolbar class in the frontend

2016-12-04T13:31:36Z

HermanPeeren: added another under construction section (stylesheets to horizontally align the buttons)

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div>
</source>

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

== Routing and SEF URLs ==

Usually in the frontend Search Engine Friendly (SEF) URLs are used. This is different from the backend and can give some bugs, especially with link-buttons. You'll have to adjust the router.php of your component.
{{underconstruction}}

== Include some stylesheets from the backend ==
To properly horizontally align the buttons.
{{underconstruction}}

== Custom frontend buttons ==
{{underconstruction}}

[[Category:Development]]
[[Category:Joomla!_3.x]]
[[Category:Component_Development]]
[[Category:Extension_development]]

J3.x:Using the JToolbar class in the frontend

2016-12-04T09:04:19Z

HermanPeeren: Added some categories and 2 sections under construction (routing and front end buttons).

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div>
</source>

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

== Routing and SEF URLs ==

Usually in the frontend Search Engine Friendly (SEF) URLs are used. This is different from the backend and can give some bugs, especially with link-buttons. You'll have to adjust the router.php of your component.
{{underconstruction}}

== Custom frontend buttons ==
{{underconstruction}}

[[Category:Development]]
[[Category:Joomla!_3.x]]
[[Category:Component_Development]]
[[Category:Extension_development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T13:10:03Z

HermanPeeren: /* Or define the toolbar buttons without using JToolbar */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div>
</source>

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T13:08:16Z

HermanPeeren: /* Or define the toolbar buttons without using JToolbar */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

You can use Joomla.submitbutton('yourtask') to submit the task you want to. The Joomla javascript to handle this is included in the template head via: <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T13:01:34Z

HermanPeeren: /* Or define the toolbar buttons without using JToolbar */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

Define your own html, directly in the view template (or via a getToolbar-method in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:59:30Z

HermanPeeren: /* Step 2: echo the rendered toolbar in the view template */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
In the view template, where you want to display the toolbar, echo the rendered toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:56:34Z

HermanPeeren: /* What is different in the frontend if you want to use a toolbar? */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or directly call JToolbar to code the toolbar or include JToolbarHelper
* render the toolbar
* echo the rendered toolbar in the view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:53:56Z

HermanPeeren: /* How is it done in the backend? */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class has a collection of static methods that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or include JToolbarHelper or directly call JToolbar to code the toolbar
* render the toolbar
* echo the rendered toolbar in our view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:46:14Z

HermanPeeren: /* Step 1: define a toolbar */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class is a collection of static functions that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or include JToolbarHelper or directly call JToolbar to code the toolbar
* render the toolbar
* echo the rendered toolbar in our view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

// Generate the html and return
// The toolbar is named "toolbar" if you use JToolbarHelper
return JToolBar::getInstance('toolbar')->render();
}
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolBar class in the frontend

2016-12-03T12:30:10Z

HermanPeeren: HermanPeeren moved page J3.x:Using the JToolBar class in the frontend to J3.x:Using the JToolbar class in the frontend: JToolbar was misspelled as JToolBar

#REDIRECT [[J3.x:Using the JToolbar class in the frontend]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:30:09Z

HermanPeeren: HermanPeeren moved page J3.x:Using the JToolBar class in the frontend to J3.x:Using the JToolbar class in the frontend: JToolbar was misspelled as JToolBar

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class is a collection of static functions that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or include JToolbarHelper or directly call JToolbar to code the toolbar
* render the toolbar
* echo the rendered toolbar in our view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Make a toolbar (you'll have to name it "toolbar" if you use JToolbarHelper)
$bar = JToolBar::getInstance('toolbar');

// include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

//generate the html and return
return $bar->render();
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:21:20Z

HermanPeeren: /* How is it done in the backend? */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class is a collection of static functions that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton() and prependButton() methods to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or include JToolbarHelper or directly call JToolbar to code the toolbar
* render the toolbar
* echo the rendered toolbar in our view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Make a toolbar (you'll have to name it "toolbar" if you use JToolbarHelper)
$bar = JToolBar::getInstance('toolbar');

// include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

//generate the html and return
return $bar->render();
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T12:18:55Z

HermanPeeren: /* Or define the toolbar buttons without using JToolbar */

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class is a collection of static functions that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton()and prependButton() methods to to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or include JToolbarHelper or directly call JToolbar to code the toolbar
* render the toolbar
* echo the rendered toolbar in our view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Make a toolbar (you'll have to name it "toolbar" if you use JToolbarHelper)
$bar = JToolBar::getInstance('toolbar');

// include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

//generate the html and return
return $bar->render();
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

J3.x:Using the JToolbar class in the frontend

2016-12-03T11:08:34Z

HermanPeeren: Added some background how a toolbar is made in backend and how frontend differs.

{{RightTOC}}

== How is it done in the backend? ==

In the backend Joomla displays a toolbar by using the following procedure:

* In the main administrator/index.php the '''JToolbarHelper''' class is included: <source lang="php">
require_once JPATH_BASE . '/includes/toolbar.php';</source>
* this JToolbarHelper class is a collection of static functions that mainly call JToolbar-methods. JToolbarHelper is used by programmers to code the toolbar in the view.
* '''JToolbar''' is the class (in libraries/cms/toolbar/toolbar.php) that actually makes the toolbar. It has a getInstance()-method to create one (and store it statically), appendButton()and prependButton() methods to to add buttons to that toolbar and a render()-method to produce the html to display the toolbar.
* In the backend there is a module mod_toolbar that is displayed in the "toolbar" position of the administrator template. The module echos the rendered toolbar: <source lang="php">
$toolbar = JToolbar::getInstance('toolbar')->render('toolbar');</source>

== What is different in the frontend if you want to use a toolbar? ==

In the frontend we '''don't have''':

* JToolbarHelper included in the index.php
* a module that renders the toolbar
* a moduleposition "toolbar" in the template

So, in order to use a toolbar in the frontend, we have to provide the missing things ourselves:

* or include JToolbarHelper or directly call JToolbar to code the toolbar
* render the toolbar
* echo the rendered toolbar in our view template

Alternatively we can directly code toolbar-buttons ourselves instead of using JToolbar.

== Using JToolbar in the frontend ==

We have to do it in 2 steps: we define a toolbar and we echo the rendered toolbar in our view template

{{clear}}
===Step 1: define a toolbar===
Add the rendered toolbar to your view.html.php file in the view you wish to add the toolbar to.

Add a getToolbar() function to your view. Here we do it by directly calling JToolbar:
<source lang="php>
protected function getToolbar()
{
// Make a toolbar (you can give it any name if you do it this way)
$bar = JToolBar::getInstance('toolbar');

// Add whatever buttons you require
$bar->appendButton( 'Standard', 'save', 'Save', 'yourviewname.save', false );
$bar->appendButton( 'Separator' );
$bar->appendButton( 'Standard', 'cancel', 'Cancel', 'yourviewname.cancel', false );

//generate the html and return
return $bar->render();
}
</source>

Alternatively you could include JToolbarHelper and define the buttons the same way as you do it in the backend. But you'll still have to render the toolbar:
<source lang="php">
protected function getToolbar()
{
// Make a toolbar (you'll have to name it "toolbar" if you use JToolbarHelper)
$bar = JToolBar::getInstance('toolbar');

// include JToolbarHelper
require_once JPATH_ADMINISTRATOR . '/includes/toolbar.php';

// Add whatever buttons you require
JToolBarHelper::save('yourviewname.save');
JToolbarHelper::divider();
JToolBarHelper::cancel('yourviewname.cancel');
JToolbarHelper::divider();

//generate the html and return
return $bar->render();
</source>

===Step 2: echo the rendered toolbar in the view template===
Where you want to display the toolbar:
<source lang="php">
<form action="index.php" method="post" id="adminForm" name="adminForm">
<?php echo $this->getToolbar(); ?>
<input type = "hidden" name = "task" value = "" />
<input type = "hidden" name = "option" value = "com_yourcom" />
</form>
<div class="clr"></div>
</source>

== Or define the toolbar buttons without using JToolbar ==

You can use Joomla.submitbutton() to submit the task you want to. The Joomla javascript is included in the template head via <source lang="php">
<script src="/luchtreiziger-joostrap/media/system/js/core.js"></script>
</source>

Define your own html, directly in the view template (or via a getToolbar-mentod in your view):

<source lang="php">
<div class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-primary" onclick="Joomla.
submitbutton('yourviewname.add')">
<i class="icon-new"></i> <?php echo JText::_('JNEW') ?>
</button>
</div>
</div></source>

[[Category:Development]]

JDOC:Translating Categories/nl

2016-11-08T10:08:22Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er zijn nog een paar methodes om te leren, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie-pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn leeg en bevatten alleen een bovenliggende categorie) en worden onderdeel van een bepaald categorie-project. Als de categorie juist vertaald is, dan is dat onderaan de vertaalde pagina zichtbaar als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze alinea.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels worden door Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: stel, er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien iemand de "Categorie Help"-pagina bekijkt, dan staat de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor de categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> zorgt ervoor dat de "Categorie Help"-pagina de betreffende pagina onder de letter '''H''' in plaats van '''K''' toont.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt van de pagina's uit deze categorie op sorteersleutel.

Waarom? En waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dan zou de sorteersleutel '''Listado de Control de acceso''' worden. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. Het is een kwestie van: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/15/nl

2016-11-08T10:08:22Z

HermanPeeren:

Dan zou de sorteersleutel '''Listado de Control de acceso''' worden. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. Het is een kwestie van: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

JDOC:Translating Categories/nl

2016-11-08T10:05:28Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er zijn nog een paar methodes om te leren, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie-pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn leeg en bevatten alleen een bovenliggende categorie) en worden onderdeel van een bepaald categorie-project. Als de categorie juist vertaald is, dan is dat onderaan de vertaalde pagina zichtbaar als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze alinea.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels worden door Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: stel, er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien iemand de "Categorie Help"-pagina bekijkt, dan staat de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor de categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> zorgt ervoor dat de "Categorie Help"-pagina de betreffende pagina onder de letter '''H''' in plaats van '''K''' toont.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt van de pagina's uit deze categorie op sorteersleutel.

Waarom? En waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/13/nl

2016-11-08T10:05:28Z

HermanPeeren:

Waarom? En waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

JDOC:Translating Categories/nl

2016-11-08T10:03:08Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er zijn nog een paar methodes om te leren, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie-pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn leeg en bevatten alleen een bovenliggende categorie) en worden onderdeel van een bepaald categorie-project. Als de categorie juist vertaald is, dan is dat onderaan de vertaalde pagina zichtbaar als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze alinea.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels worden door Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: stel, er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien iemand de "Categorie Help"-pagina bekijkt, dan staat de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor de categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> zorgt ervoor dat de "Categorie Help"-pagina de betreffende pagina onder de letter '''H''' in plaats van '''K''' toont.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt van de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/12/nl

2016-11-08T10:03:07Z

HermanPeeren:

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt van de pagina's uit deze categorie op sorteersleutel.

JDOC:Translating Categories/nl

2016-11-08T09:42:44Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er zijn nog een paar methodes om te leren, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie-pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn leeg en bevatten alleen een bovenliggende categorie) en worden onderdeel van een bepaald categorie-project. Als de categorie juist vertaald is, dan is dat onderaan de vertaalde pagina zichtbaar als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze alinea.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels worden door Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: stel, er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien iemand de "Categorie Help"-pagina bekijkt, dan staat de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor de categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> zorgt ervoor dat de "Categorie Help"-pagina de betreffende pagina onder de letter '''H''' in plaats van '''K''' toont.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/11/nl

2016-11-08T09:42:43Z

HermanPeeren:

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels worden door Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: stel, er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien iemand de "Categorie Help"-pagina bekijkt, dan staat de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor de categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> zorgt ervoor dat de "Categorie Help"-pagina de betreffende pagina onder de letter '''H''' in plaats van '''K''' toont.

JDOC:Translating Categories/nl

2016-11-08T09:33:05Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er zijn nog een paar methodes om te leren, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie-pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn leeg en bevatten alleen een bovenliggende categorie) en worden onderdeel van een bepaald categorie-project. Als de categorie juist vertaald is, dan is dat onderaan de vertaalde pagina zichtbaar als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze alinea.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/10/nl

2016-11-08T09:33:04Z

HermanPeeren:

Categorie-pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn leeg en bevatten alleen een bovenliggende categorie) en worden onderdeel van een bepaald categorie-project. Als de categorie juist vertaald is, dan is dat onderaan de vertaalde pagina zichtbaar als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze alinea.

JDOC:Translating Categories/nl

2016-11-08T09:26:26Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er zijn nog een paar methodes om te leren, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/8/nl

2016-11-08T09:26:25Z

HermanPeeren:

Er zijn nog een paar methodes om te leren, dus lees verder.

JDOC:Translating Categories/nl

2016-11-08T09:23:50Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er moeten nog een paar methodes geleerd worden, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/5/nl

2016-11-08T09:23:49Z

HermanPeeren:

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In het bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

JDOC:Translating Categories/nl

2016-11-08T09:22:47Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er moeten nog een paar methodes geleerd worden, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/4/nl

2016-11-08T09:22:47Z

HermanPeeren:

Categorie links lijken op standaard wiki-links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

JDOC:Translating Categories/nl

2016-11-08T09:21:54Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken net standaard wiki links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er moeten nog een paar methodes geleerd worden, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/2/nl

2016-11-08T09:21:54Z

HermanPeeren:

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat iedere 'categorie'-link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

JDOC:Translating Categories/nl

2016-11-08T09:18:39Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat, iedere 'categorie' link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken net standaard wiki links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er moeten nog een paar methodes geleerd worden, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die u niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/18/nl

2016-11-08T09:18:39Z

HermanPeeren:

Er zijn een paar dingen die u niet moet doen.

JDOC:Translating Categories/nl

2016-11-08T09:18:15Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat, iedere 'categorie' link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken net standaard wiki links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er moeten nog een paar methodes geleerd worden, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die je niet moet doen.

'''Doe dit alstublieft niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]

Translations:JDOC:Translating Categories/19/nl

2016-11-08T09:18:14Z

HermanPeeren:

'''Doe dit alstublieft niet'''

JDOC:Translating Categories/nl

2016-11-08T09:17:45Z

HermanPeeren:

<noinclude><languages /></noinclude>
Het maken van categorieën is een belangrijk onderdeel om gelijksoortige pagina's te groeperen. Het kan gebruikt worden om inhoud te vinden indien pagina's niet juist aan elkaar [[S:MyLanguage/JDOC:Translating Links|gelinkt]] zijn.

{{warning|title=Categorieën vragen om een speciale methode!|Iets waar aandacht aan moet worden besteed bij het vertalen van een pagina is dat, iedere 'categorie' link op de pagina aangevuld moet worden met de juiste taalcode. Ze moeten ook niet verward worden met een echte link.}}

==Categoriseren==

Categorie links lijken net standaard wiki links.
<pre>
[[Article]]
ten opzichte van
[[Category:Article]]
</pre>

Het verschil is het woord en de dubbele punt '''Category:''' er voor. Category: is een speciale term die gebruikt wordt om de pagina in een categorie te zetten. In bovenstaande is Article een link, Category:Article zet de pagina in de categorie Article.

De vertaling van een categorie is heel makkelijk, voeg '''/<taalcode>''' toe aan het eind van de categorienaam. Hier een paar voorbeelden.

<pre>
[[Category:Article/fr]] voor de Franse versie
[[Category:Article/nl]] voor de Nederlandse versie
</pre>

Er moeten nog een paar methodes geleerd worden, dus lees verder.

===Doe dit===
Bijvoorbeeld: Als je een pagina van het Engels naar het Spaans vertaalt (taalcode '''es''') en de pagina de volgende categorie bevat:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
Moet '''/es''' aan het eind van de categorienaam worden toegevoegd.
<pre><nowiki>[[Category:Development/es]]</nowiki></pre>

Categorie pagina's kunnen ook vertaald worden (hetgeen snel kan - de meeste zijn, behalve een bovenliggende categorie, leeg) en zijn onderdeel van een apart categorie-project als we klaar zijn. Als de categorie juist vertaald is, ziet men hem terug onder aan de vertaalde pagina als een gekleurd vierkant met witte letters. Rood betekent dat de categorie nog niet bestaat, maak je daar geen zorgen om. Zie de eerste zin in deze paragraaf.

===Sorteersleutels===
Wat zijn sorteersleutels? Sorteersleutels is de methode die Mediawiki gebruikt om de pagina's alfabetisch te sorteren op een categoriepagina. Ze worden toegevoegd na een <code>|</code> symbool. Indien gewenst kan de titel van een pagina overschreven worden. Bijvoorbeeld: er is een categorie genaamd <code><nowiki>[[Category:Help]]</nowiki></code> op de pagina '''Krijg hulp'''. Indien een persoon de "Help category" pagina bekijkt, zien ze de pagina '''Krijg hulp''' onder de letter K. Indien iemand een sorteersleutel gebruikt, <code><nowiki>[[Category:Help|H]]</nowiki></code> voor zijn categorie-link, dan zou '''Krijg hulp''' onder de letter H komen. De code <code>|H</code> vertelt de "Categorie Help" pagina om de pagina onder de letter '''H''' in plaats van '''K''' te tonen.

Alle vertalingen hebben een Engelse bronpagina URL/<taalcode>. Aangezien de bronpagina in het Engels is, zou de sorteersleutel, indien hij niet gezet wordt, automatisch de paginanaam worden. '''Krijg Hulp''' zou onder de letter K komen op de "Categorie Help" pagina. Bij normale vertalingen is het zetten van de sorteersleutel niet noodzakelijk. Momenteel wordt het slechts bij één categorie aangeraden om een sorteersleutel te zetten, [[S:MyLanguage/:Category:Glossary definitions|de categorie woordenlijst definities]]. Dit omdat er een alfabetische lijst wordt aangemaakt uit de pagina's uit deze categorie op sorteersleutel.

Waarom? en waarom niet? In sommige talen start een vertaald woord of vertaalde pagina niet met dezelfde letter als in het Engels. Bijvoorbeeld Access Control List wordt in het Spaans vertaald als, Listado de Control de acceso. De link naar de pagina "Access Control List/es" op de categorie pagina zou onder de '''A''' worden getoond, want de paginanaam en het eind van de URL is .../'''Access_Control_List/es'''. Als gebruikt wordt:

<pre>
[[Category:Glossary definitions/es|Listado de Control de acceso]]
</pre>

Dit zet de sorteersleutel op, '''Listado de Control de acceso'''. De Spaanse versie van "Access Control List/es" zou nu getoond worden onder de '''L''' op de categoriepagina. Het gebruik van de sorteersleutel is niet altijd noodzakelijk bij een vertaling. U moet antwoord geven op de vraag: moet(en) de vertaalde woord(en) alfabetisch nog steeds onder dezelfde letter getoond worden als in het Engels?

<pre>
[[Category:Glossary definitions/es|Componente]] op de Component/es pagina
versus
[[Category:Glossary definitions/es]] op de Component/es pagina
</pre>

==Wat niet te doen bij het categoriseren==

Er zijn een paar dingen die je niet moet doen.

'''Doe dit aub niet'''

Het vertalen van het woord 'Category' en de naam van de categorie.
<pre><nowiki>[[Category:Development]] in [[Categorie:Ontwikkeling]]</nowiki></pre>

Maar doe dit:

Alleen de naam van de categorie vertalen.
<pre><nowiki>[[Category:Development]] in [[Category:Ontwikkeling]]</nowiki></pre>

'''Doe dit ook niet:'''

Het gebruiken van Special:MyLanguage/ of S:MyLanguage/, dit is alleen voor links.
<pre>
[[Category:Development]]
in [[S:MyLanguage/Category:Development/nl]]
</pre>

[[Category:Documentation Translation/nl|Categorie:Documentatie vertaling]]