Joomla! Documentation - User contributions [en]

User talk:Null

2025-01-25T11:42:39Z

Max123kl: welcome

{{New User welcome}} [[User:Max123kl|Max123kl]] ([[User talk:Max123kl|talk]]) 11:42, 25 January 2025 (UTC)

JDOC:How to Contribute to Joomla! Documentation/de

2025-01-24T09:02:13Z

Max123kl:

<noinclude><languages /></noinclude>
Die Dokumentation von Joomla! wird durch die Plattform [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] ermöglicht. Das Wachstum und der Erfolg von Joomla! hängt von [[Special:ActiveUsers|Menschen wie Dir]] ab. Vielen Dank, dass Du den ersten Schritt zum Mithelfen bei unserem Joomla!-Projekt gemacht hast. Diese Seite zeigt, wie man anfangen und die Dokumentation unterstützen kann.

{{amboxNew|image=notice|style=notice|title={{{title|Neue Dokumentation}}}|text=Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren.</br>Wir bitten Sie, Ihre Beiträge nicht mehr zu diesem Wiki hinzuzufügen; die Informationen auf dieser Seite sind veraltet.</br>
'''Ihre Hilfe bei der Aktualisierung ist höchst willkommen und wird geschätzt! Bitte melden Sie Ihre Vorschläge, Verbesserungen oder Angebote für Hilfe auf [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''}}

==Erste Schritte!==

Es gibt ein paar Dinge, die man zuerst erledigen muss.

====Die Wiki-Nutzungsbedingung lesen====
Du solltest die Joomla-Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki-Nutzungsbedingungen]]''' lesen, bevor du mit der Bearbeitung beginnst.

====Benutzerkonto einrichten====
Um im Joomla!-Dokumentations-Wiki mitzuarbeiten, benötigst du ein Benutzerkonto. Du kannst '''{{strikethrough|hier einen Account anlegen}}'''. Bestätige anschließend unbedingt deine E-Mail-Adresse. Mit der Bestätigung der E-Mail-Adresse erhältst du die Berechtigung, jede Seite, mit Ausnahme einiger geschützten Seiten zu bearbeiten.

''Hinweis: Wenn man innerhalb von 5 Tagen nach der Erstellung des Kontos keine Änderungen/Bearbeitungen vornimmt, wird das Konto aus Sicherheitsgründen automatisch wieder gelöscht.''

====Benutzerseite erstellen====
Nachdem man ein Benutzer-Konto erstellt, die E-Mail-Adresse bestätigt und sich angemeldet hat, empfiehlt es sich, sich ein paar Augenblicke Zeit zu nehmen, um eine Benutzer-Seite zu erstellen.
Das Erstellen einer Benutzerseite dient mehreren Zielen:
* So können Benutzer mehr über dich erfahren.
* Damit kannst du einige erste Eingaben machen, damit der [[User:Abuse filter|Wiki-Spammer- und Missbrauchsfilter]] erkennen kann, dass du kein Fake-Benutzer bist. Beachte, bei deinen ersten Bearbeitungen keine externen Links einzufügen, da diese wahrscheinlich die Filter auslösen werden.
Ein schneller Einstieg für die Benutzerseite:
*Gehe im Benutzermenü auf die Seite mit deinem '''Benutzernamen''' (oder nimm den ersten Menüpunkt ganz rechts oben im Dropdown-Menü)
*Klick auf die Dropdown-Schaltfläche "Aktionen"{{-}}[[File:JDOCS-actions-create-page-de.png]]
*Klicke "Bearbeiten"
*Füge den Code zum Editor hinzu <code><nowiki>{{subst:Newuser}}</nowiki></code>
*Zusammenfassung ausfüllen (z.B. ''Das ist meine neue User-Seite''){{-}}[[File:JDOCS-summary-form-input-de.png]]
*Klicke "Seite speichern"

====Anmelden bei den Kommunikationskanälen der Dokumentation====
Das offizielle Kommunikationswerkzeug von Joomla ist [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. Auf [[Mattermost|dieser Seite]] findest Du Informationen darüber, wie man der Unterhaltung beitreten kann. Wenn man einmal dabei ist, kann man dem [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation]-Kanal beitreten und an der Diskussion über die Joomla!-Dokumentation teilnehmen.

==Was sollte man zuerst tun?==
Es gibt mehrere Bereiche der Dokumentation, die immer wieder Aufmerksamkeit brauchen. Man könnte damit beginnen, Dokumente auszuwählen, die für einen am bequemsten sind. Oder man engagiert sich mehr, indem man an mehreren gleichzeitig arbeitet. Sobald man ein Wiki-Konto hat, kann an jedem Aspekt der Dokumentation gearbeitet werden, der einem gefällt. Selbst die einfachsten Beiträge wie Rechtschreib-Korrekturen und Grammatik-Korrekturen sind eine große Hilfe!
#[[#Unterstützung bei den Dokumentations-Inhalten|Unterstützung bei den Dokumentations-Inhalten]].
#[[#Wiki Wartungsaufgaben|Wiki Wartungsaufgaben]].
#[[#Dokumentations-Projekte|Dokumentations-Projekte]].
#[[#Hilfeseiten|Hilfeseiten]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]].

===Unterstützung bei den Dokumentations-Inhalten===

#Bearbeiten, Überschreiben und Umstrukturieren von Seiten. In unserem Wiki gibt es [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs-Seiten]] für Bereiche, die sofortige Hilfe benötigen. Sie werden 'Needs-Seiten' genannt, weil sie kleine Aufgaben benötigen, um sie zu vervollständigen. Einige von ihnen sind so einfach wie die Überprüfung des Inhalts oder das Hinzufügen eines Bildes. Andere erfordern mehr Inhalt oder Verbesserungen. Nimm ein paar davon und schenke ihnen ein wenig Zuwendung. Dies ist eine enorme Hilfe für Joomla! Benutzer, die sich auf unsere Dokumentation verlassen.
#Hast du Spaß beim Suchen nach Seiten, die überflüssig sind (z.B. über die Versionen 1.0 und 1.5), oder die wegen versionsspezifischer Informationen aufgeteilt werden müssen? Dann verwende die Marker-Templates {{tl|delete}}, {{tl|merge}} oder {{tl|JSplit}} auf den betreffenden Seiten. Um zu erfahren, wie man sie einsetzt, klicke auf die vorherigen Template-Links. Dort erfährst du, wie man sie auf Seiten anwenden kann, von denen du denkst, dass diese die Markierungen benötigen. Füge sie ganz oben auf einer Seite ein und die Seite ist markiert.
#'''Erstelle eine neue Seite oder Tutorial''' Mach vor der Erstellung einer neuen Seite erst eine intensive Suche. Erstelle keine weitere Seite, wenn bereits eine existiert. Benutze die [[Special:Search|Suche]] des JDocs Wiki, um zu sehen, ob der Begriff bereits auf einer Seite existiert. '''Duplikate werden zusammengeführt und / oder gelöscht'''. Habe keine Angst, die Arbeit eines Anderen an der Joomla-Dokumentation zu verändern, neu zu formatieren oder zu verbessern! Dies ist ein kollaboratives Dokumentations-Wiki, stelle einfach sicher, dass den [[S:MyLanguage/JDOC:Policies and guidelines|Grundsätzen und Richtlinien]] gefolgt wird.
##''Wiki-Links einsetzen.'' Es ist sehr einfach, Seiten mit einer Standardsyntax zu verlinken. Wenn man einen Link zu einer Seite erstellt, die noch nicht existiert, wird der Link rot eingefärbt. Ein Klick auf einen roten Link führt direkt zur Bearbeitungsseite der neuen Seite. Gib einfach den gewünschten Inhalts-Text ein, klicke auf Speichern und die neue Seite wird erstellt. Danach wechselt der Link von rot auf blau und zeigt damit an, dass die Seite nun existiert.
##''URL einsetzen.'' Einzusetzen, wenn man eine Seite von Grund auf neu erstellen möchte. Man kann die URL des Wikis zum Erstellen einer neuen Seite verwenden. Die URL zu einem Artikel des Wikis ist normalerweise ähnlich wie: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. Wenn man YOURTITLE durch den Namen der Seite ersetzt, die man erstellen möchte, gelangt man auf eine leere Seite, die anzeigt, dass noch keine Seite dieses Namens existiert. Ein Klick auf den ''Seite erstellen''-Link führt zur Bearbeitungs-Seite der neuen Seite. Hier kann der Inhalt eingegeben werden, durch Klick auf ''Speichern'' wird die Seite angelegt.
#'''Hilfe durch Aktualisieren von Bildern in Seiten.''' Schau in die Kategorie [[S:MyLanguage/:Category:Needs image updating|Zu aktualisierende Bilder]] um die Liste an Seiten zu sehen, in denen Bilder aktualisiert werden müssen. Vorgaben dafür finden sich in den [[S:MyLanguage/JDOC:Image naming guidelines|Richtlinien zur Bildbenennung]].

===Wiki Wartungsaufgaben===
:Ein Wiki zu warten und zu organisieren bedarf eine Menge an kontinuierlicher Arbeit der Administratoren, Redakteure und Benutzer. Es gibt immer Aufgaben, die Aufmerksamkeit benötigen wie z.B.: [[Special:UncategorizedPages|Nicht kategorisierte Seiten]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Joomla! Wiki Seiten, die Hilfe brauchen]] oder auch [[S:MyLanguage/Category:Article_under_construction|Seite befindet sich in Bearbeitung]], das Markieren von Seiten für [[Template:Delete|Löschung]], [[Template:Merge|Zusammenführung]] oder [[Template:JSplit|Aufteilung]]. Für alle Wartungsaufgaben und Ideen wie man den JDocs helfen kann, besuche bitte unsere [[S:MyLanguage/JDOC:Maintenance Tasks|Wartungsseite]].

===Dokumentations-Projekte===
*Das JDocs-Team arbeitet an den [[S:MyLanguage/Tutorials:Beginners|Einsteiger Tutorials]]. Unser Ziel ist es, diese leicht verständlich und gut navigierbar zu machen, damit ein Anfänger die Dinge leicht nachvollziehen und Grundkonzepte erlernen kann. Denke mal daran, als du neu bei Joomla warst und füge ein Thema über etwas hinzu, mit dem man als Anfänger zu kämpfen hatte. Noch besser wäre es, dem [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Einsteiger-Tutorial-Projekt]] beizutreten.
*Tritt dem [[S:MyLanguage/JDOC:Developer Tutorials Project|Entwickler-Tutorial-Projekt]] bei und teile dein Wissen. Hinterlege Deinen Namen mit 4 Tilden ( <nowiki>~~~~</nowiki> ) auf der Seite [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] und liste auf, was du tun kannst. Gerne kannst du einige [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|Topics]] zur Liste der vorgeschlagenen Themen hinzufügen.

===Hilfeseiten===

Für viele unbekannt, werden alle [[S:MyLanguage/Help screens|Hilfe]] Seiten zu jeder Joomla-Installation weltweit von diesem Wiki aus erstellt und zur Verfügung gestellt! Diese sind für Anfänger und auch für die mit fortgeschrittenen Kenntnissen über Joomla notwendig.

'''Die Joomla! 4.x Hilfe-Seiten müssen komplett überarbeitet werden.''' Jeder Beitrag, den du leisten kannst, wird von vielen Benutzern weltweit geschätzt und wir suchen Freiwillige, die uns bei dieser wichtigen Aufgabe helfen können. Eine Matrix und ein Aktionsplan müssen noch erstellt werden.

==Wichtige Dinge==
Hier ein paar Dinge, die man sich als Helfer bei den Joomla-Docs merken sollte.

*Hab keine Angst, eine Seite zu beschädigen. Wenn du das tust und etwas wirklich schief gelaufen ist, kehre zum Editieren zurück. Klick auf die Registerkarte '''Versionsgeschichte''' der Seite und du siehst Links zum Widerrufen und Wiederherstellen.
*Schreibe die Beiträge in dem Bewusstsein, dass sie in eine andere Sprache übersetzt werden sollen. Die Verwendung von Slangausdrücken oder lokalen Dialekten kann dazu führen, dass diese nicht in eine andere Sprache übersetzt oder ihre Zusammenhänge nicht verstanden werden. Weitere Informationen findest du unter [[JDOC:Documentation Translators|Übersetzen der Joomla!-Dokumentation]].
*Die [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] lesen, der für alle Joomla-Dokumentationen gilt. Er gibt hilfreiche Hinweise, wie man für die Joomla Dokumentation schreibt.
*Beim Schreiben sollte auf die korrekte Rechtschreibung geachtet werden. Für eine sofortige Rückmeldung sollten Sie die Browser Google Chrome oder Mozilla Firefox verwenden. Beide haben eine integrierte Rechtschreibprüfung, die ein falsch geschriebenes Wort unterstreicht.
*Vergiss nicht das {{tl|inuse}}-Template an einen Artikel anzuwenden, den du für länger als eine Minute bearbeitest. Es hilft, Bearbeitungs-Konflikte zu vermeiden.

