Difference between revisions of "Developing an MVC Component/Adding language management/nl"

Latest revision as of 23:56, 22 January 2019

Other languages:

English • ‎Nederlands • ‎español • ‎français • ‎العربية • ‎中文（台灣）‎

This Page Needs Your Help

Joomla!

3.x

Handleiding

Het ontwikkelen van een MVC component

Artikelen in deze reeks

Het toevoegen van een view aan de website

Het toevoegen van een menu aan de website

Het toevoegen van een model aan de website

Een 'variable request' toevoegen in het menu type

De database gebruiken

Basis beheergedeelte

Het toevoegen van taalbeheer

Het toevoegen van acties in het beheergedeelte

Het toevoegen van decoraties aan het beheergedeelte

Het toevoegen van controles

Het toevoegen van categorieën

Het toevoegen van configuratie

Het toevoegen van ACL

Het toevoegen van een installatie/deïnstallatie/update script-bestand

Een formulier op de website toevoegen

Het gebruik van de taal filterfunctie

Het toevoegen van een update-server

Dit is een reeks van artikelen met handleidingen over het ontwikkelen van een Model-View-Controller Component voor Joomla! versie.

Begin met de Introductie en navigeer door de artikelen van de reeks door middel van de navigatieknop onderaan of het vak rechts (Artikelen in deze reeks).

Inleiding

Deze handleiding is een onderdeel van de Het ontwikkelen van een MVC Component voor Joomla! 3.2 uitleg. Het is aan te raden om de vorige delen van deze handleiding te lezen voordat u dit onderdeel leest.

U kunt een video bekijken die gerelateerd is aan deze stap in de handleiding op Stap 8, Toevoegen van taalbeheer.

Joomla! 3.2 beheert talen voor componenten in vier verschillende situaties:

weergave van een component op het publieke deel van de site
beheren van een component in het beheergedeelte
beheren van menu's in het beheergedeelte
installatie van een component

Joomla! 3.2 gebruikt twee verschillende locaties voor de taalmappen:

een in administrator/language of language
een in the componentmap (administrator/components/*component*/language of components/*component*/language)

Het is afhankelijk van hoe de component geïnstalleerd wordt.

Toevoegen van vertalingen in het publieke deel van de site

Maak met de bestandsmanager en editor van uw voorkeur een bestand site/language/en-GB/en-GB.com_helloworld.ini. Dit bestand zal de vertalingen bevatten voor het publieke gedeelte. Op dit moment is het bestand leeg.

site/language/en-GB/en-GB.com_helloworld.ini

Op dit moment bevat dit bestand geen taalstrings.

Toevoegen van vertalingen bij het beheren van de component

Maak met uw bestandsmanager en editor van uw voorkeur een bestand admin/language/en-GB/en-GB.com_helloworld.ini. Dit bestand zal vertalingen voor het beheergedeelte bevatten.

admin/language/en-GB/en-GB.com_helloworld.ini

; Joomla! Project
; Copyright (C) 2005 - 2018 Open Source Matters. All rights reserved.
; License GNU General Public License version 2 or later; see LICENSE.txt, see LICENSE.php
; Note : All ini files need to be saved as UTF-8

COM_HELLOWORLD_NUM="#"
COM_HELLOWORLD_PUBLISHED="Published"
COM_HELLOWORLD_HELLOWORLDS_NAME="Name"
COM_HELLOWORLD_ID="Id"

COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC="This message will be displayed"
COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL="Message"
COM_HELLOWORLD_HELLOWORLD_HEADING_GREETING="Greeting"
COM_HELLOWORLD_HELLOWORLD_HEADING_ID="Id"

Toevoegen van vertalingen bij het menubeheer in het beheergedeelte

Maak met uw bestandsmanager en editor van uw voorkeur een bestand admin/language/en-GB/en-GB.com_helloworld.sys.ini. Dit bestand zal vertalingen voor het beheergedeelte bevatten.

admin/language/en-GB/en-GB.com_helloworld.sys.ini

; Joomla! Project
; Copyright (C) 2005 - 2015 Open Source Matters. All rights reserved.
; License GNU General Public License version 2 or later; see LICENSE.txt, see LICENSE.php
; Note : All ini files need to be saved as UTF-8

