<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

:'''<code>/admin/services</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/services/provider.php</code>'''
:: Diese Datei enthält eine anonyme Klasse, die <code>\Joomla\DI\ServiceProviderInterface</code> implementiert. Ihre Aufgabe ist es, den Dependency-Injection-Container zurückzugeben, der mit allen Factories versehen ist, die für den Betrieb Ihrer Komponente benötigt werden (in allen 3 Webanwendungen, in denen sie laufen dürfen).

:'''<code>/admin/src/Extension</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: Diese Datei ist die öffentliche Seite der Erweiterung. Sie ruft Daten aus dem Container ab, der in der oben genannten Provider-Datei erzeugt wurde, und stellt die entsprechenden Dienste zur Verfügung (zugänglich über <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). Diese Klasse wird von Modulen verwendet, um Zugriff auf die Komponentenmodelle zu erhalten oder um eine Komponente über Joomla laufen zu lassen, wenn eine Seite geladen wird (indem der Dispatcher abgerufen wird).

In einigen Fällen kann es sinnvoll sein, Klassen zwischen dem Website- und dem Admin-Teil der Komponente gemeinsam zu nutzen. Insbesondere Modelle können gemeinsam genutzt werden, um die Duplizierung von Modellcode zu vermeiden. Die Joomla-Plattform unterstützt diese Strategie. Beim Teilen von Code zwischen Site- und Admin-Anwendungen sollten die Klassen mit großer Sorgfalt entworfen werden, um die Möglichkeit auszuschließen, dass ein Site-Benutzer Admin-Aktionen ausführt.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/30/de

2020-08-30T17:38:46Z

In einigen Fällen kann es sinnvoll sein, Klassen zwischen dem Website- und dem Admin-Teil der Komponente gemeinsam zu nutzen. Insbesondere Modelle können gemeinsam genutzt werden, um die Duplizierung von Modellcode zu vermeiden. Die Joomla-Plattform unterstützt diese Strategie. Beim Teilen von Code zwischen Site- und Admin-Anwendungen sollten die Klassen mit großer Sorgfalt entworfen werden, um die Möglichkeit auszuschließen, dass ein Site-Benutzer Admin-Aktionen ausführt.

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:37:15Z

Blancanieve: Created page with "Diese Datei ist die öffentliche Seite der Erweiterung. Sie ruft Daten aus dem Container ab, der in der oben genannten Provider-Datei erzeugt wurde, und stellt die entsprechen..."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

:'''<code>/admin/services</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/services/provider.php</code>'''
:: Diese Datei enthält eine anonyme Klasse, die <code>\Joomla\DI\ServiceProviderInterface</code> implementiert. Ihre Aufgabe ist es, den Dependency-Injection-Container zurückzugeben, der mit allen Factories versehen ist, die für den Betrieb Ihrer Komponente benötigt werden (in allen 3 Webanwendungen, in denen sie laufen dürfen).

:'''<code>/admin/src/Extension</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: Diese Datei ist die öffentliche Seite der Erweiterung. Sie ruft Daten aus dem Container ab, der in der oben genannten Provider-Datei erzeugt wurde, und stellt die entsprechenden Dienste zur Verfügung (zugänglich über <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). Diese Klasse wird von Modulen verwendet, um Zugriff auf die Komponentenmodelle zu erhalten oder um eine Komponente über Joomla laufen zu lassen, wenn eine Seite geladen wird (indem der Dispatcher abgerufen wird).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/34/de

2020-08-30T17:37:14Z

Diese Datei ist die öffentliche Seite der Erweiterung. Sie ruft Daten aus dem Container ab, der in der oben genannten Provider-Datei erzeugt wurde, und stellt die entsprechenden Dienste zur Verfügung (zugänglich über <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). Diese Klasse wird von Modulen verwendet, um Zugriff auf die Komponentenmodelle zu erhalten oder um eine Komponente über Joomla laufen zu lassen, wenn eine Seite geladen wird (indem der Dispatcher abgerufen wird).

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:24:23Z

Blancanieve: Created page with "Dieser Ordner enthält nur eine Datei."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