==Hilfe, ich kenne Wiki Markup nicht!==
Wenn du neu beim '''''Wiki''''' und der einfachen Markup für Seiten bist, kannst du Folgendes als Hilfe verwenden.
*Der neue WikiEditor hat Buttons und Links, um den Seitenbau einfach zu machen. Klick auf das Wort ''''Advanced'''' für mehr Buttons und Formatierungs-Links.
*Verwende [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] um grundlegende Syntax-Kommandos zu lernen. Es gibt auch ein Aufklappmenü mit den gebräuchlichen Markup im Editor. Klick auf das Wort ''Hilfe'', um sie aufzurufen.
*Noch unschlüssig? Diese Werkzeuge für die Wiki-Seiten versuchen
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], speichert Word-Dokumente als Wiki-Markup
:*'''OpenOffice.org versions 2.4 und später''' haben einen eingebauten MediaWiki-Exportfilter. Öffne das Writer-Dokument, klick auf "Datei → Export" und ändere das Dateiformat auf MediaWiki.
:*Hier eine [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|Liste von Werkzeugen]] um andere Formate wie HTML, Excel, CSV in Wiki-Markup umzuwandeln. Einige konvertieren ausgeschnittenes und eingefügtes HTML online in Wiki-Markup.
*Hilfe finden auf [https://joomlacommunity.cloud.mattermost.com/ Mattermost], (Wir haben dort eine Menge Kanäle. Beispielsweise einen für die JDocs Translation Group und einen für die JDocs Working Group).
*Eine Frage an einen [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 Administrator] oder [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 Editor] auf deren Diskussionsseite posten.

[[Category:Documentation Wiki Information/de]]
[[Category:Volunteer Engagement{{#translation:}}]]

Translations:JDOC:How to Contribute to Joomla! Documentation/47/de

2025-01-24T09:02:13Z

Max123kl:

Um im Joomla!-Dokumentations-Wiki mitzuarbeiten, benötigst du ein Benutzerkonto. Du kannst '''{{strikethrough|hier einen Account anlegen}}'''. Bestätige anschließend unbedingt deine E-Mail-Adresse. Mit der Bestätigung der E-Mail-Adresse erhältst du die Berechtigung, jede Seite, mit Ausnahme einiger geschützten Seiten zu bearbeiten.

JDOC:How to Contribute to Joomla! Documentation/de

2025-01-24T08:59:42Z

Max123kl: Created page with "'''Ihre Hilfe bei der Aktualisierung ist höchst willkommen und wird geschätzt! Bitte melden Sie Ihre Vorschläge, Verbesserungen oder Angebote für Hilfe auf [https://joomla..."

<noinclude><languages /></noinclude>
Die Dokumentation von Joomla! wird durch die Plattform [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] ermöglicht. Das Wachstum und der Erfolg von Joomla! hängt von [[Special:ActiveUsers|Menschen wie Dir]] ab. Vielen Dank, dass Du den ersten Schritt zum Mithelfen bei unserem Joomla!-Projekt gemacht hast. Diese Seite zeigt, wie man anfangen und die Dokumentation unterstützen kann.

{{amboxNew|image=notice|style=notice|title={{{title|Neue Dokumentation}}}|text=Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren.</br>Wir bitten Sie, Ihre Beiträge nicht mehr zu diesem Wiki hinzuzufügen; die Informationen auf dieser Seite sind veraltet.</br>
'''Ihre Hilfe bei der Aktualisierung ist höchst willkommen und wird geschätzt! Bitte melden Sie Ihre Vorschläge, Verbesserungen oder Angebote für Hilfe auf [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''}}

==Erste Schritte!==

Es gibt ein paar Dinge, die man zuerst erledigen muss.

====Die Wiki-Nutzungsbedingung lesen====
Du solltest die Joomla-Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki-Nutzungsbedingungen]]''' lesen, bevor du mit der Bearbeitung beginnst.

====Benutzerkonto einrichten====
<div class="mw-translate-fuzzy">
Um im Joomla!-Dokumentations-Wiki mitzuarbeiten, benötigst du ein Benutzerkonto. Du kannst '''[[Special:CreateAccount|hier einen Account anlegen]]'''. Bestätige anschließend unbedingt deine E-Mail-Adresse. Mit der Bestätigung der E-Mail-Adresse erhältst du die Berechtigung, jede Seite, mit Ausnahme einiger geschützten Seiten zu bearbeiten.
</div>

''Hinweis: Wenn man innerhalb von 5 Tagen nach der Erstellung des Kontos keine Änderungen/Bearbeitungen vornimmt, wird das Konto aus Sicherheitsgründen automatisch wieder gelöscht.''

====Benutzerseite erstellen====
Nachdem man ein Benutzer-Konto erstellt, die E-Mail-Adresse bestätigt und sich angemeldet hat, empfiehlt es sich, sich ein paar Augenblicke Zeit zu nehmen, um eine Benutzer-Seite zu erstellen.
Das Erstellen einer Benutzerseite dient mehreren Zielen:
* So können Benutzer mehr über dich erfahren.
* Damit kannst du einige erste Eingaben machen, damit der [[User:Abuse filter|Wiki-Spammer- und Missbrauchsfilter]] erkennen kann, dass du kein Fake-Benutzer bist. Beachte, bei deinen ersten Bearbeitungen keine externen Links einzufügen, da diese wahrscheinlich die Filter auslösen werden.
Ein schneller Einstieg für die Benutzerseite:
*Gehe im Benutzermenü auf die Seite mit deinem '''Benutzernamen''' (oder nimm den ersten Menüpunkt ganz rechts oben im Dropdown-Menü)
*Klick auf die Dropdown-Schaltfläche "Aktionen"{{-}}[[File:JDOCS-actions-create-page-de.png]]
*Klicke "Bearbeiten"
*Füge den Code zum Editor hinzu <code><nowiki>{{subst:Newuser}}</nowiki></code>
*Zusammenfassung ausfüllen (z.B. ''Das ist meine neue User-Seite''){{-}}[[File:JDOCS-summary-form-input-de.png]]
*Klicke "Seite speichern"

====Anmelden bei den Kommunikationskanälen der Dokumentation====
Das offizielle Kommunikationswerkzeug von Joomla ist [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. Auf [[Mattermost|dieser Seite]] findest Du Informationen darüber, wie man der Unterhaltung beitreten kann. Wenn man einmal dabei ist, kann man dem [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation]-Kanal beitreten und an der Diskussion über die Joomla!-Dokumentation teilnehmen.

==Was sollte man zuerst tun?==
Es gibt mehrere Bereiche der Dokumentation, die immer wieder Aufmerksamkeit brauchen. Man könnte damit beginnen, Dokumente auszuwählen, die für einen am bequemsten sind. Oder man engagiert sich mehr, indem man an mehreren gleichzeitig arbeitet. Sobald man ein Wiki-Konto hat, kann an jedem Aspekt der Dokumentation gearbeitet werden, der einem gefällt. Selbst die einfachsten Beiträge wie Rechtschreib-Korrekturen und Grammatik-Korrekturen sind eine große Hilfe!
#[[#Unterstützung bei den Dokumentations-Inhalten|Unterstützung bei den Dokumentations-Inhalten]].
#[[#Wiki Wartungsaufgaben|Wiki Wartungsaufgaben]].
#[[#Dokumentations-Projekte|Dokumentations-Projekte]].
#[[#Hilfeseiten|Hilfeseiten]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]].

===Unterstützung bei den Dokumentations-Inhalten===

#Bearbeiten, Überschreiben und Umstrukturieren von Seiten. In unserem Wiki gibt es [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs-Seiten]] für Bereiche, die sofortige Hilfe benötigen. Sie werden 'Needs-Seiten' genannt, weil sie kleine Aufgaben benötigen, um sie zu vervollständigen. Einige von ihnen sind so einfach wie die Überprüfung des Inhalts oder das Hinzufügen eines Bildes. Andere erfordern mehr Inhalt oder Verbesserungen. Nimm ein paar davon und schenke ihnen ein wenig Zuwendung. Dies ist eine enorme Hilfe für Joomla! Benutzer, die sich auf unsere Dokumentation verlassen.
#Hast du Spaß beim Suchen nach Seiten, die überflüssig sind (z.B. über die Versionen 1.0 und 1.5), oder die wegen versionsspezifischer Informationen aufgeteilt werden müssen? Dann verwende die Marker-Templates {{tl|delete}}, {{tl|merge}} oder {{tl|JSplit}} auf den betreffenden Seiten. Um zu erfahren, wie man sie einsetzt, klicke auf die vorherigen Template-Links. Dort erfährst du, wie man sie auf Seiten anwenden kann, von denen du denkst, dass diese die Markierungen benötigen. Füge sie ganz oben auf einer Seite ein und die Seite ist markiert.
#'''Erstelle eine neue Seite oder Tutorial''' Mach vor der Erstellung einer neuen Seite erst eine intensive Suche. Erstelle keine weitere Seite, wenn bereits eine existiert. Benutze die [[Special:Search|Suche]] des JDocs Wiki, um zu sehen, ob der Begriff bereits auf einer Seite existiert. '''Duplikate werden zusammengeführt und / oder gelöscht'''. Habe keine Angst, die Arbeit eines Anderen an der Joomla-Dokumentation zu verändern, neu zu formatieren oder zu verbessern! Dies ist ein kollaboratives Dokumentations-Wiki, stelle einfach sicher, dass den [[S:MyLanguage/JDOC:Policies and guidelines|Grundsätzen und Richtlinien]] gefolgt wird.
##''Wiki-Links einsetzen.'' Es ist sehr einfach, Seiten mit einer Standardsyntax zu verlinken. Wenn man einen Link zu einer Seite erstellt, die noch nicht existiert, wird der Link rot eingefärbt. Ein Klick auf einen roten Link führt direkt zur Bearbeitungsseite der neuen Seite. Gib einfach den gewünschten Inhalts-Text ein, klicke auf Speichern und die neue Seite wird erstellt. Danach wechselt der Link von rot auf blau und zeigt damit an, dass die Seite nun existiert.
##''URL einsetzen.'' Einzusetzen, wenn man eine Seite von Grund auf neu erstellen möchte. Man kann die URL des Wikis zum Erstellen einer neuen Seite verwenden. Die URL zu einem Artikel des Wikis ist normalerweise ähnlich wie: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. Wenn man YOURTITLE durch den Namen der Seite ersetzt, die man erstellen möchte, gelangt man auf eine leere Seite, die anzeigt, dass noch keine Seite dieses Namens existiert. Ein Klick auf den ''Seite erstellen''-Link führt zur Bearbeitungs-Seite der neuen Seite. Hier kann der Inhalt eingegeben werden, durch Klick auf ''Speichern'' wird die Seite angelegt.
#'''Hilfe durch Aktualisieren von Bildern in Seiten.''' Schau in die Kategorie [[S:MyLanguage/:Category:Needs image updating|Zu aktualisierende Bilder]] um die Liste an Seiten zu sehen, in denen Bilder aktualisiert werden müssen. Vorgaben dafür finden sich in den [[S:MyLanguage/JDOC:Image naming guidelines|Richtlinien zur Bildbenennung]].

===Wiki Wartungsaufgaben===
:Ein Wiki zu warten und zu organisieren bedarf eine Menge an kontinuierlicher Arbeit der Administratoren, Redakteure und Benutzer. Es gibt immer Aufgaben, die Aufmerksamkeit benötigen wie z.B.: [[Special:UncategorizedPages|Nicht kategorisierte Seiten]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Joomla! Wiki Seiten, die Hilfe brauchen]] oder auch [[S:MyLanguage/Category:Article_under_construction|Seite befindet sich in Bearbeitung]], das Markieren von Seiten für [[Template:Delete|Löschung]], [[Template:Merge|Zusammenführung]] oder [[Template:JSplit|Aufteilung]]. Für alle Wartungsaufgaben und Ideen wie man den JDocs helfen kann, besuche bitte unsere [[S:MyLanguage/JDOC:Maintenance Tasks|Wartungsseite]].

===Dokumentations-Projekte===
*Das JDocs-Team arbeitet an den [[S:MyLanguage/Tutorials:Beginners|Einsteiger Tutorials]]. Unser Ziel ist es, diese leicht verständlich und gut navigierbar zu machen, damit ein Anfänger die Dinge leicht nachvollziehen und Grundkonzepte erlernen kann. Denke mal daran, als du neu bei Joomla warst und füge ein Thema über etwas hinzu, mit dem man als Anfänger zu kämpfen hatte. Noch besser wäre es, dem [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Einsteiger-Tutorial-Projekt]] beizutreten.
*Tritt dem [[S:MyLanguage/JDOC:Developer Tutorials Project|Entwickler-Tutorial-Projekt]] bei und teile dein Wissen. Hinterlege Deinen Namen mit 4 Tilden ( <nowiki>~~~~</nowiki> ) auf der Seite [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] und liste auf, was du tun kannst. Gerne kannst du einige [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|Topics]] zur Liste der vorgeschlagenen Themen hinzufügen.

===Hilfeseiten===

Für viele unbekannt, werden alle [[S:MyLanguage/Help screens|Hilfe]] Seiten zu jeder Joomla-Installation weltweit von diesem Wiki aus erstellt und zur Verfügung gestellt! Diese sind für Anfänger und auch für die mit fortgeschrittenen Kenntnissen über Joomla notwendig.

'''Die Joomla! 4.x Hilfe-Seiten müssen komplett überarbeitet werden.''' Jeder Beitrag, den du leisten kannst, wird von vielen Benutzern weltweit geschätzt und wir suchen Freiwillige, die uns bei dieser wichtigen Aufgabe helfen können. Eine Matrix und ein Aktionsplan müssen noch erstellt werden.

==Wichtige Dinge==
Hier ein paar Dinge, die man sich als Helfer bei den Joomla-Docs merken sollte.

*Hab keine Angst, eine Seite zu beschädigen. Wenn du das tust und etwas wirklich schief gelaufen ist, kehre zum Editieren zurück. Klick auf die Registerkarte '''Versionsgeschichte''' der Seite und du siehst Links zum Widerrufen und Wiederherstellen.
*Schreibe die Beiträge in dem Bewusstsein, dass sie in eine andere Sprache übersetzt werden sollen. Die Verwendung von Slangausdrücken oder lokalen Dialekten kann dazu führen, dass diese nicht in eine andere Sprache übersetzt oder ihre Zusammenhänge nicht verstanden werden. Weitere Informationen findest du unter [[JDOC:Documentation Translators|Übersetzen der Joomla!-Dokumentation]].
*Die [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] lesen, der für alle Joomla-Dokumentationen gilt. Er gibt hilfreiche Hinweise, wie man für die Joomla Dokumentation schreibt.
*Beim Schreiben sollte auf die korrekte Rechtschreibung geachtet werden. Für eine sofortige Rückmeldung sollten Sie die Browser Google Chrome oder Mozilla Firefox verwenden. Beide haben eine integrierte Rechtschreibprüfung, die ein falsch geschriebenes Wort unterstreicht.
*Vergiss nicht das {{tl|inuse}}-Template an einen Artikel anzuwenden, den du für länger als eine Minute bearbeitest. Es hilft, Bearbeitungs-Konflikte zu vermeiden.

==Hilfe, ich kenne Wiki Markup nicht!==
Wenn du neu beim '''''Wiki''''' und der einfachen Markup für Seiten bist, kannst du Folgendes als Hilfe verwenden.
*Der neue WikiEditor hat Buttons und Links, um den Seitenbau einfach zu machen. Klick auf das Wort ''''Advanced'''' für mehr Buttons und Formatierungs-Links.
*Verwende [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] um grundlegende Syntax-Kommandos zu lernen. Es gibt auch ein Aufklappmenü mit den gebräuchlichen Markup im Editor. Klick auf das Wort ''Hilfe'', um sie aufzurufen.
*Noch unschlüssig? Diese Werkzeuge für die Wiki-Seiten versuchen
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], speichert Word-Dokumente als Wiki-Markup
:*'''OpenOffice.org versions 2.4 und später''' haben einen eingebauten MediaWiki-Exportfilter. Öffne das Writer-Dokument, klick auf "Datei → Export" und ändere das Dateiformat auf MediaWiki.
:*Hier eine [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|Liste von Werkzeugen]] um andere Formate wie HTML, Excel, CSV in Wiki-Markup umzuwandeln. Einige konvertieren ausgeschnittenes und eingefügtes HTML online in Wiki-Markup.
*Hilfe finden auf [https://joomlacommunity.cloud.mattermost.com/ Mattermost], (Wir haben dort eine Menge Kanäle. Beispielsweise einen für die JDocs Translation Group und einen für die JDocs Working Group).
*Eine Frage an einen [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 Administrator] oder [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 Editor] auf deren Diskussionsseite posten.

[[Category:Documentation Wiki Information/de]]
[[Category:Volunteer Engagement{{#translation:}}]]

Translations:JDOC:How to Contribute to Joomla! Documentation/55/de

2025-01-24T08:59:41Z

'''Ihre Hilfe bei der Aktualisierung ist höchst willkommen und wird geschätzt! Bitte melden Sie Ihre Vorschläge, Verbesserungen oder Angebote für Hilfe auf [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''

JDOC:How to Contribute to Joomla! Documentation/de

2025-01-24T08:58:04Z

Max123kl: Created page with "Wir bitten Sie, Ihre Beiträge nicht mehr zu diesem Wiki hinzuzufügen; die Informationen auf dieser Seite sind veraltet."

<noinclude><languages /></noinclude>
Die Dokumentation von Joomla! wird durch die Plattform [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] ermöglicht. Das Wachstum und der Erfolg von Joomla! hängt von [[Special:ActiveUsers|Menschen wie Dir]] ab. Vielen Dank, dass Du den ersten Schritt zum Mithelfen bei unserem Joomla!-Projekt gemacht hast. Diese Seite zeigt, wie man anfangen und die Dokumentation unterstützen kann.

{{amboxNew|image=notice|style=notice|title={{{title|Neue Dokumentation}}}|text=Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren.</br>Wir bitten Sie, Ihre Beiträge nicht mehr zu diesem Wiki hinzuzufügen; die Informationen auf dieser Seite sind veraltet.</br>
'''Your help with the update is very welcome and appreciated! Please report your suggestions, improvements or offer for assistence on [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''}}

==Erste Schritte!==

Es gibt ein paar Dinge, die man zuerst erledigen muss.

====Die Wiki-Nutzungsbedingung lesen====
Du solltest die Joomla-Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki-Nutzungsbedingungen]]''' lesen, bevor du mit der Bearbeitung beginnst.

====Benutzerkonto einrichten====
<div class="mw-translate-fuzzy">
Um im Joomla!-Dokumentations-Wiki mitzuarbeiten, benötigst du ein Benutzerkonto. Du kannst '''[[Special:CreateAccount|hier einen Account anlegen]]'''. Bestätige anschließend unbedingt deine E-Mail-Adresse. Mit der Bestätigung der E-Mail-Adresse erhältst du die Berechtigung, jede Seite, mit Ausnahme einiger geschützten Seiten zu bearbeiten.
</div>

''Hinweis: Wenn man innerhalb von 5 Tagen nach der Erstellung des Kontos keine Änderungen/Bearbeitungen vornimmt, wird das Konto aus Sicherheitsgründen automatisch wieder gelöscht.''

====Benutzerseite erstellen====
Nachdem man ein Benutzer-Konto erstellt, die E-Mail-Adresse bestätigt und sich angemeldet hat, empfiehlt es sich, sich ein paar Augenblicke Zeit zu nehmen, um eine Benutzer-Seite zu erstellen.
Das Erstellen einer Benutzerseite dient mehreren Zielen:
* So können Benutzer mehr über dich erfahren.
* Damit kannst du einige erste Eingaben machen, damit der [[User:Abuse filter|Wiki-Spammer- und Missbrauchsfilter]] erkennen kann, dass du kein Fake-Benutzer bist. Beachte, bei deinen ersten Bearbeitungen keine externen Links einzufügen, da diese wahrscheinlich die Filter auslösen werden.
Ein schneller Einstieg für die Benutzerseite:
*Gehe im Benutzermenü auf die Seite mit deinem '''Benutzernamen''' (oder nimm den ersten Menüpunkt ganz rechts oben im Dropdown-Menü)
*Klick auf die Dropdown-Schaltfläche "Aktionen"{{-}}[[File:JDOCS-actions-create-page-de.png]]
*Klicke "Bearbeiten"
*Füge den Code zum Editor hinzu <code><nowiki>{{subst:Newuser}}</nowiki></code>
*Zusammenfassung ausfüllen (z.B. ''Das ist meine neue User-Seite''){{-}}[[File:JDOCS-summary-form-input-de.png]]
*Klicke "Seite speichern"

====Anmelden bei den Kommunikationskanälen der Dokumentation====
Das offizielle Kommunikationswerkzeug von Joomla ist [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. Auf [[Mattermost|dieser Seite]] findest Du Informationen darüber, wie man der Unterhaltung beitreten kann. Wenn man einmal dabei ist, kann man dem [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation]-Kanal beitreten und an der Diskussion über die Joomla!-Dokumentation teilnehmen.

==Was sollte man zuerst tun?==
Es gibt mehrere Bereiche der Dokumentation, die immer wieder Aufmerksamkeit brauchen. Man könnte damit beginnen, Dokumente auszuwählen, die für einen am bequemsten sind. Oder man engagiert sich mehr, indem man an mehreren gleichzeitig arbeitet. Sobald man ein Wiki-Konto hat, kann an jedem Aspekt der Dokumentation gearbeitet werden, der einem gefällt. Selbst die einfachsten Beiträge wie Rechtschreib-Korrekturen und Grammatik-Korrekturen sind eine große Hilfe!
#[[#Unterstützung bei den Dokumentations-Inhalten|Unterstützung bei den Dokumentations-Inhalten]].
#[[#Wiki Wartungsaufgaben|Wiki Wartungsaufgaben]].
#[[#Dokumentations-Projekte|Dokumentations-Projekte]].
#[[#Hilfeseiten|Hilfeseiten]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]].

===Unterstützung bei den Dokumentations-Inhalten===

#Bearbeiten, Überschreiben und Umstrukturieren von Seiten. In unserem Wiki gibt es [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs-Seiten]] für Bereiche, die sofortige Hilfe benötigen. Sie werden 'Needs-Seiten' genannt, weil sie kleine Aufgaben benötigen, um sie zu vervollständigen. Einige von ihnen sind so einfach wie die Überprüfung des Inhalts oder das Hinzufügen eines Bildes. Andere erfordern mehr Inhalt oder Verbesserungen. Nimm ein paar davon und schenke ihnen ein wenig Zuwendung. Dies ist eine enorme Hilfe für Joomla! Benutzer, die sich auf unsere Dokumentation verlassen.
#Hast du Spaß beim Suchen nach Seiten, die überflüssig sind (z.B. über die Versionen 1.0 und 1.5), oder die wegen versionsspezifischer Informationen aufgeteilt werden müssen? Dann verwende die Marker-Templates {{tl|delete}}, {{tl|merge}} oder {{tl|JSplit}} auf den betreffenden Seiten. Um zu erfahren, wie man sie einsetzt, klicke auf die vorherigen Template-Links. Dort erfährst du, wie man sie auf Seiten anwenden kann, von denen du denkst, dass diese die Markierungen benötigen. Füge sie ganz oben auf einer Seite ein und die Seite ist markiert.
#'''Erstelle eine neue Seite oder Tutorial''' Mach vor der Erstellung einer neuen Seite erst eine intensive Suche. Erstelle keine weitere Seite, wenn bereits eine existiert. Benutze die [[Special:Search|Suche]] des JDocs Wiki, um zu sehen, ob der Begriff bereits auf einer Seite existiert. '''Duplikate werden zusammengeführt und / oder gelöscht'''. Habe keine Angst, die Arbeit eines Anderen an der Joomla-Dokumentation zu verändern, neu zu formatieren oder zu verbessern! Dies ist ein kollaboratives Dokumentations-Wiki, stelle einfach sicher, dass den [[S:MyLanguage/JDOC:Policies and guidelines|Grundsätzen und Richtlinien]] gefolgt wird.
##''Wiki-Links einsetzen.'' Es ist sehr einfach, Seiten mit einer Standardsyntax zu verlinken. Wenn man einen Link zu einer Seite erstellt, die noch nicht existiert, wird der Link rot eingefärbt. Ein Klick auf einen roten Link führt direkt zur Bearbeitungsseite der neuen Seite. Gib einfach den gewünschten Inhalts-Text ein, klicke auf Speichern und die neue Seite wird erstellt. Danach wechselt der Link von rot auf blau und zeigt damit an, dass die Seite nun existiert.
##''URL einsetzen.'' Einzusetzen, wenn man eine Seite von Grund auf neu erstellen möchte. Man kann die URL des Wikis zum Erstellen einer neuen Seite verwenden. Die URL zu einem Artikel des Wikis ist normalerweise ähnlich wie: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. Wenn man YOURTITLE durch den Namen der Seite ersetzt, die man erstellen möchte, gelangt man auf eine leere Seite, die anzeigt, dass noch keine Seite dieses Namens existiert. Ein Klick auf den ''Seite erstellen''-Link führt zur Bearbeitungs-Seite der neuen Seite. Hier kann der Inhalt eingegeben werden, durch Klick auf ''Speichern'' wird die Seite angelegt.
#'''Hilfe durch Aktualisieren von Bildern in Seiten.''' Schau in die Kategorie [[S:MyLanguage/:Category:Needs image updating|Zu aktualisierende Bilder]] um die Liste an Seiten zu sehen, in denen Bilder aktualisiert werden müssen. Vorgaben dafür finden sich in den [[S:MyLanguage/JDOC:Image naming guidelines|Richtlinien zur Bildbenennung]].

===Wiki Wartungsaufgaben===
:Ein Wiki zu warten und zu organisieren bedarf eine Menge an kontinuierlicher Arbeit der Administratoren, Redakteure und Benutzer. Es gibt immer Aufgaben, die Aufmerksamkeit benötigen wie z.B.: [[Special:UncategorizedPages|Nicht kategorisierte Seiten]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Joomla! Wiki Seiten, die Hilfe brauchen]] oder auch [[S:MyLanguage/Category:Article_under_construction|Seite befindet sich in Bearbeitung]], das Markieren von Seiten für [[Template:Delete|Löschung]], [[Template:Merge|Zusammenführung]] oder [[Template:JSplit|Aufteilung]]. Für alle Wartungsaufgaben und Ideen wie man den JDocs helfen kann, besuche bitte unsere [[S:MyLanguage/JDOC:Maintenance Tasks|Wartungsseite]].

===Dokumentations-Projekte===
*Das JDocs-Team arbeitet an den [[S:MyLanguage/Tutorials:Beginners|Einsteiger Tutorials]]. Unser Ziel ist es, diese leicht verständlich und gut navigierbar zu machen, damit ein Anfänger die Dinge leicht nachvollziehen und Grundkonzepte erlernen kann. Denke mal daran, als du neu bei Joomla warst und füge ein Thema über etwas hinzu, mit dem man als Anfänger zu kämpfen hatte. Noch besser wäre es, dem [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Einsteiger-Tutorial-Projekt]] beizutreten.
*Tritt dem [[S:MyLanguage/JDOC:Developer Tutorials Project|Entwickler-Tutorial-Projekt]] bei und teile dein Wissen. Hinterlege Deinen Namen mit 4 Tilden ( <nowiki>~~~~</nowiki> ) auf der Seite [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] und liste auf, was du tun kannst. Gerne kannst du einige [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|Topics]] zur Liste der vorgeschlagenen Themen hinzufügen.

===Hilfeseiten===

Für viele unbekannt, werden alle [[S:MyLanguage/Help screens|Hilfe]] Seiten zu jeder Joomla-Installation weltweit von diesem Wiki aus erstellt und zur Verfügung gestellt! Diese sind für Anfänger und auch für die mit fortgeschrittenen Kenntnissen über Joomla notwendig.

'''Die Joomla! 4.x Hilfe-Seiten müssen komplett überarbeitet werden.''' Jeder Beitrag, den du leisten kannst, wird von vielen Benutzern weltweit geschätzt und wir suchen Freiwillige, die uns bei dieser wichtigen Aufgabe helfen können. Eine Matrix und ein Aktionsplan müssen noch erstellt werden.

==Wichtige Dinge==
Hier ein paar Dinge, die man sich als Helfer bei den Joomla-Docs merken sollte.

*Hab keine Angst, eine Seite zu beschädigen. Wenn du das tust und etwas wirklich schief gelaufen ist, kehre zum Editieren zurück. Klick auf die Registerkarte '''Versionsgeschichte''' der Seite und du siehst Links zum Widerrufen und Wiederherstellen.
*Schreibe die Beiträge in dem Bewusstsein, dass sie in eine andere Sprache übersetzt werden sollen. Die Verwendung von Slangausdrücken oder lokalen Dialekten kann dazu führen, dass diese nicht in eine andere Sprache übersetzt oder ihre Zusammenhänge nicht verstanden werden. Weitere Informationen findest du unter [[JDOC:Documentation Translators|Übersetzen der Joomla!-Dokumentation]].
*Die [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] lesen, der für alle Joomla-Dokumentationen gilt. Er gibt hilfreiche Hinweise, wie man für die Joomla Dokumentation schreibt.
*Beim Schreiben sollte auf die korrekte Rechtschreibung geachtet werden. Für eine sofortige Rückmeldung sollten Sie die Browser Google Chrome oder Mozilla Firefox verwenden. Beide haben eine integrierte Rechtschreibprüfung, die ein falsch geschriebenes Wort unterstreicht.
*Vergiss nicht das {{tl|inuse}}-Template an einen Artikel anzuwenden, den du für länger als eine Minute bearbeitest. Es hilft, Bearbeitungs-Konflikte zu vermeiden.

==Hilfe, ich kenne Wiki Markup nicht!==
Wenn du neu beim '''''Wiki''''' und der einfachen Markup für Seiten bist, kannst du Folgendes als Hilfe verwenden.
*Der neue WikiEditor hat Buttons und Links, um den Seitenbau einfach zu machen. Klick auf das Wort ''''Advanced'''' für mehr Buttons und Formatierungs-Links.
*Verwende [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] um grundlegende Syntax-Kommandos zu lernen. Es gibt auch ein Aufklappmenü mit den gebräuchlichen Markup im Editor. Klick auf das Wort ''Hilfe'', um sie aufzurufen.
*Noch unschlüssig? Diese Werkzeuge für die Wiki-Seiten versuchen
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], speichert Word-Dokumente als Wiki-Markup
:*'''OpenOffice.org versions 2.4 und später''' haben einen eingebauten MediaWiki-Exportfilter. Öffne das Writer-Dokument, klick auf "Datei → Export" und ändere das Dateiformat auf MediaWiki.
:*Hier eine [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|Liste von Werkzeugen]] um andere Formate wie HTML, Excel, CSV in Wiki-Markup umzuwandeln. Einige konvertieren ausgeschnittenes und eingefügtes HTML online in Wiki-Markup.
*Hilfe finden auf [https://joomlacommunity.cloud.mattermost.com/ Mattermost], (Wir haben dort eine Menge Kanäle. Beispielsweise einen für die JDocs Translation Group und einen für die JDocs Working Group).
*Eine Frage an einen [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 Administrator] oder [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 Editor] auf deren Diskussionsseite posten.

[[Category:Documentation Wiki Information/de]]
[[Category:Volunteer Engagement{{#translation:}}]]

Translations:JDOC:How to Contribute to Joomla! Documentation/54/de

2025-01-24T08:58:02Z

Max123kl: Created page with "Wir bitten Sie, Ihre Beiträge nicht mehr zu diesem Wiki hinzuzufügen; die Informationen auf dieser Seite sind veraltet."

Wir bitten Sie, Ihre Beiträge nicht mehr zu diesem Wiki hinzuzufügen; die Informationen auf dieser Seite sind veraltet.

JDOC:How to Contribute to Joomla! Documentation/de

2025-01-24T08:57:07Z

Max123kl: Created page with "Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren."

<noinclude><languages /></noinclude>
Die Dokumentation von Joomla! wird durch die Plattform [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] ermöglicht. Das Wachstum und der Erfolg von Joomla! hängt von [[Special:ActiveUsers|Menschen wie Dir]] ab. Vielen Dank, dass Du den ersten Schritt zum Mithelfen bei unserem Joomla!-Projekt gemacht hast. Diese Seite zeigt, wie man anfangen und die Dokumentation unterstützen kann.

{{amboxNew|image=notice|style=notice|title={{{title|Neue Dokumentation}}}|text=Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren.</br>Please don't add your contributions to this wiki anymore; the information on this page is obsolete.</br>
'''Your help with the update is very welcome and appreciated! Please report your suggestions, improvements or offer for assistence on [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''}}

==Erste Schritte!==

Es gibt ein paar Dinge, die man zuerst erledigen muss.

====Die Wiki-Nutzungsbedingung lesen====
Du solltest die Joomla-Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki-Nutzungsbedingungen]]''' lesen, bevor du mit der Bearbeitung beginnst.

====Benutzerkonto einrichten====
<div class="mw-translate-fuzzy">
Um im Joomla!-Dokumentations-Wiki mitzuarbeiten, benötigst du ein Benutzerkonto. Du kannst '''[[Special:CreateAccount|hier einen Account anlegen]]'''. Bestätige anschließend unbedingt deine E-Mail-Adresse. Mit der Bestätigung der E-Mail-Adresse erhältst du die Berechtigung, jede Seite, mit Ausnahme einiger geschützten Seiten zu bearbeiten.
</div>

''Hinweis: Wenn man innerhalb von 5 Tagen nach der Erstellung des Kontos keine Änderungen/Bearbeitungen vornimmt, wird das Konto aus Sicherheitsgründen automatisch wieder gelöscht.''

====Benutzerseite erstellen====
Nachdem man ein Benutzer-Konto erstellt, die E-Mail-Adresse bestätigt und sich angemeldet hat, empfiehlt es sich, sich ein paar Augenblicke Zeit zu nehmen, um eine Benutzer-Seite zu erstellen.
Das Erstellen einer Benutzerseite dient mehreren Zielen:
* So können Benutzer mehr über dich erfahren.
* Damit kannst du einige erste Eingaben machen, damit der [[User:Abuse filter|Wiki-Spammer- und Missbrauchsfilter]] erkennen kann, dass du kein Fake-Benutzer bist. Beachte, bei deinen ersten Bearbeitungen keine externen Links einzufügen, da diese wahrscheinlich die Filter auslösen werden.
Ein schneller Einstieg für die Benutzerseite:
*Gehe im Benutzermenü auf die Seite mit deinem '''Benutzernamen''' (oder nimm den ersten Menüpunkt ganz rechts oben im Dropdown-Menü)
*Klick auf die Dropdown-Schaltfläche "Aktionen"{{-}}[[File:JDOCS-actions-create-page-de.png]]
*Klicke "Bearbeiten"
*Füge den Code zum Editor hinzu <code><nowiki>{{subst:Newuser}}</nowiki></code>
*Zusammenfassung ausfüllen (z.B. ''Das ist meine neue User-Seite''){{-}}[[File:JDOCS-summary-form-input-de.png]]
*Klicke "Seite speichern"

====Anmelden bei den Kommunikationskanälen der Dokumentation====
Das offizielle Kommunikationswerkzeug von Joomla ist [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. Auf [[Mattermost|dieser Seite]] findest Du Informationen darüber, wie man der Unterhaltung beitreten kann. Wenn man einmal dabei ist, kann man dem [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation]-Kanal beitreten und an der Diskussion über die Joomla!-Dokumentation teilnehmen.

==Was sollte man zuerst tun?==
Es gibt mehrere Bereiche der Dokumentation, die immer wieder Aufmerksamkeit brauchen. Man könnte damit beginnen, Dokumente auszuwählen, die für einen am bequemsten sind. Oder man engagiert sich mehr, indem man an mehreren gleichzeitig arbeitet. Sobald man ein Wiki-Konto hat, kann an jedem Aspekt der Dokumentation gearbeitet werden, der einem gefällt. Selbst die einfachsten Beiträge wie Rechtschreib-Korrekturen und Grammatik-Korrekturen sind eine große Hilfe!
#[[#Unterstützung bei den Dokumentations-Inhalten|Unterstützung bei den Dokumentations-Inhalten]].
#[[#Wiki Wartungsaufgaben|Wiki Wartungsaufgaben]].
#[[#Dokumentations-Projekte|Dokumentations-Projekte]].
#[[#Hilfeseiten|Hilfeseiten]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]].

===Unterstützung bei den Dokumentations-Inhalten===

#Bearbeiten, Überschreiben und Umstrukturieren von Seiten. In unserem Wiki gibt es [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs-Seiten]] für Bereiche, die sofortige Hilfe benötigen. Sie werden 'Needs-Seiten' genannt, weil sie kleine Aufgaben benötigen, um sie zu vervollständigen. Einige von ihnen sind so einfach wie die Überprüfung des Inhalts oder das Hinzufügen eines Bildes. Andere erfordern mehr Inhalt oder Verbesserungen. Nimm ein paar davon und schenke ihnen ein wenig Zuwendung. Dies ist eine enorme Hilfe für Joomla! Benutzer, die sich auf unsere Dokumentation verlassen.
#Hast du Spaß beim Suchen nach Seiten, die überflüssig sind (z.B. über die Versionen 1.0 und 1.5), oder die wegen versionsspezifischer Informationen aufgeteilt werden müssen? Dann verwende die Marker-Templates {{tl|delete}}, {{tl|merge}} oder {{tl|JSplit}} auf den betreffenden Seiten. Um zu erfahren, wie man sie einsetzt, klicke auf die vorherigen Template-Links. Dort erfährst du, wie man sie auf Seiten anwenden kann, von denen du denkst, dass diese die Markierungen benötigen. Füge sie ganz oben auf einer Seite ein und die Seite ist markiert.
#'''Erstelle eine neue Seite oder Tutorial''' Mach vor der Erstellung einer neuen Seite erst eine intensive Suche. Erstelle keine weitere Seite, wenn bereits eine existiert. Benutze die [[Special:Search|Suche]] des JDocs Wiki, um zu sehen, ob der Begriff bereits auf einer Seite existiert. '''Duplikate werden zusammengeführt und / oder gelöscht'''. Habe keine Angst, die Arbeit eines Anderen an der Joomla-Dokumentation zu verändern, neu zu formatieren oder zu verbessern! Dies ist ein kollaboratives Dokumentations-Wiki, stelle einfach sicher, dass den [[S:MyLanguage/JDOC:Policies and guidelines|Grundsätzen und Richtlinien]] gefolgt wird.
##''Wiki-Links einsetzen.'' Es ist sehr einfach, Seiten mit einer Standardsyntax zu verlinken. Wenn man einen Link zu einer Seite erstellt, die noch nicht existiert, wird der Link rot eingefärbt. Ein Klick auf einen roten Link führt direkt zur Bearbeitungsseite der neuen Seite. Gib einfach den gewünschten Inhalts-Text ein, klicke auf Speichern und die neue Seite wird erstellt. Danach wechselt der Link von rot auf blau und zeigt damit an, dass die Seite nun existiert.
##''URL einsetzen.'' Einzusetzen, wenn man eine Seite von Grund auf neu erstellen möchte. Man kann die URL des Wikis zum Erstellen einer neuen Seite verwenden. Die URL zu einem Artikel des Wikis ist normalerweise ähnlich wie: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. Wenn man YOURTITLE durch den Namen der Seite ersetzt, die man erstellen möchte, gelangt man auf eine leere Seite, die anzeigt, dass noch keine Seite dieses Namens existiert. Ein Klick auf den ''Seite erstellen''-Link führt zur Bearbeitungs-Seite der neuen Seite. Hier kann der Inhalt eingegeben werden, durch Klick auf ''Speichern'' wird die Seite angelegt.
#'''Hilfe durch Aktualisieren von Bildern in Seiten.''' Schau in die Kategorie [[S:MyLanguage/:Category:Needs image updating|Zu aktualisierende Bilder]] um die Liste an Seiten zu sehen, in denen Bilder aktualisiert werden müssen. Vorgaben dafür finden sich in den [[S:MyLanguage/JDOC:Image naming guidelines|Richtlinien zur Bildbenennung]].

===Wiki Wartungsaufgaben===
:Ein Wiki zu warten und zu organisieren bedarf eine Menge an kontinuierlicher Arbeit der Administratoren, Redakteure und Benutzer. Es gibt immer Aufgaben, die Aufmerksamkeit benötigen wie z.B.: [[Special:UncategorizedPages|Nicht kategorisierte Seiten]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Joomla! Wiki Seiten, die Hilfe brauchen]] oder auch [[S:MyLanguage/Category:Article_under_construction|Seite befindet sich in Bearbeitung]], das Markieren von Seiten für [[Template:Delete|Löschung]], [[Template:Merge|Zusammenführung]] oder [[Template:JSplit|Aufteilung]]. Für alle Wartungsaufgaben und Ideen wie man den JDocs helfen kann, besuche bitte unsere [[S:MyLanguage/JDOC:Maintenance Tasks|Wartungsseite]].

===Dokumentations-Projekte===
*Das JDocs-Team arbeitet an den [[S:MyLanguage/Tutorials:Beginners|Einsteiger Tutorials]]. Unser Ziel ist es, diese leicht verständlich und gut navigierbar zu machen, damit ein Anfänger die Dinge leicht nachvollziehen und Grundkonzepte erlernen kann. Denke mal daran, als du neu bei Joomla warst und füge ein Thema über etwas hinzu, mit dem man als Anfänger zu kämpfen hatte. Noch besser wäre es, dem [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Einsteiger-Tutorial-Projekt]] beizutreten.
*Tritt dem [[S:MyLanguage/JDOC:Developer Tutorials Project|Entwickler-Tutorial-Projekt]] bei und teile dein Wissen. Hinterlege Deinen Namen mit 4 Tilden ( <nowiki>~~~~</nowiki> ) auf der Seite [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] und liste auf, was du tun kannst. Gerne kannst du einige [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|Topics]] zur Liste der vorgeschlagenen Themen hinzufügen.

===Hilfeseiten===

Für viele unbekannt, werden alle [[S:MyLanguage/Help screens|Hilfe]] Seiten zu jeder Joomla-Installation weltweit von diesem Wiki aus erstellt und zur Verfügung gestellt! Diese sind für Anfänger und auch für die mit fortgeschrittenen Kenntnissen über Joomla notwendig.

'''Die Joomla! 4.x Hilfe-Seiten müssen komplett überarbeitet werden.''' Jeder Beitrag, den du leisten kannst, wird von vielen Benutzern weltweit geschätzt und wir suchen Freiwillige, die uns bei dieser wichtigen Aufgabe helfen können. Eine Matrix und ein Aktionsplan müssen noch erstellt werden.

==Wichtige Dinge==
Hier ein paar Dinge, die man sich als Helfer bei den Joomla-Docs merken sollte.

*Hab keine Angst, eine Seite zu beschädigen. Wenn du das tust und etwas wirklich schief gelaufen ist, kehre zum Editieren zurück. Klick auf die Registerkarte '''Versionsgeschichte''' der Seite und du siehst Links zum Widerrufen und Wiederherstellen.
*Schreibe die Beiträge in dem Bewusstsein, dass sie in eine andere Sprache übersetzt werden sollen. Die Verwendung von Slangausdrücken oder lokalen Dialekten kann dazu führen, dass diese nicht in eine andere Sprache übersetzt oder ihre Zusammenhänge nicht verstanden werden. Weitere Informationen findest du unter [[JDOC:Documentation Translators|Übersetzen der Joomla!-Dokumentation]].
*Die [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] lesen, der für alle Joomla-Dokumentationen gilt. Er gibt hilfreiche Hinweise, wie man für die Joomla Dokumentation schreibt.
*Beim Schreiben sollte auf die korrekte Rechtschreibung geachtet werden. Für eine sofortige Rückmeldung sollten Sie die Browser Google Chrome oder Mozilla Firefox verwenden. Beide haben eine integrierte Rechtschreibprüfung, die ein falsch geschriebenes Wort unterstreicht.
*Vergiss nicht das {{tl|inuse}}-Template an einen Artikel anzuwenden, den du für länger als eine Minute bearbeitest. Es hilft, Bearbeitungs-Konflikte zu vermeiden.

==Hilfe, ich kenne Wiki Markup nicht!==
Wenn du neu beim '''''Wiki''''' und der einfachen Markup für Seiten bist, kannst du Folgendes als Hilfe verwenden.
*Der neue WikiEditor hat Buttons und Links, um den Seitenbau einfach zu machen. Klick auf das Wort ''''Advanced'''' für mehr Buttons und Formatierungs-Links.
*Verwende [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] um grundlegende Syntax-Kommandos zu lernen. Es gibt auch ein Aufklappmenü mit den gebräuchlichen Markup im Editor. Klick auf das Wort ''Hilfe'', um sie aufzurufen.
*Noch unschlüssig? Diese Werkzeuge für die Wiki-Seiten versuchen
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], speichert Word-Dokumente als Wiki-Markup
:*'''OpenOffice.org versions 2.4 und später''' haben einen eingebauten MediaWiki-Exportfilter. Öffne das Writer-Dokument, klick auf "Datei → Export" und ändere das Dateiformat auf MediaWiki.
:*Hier eine [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|Liste von Werkzeugen]] um andere Formate wie HTML, Excel, CSV in Wiki-Markup umzuwandeln. Einige konvertieren ausgeschnittenes und eingefügtes HTML online in Wiki-Markup.
*Hilfe finden auf [https://joomlacommunity.cloud.mattermost.com/ Mattermost], (Wir haben dort eine Menge Kanäle. Beispielsweise einen für die JDocs Translation Group und einen für die JDocs Working Group).
*Eine Frage an einen [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 Administrator] oder [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 Editor] auf deren Diskussionsseite posten.

[[Category:Documentation Wiki Information/de]]
[[Category:Volunteer Engagement{{#translation:}}]]

Translations:JDOC:How to Contribute to Joomla! Documentation/53/de

2025-01-24T08:56:56Z

Max123kl: Created page with "Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren."

Wir entwickeln gerade eine neue Dokumentation auf Basis von Joomla!, auch um die Leistungsfähigkeit unseres CMS zu demonstrieren.

JDOC:How to Contribute to Joomla! Documentation/de

2025-01-24T08:49:59Z

Max123kl: Created page with "Neue Dokumentation"

<noinclude><languages /></noinclude>
Die Dokumentation von Joomla! wird durch die Plattform [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] ermöglicht. Das Wachstum und der Erfolg von Joomla! hängt von [[Special:ActiveUsers|Menschen wie Dir]] ab. Vielen Dank, dass Du den ersten Schritt zum Mithelfen bei unserem Joomla!-Projekt gemacht hast. Diese Seite zeigt, wie man anfangen und die Dokumentation unterstützen kann.

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

==Erste Schritte!==

Es gibt ein paar Dinge, die man zuerst erledigen muss.

====Die Wiki-Nutzungsbedingung lesen====
Du solltest die Joomla-Docs '''[[S:MyLanguage/JDOC:Wiki policy|Wiki-Nutzungsbedingungen]]''' lesen, bevor du mit der Bearbeitung beginnst.

====Benutzerkonto einrichten====
<div class="mw-translate-fuzzy">
Um im Joomla!-Dokumentations-Wiki mitzuarbeiten, benötigst du ein Benutzerkonto. Du kannst '''[[Special:CreateAccount|hier einen Account anlegen]]'''. Bestätige anschließend unbedingt deine E-Mail-Adresse. Mit der Bestätigung der E-Mail-Adresse erhältst du die Berechtigung, jede Seite, mit Ausnahme einiger geschützten Seiten zu bearbeiten.
</div>

''Hinweis: Wenn man innerhalb von 5 Tagen nach der Erstellung des Kontos keine Änderungen/Bearbeitungen vornimmt, wird das Konto aus Sicherheitsgründen automatisch wieder gelöscht.''

====Benutzerseite erstellen====
Nachdem man ein Benutzer-Konto erstellt, die E-Mail-Adresse bestätigt und sich angemeldet hat, empfiehlt es sich, sich ein paar Augenblicke Zeit zu nehmen, um eine Benutzer-Seite zu erstellen.
Das Erstellen einer Benutzerseite dient mehreren Zielen:
* So können Benutzer mehr über dich erfahren.
* Damit kannst du einige erste Eingaben machen, damit der [[User:Abuse filter|Wiki-Spammer- und Missbrauchsfilter]] erkennen kann, dass du kein Fake-Benutzer bist. Beachte, bei deinen ersten Bearbeitungen keine externen Links einzufügen, da diese wahrscheinlich die Filter auslösen werden.
Ein schneller Einstieg für die Benutzerseite:
*Gehe im Benutzermenü auf die Seite mit deinem '''Benutzernamen''' (oder nimm den ersten Menüpunkt ganz rechts oben im Dropdown-Menü)
*Klick auf die Dropdown-Schaltfläche "Aktionen"{{-}}[[File:JDOCS-actions-create-page-de.png]]
*Klicke "Bearbeiten"
*Füge den Code zum Editor hinzu <code><nowiki>{{subst:Newuser}}</nowiki></code>
*Zusammenfassung ausfüllen (z.B. ''Das ist meine neue User-Seite''){{-}}[[File:JDOCS-summary-form-input-de.png]]
*Klicke "Seite speichern"

====Anmelden bei den Kommunikationskanälen der Dokumentation====
Das offizielle Kommunikationswerkzeug von Joomla ist [https://joomlacommunity.cloud.mattermost.com/ Mattermost]. Auf [[Mattermost|dieser Seite]] findest Du Informationen darüber, wie man der Unterhaltung beitreten kann. Wenn man einmal dabei ist, kann man dem [https://joomlacommunity.cloud.mattermost.com/main/channels/pd-documentation PD Documentation]-Kanal beitreten und an der Diskussion über die Joomla!-Dokumentation teilnehmen.

==Was sollte man zuerst tun?==
Es gibt mehrere Bereiche der Dokumentation, die immer wieder Aufmerksamkeit brauchen. Man könnte damit beginnen, Dokumente auszuwählen, die für einen am bequemsten sind. Oder man engagiert sich mehr, indem man an mehreren gleichzeitig arbeitet. Sobald man ein Wiki-Konto hat, kann an jedem Aspekt der Dokumentation gearbeitet werden, der einem gefällt. Selbst die einfachsten Beiträge wie Rechtschreib-Korrekturen und Grammatik-Korrekturen sind eine große Hilfe!
#[[#Unterstützung bei den Dokumentations-Inhalten|Unterstützung bei den Dokumentations-Inhalten]].
#[[#Wiki Wartungsaufgaben|Wiki Wartungsaufgaben]].
#[[#Dokumentations-Projekte|Dokumentations-Projekte]].
#[[#Hilfeseiten|Hilfeseiten]].
#[[JDOC:Page_Translation_Explained|Page Translation Explained]].

===Unterstützung bei den Dokumentations-Inhalten===

#Bearbeiten, Überschreiben und Umstrukturieren von Seiten. In unserem Wiki gibt es [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Needs-Seiten]] für Bereiche, die sofortige Hilfe benötigen. Sie werden 'Needs-Seiten' genannt, weil sie kleine Aufgaben benötigen, um sie zu vervollständigen. Einige von ihnen sind so einfach wie die Überprüfung des Inhalts oder das Hinzufügen eines Bildes. Andere erfordern mehr Inhalt oder Verbesserungen. Nimm ein paar davon und schenke ihnen ein wenig Zuwendung. Dies ist eine enorme Hilfe für Joomla! Benutzer, die sich auf unsere Dokumentation verlassen.
#Hast du Spaß beim Suchen nach Seiten, die überflüssig sind (z.B. über die Versionen 1.0 und 1.5), oder die wegen versionsspezifischer Informationen aufgeteilt werden müssen? Dann verwende die Marker-Templates {{tl|delete}}, {{tl|merge}} oder {{tl|JSplit}} auf den betreffenden Seiten. Um zu erfahren, wie man sie einsetzt, klicke auf die vorherigen Template-Links. Dort erfährst du, wie man sie auf Seiten anwenden kann, von denen du denkst, dass diese die Markierungen benötigen. Füge sie ganz oben auf einer Seite ein und die Seite ist markiert.
#'''Erstelle eine neue Seite oder Tutorial''' Mach vor der Erstellung einer neuen Seite erst eine intensive Suche. Erstelle keine weitere Seite, wenn bereits eine existiert. Benutze die [[Special:Search|Suche]] des JDocs Wiki, um zu sehen, ob der Begriff bereits auf einer Seite existiert. '''Duplikate werden zusammengeführt und / oder gelöscht'''. Habe keine Angst, die Arbeit eines Anderen an der Joomla-Dokumentation zu verändern, neu zu formatieren oder zu verbessern! Dies ist ein kollaboratives Dokumentations-Wiki, stelle einfach sicher, dass den [[S:MyLanguage/JDOC:Policies and guidelines|Grundsätzen und Richtlinien]] gefolgt wird.
##''Wiki-Links einsetzen.'' Es ist sehr einfach, Seiten mit einer Standardsyntax zu verlinken. Wenn man einen Link zu einer Seite erstellt, die noch nicht existiert, wird der Link rot eingefärbt. Ein Klick auf einen roten Link führt direkt zur Bearbeitungsseite der neuen Seite. Gib einfach den gewünschten Inhalts-Text ein, klicke auf Speichern und die neue Seite wird erstellt. Danach wechselt der Link von rot auf blau und zeigt damit an, dass die Seite nun existiert.
##''URL einsetzen.'' Einzusetzen, wenn man eine Seite von Grund auf neu erstellen möchte. Man kann die URL des Wikis zum Erstellen einer neuen Seite verwenden. Die URL zu einem Artikel des Wikis ist normalerweise ähnlich wie: <tt><nowiki>https://docs.joomla.org/YOURTITLE</nowiki></tt>. Wenn man YOURTITLE durch den Namen der Seite ersetzt, die man erstellen möchte, gelangt man auf eine leere Seite, die anzeigt, dass noch keine Seite dieses Namens existiert. Ein Klick auf den ''Seite erstellen''-Link führt zur Bearbeitungs-Seite der neuen Seite. Hier kann der Inhalt eingegeben werden, durch Klick auf ''Speichern'' wird die Seite angelegt.
#'''Hilfe durch Aktualisieren von Bildern in Seiten.''' Schau in die Kategorie [[S:MyLanguage/:Category:Needs image updating|Zu aktualisierende Bilder]] um die Liste an Seiten zu sehen, in denen Bilder aktualisiert werden müssen. Vorgaben dafür finden sich in den [[S:MyLanguage/JDOC:Image naming guidelines|Richtlinien zur Bildbenennung]].

===Wiki Wartungsaufgaben===
:Ein Wiki zu warten und zu organisieren bedarf eine Menge an kontinuierlicher Arbeit der Administratoren, Redakteure und Benutzer. Es gibt immer Aufgaben, die Aufmerksamkeit benötigen wie z.B.: [[Special:UncategorizedPages|Nicht kategorisierte Seiten]], [[S:MyLanguage/Category:Joomla!_Wiki_need_pages|Joomla! Wiki Seiten, die Hilfe brauchen]] oder auch [[S:MyLanguage/Category:Article_under_construction|Seite befindet sich in Bearbeitung]], das Markieren von Seiten für [[Template:Delete|Löschung]], [[Template:Merge|Zusammenführung]] oder [[Template:JSplit|Aufteilung]]. Für alle Wartungsaufgaben und Ideen wie man den JDocs helfen kann, besuche bitte unsere [[S:MyLanguage/JDOC:Maintenance Tasks|Wartungsseite]].

===Dokumentations-Projekte===
*Das JDocs-Team arbeitet an den [[S:MyLanguage/Tutorials:Beginners|Einsteiger Tutorials]]. Unser Ziel ist es, diese leicht verständlich und gut navigierbar zu machen, damit ein Anfänger die Dinge leicht nachvollziehen und Grundkonzepte erlernen kann. Denke mal daran, als du neu bei Joomla warst und füge ein Thema über etwas hinzu, mit dem man als Anfänger zu kämpfen hatte. Noch besser wäre es, dem [[S:MyLanguage/JDOC:Beginners_Tutorial_Project|Einsteiger-Tutorial-Projekt]] beizutreten.
*Tritt dem [[S:MyLanguage/JDOC:Developer Tutorials Project|Entwickler-Tutorial-Projekt]] bei und teile dein Wissen. Hinterlege Deinen Namen mit 4 Tilden ( <nowiki>~~~~</nowiki> ) auf der Seite [[S:MyLanguage/JDOC_talk:Developer Tutorials Project|Developer Tutorials Project]] und liste auf, was du tun kannst. Gerne kannst du einige [[S:MyLanguage/JDOC:Developer Tutorials Project/Topics|Topics]] zur Liste der vorgeschlagenen Themen hinzufügen.

===Hilfeseiten===

Für viele unbekannt, werden alle [[S:MyLanguage/Help screens|Hilfe]] Seiten zu jeder Joomla-Installation weltweit von diesem Wiki aus erstellt und zur Verfügung gestellt! Diese sind für Anfänger und auch für die mit fortgeschrittenen Kenntnissen über Joomla notwendig.

'''Die Joomla! 4.x Hilfe-Seiten müssen komplett überarbeitet werden.''' Jeder Beitrag, den du leisten kannst, wird von vielen Benutzern weltweit geschätzt und wir suchen Freiwillige, die uns bei dieser wichtigen Aufgabe helfen können. Eine Matrix und ein Aktionsplan müssen noch erstellt werden.

==Wichtige Dinge==
Hier ein paar Dinge, die man sich als Helfer bei den Joomla-Docs merken sollte.

*Hab keine Angst, eine Seite zu beschädigen. Wenn du das tust und etwas wirklich schief gelaufen ist, kehre zum Editieren zurück. Klick auf die Registerkarte '''Versionsgeschichte''' der Seite und du siehst Links zum Widerrufen und Wiederherstellen.
*Schreibe die Beiträge in dem Bewusstsein, dass sie in eine andere Sprache übersetzt werden sollen. Die Verwendung von Slangausdrücken oder lokalen Dialekten kann dazu führen, dass diese nicht in eine andere Sprache übersetzt oder ihre Zusammenhänge nicht verstanden werden. Weitere Informationen findest du unter [[JDOC:Documentation Translators|Übersetzen der Joomla!-Dokumentation]].
*Die [https://developer.joomla.org/en-gb-user-interface-text-guidelines/introduction.html Joomla! en-GB User Interface Text Guidelines] lesen, der für alle Joomla-Dokumentationen gilt. Er gibt hilfreiche Hinweise, wie man für die Joomla Dokumentation schreibt.
*Beim Schreiben sollte auf die korrekte Rechtschreibung geachtet werden. Für eine sofortige Rückmeldung sollten Sie die Browser Google Chrome oder Mozilla Firefox verwenden. Beide haben eine integrierte Rechtschreibprüfung, die ein falsch geschriebenes Wort unterstreicht.
*Vergiss nicht das {{tl|inuse}}-Template an einen Artikel anzuwenden, den du für länger als eine Minute bearbeitest. Es hilft, Bearbeitungs-Konflikte zu vermeiden.

==Hilfe, ich kenne Wiki Markup nicht!==
Wenn du neu beim '''''Wiki''''' und der einfachen Markup für Seiten bist, kannst du Folgendes als Hilfe verwenden.
*Der neue WikiEditor hat Buttons und Links, um den Seitenbau einfach zu machen. Klick auf das Wort ''''Advanced'''' für mehr Buttons und Formatierungs-Links.
*Verwende [[S:MyLanguage/Help:Cheatsheet|JDOC's Wiki Cheatsheet]] um grundlegende Syntax-Kommandos zu lernen. Es gibt auch ein Aufklappmenü mit den gebräuchlichen Markup im Editor. Klick auf das Wort ''Hilfe'', um sie aufzurufen.
*Noch unschlüssig? Diese Werkzeuge für die Wiki-Seiten versuchen
:*[https://www.microsoft.com/en-us/download/details.aspx?id=12298 Microsoft Word Add-on for Wiki Markup], speichert Word-Dokumente als Wiki-Markup
:*'''OpenOffice.org versions 2.4 und später''' haben einen eingebauten MediaWiki-Exportfilter. Öffne das Writer-Dokument, klick auf "Datei → Export" und ändere das Dateiformat auf MediaWiki.
:*Hier eine [[wp:Wikipedia:Tools#Importing_.28converting.29_content_to_Wikipedia_.28MediaWiki.29_format|Liste von Werkzeugen]] um andere Formate wie HTML, Excel, CSV in Wiki-Markup umzuwandeln. Einige konvertieren ausgeschnittenes und eingefügtes HTML online in Wiki-Markup.
*Hilfe finden auf [https://joomlacommunity.cloud.mattermost.com/ Mattermost], (Wir haben dort eine Menge Kanäle. Beispielsweise einen für die JDocs Translation Group und einen für die JDocs Working Group).
*Eine Frage an einen [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=sysop&limit=50 Administrator] oder [https://docs.joomla.org/index.php?title=Special%3AListUsers&username=&group=editor&limit=50 Editor] auf deren Diskussionsseite posten.

[[Category:Documentation Wiki Information/de]]
[[Category:Volunteer Engagement{{#translation:}}]]

Translations:JDOC:How to Contribute to Joomla! Documentation/52/de

2025-01-24T08:49:56Z

Max123kl: Created page with "Neue Dokumentation"

Neue Dokumentation

JDOC:How to Contribute to Joomla! Documentation

2025-01-24T08:46:42Z

Max123kl: Marked this version for translation

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

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

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

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

<translate>

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

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

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

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

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

<translate>

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

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

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

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

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

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

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

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

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

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

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

<translate>

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

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

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

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

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

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

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

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

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

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

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

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

<translate>

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

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

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

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

<translate>

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

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

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

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

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

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

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

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

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

Search Engine Friendly URLs/de

2025-01-24T06:38:05Z

Max123kl:

<noinclude><languages /></noinclude>
<onlyinclude>
'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine ''Route'' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als ''Routing'' bezeichnet. Der dazugehörige Code wird ''Router'' genannt.
</onlyinclude>
Ein gutes Beispiel für Routing ist die URL des ''Willkommen zu Joomla!'' Beitrags in den Beispieldaten.

* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt ''<nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: ''<nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird ''<nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki>'' erzeugt.

== Optionen ==
Suchmaschinenfreundliche URLs werden hauptsächlich in der ''„globalen“ Konfiguration'' über den Block ''Suchmaschinenoptimierung (SEO)'' gesteuert. Dort gibt es die folgenden Optionen:

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.

The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.

For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs ==

<div class="mw-translate-fuzzy">
=== Was bedeuten die Zahlen in der URL? ===
Beim Vergleich der alten und der neuen URL sieht man Zahlen in der alten URL ,
</div>

<pre><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:willkommen-bei-joomla&catid=1:letzte-neuigkeiten&Itemid=50</nowiki></pre>

es gibt aber auch Zahlen in der neuen URL:

<pre><nowiki>http://www.beispiel.de/aktuell/1-letzte-neuigkeiten/1-willkommen-bei-joomla</nowiki></pre>

<div class="mw-translate-fuzzy">
Bei den Zahlen handelt es sich um Parameter, die von Joomla verwendet werden, um die interne URL zu ermitteln und die entsprechende Seite anzeigen zu können (im Beispiel handelt es sich bei der ersten Ziffer um die ID der Kategorie, bei der Zweiten um die ID des Beitrags).
</div>

<div class="mw-translate-fuzzy">
=== Es gibt kein <code>index.php</code> mehr in der URL. Kann ich die Datei nun löschen? ===
'''Nein!''' Die URL enthält zwar kein <code>index.php</code> mehr, aber intern wird der mod_rewrite zum Originalpfad umleiten, ohne es dem Anwender zu zeigen.
</div>

<div class="mw-translate-fuzzy">
=== Was ist der [[Alias]] ? Wie kann man ihn erzeugen? ===
Alias-Felder finden sich rechts neben den Titel-Feldern in Beiträgen, Kategorien und Menüeinträgen. Joomla! kann den Alias automatisch erzeugen. Als Basis wird der Titel verwendet. Alle Großbuchstaben werden in Kleinbuchstaben umgesetzt, Leerzeichen und Sonderzeichen sind in einer URL nicht erlaubt und werden daher durch Bindestriche ersetzt.
</div>

<div class="mw-translate-fuzzy">
=== Verwendung eines selbst definierten Alias-Werts ===
Falls der von Joomla erzeugte Wert für den Alias nicht verwendet werden soll, kann ein individueller Wert in das Alias-Feld eingetragen werden. Die Verwendung von guten Schlüsselwörtern in der URL soll die Suchmaschinenoptimierung verbessern. Die Schlüsselwörter können entweder in den Titel eingebaut werden, woraus Joomla den Alias generiert oder sie können direkt im selbst definierten Alias verwendet werden.
</div>

<div class="mw-translate-fuzzy">
=== Wie wird der Alias in der URL verwendet? ===
Im Menüeintrag verwendet Joomla! den Alias als Baustein. Sind die ersten beiden SEF Einstellungen in der Konfiguration aktiviert (Suchmaschinenfreundliche URL + URL Rewrite) und man erzeugt einen Menüeintrag mit dem Titel Produkte erhält man folgende URL: beispiel.de/produkte.
</div>

<div class="mw-translate-fuzzy">
Joomla verwendet zusätzlich den Primärschlüssel der Daten innerhalb der URL. So kann der Router zur richtigen Webseite navigieren. Im folgenden wird das oben verwendete Beispiel weitergeführt: der Menüeintrag Produkte hat den Menüeintragstyp Beiträge/Kategorieblog. Der Link des Beitragtitels und/oder der Weiterlesen-Link bestehen dann aus drei Teilen:
</div>

<div class="mw-translate-fuzzy">
* Die URL des Menüeintrags - beispiel.de/produkte;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für die Kategorie und den Kategorie-Alias - 32-Obst;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für den Beitrag und den Alias des Beitrags - 1-Apfel;
</div>

<div class="mw-translate-fuzzy">
Die vollständige URL ergibt sich dann zu: <code><nowiki>http://beispiel.de/produkte/32-obst/1-apfel</nowiki></code>
</div>

<div class="mw-translate-fuzzy">
=== Wie können die Zahlen in den SEF URLs vermieden werden? ===
Die Zahlen in der SEF URL werden vom Joomla Router gebraucht, um die Seitenzugriffe zu lenken. Mit einer stablilen Router Logik, können Drittanbieter einfach Plugins entwickeln. So werden die Möglichkeiten der Router vergrößert, z.B. durch bessere Auswahlmöglichkeiten. Dann werden sicherlich auch die Zahlen aus den URLs entfernt.
</div>

== Route Formate und Routing Mechanismus ==

''Dieser Teil beschreibt Joomlas Core (built-in) Routing Mechanismus. Externe Routing Erweiterungen können die Art der Erzeugung von Routes im System verändern.''

=== Route Formate ===

<div class="mw-translate-fuzzy">
Zur Beschreibung des Joomla Routing Mechanismus im Detail muss der Begriff '''Route''' erklärt werden. Angenommen das Joomla System wurde auf <code><nowiki>http://beispiel.de/sites/first/</nowiki></code> installiert. Der Installationspfad wird allgemein als '''base URL''' bezeichnet. Betrachtet man folgende Beispiel-URL <code><nowiki>http://beispiel.de/sites/first/products/32-fruit/1-apple</nowiki></code>, dann ist der erste Teil der URL die base URL, dieser Teil kann von Joomla und den Routern der Komponenten nicht verändert werden. Der zweite Teil <code>products/32-fruit/1-apple</code>, wird als '''Route''' bezeichnet, und besteht wiederum aus drei '''Segmenten'''.
</div>

<div class="mw-translate-fuzzy">
Das erste Segment einer Route wird bei einer typischen URL vom Alias des Menüeintrags gebildet. Die SEF URL wird sozusagen durch den Menüeintrag geleitet ('''routed through'''). Die anderen Segmente werden durch den Router der Komponente bestimmt, die für den Menüeintragstyp zur Verfügung verantwortlich ist. Zum Beispiel wird der Menüeintragstyp ''Kategorie - Blog'' von der Komponente [[Inhalt]] bereitgestellt. Daher ist dieser Router für die Erzeugung und das Parsen des restlichen Segments verantwortlich.
</div>

<div class="mw-translate-fuzzy">
Joomla kann auch für Erweiterungen Routen erzeugen, ohne einen Menüeintrag zur Verfügung zu haben. In diesem Fall generiert das System eine spezielle Route, die mit dem Wort <code>component</code> als erstes Segment beginnt. Diese Route wird unter Verwendung eines festen Formats erzeugt: der Name der Komponente (ohne das führende <code>com_</code>) wird zum zweiten Segement und alle anderen Parameter als weitere Segemente angehängt.
</div>

=== Grenzen ===

<div class="mw-translate-fuzzy">
Es ist wichtig zu verstehen, dass die Erstellung von Menüpunkten die ''einzige'' Möglichkeit für Joomla Benutzer ist, eine Route zu definieren, die zu einer spezifischen Komponente führt. Allerdings können Routen erstellt werden, ohne sie auf der Website in einem Menü anzuzeigen. Eine häufig verwendete Methode besteht in der Erzeugung eines Menüs, welches im Frontend nicht angezeigt wird. So ein Menü wird [[Menu|Schattenmenü]] (hidden menu) genannt .
</div>

<div class="mw-translate-fuzzy">
Der vorige Abschnitt zeigt, dass es nicht möglich ist, eine einzige Komponente für die Behandlung aller Routen verantwortlich zu machen. Es ist z.B. nicht möglich zu spezifizieren, dass die URL <code><nowiki>http://beispiel.de/deralias</nowiki></code> den Beitrag mit dem Alias <code>deralias</code> anzeigt, wobei <code>deralias</code> jeder beliebige Text sein kann. Falls solche URLs benötigt werden, können für die einzelnen Beiträge, jeweils eigene Menüpunkte im Schattenmenü erstellt werden. Dies ist jedoch nur bei einer kleinen Anzahl von Beiträgen sinnvoll. Ansonsten ist eine Routing Erweiterung notwendig.
</div>

Der Routing Mechanismus ist daher nicht so flexibel, wie ihn Benutzer manchmal brauchen. Andererseits reduziert er die Wahrscheinlichkeit für mehrdeutige Routen (gleiche Route, die auf verschiedene Seiten weist) und hat so einen großen Vorteil. Da das erste Segment immer von einem Menüeintrag gebildet wird, weiß das System sofort, welcher Komponenten-Router zum Parsen verwendet werden muss.

==Details der Implementierung ==
=== Handhabung der Routen ===

''Dieser Abschnitt beschreibt die Implementierung des Routings in Joomla. Komponenten Enwickler könnte auch dies interessieren: [[Supporting SEF URLs in your component]].''

<div class="mw-translate-fuzzy">
Joomla Routen werden von der [[JRouter|JRouter Klasse]] erzeugt und aufgelöst. Diese Klasse schaut im Wurzel-Verzeichnis (root) der aktiven Komponente nach (spezifiziert im <code>option</code> Parameter im query string) und fügt die <code>router.php</code> Datei in das Wurzel-Verzeichnis der Komponente ein. Es kann danach entweder die Funktion zur Erzeugung der SEF URL oder die zur Interpretation der SEF URL aufgerufen werden.
</div>

<div class="mw-translate-fuzzy">
Die JRouter Klasse wird vom Joomla CMS in <code>/includes/router.php</code> überschrieben (overriden). In dieser Datei werden die Build- und Parse-Funktionen überschrieben, um einen sauberen Aufbau der URLs ( build und parse) im Joomla zu erreichen.
</div>

<div class="mw-translate-fuzzy">
Die <code>router.php</code> Datei einer Komponente (z.B.: <code>/components/com_content/router.php</code>) sollte folgende Funktionen enthalten:
* ContentBuildRoute - baut die SEF URL auf
** Parameter
*** $query - dieser Array enthält die querystring Variablen
** Returns: ein Array aus Segmenten. Jedes Segment ist durch ein '/' getrennt. Da diese später kombiniert werden, um die eigentliche URL zu erzeugen, sollten diese Felder im Arry keine '/' Zeichen enthalten.
* ContentParseRoute - interpretiert eine SEF URL
** Parameters
*** $segments - dieses Array enthält die Segmente der angeforderten URL.
** Returns: ein Name => (value) Array der querystring Variablen. Auf das Array verweist der Link.
</div>

<div class="mw-translate-fuzzy">
=== Das SEF Plugin ===
Das Joomla ''System - SEF'' Plugin erbt <code>JPlugin</code> und implementiert die Funktion <code>onAfterRender()</code>. In dieser Funktion wird der Body der Antwort, die an den Browser geschickt wird ermittelt, durch die Verwendung von <code>JResponse::getBody()</code>. Der Body der Antwort wird dann auf Links durchsucht die <code>/index.php...</code> enthalten. Danach werden diese Teile der Links durch eine korrekter SEF URL ersetzt. Dies geschieht während des Aufrufs von <code>JRoute::_(''url'')</code>.
</div>

<div class="mw-translate-fuzzy">
JRoute baut SEF URLs durch Instanziierung von <code>JRouter</code>-Objekten auf. Dabei gibt es die Anforderung mit, das korrekte Links aus den weitergegebenen URLs aufgebaut werden.
</div>

<div class="mw-translate-fuzzy">
=== Handhabung von SEF URLs ===
Im Standard werden SEF URLs vom <code>JRouterSite</code>-Objekt ( <code>/includes/router.php</code>) gehandhabt. Sie werden von <code>JApplication::route()</code> in der Datei index.php aufgerufen. Dieser Aufruf erfolgt durch die <code>$app</code>-Variable. Diese ist eine Instantz von <code>JSite</code> (von <code>/includes/application.php</code>).
</div>

<div class="mw-translate-fuzzy">
<code>JApplication::route()</code> hat das Ergebnis (non-destructive) im <code>$_GET</code> Array. <code>JApplication::route()</code> setzt Variablen in <code>$_GET</code> durch den Aufruf von <code>JRequest::set()</code>, dabei ist das overwrite Flag auf false gesetzt. Daher wird ein Variablenname, der von <code>JRouter::route()</code> zurückgebeben wird und bereits in <code>$_GET</code> vorhanden ist, nicht in <code>$_GET</code> übernommen. Die ermöglicht eigenentwickeltes Routing.
</div>

<div class="mw-translate-fuzzy">
=== Eigenentwickeltes Routing ===
Joomla erlaubt die Erstellung eigener Routing Mechanismen. Um diese zu erzeugen wird ein Plugin benötigt, dass die <code>JPlugin::onAfterInitialise()</code> Funktion überschreibt. Diese Funktion parst dann die URL und erzeugt die benötigten Variablen in <code>$_GET</code> bevor das Standard-Routing in Joomla abläuft.
</div>

''Siehe auch [[Creating a System Plugin to augment JRouter]] als Beispiel.''

[[Category:Search Engine Friendly URLs| ]]

Translations:Search Engine Friendly URLs/2/de

2025-01-24T06:38:03Z

Max123kl:

Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine ''Route'' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als ''Routing'' bezeichnet. Der dazugehörige Code wird ''Router'' genannt.

Search Engine Friendly URLs/de

2025-01-24T06:36:33Z

Max123kl:

<noinclude><languages /></noinclude>
<onlyinclude>
'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine ''Route'' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als ''Routing'' bezeichnet. Der dazugehörige Code wird '''Router''' genannt.
</onlyinclude>
Ein gutes Beispiel für Routing ist die URL des ''Willkommen zu Joomla!'' Beitrags in den Beispieldaten.

* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt ''<nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: ''<nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird ''<nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki>'' erzeugt.

== Optionen ==
Suchmaschinenfreundliche URLs werden hauptsächlich in der ''„globalen“ Konfiguration'' über den Block ''Suchmaschinenoptimierung (SEO)'' gesteuert. Dort gibt es die folgenden Optionen:

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.

The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.

For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs ==

<div class="mw-translate-fuzzy">
=== Was bedeuten die Zahlen in der URL? ===
Beim Vergleich der alten und der neuen URL sieht man Zahlen in der alten URL ,
</div>

<pre><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:willkommen-bei-joomla&catid=1:letzte-neuigkeiten&Itemid=50</nowiki></pre>

es gibt aber auch Zahlen in der neuen URL:

<pre><nowiki>http://www.beispiel.de/aktuell/1-letzte-neuigkeiten/1-willkommen-bei-joomla</nowiki></pre>

<div class="mw-translate-fuzzy">
Bei den Zahlen handelt es sich um Parameter, die von Joomla verwendet werden, um die interne URL zu ermitteln und die entsprechende Seite anzeigen zu können (im Beispiel handelt es sich bei der ersten Ziffer um die ID der Kategorie, bei der Zweiten um die ID des Beitrags).
</div>

<div class="mw-translate-fuzzy">
=== Es gibt kein <code>index.php</code> mehr in der URL. Kann ich die Datei nun löschen? ===
'''Nein!''' Die URL enthält zwar kein <code>index.php</code> mehr, aber intern wird der mod_rewrite zum Originalpfad umleiten, ohne es dem Anwender zu zeigen.
</div>

<div class="mw-translate-fuzzy">
=== Was ist der [[Alias]] ? Wie kann man ihn erzeugen? ===
Alias-Felder finden sich rechts neben den Titel-Feldern in Beiträgen, Kategorien und Menüeinträgen. Joomla! kann den Alias automatisch erzeugen. Als Basis wird der Titel verwendet. Alle Großbuchstaben werden in Kleinbuchstaben umgesetzt, Leerzeichen und Sonderzeichen sind in einer URL nicht erlaubt und werden daher durch Bindestriche ersetzt.
</div>

<div class="mw-translate-fuzzy">
=== Verwendung eines selbst definierten Alias-Werts ===
Falls der von Joomla erzeugte Wert für den Alias nicht verwendet werden soll, kann ein individueller Wert in das Alias-Feld eingetragen werden. Die Verwendung von guten Schlüsselwörtern in der URL soll die Suchmaschinenoptimierung verbessern. Die Schlüsselwörter können entweder in den Titel eingebaut werden, woraus Joomla den Alias generiert oder sie können direkt im selbst definierten Alias verwendet werden.
</div>

<div class="mw-translate-fuzzy">
=== Wie wird der Alias in der URL verwendet? ===
Im Menüeintrag verwendet Joomla! den Alias als Baustein. Sind die ersten beiden SEF Einstellungen in der Konfiguration aktiviert (Suchmaschinenfreundliche URL + URL Rewrite) und man erzeugt einen Menüeintrag mit dem Titel Produkte erhält man folgende URL: beispiel.de/produkte.
</div>

<div class="mw-translate-fuzzy">
Joomla verwendet zusätzlich den Primärschlüssel der Daten innerhalb der URL. So kann der Router zur richtigen Webseite navigieren. Im folgenden wird das oben verwendete Beispiel weitergeführt: der Menüeintrag Produkte hat den Menüeintragstyp Beiträge/Kategorieblog. Der Link des Beitragtitels und/oder der Weiterlesen-Link bestehen dann aus drei Teilen:
</div>

<div class="mw-translate-fuzzy">
* Die URL des Menüeintrags - beispiel.de/produkte;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für die Kategorie und den Kategorie-Alias - 32-Obst;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für den Beitrag und den Alias des Beitrags - 1-Apfel;
</div>

<div class="mw-translate-fuzzy">
Die vollständige URL ergibt sich dann zu: <code><nowiki>http://beispiel.de/produkte/32-obst/1-apfel</nowiki></code>
</div>

<div class="mw-translate-fuzzy">
=== Wie können die Zahlen in den SEF URLs vermieden werden? ===
Die Zahlen in der SEF URL werden vom Joomla Router gebraucht, um die Seitenzugriffe zu lenken. Mit einer stablilen Router Logik, können Drittanbieter einfach Plugins entwickeln. So werden die Möglichkeiten der Router vergrößert, z.B. durch bessere Auswahlmöglichkeiten. Dann werden sicherlich auch die Zahlen aus den URLs entfernt.
</div>

== Route Formate und Routing Mechanismus ==

''Dieser Teil beschreibt Joomlas Core (built-in) Routing Mechanismus. Externe Routing Erweiterungen können die Art der Erzeugung von Routes im System verändern.''

=== Route Formate ===

<div class="mw-translate-fuzzy">
Zur Beschreibung des Joomla Routing Mechanismus im Detail muss der Begriff '''Route''' erklärt werden. Angenommen das Joomla System wurde auf <code><nowiki>http://beispiel.de/sites/first/</nowiki></code> installiert. Der Installationspfad wird allgemein als '''base URL''' bezeichnet. Betrachtet man folgende Beispiel-URL <code><nowiki>http://beispiel.de/sites/first/products/32-fruit/1-apple</nowiki></code>, dann ist der erste Teil der URL die base URL, dieser Teil kann von Joomla und den Routern der Komponenten nicht verändert werden. Der zweite Teil <code>products/32-fruit/1-apple</code>, wird als '''Route''' bezeichnet, und besteht wiederum aus drei '''Segmenten'''.
</div>

<div class="mw-translate-fuzzy">
Das erste Segment einer Route wird bei einer typischen URL vom Alias des Menüeintrags gebildet. Die SEF URL wird sozusagen durch den Menüeintrag geleitet ('''routed through'''). Die anderen Segmente werden durch den Router der Komponente bestimmt, die für den Menüeintragstyp zur Verfügung verantwortlich ist. Zum Beispiel wird der Menüeintragstyp ''Kategorie - Blog'' von der Komponente [[Inhalt]] bereitgestellt. Daher ist dieser Router für die Erzeugung und das Parsen des restlichen Segments verantwortlich.
</div>

<div class="mw-translate-fuzzy">
Joomla kann auch für Erweiterungen Routen erzeugen, ohne einen Menüeintrag zur Verfügung zu haben. In diesem Fall generiert das System eine spezielle Route, die mit dem Wort <code>component</code> als erstes Segment beginnt. Diese Route wird unter Verwendung eines festen Formats erzeugt: der Name der Komponente (ohne das führende <code>com_</code>) wird zum zweiten Segement und alle anderen Parameter als weitere Segemente angehängt.
</div>

=== Grenzen ===

<div class="mw-translate-fuzzy">
Es ist wichtig zu verstehen, dass die Erstellung von Menüpunkten die ''einzige'' Möglichkeit für Joomla Benutzer ist, eine Route zu definieren, die zu einer spezifischen Komponente führt. Allerdings können Routen erstellt werden, ohne sie auf der Website in einem Menü anzuzeigen. Eine häufig verwendete Methode besteht in der Erzeugung eines Menüs, welches im Frontend nicht angezeigt wird. So ein Menü wird [[Menu|Schattenmenü]] (hidden menu) genannt .
</div>

<div class="mw-translate-fuzzy">
Der vorige Abschnitt zeigt, dass es nicht möglich ist, eine einzige Komponente für die Behandlung aller Routen verantwortlich zu machen. Es ist z.B. nicht möglich zu spezifizieren, dass die URL <code><nowiki>http://beispiel.de/deralias</nowiki></code> den Beitrag mit dem Alias <code>deralias</code> anzeigt, wobei <code>deralias</code> jeder beliebige Text sein kann. Falls solche URLs benötigt werden, können für die einzelnen Beiträge, jeweils eigene Menüpunkte im Schattenmenü erstellt werden. Dies ist jedoch nur bei einer kleinen Anzahl von Beiträgen sinnvoll. Ansonsten ist eine Routing Erweiterung notwendig.
</div>

Der Routing Mechanismus ist daher nicht so flexibel, wie ihn Benutzer manchmal brauchen. Andererseits reduziert er die Wahrscheinlichkeit für mehrdeutige Routen (gleiche Route, die auf verschiedene Seiten weist) und hat so einen großen Vorteil. Da das erste Segment immer von einem Menüeintrag gebildet wird, weiß das System sofort, welcher Komponenten-Router zum Parsen verwendet werden muss.

==Details der Implementierung ==
=== Handhabung der Routen ===

''Dieser Abschnitt beschreibt die Implementierung des Routings in Joomla. Komponenten Enwickler könnte auch dies interessieren: [[Supporting SEF URLs in your component]].''

<div class="mw-translate-fuzzy">
Joomla Routen werden von der [[JRouter|JRouter Klasse]] erzeugt und aufgelöst. Diese Klasse schaut im Wurzel-Verzeichnis (root) der aktiven Komponente nach (spezifiziert im <code>option</code> Parameter im query string) und fügt die <code>router.php</code> Datei in das Wurzel-Verzeichnis der Komponente ein. Es kann danach entweder die Funktion zur Erzeugung der SEF URL oder die zur Interpretation der SEF URL aufgerufen werden.
</div>

<div class="mw-translate-fuzzy">
Die JRouter Klasse wird vom Joomla CMS in <code>/includes/router.php</code> überschrieben (overriden). In dieser Datei werden die Build- und Parse-Funktionen überschrieben, um einen sauberen Aufbau der URLs ( build und parse) im Joomla zu erreichen.
</div>

<div class="mw-translate-fuzzy">
Die <code>router.php</code> Datei einer Komponente (z.B.: <code>/components/com_content/router.php</code>) sollte folgende Funktionen enthalten:
* ContentBuildRoute - baut die SEF URL auf
** Parameter
*** $query - dieser Array enthält die querystring Variablen
** Returns: ein Array aus Segmenten. Jedes Segment ist durch ein '/' getrennt. Da diese später kombiniert werden, um die eigentliche URL zu erzeugen, sollten diese Felder im Arry keine '/' Zeichen enthalten.
* ContentParseRoute - interpretiert eine SEF URL
** Parameters
*** $segments - dieses Array enthält die Segmente der angeforderten URL.
** Returns: ein Name => (value) Array der querystring Variablen. Auf das Array verweist der Link.
</div>

<div class="mw-translate-fuzzy">
=== Das SEF Plugin ===
Das Joomla ''System - SEF'' Plugin erbt <code>JPlugin</code> und implementiert die Funktion <code>onAfterRender()</code>. In dieser Funktion wird der Body der Antwort, die an den Browser geschickt wird ermittelt, durch die Verwendung von <code>JResponse::getBody()</code>. Der Body der Antwort wird dann auf Links durchsucht die <code>/index.php...</code> enthalten. Danach werden diese Teile der Links durch eine korrekter SEF URL ersetzt. Dies geschieht während des Aufrufs von <code>JRoute::_(''url'')</code>.
</div>

<div class="mw-translate-fuzzy">
JRoute baut SEF URLs durch Instanziierung von <code>JRouter</code>-Objekten auf. Dabei gibt es die Anforderung mit, das korrekte Links aus den weitergegebenen URLs aufgebaut werden.
</div>

<div class="mw-translate-fuzzy">
=== Handhabung von SEF URLs ===
Im Standard werden SEF URLs vom <code>JRouterSite</code>-Objekt ( <code>/includes/router.php</code>) gehandhabt. Sie werden von <code>JApplication::route()</code> in der Datei index.php aufgerufen. Dieser Aufruf erfolgt durch die <code>$app</code>-Variable. Diese ist eine Instantz von <code>JSite</code> (von <code>/includes/application.php</code>).
</div>

<div class="mw-translate-fuzzy">
<code>JApplication::route()</code> hat das Ergebnis (non-destructive) im <code>$_GET</code> Array. <code>JApplication::route()</code> setzt Variablen in <code>$_GET</code> durch den Aufruf von <code>JRequest::set()</code>, dabei ist das overwrite Flag auf false gesetzt. Daher wird ein Variablenname, der von <code>JRouter::route()</code> zurückgebeben wird und bereits in <code>$_GET</code> vorhanden ist, nicht in <code>$_GET</code> übernommen. Die ermöglicht eigenentwickeltes Routing.
</div>

<div class="mw-translate-fuzzy">
=== Eigenentwickeltes Routing ===
Joomla erlaubt die Erstellung eigener Routing Mechanismen. Um diese zu erzeugen wird ein Plugin benötigt, dass die <code>JPlugin::onAfterInitialise()</code> Funktion überschreibt. Diese Funktion parst dann die URL und erzeugt die benötigten Variablen in <code>$_GET</code> bevor das Standard-Routing in Joomla abläuft.
</div>

''Siehe auch [[Creating a System Plugin to augment JRouter]] als Beispiel.''

[[Category:Search Engine Friendly URLs| ]]

Translations:Search Engine Friendly URLs/5/de

2025-01-24T06:36:30Z

Max123kl:

== Optionen ==
Suchmaschinenfreundliche URLs werden hauptsächlich in der ''„globalen“ Konfiguration'' über den Block ''Suchmaschinenoptimierung (SEO)'' gesteuert. Dort gibt es die folgenden Optionen:

Search Engine Friendly URLs/de

2025-01-24T06:30:42Z

Max123kl:

<noinclude><languages /></noinclude>
<onlyinclude>
'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine ''Route'' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als ''Routing'' bezeichnet. Der dazugehörige Code wird '''Router''' genannt.
</onlyinclude>
Ein gutes Beispiel für Routing ist die URL des ''Willkommen zu Joomla!'' Beitrags in den Beispieldaten.

* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt ''<nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: ''<nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird ''<nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki>'' erzeugt.

<div class="mw-translate-fuzzy">
Suchmaschinenfreundliche URLs können durch die Einstellung '''Suchmaschinenfreundliche URL''' in der ''Globalen Konfiguration'' aktiviert werden. Diese Einstellung ist seit Joomla! 1.6 vorhanden. Siehe auch [[Enabling Search Engine Friendly (SEF) URLs]] für weitere Informationen.
</div>

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.

The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.

For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs ==

<div class="mw-translate-fuzzy">
=== Was bedeuten die Zahlen in der URL? ===
Beim Vergleich der alten und der neuen URL sieht man Zahlen in der alten URL ,
</div>

<pre><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:willkommen-bei-joomla&catid=1:letzte-neuigkeiten&Itemid=50</nowiki></pre>

es gibt aber auch Zahlen in der neuen URL:

<pre><nowiki>http://www.beispiel.de/aktuell/1-letzte-neuigkeiten/1-willkommen-bei-joomla</nowiki></pre>

<div class="mw-translate-fuzzy">
Bei den Zahlen handelt es sich um Parameter, die von Joomla verwendet werden, um die interne URL zu ermitteln und die entsprechende Seite anzeigen zu können (im Beispiel handelt es sich bei der ersten Ziffer um die ID der Kategorie, bei der Zweiten um die ID des Beitrags).
</div>

<div class="mw-translate-fuzzy">
=== Es gibt kein <code>index.php</code> mehr in der URL. Kann ich die Datei nun löschen? ===
'''Nein!''' Die URL enthält zwar kein <code>index.php</code> mehr, aber intern wird der mod_rewrite zum Originalpfad umleiten, ohne es dem Anwender zu zeigen.
</div>

<div class="mw-translate-fuzzy">
=== Was ist der [[Alias]] ? Wie kann man ihn erzeugen? ===
Alias-Felder finden sich rechts neben den Titel-Feldern in Beiträgen, Kategorien und Menüeinträgen. Joomla! kann den Alias automatisch erzeugen. Als Basis wird der Titel verwendet. Alle Großbuchstaben werden in Kleinbuchstaben umgesetzt, Leerzeichen und Sonderzeichen sind in einer URL nicht erlaubt und werden daher durch Bindestriche ersetzt.
</div>

<div class="mw-translate-fuzzy">
=== Verwendung eines selbst definierten Alias-Werts ===
Falls der von Joomla erzeugte Wert für den Alias nicht verwendet werden soll, kann ein individueller Wert in das Alias-Feld eingetragen werden. Die Verwendung von guten Schlüsselwörtern in der URL soll die Suchmaschinenoptimierung verbessern. Die Schlüsselwörter können entweder in den Titel eingebaut werden, woraus Joomla den Alias generiert oder sie können direkt im selbst definierten Alias verwendet werden.
</div>

<div class="mw-translate-fuzzy">
=== Wie wird der Alias in der URL verwendet? ===
Im Menüeintrag verwendet Joomla! den Alias als Baustein. Sind die ersten beiden SEF Einstellungen in der Konfiguration aktiviert (Suchmaschinenfreundliche URL + URL Rewrite) und man erzeugt einen Menüeintrag mit dem Titel Produkte erhält man folgende URL: beispiel.de/produkte.
</div>

<div class="mw-translate-fuzzy">
Joomla verwendet zusätzlich den Primärschlüssel der Daten innerhalb der URL. So kann der Router zur richtigen Webseite navigieren. Im folgenden wird das oben verwendete Beispiel weitergeführt: der Menüeintrag Produkte hat den Menüeintragstyp Beiträge/Kategorieblog. Der Link des Beitragtitels und/oder der Weiterlesen-Link bestehen dann aus drei Teilen:
</div>

<div class="mw-translate-fuzzy">
* Die URL des Menüeintrags - beispiel.de/produkte;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für die Kategorie und den Kategorie-Alias - 32-Obst;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für den Beitrag und den Alias des Beitrags - 1-Apfel;
</div>

<div class="mw-translate-fuzzy">
Die vollständige URL ergibt sich dann zu: <code><nowiki>http://beispiel.de/produkte/32-obst/1-apfel</nowiki></code>
</div>

<div class="mw-translate-fuzzy">
=== Wie können die Zahlen in den SEF URLs vermieden werden? ===
Die Zahlen in der SEF URL werden vom Joomla Router gebraucht, um die Seitenzugriffe zu lenken. Mit einer stablilen Router Logik, können Drittanbieter einfach Plugins entwickeln. So werden die Möglichkeiten der Router vergrößert, z.B. durch bessere Auswahlmöglichkeiten. Dann werden sicherlich auch die Zahlen aus den URLs entfernt.
</div>

== Route Formate und Routing Mechanismus ==

''Dieser Teil beschreibt Joomlas Core (built-in) Routing Mechanismus. Externe Routing Erweiterungen können die Art der Erzeugung von Routes im System verändern.''

=== Route Formate ===

<div class="mw-translate-fuzzy">
Zur Beschreibung des Joomla Routing Mechanismus im Detail muss der Begriff '''Route''' erklärt werden. Angenommen das Joomla System wurde auf <code><nowiki>http://beispiel.de/sites/first/</nowiki></code> installiert. Der Installationspfad wird allgemein als '''base URL''' bezeichnet. Betrachtet man folgende Beispiel-URL <code><nowiki>http://beispiel.de/sites/first/products/32-fruit/1-apple</nowiki></code>, dann ist der erste Teil der URL die base URL, dieser Teil kann von Joomla und den Routern der Komponenten nicht verändert werden. Der zweite Teil <code>products/32-fruit/1-apple</code>, wird als '''Route''' bezeichnet, und besteht wiederum aus drei '''Segmenten'''.
</div>

<div class="mw-translate-fuzzy">
Das erste Segment einer Route wird bei einer typischen URL vom Alias des Menüeintrags gebildet. Die SEF URL wird sozusagen durch den Menüeintrag geleitet ('''routed through'''). Die anderen Segmente werden durch den Router der Komponente bestimmt, die für den Menüeintragstyp zur Verfügung verantwortlich ist. Zum Beispiel wird der Menüeintragstyp ''Kategorie - Blog'' von der Komponente [[Inhalt]] bereitgestellt. Daher ist dieser Router für die Erzeugung und das Parsen des restlichen Segments verantwortlich.
</div>

<div class="mw-translate-fuzzy">
Joomla kann auch für Erweiterungen Routen erzeugen, ohne einen Menüeintrag zur Verfügung zu haben. In diesem Fall generiert das System eine spezielle Route, die mit dem Wort <code>component</code> als erstes Segment beginnt. Diese Route wird unter Verwendung eines festen Formats erzeugt: der Name der Komponente (ohne das führende <code>com_</code>) wird zum zweiten Segement und alle anderen Parameter als weitere Segemente angehängt.
</div>

=== Grenzen ===

<div class="mw-translate-fuzzy">
Es ist wichtig zu verstehen, dass die Erstellung von Menüpunkten die ''einzige'' Möglichkeit für Joomla Benutzer ist, eine Route zu definieren, die zu einer spezifischen Komponente führt. Allerdings können Routen erstellt werden, ohne sie auf der Website in einem Menü anzuzeigen. Eine häufig verwendete Methode besteht in der Erzeugung eines Menüs, welches im Frontend nicht angezeigt wird. So ein Menü wird [[Menu|Schattenmenü]] (hidden menu) genannt .
</div>

<div class="mw-translate-fuzzy">
Der vorige Abschnitt zeigt, dass es nicht möglich ist, eine einzige Komponente für die Behandlung aller Routen verantwortlich zu machen. Es ist z.B. nicht möglich zu spezifizieren, dass die URL <code><nowiki>http://beispiel.de/deralias</nowiki></code> den Beitrag mit dem Alias <code>deralias</code> anzeigt, wobei <code>deralias</code> jeder beliebige Text sein kann. Falls solche URLs benötigt werden, können für die einzelnen Beiträge, jeweils eigene Menüpunkte im Schattenmenü erstellt werden. Dies ist jedoch nur bei einer kleinen Anzahl von Beiträgen sinnvoll. Ansonsten ist eine Routing Erweiterung notwendig.
</div>

Der Routing Mechanismus ist daher nicht so flexibel, wie ihn Benutzer manchmal brauchen. Andererseits reduziert er die Wahrscheinlichkeit für mehrdeutige Routen (gleiche Route, die auf verschiedene Seiten weist) und hat so einen großen Vorteil. Da das erste Segment immer von einem Menüeintrag gebildet wird, weiß das System sofort, welcher Komponenten-Router zum Parsen verwendet werden muss.

==Details der Implementierung ==
=== Handhabung der Routen ===

''Dieser Abschnitt beschreibt die Implementierung des Routings in Joomla. Komponenten Enwickler könnte auch dies interessieren: [[Supporting SEF URLs in your component]].''

<div class="mw-translate-fuzzy">
Joomla Routen werden von der [[JRouter|JRouter Klasse]] erzeugt und aufgelöst. Diese Klasse schaut im Wurzel-Verzeichnis (root) der aktiven Komponente nach (spezifiziert im <code>option</code> Parameter im query string) und fügt die <code>router.php</code> Datei in das Wurzel-Verzeichnis der Komponente ein. Es kann danach entweder die Funktion zur Erzeugung der SEF URL oder die zur Interpretation der SEF URL aufgerufen werden.
</div>

<div class="mw-translate-fuzzy">
Die JRouter Klasse wird vom Joomla CMS in <code>/includes/router.php</code> überschrieben (overriden). In dieser Datei werden die Build- und Parse-Funktionen überschrieben, um einen sauberen Aufbau der URLs ( build und parse) im Joomla zu erreichen.
</div>

<div class="mw-translate-fuzzy">
Die <code>router.php</code> Datei einer Komponente (z.B.: <code>/components/com_content/router.php</code>) sollte folgende Funktionen enthalten:
* ContentBuildRoute - baut die SEF URL auf
** Parameter
*** $query - dieser Array enthält die querystring Variablen
** Returns: ein Array aus Segmenten. Jedes Segment ist durch ein '/' getrennt. Da diese später kombiniert werden, um die eigentliche URL zu erzeugen, sollten diese Felder im Arry keine '/' Zeichen enthalten.
* ContentParseRoute - interpretiert eine SEF URL
** Parameters
*** $segments - dieses Array enthält die Segmente der angeforderten URL.
** Returns: ein Name => (value) Array der querystring Variablen. Auf das Array verweist der Link.
</div>

<div class="mw-translate-fuzzy">
=== Das SEF Plugin ===
Das Joomla ''System - SEF'' Plugin erbt <code>JPlugin</code> und implementiert die Funktion <code>onAfterRender()</code>. In dieser Funktion wird der Body der Antwort, die an den Browser geschickt wird ermittelt, durch die Verwendung von <code>JResponse::getBody()</code>. Der Body der Antwort wird dann auf Links durchsucht die <code>/index.php...</code> enthalten. Danach werden diese Teile der Links durch eine korrekter SEF URL ersetzt. Dies geschieht während des Aufrufs von <code>JRoute::_(''url'')</code>.
</div>

<div class="mw-translate-fuzzy">
JRoute baut SEF URLs durch Instanziierung von <code>JRouter</code>-Objekten auf. Dabei gibt es die Anforderung mit, das korrekte Links aus den weitergegebenen URLs aufgebaut werden.
</div>

<div class="mw-translate-fuzzy">
=== Handhabung von SEF URLs ===
Im Standard werden SEF URLs vom <code>JRouterSite</code>-Objekt ( <code>/includes/router.php</code>) gehandhabt. Sie werden von <code>JApplication::route()</code> in der Datei index.php aufgerufen. Dieser Aufruf erfolgt durch die <code>$app</code>-Variable. Diese ist eine Instantz von <code>JSite</code> (von <code>/includes/application.php</code>).
</div>

<div class="mw-translate-fuzzy">
<code>JApplication::route()</code> hat das Ergebnis (non-destructive) im <code>$_GET</code> Array. <code>JApplication::route()</code> setzt Variablen in <code>$_GET</code> durch den Aufruf von <code>JRequest::set()</code>, dabei ist das overwrite Flag auf false gesetzt. Daher wird ein Variablenname, der von <code>JRouter::route()</code> zurückgebeben wird und bereits in <code>$_GET</code> vorhanden ist, nicht in <code>$_GET</code> übernommen. Die ermöglicht eigenentwickeltes Routing.
</div>

<div class="mw-translate-fuzzy">
=== Eigenentwickeltes Routing ===
Joomla erlaubt die Erstellung eigener Routing Mechanismen. Um diese zu erzeugen wird ein Plugin benötigt, dass die <code>JPlugin::onAfterInitialise()</code> Funktion überschreibt. Diese Funktion parst dann die URL und erzeugt die benötigten Variablen in <code>$_GET</code> bevor das Standard-Routing in Joomla abläuft.
</div>

''Siehe auch [[Creating a System Plugin to augment JRouter]] als Beispiel.''

[[Category:Search Engine Friendly URLs| ]]

Translations:Search Engine Friendly URLs/4/de

2025-01-24T06:30:30Z

Max123kl:

* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt ''<nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: ''<nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird ''<nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki>'' erzeugt.

Search Engine Friendly URLs/de

2025-01-24T06:29:29Z

Max123kl:

<noinclude><languages /></noinclude>
<onlyinclude>
'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine ''Route'' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als ''Routing'' bezeichnet. Der dazugehörige Code wird '''Router''' genannt.
</onlyinclude>
Ein gutes Beispiel für Routing ist die URL des ''Willkommen zu Joomla!'' Beitrags in den Beispieldaten.

<div class="mw-translate-fuzzy">
* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt <code><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></code>
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: <code><nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code>
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird <code><nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code> erzeugt.
</div>

<div class="mw-translate-fuzzy">
Suchmaschinenfreundliche URLs können durch die Einstellung '''Suchmaschinenfreundliche URL''' in der ''Globalen Konfiguration'' aktiviert werden. Diese Einstellung ist seit Joomla! 1.6 vorhanden. Siehe auch [[Enabling Search Engine Friendly (SEF) URLs]] für weitere Informationen.
</div>

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.

The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.

For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs ==

<div class="mw-translate-fuzzy">
=== Was bedeuten die Zahlen in der URL? ===
Beim Vergleich der alten und der neuen URL sieht man Zahlen in der alten URL ,
</div>

<pre><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:willkommen-bei-joomla&catid=1:letzte-neuigkeiten&Itemid=50</nowiki></pre>

es gibt aber auch Zahlen in der neuen URL:

<pre><nowiki>http://www.beispiel.de/aktuell/1-letzte-neuigkeiten/1-willkommen-bei-joomla</nowiki></pre>

<div class="mw-translate-fuzzy">
Bei den Zahlen handelt es sich um Parameter, die von Joomla verwendet werden, um die interne URL zu ermitteln und die entsprechende Seite anzeigen zu können (im Beispiel handelt es sich bei der ersten Ziffer um die ID der Kategorie, bei der Zweiten um die ID des Beitrags).
</div>

<div class="mw-translate-fuzzy">
=== Es gibt kein <code>index.php</code> mehr in der URL. Kann ich die Datei nun löschen? ===
'''Nein!''' Die URL enthält zwar kein <code>index.php</code> mehr, aber intern wird der mod_rewrite zum Originalpfad umleiten, ohne es dem Anwender zu zeigen.
</div>

<div class="mw-translate-fuzzy">
=== Was ist der [[Alias]] ? Wie kann man ihn erzeugen? ===
Alias-Felder finden sich rechts neben den Titel-Feldern in Beiträgen, Kategorien und Menüeinträgen. Joomla! kann den Alias automatisch erzeugen. Als Basis wird der Titel verwendet. Alle Großbuchstaben werden in Kleinbuchstaben umgesetzt, Leerzeichen und Sonderzeichen sind in einer URL nicht erlaubt und werden daher durch Bindestriche ersetzt.
</div>

<div class="mw-translate-fuzzy">
=== Verwendung eines selbst definierten Alias-Werts ===
Falls der von Joomla erzeugte Wert für den Alias nicht verwendet werden soll, kann ein individueller Wert in das Alias-Feld eingetragen werden. Die Verwendung von guten Schlüsselwörtern in der URL soll die Suchmaschinenoptimierung verbessern. Die Schlüsselwörter können entweder in den Titel eingebaut werden, woraus Joomla den Alias generiert oder sie können direkt im selbst definierten Alias verwendet werden.
</div>

<div class="mw-translate-fuzzy">
=== Wie wird der Alias in der URL verwendet? ===
Im Menüeintrag verwendet Joomla! den Alias als Baustein. Sind die ersten beiden SEF Einstellungen in der Konfiguration aktiviert (Suchmaschinenfreundliche URL + URL Rewrite) und man erzeugt einen Menüeintrag mit dem Titel Produkte erhält man folgende URL: beispiel.de/produkte.
</div>

<div class="mw-translate-fuzzy">
Joomla verwendet zusätzlich den Primärschlüssel der Daten innerhalb der URL. So kann der Router zur richtigen Webseite navigieren. Im folgenden wird das oben verwendete Beispiel weitergeführt: der Menüeintrag Produkte hat den Menüeintragstyp Beiträge/Kategorieblog. Der Link des Beitragtitels und/oder der Weiterlesen-Link bestehen dann aus drei Teilen:
</div>

<div class="mw-translate-fuzzy">
* Die URL des Menüeintrags - beispiel.de/produkte;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für die Kategorie und den Kategorie-Alias - 32-Obst;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für den Beitrag und den Alias des Beitrags - 1-Apfel;
</div>

<div class="mw-translate-fuzzy">
Die vollständige URL ergibt sich dann zu: <code><nowiki>http://beispiel.de/produkte/32-obst/1-apfel</nowiki></code>
</div>

<div class="mw-translate-fuzzy">
=== Wie können die Zahlen in den SEF URLs vermieden werden? ===
Die Zahlen in der SEF URL werden vom Joomla Router gebraucht, um die Seitenzugriffe zu lenken. Mit einer stablilen Router Logik, können Drittanbieter einfach Plugins entwickeln. So werden die Möglichkeiten der Router vergrößert, z.B. durch bessere Auswahlmöglichkeiten. Dann werden sicherlich auch die Zahlen aus den URLs entfernt.
</div>

== Route Formate und Routing Mechanismus ==

''Dieser Teil beschreibt Joomlas Core (built-in) Routing Mechanismus. Externe Routing Erweiterungen können die Art der Erzeugung von Routes im System verändern.''

=== Route Formate ===

<div class="mw-translate-fuzzy">
Zur Beschreibung des Joomla Routing Mechanismus im Detail muss der Begriff '''Route''' erklärt werden. Angenommen das Joomla System wurde auf <code><nowiki>http://beispiel.de/sites/first/</nowiki></code> installiert. Der Installationspfad wird allgemein als '''base URL''' bezeichnet. Betrachtet man folgende Beispiel-URL <code><nowiki>http://beispiel.de/sites/first/products/32-fruit/1-apple</nowiki></code>, dann ist der erste Teil der URL die base URL, dieser Teil kann von Joomla und den Routern der Komponenten nicht verändert werden. Der zweite Teil <code>products/32-fruit/1-apple</code>, wird als '''Route''' bezeichnet, und besteht wiederum aus drei '''Segmenten'''.
</div>

<div class="mw-translate-fuzzy">
Das erste Segment einer Route wird bei einer typischen URL vom Alias des Menüeintrags gebildet. Die SEF URL wird sozusagen durch den Menüeintrag geleitet ('''routed through'''). Die anderen Segmente werden durch den Router der Komponente bestimmt, die für den Menüeintragstyp zur Verfügung verantwortlich ist. Zum Beispiel wird der Menüeintragstyp ''Kategorie - Blog'' von der Komponente [[Inhalt]] bereitgestellt. Daher ist dieser Router für die Erzeugung und das Parsen des restlichen Segments verantwortlich.
</div>

<div class="mw-translate-fuzzy">
Joomla kann auch für Erweiterungen Routen erzeugen, ohne einen Menüeintrag zur Verfügung zu haben. In diesem Fall generiert das System eine spezielle Route, die mit dem Wort <code>component</code> als erstes Segment beginnt. Diese Route wird unter Verwendung eines festen Formats erzeugt: der Name der Komponente (ohne das führende <code>com_</code>) wird zum zweiten Segement und alle anderen Parameter als weitere Segemente angehängt.
</div>

=== Grenzen ===

<div class="mw-translate-fuzzy">
Es ist wichtig zu verstehen, dass die Erstellung von Menüpunkten die ''einzige'' Möglichkeit für Joomla Benutzer ist, eine Route zu definieren, die zu einer spezifischen Komponente führt. Allerdings können Routen erstellt werden, ohne sie auf der Website in einem Menü anzuzeigen. Eine häufig verwendete Methode besteht in der Erzeugung eines Menüs, welches im Frontend nicht angezeigt wird. So ein Menü wird [[Menu|Schattenmenü]] (hidden menu) genannt .
</div>

<div class="mw-translate-fuzzy">
Der vorige Abschnitt zeigt, dass es nicht möglich ist, eine einzige Komponente für die Behandlung aller Routen verantwortlich zu machen. Es ist z.B. nicht möglich zu spezifizieren, dass die URL <code><nowiki>http://beispiel.de/deralias</nowiki></code> den Beitrag mit dem Alias <code>deralias</code> anzeigt, wobei <code>deralias</code> jeder beliebige Text sein kann. Falls solche URLs benötigt werden, können für die einzelnen Beiträge, jeweils eigene Menüpunkte im Schattenmenü erstellt werden. Dies ist jedoch nur bei einer kleinen Anzahl von Beiträgen sinnvoll. Ansonsten ist eine Routing Erweiterung notwendig.
</div>

Der Routing Mechanismus ist daher nicht so flexibel, wie ihn Benutzer manchmal brauchen. Andererseits reduziert er die Wahrscheinlichkeit für mehrdeutige Routen (gleiche Route, die auf verschiedene Seiten weist) und hat so einen großen Vorteil. Da das erste Segment immer von einem Menüeintrag gebildet wird, weiß das System sofort, welcher Komponenten-Router zum Parsen verwendet werden muss.

==Details der Implementierung ==
=== Handhabung der Routen ===

''Dieser Abschnitt beschreibt die Implementierung des Routings in Joomla. Komponenten Enwickler könnte auch dies interessieren: [[Supporting SEF URLs in your component]].''

<div class="mw-translate-fuzzy">
Joomla Routen werden von der [[JRouter|JRouter Klasse]] erzeugt und aufgelöst. Diese Klasse schaut im Wurzel-Verzeichnis (root) der aktiven Komponente nach (spezifiziert im <code>option</code> Parameter im query string) und fügt die <code>router.php</code> Datei in das Wurzel-Verzeichnis der Komponente ein. Es kann danach entweder die Funktion zur Erzeugung der SEF URL oder die zur Interpretation der SEF URL aufgerufen werden.
</div>

<div class="mw-translate-fuzzy">
Die JRouter Klasse wird vom Joomla CMS in <code>/includes/router.php</code> überschrieben (overriden). In dieser Datei werden die Build- und Parse-Funktionen überschrieben, um einen sauberen Aufbau der URLs ( build und parse) im Joomla zu erreichen.
</div>

<div class="mw-translate-fuzzy">
Die <code>router.php</code> Datei einer Komponente (z.B.: <code>/components/com_content/router.php</code>) sollte folgende Funktionen enthalten:
* ContentBuildRoute - baut die SEF URL auf
** Parameter
*** $query - dieser Array enthält die querystring Variablen
** Returns: ein Array aus Segmenten. Jedes Segment ist durch ein '/' getrennt. Da diese später kombiniert werden, um die eigentliche URL zu erzeugen, sollten diese Felder im Arry keine '/' Zeichen enthalten.
* ContentParseRoute - interpretiert eine SEF URL
** Parameters
*** $segments - dieses Array enthält die Segmente der angeforderten URL.
** Returns: ein Name => (value) Array der querystring Variablen. Auf das Array verweist der Link.
</div>

<div class="mw-translate-fuzzy">
=== Das SEF Plugin ===
Das Joomla ''System - SEF'' Plugin erbt <code>JPlugin</code> und implementiert die Funktion <code>onAfterRender()</code>. In dieser Funktion wird der Body der Antwort, die an den Browser geschickt wird ermittelt, durch die Verwendung von <code>JResponse::getBody()</code>. Der Body der Antwort wird dann auf Links durchsucht die <code>/index.php...</code> enthalten. Danach werden diese Teile der Links durch eine korrekter SEF URL ersetzt. Dies geschieht während des Aufrufs von <code>JRoute::_(''url'')</code>.
</div>

<div class="mw-translate-fuzzy">
JRoute baut SEF URLs durch Instanziierung von <code>JRouter</code>-Objekten auf. Dabei gibt es die Anforderung mit, das korrekte Links aus den weitergegebenen URLs aufgebaut werden.
</div>

<div class="mw-translate-fuzzy">
=== Handhabung von SEF URLs ===
Im Standard werden SEF URLs vom <code>JRouterSite</code>-Objekt ( <code>/includes/router.php</code>) gehandhabt. Sie werden von <code>JApplication::route()</code> in der Datei index.php aufgerufen. Dieser Aufruf erfolgt durch die <code>$app</code>-Variable. Diese ist eine Instantz von <code>JSite</code> (von <code>/includes/application.php</code>).
</div>

<div class="mw-translate-fuzzy">
<code>JApplication::route()</code> hat das Ergebnis (non-destructive) im <code>$_GET</code> Array. <code>JApplication::route()</code> setzt Variablen in <code>$_GET</code> durch den Aufruf von <code>JRequest::set()</code>, dabei ist das overwrite Flag auf false gesetzt. Daher wird ein Variablenname, der von <code>JRouter::route()</code> zurückgebeben wird und bereits in <code>$_GET</code> vorhanden ist, nicht in <code>$_GET</code> übernommen. Die ermöglicht eigenentwickeltes Routing.
</div>

<div class="mw-translate-fuzzy">
=== Eigenentwickeltes Routing ===
Joomla erlaubt die Erstellung eigener Routing Mechanismen. Um diese zu erzeugen wird ein Plugin benötigt, dass die <code>JPlugin::onAfterInitialise()</code> Funktion überschreibt. Diese Funktion parst dann die URL und erzeugt die benötigten Variablen in <code>$_GET</code> bevor das Standard-Routing in Joomla abläuft.
</div>

''Siehe auch [[Creating a System Plugin to augment JRouter]] als Beispiel.''

[[Category:Search Engine Friendly URLs| ]]

Translations:Search Engine Friendly URLs/3/de

2025-01-24T06:28:49Z

Max123kl:

Ein gutes Beispiel für Routing ist die URL des ''Willkommen zu Joomla!'' Beitrags in den Beispieldaten.

Search Engine Friendly URLs/de

2025-01-24T06:28:29Z

Max123kl:

<noinclude><languages /></noinclude>
<onlyinclude>
'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine ''Route'' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als ''Routing'' bezeichnet. Der dazugehörige Code wird '''Router''' genannt.
</onlyinclude>
<div class="mw-translate-fuzzy">
Ein gutes Beispiel für Routing ist die URL des "Willkommen zu Joomla!" Beitrags in den Beispieldaten.
</div>

<div class="mw-translate-fuzzy">
* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt <code><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></code>
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: <code><nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code>
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird <code><nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code> erzeugt.
</div>

<div class="mw-translate-fuzzy">
Suchmaschinenfreundliche URLs können durch die Einstellung '''Suchmaschinenfreundliche URL''' in der ''Globalen Konfiguration'' aktiviert werden. Diese Einstellung ist seit Joomla! 1.6 vorhanden. Siehe auch [[Enabling Search Engine Friendly (SEF) URLs]] für weitere Informationen.
</div>

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.

The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.

For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs ==

<div class="mw-translate-fuzzy">
=== Was bedeuten die Zahlen in der URL? ===
Beim Vergleich der alten und der neuen URL sieht man Zahlen in der alten URL ,
</div>

<pre><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:willkommen-bei-joomla&catid=1:letzte-neuigkeiten&Itemid=50</nowiki></pre>

es gibt aber auch Zahlen in der neuen URL:

<pre><nowiki>http://www.beispiel.de/aktuell/1-letzte-neuigkeiten/1-willkommen-bei-joomla</nowiki></pre>

<div class="mw-translate-fuzzy">
Bei den Zahlen handelt es sich um Parameter, die von Joomla verwendet werden, um die interne URL zu ermitteln und die entsprechende Seite anzeigen zu können (im Beispiel handelt es sich bei der ersten Ziffer um die ID der Kategorie, bei der Zweiten um die ID des Beitrags).
</div>

<div class="mw-translate-fuzzy">
=== Es gibt kein <code>index.php</code> mehr in der URL. Kann ich die Datei nun löschen? ===
'''Nein!''' Die URL enthält zwar kein <code>index.php</code> mehr, aber intern wird der mod_rewrite zum Originalpfad umleiten, ohne es dem Anwender zu zeigen.
</div>

<div class="mw-translate-fuzzy">
=== Was ist der [[Alias]] ? Wie kann man ihn erzeugen? ===
Alias-Felder finden sich rechts neben den Titel-Feldern in Beiträgen, Kategorien und Menüeinträgen. Joomla! kann den Alias automatisch erzeugen. Als Basis wird der Titel verwendet. Alle Großbuchstaben werden in Kleinbuchstaben umgesetzt, Leerzeichen und Sonderzeichen sind in einer URL nicht erlaubt und werden daher durch Bindestriche ersetzt.
</div>

<div class="mw-translate-fuzzy">
=== Verwendung eines selbst definierten Alias-Werts ===
Falls der von Joomla erzeugte Wert für den Alias nicht verwendet werden soll, kann ein individueller Wert in das Alias-Feld eingetragen werden. Die Verwendung von guten Schlüsselwörtern in der URL soll die Suchmaschinenoptimierung verbessern. Die Schlüsselwörter können entweder in den Titel eingebaut werden, woraus Joomla den Alias generiert oder sie können direkt im selbst definierten Alias verwendet werden.
</div>

<div class="mw-translate-fuzzy">
=== Wie wird der Alias in der URL verwendet? ===
Im Menüeintrag verwendet Joomla! den Alias als Baustein. Sind die ersten beiden SEF Einstellungen in der Konfiguration aktiviert (Suchmaschinenfreundliche URL + URL Rewrite) und man erzeugt einen Menüeintrag mit dem Titel Produkte erhält man folgende URL: beispiel.de/produkte.
</div>

<div class="mw-translate-fuzzy">
Joomla verwendet zusätzlich den Primärschlüssel der Daten innerhalb der URL. So kann der Router zur richtigen Webseite navigieren. Im folgenden wird das oben verwendete Beispiel weitergeführt: der Menüeintrag Produkte hat den Menüeintragstyp Beiträge/Kategorieblog. Der Link des Beitragtitels und/oder der Weiterlesen-Link bestehen dann aus drei Teilen:
</div>

<div class="mw-translate-fuzzy">
* Die URL des Menüeintrags - beispiel.de/produkte;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für die Kategorie und den Kategorie-Alias - 32-Obst;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für den Beitrag und den Alias des Beitrags - 1-Apfel;
</div>

<div class="mw-translate-fuzzy">
Die vollständige URL ergibt sich dann zu: <code><nowiki>http://beispiel.de/produkte/32-obst/1-apfel</nowiki></code>
</div>

<div class="mw-translate-fuzzy">
=== Wie können die Zahlen in den SEF URLs vermieden werden? ===
Die Zahlen in der SEF URL werden vom Joomla Router gebraucht, um die Seitenzugriffe zu lenken. Mit einer stablilen Router Logik, können Drittanbieter einfach Plugins entwickeln. So werden die Möglichkeiten der Router vergrößert, z.B. durch bessere Auswahlmöglichkeiten. Dann werden sicherlich auch die Zahlen aus den URLs entfernt.
</div>

== Route Formate und Routing Mechanismus ==

''Dieser Teil beschreibt Joomlas Core (built-in) Routing Mechanismus. Externe Routing Erweiterungen können die Art der Erzeugung von Routes im System verändern.''

=== Route Formate ===

<div class="mw-translate-fuzzy">
Zur Beschreibung des Joomla Routing Mechanismus im Detail muss der Begriff '''Route''' erklärt werden. Angenommen das Joomla System wurde auf <code><nowiki>http://beispiel.de/sites/first/</nowiki></code> installiert. Der Installationspfad wird allgemein als '''base URL''' bezeichnet. Betrachtet man folgende Beispiel-URL <code><nowiki>http://beispiel.de/sites/first/products/32-fruit/1-apple</nowiki></code>, dann ist der erste Teil der URL die base URL, dieser Teil kann von Joomla und den Routern der Komponenten nicht verändert werden. Der zweite Teil <code>products/32-fruit/1-apple</code>, wird als '''Route''' bezeichnet, und besteht wiederum aus drei '''Segmenten'''.
</div>

<div class="mw-translate-fuzzy">
Das erste Segment einer Route wird bei einer typischen URL vom Alias des Menüeintrags gebildet. Die SEF URL wird sozusagen durch den Menüeintrag geleitet ('''routed through'''). Die anderen Segmente werden durch den Router der Komponente bestimmt, die für den Menüeintragstyp zur Verfügung verantwortlich ist. Zum Beispiel wird der Menüeintragstyp ''Kategorie - Blog'' von der Komponente [[Inhalt]] bereitgestellt. Daher ist dieser Router für die Erzeugung und das Parsen des restlichen Segments verantwortlich.
</div>

<div class="mw-translate-fuzzy">
Joomla kann auch für Erweiterungen Routen erzeugen, ohne einen Menüeintrag zur Verfügung zu haben. In diesem Fall generiert das System eine spezielle Route, die mit dem Wort <code>component</code> als erstes Segment beginnt. Diese Route wird unter Verwendung eines festen Formats erzeugt: der Name der Komponente (ohne das führende <code>com_</code>) wird zum zweiten Segement und alle anderen Parameter als weitere Segemente angehängt.
</div>

=== Grenzen ===

<div class="mw-translate-fuzzy">
Es ist wichtig zu verstehen, dass die Erstellung von Menüpunkten die ''einzige'' Möglichkeit für Joomla Benutzer ist, eine Route zu definieren, die zu einer spezifischen Komponente führt. Allerdings können Routen erstellt werden, ohne sie auf der Website in einem Menü anzuzeigen. Eine häufig verwendete Methode besteht in der Erzeugung eines Menüs, welches im Frontend nicht angezeigt wird. So ein Menü wird [[Menu|Schattenmenü]] (hidden menu) genannt .
</div>

<div class="mw-translate-fuzzy">
Der vorige Abschnitt zeigt, dass es nicht möglich ist, eine einzige Komponente für die Behandlung aller Routen verantwortlich zu machen. Es ist z.B. nicht möglich zu spezifizieren, dass die URL <code><nowiki>http://beispiel.de/deralias</nowiki></code> den Beitrag mit dem Alias <code>deralias</code> anzeigt, wobei <code>deralias</code> jeder beliebige Text sein kann. Falls solche URLs benötigt werden, können für die einzelnen Beiträge, jeweils eigene Menüpunkte im Schattenmenü erstellt werden. Dies ist jedoch nur bei einer kleinen Anzahl von Beiträgen sinnvoll. Ansonsten ist eine Routing Erweiterung notwendig.
</div>

Der Routing Mechanismus ist daher nicht so flexibel, wie ihn Benutzer manchmal brauchen. Andererseits reduziert er die Wahrscheinlichkeit für mehrdeutige Routen (gleiche Route, die auf verschiedene Seiten weist) und hat so einen großen Vorteil. Da das erste Segment immer von einem Menüeintrag gebildet wird, weiß das System sofort, welcher Komponenten-Router zum Parsen verwendet werden muss.

==Details der Implementierung ==
=== Handhabung der Routen ===

''Dieser Abschnitt beschreibt die Implementierung des Routings in Joomla. Komponenten Enwickler könnte auch dies interessieren: [[Supporting SEF URLs in your component]].''

<div class="mw-translate-fuzzy">
Joomla Routen werden von der [[JRouter|JRouter Klasse]] erzeugt und aufgelöst. Diese Klasse schaut im Wurzel-Verzeichnis (root) der aktiven Komponente nach (spezifiziert im <code>option</code> Parameter im query string) und fügt die <code>router.php</code> Datei in das Wurzel-Verzeichnis der Komponente ein. Es kann danach entweder die Funktion zur Erzeugung der SEF URL oder die zur Interpretation der SEF URL aufgerufen werden.
</div>

<div class="mw-translate-fuzzy">
Die JRouter Klasse wird vom Joomla CMS in <code>/includes/router.php</code> überschrieben (overriden). In dieser Datei werden die Build- und Parse-Funktionen überschrieben, um einen sauberen Aufbau der URLs ( build und parse) im Joomla zu erreichen.
</div>

<div class="mw-translate-fuzzy">
Die <code>router.php</code> Datei einer Komponente (z.B.: <code>/components/com_content/router.php</code>) sollte folgende Funktionen enthalten:
* ContentBuildRoute - baut die SEF URL auf
** Parameter
*** $query - dieser Array enthält die querystring Variablen
** Returns: ein Array aus Segmenten. Jedes Segment ist durch ein '/' getrennt. Da diese später kombiniert werden, um die eigentliche URL zu erzeugen, sollten diese Felder im Arry keine '/' Zeichen enthalten.
* ContentParseRoute - interpretiert eine SEF URL
** Parameters
*** $segments - dieses Array enthält die Segmente der angeforderten URL.
** Returns: ein Name => (value) Array der querystring Variablen. Auf das Array verweist der Link.
</div>

<div class="mw-translate-fuzzy">
=== Das SEF Plugin ===
Das Joomla ''System - SEF'' Plugin erbt <code>JPlugin</code> und implementiert die Funktion <code>onAfterRender()</code>. In dieser Funktion wird der Body der Antwort, die an den Browser geschickt wird ermittelt, durch die Verwendung von <code>JResponse::getBody()</code>. Der Body der Antwort wird dann auf Links durchsucht die <code>/index.php...</code> enthalten. Danach werden diese Teile der Links durch eine korrekter SEF URL ersetzt. Dies geschieht während des Aufrufs von <code>JRoute::_(''url'')</code>.
</div>

<div class="mw-translate-fuzzy">
JRoute baut SEF URLs durch Instanziierung von <code>JRouter</code>-Objekten auf. Dabei gibt es die Anforderung mit, das korrekte Links aus den weitergegebenen URLs aufgebaut werden.
</div>

<div class="mw-translate-fuzzy">
=== Handhabung von SEF URLs ===
Im Standard werden SEF URLs vom <code>JRouterSite</code>-Objekt ( <code>/includes/router.php</code>) gehandhabt. Sie werden von <code>JApplication::route()</code> in der Datei index.php aufgerufen. Dieser Aufruf erfolgt durch die <code>$app</code>-Variable. Diese ist eine Instantz von <code>JSite</code> (von <code>/includes/application.php</code>).
</div>

<div class="mw-translate-fuzzy">
<code>JApplication::route()</code> hat das Ergebnis (non-destructive) im <code>$_GET</code> Array. <code>JApplication::route()</code> setzt Variablen in <code>$_GET</code> durch den Aufruf von <code>JRequest::set()</code>, dabei ist das overwrite Flag auf false gesetzt. Daher wird ein Variablenname, der von <code>JRouter::route()</code> zurückgebeben wird und bereits in <code>$_GET</code> vorhanden ist, nicht in <code>$_GET</code> übernommen. Die ermöglicht eigenentwickeltes Routing.
</div>

<div class="mw-translate-fuzzy">
=== Eigenentwickeltes Routing ===
Joomla erlaubt die Erstellung eigener Routing Mechanismen. Um diese zu erzeugen wird ein Plugin benötigt, dass die <code>JPlugin::onAfterInitialise()</code> Funktion überschreibt. Diese Funktion parst dann die URL und erzeugt die benötigten Variablen in <code>$_GET</code> bevor das Standard-Routing in Joomla abläuft.
</div>

''Siehe auch [[Creating a System Plugin to augment JRouter]] als Beispiel.''

[[Category:Search Engine Friendly URLs| ]]

Translations:Search Engine Friendly URLs/2/de

2025-01-24T06:28:24Z

Max123kl:

Search Engine Friendly URLs/de

2025-01-24T06:27:47Z

Max123kl:

<noinclude><languages /></noinclude>
<onlyinclude>
'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

<div class="mw-translate-fuzzy">
Intern wird der lokale Teil der SEF URL (der Teil des Domain Namens) eine '''Route''' genannt. Das Erzeugen und Verarbeiten von SEF URLs wird daher als '''Routing''' bezeichnet. Der dazugehörige Code wird '''Router''' genannt.
</div>
</onlyinclude>
<div class="mw-translate-fuzzy">
Ein gutes Beispiel für Routing ist die URL des "Willkommen zu Joomla!" Beitrags in den Beispieldaten.
</div>

<div class="mw-translate-fuzzy">
* Ohne die Aktivierung von SEF URLs, wird folgende URL erzeugt <code><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></code>
* Mit Aktivierung von SEF URLs und deaktiviertem mod_rewrite, wird diese URL generiert: <code><nowiki>http://www.beispiel.de/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code>
*Sind sowohl SEF URLs als auch mod_rewrite aktiviert wird <code><nowiki>http://www.beispiel.de/the-news/1-latest-news/1-welcome-to-joomla</nowiki></code> erzeugt.
</div>

<div class="mw-translate-fuzzy">
Suchmaschinenfreundliche URLs können durch die Einstellung '''Suchmaschinenfreundliche URL''' in der ''Globalen Konfiguration'' aktiviert werden. Diese Einstellung ist seit Joomla! 1.6 vorhanden. Siehe auch [[Enabling Search Engine Friendly (SEF) URLs]] für weitere Informationen.
</div>

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.

The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.

For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs ==

<div class="mw-translate-fuzzy">
=== Was bedeuten die Zahlen in der URL? ===
Beim Vergleich der alten und der neuen URL sieht man Zahlen in der alten URL ,
</div>

<pre><nowiki>http://www.beispiel.de/index.php?option=com_content&view=article&id=1:willkommen-bei-joomla&catid=1:letzte-neuigkeiten&Itemid=50</nowiki></pre>

es gibt aber auch Zahlen in der neuen URL:

<pre><nowiki>http://www.beispiel.de/aktuell/1-letzte-neuigkeiten/1-willkommen-bei-joomla</nowiki></pre>

<div class="mw-translate-fuzzy">
Bei den Zahlen handelt es sich um Parameter, die von Joomla verwendet werden, um die interne URL zu ermitteln und die entsprechende Seite anzeigen zu können (im Beispiel handelt es sich bei der ersten Ziffer um die ID der Kategorie, bei der Zweiten um die ID des Beitrags).
</div>

<div class="mw-translate-fuzzy">
=== Es gibt kein <code>index.php</code> mehr in der URL. Kann ich die Datei nun löschen? ===
'''Nein!''' Die URL enthält zwar kein <code>index.php</code> mehr, aber intern wird der mod_rewrite zum Originalpfad umleiten, ohne es dem Anwender zu zeigen.
</div>

<div class="mw-translate-fuzzy">
=== Was ist der [[Alias]] ? Wie kann man ihn erzeugen? ===
Alias-Felder finden sich rechts neben den Titel-Feldern in Beiträgen, Kategorien und Menüeinträgen. Joomla! kann den Alias automatisch erzeugen. Als Basis wird der Titel verwendet. Alle Großbuchstaben werden in Kleinbuchstaben umgesetzt, Leerzeichen und Sonderzeichen sind in einer URL nicht erlaubt und werden daher durch Bindestriche ersetzt.
</div>

<div class="mw-translate-fuzzy">
=== Verwendung eines selbst definierten Alias-Werts ===
Falls der von Joomla erzeugte Wert für den Alias nicht verwendet werden soll, kann ein individueller Wert in das Alias-Feld eingetragen werden. Die Verwendung von guten Schlüsselwörtern in der URL soll die Suchmaschinenoptimierung verbessern. Die Schlüsselwörter können entweder in den Titel eingebaut werden, woraus Joomla den Alias generiert oder sie können direkt im selbst definierten Alias verwendet werden.
</div>

<div class="mw-translate-fuzzy">
=== Wie wird der Alias in der URL verwendet? ===
Im Menüeintrag verwendet Joomla! den Alias als Baustein. Sind die ersten beiden SEF Einstellungen in der Konfiguration aktiviert (Suchmaschinenfreundliche URL + URL Rewrite) und man erzeugt einen Menüeintrag mit dem Titel Produkte erhält man folgende URL: beispiel.de/produkte.
</div>

<div class="mw-translate-fuzzy">
Joomla verwendet zusätzlich den Primärschlüssel der Daten innerhalb der URL. So kann der Router zur richtigen Webseite navigieren. Im folgenden wird das oben verwendete Beispiel weitergeführt: der Menüeintrag Produkte hat den Menüeintragstyp Beiträge/Kategorieblog. Der Link des Beitragtitels und/oder der Weiterlesen-Link bestehen dann aus drei Teilen:
</div>

<div class="mw-translate-fuzzy">
* Die URL des Menüeintrags - beispiel.de/produkte;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für die Kategorie und den Kategorie-Alias - 32-Obst;
</div>

<div class="mw-translate-fuzzy">
* Plus, den Primärschlüssel für den Beitrag und den Alias des Beitrags - 1-Apfel;
</div>

<div class="mw-translate-fuzzy">
Die vollständige URL ergibt sich dann zu: <code><nowiki>http://beispiel.de/produkte/32-obst/1-apfel</nowiki></code>
</div>

<div class="mw-translate-fuzzy">
=== Wie können die Zahlen in den SEF URLs vermieden werden? ===
Die Zahlen in der SEF URL werden vom Joomla Router gebraucht, um die Seitenzugriffe zu lenken. Mit einer stablilen Router Logik, können Drittanbieter einfach Plugins entwickeln. So werden die Möglichkeiten der Router vergrößert, z.B. durch bessere Auswahlmöglichkeiten. Dann werden sicherlich auch die Zahlen aus den URLs entfernt.
</div>

== Route Formate und Routing Mechanismus ==

''Dieser Teil beschreibt Joomlas Core (built-in) Routing Mechanismus. Externe Routing Erweiterungen können die Art der Erzeugung von Routes im System verändern.''

=== Route Formate ===

<div class="mw-translate-fuzzy">
Zur Beschreibung des Joomla Routing Mechanismus im Detail muss der Begriff '''Route''' erklärt werden. Angenommen das Joomla System wurde auf <code><nowiki>http://beispiel.de/sites/first/</nowiki></code> installiert. Der Installationspfad wird allgemein als '''base URL''' bezeichnet. Betrachtet man folgende Beispiel-URL <code><nowiki>http://beispiel.de/sites/first/products/32-fruit/1-apple</nowiki></code>, dann ist der erste Teil der URL die base URL, dieser Teil kann von Joomla und den Routern der Komponenten nicht verändert werden. Der zweite Teil <code>products/32-fruit/1-apple</code>, wird als '''Route''' bezeichnet, und besteht wiederum aus drei '''Segmenten'''.
</div>

<div class="mw-translate-fuzzy">
Das erste Segment einer Route wird bei einer typischen URL vom Alias des Menüeintrags gebildet. Die SEF URL wird sozusagen durch den Menüeintrag geleitet ('''routed through'''). Die anderen Segmente werden durch den Router der Komponente bestimmt, die für den Menüeintragstyp zur Verfügung verantwortlich ist. Zum Beispiel wird der Menüeintragstyp ''Kategorie - Blog'' von der Komponente [[Inhalt]] bereitgestellt. Daher ist dieser Router für die Erzeugung und das Parsen des restlichen Segments verantwortlich.
</div>

<div class="mw-translate-fuzzy">
Joomla kann auch für Erweiterungen Routen erzeugen, ohne einen Menüeintrag zur Verfügung zu haben. In diesem Fall generiert das System eine spezielle Route, die mit dem Wort <code>component</code> als erstes Segment beginnt. Diese Route wird unter Verwendung eines festen Formats erzeugt: der Name der Komponente (ohne das führende <code>com_</code>) wird zum zweiten Segement und alle anderen Parameter als weitere Segemente angehängt.
</div>

=== Grenzen ===

<div class="mw-translate-fuzzy">
Es ist wichtig zu verstehen, dass die Erstellung von Menüpunkten die ''einzige'' Möglichkeit für Joomla Benutzer ist, eine Route zu definieren, die zu einer spezifischen Komponente führt. Allerdings können Routen erstellt werden, ohne sie auf der Website in einem Menü anzuzeigen. Eine häufig verwendete Methode besteht in der Erzeugung eines Menüs, welches im Frontend nicht angezeigt wird. So ein Menü wird [[Menu|Schattenmenü]] (hidden menu) genannt .
</div>

<div class="mw-translate-fuzzy">
Der vorige Abschnitt zeigt, dass es nicht möglich ist, eine einzige Komponente für die Behandlung aller Routen verantwortlich zu machen. Es ist z.B. nicht möglich zu spezifizieren, dass die URL <code><nowiki>http://beispiel.de/deralias</nowiki></code> den Beitrag mit dem Alias <code>deralias</code> anzeigt, wobei <code>deralias</code> jeder beliebige Text sein kann. Falls solche URLs benötigt werden, können für die einzelnen Beiträge, jeweils eigene Menüpunkte im Schattenmenü erstellt werden. Dies ist jedoch nur bei einer kleinen Anzahl von Beiträgen sinnvoll. Ansonsten ist eine Routing Erweiterung notwendig.
</div>

Der Routing Mechanismus ist daher nicht so flexibel, wie ihn Benutzer manchmal brauchen. Andererseits reduziert er die Wahrscheinlichkeit für mehrdeutige Routen (gleiche Route, die auf verschiedene Seiten weist) und hat so einen großen Vorteil. Da das erste Segment immer von einem Menüeintrag gebildet wird, weiß das System sofort, welcher Komponenten-Router zum Parsen verwendet werden muss.

==Details der Implementierung ==
=== Handhabung der Routen ===

''Dieser Abschnitt beschreibt die Implementierung des Routings in Joomla. Komponenten Enwickler könnte auch dies interessieren: [[Supporting SEF URLs in your component]].''

<div class="mw-translate-fuzzy">
Joomla Routen werden von der [[JRouter|JRouter Klasse]] erzeugt und aufgelöst. Diese Klasse schaut im Wurzel-Verzeichnis (root) der aktiven Komponente nach (spezifiziert im <code>option</code> Parameter im query string) und fügt die <code>router.php</code> Datei in das Wurzel-Verzeichnis der Komponente ein. Es kann danach entweder die Funktion zur Erzeugung der SEF URL oder die zur Interpretation der SEF URL aufgerufen werden.
</div>

<div class="mw-translate-fuzzy">
Die JRouter Klasse wird vom Joomla CMS in <code>/includes/router.php</code> überschrieben (overriden). In dieser Datei werden die Build- und Parse-Funktionen überschrieben, um einen sauberen Aufbau der URLs ( build und parse) im Joomla zu erreichen.
</div>

<div class="mw-translate-fuzzy">
Die <code>router.php</code> Datei einer Komponente (z.B.: <code>/components/com_content/router.php</code>) sollte folgende Funktionen enthalten:
* ContentBuildRoute - baut die SEF URL auf
** Parameter
*** $query - dieser Array enthält die querystring Variablen
** Returns: ein Array aus Segmenten. Jedes Segment ist durch ein '/' getrennt. Da diese später kombiniert werden, um die eigentliche URL zu erzeugen, sollten diese Felder im Arry keine '/' Zeichen enthalten.
* ContentParseRoute - interpretiert eine SEF URL
** Parameters
*** $segments - dieses Array enthält die Segmente der angeforderten URL.
** Returns: ein Name => (value) Array der querystring Variablen. Auf das Array verweist der Link.
</div>

<div class="mw-translate-fuzzy">
=== Das SEF Plugin ===
Das Joomla ''System - SEF'' Plugin erbt <code>JPlugin</code> und implementiert die Funktion <code>onAfterRender()</code>. In dieser Funktion wird der Body der Antwort, die an den Browser geschickt wird ermittelt, durch die Verwendung von <code>JResponse::getBody()</code>. Der Body der Antwort wird dann auf Links durchsucht die <code>/index.php...</code> enthalten. Danach werden diese Teile der Links durch eine korrekter SEF URL ersetzt. Dies geschieht während des Aufrufs von <code>JRoute::_(''url'')</code>.
</div>

<div class="mw-translate-fuzzy">
JRoute baut SEF URLs durch Instanziierung von <code>JRouter</code>-Objekten auf. Dabei gibt es die Anforderung mit, das korrekte Links aus den weitergegebenen URLs aufgebaut werden.
</div>

<div class="mw-translate-fuzzy">
=== Handhabung von SEF URLs ===
Im Standard werden SEF URLs vom <code>JRouterSite</code>-Objekt ( <code>/includes/router.php</code>) gehandhabt. Sie werden von <code>JApplication::route()</code> in der Datei index.php aufgerufen. Dieser Aufruf erfolgt durch die <code>$app</code>-Variable. Diese ist eine Instantz von <code>JSite</code> (von <code>/includes/application.php</code>).
</div>

<div class="mw-translate-fuzzy">
<code>JApplication::route()</code> hat das Ergebnis (non-destructive) im <code>$_GET</code> Array. <code>JApplication::route()</code> setzt Variablen in <code>$_GET</code> durch den Aufruf von <code>JRequest::set()</code>, dabei ist das overwrite Flag auf false gesetzt. Daher wird ein Variablenname, der von <code>JRouter::route()</code> zurückgebeben wird und bereits in <code>$_GET</code> vorhanden ist, nicht in <code>$_GET</code> übernommen. Die ermöglicht eigenentwickeltes Routing.
</div>

<div class="mw-translate-fuzzy">
=== Eigenentwickeltes Routing ===
Joomla erlaubt die Erstellung eigener Routing Mechanismen. Um diese zu erzeugen wird ein Plugin benötigt, dass die <code>JPlugin::onAfterInitialise()</code> Funktion überschreibt. Diese Funktion parst dann die URL und erzeugt die benötigten Variablen in <code>$_GET</code> bevor das Standard-Routing in Joomla abläuft.
</div>

''Siehe auch [[Creating a System Plugin to augment JRouter]] als Beispiel.''

[[Category:Search Engine Friendly URLs| ]]

Translations:Search Engine Friendly URLs/1/de

2025-01-24T06:27:43Z

Max123kl:

'''Suchmaschinenfreundliche (SEF-search engine friendly)''', '''vom Menschen lesbar''' oder [[wikipedia:Clean URL|clean URLs]] sind URLs, die sowohl von Menschen als auch von Suchmaschinen verstanden werden. Sie bilden den Pfad zu der aufgerufenen Seite ab. Seit Version 1.5 kann Joomla! URLs in verschiedenen Formaten erzeugen und parsen, darunter auch SEF URLs. Dabei ist Joomla nicht vom URL-Rewriting (Apache mod-rewrite Modul) des Webservers abhängig. SEF URLs können auch auf jedem Nicht-Apache-Server generiert werden. SEF URLs haben ein feststehendes Muster. Der Benutzer kann jedoch [[Alias|kurze, beschreibende Texte (Aliase)]] für jeden Teil der URL definieren.

Search Engine Friendly URLs

2025-01-24T06:25:22Z

Max123kl: Marked this version for translation

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

'''Search engine friendly (SEF)''', '''human-readable''' or [[wikipedia:Clean_URL|clean URLs]] are URLs that make sense to both humans and search engines because they explain the path to the particular page they point to. Since version 1.5, Joomla! is capable of creating and parsing URLs in any format, including SEF URLs. This does not depend on URL rewriting executed by the web server, so it works even if Joomla! runs on a server other than Apache with the mod_rewrite module. The SEF URLs follow a certain fixed pattern, but the user can define a [[Alias|short descriptive text (alias)]] for each segment of the URL.


Internally, the local part of a SEF URL (the part after the domain name) is called a ''route''. Creating and processing SEF URLs is therefore referred to as ''routing'', and the relevant code is called a ''router''.
</translate>
</onlyinclude>
<translate>

A good example of routing is the URL to ''Welcome to Joomla!'' article in the sample data.


* Without SEF URLs turned on, the URL is ''<nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* With SEF URLs on and mod_rewrite off, it's ''<nowiki>http://www.example.com/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
* With both SEF URLs and mod_rewrite on, it's ''<nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''

== Options == 
Search engine friendly URLs are controlled mainly in the ''Global Configuration'' via the block ''Search Engine Friendly URLs''. You have the following options:


* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.


* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.


The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:


* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.


* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.


* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.


* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.


For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs == 

=== What Do the Numbers in the URL Mean? === 
By comparing the old and the new URL we can see numbers in the old URL:


<pre><nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></pre>


but also in the new URL:


<pre><nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki></pre>


These numbers are the parameters that are needed by Joomla! to get the internal URL and show the desired page. (In this case, the first numeral one is the ID of the category, the second numeral one is the ID of the article.)

=== There is No ''index.php'' in the URL. Can I Delete that File Now? === 
No! The URL doesn't contain the ''index.php'' anymore, but internally the ''mod_rewrite'' will only redirect to the original path without showing it to you.

=== What is the ''[[Alias]]'' Value? How Does It Get Created? === 
Alias is listed beneath the Title field in Articles, Categories, Sections and Menu Items. Joomla! can automatically create the alias for you. An automatic alias begins with the title. All upper case letters are changed to lower case. Spaces and special characters not allowed in a URL; they are changed to dashes.

=== I Want to Specify My Own Value for Alias. === 
If you do not like the alias provided by Joomla!, enter a value of your choosing into that field. Many believe using good keywords in your URL helps search engine optimization. You can do so by including those keywords in your title, and allowing Joomla! to create the alias, or by creating the alias yourself.

=== How is Alias Used in a URL? === 
For a menu item, Joomla! uses the alias as the URL slug. Assume that you use the first two SEF URL options and you create a menu item called Products. Your URL would be ''example.com/products''.


Joomla! also uses the primary key values of data within the URL to help the router navigate to the correct page. Continuing with the previous example, if your ''products'' menu item was for an Article/Category Blog, the link for the Article Title and/or Read More link would have three parts:


* The menu item URL - ''example.com/products''


* Plus, the primary key for the Category and the Category alias - ''32-fruit''


* Plus, the primary key for the Article and the Article alias - ''1-apple''


The complete URL is: ''<nowiki>http://example.com/products/32-fruit/1-apple</nowiki>''

=== How Can I Get Rid of the Numbers in the SEF URLs? === 
The numbers in the SEF URL are needed by Joomla!'s router to know how to direct site traffic. Once the router logic stabilizes, simple third party system plugins can be developed to augment the router capabilities by allowing more choice. At that time, numbers will likely be removed from the URL.

== Route Formats and the Routing Mechanism == 


''This section describes Joomla!'s core (built-in) routing mechanism. Routing extensions may change the way routes are created on your system.''

=== Route Formats === 


To describe the Joomla! routing mechanism in more detail, we need to pin down what we refer to as a ''route''. Suppose that Joomla! has been installed in ''<nowiki>http://example.com/sites/first/</nowiki>''. The installation path is generally referred to as the ''base URL''. A possible example URL is ''<nowiki>http://example.com/sites/first/products/32-fruit/1-apple</nowiki>''. The first part of this URL is the aforementioned base URL, and neither Joomla! nor any component router can create URLs with a different first part. The second part, ''products/32-fruit/1-apple'', is a ''route'', consisting of three ''segment''s.


The first segment of a route is, for regular URLs, the alias of a menu item. The SEF URL is said to be ''routed through'' that menu item. The other segments are determined entirely by the router of the component that provides the type of the menu item. The ''Category - Blog'' menu item type, for example, is provided by the [[Content]] component, and therefore that component's router is responsible for building and parsing the remaining segments.


It is also possible (for extensions) to ask the system to create a route without supplying a menu item to route through. In that case, the system will usually decide to create a special route that has the word ''component'' as the first segment. These routes are created using a fixed format: the name of the component (without the leading ''com_'') is selected as the second segment and any parameters as the other segments.

=== Limitations === 


It is important to note that creating a menu item is the ''only'' way for a Joomla! user to define a route that leads to a specific component. It is, however, possible to create a route without showing it on the site (in a menu). An usual method is to create a menu item in a menu that isn't displayed anywhere. Such a menu is usually called a [[Menu|hidden menu]].


The previous paragraph implies that it is not possible to make one component responsible for handling all routes. For example, it is not possible to specify that the URL ''<nowiki>http://example.com/thealias</nowiki>'' should display the Content item with the alias ''thealias'', where ''thealias'' could be any word. If this needs to be done for a small number of articles, menu items can be created manually for these. Otherwise a routing extension is necessary.


This routing mechanism is therefore not as flexible as users sometimes require. On the other hand, it has one large advantage: it reduces the chance of ambiguous routes (routes that could lead to two different pages). Since the first segment of a route is always a menu item alias, the system immediately knows which component's router must be used to parse it.

== Implementation Details == 
=== Handling Routes ===


''This section describes the routing implementation. If you are a component developer, see [[Supporting SEF URLs in your component]].''


Joomla routes are created and resolved by [[JRouter|the JRouter class]]. This class looks in the component root of the currently active component (specified in the ''option'' parameter in the query string) and includes the ''router.php'' file in that component's root directory. It then calls one of two functions: one for creating the SEF URL and one for interpreting the SEF URL.


The JRouter class is overridden by the Joomla CMS in ''/includes/router.php''. In this file the build and parse functions are overridden to properly build and parse the URLs for the Joomla CMS.


The ''router.php'' file in each component (for example, ''/components/com_content/router.php'') should contain the following two functions:
* ContentBuildRoute - this builds the SEF URL
** Parameters
*** $query - this is a named array containing the ''querystring'' variables
** Returns: an array of segments where each segment is separated by a '/' when later combined to create the actual URL. (The items in the array should not contain '/' characters.)
* ContentParseRoute - this interprets an SEF URL
** Parameters
*** $segments - this is an array that contains the segments of the URL requested.
** Returns: a name => value array of the ''querystring'' variables that the link maps to.

=== The SEF Plugin === 
The Joomla ''System - SEF'' plugin inherits ''JPlugin'' and implements the ''onAfterRender()'' function. In this function the body of the response that will be sent to the browser is retrieved using ''JResponse::getBody()''. The body of the response is then searched for links containing ''/index.php...'' and replaces them with a correct SEF URL by calling ''JRoute::_(''url'')''.


JRoute builds SEF URLs by instantiating a ''JRouter'' object and requesting that it build the correct link from the passed-in URL.

=== Handling SEF URLs === 
By default the SEF URLs are handled by the ''JRouterSite'' object (from ''/includes/router.php'') and is invoked by a call to ''JApplication::route()'' in ''index.php''. This call is made on the ''$app'' variable which is actually an instance of ''JSite'' (from ''/includes/application.php'').


''JApplication::route()'' has a non-destructive result on the ''$_GET'' array. That is, ''JApplication::route()'' sets variables in ''$_GET'' by calling ''JRequest::set()'' with the overwrite flag set to ''false''. Thus if a variable name is returned from ''JRouter::route()'' that is already in ''$_GET'', it will not put that value into ''$_GET''. This allows for custom routing.

=== Custom Routing === 
Joomla allows you to create your own routing mechanism. In order to create this mechanism you must have a plugin that overrides the ''JPlugin::onAfterInitialise()'' function. This function then parses the URL and creates the needed variables in ''$_GET'' before the standard Joomla routing is done.


''See [[Creating a System Plugin to augment JRouter]] for an example.''


[[Category:Search Engine Friendly URLs| ]]
</translate>

Search Engine Friendly URLs

2025-01-24T06:23:41Z

Max123kl: translation made easier

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

'''Search engine friendly (SEF)''', '''human-readable''' or [[wikipedia:Clean_URL|clean URLs]] are URLs that make sense to both humans and search engines because they explain the path to the particular page they point to. Since version 1.5, Joomla! is capable of creating and parsing URLs in any format, including SEF URLs. This does not depend on URL rewriting executed by the web server, so it works even if Joomla! runs on a server other than Apache with the mod_rewrite module. The SEF URLs follow a certain fixed pattern, but the user can define a [[Alias|short descriptive text (alias)]] for each segment of the URL.


Internally, the local part of a SEF URL (the part after the domain name) is called a ''route''. Creating and processing SEF URLs is therefore referred to as ''routing'', and the relevant code is called a ''router''.
</translate>
</onlyinclude>
<translate>

A good example of routing is the URL to ''Welcome to Joomla!'' article in the sample data.


* Without SEF URLs turned on, the URL is ''<nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* With SEF URLs on and mod_rewrite off, it's ''<nowiki>http://www.example.com/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
* With both SEF URLs and mod_rewrite on, it's ''<nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''

== Options == 
Search engine friendly URLs are controlled mainly in the ''Global Configuration'' via the block ''Search Engine Friendly URLs''. You have the following options:

* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.

* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.


The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:

* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.

* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.

* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.

* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.


For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs == 

=== What Do the Numbers in the URL Mean? === 
By comparing the old and the new URL we can see numbers in the old URL:


<pre><nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></pre>


but also in the new URL:


<pre><nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki></pre>


These numbers are the parameters that are needed by Joomla! to get the internal URL and show the desired page. (In this case, the first numeral one is the ID of the category, the second numeral one is the ID of the article.)

=== There is No ''index.php'' in the URL. Can I Delete that File Now? === 
No! The URL doesn't contain the ''index.php'' anymore, but internally the ''mod_rewrite'' will only redirect to the original path without showing it to you.

=== What is the ''[[Alias]]'' Value? How Does It Get Created? === 
Alias is listed beneath the Title field in Articles, Categories, Sections and Menu Items. Joomla! can automatically create the alias for you. An automatic alias begins with the title. All upper case letters are changed to lower case. Spaces and special characters not allowed in a URL; they are changed to dashes.

=== I Want to Specify My Own Value for Alias. === 
If you do not like the alias provided by Joomla!, enter a value of your choosing into that field. Many believe using good keywords in your URL helps search engine optimization. You can do so by including those keywords in your title, and allowing Joomla! to create the alias, or by creating the alias yourself.

=== How is Alias Used in a URL? === 
For a menu item, Joomla! uses the alias as the URL slug. Assume that you use the first two SEF URL options and you create a menu item called Products. Your URL would be ''example.com/products''.


Joomla! also uses the primary key values of data within the URL to help the router navigate to the correct page. Continuing with the previous example, if your ''products'' menu item was for an Article/Category Blog, the link for the Article Title and/or Read More link would have three parts:


* The menu item URL - ''example.com/products''


* Plus, the primary key for the Category and the Category alias - ''32-fruit''


* Plus, the primary key for the Article and the Article alias - ''1-apple''


The complete URL is: ''<nowiki>http://example.com/products/32-fruit/1-apple</nowiki>''

=== How Can I Get Rid of the Numbers in the SEF URLs? === 
The numbers in the SEF URL are needed by Joomla!'s router to know how to direct site traffic. Once the router logic stabilizes, simple third party system plugins can be developed to augment the router capabilities by allowing more choice. At that time, numbers will likely be removed from the URL.

== Route Formats and the Routing Mechanism == 


''This section describes Joomla!'s core (built-in) routing mechanism. Routing extensions may change the way routes are created on your system.''

=== Route Formats === 


To describe the Joomla! routing mechanism in more detail, we need to pin down what we refer to as a ''route''. Suppose that Joomla! has been installed in ''<nowiki>http://example.com/sites/first/</nowiki>''. The installation path is generally referred to as the ''base URL''. A possible example URL is ''<nowiki>http://example.com/sites/first/products/32-fruit/1-apple</nowiki>''. The first part of this URL is the aforementioned base URL, and neither Joomla! nor any component router can create URLs with a different first part. The second part, ''products/32-fruit/1-apple'', is a ''route'', consisting of three ''segment''s.


The first segment of a route is, for regular URLs, the alias of a menu item. The SEF URL is said to be ''routed through'' that menu item. The other segments are determined entirely by the router of the component that provides the type of the menu item. The ''Category - Blog'' menu item type, for example, is provided by the [[Content]] component, and therefore that component's router is responsible for building and parsing the remaining segments.


It is also possible (for extensions) to ask the system to create a route without supplying a menu item to route through. In that case, the system will usually decide to create a special route that has the word ''component'' as the first segment. These routes are created using a fixed format: the name of the component (without the leading ''com_'') is selected as the second segment and any parameters as the other segments.

=== Limitations === 


It is important to note that creating a menu item is the ''only'' way for a Joomla! user to define a route that leads to a specific component. It is, however, possible to create a route without showing it on the site (in a menu). An usual method is to create a menu item in a menu that isn't displayed anywhere. Such a menu is usually called a [[Menu|hidden menu]].


The previous paragraph implies that it is not possible to make one component responsible for handling all routes. For example, it is not possible to specify that the URL ''<nowiki>http://example.com/thealias</nowiki>'' should display the Content item with the alias ''thealias'', where ''thealias'' could be any word. If this needs to be done for a small number of articles, menu items can be created manually for these. Otherwise a routing extension is necessary.


This routing mechanism is therefore not as flexible as users sometimes require. On the other hand, it has one large advantage: it reduces the chance of ambiguous routes (routes that could lead to two different pages). Since the first segment of a route is always a menu item alias, the system immediately knows which component's router must be used to parse it.

== Implementation Details == 
=== Handling Routes ===


''This section describes the routing implementation. If you are a component developer, see [[Supporting SEF URLs in your component]].''


Joomla routes are created and resolved by [[JRouter|the JRouter class]]. This class looks in the component root of the currently active component (specified in the ''option'' parameter in the query string) and includes the ''router.php'' file in that component's root directory. It then calls one of two functions: one for creating the SEF URL and one for interpreting the SEF URL.


The JRouter class is overridden by the Joomla CMS in ''/includes/router.php''. In this file the build and parse functions are overridden to properly build and parse the URLs for the Joomla CMS.


The ''router.php'' file in each component (for example, ''/components/com_content/router.php'') should contain the following two functions:
* ContentBuildRoute - this builds the SEF URL
** Parameters
*** $query - this is a named array containing the ''querystring'' variables
** Returns: an array of segments where each segment is separated by a '/' when later combined to create the actual URL. (The items in the array should not contain '/' characters.)
* ContentParseRoute - this interprets an SEF URL
** Parameters
*** $segments - this is an array that contains the segments of the URL requested.
** Returns: a name => value array of the ''querystring'' variables that the link maps to.

=== The SEF Plugin === 
The Joomla ''System - SEF'' plugin inherits ''JPlugin'' and implements the ''onAfterRender()'' function. In this function the body of the response that will be sent to the browser is retrieved using ''JResponse::getBody()''. The body of the response is then searched for links containing ''/index.php...'' and replaces them with a correct SEF URL by calling ''JRoute::_(''url'')''.


JRoute builds SEF URLs by instantiating a ''JRouter'' object and requesting that it build the correct link from the passed-in URL.

=== Handling SEF URLs === 
By default the SEF URLs are handled by the ''JRouterSite'' object (from ''/includes/router.php'') and is invoked by a call to ''JApplication::route()'' in ''index.php''. This call is made on the ''$app'' variable which is actually an instance of ''JSite'' (from ''/includes/application.php'').


''JApplication::route()'' has a non-destructive result on the ''$_GET'' array. That is, ''JApplication::route()'' sets variables in ''$_GET'' by calling ''JRequest::set()'' with the overwrite flag set to ''false''. Thus if a variable name is returned from ''JRouter::route()'' that is already in ''$_GET'', it will not put that value into ''$_GET''. This allows for custom routing.

=== Custom Routing === 
Joomla allows you to create your own routing mechanism. In order to create this mechanism you must have a plugin that overrides the ''JPlugin::onAfterInitialise()'' function. This function then parses the URL and creates the needed variables in ''$_GET'' before the standard Joomla routing is done.


''See [[Creating a System Plugin to augment JRouter]] for an example.''


[[Category:Search Engine Friendly URLs| ]]
</translate>

Search Engine Friendly URLs

2025-01-24T05:49:40Z

Max123kl: Marked this version for translation

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

'''Search engine friendly (SEF)''', '''human-readable''' or [[wikipedia:Clean_URL|clean URLs]] are URLs that make sense to both humans and search engines because they explain the path to the particular page they point to. Since version 1.5, Joomla! is capable of creating and parsing URLs in any format, including SEF URLs. This does not depend on URL rewriting executed by the web server, so it works even if Joomla! runs on a server other than Apache with the mod_rewrite module. The SEF URLs follow a certain fixed pattern, but the user can define a [[Alias|short descriptive text (alias)]] for each segment of the URL.


Internally, the local part of a SEF URL (the part after the domain name) is called a ''route''. Creating and processing SEF URLs is therefore referred to as ''routing'', and the relevant code is called a ''router''.
</translate>
</onlyinclude>
<translate>

A good example of routing is the URL to ''Welcome to Joomla!'' article in the sample data.


* Without SEF URLs turned on, the URL is ''<nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki>''
* With SEF URLs on and mod_rewrite off, it's ''<nowiki>http://www.example.com/index.php/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''
* With both SEF URLs and mod_rewrite on, it's ''<nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki>''

== Options == 
Search engine friendly URLs are controlled mainly in the ''Global Configuration'' via the block ''Search Engine Friendly URLs''. You have the following options:
* ''Search Engine Friendly URLs'': This is the main switch to enable SEF URLs and creates the URLs like in the second example above.
* ''Use URL Rewriting'': When enabled, the server tries to use mod_rewrite and shorten the URL further by removing the ''/index.php/'' from the URL.
* ''Add Suffix to URL'': When enabled, the URLs get a suffix similar to a file extension (depending on the output). By default this is ''.html'', but for a JSON output this can also be ''.json''.
* ''Unicode Aliases'': Joomla by default tries to convert any alias to a plain ASCII representation for the URL, converting for example ''ö'' to ''oe''. Enabling this option keeps the original unicode string. This might be preferable for your local users, but create a barrier for international users who don't know how to generate those characters.


The system behind these SEF URLs by default is very lenient and allows a lot of different URLs to reach the same page. While this is user-friendly, Google doesn't really like that. So starting with Joomla 5.1 there are additional switches in the ''System - SEF'' plugin which enforce a stricter behavior:
* ''Forcibly remove index.php in URL with redirects'': If the site is called with an index.php in the URL, Joomla will now redirect to the page without an index.php with a 301 redirect. From Joomla 6.0 onwards this option will be removed again and the behavior enabled as standard.
* ''Trailing slash for URLs'': This option allows to set and enforce if a URL should have a trailing slash or not. This is also enforce with a 301 redirect if the current URL does not confirm the selected setting. By default the site accepts both. This option is only available when ''Add Suffix to URL'' is disabled. Starting with Joomla 6.0 the default behavior will be to enforce without a trailing slash.
* ''Enforce a suffix by redirect'': When this setting and ''Add Suffix to URL'' is enabled, URLs without a suffix are redirected to their "correct" URL with a suffix with a 301 redirect. Starting with Joomla 6.0 this option will be the standard behavior and the option will then be removed again.
* ''Disallow non-SEF URLs'': Enabling this option means that Joomla will try to build the correct URL from what it understood of the current URL and if the current URL and the one Joomla built itself are not identical, Joomla will redirect to the one it built itself. This means that URLs like ''/component/content/article/42'' or ''index.php?option=com_content&view=article&id=42'' would be correctly redirected to ''/welcome/to/joomla''. This option can create issues in some site setups, so test your site thoroughly after enabling this.


For more information please see [[Enabling Search Engine Friendly (SEF) URLs]].

== FAQs == 

=== What Do the Numbers in the URL Mean? === 
By comparing the old and the new URL we can see numbers in the old URL:


<pre><nowiki>http://www.example.com/index.php?option=com_content&view=article&id=1:welcome-to-joomla&catid=1:latest-news&Itemid=50</nowiki></pre>


but also in the new URL:


<pre><nowiki>http://www.example.com/the-news/1-latest-news/1-welcome-to-joomla</nowiki></pre>


These numbers are the parameters that are needed by Joomla! to get the internal URL and show the desired page. (In this case, the first numeral one is the ID of the category, the second numeral one is the ID of the article.)

=== There is No ''index.php'' in the URL. Can I Delete that File Now? === 
No! The URL doesn't contain the ''index.php'' anymore, but internally the ''mod_rewrite'' will only redirect to the original path without showing it to you.

=== What is the ''[[Alias]]'' Value? How Does It Get Created? === 
Alias is listed beneath the Title field in Articles, Categories, Sections and Menu Items. Joomla! can automatically create the alias for you. An automatic alias begins with the title. All upper case letters are changed to lower case. Spaces and special characters not allowed in a URL; they are changed to dashes.

=== I Want to Specify My Own Value for Alias. === 
If you do not like the alias provided by Joomla!, enter a value of your choosing into that field. Many believe using good keywords in your URL helps search engine optimization. You can do so by including those keywords in your title, and allowing Joomla! to create the alias, or by creating the alias yourself.

=== How is Alias Used in a URL? === 
For a menu item, Joomla! uses the alias as the URL slug. Assume that you use the first two SEF URL options and you create a menu item called Products. Your URL would be ''example.com/products''.


Joomla! also uses the primary key values of data within the URL to help the router navigate to the correct page. Continuing with the previous example, if your ''products'' menu item was for an Article/Category Blog, the link for the Article Title and/or Read More link would have three parts:


* The menu item URL - ''example.com/products''


* Plus, the primary key for the Category and the Category alias - ''32-fruit''


* Plus, the primary key for the Article and the Article alias - ''1-apple''


The complete URL is: ''<nowiki>http://example.com/products/32-fruit/1-apple</nowiki>''

=== How Can I Get Rid of the Numbers in the SEF URLs? === 
The numbers in the SEF URL are needed by Joomla!'s router to know how to direct site traffic. Once the router logic stabilizes, simple third party system plugins can be developed to augment the router capabilities by allowing more choice. At that time, numbers will likely be removed from the URL.

== Route Formats and the Routing Mechanism == 


''This section describes Joomla!'s core (built-in) routing mechanism. Routing extensions may change the way routes are created on your system.''

=== Route Formats === 


To describe the Joomla! routing mechanism in more detail, we need to pin down what we refer to as a ''route''. Suppose that Joomla! has been installed in ''<nowiki>http://example.com/sites/first/</nowiki>''. The installation path is generally referred to as the ''base URL''. A possible example URL is ''<nowiki>http://example.com/sites/first/products/32-fruit/1-apple</nowiki>''. The first part of this URL is the aforementioned base URL, and neither Joomla! nor any component router can create URLs with a different first part. The second part, ''products/32-fruit/1-apple'', is a ''route'', consisting of three ''segment''s.


The first segment of a route is, for regular URLs, the alias of a menu item. The SEF URL is said to be ''routed through'' that menu item. The other segments are determined entirely by the router of the component that provides the type of the menu item. The ''Category - Blog'' menu item type, for example, is provided by the [[Content]] component, and therefore that component's router is responsible for building and parsing the remaining segments.


It is also possible (for extensions) to ask the system to create a route without supplying a menu item to route through. In that case, the system will usually decide to create a special route that has the word ''component'' as the first segment. These routes are created using a fixed format: the name of the component (without the leading ''com_'') is selected as the second segment and any parameters as the other segments.

=== Limitations === 


It is important to note that creating a menu item is the ''only'' way for a Joomla! user to define a route that leads to a specific component. It is, however, possible to create a route without showing it on the site (in a menu). An usual method is to create a menu item in a menu that isn't displayed anywhere. Such a menu is usually called a [[Menu|hidden menu]].


The previous paragraph implies that it is not possible to make one component responsible for handling all routes. For example, it is not possible to specify that the URL ''<nowiki>http://example.com/thealias</nowiki>'' should display the Content item with the alias ''thealias'', where ''thealias'' could be any word. If this needs to be done for a small number of articles, menu items can be created manually for these. Otherwise a routing extension is necessary.


This routing mechanism is therefore not as flexible as users sometimes require. On the other hand, it has one large advantage: it reduces the chance of ambiguous routes (routes that could lead to two different pages). Since the first segment of a route is always a menu item alias, the system immediately knows which component's router must be used to parse it.

== Implementation Details == 
=== Handling Routes ===


''This section describes the routing implementation. If you are a component developer, see [[Supporting SEF URLs in your component]].''


Joomla routes are created and resolved by [[JRouter|the JRouter class]]. This class looks in the component root of the currently active component (specified in the ''option'' parameter in the query string) and includes the ''router.php'' file in that component's root directory. It then calls one of two functions: one for creating the SEF URL and one for interpreting the SEF URL.


The JRouter class is overridden by the Joomla CMS in ''/includes/router.php''. In this file the build and parse functions are overridden to properly build and parse the URLs for the Joomla CMS.


The ''router.php'' file in each component (for example, ''/components/com_content/router.php'') should contain the following two functions:
* ContentBuildRoute - this builds the SEF URL
** Parameters
*** $query - this is a named array containing the ''querystring'' variables
** Returns: an array of segments where each segment is separated by a '/' when later combined to create the actual URL. (The items in the array should not contain '/' characters.)
* ContentParseRoute - this interprets an SEF URL
** Parameters
*** $segments - this is an array that contains the segments of the URL requested.
** Returns: a name => value array of the ''querystring'' variables that the link maps to.

=== The SEF Plugin === 
The Joomla ''System - SEF'' plugin inherits ''JPlugin'' and implements the ''onAfterRender()'' function. In this function the body of the response that will be sent to the browser is retrieved using ''JResponse::getBody()''. The body of the response is then searched for links containing ''/index.php...'' and replaces them with a correct SEF URL by calling ''JRoute::_(''url'')''.


JRoute builds SEF URLs by instantiating a ''JRouter'' object and requesting that it build the correct link from the passed-in URL.

=== Handling SEF URLs === 
By default the SEF URLs are handled by the ''JRouterSite'' object (from ''/includes/router.php'') and is invoked by a call to ''JApplication::route()'' in ''index.php''. This call is made on the ''$app'' variable which is actually an instance of ''JSite'' (from ''/includes/application.php'').


''JApplication::route()'' has a non-destructive result on the ''$_GET'' array. That is, ''JApplication::route()'' sets variables in ''$_GET'' by calling ''JRequest::set()'' with the overwrite flag set to ''false''. Thus if a variable name is returned from ''JRouter::route()'' that is already in ''$_GET'', it will not put that value into ''$_GET''. This allows for custom routing.

=== Custom Routing === 
Joomla allows you to create your own routing mechanism. In order to create this mechanism you must have a plugin that overrides the ''JPlugin::onAfterInitialise()'' function. This function then parses the URL and creates the needed variables in ''$_GET'' before the standard Joomla routing is done.


''See [[Creating a System Plugin to augment JRouter]] for an example.''


[[Category:Search Engine Friendly URLs| ]]
</translate>

User:Max123kl/test

2025-01-23T18:56:12Z

Max123kl: text added

<div class="row">
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;">'''Joomla!'''<span style="font-size:.4em; vertical-align:super;"><sup>®<sup></span></span>{{-}}
[[File:Joomla_logo.png‎|80px|center]]{{-}}
</div>
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;font-weight:bold;"><translate>
Documentation</translate></span>{{-}}
<div class="large-11 large-centered column small-12">
<translate>

An online [[S:MyLanguage/JDOC:About|collaborative community manual]] for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles written, maintained, and translated by our Joomla! community members.
</translate>
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center" style="margin:0;">
<div style="min-width:60px; display:inline-block; margin:0 auto;"><div class="fa fa-language fa-3x"></div></div>
<div id="lang-control" style="max-width:80%; margin:0 auto;">
<noinclude><languages /></noinclude>
</div>
</div>

</br>
{{amboxNew|image=notice|style=notice|title={{{title|<translate>General Information</translate>}}}|text=<translate>'''Dear friends and users of Joomla!''' </translate></br><translate>In year 2025 Joomla! is celebrating its 20th birthday. While our CMS has grown up and is younger and more active than ever, the documentation based on MediaWiki is getting on in years and will be going into retirement before long. We are currently developing new documentation based on Joomla! to demonstrate the power of our CMS.</translate></br><translate>Until the official release of the new documentation (scheduled for October 2025), some pages may not be up to date with the current release of Joomla. In the meantime, the unofficial user guide [https://jdocmanual.org '''Jdocmanual'''] by Cliff Ford and the official [https://manual.joomla.org/ '''Joomla! Programmers Documentation'''] may help you as an alternative.</translate></br>
<translate>'''Your help with the update is very welcome and appreciated! Please report your suggestions or improvements on [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].'''</translate>}}


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon blue-bkgd"><div class="fa fa-university fa-3x"></div>
<span class="icon-text">
<translate>

'''Learn'''
</translate>
</span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#5290C8;"></div> <translate>

[[S:MyLanguage/Portal:Learn More|More About Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Joomla:The_Joomla_Websites|The Joomla! Websites]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Filing_bugs_and_issues|Report a Bug or Issue]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Beginners|Beginners]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Portal:Administrators|Administrators]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-code fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Developers|Developers]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Developers]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon red-bkgd"><div class="fa fa-exclamation fa-3x"></div>
<span class="icon-text">
<translate>

'''Links'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-wrench fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-arrow-circle-o-up fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/Portal:Upgrading Versions|Upgrading and Migrations]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-question-circle fa-lg icon" style="color:#7DB847;"></div> <translate>
[[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-life-saver fa-lg icon" style="color:#E6462B;"></div> <translate>
[[S:MyLanguage/Help screens|Admin Help Screens]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-unlock fa-lg icon" style="color:#F5A443;"></div> <translate>
[[S:MyLanguage/How do you recover or reset your admin password?|Password Recovery]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-book fa-lg icon" style="color:#555;"></div> <translate>
[[S:MyLanguage/Glossary|Our Glossary]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-magic fa-lg icon" style="color:#333;"></div> <translate>
[[S:MyLanguage/:Category:Tips and tricks|Tips and Tricks]] or [[S:MyLanguage/:Category:FAQ|FAQs]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-code-fork fa-3x"></div>
<span class="icon-text">
<translate>

'''Versions'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="main-page-text">'''Joomla! {{CurrentSTSVer5|maintenance}} <translate>

is the latest stable version of Joomla 5, we recommend for new installations.</translate>'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer4|maintenance}} <translate>

is the last stable version of Joomla 4. Support will end on the 17th of October 2025</translate>.'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer|maintenance}} <translate>
was the last stable version of Joomla 3. Support ended on the 17th of August 2023</translate>.'''</span>{{-}}
<translate>

Info on all [[S:MyLanguage/What_version_of_Joomla!_should_you_use?|Joomla! CMS Versions]]</translate>{{-}}
<translate>

[https://manual.joomla.org/docs/next/get-started/technical-requirements Technical requirements] for Joomla! </translate>{{-}}
<translate>

[[S:MyLanguage/J4.x:What%27s_new_in_Joomla!_4|Find out what's new in Joomla! CMS {{CurrentSTSVer4|minor}}]]{{-}}
[[S:MyLanguage/J5.x:What%27s_new_in_Joomla!_5|Find out what's new in Joomla! CMS {{CurrentSTSVer5|minor}}]]</translate>{{-}}
<translate>
Take an extended test drive and build your own [[S:MyLanguage/How_to_build_your_free_Joomla_Website|free Joomla! website]]</translate>{{-}}
<translate>

Always use a supported version, read our [[S:MyLanguage/Release and support cycle|release and support cycle]] page.</translate>{{-}}
<div class="no-external-icon"><span style="line-height:2.2em;font-size:1.3em;"><translate>

[https://downloads.joomla.org Download Joomla!]</translate>{{-}}<div class="fa fa-download fa-2x" style="color:#142849;"></div></span></div>{{-}}
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon green-bkgd"><div class="fa fa-tasks fa-3x"></div>
<span class="icon-text">
<translate>

'''Tasks'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-cogs fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Global_Configuration|Configuring Your Installation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-lock fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Security_Checklist|Secure Your Website]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-search-plus fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Search Engine Optimisation|Search Engine Optimisation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/User Management|Managing Your Users]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Template_Management|Managing Templates]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-newspaper-o fa-lg icon" style="color:#555;"></div> <translate>

[[S:MyLanguage/Article_Management|Content Management]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bars fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/Menu_Management|Menu Management]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column text-center">
<div class="large-12 small-12 column">
<div class="main-page-icon orange-bkgd"><div class="fa fa-users fa-3x"></div>
<span class="icon-text"><translate>

'''Contribute'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-pencil-square-o fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/JDOC:How_to_Contribute_to_Joomla!_Documentation|Help with Documentation]]</translate></span>{{-}}
<span style="color:#7DB847;line-height:2.2em;font-size:1.1em;"><div class="fa fa-language fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/JDOC:Documentation_Translators|Translate Documentation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

Join the [[S:MyLanguage/Portal:Bug Squad|Bug Squad]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-file-code-o fa-lg icon" style="color:#F5A443;"></div> <translate>

Be a [[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Code Contributor]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-user-plus fa-lg icon" style="color:#555;"></div> <translate>

Join a [[S:MyLanguage/Portal:Joomla_User_Groups|Joomla User Group]]</translate></span>{{-}}
<span class="main-page-text no-external-icon"><div class="fa fa-life-ring fa-lg icon" style="color:#E6462B;"></div> <translate>

Help on a [http://volunteers.joomla.org Joomla! Team]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#5091CD;"></div>
[[S:MyLanguage/Joomla:Brand Identity Elements|<translate>
Brand Identity Elements</translate>]]</span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#F9A541;"></div>
[[S:MyLanguage/Category:Marketing materials|<translate>
Marketing Resources</translate>]]</span>{{-}}
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-list-alt fa-3x"></div>
<span class="icon-text"><translate>

'''Projects'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="icon-text"><translate>

'''[[S:MyLanguage/JDOC:Projects|Find a JDOC Project]]'''</translate></span>{{-}}
<translate>

Here are a few in need of contributors.</translate>{{-}}
<translate>

'''[[S:MyLanguage/Help screens|Help Screens Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Beginners Tutorial Project|Beginners Tutorial Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]]'''</translate>{{-}}
<translate> '''[[S:MyLanguage/JDOC:Joomla 4 Tutorials Project|Joomla 4 Tutorials Project]]'''</translate>{{-}}
</div>
{{-}}
{{license/<translate>
en</translate>}}
__NOTOC__ __NOEDITSECTION__

User:Max123kl/test

2025-01-23T12:40:16Z

Max123kl: tst

<div class="row">
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;">'''Joomla!'''<span style="font-size:.4em; vertical-align:super;"><sup>®<sup></span></span>{{-}}
[[File:Joomla_logo.png‎|80px|center]]{{-}}
</div>
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;font-weight:bold;"><translate>
Documentation</translate></span>{{-}}
<div class="large-11 large-centered column small-12">
<translate>

An online [[S:MyLanguage/JDOC:About|collaborative community manual]] for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles written, maintained, and translated by our Joomla! community members.
</translate>
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center" style="margin:0;">
<div style="min-width:60px; display:inline-block; margin:0 auto;"><div class="fa fa-language fa-3x"></div></div>
<div id="lang-control" style="max-width:80%; margin:0 auto;">
<noinclude><languages /></noinclude>
</div>
</div>

</br>
{{amboxNew|image=notice|style=notice|title={{{title|<translate>General Information</translate>}}}|text=<translate>'''Dear friends and users of Joomla!''' </translate></br><translate>In year 2025 Joomla! is celebrating its 20th birthday. While our CMS has grown up and is younger and more active than ever, the documentation based on MediaWiki is getting on in years and will be going into retirement before long. We are currently developing new documentation based on Joomla! to demonstrate the power of our CMS.</translate></br><translate>Until the official release of the new documentation (scheduled for October 2025), some pages may not be up to date with the current release of Joomla. In the meantime, the unofficial [https://jdocmanual.org '''Jdocmanual'''] by Cliff may help you as an alternative.</translate></br>
<translate>Those of you who would like to help us with the update are welcome to report your suggestions or improvements on [https://joomlacommunity.cloud.mattermost.com/main/channels/documentation-suggestions Mattermost].</translate>}}


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon blue-bkgd"><div class="fa fa-university fa-3x"></div>
<span class="icon-text">
<translate>

'''Learn'''
</translate>
</span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#5290C8;"></div> <translate>

[[S:MyLanguage/Portal:Learn More|More About Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Joomla:The_Joomla_Websites|The Joomla! Websites]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Filing_bugs_and_issues|Report a Bug or Issue]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Beginners|Beginners]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Portal:Administrators|Administrators]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-code fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Developers|Developers]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Developers]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon red-bkgd"><div class="fa fa-exclamation fa-3x"></div>
<span class="icon-text">
<translate>

'''Links'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-wrench fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-arrow-circle-o-up fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/Portal:Upgrading Versions|Upgrading and Migrations]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-question-circle fa-lg icon" style="color:#7DB847;"></div> <translate>
[[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-life-saver fa-lg icon" style="color:#E6462B;"></div> <translate>
[[S:MyLanguage/Help screens|Admin Help Screens]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-unlock fa-lg icon" style="color:#F5A443;"></div> <translate>
[[S:MyLanguage/How do you recover or reset your admin password?|Password Recovery]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-book fa-lg icon" style="color:#555;"></div> <translate>
[[S:MyLanguage/Glossary|Our Glossary]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-magic fa-lg icon" style="color:#333;"></div> <translate>
[[S:MyLanguage/:Category:Tips and tricks|Tips and Tricks]] or [[S:MyLanguage/:Category:FAQ|FAQs]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-code-fork fa-3x"></div>
<span class="icon-text">
<translate>

'''Versions'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="main-page-text">'''Joomla! {{CurrentSTSVer5|maintenance}} <translate>

is the latest stable version of Joomla 5, we recommend for new installations.</translate>'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer4|maintenance}} <translate>

is the last stable version of Joomla 4. Support will end on the 17th of October 2025</translate>.'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer|maintenance}} <translate>
was the last stable version of Joomla 3. Support ended on the 17th of August 2023</translate>.'''</span>{{-}}
<translate>

Info on all [[S:MyLanguage/What_version_of_Joomla!_should_you_use?|Joomla! CMS Versions]]</translate>{{-}}
<translate>

[https://manual.joomla.org/docs/next/get-started/technical-requirements Technical requirements] for Joomla! </translate>{{-}}
<translate>

[[S:MyLanguage/J4.x:What%27s_new_in_Joomla!_4|Find out what's new in Joomla! CMS {{CurrentSTSVer4|minor}}]]{{-}}
[[S:MyLanguage/J5.x:What%27s_new_in_Joomla!_5|Find out what's new in Joomla! CMS {{CurrentSTSVer5|minor}}]]</translate>{{-}}
<translate>
Take an extended test drive and build your own [[S:MyLanguage/How_to_build_your_free_Joomla_Website|free Joomla! website]]</translate>{{-}}
<translate>

Always use a supported version, read our [[S:MyLanguage/Release and support cycle|release and support cycle]] page.</translate>{{-}}
<div class="no-external-icon"><span style="line-height:2.2em;font-size:1.3em;"><translate>

[https://downloads.joomla.org Download Joomla!]</translate>{{-}}<div class="fa fa-download fa-2x" style="color:#142849;"></div></span></div>{{-}}
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon green-bkgd"><div class="fa fa-tasks fa-3x"></div>
<span class="icon-text">
<translate>

'''Tasks'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-cogs fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Global_Configuration|Configuring Your Installation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-lock fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Security_Checklist|Secure Your Website]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-search-plus fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Search Engine Optimisation|Search Engine Optimisation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/User Management|Managing Your Users]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Template_Management|Managing Templates]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-newspaper-o fa-lg icon" style="color:#555;"></div> <translate>

[[S:MyLanguage/Article_Management|Content Management]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bars fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/Menu_Management|Menu Management]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column text-center">
<div class="large-12 small-12 column">
<div class="main-page-icon orange-bkgd"><div class="fa fa-users fa-3x"></div>
<span class="icon-text"><translate>

'''Contribute'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-pencil-square-o fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/JDOC:How_to_Contribute_to_Joomla!_Documentation|Help with Documentation]]</translate></span>{{-}}
<span style="color:#7DB847;line-height:2.2em;font-size:1.1em;"><div class="fa fa-language fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/JDOC:Documentation_Translators|Translate Documentation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

Join the [[S:MyLanguage/Portal:Bug Squad|Bug Squad]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-file-code-o fa-lg icon" style="color:#F5A443;"></div> <translate>

Be a [[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Code Contributor]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-user-plus fa-lg icon" style="color:#555;"></div> <translate>

Join a [[S:MyLanguage/Portal:Joomla_User_Groups|Joomla User Group]]</translate></span>{{-}}
<span class="main-page-text no-external-icon"><div class="fa fa-life-ring fa-lg icon" style="color:#E6462B;"></div> <translate>

Help on a [http://volunteers.joomla.org Joomla! Team]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#5091CD;"></div>
[[S:MyLanguage/Joomla:Brand Identity Elements|<translate>
Brand Identity Elements</translate>]]</span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#F9A541;"></div>
[[S:MyLanguage/Category:Marketing materials|<translate>
Marketing Resources</translate>]]</span>{{-}}
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-list-alt fa-3x"></div>
<span class="icon-text"><translate>

'''Projects'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="icon-text"><translate>

'''[[S:MyLanguage/JDOC:Projects|Find a JDOC Project]]'''</translate></span>{{-}}
<translate>

Here are a few in need of contributors.</translate>{{-}}
<translate>

'''[[S:MyLanguage/Help screens|Help Screens Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Beginners Tutorial Project|Beginners Tutorial Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]]'''</translate>{{-}}
<translate> '''[[S:MyLanguage/JDOC:Joomla 4 Tutorials Project|Joomla 4 Tutorials Project]]'''</translate>{{-}}
</div>
{{-}}
{{license/<translate>
en</translate>}}
__NOTOC__ __NOEDITSECTION__

User:Max123kl/test

2025-01-23T11:55:37Z

Max123kl: tst

<div class="row">
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;">'''Joomla!'''<span style="font-size:.4em; vertical-align:super;"><sup>®<sup></span></span>{{-}}
[[File:Joomla_logo.png‎|80px|center]]{{-}}
</div>
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;font-weight:bold;"><translate>
Documentation</translate></span>{{-}}
<div class="large-11 large-centered column small-12">
<translate>

An online [[S:MyLanguage/JDOC:About|collaborative community manual]] for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles written, maintained, and translated by our Joomla! community members.
</translate>
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center" style="margin:0;">
<div style="min-width:60px; display:inline-block; margin:0 auto;"><div class="fa fa-language fa-3x"></div></div>
<div id="lang-control" style="max-width:80%; margin:0 auto;">
<noinclude><languages /></noinclude>
</div>
</div>

</br>
{{amboxNew|image=notice|style=notice|title={{{title|<translate>General Information</translate>}}}|text=<translate>BlaBla</translate>}}


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon blue-bkgd"><div class="fa fa-university fa-3x"></div>
<span class="icon-text">
<translate>

'''Learn'''
</translate>
</span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#5290C8;"></div> <translate>

[[S:MyLanguage/Portal:Learn More|More About Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Joomla:The_Joomla_Websites|The Joomla! Websites]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Filing_bugs_and_issues|Report a Bug or Issue]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Beginners|Beginners]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Portal:Administrators|Administrators]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-code fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Developers|Developers]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Developers]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon red-bkgd"><div class="fa fa-exclamation fa-3x"></div>
<span class="icon-text">
<translate>

'''Links'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-wrench fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-arrow-circle-o-up fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/Portal:Upgrading Versions|Upgrading and Migrations]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-question-circle fa-lg icon" style="color:#7DB847;"></div> <translate>
[[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-life-saver fa-lg icon" style="color:#E6462B;"></div> <translate>
[[S:MyLanguage/Help screens|Admin Help Screens]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-unlock fa-lg icon" style="color:#F5A443;"></div> <translate>
[[S:MyLanguage/How do you recover or reset your admin password?|Password Recovery]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-book fa-lg icon" style="color:#555;"></div> <translate>
[[S:MyLanguage/Glossary|Our Glossary]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-magic fa-lg icon" style="color:#333;"></div> <translate>
[[S:MyLanguage/:Category:Tips and tricks|Tips and Tricks]] or [[S:MyLanguage/:Category:FAQ|FAQs]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-code-fork fa-3x"></div>
<span class="icon-text">
<translate>

'''Versions'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="main-page-text">'''Joomla! {{CurrentSTSVer5|maintenance}} <translate>

is the latest stable version of Joomla 5, we recommend for new installations.</translate>'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer4|maintenance}} <translate>

is the last stable version of Joomla 4. Support will end on the 17th of October 2025</translate>.'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer|maintenance}} <translate>
was the last stable version of Joomla 3. Support ended on the 17th of August 2023</translate>.'''</span>{{-}}
<translate>

Info on all [[S:MyLanguage/What_version_of_Joomla!_should_you_use?|Joomla! CMS Versions]]</translate>{{-}}
<translate>

[https://manual.joomla.org/docs/next/get-started/technical-requirements Technical requirements] for Joomla! </translate>{{-}}
<translate>

[[S:MyLanguage/J4.x:What%27s_new_in_Joomla!_4|Find out what's new in Joomla! CMS {{CurrentSTSVer4|minor}}]]{{-}}
[[S:MyLanguage/J5.x:What%27s_new_in_Joomla!_5|Find out what's new in Joomla! CMS {{CurrentSTSVer5|minor}}]]</translate>{{-}}
<translate>
Take an extended test drive and build your own [[S:MyLanguage/How_to_build_your_free_Joomla_Website|free Joomla! website]]</translate>{{-}}
<translate>

Always use a supported version, read our [[S:MyLanguage/Release and support cycle|release and support cycle]] page.</translate>{{-}}
<div class="no-external-icon"><span style="line-height:2.2em;font-size:1.3em;"><translate>

[https://downloads.joomla.org Download Joomla!]</translate>{{-}}<div class="fa fa-download fa-2x" style="color:#142849;"></div></span></div>{{-}}
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon green-bkgd"><div class="fa fa-tasks fa-3x"></div>
<span class="icon-text">
<translate>

'''Tasks'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-cogs fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Global_Configuration|Configuring Your Installation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-lock fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Security_Checklist|Secure Your Website]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-search-plus fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Search Engine Optimisation|Search Engine Optimisation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/User Management|Managing Your Users]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Template_Management|Managing Templates]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-newspaper-o fa-lg icon" style="color:#555;"></div> <translate>

[[S:MyLanguage/Article_Management|Content Management]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bars fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/Menu_Management|Menu Management]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column text-center">
<div class="large-12 small-12 column">
<div class="main-page-icon orange-bkgd"><div class="fa fa-users fa-3x"></div>
<span class="icon-text"><translate>

'''Contribute'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-pencil-square-o fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/JDOC:How_to_Contribute_to_Joomla!_Documentation|Help with Documentation]]</translate></span>{{-}}
<span style="color:#7DB847;line-height:2.2em;font-size:1.1em;"><div class="fa fa-language fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/JDOC:Documentation_Translators|Translate Documentation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

Join the [[S:MyLanguage/Portal:Bug Squad|Bug Squad]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-file-code-o fa-lg icon" style="color:#F5A443;"></div> <translate>

Be a [[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Code Contributor]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-user-plus fa-lg icon" style="color:#555;"></div> <translate>

Join a [[S:MyLanguage/Portal:Joomla_User_Groups|Joomla User Group]]</translate></span>{{-}}
<span class="main-page-text no-external-icon"><div class="fa fa-life-ring fa-lg icon" style="color:#E6462B;"></div> <translate>

Help on a [http://volunteers.joomla.org Joomla! Team]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#5091CD;"></div>
[[S:MyLanguage/Joomla:Brand Identity Elements|<translate>
Brand Identity Elements</translate>]]</span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#F9A541;"></div>
[[S:MyLanguage/Category:Marketing materials|<translate>
Marketing Resources</translate>]]</span>{{-}}
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-list-alt fa-3x"></div>
<span class="icon-text"><translate>

'''Projects'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="icon-text"><translate>

'''[[S:MyLanguage/JDOC:Projects|Find a JDOC Project]]'''</translate></span>{{-}}
<translate>

Here are a few in need of contributors.</translate>{{-}}
<translate>

'''[[S:MyLanguage/Help screens|Help Screens Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Beginners Tutorial Project|Beginners Tutorial Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]]'''</translate>{{-}}
<translate> '''[[S:MyLanguage/JDOC:Joomla 4 Tutorials Project|Joomla 4 Tutorials Project]]'''</translate>{{-}}
</div>
{{-}}
{{license/<translate>
en</translate>}}
__NOTOC__ __NOEDITSECTION__

Archive Main Page

2025-01-23T11:08:47Z

Max123kl: Protected "Archive Main Page": Backup of former main page ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

<div class="row">
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;">'''Joomla!'''<span style="font-size:.4em; vertical-align:super;"><sup>®<sup></span></span>{{-}}
[[File:Joomla_logo.png‎|80px|center]]{{-}}
</div>
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;font-weight:bold;"><translate>
Documentation</translate></span>{{-}}
<div class="large-11 large-centered column small-12">
<translate>

An online [[S:MyLanguage/JDOC:About|collaborative community manual]] for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles written, maintained, and translated by our Joomla! community members.
</translate>
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center" style="margin:0;">
<div style="min-width:60px; display:inline-block; margin:0 auto;"><div class="fa fa-language fa-3x"></div></div>
<div id="lang-control" style="max-width:80%; margin:0 auto;">
<noinclude><languages /></noinclude>
</div>
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon blue-bkgd"><div class="fa fa-university fa-3x"></div>
<span class="icon-text">
<translate>

'''Learn'''
</translate>
</span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#5290C8;"></div> <translate>

[[S:MyLanguage/Portal:Learn More|More About Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Joomla:The_Joomla_Websites|The Joomla! Websites]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Filing_bugs_and_issues|Report a Bug or Issue]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Beginners|Beginners]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Portal:Administrators|Administrators]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-code fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Developers|Developers]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Developers]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon red-bkgd"><div class="fa fa-exclamation fa-3x"></div>
<span class="icon-text">
<translate>