COM_HELLOWORLD="Hello World!"
COM_HELLOWORLD_DESCRIPTION="This is the Hello World description"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE="Hello World"
COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC="This view displays a selected message"
COM_HELLOWORLD_MENU="Hello World!"

Taalbestanden locatie opties

Vanaf versie 1.7 zijn er 2 manieren om taalbestanden te installeren voor een extensie. Men kan een van beiden of een combinatie van beiden gebruiken.

De 1.5 manier zal de bestanden in de CORE taalmappen (ROOT/administrator/language/ en ROOT/language/) installeren. Sinds versie 1.6, voegt u de bestanden toe in een "language" map die in de root van de extensie wordt geïnstalleerd.

Zodoende kan een extensie een taalmap toevoegen met een .sys.ini die verschilt van de het bestand dat in de Joomla core taalmap is geïnstalleerd. (De laatste niet ingevoegd in die taalmap maar in root of iedere andere niet geïnstalleerde map.)

Zodoende kunnen 2 verschillende beschrijvingen worden weergeven: een van de sys.ini in de "language" map die wordt gebruikt als bericht nadat de installatie is voltooid, de andere (van de .ini) wordt gebruikt voor "normale" handelingen, zoals het bewerken van de extensie in het beheergedeelte. Dit kan behoorlijk nuttig zijn wanneer de installatie ook enkele scripts gebruikt en een andere waarde vereist als beschrijving.

Dit moet u weten!

Derhalve moet in de xml sinds 1.6 ingevoegd worden:

<files>
<[...]
<folder>language</folder>  // This folder HAS to include the right subfolders, i.e. language/en-GB/ ... language/fr-FR/
<filename>whatever</filename>
[...]
</files>

<administration>
    <files folder="admin">
        <[...]
        <folder>language</folder>
        <filename>whatever</filename>
        <[...]
    </files>
</administration>

en/of de (1.5 manier)

<languages folder="joomlacorelanguagefolders"> // If using another language folder for cleanliness. (Any folder name will fit.)
<language tag="en-GB">en-GB/en-GB.whatever.ini</language> // or
<language tag="en-GB">en-GB.whatever.ini</language> if no tagged subfolder
<language tag="en-GB">en-GB/en-GB.whatever.sys.ini</language> // or
<language tag="en-GB">en-GB.whatever.sys.ini</language> if no tagged subfolder
</languages>

of eenvoudig in de ROOT:

<languages>
<language tag="en-GB">en-GB.whatever.ini</language>
<language tag="en-GB">en-GB.whatever.sys.ini</language>
</languages>

Taalbestanden die gebruikt worden door het installatiescript tijdens de installatie van een component(de eerste installatie, niet een upgrade) moeten voldoen aan specifieke regels, beschreven in het artikel Specificatie van taalbestanden. Tijdens de eerste installatie wordt alleen het taalbestand in de component map (/administrator/components/com_helloworld/language) gebruikt indien aanwezig. Indien dit bestand alleen aangeboden wordt in de CORE taalmap (/administrator/language), wordt er geen vertaling weergegeven. Dit geldt ook voor KEYs die gebruikt worden in het manifest bestand.

Na upgraden of deinstalleren van de extensie (niet installeren), is het het sys.ini bestand, aanwezig in de basis taalmap van de extensie die het resultaat weergeeft van de installatie via de beschrijving key/waarde. Derhalve, indien aanwezig, heeft de sys.ini alsook de .ini geïnstalleerd in de CORE taalmap prioriteit boven de aanwezige bestanden in de basis taalmap van de extensie.

Voordelen van de extensie "language" map

Nog een voordeel is dat deze map meerdere talen kan bevatten (en-GB altijd, fr-FR, it-IT, enz.) zodat de gebruiker geen corresponderende taalpakketten hoeft te installeren. Dit is handig wanneer een gebruiker later een corresponderend pakket installeert.

Inpakken van de component

De inhoud van uw code map

Maak een gecomprimeerd bestand aan van deze map of download direct het archief en installeer het via Extensiebeheer van Joomla. U kunt een menu-item aanmaken voor deze component met behulp van het menubeheer in het beheergedeelte.

