Joomla! Documentation - User contributions [en]

J3.x:Developing an MVC Component/Developing a Basic Component/de

2021-03-22T09:20:29Z

Krauthos: Chapters have been mixed up

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Info ==
Dieses Tutorial ist ein Teil der [[S:MyLanguage/J3.x:Developing_an_MVC_Component/Introduction|Entwicklung einer MVC-Komponente für Joomla! 3.x]] Artikel-Serie. Es ist sinnvoll, die vorherigen Teile des Tutorials zu lesen, bevor du fortfährst.

Wenn du Joomla! bereits nutzt, hast du sicher schon festgestellt, dass Erweiterungen durch eine komprimierte Datei, welche alle für eine Installation und Deinstallation notwendigen Dateien enthält, installiert werden.

Wenn du die nachfolgenden Schritte durcharbeitest, kannst du selbst eine eigene Komponente namens Hello World! erstellen oder kannst die Dateien direkt vom Git Repository [https://github.com/Stevec4/Joomla-HelloWorld/raw/master/01%20Introduction/helloworld.zip Archiv] herunterladen.

Hier sind einige auf diesem Dokument basierende Folien, die erklären wie, man grundlegende bis fortgeschrittene Joomla!-Komponenten erstellt.<br />
[http://bit.ly/joomlaWorkshopBasic Joomla! Basic Component Help]<br />
[http://bit.ly/joomlaWorkshopAdvance Joomla! Advance Component Help]<br />

Des Weiteren gibt es eine Reihe von Videos, welche die Schritte im Tutorial begleiten, beginnend mit:<br />
[https://www.youtube.com/watch?v=4JDsdfnlOhE Schritt 1, Entwickle eine einfache Komponente] (en)
Zugriff auf die in der Videoserie verwendeten Folien findest du unter: [https://docs.google.com/presentation/d/11g6qd64zmQObe8xMuEVubdUeIp0DcZ1wr8dq7LcrXIA Folien].

'''Wichtig! Die Joomla-Entwickler begannen seit Version 3.8 mit der Änderung der Namen von Joomla-Klassen und der Verzeichnisstruktur, in der sie liegen. Viele der Schritte im Tutorial und den Videos verweisen auf veraltete Namenskonventionen. Um das passende Äquivalent der neuen Klasse und und deren Ort zu finden, schaue in deine libraries/classmap.php Datei.'''

{{#widget:YouTube|id=4JDsdfnlOhE}}

== Wie du eine eigene Komponente zu Joomla! hinzufügst ==
In diesem Artikel zeigen wir dir, wie du eine Basis-Komponente für Joomla! erstellst und anschließend installierst. Für dieses Beispiel werden wir mit der Komponente Hello World! arbeiten.

Zu Beginn erstelle bitte mit deinem bevorzugten Datei-Explorer einen Ordner für die Hello World! Komponente. Dieser Ordner kann überall in deinem Dateisystem sein, er muss nur außerhalb deines Joomla! Installationsverzeichnisses sein. Für dieses Beispiel geben wir dem neuen Ordner den Namen <tt>com_helloworld</tt>, aber grundsätzlich kann der Ordner auch jeden beliebigen anderen Namen besitzen.

Als nächstes müssen wir innerhalb des gerade erstellten Verzeichnisses einige Dateien anlegen. Lege die folgenden Dateien an und schreibe den jeweiligen Source-Code für jede Datei. Den jeweiligen Code findest du hier ''[[#File Details| Datei-Details]]''.


{| border=1
| 1
| ''[[#helloworld.xml|helloworld.xml]]''
| Das ist eine XML-Datei (Manifest), welche Joomla! sagt, wo deine Komponente installiert werden soll.
|-
| 2
| ''[[#site/helloworld.php|site/helloworld.php]]''
| Das ist der Einstiegspunkt der Seite für die Komponente Hello World!
|-
| 3
| ''[[#index.html|site/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 4
| ''[[#index.html|admin/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 5
| ''[[#admin/helloworld.php|admin/helloworld.php]]''
| Das ist der Einstiegspunkt der Administration für die Hello World! Komponente.
|-
| 6
| ''[[#index.html|admin/sql/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 7
| ''[[#index.html|admin/sql/updates/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 8
| ''[[#index.html|admin/sql/updates/mysql/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 9
| ''[[#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
| Datei, mit der die Schemaversion der Komponente com_helloworld initialisiert werden kann.
|}

=== Installation der Komponente Hello World! ===
Erstelle mit deinem bevorzugten Datei-Explorer ein Zip-Archiv aus diesem Verzeichnis. Für dieses Beispiel nennen wir die Datei <tt>com_helloworld.zip</tt>. Und wieder der Hinweis: Der Name dieser Datei kann beliebig gewählt werden.

Jetzt sind wir bereit die Komponente Hello World! zu installieren. Es gibt zwei Wege, dies zu tun. Beide sind erklärt in: [[S:MyLanguage/Installing an extension|Installation einer Erweiterung]]. Hier nutzen wir die Methode über die Erweiterungs-Verwaltung von Joomla!.

*Benutze deinen bevorzugten Browser und navigiere zur Administrationsansicht deiner Joomla! Seite. Die Adresse wird folgende sein: <tt><DeineSeite>/joomla/administrator/index.php</tt>. Für dieses Beispiel navigieren nun auf <tt>localhost/joomla/administrator/index.php</tt>.
*Klicke auf Erweiterungen {{rarr}} Verwalten {{rarr}} Installieren {{rarr}} Paketdatei hochladen {{rarr}} Datei auswählen
*Suche und wähle die Datei
*Klicke auf Hochladen und Installieren

Hinweis - Du solltest eine Nachricht sehen, ob die Installation erfolgreich oder fehlgeschlagen ist.

Du kannst die grundlegenden Funktionen der Komponente überprüfen, indem du die Hello World! Seite für den Administrator- oder Seitenbereich eingibst.
* Nutze deinen bevorzugten Browser und navigiere zur Hello World! Komponentenseite deiner Website. Die Adresse wäre: <tt><DeineSeite>/joomla/index.php?option=com_helloworld</tt>. Für dieses Beispiel navigieren wir also zu: <tt>localhost/joomla/index.php?option=com_helloworld</tt>.
* Nutze deinen bevorzugten Browser und navigiere zur Hello World! Komponentenseite deines Administrationsabschnittes. Die Adresse wäre: <tt><DeineSeite>/joomla/administrator/index.php?option=com_helloworld</tt>. Für dieses Beispiel navigieren wir also zu: <tt>localhost/joomla/administrator/index.php?option=com_helloworld</tt>.

Du wirst weiterhin bemerken das die Komponente ''Hello World!'' in der Administratorenansicht deiner Joomla-Installation unter ''Komponenten'' sichtbar ist.

==Details zu den Dateien==
{{vanchor|admin/sql/updates/mysql/0.0.1.sql}}
eine leere Datei, mit der die Schemaversion der Komponente com_helloworld initialisiert werden kann.

<source lang="sql">
</source>

{{vanchor|helloworld.xml}}

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

<name>Hello World!</name>

<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>

<version>0.0.1</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>

{{vanchor|site/helloworld.php}}

<source lang="php">
Hello World
</source>

{{vanchor|admin/helloworld.php}}

<source lang="php">
Hello World administration
</source>

{{vanchor|index.html}}

Übliche Datei in allen Ordnern.

<source lang="html4strict">
<html><body bgcolor="#FFFFFF"></body></html>
</source>

==Inhalte der Komponente==
An diesem Punkt der Übung sollte deine Komponente folgende Dateien enthalten:
{| border=1
| 1
| ''[[#helloworld.xml|helloworld.xml]]''
| Dies ist eine XML-Datei (Manifest), die Joomla! mitteilt, wie unsere Komponente installiert werden soll.
|-
| 2
| ''[[#site/helloworld.php|site/helloworld.php]]''
| Dies ist der Einstiegspunkt zum Seitenbereich der Komponente Hello World!
|-
| 3
| ''[[#index.html|site/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 4
| ''[[#index.html|admin/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 5
| ''[[#admin/helloworld.php|admin/helloworld.php]]''
| Das ist der Einstiegspunkt für die Administration der Hello World! Komponente.
|-
| 6
| ''[[#index.html|admin/sql/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 7
| ''[[#index.html|admin/sql/updates/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 8
| ''[[#index.html|admin/sql/updates/mysql/index.html]]''
| Hindert den Webserver daran, den Verzeichnisinhalt aufzulisten.
|-
| 9
| ''[[#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
| Datei, mit der die Schemaversion der Komponente com_helloworld initialisiert werden kann.
|}

{{notice|Ein aktualisiertes Git-Repository, das diesem Tutorial folgt, ist verfügbar unter https://github.com/Stevec4/Joomla-HelloWorld
Bei Code Unstimmigkeiten oder Änderungen erstelle bitte ein "Pull Request".}}

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Introduction|Zurück: Einführung|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_view_to_the_site_part|Weiter: Hinzufügen eines Views zum Seitenbereich|class=expand}}</div>
</div>
__NOTOC__
<noinclude>
[[Category:Joomla! 3.x]]
[[Category:Joomla! 3.0]]
[[Category:Joomla! 3.1]]
[[Category:Joomla! 3.2]]
[[Category:Joomla! 3.3]]
[[Category:Joomla! 3.4]]
[[Category:Beginner Development/de|Einsteigerentwicklung]]
[[Category:Component Development/de|Komponenten-Entwicklung]]
[[Category:Tutorials/de]]
[[Category:Tutorials in a Series/de]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Developing a Basic Component/20/de

2021-03-22T09:20:27Z

Krauthos: Chapters have been mixed up

S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_view_to_the_site_part|Weiter: Hinzufügen eines Views zum Seitenbereich

JDOC:Documentation Translators

2021-03-20T18:22:16Z

Krauthos: /* de - Deutsch - German */

[[File:JDOC translation icon.png|right]]
Here, people '''translating''' {{SITENAME}} can sign up as a translator. Please be sure to read the required reading list below.

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.

{{tip|title=<translate>New to contributing to Joomla! Documentation?</translate>|text=<translate>If you're new to helping with Joomla! Documentation, and have come to this page as a starting point, we suggest you start at the [[JDOC:How to Contribute to Joomla! Documentation{{#translation:}}|How to Contribute to Joomla! Documentation]] page instead.</translate>}}

{{-}}

==Required Reading==
* Getting started with contributing to Joomla! Documentation, [[JDOC:How to Contribute to Joomla! Documentation{{#translation:}}|start here]].
* Getting started translating, read [[JDOC:Page Translation Quickstart Guide|Page Translation Quickstart Guide]]
* Detailed explanation of translating, [[JDOC:Page Translation Explained|Page Translation Explained]].
* Our [[JDOC:Language policy|Language policy]]
* [[JDOC:Translator Tips|Translator Tips]]
* [[Joomla:JDOC%27s_Translation_Guidelines|Translation Guidelines]]
* Having an [[JDOC:Translation Questions|issue or need help]]?

{{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}}

===Add Your Language===
If your language isn't listed below, please add it using the format:

<code><lang code> - Localised language name - English language name </code>

Use the syntax, <code><nowiki>* {{User|YourUsername}}</nowiki> - requested</code>

When a Translation Administrator adds you as a translator, they will remove the "- requested" from your username.

==Current Translations Teams==

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.

=== ar - عربي - arabe ===
* {{User|ghilo}}
* {{User|HawraMilani}}
* {{User|hossen}}
* {{User|ahmadm42}}

=== af - Afrikaans ===
*{{User|JoeSA}}
*{{User|Llewellyn}}

=== as - অসমীয়া - Assamese ===
*{{User|Mohsin Ali}}

=== be - Беларуская - Belarusian ===
* {{User|Nikolice}}

=== bg - Български - Bulgarian ===
* {{User|bdimov}}
* {{User|Mastwd}}

=== bn - বাংলা - Bengali ===
* {{User|ashiks}}
* {{User|shamsbd71}}
* {{User|theanamhossain}}
* {{User|Azadulkabir455}}

=== ca - Català - Catalan ===
* {{User|el_libre}}

=== cs - Čeština - Czech ===
* {{User|fredericco-cz}}
* {{User|Bart}}
* {{User|n3tcz}}
* {{User|svatas}}

=== cy - Cymraeg - Welsh ===
* {{User|Dyfrig}}

=== da - Dansk - Danish ===
* {{User|ot2sen}}
* {{User|rbuelund}}
* {{User|BBRA}}

=== de - Deutsch - German ===
* {{User|Astridx}}
* {{User|Assmann}}
* {{User|Alexander-metzler}}
* {{User|Balzercomp}}
* {{User|Batmin}}
* {{User|bbkSecond}}
* {{User|Blancanieve}}
* {{User|blueforce}}
* {{User|ceus1984}}
* {{User|Chmst}}
* {{User|chrishoefliger}}
* {{User|David0296}}
* {{User|Dimkk}}
* {{User|es_ka}}
* {{User|FancyFranci}}
* {{User|Farrell}}
* {{User|Florian}}
* {{User|FLin1}}
* {{User|FrankyD}}
* {{User|Franz.wohlkoenig}}
* {{User|fruppel}}
* {{User|goethe}}
* {{User|gorgonz}}
* {{User|Hleithner}}
* {{User|Indigo66}}
* {{User|Isarbella}}
* {{User|jehacgn}}
* {{User|JDocDummy}}
* {{User|joomla-agency}}
* {{User|Joomti}}
* {{User|Ka3media}}
* {{User|King_Louis_1}}
* {{User|Knig.Markus}}
* {{User|Kolvar}}
* {{User|Kurztipp}}
* {{User|LadySolveig}}
* {{User|m-b-o}}
* {{User|Maggus}}
* {{User|MAIN}}
* {{User|Max123kl}}
* {{User|michaelmyk}}
* {{User|Nathan.k}}
* {{User|oliverhh}}
* {{User|Paterna}}
* {{User|Pc-doppler}}
* {{User|Pete71}}
* {{User|phillopp}}
* {{User|plocher}}
* {{User|Prof.Logout}}
* {{User|quiltgabi}}
* {{User|RMajewski}}
* {{User|Redback}}
* {{User|Schmidie64}}
* {{User|SeigetsuShoen}}
* {{User|Sieger66}}
* {{User|Sisko1990}}
* {{User|Spannama}}
* {{User|Stefanie}}
* {{User|tfecha}}
* {{User|Tkahl}}
* {{User|UCFnet002}}
* {{User|Usimon}}
* {{User|Webberry}}
* {{User|Yvesh}}
* {{User|zero24}}
* {{User|Xadomir}}
* {{User|Vovos}}
* {{User|waldiwhz}}
* {{User|Widmann}}
* {{User|Zeroweb1}}
* {{User|Zeroweb2}}
* {{User|RobertMittl}}
* {{User|Uta}}
* {{User|Krauthos}} - requested

=== el - Ελληνικά - Greek ===
* {{User|Aris_Ntatsis}}
* {{User|Tonia_Chan}}
* {{User|Alphapi}}
* {{User|Alcaeusd}}
* {{User|TaDrik}}
* {{User|SiteworksGr}}
* {{User|pnkr}}
* {{User|Gfakas}}
* {{User|Stekarag}}
* {{User|Proudpixel}}
* {{User|Tropos}}
* {{User|ARTIFIEDWEB}}
* {{User|Fotis}}

=== es - Español - Spanish ===
* {{User|Abulafia}}
* {{User|AlejandroVega}}
* {{User|Andrea Gentil}}
* {{user|Antoniofmunoz}}
* {{User|BNovoa.S}}
* {{User|brucevalle}}
* {{User|carcam}}
* {{User|cristobal.vio}}
* {{User|Crsanchez}}
* {{User|danielperaza}}
* {{User|duoduo}}
* {{User|filisfutsarov}}
* {{User|framon}}
* {{User|Irene.lopez}}
* {{User|isidrobaq}}
* {{User|ivanramosnet}}
* {{User|Javiparati}}
* {{User|Jcollver}}
* {{User|Jolfig}}
* {{User|Koa}}
* {{User|Leo_Soto}}
* {{User|netandsoftware}}
* {{User|NunoLopes}}
* {{User|Maikolort}} - requested
* {{User|Pabloarias}}
* {{User|pdavila2709}}
* {{User|pfvidal}}
* {{User|Quivro}}
* {{User|shaz}}
* {{User|Urielmx}}
* {{User|VictorYork87}}
* {{User|viena}}
* {{User|Willin}}

=== et - Eesti - Estonian ===
* {{User|Eraser}}

=== fa - فارسی - Persian ===
* {{User|azolfagharj}}
* {{User|Grand}}
* {{User|Heydari}}
* {{User|Joomlafarsi}}
* {{User|Levelup}}
* {{User|mhehm}}

=== fr - Français - French ===
* {{User|alatak}}
* {{User|david613}}
* {{User|Cavo789}}
* {{User|Christophe}}
* {{User|Daneel}}
* {{User|edelouche}}
* {{User|Erix}}
* {{User|Garstud}}
* {{User|Lorangerart}}
* {{User|MaximeK7}}
* {{User|Opware2000}}
* {{User|Patpat}}
* {{User|Perete}}
* {{User|Remi1945}}
* {{User|Sandra97}}
* {{User|Shim-sao}}
* {{User|Thierry}}
* {{User|Twister65}}
* {{User|wisgar}}
* {{User|smilecollector}}

=== ga - Gaeilge - Irish ===
* {{User|rvbgnu}}

=== he - עברית - Hebrew ===
* {{User|ydl}}
* {{User|shirdesign}}

=== hi - हिंदी - Hindi ===
* {{User|AlamM}}
* {{User|Rana}}
* {{User|Syhussaini}}
* {{User|Shivamrajput}}
* {{User|ankitify}}

=== hr - Hrvatski - Croatian ===
* {{User|limoo}}

=== hu - Magyar - Hungarian ===
* {{User|Balazs}}
* {{User|webgobe}}

=== hy - Հայերեն - Armenian ===
* {{User|Aaleksanyants}}

=== id - Bahasa Indonesia - Indonesian ===
* {{User|dw1Rianto}}
* {{User|Micokelana}}
* {{User|sikumbang}}

=== it - Italiano - Italian ===
* {{User|alexred}}
* {{User|aleorco}}
* {{User|alikon}}
* {{User|Andreacarriero}}
* {{User|CinziaDesign}}
* {{User|donato}}
* {{User|ino}}
* {{User|Ladyj}}
* {{User|Luca.marzo}}
* {{User|marioluciani}}
* {{User|moqui}}
* {{User|nemo_bis}} (occasionally)
* {{User|Paolo Alberti}}
* {{User|Fabio Caracciolo}}
* {{User|robertolongo}}
* {{User|ste}}
* {{User|Ing Pulizzi}}
* {{User|Davidemessia}}
* {{User|NioBee}}
* {{User|Aurora}}
* {{User|Cristina Martorana}}
* {{User|Razzo}}

=== ja - 日本語 - Japanese ===
* {{User|Koji Hijikuro}}
* {{User|Nori}}
* {{User|Richell}}
* {{User|Yama}}
* {{User|Yui}}

=== lg - Luganda ===
*{{User|Bongomindaniel}}

=== nl - Nederlands - Dutch ===
* {{User|HildaAbbing}}
* {{User|AboutTime}}
* {{User|Alex0703}}
* {{User|Annemiek}}
* {{User|Arkomat}}
* {{User|BCWebdesign}}
* {{User|crommie}}
* {{User|Grubosoft}}
* {{User|fcschippers}}
* {{User|HermanPeeren}}
* {{User|Hvdmeer}}
* {{User|janvankuijk}}
* {{User|John Flour}}
* {{User|JorSanders}}
* {{User|Josien}}
* {{User|LtB}}
* {{User|Lianne}}
* {{User|klatte88}}
* {{User|ManuAmpe}}
* {{User|Marcelk}}
* {{User|marionnijhuis}}
* {{User|Marnix}}
* {{User|MartijnM}}
* {{User|Meta}}
* {{User|metdick}}
* {{User|Mtb}}
* {{User|n9iels}}
* {{User|Nemphias}}
* {{User|Nico-van-Leeuwen}}
* {{User|Onderzoekspraktijk}}
* {{User|12pooh}}
* {{User|rachel73}}
* {{User|Renem}}
* {{User|Ries}}
* {{User|Rineke}}
* {{User|Schrijvers123}}
* {{User|slibbe}}
* {{User|Sloekers}}
* {{User|Stitch123}}
* {{User|Vertaalbirdy}}
* {{User|webmiep}}
* {{User|Webcase}}
* {{User|webcatsolutions}}
* {{User|willoweb}}
* {{User|wimstrik}}

=== pl - Polski - Polish ===
* {{User|Vaco}}
* {{User|Derek}}
* {{User|justyna}}
* {{User|MiloW}}
* {{User|Zwiastun}}

=== pt - Português (Portugal) - Portuguese (Portugal) ===
* {{User|Djesus}}
* {{User|Horus_68}}
* {{User|Lampreia Lopes}}
* {{User|Mansil}}
* {{User|Nunof}}
* {{User|NunoLopes}}
* {{User|Ricardo.fusco}}

=== pt-br - Português Brasil - Brazilian Portuguese ===
* {{User|Airton}}
* {{User|alangustavo}}
* {{User|AleMorettiSan}}
* {{User|Anabarcellos}}
* {{User|Ariadnepinheiro}}
* {{User|Belisards}}
* {{User|Dagoberto}}
* {{User|DiLeu}}
* {{User|Filipetorres}}
* {{User|Gleisonsoares}}
* {{User|Helvecio}}
* {{User|Henrydouglas}}
* {{User|Jeann Wilson}}
* {{User|Juliano.freitas}}
* {{User|Murilotimo}}
* {{User|VitorAdonai}}
* {{User|Vizetti}}
* {{User|Welkson Ramos}}

=== ro - Română - Romanian ===
* {{User|andreeastefan}}
* {{User|isac}}
* {{User|Dudi161}}

=== ru - Русский - Russian ===
* {{User|AlexSmirnov}}
* {{User|Antonio3}}
* {{User|b2z}}
* {{User|cadko}}
* {{User|Cronolio}}
* {{User|Dosfanat}}
* {{User|Dzandut}}
* {{User|Igor}}
* {{User|Kanta}}
* {{User|Leo240}}
* {{User|Nikitm}}
* {{User|Nikolice}}
* {{User|Serg SSN}}
* {{User|Vyatka}}
* {{User|Yambergaa}}
* {{User|Powercoder}}

=== si - සිංහල - Sinhala ===
* {{User|Yasirunilan}}
* {{User|Supun}}

=== sk - Slovenčina - Slovak ===
* {{User|adambako}}

=== sw - Kiswahili ===
*

=== yu - Srpski (Latin) - Serbian (Latin) ===
* {{User|novii}}

=== sr - Српски (Ћирилица) - Serbian (Cyrillic) ===
* {{User|novii}}

=== sv - Svenska - Swedish ===
* {{User|Propellerhuvud}}
* {{User|Sgagner}}

=== sw - Kiswahili - Swahili ===
* {{User|Ayeko}}

=== th - ไทย - Thai ===
* {{User|Supachai_chai}}
* {{User|Mrs.siam}}
* {{User|Ariesanywhere}}

=== tr - Türkçe - Turkish ===
* {{User|Ugur}}
* {{User|Umitkenan}}

=== ukr - Українська - Ukrainian ===
* {{User|Olesya6968ak}}
* {{User|sera527}}
* {{User|trv}}

=== ur - ur-PK - اردو - Urdu Pakistan ===
* {{User|hoornayyer}}

=== vec - Veneto - Vèneto ===
* {{User|ino}}

=== vi - Tiếng Việt - Vietnamese ===
* {{User|huyhoa}}

=== zh - 中文 - Chinese ===
* {{User|asika32764}}
* {{User|eyesofkids}}
* {{User|Guozhanfeng}}
* {{User|KellyXYM}}
* {{User|lai32290}}
* {{User|Mori0725ken}}
* {{User|myskies}}
* {{User|Wulijun01234}}
* {{User|Zace}}
* {{User|Zhang19min88}}
* {{User|Zhous98}}

=== zh-tw - 繁體中文 - Traditional Chinese ===
* {{User|Yuhoward}}
* {{User|shawnhy}}

==Translation Administrators==

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.

===Current Volunteer Translation Administrators===
{{:Special:ListUsers/translationadmins}}

==Common Language Codes==
<div class="small-4 columns"> afr - Afrikaans - Afrikaans
</div><div class="small-4 columns"> ar - عربي - Arabic
</div><div class="small-4 columns"> as - অসমীয়া - Assamese
</div><div class="small-4 columns"> be - Беларуская - Belarusian
</div><div class="small-4 columns"> bg - Български - Bulgarian
</div><div class="small-4 columns"> bn - বাংলা - Bengali
</div><div class="small-4 columns"> bo - བོད་ཡིག - tibetan
</div><div class="small-4 columns"> ca - Català - Catalan
</div><div class="small-4 columns"> ce - Nohçi - Chechen
</div><div class="small-4 columns"> da - Dansk - Danish
</div><div class="small-4 columns"> de - Deutsch - German
</div><div class="small-4 columns"> es - Español - Spanish
</div><div class="small-4 columns"> fa - فارسی - Persian
</div><div class="small-4 columns"> fi - Suomi - Finnish
</div><div class="small-4 columns"> fr - Français - French
</div><div class="small-4 columns"> hu - Magyar - Hungarian
</div><div class="small-4 columns"> hy - Հայերեն - Armenian
</div><div class="small-4 columns"> id - Bahasa Indonesia - Indonesian
</div><div class="small-4 columns"> is - Íslenska - Icelandic
</div><div class="small-4 columns"> it - Italiano - Italian
</div><div class="small-4 columns"> ja - 日本語 - Japanese
</div><div class="small-4 columns"> ko - 한국어 - Korean
</div><div class="small-4 columns"> lb - Lëtzebuergesch - Luxembourgish
</div><div class="small-4 columns"> min - Baso Minangkabau - Minang
</div><div class="small-4 columns"> ml - liviox alvax - Malayalam
</div><div class="small-4 columns"> mr - मराठी - Marathi
</div><div class="small-4 columns"> ms - Bahasa Melayu - Malay
</div><div class="small-4 columns"> nl - Nederlands - Dutch
</div><div class="small-4 columns"> pl - Polski - Polish
</div><div class="small-4 columns"> pt - Português - Portuguese
</div><div class="small-4 columns"> pt-br - Português do Brasil - Brazilian Portuguese
</div><div class="small-4 columns"> ro - Română - Romanian
</div><div class="small-4 columns"> ru - Русский - Russian
</div><div class="small-4 columns"> sl - Slovenščina - Slovenianjtökók
</div><div class="small-4 columns"> sq - Shqip - Albanian
</div><div class="small-4 columns"> sv - Svenska - Swedish
</div><div class="small-4 columns"> sw - Kiswahili - Swahili
</div><div class="small-4 columns"> ta - தமிழ் - Tamil
</div><div class="small-4 columns"> th - ไทย - Thai
</div><div class="small-4 columns"> tr - Türkçe - Turkish
</div><div class="small-4 columns"> vi - Tiếng Việt - Vietnamese
</div><div class="small-4 columns"> zh - 中文 - Chinese
</div><div class="small-4 columns"> zh-tw - 繁體中文 - Traditional Chinese
</div>

<noinclude>
[[Category:Documentation Wiki Policies and Guidelines{{#translation:}}]]
[[Category:Documentation Translation{{#translation:}}]]
[[Category:Volunteer Engagement{{#translation:}}]]
</noinclude>

J4.x talk:Developing an MVC Component

2021-03-20T12:15:35Z

Krauthos: I'd like to help with the documentation

M-b-o, I appreciate you adding language tagging, but as per the translation guide I am not intending to do so until I am confident the text is correct. --[[User:GregJPreece|GregJPreece]] ([[User talk:GregJPreece|talk]]) 17:22, 13 December 2020 (CST)

Hi there, please let me know if and how I can help with the documentation of „Developing an MVC Component“. [[User:Krauthos|Krauthos]] ([[User talk:Krauthos|talk]]) 07:15, 20 March 2021 (CDT)

User:Krauthos

2021-03-20T10:09:32Z

Krauthos: Created page with "IT-Consultant & Graphic Artist based in Graz, Austria."

IT-Consultant & Graphic Artist based in Graz, Austria.

User talk:Krauthos

2021-03-20T10:08:20Z

Krauthos:

Hey man, thanks for your corrections on the Joomla 4 tutorial. I'll be continuing with the rest of it soon - there's a lot to get through! --[[User:GregJPreece|GregJPreece]] ([[User talk:GregJPreece|talk]]) 17:44, 19 March 2021 (CDT)

Sure, thanks for your work so far!
Looking forward to the complete tutorial, let me know if I can help somehow, I would be in to write a chapter or more.
(I hope that's the right way to reply to your comment).
[[User:Krauthos|Krauthos]] ([[User talk:Krauthos|talk]]) 05:08, 20 March 2021 (CDT)

J4.x:Developing an MVC Component/Adding a Menu Type to the Site Part

2021-03-19T21:44:44Z

Krauthos: path to the configuration file was incorrect

J4.x:Developing an MVC Component/Adding a Menu Type to the Site Part

2021-03-19T21:42:42Z

Krauthos: site and src folder have been mixed up

J4.x:Developing an MVC Component/Adding a View to the Site Part

2021-03-19T21:31:16Z

Krauthos: added required filetype extension .php to Controller

{{Joomla version|version=4.x|comment=>Tutorial}}
{{-}}
{{Top portal heading|color=white-bkgd|icon=file-code-o|icon-color=#5091cd|size=5x|text-color=#333|title=Adding a View to the Site Part}}
{{-}}
{{Chunk:Developing_a_Model-View-Controller_(MVC)_Component_for_Joomla!4.x_-_Contents/<translate>en</translate>}}
{{Chunk:Developing_a_Model-View-Controller_(MVC)_Component_for_Joomla!4.x_-_Notes/<translate>en</translate>}}

== Adding the View ==

Though a component is split into "admin" and "site" parts, the process of adding a view is very similar in both. Just as in the basic view we made in the last article, we will require a controller, a view, and a template.

To get started, let's first create the new files for the site page. As before, the source code for each file can be found under [[#File Details|File Details]].

{|border=1
| 1
| Create: [[#site/src/Controller/DisplayController.php|site/src/Controller/DisplayController.php]]
| The default MVC Controller for the site part
|-
| 2
| Create: [[#site/src/View/Hello/HtmlView.php|site/src/View/Hello/HtmlView.php]]
| The MVC View object for the new "Hello" page
|-
| 3
| Create: [[#site/tmpl/hello/default.php|site/tmpl/hello/default.php]]
| The template for the new "Hello" page
|-
| 4
| Update: [[#helloworld.xml|helloworld.xml]]
| Need to add the new files to the component's manifest
|}

== File Details ==

{{vanchor|site/src/Controller/DisplayController.php}}

The default MVC controller in the site part. We have some basic code in here to fetch and render a view, but as before we're mostly delegating to the parent Joomla! class. As this is a PHP class, it lives under your PHP namespace root <tt>src/</tt>, in the <tt>Controller</tt> namespace.

<source lang="php">
<?php

namespace JohnSmith\Component\HelloWorld\Site\Controller;

defined('_JEXEC') or die;

use Joomla\CMS\MVC\Controller\BaseController;
use Joomla\CMS\Factory;

/**
* @package Joomla.Site
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2020 John Smith. All rights reserved.
* @license GNU General Public License version 3; see LICENSE
*/

/**
* HelloWorld Component Controller
* @since 0.0.2
*/
class DisplayController extends BaseController {

public function display($cachable = false, $urlparams = array()) {
$document = Factory::getDocument();
$viewName = $this->input->getCmd('view', 'login');
$viewFormat = $document->getType();

$view = $this->getView($viewName, $viewFormat);

$view->document = $document;
$view->display();
}

}
</source>

{{vanchor|site/src/View/Hello/HtmlView.php}}

The MVC view for this "Hello World" page. As before, this file simply delegates to the parent object to get us started. As this is a PHP class, it lives under <tt>src/</tt>, in the <tt>View/Hello</tt> namespace that matches the view's name.

<source lang="php">
<?php

namespace JohnSmith\Component\HelloWorld\Site\View\Hello;

defined('_JEXEC') or die;

use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;

/**
* @package Joomla.Site
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2020 John Smith. All rights reserved.
* @license GNU General Public License version 3; see LICENSE
*/

/**
* View for the user identity validation form
*/
class HtmlView extends BaseHtmlView {

/**
* Display the view
*
* @param string $template The name of the layout file to parse.
* @return void
*/
public function display($template = null) {
// Call the parent display to display the layout file
parent::display($template);
}

}
</source>

{{vanchor|site/tmpl/hello/default.php}}

The page template for our "Hello World" page in the site part. This is identical to the template we used in the admin part, to get us started. As a template, it lives under <tt>tmpl</tt> in a folder that matches the view's name.

<source lang="php">
<?php

/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2020 John Smith. All rights reserved.
* @license GNU General Public License version 3; see LICENSE
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted Access');
?>
<h2>Hello world!</h2>
</source>

{{vanchor|helloworld.xml}}

Finally, let's update the component's manifest to include the new files. We need to tell Joomla! that the new files exist so that it will copy them into place. We'll also update the extension's version number in the manifest - right now, this has no real effect, but in the future changing the version number will have more significance so it's a good habit to get into.

<source lang="xml" highlight="13,32-35">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="4.0" method="upgrade">

<name>Hello World</name>

<creationDate>December 2020</creationDate>

<author>John Smith</author>
<authorUrl>https://smith.ca</authorUrl>
<copyright>John Smith</copyright>
<license>GPL v3</license>

<version>0.0.2</version>

<description>
A hello world component!
</description>


<namespace path="src/">JohnSmith\Component\HelloWorld</namespace>

<files folder="site/">
<folder>src</folder>
<folder>tmpl</folder>
</files>

<administration>

<menu link="index.php?option=com_helloworld">Hello World</menu>

<files folder="admin/">
<folder>services</folder>
<folder>src</folder>
<folder>tmpl</folder>
</files>
</administration>

</extension>
</source>

== Updating the Extension ==

To test the changes to your extension, first you will need to zip up the <tt>com_helloworld</tt> folder and install it just as you did before. We'll go through the process step-by-step one more time here:

# Using your web browser, navigate to the Administrator panel of your Joomla! site. The address would be <tt><joomla>/administrator/</tt>. For example: <tt>http://localhost/joomla/administrator/</tt>
# On the left menu, click the "System" link.
# On the "Install" card, click "Extensions".
# On the "Upload Package File" tab, browse for and select the .zip file you just created.

Once your new component version is installed, click the "System" link on the main menu again, then select "Extensions" on the "Manage" card this time. A list of the installed Joomla! extensions should appear. Type "hello" into the search bar at the top right and hit return. You should see your "Hello World" extension, now listed as version 0.0.2.

[[File:Joomla 4.x Component Tutorial 0.0.2 Component Listing.png|frameless|The Hello World component, listed in the Joomla! extensions directory.]]

== Testing the New Page ==

The new page has no menu link yet (we will add that in the next article) so to test it we'll need to use a direct URL. Go to <tt><joomla>/index.php?option=com_helloworld&view=hello</tt> (not inside the <tt>/administrator</tt> path), and you should see your new "Hello World" site page appear.

[[File:Joomla_4.x_Component_Tutorial_0.0.2_Hello_World.png|frameless|The Hello World page as it appears on Joomla 4 Beta 5.]]

Next, we will add menu configuration for this page, so that it can be used inside the Joomla! menu system.

<div class="row">
<div class="large-6 columns">{{Basic button|
S:MyLanguage/J4.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Prev: Developing a Basic Component|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|
S:MyLanguage/J4.x:Developing_an_MVC_Component/Adding_a_Menu_Type_to_the_Site_Part|Next: Adding a Menu Type to the Site Part|class=expand}}</div>
</div>

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