'''Links'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-wrench fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-arrow-circle-o-up fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/Portal:Upgrading Versions|Upgrading and Migrations]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-question-circle fa-lg icon" style="color:#7DB847;"></div> <translate>
[[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-life-saver fa-lg icon" style="color:#E6462B;"></div> <translate>
[[S:MyLanguage/Help screens|Admin Help Screens]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-unlock fa-lg icon" style="color:#F5A443;"></div> <translate>
[[S:MyLanguage/How do you recover or reset your admin password?|Password Recovery]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-book fa-lg icon" style="color:#555;"></div> <translate>
[[S:MyLanguage/Glossary|Our Glossary]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-magic fa-lg icon" style="color:#333;"></div> <translate>
[[S:MyLanguage/:Category:Tips and tricks|Tips and Tricks]] or [[S:MyLanguage/:Category:FAQ|FAQs]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-code-fork fa-3x"></div>
<span class="icon-text">
<translate>

'''Versions'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="main-page-text">'''Joomla! {{CurrentSTSVer5|maintenance}} <translate>

is the latest stable version of Joomla 5, we recommend for new installations.</translate>'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer4|maintenance}} <translate>

is the last stable version of Joomla 4. Support will end on the 17th of October 2025</translate>.'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer|maintenance}} <translate>
was the last stable version of Joomla 3. Support ended on the 17th of August 2023</translate>.'''</span>{{-}}
<translate>

Info on all [[S:MyLanguage/What_version_of_Joomla!_should_you_use?|Joomla! CMS Versions]]</translate>{{-}}
<translate>

[https://manual.joomla.org/docs/next/get-started/technical-requirements Technical requirements] for Joomla! </translate>{{-}}
<translate>

[[S:MyLanguage/J4.x:What%27s_new_in_Joomla!_4|Find out what's new in Joomla! CMS {{CurrentSTSVer4|minor}}]]{{-}}
[[S:MyLanguage/J5.x:What%27s_new_in_Joomla!_5|Find out what's new in Joomla! CMS {{CurrentSTSVer5|minor}}]]</translate>{{-}}
<translate>
Take an extended test drive and build your own [[S:MyLanguage/How_to_build_your_free_Joomla_Website|free Joomla! website]]</translate>{{-}}
<translate>

Always use a supported version, read our [[S:MyLanguage/Release and support cycle|release and support cycle]] page.</translate>{{-}}
<div class="no-external-icon"><span style="line-height:2.2em;font-size:1.3em;"><translate>

[https://downloads.joomla.org Download Joomla!]</translate>{{-}}<div class="fa fa-download fa-2x" style="color:#142849;"></div></span></div>{{-}}
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon green-bkgd"><div class="fa fa-tasks fa-3x"></div>
<span class="icon-text">
<translate>

'''Tasks'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-cogs fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Global_Configuration|Configuring Your Installation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-lock fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Security_Checklist|Secure Your Website]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-search-plus fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Search Engine Optimisation|Search Engine Optimisation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/User Management|Managing Your Users]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Template_Management|Managing Templates]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-newspaper-o fa-lg icon" style="color:#555;"></div> <translate>