helloworld.xml

<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.0" method="upgrade">

	<name>COM_HELLOWORLD</name>
	<!-- The following elements are optional and free of formatting constraints -->
	<creationDate>January 2018</creationDate>
	<author>John Doe</author>
	<authorEmail>john.doe@example.org</authorEmail>
	<authorUrl>http://www.example.org</authorUrl>
	<copyright>Copyright Info</copyright>
	<license>License Info</license>
	<!--  The version string is recorded in the components table -->
	<version>0.0.8</version>
	<!-- The description is optional and defaults to the name -->
	<description>COM_HELLOWORLD_DESCRIPTION</description>

	<install> <!-- Runs on install -->
		<sql>
			<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
		</sql>
	</install>
	<uninstall> <!-- Runs on uninstall -->
		<sql>
			<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
		</sql>
	</uninstall>
	<update> <!-- Runs on update; New since J2.5 -->
		<schemas>
			<schemapath type="mysql">sql/updates/mysql</schemapath>
		</schemas>
	</update>

	<!-- Site Main File Copy Section -->
	<!-- Note the folder attribute: This attribute describes the folder
		to copy FROM in the package to install therefore files copied
		in this section are copied from /site/ in the package -->
	<files folder="site">
		<filename>index.html</filename>
		<filename>helloworld.php</filename>
		<filename>controller.php</filename>
		<folder>views</folder>
		<folder>models</folder>
	</files>

	<languages folder="site/language">
		<language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language>
	</languages>

	<administration>
		<!-- Administration Menu Section -->
		<menu link='index.php?option=com_helloworld'>COM_HELLOWORLD_MENU</menu>
		<!-- Administration Main File Copy Section -->
		<!-- Note the folder attribute: This attribute describes the folder
			to copy FROM in the package to install therefore files copied
			in this section are copied from /admin/ in the package -->
		<files folder="admin">
			<!-- Admin Main File Copy Section -->
			<filename>index.html</filename>
			<filename>helloworld.php</filename>
			<filename>controller.php</filename>
			<!-- SQL files section -->
			<folder>sql</folder>
			<!-- tables files section -->
			<folder>tables</folder>
			<!-- models files section -->
			<folder>models</folder>
			<!-- views files section -->
			<folder>views</folder>
		</files>
		<languages folder="admin/language">
			<language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language>
			<language tag="en-GB">en-GB/en-GB.com_helloworld.sys.ini</language>
		</languages>
	</administration>

</extension>

In dit helloworld.xml bestand worden taalbestanden geïnstalleerd in:

administrator/language voor het beheergedeelte (kijk naar de xml languages tag).
components/com_helloworld/language voor het website gedeelte (er zijn geen xml languages tags in het website gedeelte van de xml beschrijving file, maar de taalmap is ingevoegd).

General Information

Bijdragers

Vorige: Basis beheergedeelte

Volgende: Toevoegen van acties in het beheergedeelte

@@ Line 32: / Line 32: @@
 Op dit moment bevat dit bestand geen taalstrings.
-== Adding language translation when managing the component ==
+== Toevoegen van vertalingen bij het beheren van de component ==
-With your favourite file manager and editor, put a file <tt>admin/language/en-GB/en-GB.com_helloworld.ini</tt>. This file will contain translation for the backend part.
+Maak met uw bestandsmanager en editor van uw voorkeur een bestand <tt>admin/language/en-GB/en-GB.com_helloworld.ini</tt>. Dit bestand zal vertalingen voor het beheergedeelte bevatten.
 <span id="admin/language/en-GB/en-GB.com_helloworld.ini">
@@ Line 56: / Line 56: @@
 </span>
-== Adding language translation when managing the menus in the backend ==
+== Toevoegen van vertalingen bij het menubeheer in het beheergedeelte ==
-With your favourite file manager and editor, put a file <tt>admin/language/en-GB/en-GB.com_helloworld.sys.ini</tt>. This file will contain translation for the backend part.
+Maak met uw bestandsmanager en editor van uw voorkeur een bestand <tt>admin/language/en-GB/en-GB.com_helloworld.sys.ini</tt>. Dit bestand zal vertalingen voor het beheergedeelte bevatten.
 <span id="admin/language/en-GB/en-GB.com_helloworld.sys.ini">