:'''<code>/admin/services</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/services/provider.php</code>'''
:: Diese Datei enthält eine anonyme Klasse, die <code>\Joomla\DI\ServiceProviderInterface</code> implementiert. Ihre Aufgabe ist es, den Dependency-Injection-Container zurückzugeben, der mit allen Factories versehen ist, die für den Betrieb Ihrer Komponente benötigt werden (in allen 3 Webanwendungen, in denen sie laufen dürfen).

:'''<code>/admin/src/Extension</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/33/de

2020-08-30T17:24:23Z

Blancanieve: Created page with "Dieser Ordner enthält nur eine Datei."

Dieser Ordner enthält nur eine Datei.

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:23:46Z

Blancanieve: Created page with "Diese Datei enthält eine anonyme Klasse, die <code>\Joomla\DI\ServiceProviderInterface</code> implementiert. Ihre Aufgabe ist es, den Dependency-Injection-Container zurückzu..."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

:'''<code>/admin/services</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/services/provider.php</code>'''
:: Diese Datei enthält eine anonyme Klasse, die <code>\Joomla\DI\ServiceProviderInterface</code> implementiert. Ihre Aufgabe ist es, den Dependency-Injection-Container zurückzugeben, der mit allen Factories versehen ist, die für den Betrieb Ihrer Komponente benötigt werden (in allen 3 Webanwendungen, in denen sie laufen dürfen).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/29/de

2020-08-30T17:23:46Z

Diese Datei enthält eine anonyme Klasse, die <code>\Joomla\DI\ServiceProviderInterface</code> implementiert. Ihre Aufgabe ist es, den Dependency-Injection-Container zurückzugeben, der mit allen Factories versehen ist, die für den Betrieb Ihrer Komponente benötigt werden (in allen 3 Webanwendungen, in denen sie laufen dürfen).

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:22:49Z

Blancanieve: Created page with "Dieser Ordner enthält nur eine Datei."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

:'''<code>/admin/services</code>'''
:Dieser Ordner enthält nur eine Datei.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/28/de

2020-08-30T17:22:49Z

Blancanieve: Created page with "Dieser Ordner enthält nur eine Datei."

Dieser Ordner enthält nur eine Datei.

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:22:28Z

Blancanieve: Created page with "Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:"

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/27/de

2020-08-30T17:22:27Z

Blancanieve: Created page with "Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:"

Es gibt zwei zusätzliche Ordner im Administrator-Verzeichnis:

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:21:52Z

Blancanieve: Created page with "Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardm..."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

There are two additional parts in the administrator directory:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/26/de

2020-08-30T17:21:52Z

Die Dateistruktur ist fast genau die gleiche wie im Ordner ''/site''. Es sollte beachtet werden, dass die Ansicht, Modelle, Controller usw. des Site- und Admin-Teils standardmäßig vollständig voneinander getrennt sind und nichts miteinander zu tun haben - der Site-Teil und der Admin-Teil können als zwei verschiedene Komponenten betrachtet werden! Eine Ansicht im Ordner ''/admin'' kann ein gleichnamiges Gegenstück im Ordner ''/site'' haben, aber die beiden Ansichten haben nichts gemeinsam, außer ihren Klassennamen (obwohl sie unterschiedliche Namensräume haben werden, um sie zu trennen).

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:20:25Z

Blancanieve: Created page with "== Der Ordner ''/admin'' =="

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== Der Ordner ''/admin'' ==
The file structure is almost exactly the same as in the /site folder. Note that the view, models, controllers etc. of the site and admin parts are by default completely separated, and have nothing to do with each other - the site part and the admin part can be thought of as two different components! A view in the /admin folder may have a counterpart with the same name in the /site folder, yet the two views have nothing in common but their class names (although they will have different namespaces to separate them).

There are two additional parts in the administrator directory:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/25/de

2020-08-30T17:20:25Z

Blancanieve: Created page with "== Der Ordner ''/admin'' =="

== Der Ordner ''/admin'' ==

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:20:06Z

Blancanieve: Created page with "Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus..."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

== The /admin folder ==
The file structure is almost exactly the same as in the /site folder. Note that the view, models, controllers etc. of the site and admin parts are by default completely separated, and have nothing to do with each other - the site part and the admin part can be thought of as two different components! A view in the /admin folder may have a counterpart with the same name in the /site folder, yet the two views have nothing in common but their class names (although they will have different namespaces to separate them).

There are two additional parts in the administrator directory:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/32/de

2020-08-30T17:20:06Z

Diese Datei enthält den Site-Dispatcher. Er lädt die Sprachdateien, führt eine Komponentenzugriffsprüfung durch und ruft anschließend den Controller ab und führt ihn aus. Dabei führt er in Komponenten mit HTML-Ausgabe bei Bedarf auch Umleitungen aus.

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:18:58Z

Blancanieve: Created page with "Dieser Ordner enthält den Site-Dispatcher."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::Dieser Ordner enthält den Site-Dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::This file holds the site dispatcher. It loads the language files, does a component access check and then gets and executes the controller, in components with HTML output also executing redirects if required.

== The /admin folder ==
The file structure is almost exactly the same as in the /site folder. Note that the view, models, controllers etc. of the site and admin parts are by default completely separated, and have nothing to do with each other - the site part and the admin part can be thought of as two different components! A view in the /admin folder may have a counterpart with the same name in the /site folder, yet the two views have nothing in common but their class names (although they will have different namespaces to separate them).

There are two additional parts in the administrator directory:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/31/de

2020-08-30T17:18:57Z

Blancanieve: Created page with "Dieser Ordner enthält den Site-Dispatcher."

Dieser Ordner enthält den Site-Dispatcher.

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:18:37Z

Blancanieve: Created page with "Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern:"

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern: <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::This folder holds the site dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::This file holds the site dispatcher. It loads the language files, does a component access check and then gets and executes the controller, in components with HTML output also executing redirects if required.

== The /admin folder ==
The file structure is almost exactly the same as in the /site folder. Note that the view, models, controllers etc. of the site and admin parts are by default completely separated, and have nothing to do with each other - the site part and the admin part can be thought of as two different components! A view in the /admin folder may have a counterpart with the same name in the /site folder, yet the two views have nothing in common but their class names (although they will have different namespaces to separate them).

There are two additional parts in the administrator directory:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/24/de

2020-08-30T17:18:36Z

Blancanieve: Created page with "Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern:"

Diese Datei enthält die Controller-Klasse <code>{ControllerName}</code>. Diese Klasse muss die Basisklasse erweitern:

J4.x:File Structure and Naming Conventions/de

2020-08-30T17:17:33Z

Blancanieve: Created page with "Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt."

<noinclude><languages /></noinclude>
{{RightTOC}}
{{notice|Dieses Dokument informiert über die neuen Konventionen speziell für Joomla 4. Joomla 4 unterstützt aus Gründen der Abwärtskompatibilität auch die alten Namenskonventionen für Joomla 3. Wenn Joomla 3 und Joomla 4 gleichzeitig unterstützen werden soll, können weiterhin die Konventionen für Joomla 3 verwendet werden, die unter '''[[J3.x:File_Structure_and_Naming_Conventions|Dateistruktur und Namenskonventionen für Joomla 3]]''' beschrieben sind.}}

Komponenten des Joomla-Kerns (und in der Tat im Allgemeinen im Joomla-Universum) folgen dem Model-View-Controller (MVC)-Designmuster. Dieses Muster trennt die Aktivitäten Datenerfassung (Model), Präsentation (View) und Benutzerinteraktion (Controller) einer Komponente. Eine solche Trennung ermöglicht es, Eigenschaften und Methoden eines Abschnitts zu erweitern oder zu überarbeiten, ohne dass zusätzliche Änderungen an den anderen Abschnitten erforderlich sind. Weitere Informationen dazu sind in den '''[[S:MyLanguage/Developing_a_Model-View-Controller_Component|MVC-Tutorials]]''' zu finden, die für mehrere Joomla-Versionen verfügbar sind.

Das Dateiladesystem von Joomla ermöglicht es Entwicklern, mit separaten Dateien für Controller, Views und Models zu arbeiten, ohne sich um den Import der richtigen Datei an der richtigen Stelle kümmern zu müssen. Damit dies jedoch funktioniert, müssen bestimmte Namenskonventionen eingehalten werden.

Die Joomla-Plattform ist äußerst flexibel, und es ist möglich, in vielerlei Hinsicht von diesen Konventionen abzuweichen. Es wird dennoch empfohlen, wo immer möglich, Standardnamen zu verwenden, um die Lesbarkeit und Wartbarkeit zu erhöhen. Darüber hinaus wird die Plattform die vielen mühsamen Aufgaben zur Verwaltung von Klassen übernehmen, wenn die Dateien und Klassen einer Komponente korrekt benannt sind.

== Reservierte Begriffe ==

Es gibt reservierte Wörter, die nicht in Namen von Klassen und Komponenten verwendet werden können.

Ein Beispiel ist das Wort "model" (in jedem Fall) für Modellklassen (außer "model", das der zweite Teil des Klassennamens sein muss)<ref>der Grund ist in der Funktion ''getName'' in der Datei '''libraries/src/MVC/Model/BaseDatabaseModel.php''' zu finden:
<source lang="php" inline> if (!preg_match('/Model(.*)/i', get_class($this), $r))</source></ref>.
Da der erste Teil des Namens von Modellklassen derselbe ist wie der Controller-Klassenname, können Controller-Klassennamen auch nicht das Wort "Model" enthalten. Und aufgrund der Konventionen (auch wenn die Verletzung dieser Konventionen keinen Fehler erzeugt) müssen Controller-Klassennamen den Komponentennamen enthalten, so dass Komponentennamen auch nicht das Wort "Model" enthalten dürfen. Komponenten können also nicht "com_modelling" genannt werden. Falls doch, verletzen sie die Namenskonventionen und müssen einen anderen Basis-Controller-Klassennamen (oder andere Hacks) haben.

== Installationspaket und tatsächlicher Ort von Dateien ==

Alle Joomla-Erweiterungen müssen als .zip-Installationsdatei gepackt werden. Nach der gebräuchlichsten Dateianordnung sollte das Paket in seiner Grundstruktur mindestens den ''admin''-Ordner enthalten. Es kann zusätzlich (unter anderem) enthalten:
* <code>site</code>
* <code>admin</code>
Wenn die XML-Manifestdatei gemäß der Standardpraxis einrichtet ist, wird der Inhalt von <code>site</code> in <code>/components/com_{komponentenname}</code> installiert, während der Inhalt von <code>admin</code> in <code>/administrator/components/com_{komponentenname}</code> installiert wird (Hinweis: In diesen Pfaden ist der Komponentenname kleingeschrieben).

== Der Ordner ''/site'' ==
In diesem Ordner befinden sich die Dateien für den Frontend-Teil der Komponente.
:'''<code>/site/forms</code>'''
:Dieser Ordner enthält die XML-Formulare, die von <source lang="php" inline>\Joomla\CMS\Form\Form</source> verwendet werden.

:'''<code>/site/tpl</code>'''
:Dieser Ordner enthält die Ansichten, die im Template erscheinen sollen.

::'''<code>/site/tpl/{viewname}</code>'''
::Dieser Ordner enthält die Dateien für die Ansicht {ViewName}. Hinweis: Der Pfad verwendet hier den Ansichtsnamen in Kleinbuchstaben.

:::'''<code>/site/src/tpl/{viewname}/default.php</code>'''
:::Dies ist das Standard-Template für die Ansicht {ViewName}. In dieser PHP-Datei bezieht sich das Schlüsselwort <code>$this</code> auf die View-Klasse, zu der die Vorlage gehört.

:'''<code>/site/src</code>'''
:Dieser Ordner enthält den auf Namensräume bezogenen PHP-Code für das Frontend der Komponente. Die Konventionen bezüglich der Namensräume werden unter '''[[J4.x:Namespace_Conventions_In_Joomla|Namensraum-Konventionen in Joomla 4]]''' beschrieben.

::'''<code>/site/src/View</code>'''
::Dieser Ordner enthält die verschiedenen Ansichten (Views) für die Komponente.

:::'''<code>/site/src/View/{ViewName}/HtmlView.php</code>'''
:::Diese Datei ist der Einstiegspunkt für die Ansicht {ViewName}. Diese Klasse muss das Interface <code>\Joomla\CMS\MVC\View\ViewInterface</code> implementieren und erweitert die formatspezifische Klasse (wenn der Kern sie bereitstellt - wie z. B. <code>\Joomla\CMS\MVC\View\HtmlView</code>) oder <code>\Joomla\CMS\MVC\View\AbstractView</code>. Der Dateiname bezieht sich auf das Format, in dem die Ansicht geladen wird. Wenn zum Beispiel der URL-Parameter <code>format</code> auf <code>format=feed</code> gesetzt ist, wird die Datei <code>FeedView</code> geladen.

::'''<code>/site/src/Model</code>'''
::Dieser Ordner enthält zusätzliche Modelle, falls diese von der Anwendung benötigt werden.

:::'''<code>/site/Model/{ModelName}.php</code>'''
:::Diese Datei enthält die Modellklasse <code>{ModelName}</code>. Diese Klasse muss die Basisklasse <code>\Joomla\CMS\MVC\Model\BaseDatabaseModel</code> erweitern. Es ist zu beachten, dass die Ansicht mit dem Namen {ViewName} standardmäßig ein Modell mit dem Namen {ViewName} lädt, falls es existiert. Die meisten Modelle sind nach der Ansicht benannt, mit der sie verwendet werden sollen, aber dies ist '''keine''' Voraussetzung. Weitere Informationen sind unter '''[[S:MyLanguage/Using_multiple_models_in_an_MVC_component|Verwendung mehrerer Modelle in einer MVC-Komponente]]''' zu finden.

::'''<code>/site/src/Controller</code>'''
::Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.

:::'''<code>/site/src/Controller/{ControllerName}.php</code>'''
:::This file holds the controller class <code>{ControllerName}</code>. This class must extend the base class <code>\Joomla\CMS\MVC\Controller\BaseController</code>.

::'''<code>/site/src/Dispatcher</code>'''
::This folder holds the site dispatcher.

:::'''<code>/site/src/Dispatcher/Dispatcher.php</code>'''
:::This file holds the site dispatcher. It loads the language files, does a component access check and then gets and executes the controller, in components with HTML output also executing redirects if required.

== The /admin folder ==
The file structure is almost exactly the same as in the /site folder. Note that the view, models, controllers etc. of the site and admin parts are by default completely separated, and have nothing to do with each other - the site part and the admin part can be thought of as two different components! A view in the /admin folder may have a counterpart with the same name in the /site folder, yet the two views have nothing in common but their class names (although they will have different namespaces to separate them).

There are two additional parts in the administrator directory:

:'''<code>/admin/services</code>'''
:This folder holds a single file.

::'''<code>/admin/services/provider.php</code>'''
:: This file holds an anonymous class implementing <code>\Joomla\DI\ServiceProviderInterface</code>. It's job is to return the Dependency Injection container provisioned with all the factories needed to run your component (in all 3 web applications they may run in).

:'''<code>/admin/src/Extension</code>'''
:This folder holds a single file.

::'''<code>/admin/src/Extension/{ComponentName}Component.php</code>'''
:: This file is the public face of the extension, it retrieves data from the Container produced in the provider file above and exposes the relevant services (accessible via <source lang="php" inline>\Joomla\CMS\Application\CMSApplication::bootComponent()</source>). This class is used by modules to get access to the component models or to run a component by Joomla when loading a page (by getting the dispatcher).

In some cases it might sometimes make sense to share classes between the site and admin parts of the component. Especially models can be shared to avoid duplicating model code. The Joomla platform supports this strategy. When sharing any code between site and admin applications, the classes should be designed with great care to avoid the possibility of a site user executing admin actions.

<noinclude>
<references/>
[[Category:Development{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
</noinclude>

Translations:J4.x:File Structure and Naming Conventions/23/de

2020-08-30T17:17:33Z

Blancanieve: Created page with "Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt."

Dieser Ordner enthält zusätzliche Controller, falls von der Anwendung benötigt.