[[S:MyLanguage/Article_Management|Content Management]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bars fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/Menu_Management|Menu Management]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column text-center">
<div class="large-12 small-12 column">
<div class="main-page-icon orange-bkgd"><div class="fa fa-users fa-3x"></div>
<span class="icon-text"><translate>

'''Contribute'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-pencil-square-o fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/JDOC:How_to_Contribute_to_Joomla!_Documentation|Help with Documentation]]</translate></span>{{-}}
<span style="color:#7DB847;line-height:2.2em;font-size:1.1em;"><div class="fa fa-language fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/JDOC:Documentation_Translators|Translate Documentation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

Join the [[S:MyLanguage/Portal:Bug Squad|Bug Squad]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-file-code-o fa-lg icon" style="color:#F5A443;"></div> <translate>

Be a [[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Code Contributor]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-user-plus fa-lg icon" style="color:#555;"></div> <translate>

Join a [[S:MyLanguage/Portal:Joomla_User_Groups|Joomla User Group]]</translate></span>{{-}}
<span class="main-page-text no-external-icon"><div class="fa fa-life-ring fa-lg icon" style="color:#E6462B;"></div> <translate>

Help on a [http://volunteers.joomla.org Joomla! Team]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#5091CD;"></div>
[[S:MyLanguage/Joomla:Brand Identity Elements|<translate>
Brand Identity Elements</translate>]]</span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#F9A541;"></div>
[[S:MyLanguage/Category:Marketing materials|<translate>
Marketing Resources</translate>]]</span>{{-}}
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-list-alt fa-3x"></div>
<span class="icon-text"><translate>

'''Projects'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="icon-text"><translate>