@@ Line 76: / Line 76: @@
 </span>
-== Language File Location Options ==
+== Taalbestanden locatie opties ==
-Starting with version 1.7 there are 2 ways to install language files for an extension. One can use one or the other or a combination of both.
+Vanaf versie 1.7 zijn er 2 manieren om taalbestanden te installeren voor een extensie. Men kan een van beiden of een combinatie van beiden gebruiken.
-The 1.5 way will install the files in the CORE language folders (<tt>ROOT/administrator/language/</tt> and <tt>ROOT/language/</tt>).
+De 1.5 manier zal de bestanden in de CORE taalmappen (<tt>ROOT/administrator/language/</tt> en <tt>ROOT/language/</tt>) installeren.
-Since version 1.6, include the files in a "language" folder installed at the root of the extension.
+Sinds versie 1.6, voegt u de bestanden toe in een "language" map die in de root van de extensie wordt geïnstalleerd.
-Therefore an extension can include a language folder with a .sys.ini different from the one installed in the Joomla core language folders. (This last one not being included in that language folder but in root or any other folder not installed.)
+Zodoende kan een extensie een taalmap toevoegen met een .sys.ini die verschilt van de het bestand dat in de Joomla core taalmap is geïnstalleerd. (De laatste niet ingevoegd in die taalmap maar in root of iedere andere niet geïnstalleerde map.)
-This lets us display 2 different descriptions: one from the sys.ini in the "language" folder is used as a message displayed when installation is finished, the other (from the .ini) is used for "normal" operation, that is, when the extension is edited in the back-end. This can be extremely useful when the installation also uses some scripts and requires a different value for the description.
+Zodoende kunnen 2 verschillende beschrijvingen worden weergeven: een van de sys.ini in de "language" map die wordt gebruikt als bericht nadat de installatie is voltooid, de andere (van de .ini) wordt gebruikt voor "normale" handelingen, zoals het bewerken van de extensie in het beheergedeelte. Dit kan behoorlijk nuttig zijn wanneer de installatie ook enkele scripts gebruikt en een andere waarde vereist als beschrijving.
-{{tip|The sys.ini file is also used to translate the name of the extensions in some back-end Managers and to provide menu translation for components.|title=You Should Note!}}
+{{tip|Het sys.ini bestand wordt ook gebruikt om de naam van de extensie te vertalen in sommige gedeelten van het beheergedeelte en om vertalingen van het menu te bieden voor componenten.|title=Dit moet u weten!}}
-Therefore, the xml would include since 1.6:
+Derhalve moet in de xml sinds 1.6 ingevoegd worden:
 <source lang="xml">
@@ Line 108: / Line 108: @@
 </source>
-and/or then (1.5 way):
+en/of de (1.5 manier)
 <source lang="xml">
@@ Line 119: / Line 119: @@
 </source>
-or simply in ROOT:
+of eenvoudig in de ROOT:
 <source lang="xml">
@@ Line 128: / Line 128: @@
 </source>
