https://docs.sandbox.joomla.org/api.php?action=feedcontributions&feedformat=atom&user=DylisJoomla! Documentation - User contributions [en]2026-09-10T01:03:39ZUser contributionsMediaWiki 1.43.0https://docs.sandbox.joomla.org/index.php?title=JDOC:Documentation_Translators&diff=179542JDOC:Documentation Translators2015-05-09T12:28:55Z<p>Dylis: /* fr - Français - French */</p>
<hr />
<div>[[File:JDOC translation icon.png|right]]<br />
Here, people '''translating''' {{SITENAME}} can sign up as a translator. Please be sure to read the required reading list below. <br />
<br />
After you add your username to the list below under the appropriate language heading, a [[JDOC:Translation Administrators|Translation Administrator]] will assign your username translator permissions. After your username is added as a translator you can start translating! Please be on the look out for a [[Template:Translator welcome|welcome message]] with more information posted to your user talk page.{{-}}<br />
<br />
== Required Reading ==<br />
* Getting started, read [[JDOC:Page Translation Quickstart Guide|Page Translation Quickstart Guide]]<br />
* Detailed explanation of translating, [[JDOC:Page Translation Explained|Page Translation Explained]].<br />
* Our [[JDOC:Language policy|Language policy]]<br />
* [[JDOC:Translator Tips|Translator Tips]]<br />
* Having an [[JDOC:Translation Questions|issue or need help]]?<br />
<br />
{{tip|text=Dear translators! Please [[Special:TranslatorSignup|register for translator notifications about your language]]. You are placed on a list to receive notices about new/updated pages that need translation.|title=A Tip for Translators}}<br />
<br />
===Add Your Username===<br />
Add your username below under a language you want to translate and you will be added to the [[Special:ListUsers/translator|Translator user group]].<br />
<br />
===Add Your Language===<br />
If your language isn't listed below, please add it using the format:<br />
<br />
<code><lang code> - Localised language name - English language name </code><br />
<br />
Use the syntax, <code><nowiki>* {{User|YourUsername}}</nowiki> - requested</code><br />
<br />
When a Translation Administrator adds you as a translator, they will remove the "- requested" from your username.<br />
<br />
==Current Translations Teams==<br />
<br />
Documentation language codes are different from Joomla! language codes, they are ISO 639-1 2 letter code. A small quantity of 4 letter language codes are used as an exception, but these language codes are all lowercase.<br />
<br />
=== ar - عربي - arabe ===<br />
* {{User|ghilo}}<br />
<br />
=== af - Afrikaans ===<br />
*{{User|JoeSA}}<br />
<br />
=== bg - Български - Bulgarian ===<br />
* {{User|bdimov}}<br />
* {{User|Mastwd}}<br />
<br />
=== ca - Català - Catalan === <br />
* {{User|el_libre}}<br />
* {{User|Jcollver}}<br />
* {{User|Johnnydement}}<br />
<br />
=== da - Dansk - Danish ===<br />
* {{User|Jespertoender}}<br />
* {{User|rbuelund}}<br />
* {{User|tienloantran}}<br />
<br />
=== de - Deutsch - German ===<br />
* {{User|FrankyD}}<br />
* {{User|gorgonz}}<br />
* {{User|joomla-agency}}<br />
* {{User|Ka3media}}<br />
* {{User|Paterna}}<br />
* {{User|Sisko1990}}<br />
* {{User|Stefanie}}<br />
* {{User|Tkahl}}<br />
<br />
=== es - Español - Spanish ===<br />
* {{User|carcam}}<br />
* {{User|Crsanchez}}<br />
* {{User|danielperaza}}<br />
* {{User|Irene.lopez}}<br />
* {{User|isidrobaq}}<br />
* {{User|ivanramosnet}}<br />
* {{User|Javiparati}}<br />
* {{User|Jcollver}}<br />
* {{User|Leo_Soto}}<br />
* {{User|netandsoftware}}<br />
* {{User|pfvidal}}<br />
* {{User|VictorYork87}}<br />
* {{User|viena}}<br />
* {{User|Willin}}<br />
<br />
=== et - Eesti - Estonian ===<br />
* {{User|Eraser}}<br />
<br />
=== fa - فارسی - Persian ===<br />
* {{User|Grand}}<br />
* {{User|mhehm}}<br />
<br />
=== fr - Français - French ===<br />
* {{User|BerCalva}}<br />
* {{User|Daniel}}<br />
* {{User|Erix}}<br />
* {{User|MATsxm}}<br />
* {{User|Opware2000}}<br />
* {{User|Rajoz}}<br />
* {{User|Sandra97}}<br />
* {{User|Simon}}<br />
* {{User|Dylis}}<br />
<br />
=== hu - Magyar - Hungarian ===<br />
* {{User|Balazs}}<br />
<br />
=== id - Bahasa Indonesia - Indonesian ===<br />
* {{User|dw1Rianto}}<br />
* {{User|Micokelana}}<br />
* {{User|sikumbang}}<br />
<br />
=== it - Italiano - Italian ===<br />
* {{User|alexred}}<br />
* {{User|alikon}}<br />
* {{User|donato}}<br />
* {{User|nemo_bis}} (occasionally)<br />
* {{User|ste}}<br />
<br />
=== ja - 日本語 - Japanese ===<br />
* {{User|Nori}}<br />
* {{User|Richell}}<br />
* {{User|Yama}}<br />
<br />
=== nl - Nederlands - Dutch ===<br />
* {{User|Arkomat}}<br />
* {{User|bcdesign}}<br />
* {{User|Grubosoft}}<br />
* {{User|Hvdmeer}}<br />
* {{User|Lara}}<br />
* {{User|Lianne}}<br />
* {{User|marionnijhuis}}<br />
* {{User|Marnix}}<br />
* {{User|MartijnM}}<br />
* {{User|metdick}}<br />
* {{User|Mtb}}<br />
* {{User|n9iels}}<br />
* {{User|Onderzoekspraktijk}}<br />
* {{User|Rineke}}<br />
* {{User|Schrijvers123}}<br />
* {{User|slibbe}}<br />
* {{User|Stitch123}}<br />
* {{User|webmiep}}<br />
* {{User|webcatsolutions}}<br />
* {{User|wimstrik}}<br />
<br />
=== pl - Polski - Polish ===<br />
* {{User|justyna}}<br />
<br />
=== pt - Português - Portuguese ===<br />
* {{User|Djesus}}<br />
* {{User|Horus_68}}<br />
* {{User|Mansil}}<br />
<br />
=== pt-br - Português do Brasil - Brazilian Portuguese ===<br />
* {{User|Airton}}<br />
* {{User|Anabarcellos}}<br />
* {{User|Ariadnepinheiro}}<br />
* {{User|DiLeu}}<br />
* {{User|Filipetorres}}<br />
* {{User|Helvecio}}<br />
* {{User|Henrydouglas}}<br />
* {{User|Murilotimo}}<br />
<br />
=== ru - Русский - Russian ===<br />
* {{User|AlexSmirnov}}<br />
* {{User|Vyatka}}<br />
<br />
=== sv - Svenska - Swedish ===<br />
* {{User|Propellerhuvud}}<br />
* {{User|Sgagner}}<br />
<br />
=== sw - Kiswahili - Swahili ===<br />
* {{User|Ayeko}}<br />
<br />
=== th - ไทย - Thai ===<br />
* {{User|Supachai_chai}}<br />
<br />
=== tr - Türkçe - Turkish ===<br />
* {{User|Enes}}<br />
* {{User|Ugur}}<br />
* {{User|Umitkenan}}<br />
<br />
=== ur - ur-PK - اردو - Urdu Pakistan ===<br />
<br />
=== vi - Tiếng Việt - Vietnamese ===<br />
* {{User|huyhoa}}<br />
<br />
=== zh - 中文 - Chinese ===<br />
* {{User|eyesofkids}}<br />
* {{User|Zhang19min88}}<br />
<br />
<br />
==Translation Administrators==<br />
<br />
The responsibilities of a Translation Administrator will require slightly more attention to the documents for translation. Translation Administrators should feel comfortable with using wiki markup, made hundreds of contributions to their specific language and assisted others in translation of docs. Administrators will need to check the documentation every few days and perform any required tasks. These tasks include re-marking pages in en-GB with edit changes, tracking language units which need translation and welcoming new translators. Ideally, we should have at least one Translation Administrator who will not be tied to any specific language and when the time comes, one Translation Administrator for active language teams. [[JDOC_talk:Documentation Translators|Volunteer as a Translation Administrator here]].<br />
<br />
===Current Volunteer Translation Administrators===<br />
{{:Special:ListUsers/translationadmins}}<br />
<br />
==Common Language Codes==<br />
<div class="small-4 columns"> afr - Afrikaans - Afrikaans<br />
</div><div class="small-4 columns"> ar - عربي - Arabic<br />
</div><div class="small-4 columns"> bg - Български - Bulgarian<br />
</div><div class="small-4 columns"> bg - Български - Bulgarian<br />
</div><div class="small-4 columns"> bn - বাংলা - Bengali<br />
</div><div class="small-4 columns"> bo - བོད་ཡིག - tibetan<br />
</div><div class="small-4 columns"> ca - Català - Catalan<br />
</div><div class="small-4 columns"> ce - Nohçi - Chechen<br />
</div><div class="small-4 columns"> da - Dansk - Danish<br />
</div><div class="small-4 columns"> de - Deutsch - German<br />
</div><div class="small-4 columns"> es - Español - Spanish<br />
</div><div class="small-4 columns"> fa - فارسی - Persian<br />
</div><div class="small-4 columns"> fi - - Finnish<br />
</div><div class="small-4 columns"> fr - Français - French<br />
</div><div class="small-4 columns"> hu - Magyar - Hungarian<br />
</div><div class="small-4 columns"> hy - Հայերեն - Armenian<br />
</div><div class="small-4 columns"> id - Bahasa Indonesia - Indonesian<br />
</div><div class="small-4 columns"> is - Íslenska - Icelandic<br />
</div><div class="small-4 columns"> it - Italiano - Italian<br />
</div><div class="small-4 columns"> ja - 日本語 - Japanese<br />
</div><div class="small-4 columns"> ko - 한국어 - Korean<br />
</div><div class="small-4 columns"> lb - Lëtzebuergesch - Luxembourgish<br />
</div><div class="small-4 columns"> min - Baso Minangkabau - Minang<br />
</div><div class="small-4 columns"> ml - liviox alvax - Malayalam<br />
</div><div class="small-4 columns"> mr - मराठी - Marathi<br />
</div><div class="small-4 columns"> ms - Bahasa Melayu - Malay<br />
</div><div class="small-4 columns"> nl - Nederlands - Dutch<br />
</div><div class="small-4 columns"> pl - Polski - Polish<br />
</div><div class="small-4 columns"> pt - Português - Portuguese<br />
</div><div class="small-4 columns"> pt-br - Português do Brasil - Brazilian Portuguese<br />
</div><div class="small-4 columns"> ro - Română - Romanian<br />
</div><div class="small-4 columns"> ru - Русский - Russian<br />
</div><div class="small-4 columns"> sl - Slovenščina - Slovenianjtökók<br />
</div><div class="small-4 columns"> sq - Shqip - Albanian<br />
</div><div class="small-4 columns"> sv - Svenska - Swedish<br />
</div><div class="small-4 columns"> sw - Kiswahili - Swahili<br />
</div><div class="small-4 columns"> ta - தமிழ் - Tamil<br />
</div><div class="small-4 columns"> th - ไทย - Thai<br />
</div><div class="small-4 columns"> tr - Türkçe - Turkish<br />
</div><div class="small-4 columns"> vi - Tiếng Việt - Vietnamese<br />
</div><div class="small-4 columns"> zh 中文 Chinese<br />
</div><br />
<br />
<noinclude><br />
[[Category:Documentation Wiki Policies and Guidelines]]<br />
[[Category:Documentation Translation]]<br />
</noinclude></div>Dylishttps://docs.sandbox.joomla.org/index.php?title=Testing_Joomla!_patches&diff=179469Testing Joomla! patches2015-05-09T09:59:19Z<p>Dylis: </p>
<hr />
<div><noinclude><languages /></noinclude><br />
<translate><!--T:2--><br />
In all software there are mistakes that need to be fixed, this is also the case in Open Source software like Joomla!. The source code of Joomla is centrally located on the internet, making it accessible to everyone. Besides that there is a possibility to report bugs. Reported bugs will be solved and eventually need testing. This page explains how you can contribute to the Joomla project by testing proposed solutions. You do not need to have any coding knowledge, you do need a Joomla installation to test on. <br />
A Quick Reference Guide for testing is available at: [[S:MyLanguage/Testing Joomla! patches QuickReferenceGuide|Testing Joomla! patches QuickReferenceGuide]]</translate><br />
<br />
<translate><br />
=== The Joomla staging code === <!--T:3--><br />
</translate><br />
<translate><!--T:4--><br />
The Joomla staging code is the most recent code that is being worked on. All bugfixes and new features are applied to this code.<br />
<br />
<!--T:5--><br />
The Joomla staging code is located at https://github.com/joomla/joomla-cms, this is the code that needs to be installed. How that is done is explained a little further under [[#Preparing to test|Preparing to test]].</translate><br />
<br />
<translate><br />
<br />
=== The issue-tracker === <!--T:6--><br />
</translate><br />
<translate><!--T:7--><br />
The issue-tracker for Joomla is located here: http://issues.joomla.org</translate><br />
<br />
[[File:joomla_issue_tracker-<translate><!--T:8--><br />
en</translate>.png]]<br />
<br />
<translate><!--T:9--><br />
The list shows the tracker items from new to old but the order can be changed by using the filters under Search tools. All items in the tracker, that have a patch, have a version number beside the title.<br />
* PR-staging: This is Joomla 3.4.x<br />
* PR-3.5.dev: This is Joomla 3.5</translate><br />
<br />
<translate><!--T:10--><br />
These labels will change in the future as new versions come and old versions go.<br />
<br />
<!--T:11--><br />
The status is important and this is an explanation:</translate><br />
<br />
<translate><!--T:12--><br />
'''New''' - Immediately after an issue is reported it receives this status. When you find a bug, create a description how to reproduce the bug. People who are testing the issue then know how to test the patch.</translate><br />
<br />
<translate><!--T:13--><br />
'''Confirmed''' - The tracker team has been able to reproduce the issue. The coding team is going to look for a solution.</translate><br />
<br />
<translate><!--T:14--><br />
'''Pending''' - A solution has been found for the issue. A patch has been attached that can be tested. The issue needs to be tested. Pay attention to the label beside the title, this indicates for which Joomla version the patch is applicable.</translate><br />
<br />
<translate><!--T:15--><br />
'''Ready to commit''' - The patch has been successfully tested and the code can be committed.</translate><br />
<br />
<translate><!--T:16--><br />
'''Closed''' - This status is for all issues that need no further action.</translate><br />
<br />
<translate><!--T:17--><br />
Filtering is useful in the issue tracker. Monitoring can be useful to receive notifications of an issue that has been updated.</translate> <br />
<br />
<translate><!--T:18--><br />
Basically you start testing issues that have the status "Pending".</translate><br />
<br />
<translate><br />
=== Preparing to test === <!--T:19--><br />
</translate><br />
<translate><!--T:20--><br />
First the master code has to be retrieved from the Joomla GitHub repository.<br />
There are several different ways to download the Joomla master code but here we only discuss the download option.</translate><br />
<br />
<translate><br />
==== Create folder ==== <!--T:21--><br />
</translate><br />
<translate><!--T:22--><br />
First we need to create a folder on either the local webserver or the hosting account that can be accessed via the browser. Create the folder '''bugtesting''' and go to this folder via Explorer or Finder.</translate><br />
<br />
<translate><br />
==== Download Joomla ==== <!--T:23--><br />
</translate><br />
<translate><!--T:24--><br />
Go to the [https://github.com/joomla/joomla-cms Joomla GitHub location] and click on '''Download ZIP'''</translate><br />
<br />
[[File:joomla_github-<translate><!--T:25--><br />
en</translate>.png]]<br />
<br />
<translate><!--T:26--><br />
This will get you a copy of the Joomla master code in a ZIP file. Unzip the file in a temporary location, a folder named joomla-cms-staging will appear. Inside this folder is the Joomla master code. Go into the joomla-cms-staging folder and copy the complete contents to the folder '''bugtesting''' that you created in the previous step.</translate><br />
<br />
<translate><!--T:27--><br />
Now you can install Joomla by navigating to <code><nowiki>http://localhost/bugtesting</nowiki></code> if you are using a local webserver, if you use one on a hosting account, navigate to the appropriate URL for the hosting account. You will see the regular installation process of Joomla.<br />
For sample data choose: Test English (GB) sample data<br />
<br />
<!--T:28--><br />
This is important so everybody uses the same data to test!<br />
<br />
<!--T:29--><br />
The installation folder does not have to be removed, this way you can easily reinstall everything if needed.</translate><br />
<br />
<translate><br />
=== Download Patch Tester === <!--T:30--><br />
</translate><br />
<translate><!--T:31--><br />
To help you with the process of testing patches, a Joomla extension called Patch Tester has been developed. The Patch Tester can be downloaded from the [https://github.com/joomla-extensions/patchtester/releases Patch Tester page] and after that can be installed via the Extension manager in Joomla.</translate><br />
<br />
<translate><!--T:32--><br />
To use the Patch Tester a GitHub account is required, the reason for this that there is a strict limit on the number of anonymous requests that can be made via the Patch Tester. You can sign up for a GitHub account on [https://github.com/join this page].</translate><br />
<br />
<translate><br />
=== Setup Patch Tester === <!--T:33--><br />
</translate><br />
<translate><!--T:34--><br />
The GitHub account details can be entered into the settings of the Patch Tester. After the Patch Tester has been installed go to Components -> Joomla! Patch Tester and click on Options in the top right corner. The Options page shows up and you can enter your GitHub username and password.</translate><br />
<br />
[[File:patchtester_details-<translate><!--T:35--><br />
en</translate>.png]]<br />
<br />
<translate><!--T:36--><br />
After entering your account details click on Save & Close. Once back in the Patch Tester click on Retrieve data in the top left corner.</translate><br />
<br />
<translate><!--T:37--><br />
You are now ready to start testing.<br />
<br />
<!--T:38--><br />
Find an issue in the issue tracker you want to test or use the "Feeling lucky" button. First check if you can reproduce the issue. If you can reproduce the issue, then you can install the patch.</translate><br />
<br />
<translate>=== Installing Patch === <!--T:39--><br />
</translate><br />
<translate><!--T:40--><br />
In the Patch Tester find the issue you are working on by (partial) title or ID. The title of a tracker always looks like this:<br />
<br />
<!--T:41--><br />
[#4308] - Fixed event dispatching inconsistencies leading to incomplete API<br />
<br />
<!--T:42--><br />
Beside the # is the ID and behind the - sign comes the title.</translate><br />
<br />
<translate><!--T:43--><br />
After the patch has been found click on the blue button Apply Patch. Check if the bug has been fixed and also check if no new bugs have been introduced</translate><br />
<br />
<translate><br />
=== Recording test results === <!--T:50--><br />
</translate><br />
<translate><br />
<!--T:51--><br />
In the issue add your comments and start the comment with @test and describe your findings. After your comment has been added, also add your test result in the test overview. This is the module on the right in every issue.<br />
</translate><br />
<br />
[[File:test_results-<translate><!--T:44--><br />
en</translate>.png]]<br />
<br />
<translate><br />
=== Revert patch === <!--T:45--><br />
</translate><br />
<translate><!--T:46--><br />
After a patch has been tested it is no longer needed and can be removed from your test installation, this way you are always testing with a clean system. Go back to the Patch Tester and click on the green button Revert Patch. This will remove the patch and you can start testing the next issue.<br />
<br />
<!--T:47--><br />
If you have become enthusiastic to test, give it a try. It takes a bit of effort to set everything up but once that is done, it is fun and easy! In addition you are also contributing to Joomla!.</translate><br />
<br />
<translate><!--T:48--><br />
[[Category:Bug Squad]]<br />
[[Category:Bug Tracker]]<br />
[[Category:Core Contributions]]</translate></div>Dylis