'''[[S:MyLanguage/JDOC:Projects|Find a JDOC Project]]'''</translate></span>{{-}}
<translate>

Here are a few in need of contributors.</translate>{{-}}
<translate>

'''[[S:MyLanguage/Help screens|Help Screens Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Beginners Tutorial Project|Beginners Tutorial Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]]'''</translate>{{-}}
<translate> '''[[S:MyLanguage/JDOC:Joomla 4 Tutorials Project|Joomla 4 Tutorials Project]]'''</translate>{{-}}
</div>
{{-}}
{{license/<translate>
en</translate>}}
__NOTOC__ __NOEDITSECTION__

Archive Main Page

2025-01-23T11:00:28Z

Max123kl: Main page secured

<div class="row">
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;">'''Joomla!'''<span style="font-size:.4em; vertical-align:super;"><sup>®<sup></span></span>{{-}}
[[File:Joomla_logo.png‎|80px|center]]{{-}}
</div>
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;font-weight:bold;"><translate>
Documentation</translate></span>{{-}}
<div class="large-11 large-centered column small-12">
<translate>

An online [[S:MyLanguage/JDOC:About|collaborative community manual]] for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles written, maintained, and translated by our Joomla! community members.
</translate>
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center" style="margin:0;">
<div style="min-width:60px; display:inline-block; margin:0 auto;"><div class="fa fa-language fa-3x"></div></div>
<div id="lang-control" style="max-width:80%; margin:0 auto;">
<noinclude><languages /></noinclude>
</div>
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon blue-bkgd"><div class="fa fa-university fa-3x"></div>
<span class="icon-text">
<translate>