-Language file used by the installation script during the installation of a component(''the first install'', not an upgrade) obeys specific rules described in the article, [[S:MyLanguage/Specification of language files|Specification of language files]]. During the first installation, only the language file included in the component folder <code>(/administrator/components/com_helloworld/language)</code> is used when present. If this file is only provided in the CORE language folder <code>(/administrator/language)</code>, no translation occurs. This also applies to KEYs used in the manifest file.
+Taalbestanden die gebruikt worden door het installatiescript tijdens de installatie van een component(''de eerste installatie'', niet een upgrade) moeten voldoen aan specifieke regels, beschreven in het artikel [[S:MyLanguage/Specification of language files|Specificatie van taalbestanden]]. Tijdens de eerste installatie wordt alleen het taalbestand in de component map <code>(/administrator/components/com_helloworld/language)</code> gebruikt indien aanwezig. Indien dit bestand alleen aangeboden wordt in de CORE taalmap <code>(/administrator/language)</code>, wordt er geen vertaling weergegeven. Dit geldt ook voor KEYs die gebruikt worden in het manifest bestand.
-When upgrading or uninstalling the extension (not installing), it is the sys.ini file present in the extension root language folder which will display the result of the installation from the description key/value. Thereafter, if present, the sys.ini as well as the .ini installed in the CORE language folder will have priority over the files present in the root language folder of the extension.
+Na upgraden of deinstalleren van de extensie (niet installeren), is het het sys.ini bestand, aanwezig in de basis taalmap van de extensie die het resultaat weergeeft van de installatie via de beschrijving key/waarde. Derhalve, indien aanwezig, heeft de sys.ini alsook de .ini geïnstalleerd in de CORE taalmap prioriteit boven de aanwezige bestanden in de basis taalmap van de extensie.
-{{tip|title=Advantages of Extension "Language" Folder|''One advantage of installing the files in the extension "language" folder is that these '''are not touched when updating''' a language pack.''{{-}}The other advantage is that this folder can include multiple languages (en-GB always, fr-FR, it-IT, etc.) not requiring the user to install the corresponding language pack. This is handy as they are available if, later on, a user installs the corresponding pack.}}
+{{tip|title=Voordelen van de extensie "language" map|''Een van de voordelen van het installeren van de bestanden in de extensie "language" map is dat deze '''niet beïnvloed worden tijdens het updaten van''' een taalpakket.''{{-}}Nog een voordeel is dat deze map meerdere talen kan bevatten (en-GB altijd, fr-FR, it-IT, enz.) zodat de gebruiker geen corresponderende taalpakketten hoeft te installeren. Dit is handig wanneer een gebruiker later een corresponderend pakket installeert.}}
-== Packaging the component ==
+== Inpakken van de component ==
-Content of your code directory
+De inhoud van uw code map
 * ''[[#helloworld.xml|helloworld.xml]]''
 * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
@@ Line 178: / Line 178: @@
 * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/language/en-GB/index.html]]''
-Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-8-adding-language-management.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.
+Maak een gecomprimeerd bestand aan van deze map of download direct het [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-8-adding-language-management.zip archief] en installeer het via Extensiebeheer van Joomla. U kunt een menu-item aanmaken voor deze component met behulp van het menubeheer in het beheergedeelte.
 <span id="helloworld.xml">
@@ Line 227: / Line 227: @@
 	</files>
-        <languages folder="site/language">
+	<languages folder="site/language">
 		<language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language>
-        </languages>
+	</languages>
 	<administration>
@@ Line 262: / Line 262: @@
 </span>
-In this <tt>helloworld.xml</tt> file, languages are installed in:
+In dit <tt>helloworld.xml</tt> bestand worden taalbestanden geïnstalleerd in:
-* <tt>administrator/language</tt> for the admin part (look at the xml languages tag).
+* <tt>administrator/language</tt> voor het beheergedeelte (kijk naar de xml languages tag).
-* <tt>components/com_helloworld/language</tt> for the site part (there are no xml languages tag in the site part of the xml description file, but the language folder is included).
+* <tt>components/com_helloworld/language</tt> voor het website gedeelte (er zijn geen xml languages tags in het website gedeelte van de xml beschrijving file, maar de taalmap is ingevoegd).
-{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code descprepancies or if editing any of the source code on this page.}}
+{{notice|Maak alstublieft een pull request of issue aan op https://github.com/joomla/Joomla-3.2-Hello-World-Component voor enige foute code of een wijziging van de broncode op deze pagina.}}
-== Contributors ==
+== Bijdragers ==
 *[[User:cdemko|Christophe Demko]]
 *[[User:oaksu|Ozgur Aksu]]
@@ Line 274: / Line 274: @@
 <div class="row">
-<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Prev: Basic backend|class=expand success}}</div>
+<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Vorige: Basis beheergedeelte|class=expand success}}</div>
-<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding backend actions|Next: Adding backend actions|class=expand}}</div>
+<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding backend actions|Volgende: Toevoegen van acties in het beheergedeelte|class=expand}}</div>
 </div>
 __NOTOC__

J3.x