'''Learn'''
</translate>
</span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#5290C8;"></div> <translate>

[[S:MyLanguage/Portal:Learn More|More About Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Joomla:The_Joomla_Websites|The Joomla! Websites]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Filing_bugs_and_issues|Report a Bug or Issue]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Beginners|Beginners]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Portal:Administrators|Administrators]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-code fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Developers|Developers]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Developers]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon red-bkgd"><div class="fa fa-exclamation fa-3x"></div>
<span class="icon-text">
<translate>

'''Links'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-wrench fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-arrow-circle-o-up fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/Portal:Upgrading Versions|Upgrading and Migrations]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-question-circle fa-lg icon" style="color:#7DB847;"></div> <translate>
[[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-life-saver fa-lg icon" style="color:#E6462B;"></div> <translate>
[[S:MyLanguage/Help screens|Admin Help Screens]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-unlock fa-lg icon" style="color:#F5A443;"></div> <translate>
[[S:MyLanguage/How do you recover or reset your admin password?|Password Recovery]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-book fa-lg icon" style="color:#555;"></div> <translate>
[[S:MyLanguage/Glossary|Our Glossary]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-magic fa-lg icon" style="color:#333;"></div> <translate>
[[S:MyLanguage/:Category:Tips and tricks|Tips and Tricks]] or [[S:MyLanguage/:Category:FAQ|FAQs]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-code-fork fa-3x"></div>
<span class="icon-text">
<translate>

'''Versions'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="main-page-text">'''Joomla! {{CurrentSTSVer5|maintenance}} <translate>

is the latest stable version of Joomla 5, we recommend for new installations.</translate>'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer4|maintenance}} <translate>

is the last stable version of Joomla 4. Support will end on the 17th of October 2025</translate>.'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer|maintenance}} <translate>
was the last stable version of Joomla 3. Support ended on the 17th of August 2023</translate>.'''</span>{{-}}
<translate>

Info on all [[S:MyLanguage/What_version_of_Joomla!_should_you_use?|Joomla! CMS Versions]]</translate>{{-}}
<translate>

[https://manual.joomla.org/docs/next/get-started/technical-requirements Technical requirements] for Joomla! </translate>{{-}}
<translate>

[[S:MyLanguage/J4.x:What%27s_new_in_Joomla!_4|Find out what's new in Joomla! CMS {{CurrentSTSVer4|minor}}]]{{-}}
[[S:MyLanguage/J5.x:What%27s_new_in_Joomla!_5|Find out what's new in Joomla! CMS {{CurrentSTSVer5|minor}}]]</translate>{{-}}
<translate>
Take an extended test drive and build your own [[S:MyLanguage/How_to_build_your_free_Joomla_Website|free Joomla! website]]</translate>{{-}}
<translate>

Always use a supported version, read our [[S:MyLanguage/Release and support cycle|release and support cycle]] page.</translate>{{-}}
<div class="no-external-icon"><span style="line-height:2.2em;font-size:1.3em;"><translate>

[https://downloads.joomla.org Download Joomla!]</translate>{{-}}<div class="fa fa-download fa-2x" style="color:#142849;"></div></span></div>{{-}}
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon green-bkgd"><div class="fa fa-tasks fa-3x"></div>
<span class="icon-text">
<translate>

'''Tasks'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-cogs fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Global_Configuration|Configuring Your Installation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-lock fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Security_Checklist|Secure Your Website]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-search-plus fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Search Engine Optimisation|Search Engine Optimisation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/User Management|Managing Your Users]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Template_Management|Managing Templates]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-newspaper-o fa-lg icon" style="color:#555;"></div> <translate>

[[S:MyLanguage/Article_Management|Content Management]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bars fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/Menu_Management|Menu Management]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column text-center">
<div class="large-12 small-12 column">
<div class="main-page-icon orange-bkgd"><div class="fa fa-users fa-3x"></div>
<span class="icon-text"><translate>

'''Contribute'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-pencil-square-o fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/JDOC:How_to_Contribute_to_Joomla!_Documentation|Help with Documentation]]</translate></span>{{-}}
<span style="color:#7DB847;line-height:2.2em;font-size:1.1em;"><div class="fa fa-language fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/JDOC:Documentation_Translators|Translate Documentation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

Join the [[S:MyLanguage/Portal:Bug Squad|Bug Squad]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-file-code-o fa-lg icon" style="color:#F5A443;"></div> <translate>

Be a [[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Code Contributor]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-user-plus fa-lg icon" style="color:#555;"></div> <translate>

Join a [[S:MyLanguage/Portal:Joomla_User_Groups|Joomla User Group]]</translate></span>{{-}}
<span class="main-page-text no-external-icon"><div class="fa fa-life-ring fa-lg icon" style="color:#E6462B;"></div> <translate>

Help on a [http://volunteers.joomla.org Joomla! Team]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#5091CD;"></div>
[[S:MyLanguage/Joomla:Brand Identity Elements|<translate>
Brand Identity Elements</translate>]]</span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#F9A541;"></div>
[[S:MyLanguage/Category:Marketing materials|<translate>
Marketing Resources</translate>]]</span>{{-}}
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-list-alt fa-3x"></div>
<span class="icon-text"><translate>

'''Projects'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="icon-text"><translate>

'''[[S:MyLanguage/JDOC:Projects|Find a JDOC Project]]'''</translate></span>{{-}}
<translate>

Here are a few in need of contributors.</translate>{{-}}
<translate>

'''[[S:MyLanguage/Help screens|Help Screens Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Beginners Tutorial Project|Beginners Tutorial Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]]'''</translate>{{-}}
<translate> '''[[S:MyLanguage/JDOC:Joomla 4 Tutorials Project|Joomla 4 Tutorials Project]]'''</translate>{{-}}
</div>
{{-}}
{{license/<translate>
en</translate>}}
__NOTOC__ __NOEDITSECTION__

What is the typical template directory structure?

2025-01-22T16:39:46Z

Max123kl: review marker set

<noinclude><languages /></noinclude>
{{review}}
<translate>===Typical Template Directory Structure=== </translate>
<translate>
Joomla! CMS templates use a structure of directories and files but they can vary from template to template
*'''Site''' templates (templates that change what your website looks like) can be found in the ''/templates'' directory. For example, if your template is called ''mytemplate'', it would be placed in the folder:</translate>
:<translate>
''<path-to-Joomla!>/templates/mytemplate''</translate>
<translate>
*'''Administrator''' templates (templates that change what the Administrator section of the site looks like) can be found in the ''/administrator/templates'' directory. For example, if your administrator template is called ''myadmintemplate'', it would be placed in the folder:</translate>
:<translate>
''<path-to-Joomla!>/administrator/templates/myadmintemplate''</translate>
<translate>====Template Directories==== </translate>
{{:Typical template directory structure/<translate>
en</translate>}}

<translate>====Template Files==== </translate>
<translate>
It is most common for a template to have at least the following files:
* '''index.php'''
: Provides the logic for the display and positioning of modules and components.
* '''component.php'''
: Provides the logic for the display of the printer friendly page, "E-mail this link to a friend." etc.
* '''error.php'''
: Provides a method to handle errors such as 404, page not found error.
* '''favicon.ico'''
: favicon icon file</translate>
<translate>
* '''template.css'''
: Handles the presentational aspects of the template including specifications for margins, fonts, headings, image borders, list formatting, etc. The ''.css'' files may also be located in the ''/css'' directory.</translate>
<translate>
* '''templateDetails.xml'''
: Holds meta-information related to the template and is used by the Installer and the Template Manager.
* '''template_preview.ext''' - replace ''.ext'' with the extension format of the image (''.jpg'', ''.png'', ''.gif'')
: Generally a 600x400 pixel image shown when the cursor is clicked on the thumbnail image in Template Manager:Templates, not Template Manager:Styles. This gives the Administrator a pop up modal window of the template before applying it to the Site.</translate>
<translate>
* '''template_thumbnail.ext''' - replace ''.ext'' with the extension format of the image (''.jpg'', ''.png''', ''.gif'')
: Generally a 200x150 pixel thumbnail image shown when viewing the Template list in Template Manager:Templates, not Template Manager:Styles. This gives the Administrator a thumbnail view of the template before applying it to the Site.</translate>

<noinclude>
<translate>
[[Category:Template Development FAQ]]
[[Category:Template Development]]
[[Category:Template Reference]]
[[Category:Template Management]]</translate>
</noinclude>

Translations:Tutorials:Beginners/4/de

2025-01-14T20:30:56Z

Max123kl:

*[[S:MyLanguage/J4.x:Getting Started with Joomla!|Erste Schritte mit Joomla!]]
**[[S:MyLanguage/J3.0:Getting Started with Templates|Erste Schritte mit Templates]]
**[[S:MyLanguage/J3.0:Getting Started with Categories|Erste Schritte mit Kategorien]]
**[[S:MyLanguage/J3.0:Getting Started with Articles|Erste Schritte mit Beiträgen]]
**[[S:MyLanguage/J3.0:Getting Started with Menus|Erste Schritte mit Menüs]]
**[[S:MyLanguage/J3.0:Getting Started Modules|Erste Schritte mit Modulen]]
*[[S:MyLanguage/J3.1:How To Use Content Tags in Joomla!|Nutzung von Tags in Joomla!]]

J4.x:Global Configuration

2025-01-14T12:52:36Z

Max123kl: Marked this version for translation

<noinclude><languages /></noinclude>

<translate>
== Overview == 


On installation, a Joomla site creates a file named '''configuration.php''' in the root of the site. This file contains the values of configuration variables that apply to the site as a whole. Examples include the site name and database credentials that were entered during the installation process. There are many more variables that are given suitable initial values.


The Global Configuration form allows a Super User to change the configuration variables to suit the needs of the site. In addition to the variables stored in configuration.php, the form keeps track of Logging, Filtering and Access Control information, some of which is stored in the database.

== Screenshot == 


The Global Configuration form has six tabs some of which have long lists of parameters. Use the <tt>Toggle Inline Help</tt> button to see more or less information on each parameter.


[[File:J4x-global-configuration-en.png|Global Configuration|800px|border|center]]


Some parameters show or hide other parameters when selected. For example, the '''Site Offline''' button shows more fields when set to <tt>Yes</tt> than it does when set to <tt>No</tt>. With inline help expanded most fields are sufficiently well documented to need no further explanation here, other than some additional user notes on each tab.

== Site tab == 
=== Site panel ===


* '''Default List Limit''' sets the default maximum number of items per page in list views. By default, this parameter is set to 20 but list views usually include a drop-down list to select other values ranging from 5 to 100. Fewer values are quicker to process and involve less user scrolling.

=== Metadata panel === 


* '''Site Metadata Description''' is the default metadata description used if such a description is not specified in an article Meta Description field or a menu Meta Description field. If all three are empty the metadata description is omitted from the page output. Search engines often use this to provide descriptive text for a page. If absent, search engines my use text from the content of the page, which may be inappropriate. A description of the purpose of the site of around 20 words is recommended.
* '''Content Rights''' sets the ''rights'' metadata entry. If appropriate, describe here what rights others have to use this content. This metadata entry is omitted from web pages if this entry is blank. Example: Creative Commons Attribution 4.0 International License. (See: https://creativecommons.org/choose/ for Creative Commons licences.)

=== SEO panel === 


SEO is an acronym for ''Search Engine Optimisation''. Settings in this group alter the format of URLs for pages in the website and this may have a significant effect on the search rankings of individual pages and the site as a whole. SEO URLs are more human-readable.


'''Tip:''' After making any changes to the settings in this group, refresh any of the website's pages already open in your web browser (usually Ctrl+R or Cmd+R will do this). Failure to refresh may mean that the format of web links internal to the site no longer match that which Joomla is expecting and thus give the appearance of broken links.


'''Tip:''' If at all possible, avoid altering the SEO Settings once a website is established. Doing so may result in broken links from other sites and perhaps a temporary drop in search engine rankings.


* '''Unicode aliases''' Changing this parameter does not retroactively change aliases, it just changes the behaviour of automatic alias generation for future content editing and creation. ''Transliteration'' (No) is the default setting.

=== Cookie panel === 


* '''Cookie Domain''' Overrides the site's default cookie domain with the domain added here. The most likely situation when this would be needed is when the Joomla site is “bridged“ with other sites (e.g. forum or e-commerce) in sub-domains of the Joomla site. The default cookie domain may be like <tt>www.example.com</tt>, but using <tt>.example.com</tt> (note the leading dot) here will deliver cookies valid for any sub-domain of example.com.
* '''Cookie Path''' Overrides the site's default path for which the cookie is valid with the path added here. This may be needed if you have several Joomla installations in sibling folders.

== System tab == 
=== Debug panel ===


The items in this panel are well explained by the inline help. However, if you encounter a problem that disables normal access to the Administrator interface you may need to set Debug System by editing configuration.php with a text editor. On most Linux based hosting systems the file permissions are set to 444 which prevents saving from a text editor. Change the permission to 644 before editing. Then set $debug = true; and set $error_reporting = 'maximum'; and save. You should then get a stack trace identifying exactly where the problem occurs. You can use that to seek help in the Forums. Most problems arise from incompatible third party extensions or from problems with the hosting environment.

=== Mail panel === 


A Joomla site should be able to send outgoing emails. Amongst other things, it will send automated messages to the site owner when updates are available. However, some hosting services restrict methods by which outgoing mail may be sent. Using your own private email address in the From Email field:
* Try PHP Mail first and select the <tt>Send Test Mail</tt> button. If the email arrives you are good to go. Otherwise:
* Try the Sendmail option. If that does not work:
* Try the SMTP option. This needs to be set up for a specific mail server. It could be one provided by your hosting service. It could be a GMail account.
* '''SMTP Host''' The hostname of the SMTP server (e.g. ''smtp.example.com'').
** '''SMTP Port''' The port to use when connecting to the SMTP server. This will usually be ''25'' when SMTP Security is set to <tt>None</tt>, or ''465'' or ''587'' when SMTP Security is set to <tt>SSL/TLS</tt> or <tt>STARTTLS</tt>. Ask your SMTP service provider which port to use.
** '''SMTP Security''' The form of security required by the SMTP server: ''None'', ''SSL/TLS'' or ''STARTTLS''. The default is ''None''.
** '''SMTP Authentication''' Whether or not the external SMTP server requires authentication before accepting outgoing emails. The default is ''No''.
** '''SMTP Username''' The username to be used when connecting to the SMTP server in SSL or TLS mode. May be left blank if there is no SMTP authentication.
** '''SMTP Password''' The password to be used when connecting to the SMTP server in SSL or TLS mode. May be left blank if there is no SMTP authentication.

=== Using Gmail as Mail Server === 


If you have a working Gmail account you can use Gmail as your mail server by setting it in the global configuration. On the server tab set the following:
* Mailer: SMTP
* SMTP Host: smtp.gmail.com
* SMTP Port 465
* SMTP Security: SSL/TLS
* SMTP Authentication: Yes
* Set the next two lines with your information. You need to use an app specific password (ASP), described below.
* SMTP Username: your gmail username
* SMTP Password: the app specific password (ASP) you generated, described below.
The following are also working combinations:
*SMTP Port 587
*SMTP Security: STARTTLS
*SMTP Port 25
*SMTP Security: STARTTLS


'''Notes:'''
* The SSL module does not need to be enabled in Apache.
* The OpenSSL extension needs to be enabled in PHP. The details can be found at the [https://www.php.net/manual/en/openssl.installation.php php.net Installation page].
* If you are using WAMP on Windows, the openssl module is not enabled by default and you need to enable it. To do this:
** Open the php.ini file and uncomment the line <code>extension=php_openssl.dll</code> by removing the semicolon ; from the beginning of the line.
** Save the php.ini file and restart the Apache service.
* If you use 2-step verification in Gmail, you need to add a new password in Settings - Accounts - Change accounts settings - Other Google Account settings - Security - 2-step verification - Manage your application specific passwords.
* When the new Application Specific Password (ASP) is presented in groups of four characters separated by spaces, make sure that you '''do NOT enter the spaces''' into the SMTP password in the mail server settings in Joomla.
* Application Specific Passwords (ASPs): See the Google Support [https://support.google.com/accounts/answer/185833 Sign in with App Passwords] page.
* 2-Step Verification: See the Google Support [https://support.google.com/accounts/answer/185839 Turn on 2-Step Verification] page.

== Logging tab == 


In normal operation a Joomla site should have logging disabled. If there are problems you can enable logging by setting the '''Log Almost Everything''' field to <tt>Yes</tt>. The '''Log Deprecated API''' is really for developers only. The '''Path to Log Folder''' field shows you where to look for logs if you have set up logging to help with debugging. The error logs you find there are only those trapped by Joomla. There may be other errors that will only appear in your server error logs.

== The Text Filters Tab == 


The text filter settings will be applied to all text editor fields submitted by users in the selected groups. These filtering options give more control over the HTML your content providers submit. You can be as strict or as liberal as you require to suit your site's needs. The filtering is opt-in and the default settings provide good protection against markup commonly associated with website attacks.

== Permissions tab == 


Permissions control what users in each User Group can do and see. The entries in Permissions tab set the default permissions for the site.


There are comprehensive descriptions of the use of the settings under this tab and the general principles of operation and set-up of permissions here: [[S:MyLanguage/J3.x:Access Control List Tutorial#Global_Configuration|ACL Tutorial for Joomla 3.x]].
</translate>

J4.x:Global Configuration

2025-01-14T12:52:13Z

Max123kl: blank lines added

<noinclude><languages /></noinclude>

<translate>
== Overview ==

On installation, a Joomla site creates a file named '''configuration.php''' in the root of the site. This file contains the values of configuration variables that apply to the site as a whole. Examples include the site name and database credentials that were entered during the installation process. There are many more variables that are given suitable initial values.

The Global Configuration form allows a Super User to change the configuration variables to suit the needs of the site. In addition to the variables stored in configuration.php, the form keeps track of Logging, Filtering and Access Control information, some of which is stored in the database.

== Screenshot ==

The Global Configuration form has six tabs some of which have long lists of parameters. Use the <tt>Toggle Inline Help</tt> button to see more or less information on each parameter.

[[File:J4x-global-configuration-en.png|Global Configuration|800px|border|center]]

Some parameters show or hide other parameters when selected. For example, the '''Site Offline''' button shows more fields when set to <tt>Yes</tt> than it does when set to <tt>No</tt>. With inline help expanded most fields are sufficiently well documented to need no further explanation here, other than some additional user notes on each tab.

== Site tab ==
=== Site panel ===

* '''Default List Limit''' sets the default maximum number of items per page in list views. By default, this parameter is set to 20 but list views usually include a drop-down list to select other values ranging from 5 to 100. Fewer values are quicker to process and involve less user scrolling.

=== Metadata panel ===

* '''Site Metadata Description''' is the default metadata description used if such a description is not specified in an article Meta Description field or a menu Meta Description field. If all three are empty the metadata description is omitted from the page output. Search engines often use this to provide descriptive text for a page. If absent, search engines my use text from the content of the page, which may be inappropriate. A description of the purpose of the site of around 20 words is recommended.
* '''Content Rights''' sets the ''rights'' metadata entry. If appropriate, describe here what rights others have to use this content. This metadata entry is omitted from web pages if this entry is blank. Example: Creative Commons Attribution 4.0 International License. (See: https://creativecommons.org/choose/ for Creative Commons licences.)

=== SEO panel ===

SEO is an acronym for ''Search Engine Optimisation''. Settings in this group alter the format of URLs for pages in the website and this may have a significant effect on the search rankings of individual pages and the site as a whole. SEO URLs are more human-readable.

'''Tip:''' After making any changes to the settings in this group, refresh any of the website's pages already open in your web browser (usually Ctrl+R or Cmd+R will do this). Failure to refresh may mean that the format of web links internal to the site no longer match that which Joomla is expecting and thus give the appearance of broken links.

'''Tip:''' If at all possible, avoid altering the SEO Settings once a website is established. Doing so may result in broken links from other sites and perhaps a temporary drop in search engine rankings.

* '''Unicode aliases''' Changing this parameter does not retroactively change aliases, it just changes the behaviour of automatic alias generation for future content editing and creation. ''Transliteration'' (No) is the default setting.

=== Cookie panel ===

* '''Cookie Domain''' Overrides the site's default cookie domain with the domain added here. The most likely situation when this would be needed is when the Joomla site is “bridged“ with other sites (e.g. forum or e-commerce) in sub-domains of the Joomla site. The default cookie domain may be like <tt>www.example.com</tt>, but using <tt>.example.com</tt> (note the leading dot) here will deliver cookies valid for any sub-domain of example.com.
* '''Cookie Path''' Overrides the site's default path for which the cookie is valid with the path added here. This may be needed if you have several Joomla installations in sibling folders.

== System tab ==
=== Debug panel ===

The items in this panel are well explained by the inline help. However, if you encounter a problem that disables normal access to the Administrator interface you may need to set Debug System by editing configuration.php with a text editor. On most Linux based hosting systems the file permissions are set to 444 which prevents saving from a text editor. Change the permission to 644 before editing. Then set $debug = true; and set $error_reporting = 'maximum'; and save. You should then get a stack trace identifying exactly where the problem occurs. You can use that to seek help in the Forums. Most problems arise from incompatible third party extensions or from problems with the hosting environment.

=== Mail panel ===

A Joomla site should be able to send outgoing emails. Amongst other things, it will send automated messages to the site owner when updates are available. However, some hosting services restrict methods by which outgoing mail may be sent. Using your own private email address in the From Email field:
* Try PHP Mail first and select the <tt>Send Test Mail</tt> button. If the email arrives you are good to go. Otherwise:
* Try the Sendmail option. If that does not work:
* Try the SMTP option. This needs to be set up for a specific mail server. It could be one provided by your hosting service. It could be a GMail account.
* '''SMTP Host''' The hostname of the SMTP server (e.g. ''smtp.example.com'').
** '''SMTP Port''' The port to use when connecting to the SMTP server. This will usually be ''25'' when SMTP Security is set to <tt>None</tt>, or ''465'' or ''587'' when SMTP Security is set to <tt>SSL/TLS</tt> or <tt>STARTTLS</tt>. Ask your SMTP service provider which port to use.
** '''SMTP Security''' The form of security required by the SMTP server: ''None'', ''SSL/TLS'' or ''STARTTLS''. The default is ''None''.
** '''SMTP Authentication''' Whether or not the external SMTP server requires authentication before accepting outgoing emails. The default is ''No''.
** '''SMTP Username''' The username to be used when connecting to the SMTP server in SSL or TLS mode. May be left blank if there is no SMTP authentication.
** '''SMTP Password''' The password to be used when connecting to the SMTP server in SSL or TLS mode. May be left blank if there is no SMTP authentication.

=== Using Gmail as Mail Server ===

If you have a working Gmail account you can use Gmail as your mail server by setting it in the global configuration. On the server tab set the following:
* Mailer: SMTP
* SMTP Host: smtp.gmail.com
* SMTP Port 465
* SMTP Security: SSL/TLS
* SMTP Authentication: Yes
* Set the next two lines with your information. You need to use an app specific password (ASP), described below.
* SMTP Username: your gmail username
* SMTP Password: the app specific password (ASP) you generated, described below.
The following are also working combinations:
*SMTP Port 587
*SMTP Security: STARTTLS
*SMTP Port 25
*SMTP Security: STARTTLS

'''Notes:'''
* The SSL module does not need to be enabled in Apache.
* The OpenSSL extension needs to be enabled in PHP. The details can be found at the [https://www.php.net/manual/en/openssl.installation.php php.net Installation page].
* If you are using WAMP on Windows, the openssl module is not enabled by default and you need to enable it. To do this:
** Open the php.ini file and uncomment the line <code>extension=php_openssl.dll</code> by removing the semicolon ; from the beginning of the line.
** Save the php.ini file and restart the Apache service.
* If you use 2-step verification in Gmail, you need to add a new password in Settings - Accounts - Change accounts settings - Other Google Account settings - Security - 2-step verification - Manage your application specific passwords.
* When the new Application Specific Password (ASP) is presented in groups of four characters separated by spaces, make sure that you '''do NOT enter the spaces''' into the SMTP password in the mail server settings in Joomla.
* Application Specific Passwords (ASPs): See the Google Support [https://support.google.com/accounts/answer/185833 Sign in with App Passwords] page.
* 2-Step Verification: See the Google Support [https://support.google.com/accounts/answer/185839 Turn on 2-Step Verification] page.

== Logging tab ==

In normal operation a Joomla site should have logging disabled. If there are problems you can enable logging by setting the '''Log Almost Everything''' field to <tt>Yes</tt>. The '''Log Deprecated API''' is really for developers only. The '''Path to Log Folder''' field shows you where to look for logs if you have set up logging to help with debugging. The error logs you find there are only those trapped by Joomla. There may be other errors that will only appear in your server error logs.

== The Text Filters Tab ==

The text filter settings will be applied to all text editor fields submitted by users in the selected groups. These filtering options give more control over the HTML your content providers submit. You can be as strict or as liberal as you require to suit your site's needs. The filtering is opt-in and the default settings provide good protection against markup commonly associated with website attacks.

== Permissions tab ==

Permissions control what users in each User Group can do and see. The entries in Permissions tab set the default permissions for the site.

There are comprehensive descriptions of the use of the settings under this tab and the general principles of operation and set-up of permissions here: [[S:MyLanguage/J3.x:Access Control List Tutorial#Global_Configuration|ACL Tutorial for Joomla 3.x]].
</translate>

J4.x:Global Configuration

2025-01-14T12:46:10Z

Max123kl: marked for translation

<noinclude><languages /></noinclude>

<translate>
== Overview ==
On installation, a Joomla site creates a file named '''configuration.php''' in the root of the site. This file contains the values of configuration variables that apply to the site as a whole. Examples include the site name and database credentials that were entered during the installation process. There are many more variables that are given suitable initial values.

The Global Configuration form allows a Super User to change the configuration variables to suit the needs of the site. In addition to the variables stored in configuration.php, the form keeps track of Logging, Filtering and Access Control information, some of which is stored in the database.

== Screenshot ==
The Global Configuration form has six tabs some of which have long lists of parameters. Use the <tt>Toggle Inline Help</tt> button to see more or less information on each parameter.

[[File:J4x-global-configuration-en.png|Global Configuration|800px|border|center]]

Some parameters show or hide other parameters when selected. For example, the '''Site Offline''' button shows more fields when set to <tt>Yes</tt> than it does when set to <tt>No</tt>. With inline help expanded most fields are sufficiently well documented to need no further explanation here, other than some additional user notes on each tab.

== Site tab ==
=== Site panel ===
* '''Default List Limit''' sets the default maximum number of items per page in list views. By default, this parameter is set to 20 but list views usually include a drop-down list to select other values ranging from 5 to 100. Fewer values are quicker to process and involve less user scrolling.

=== Metadata panel ===
* '''Site Metadata Description''' is the default metadata description used if such a description is not specified in an article Meta Description field or a menu Meta Description field. If all three are empty the metadata description is omitted from the page output. Search engines often use this to provide descriptive text for a page. If absent, search engines my use text from the content of the page, which may be inappropriate. A description of the purpose of the site of around 20 words is recommended.
* '''Content Rights''' sets the ''rights'' metadata entry. If appropriate, describe here what rights others have to use this content. This metadata entry is omitted from web pages if this entry is blank. Example: Creative Commons Attribution 4.0 International License. (See: https://creativecommons.org/choose/ for Creative Commons licences.)

=== SEO panel ===
SEO is an acronym for ''Search Engine Optimisation''. Settings in this group alter the format of URLs for pages in the website and this may have a significant effect on the search rankings of individual pages and the site as a whole. SEO URLs are more human-readable.

'''Tip:''' After making any changes to the settings in this group, refresh any of the website's pages already open in your web browser (usually Ctrl+R or Cmd+R will do this). Failure to refresh may mean that the format of web links internal to the site no longer match that which Joomla is expecting and thus give the appearance of broken links.

'''Tip:''' If at all possible, avoid altering the SEO Settings once a website is established. Doing so may result in broken links from other sites and perhaps a temporary drop in search engine rankings.

* '''Unicode aliases''' Changing this parameter does not retroactively change aliases, it just changes the behaviour of automatic alias generation for future content editing and creation. ''Transliteration'' (No) is the default setting.

=== Cookie panel ===
* '''Cookie Domain''' Overrides the site's default cookie domain with the domain added here. The most likely situation when this would be needed is when the Joomla site is “bridged“ with other sites (e.g. forum or e-commerce) in sub-domains of the Joomla site. The default cookie domain may be like <tt>www.example.com</tt>, but using <tt>.example.com</tt> (note the leading dot) here will deliver cookies valid for any sub-domain of example.com.
* '''Cookie Path''' Overrides the site's default path for which the cookie is valid with the path added here. This may be needed if you have several Joomla installations in sibling folders.

== System tab ==
=== Debug panel ===
The items in this panel are well explained by the inline help. However, if you encounter a problem that disables normal access to the Administrator interface you may need to set Debug System by editing configuration.php with a text editor. On most Linux based hosting systems the file permissions are set to 444 which prevents saving from a text editor. Change the permission to 644 before editing. Then set $debug = true; and set $error_reporting = 'maximum'; and save. You should then get a stack trace identifying exactly where the problem occurs. You can use that to seek help in the Forums. Most problems arise from incompatible third party extensions or from problems with the hosting environment.

=== Mail panel ===
A Joomla site should be able to send outgoing emails. Amongst other things, it will send automated messages to the site owner when updates are available. However, some hosting services restrict methods by which outgoing mail may be sent. Using your own private email address in the From Email field:
* Try PHP Mail first and select the <tt>Send Test Mail</tt> button. If the email arrives you are good to go. Otherwise:
* Try the Sendmail option. If that does not work:
* Try the SMTP option. This needs to be set up for a specific mail server. It could be one provided by your hosting service. It could be a GMail account.
* '''SMTP Host''' The hostname of the SMTP server (e.g. ''smtp.example.com'').
** '''SMTP Port''' The port to use when connecting to the SMTP server. This will usually be ''25'' when SMTP Security is set to <tt>None</tt>, or ''465'' or ''587'' when SMTP Security is set to <tt>SSL/TLS</tt> or <tt>STARTTLS</tt>. Ask your SMTP service provider which port to use.
** '''SMTP Security''' The form of security required by the SMTP server: ''None'', ''SSL/TLS'' or ''STARTTLS''. The default is ''None''.
** '''SMTP Authentication''' Whether or not the external SMTP server requires authentication before accepting outgoing emails. The default is ''No''.
** '''SMTP Username''' The username to be used when connecting to the SMTP server in SSL or TLS mode. May be left blank if there is no SMTP authentication.
** '''SMTP Password''' The password to be used when connecting to the SMTP server in SSL or TLS mode. May be left blank if there is no SMTP authentication.

=== Using Gmail as Mail Server ===
If you have a working Gmail account you can use Gmail as your mail server by setting it in the global configuration. On the server tab set the following:
* Mailer: SMTP
* SMTP Host: smtp.gmail.com
* SMTP Port 465
* SMTP Security: SSL/TLS
* SMTP Authentication: Yes
* Set the next two lines with your information. You need to use an app specific password (ASP), described below.
* SMTP Username: your gmail username
* SMTP Password: the app specific password (ASP) you generated, described below.
The following are also working combinations:
*SMTP Port 587
*SMTP Security: STARTTLS
*SMTP Port 25
*SMTP Security: STARTTLS

'''Notes:'''
* The SSL module does not need to be enabled in Apache.
* The OpenSSL extension needs to be enabled in PHP. The details can be found at the [https://www.php.net/manual/en/openssl.installation.php php.net Installation page].
* If you are using WAMP on Windows, the openssl module is not enabled by default and you need to enable it. To do this:
** Open the php.ini file and uncomment the line <code>extension=php_openssl.dll</code> by removing the semicolon ; from the beginning of the line.
** Save the php.ini file and restart the Apache service.
* If you use 2-step verification in Gmail, you need to add a new password in Settings - Accounts - Change accounts settings - Other Google Account settings - Security - 2-step verification - Manage your application specific passwords.
* When the new Application Specific Password (ASP) is presented in groups of four characters separated by spaces, make sure that you '''do NOT enter the spaces''' into the SMTP password in the mail server settings in Joomla.
* Application Specific Passwords (ASPs): See the Google Support [https://support.google.com/accounts/answer/185833 Sign in with App Passwords] page.
* 2-Step Verification: See the Google Support [https://support.google.com/accounts/answer/185839 Turn on 2-Step Verification] page.

== Logging tab ==
In normal operation a Joomla site should have logging disabled. If there are problems you can enable logging by setting the '''Log Almost Everything''' field to <tt>Yes</tt>. The '''Log Deprecated API''' is really for developers only. The '''Path to Log Folder''' field shows you where to look for logs if you have set up logging to help with debugging. The error logs you find there are only those trapped by Joomla. There may be other errors that will only appear in your server error logs.

== The Text Filters Tab ==
The text filter settings will be applied to all text editor fields submitted by users in the selected groups. These filtering options give more control over the HTML your content providers submit. You can be as strict or as liberal as you require to suit your site's needs. The filtering is opt-in and the default settings provide good protection against markup commonly associated with website attacks.

== Permissions tab ==
Permissions control what users in each User Group can do and see. The entries in Permissions tab set the default permissions for the site.

There are comprehensive descriptions of the use of the settings under this tab and the general principles of operation and set-up of permissions here: [[S:MyLanguage/J3.x:Access Control List Tutorial#Global_Configuration|ACL Tutorial for Joomla 3.x]].
</translate>

Main Page

2025-01-14T12:34:17Z

Max123kl: link J3 fixed to J4

<div class="row">
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;">'''Joomla!'''<span style="font-size:.4em; vertical-align:super;"><sup>®<sup></span></span>{{-}}
[[File:Joomla_logo.png‎|80px|center]]{{-}}
</div>
<div class="large-12 small-12 columns text-center hide-for-small">
<span style="font-size:2.5em;font-weight:bold;"><translate>
Documentation</translate></span>{{-}}
<div class="large-11 large-centered column small-12">
<translate>

An online [[S:MyLanguage/JDOC:About|collaborative community manual]] for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles written, maintained, and translated by our Joomla! community members.
</translate>
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center" style="margin:0;">
<div style="min-width:60px; display:inline-block; margin:0 auto;"><div class="fa fa-language fa-3x"></div></div>
<div id="lang-control" style="max-width:80%; margin:0 auto;">
<noinclude><languages /></noinclude>
</div>
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon blue-bkgd"><div class="fa fa-university fa-3x"></div>
<span class="icon-text">
<translate>

'''Learn'''
</translate>
</span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#5290C8;"></div> <translate>

[[S:MyLanguage/Portal:Learn More|More About Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Joomla:The_Joomla_Websites|The Joomla! Websites]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Filing_bugs_and_issues|Report a Bug or Issue]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Beginners|Beginners]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Portal:Administrators|Administrators]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-code fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Developers|Developers]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#000;"></div> <translate>

[[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Developers]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon red-bkgd"><div class="fa fa-exclamation fa-3x"></div>
<span class="icon-text">
<translate>

'''Links'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-wrench fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla!]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-arrow-circle-o-up fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/Portal:Upgrading Versions|Upgrading and Migrations]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-question-circle fa-lg icon" style="color:#7DB847;"></div> <translate>
[[S:MyLanguage/Tutorials:Beginners|Beginner Tutorials]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-life-saver fa-lg icon" style="color:#E6462B;"></div> <translate>
[[S:MyLanguage/Help screens|Admin Help Screens]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-unlock fa-lg icon" style="color:#F5A443;"></div> <translate>
[[S:MyLanguage/How do you recover or reset your admin password?|Password Recovery]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-book fa-lg icon" style="color:#555;"></div> <translate>
[[S:MyLanguage/Glossary|Our Glossary]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-magic fa-lg icon" style="color:#333;"></div> <translate>
[[S:MyLanguage/:Category:Tips and tricks|Tips and Tricks]] or [[S:MyLanguage/:Category:FAQ|FAQs]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-code-fork fa-3x"></div>
<span class="icon-text">
<translate>

'''Versions'''
</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="main-page-text">'''Joomla! {{CurrentSTSVer5|maintenance}} <translate>

is the latest stable version of Joomla 5, we recommend for new installations.</translate>'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer4|maintenance}} <translate>

is the last stable version of Joomla 4. Support will end on the 17th of October 2025</translate>.'''</span>{{-}}
<span class="main-page-text">'''Joomla! {{CurrentSTSVer|maintenance}} <translate>
was the last stable version of Joomla 3. Support ended on the 17th of August 2023</translate>.'''</span>{{-}}
<translate>

Info on all [[S:MyLanguage/What_version_of_Joomla!_should_you_use?|Joomla! CMS Versions]]</translate>{{-}}
<translate>

[https://manual.joomla.org/docs/next/get-started/technical-requirements Technical requirements] for Joomla! </translate>{{-}}
<translate>

[[S:MyLanguage/J4.x:What%27s_new_in_Joomla!_4|Find out what's new in Joomla! CMS {{CurrentSTSVer4|minor}}]]{{-}}
[[S:MyLanguage/J5.x:What%27s_new_in_Joomla!_5|Find out what's new in Joomla! CMS {{CurrentSTSVer5|minor}}]]</translate>{{-}}
<translate>
Take an extended test drive and build your own [[S:MyLanguage/How_to_build_your_free_Joomla_Website|free Joomla! website]]</translate>{{-}}
<translate>

Always use a supported version, read our [[S:MyLanguage/Release and support cycle|release and support cycle]] page.</translate>{{-}}
<div class="no-external-icon"><span style="line-height:2.2em;font-size:1.3em;"><translate>

[https://downloads.joomla.org Download Joomla!]</translate>{{-}}<div class="fa fa-download fa-2x" style="color:#142849;"></div></span></div>{{-}}
</div>


<div class="large-6 small-12 column">
<div class="large-12 small-12 column text-center">
<div class="main-page-icon green-bkgd"><div class="fa fa-tasks fa-3x"></div>
<span class="icon-text">
<translate>

'''Tasks'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-cogs fa-lg icon" style="color:#5290C8;"></div> <translate>
[[S:MyLanguage/J4.x:Global_Configuration|Configuring Your Installation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-lock fa-lg icon" style="color:#E6462B;"></div> <translate>

[[S:MyLanguage/Security_Checklist|Secure Your Website]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-search-plus fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/Portal:Search Engine Optimisation|Search Engine Optimisation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#aaa;"></div> <translate>

[[S:MyLanguage/User Management|Managing Your Users]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-info-circle fa-lg icon" style="color:#F5A443;"></div> <translate>

[[S:MyLanguage/Portal:Template_Management|Managing Templates]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-newspaper-o fa-lg icon" style="color:#555;"></div> <translate>

[[S:MyLanguage/Article_Management|Content Management]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bars fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/Menu_Management|Menu Management]]</translate></span>{{-}}
</div>
</div>
</div>

<div class="large-6 small-12 column text-center">
<div class="large-12 small-12 column">
<div class="main-page-icon orange-bkgd"><div class="fa fa-users fa-3x"></div>
<span class="icon-text"><translate>

'''Contribute'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<div id="main-page-list" class="text-left">
<span class="main-page-text"><div class="fa fa-pencil-square-o fa-lg icon" style="color:#7DB847;"></div> <translate>

[[S:MyLanguage/JDOC:How_to_Contribute_to_Joomla!_Documentation|Help with Documentation]]</translate></span>{{-}}
<span style="color:#7DB847;line-height:2.2em;font-size:1.1em;"><div class="fa fa-language fa-lg icon" style="color:#333;"></div> <translate>

[[S:MyLanguage/JDOC:Documentation_Translators|Translate Documentation]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-bug fa-lg icon" style="color:#E6462B;"></div> <translate>

Join the [[S:MyLanguage/Portal:Bug Squad|Bug Squad]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-file-code-o fa-lg icon" style="color:#F5A443;"></div> <translate>

Be a [[S:MyLanguage/Portal:Joomla!_Code_Contributors|Core Code Contributor]]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-user-plus fa-lg icon" style="color:#555;"></div> <translate>

Join a [[S:MyLanguage/Portal:Joomla_User_Groups|Joomla User Group]]</translate></span>{{-}}
<span class="main-page-text no-external-icon"><div class="fa fa-life-ring fa-lg icon" style="color:#E6462B;"></div> <translate>

Help on a [http://volunteers.joomla.org Joomla! Team]</translate></span>{{-}}
<span class="main-page-text"><div class="fa fa-joomla fa-lg icon" style="color:#5091CD;"></div>
[[S:MyLanguage/Joomla:Brand Identity Elements|<translate>
Brand Identity Elements</translate>]]</span>{{-}}
<span class="main-page-text"><div class="fa fa-users fa-lg icon" style="color:#F9A541;"></div>
[[S:MyLanguage/Category:Marketing materials|<translate>
Marketing Resources</translate>]]</span>{{-}}
</div>
</div>
</div>
{{-}}
<div class="large-12 small-12 column text-center">
<div class="main-page-icon dark-grey-bkgd"><div class="fa fa-list-alt fa-3x"></div>
<span class="icon-text"><translate>

'''Projects'''</translate></span>
</div>
</div>
<div class="large-12 small-12 column text-center">
<span class="icon-text"><translate>

'''[[S:MyLanguage/JDOC:Projects|Find a JDOC Project]]'''</translate></span>{{-}}
<translate>

Here are a few in need of contributors.</translate>{{-}}
<translate>

'''[[S:MyLanguage/Help screens|Help Screens Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Beginners Tutorial Project|Beginners Tutorial Project]]'''</translate>{{-}}
<translate>

'''[[S:MyLanguage/JDOC:Developer Tutorials Project|Developer Tutorials Project]]'''</translate>{{-}}
<translate> '''[[S:MyLanguage/JDOC:Joomla 4 Tutorials Project|Joomla 4 Tutorials Project]]'''</translate>{{-}}
</div>
{{-}}
{{license/<translate>
en</translate>}}
__NOTOC__ __NOEDITSECTION__

Creating a Database for Joomla!

2025-01-13T16:47:03Z

Max123kl: Marked this version for translation

<noinclude><languages /></noinclude>
<translate> Every installation of the Joomla! CMS requires a database. The database will store data such as articles, menus, categories, and users. This information is needed to make and manage your Joomla! website. Regardless of the [[Technical requirements|requirements of the version]], in order to install Joomla! you must have a working database, database user, database password and proper privileges for the database user.</translate>
<translate> You will need to complete these tasks before you begin the installation. This article will address the most common type of database used when [[Installing Joomla!]], a MySQL database. First, we show using [[wp:cPanel|cPanel]] on a hosting account, other types of hosting interfaces should have similar steps. Then we show the same using phpMyAdmin on a localhost XAMPP setup</translate>

<translate>
==MySQL DB Wizard== </translate>
<translate>

For beginners, it is recommended that the MySQL Database Wizard is used. The wizard will guide you step by step through the process. You may use these steps to guide you through your own hosting account panel if it differs, they are:</translate>
<translate> :{{rarr|Create a Database, Create a User, Set User password, Set User Privileges}}. </translate>

<translate> First, activate the wizard by clicking the icon in your hosting account's cPanel.</translate>

[[File:cPanel-database-wizard-icon-<translate> en</translate>.png]]

<translate>
===Creating a Database=== </translate>
<translate>

Next, you must choose a name for your database. In a shared hosting environment, your database name is usually proceeded by your hosting account's username, then an ID you specify. For example, if your hosting account's username is ''B1234'', your database name could look similar to this: ''B1234_joomla''.</translate>

[[File:cPanel-create-MySQL-database-<translate> en</translate>.png]]

<translate>
===Creating a Database User and User password=== </translate>
<translate>

Once you have created a database, you now need a ''database user'' to access it. This step will create a user and the user's password at the same time. The Username for a database will be similar to the database name. You can actually use the name of the database for the user, but for security, use a unique Username with a strong password.</translate>

[[File:cPanel-create-MySQL-user-<translate> en</translate>.png]]

<translate>
===Set the User Privileges=== </translate>
<translate>

The last database creation task is to give your database user privileges (permissions) to interact with your database. These privileges give your user the ability to create database tables, drop (delete) them, alter, index and other interactive tasks.</translate>

[[File:cPanel-set-MySQL-user-privileges.png]]
<translate>

* ''If you are not using the database creation wizard. Privileges are usually included in the assignment of a database user to a database. This work flow is {{rarr|Create db,Create db User,Assign a db User to a db (including privileges)}}.''</translate>

<translate>
===Finishing Up=== </translate>
<translate>

After you complete all the steps of the database wizard, you will see the summary of the final results.</translate>

[[File:cPanel-MySQL-database-wizard-finished.png]]
<translate>

* Write down the following information for use in your Joomla! installation.</translate>
<translate>

:* Database name, example: ''D1234_joomla''</translate>
<translate> :* Database user, example: ''D1234_juser''</translate>
<translate> :* Database user's password</translate>
<translate> :* Note the location of the database. Usually, ''Localhost'' for a cPanel installation. Occasionally, a hosting account may have a database server completely separate from a user account's server for physical files. Instead of ''Localhost'' the database server may actually be a URL type of address, ''dbserver10.hosting.com''.</translate>

<translate>
==MariaDB using phpMyAdmin XAMPP on Localhost== </translate>
<translate> Start by opening your XAMPP Control Panel and seeing that it works by going to http://localhost/. You should see the XAMPP welcome page with PHPInfo and phpMyAdmin in the top menu.</translate>
<translate>

Next, we want to make our root user secure with a password. This can be done in your XAMPP console by opening the Shell and
entering:
''mysqladmin.exe -u root password secretpassword''


This will set the root to use a password. Choose your own and not ''secretpassword''. Make a note of it.</translate>

[[File:Add password.png]]

<translate>

Now your phpMyAdmin will break so we need to fix that.</translate>

<translate>

Navigate to your ''config.inc.php'' file which is most likely at:</translate>

''C:\xampp\phpMyAdmin\config.inc.php''

<translate> On line 21: </translate>

''$cfg['Servers'][$i]['password'] = ' ';''

<translate> You need to add your password. In our example it will look like:</translate>

''$cfg['Servers'][$i]['password'] = 'secretpassword';''

<translate> Now our phpMyAdmin should work. We can use it to create a new user</translate>

<translate>
===Create a New Database User with phpMyAdmin XAMPP on Localhost=== </translate>

<translate>
Open phpMyAdmin from the link in the top menu of the XAMPP welcome page and select User accounts in the top menu.
Here you will see a page listing the users. Select the ''Add user account'' link which is just under the ''New'' label.</translate>

<translate> You will be asked for a Username and password and to retype the password. For development on your localhost, in Global privileges, check the ''All'' box. Select ''Go'' in the bottom right corner.</translate>

<translate>
===Create a New Database using phpMyAdmin XAMPP on Localhost=== </translate>

<translate>

Now that you have your user, create a new database to add your tables to or allow Joomla to create it for you in the installation process. If you want to name your own then click the Databases tab.</translate>
<translate>
Fill in the name you would like to use spacing words with underscores. If you want "my database" enter ''my_database''.
Select ''utf8_unicode_ci'' and hit ''Create''.</translate>

<translate>

You now have a database, a user and a password and are all set to install Joomla!</translate>

<noinclude>
[[Category:Beginners{{#translation:}}]]
[[Category:Server configurations{{#translation:}}]]
[[Category:Installation{{#translation:}}]]
</noinclude>

Bug Squad/Contacts/de

2025-01-07T12:16:38Z

Max123kl:

<noinclude><languages /></noinclude>

;Joomla! Bug Squad Teamleiter
[mailto:martin.kopp@community.joomla.org Martin Kopp]
;Werden Sie Mitglied im Bug Squad Team
:[mailto:bugsquad@community.joomla.org Bug Squad]

<noinclude>
[[Category:Landing subpages/de|Landing subpages]]
</noinclude>

Translations:Bug Squad/Contacts/2/de

2025-01-07T12:16:32Z

Max123kl:

Werden Sie Mitglied im Bug Squad Team

Bug Squad/Contacts/de

2025-01-07T12:15:20Z

Max123kl:

<noinclude><languages /></noinclude>

;Joomla! Bug Squad Teamleiter
[mailto:martin.kopp@community.joomla.org Martin Kopp]
;Wenn Sie Mitglied im Bug Squad werden wollen:
:[mailto:bugsquad@community.joomla.org Bug Squad]

<noinclude>
[[Category:Landing subpages/de|Landing subpages]]
</noinclude>

Translations:Bug Squad/Contacts/2/de

2025-01-07T12:15:10Z

Max123kl:

Wenn Sie Mitglied im Bug Squad werden wollen:

Bug Squad/Contacts/de

2025-01-07T12:10:33Z

Max123kl:

<noinclude><languages /></noinclude>

;Joomla! Bug Squad Teamleiter
[mailto:martin.kopp@community.joomla.org Martin Kopp]
;Anfrage zum Bug Squad-Beitritt
:[mailto:bugsquad@community.joomla.org Bug Squad]

<noinclude>
[[Category:Landing subpages/de|Landing subpages]]
</noinclude>

Translations:Bug Squad/Contacts/1/de

2025-01-07T12:10:32Z

Max123kl:

Joomla! Bug Squad Teamleiter

Bug Squad/Contacts

2025-01-07T12:01:35Z

Max123kl: fixed

<noinclude><languages /></noinclude>

;<translate>
Joomla! Bug Squad Team Leader</translate>
[mailto:martin.kopp@community.joomla.org Martin Kopp]
;<translate>
To request to join the Bug Squad</translate>
:[mailto:bugsquad@community.joomla.org Bug Squad]

<noinclude>
<translate>

[[Category:Landing subpages|Landing subpages]]
</translate>
</noinclude>

Tutorials:Beginners

2025-01-04T19:47:44Z

Max123kl: link fixed

<noinclude><languages /></noinclude>

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

<translate>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

===More=== 


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


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


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

J4.x:Getting Started with Joomla!

2025-01-04T19:11:20Z

Max123kl: version icons added

<noinclude><languages /></noinclude>
{{version|4.x,5.x}}

<translate>
==Introduction== 
</translate>
<translate>

Joomla! is one of the most popular, free and open-source content management systems (CMS) available for publishing web content. It is user friendly, extendable, multilingual, accessible, responsive, search engine optimised and so much more. '''Joomla! 4''' is the current version, released in August 2021.
</translate>
<translate>


Joomla! must be installed on a web server, either on your own computer for private testing purposes or a hosting service to make your content available to the rest of the world.


There are thousands of free and commercial Joomla! extensions available from third parties for all sorts of special purposes. However, Joomla! comes with enough '''core''' extensions to allow you to create a fully functional web site. It is best to familiarise yourself with the core Joomla capabilities before looking for third party extensions.
</translate>
<translate>

==Understanding Joomla!== 
</translate>
<translate>
If you're having trouble visualizing how Joomla! works, it might be useful for you to think of Joomla! as an Operating System (OS), like Microsoft Windows, Apple Mac OS or Linux. The most important similarity is that your OS uses '''Applications''' and Joomla! uses '''Extensions''' to do something useful. </translate>

<translate>
Further similarities and differences can be found in the following table.</translate>
<translate>

===Comparison Table=== 
</translate>
{| class="wikitable"
! <translate>
Joomla! concept</translate>
! <translate>
Operating System concept</translate>
|-
| [[S:MyLanguage/Extension|<translate>
Extension</translate>]] || <translate>
Added Application (e.g. Word, Chrome, Music Player, Photoshop)</translate>
|-
| <translate>
Core extensions</translate> || <translate>
Built-in applications (e.g. Start button, Screen Saver, File Search)</translate>
|-
| <translate>
Database</translate> || <translate>
File system (one type of Files)</translate>
|-
| <translate>
File system</translate> || <translate>
File system (another type of Files)</translate>
|-
| <translate>
Viewing a page</translate> || <translate>
Using an application (Added or Built-in)</translate>
|-
| <translate>
Updating Joomla!</translate> || <translate>
Installing updates for your OS (Security patches and bug fixes)</translate>
|-
| <translate>
Migrating between Joomla! versions</translate> || <translate>
Installing a new version of your OS, for example moving from MS Windows 7 to MS Windows 10.</translate>
|}
<translate>

== What You Will Need == 
</translate>
<translate>

=== A Hosting Environment === </translate>
<translate>

* '''On your own laptop or desktop.''' Install a WAMP or XAMP or LAMP stack. This looks daunting but is usually very easy and may be installed already along with your operating system. The W stands for Windows, the X for Mac OS X and L for Linux, your OS software; the A stands for Apache, the web server software; the M stands for MySQL (or MariaDB), the database software; the P for PHP, a widely use web scripting language. You should also install phpMyAdmin to create a Database and Database User. </translate>
<translate>

** Check whether your OS provides the appropriate stack. If it does, check that it is installed or install it. If not, search the web for a download site. All of this software is free! You should not need to pay or provide any personal details.
** If stuck, try [https://www.apachefriends.org/index.html XAMPP] which is a free package used to install and manage all of the required components, except Joomla. It works on all platforms. WAMP is restricted to Windows.</translate>
<translate>

* '''On a Hosting Service.''' Almost all will provide the necessary environment. However, the cheapest may have over-restrictive php.ini settings so it is best to check the recommended settings in the Installing Joomla tutorial with what a proposed hosting service provides.</translate>
<translate>

===An Installed Copy of Joomla!=== 
</translate>
<translate>

This is described in more details in the Installing Joomla! tutorial.</translate>
<translate>

* '''Download''' the latest version of Joomla to your local computer from the [https://www.joomla.org Joomla] site. </translate>
<translate>

* '''Move or copy''' it to the root of your web site, uncompress it and give the folder a short name. </translate>
<translate>

* '''Install''' Joomla!.
</translate>
<translate>

**Installing with Sample Data allows you to to explore a Joomla! site before you have created one for your own content. </translate>
<translate>

====Alternatives==== 
</translate>
<translate>
* '''Use a Demo Installation'''. Many hosting services or script installer sites offer 'demo' versions of a Joomla! installation. You will at least be able to make changes, but they will not be permanent. 'Demo installations' are reset back to a 'fresh' installation state at regular intervals.</translate>
<translate>
* '''One-click Installation'''. Many hosting services offer a one-click installation of popular web site programs.</translate>
<translate>

Alternatives are likely to come with their own problems and are probably best avoided!</translate>
<translate>

=== Upgrading an Existing Site === </translate>
<translate>

If you have inherited an existing site you may need to follow the [[J4.x:Updating_from_an_existing_version|Upgrading from an Existing Version]] tutorial.</translate>

<translate>

== Getting Started Tutorials == 
</translate>
<translate>

* [[S:MyLanguage/J4.x:Hosting_Setup|Hosting Setup]]
* [[S:MyLanguage/J4.x:Installing_Joomla|Installing Joomla]]
* [[S:MyLanguage/J4.x:Logging_in_to_Joomla|Logging in to Joomla]]
* [[S:MyLanguage/J4.x:Articles_and_categories|Articles and Categories]]
* [[S:MyLanguage/J4.x:Getting_Started:_Adding_an_Article|Adding an Article]]
* [[S:MyLanguage/J4.x:Getting_Started:_Adding_a_Category|Adding a Category]]
* [[S:MyLanguage/J4.x:Getting_Started:_Adding_a_Menu_Item|Adding a Menu Item]]
* [[S:MyLanguage/J4.x:Getting_Started:_Adding_a_Module|Adding a Module]]
* [[S:MyLanguage/J4.x:Getting_Started:_Site_and_Administrator_templates|Site and Administrator Templates]]
</translate>
<translate>

===Summing it all up=== 
</translate>
<translate>
*Articles are the main type of web site content.</translate>
<translate>
*Categories create an organisational hierarchy to control web site content.</translate>
<translate>
*Menus provide a navigational method to use or browse the web site content (pages).</translate>
<translate>
*Modules provide a means to combine web site content (Articles) with other information.</translate>
<translate>
*Templates control the look of a Joomla! web site.</translate>

{{-}}
<noinclude>
[[Category:Beginners{{#translation:}}]]
[[Category:Joomla!_4.x{{#translation:}}]]
[[Category:Joomla!_5.x{{#translation:}}]]
</noinclude>

User talk:Martin Kopp

2024-11-28T07:27:36Z

Max123kl: welcome

{{New User welcome}} [[User:Max123kl|Max123kl]] ([[User talk:Max123kl|talk]]) 07:27, 28 November 2024 (UTC)

=== Translations ===
{{Translator welcome}} [[User:Max123kl|Max123kl]] ([[User talk:Max123kl|talk]]) 07:27, 28 November 2024 (UTC)

User talk:BernardoOlson2

2024-11-20T18:36:08Z

Max123kl: welcome

{{New User welcome}} [[User:Max123kl|Max123kl]] ([[User talk:Max123kl|talk]]) 18:36, 20 November 2024 (UTC)