Joomla! Documentation™

Das diesjährige Joomla! Pizza Bug and Fun (PBF)-Event findet am 17. Oktober 2020 statt und wird Teilnehmer aus der ganzen Welt anziehen. Dieses Wiki wird als zentrale Ressource für die Koordinierung der Aktivitäten und die Zusammenstellung der Ergebnisse dieser Veranstaltung genutzt werden. Weitere Informationen über die Veranstaltung unter pizza-bugs-fun.com einschließlich des Angebots von PBF-Produkten!

Willkommen

Ziele

Egal ob man ein Neuling, Anfänger oder Profi, Grafikdesigner oder Programmierer ist, ob man eine Agentur oder Vereinsseite hat, ob man weiblich oder männlich, jung oder alt ist, Pizza Bugs and Fun ist für alle. Die Veranstaltung ist für diejenigen, die bereits mit Joomla! arbeiten oder Joomla! zuerst kennenlernen möchten. Nur das Interesse an Joomla! zählt. Jeder ist willkommen. Am 17. Oktober 2020 möchten wir alle Joomla-begeisterten Benutzer unabhängig von euren Vorkenntnissen einladen, Joomla! noch besser zu machen. Wir sind für jede Unterstützung dankbar! Die Teilnahme ist kostenlos und obwohl alkoholfreie Getränke und Pizza dank der Sponsoren der Veranstaltung normalerweise inbegriffen sind, werden wir dank COVID-19 stattdessen virtuell gehen. Die Aufgaben für den Tag sind in Kategorien und einer Reihe von Qualifikationsniveaus gruppiert, somit kann man auf unterschiedlichen Ebenen beitragen:

• Joomla 4: Joomla 4.0 kommt bald, hat aber noch viele Bugs und Feature-Anfragen, die ungetestet sind oder zusätzlichen Code benötigen. Das bedeutet, sie können nicht dem Joomla-Kern hinzugefügt werden. Die Joomla 4-Dokumentation benötigt ebenfalls viel Arbeit.
• Patch-Testing: Als Hauptregel gilt, dass neue Funktionen für Joomla getestet werden müssen, bevor sie in eine offizielle Version eingebunden werden können. Normalerweise dauert es nur ein paar Minuten um zu helfen, Joomla besser zu machen.
• Dokumentation: Es gibt viele Dokumente, die geschrieben oder gewartet werden müssen. Tutorials und Hilfeseiten werden für Joomla! 4 benötigt.
• Dokumentation Übersetzung: Bei der PBF-Veranstaltung hoffen wir, viele englische Dokumente in andere Sprachen zu übersetzen, um Joomla!-Benutzern so viele Informationen wie möglich in ihrer Sprache zu geben.
• Sprachpakete: Bei Crowdin anmelden, das Joomla! für Lokalisierung und Übersetzung verwendet. Von dort aus kann man mit der Übersetzung von Joomla in eine lokale Sprache beginnen. Joomla 4-Sprachpakete stehen auf Crowdin zur Übersetzung bereit und benötigen Hilfe, um die Fertigstellung in Vorbereitung auf die Veröffentlichung von Joomla 4 zu beschleunigen.

Häufige Fragen

Wenn man nicht findet, was man sucht, sind hier einige FAQs:

F: Wo kann ich mich anmelden, wenn ich beitreten möchte?
A: Such nach einer Joomla User Group und kontaktiere sie, um zu erfahren, ob sie gerade etwas tun. Du kannst auch unter nachlesen, wie man eine eigene Joomla-Benutzergruppe (JUG) gründet, in Deiner Nähe suchen oder eine E-Mail an das Team schreiben [1].

F: Ich kann nicht an einen Ort gehen - kann ich mich online anmelden?
A: Ja! Man braucht nur einen Computer und einen Internetanschluss, aber leider muss man selbst bestellen oder man macht seine eigene Pizza.

F: Ich habe es verpasst! Kann ich noch helfen?
A: Sicher kann man das! Seit April dieses Jahres, an jedem Samstag, an dem die restliche Welt weitgehend abgeriegelt ist, veranstalten wir Bugs & Fun @Home (BF@H). Freiwillige nehmen teil, wenn sie die in der obigen Liste aufgeführten Aufgaben erledigen wollen. Das wird auch in Zukunft so bleiben, also auf der BF@H-Seite nach Details schauen.

F: Wie kann ich mich stärker einbringen?
A: Joomla verfügt über qualifizierte Unterstützer für ein breites Spektrum von Funktionen. Auf das Volunteers-Portal, insbesondere die Help Wanted Seite schauen um zu erfahren, wie man helfen kann. Oder ein Gespräch während des PBF oder an einem Wochenende während BF@H beginnen.

Organisation, Logistik und Kommunikation

PBF-Events werden von lokalen Joomla! User Groups (JUGs) organisiert. 2020 ist ein bisschen anders, da wir es virtuell durchführen. Aber für zukünftige Jahre würden wir uns freuen, wenn mehr Gruppen an Bord kämen, um daran teilzunehmen.

Falls man teilnehmen möchte aber keine Anwendergruppe in der Nähe hat oder man eine Anwendergruppe ist und teilnehmen möchte ist es dieses Jahr einfacher denn je, das online zu tun! Es gibt ein paar Voraussetzungen:

• Man benötig einen Raum mit WiFi-Zugang.
• Man braucht einige mit einem Laptop und Motivation ausgestattete Joomler.
• Zögert nicht, eine E-Mail an [email protected] zu senden oder das Team unter Glip zu kontaktieren.

Natürlich kann man auch von Zuhause aus teilnehmen, aber wo bleibt der Spaß ohne Community und Pizza?

Soziale Medien

Bei Joomla! dreht sich alles um die Community. Wenn du also an PBF teilnimmst, erzähle uns und der Welt davon.

• Zum Austausch von Informationen in sozialen Medien nutze bitte die Hashtags #pbf20 #joomla
• Verwende auch Tags für Dinge, an denen du gerade arbeitest: #joomla4 #joomladocs #joomlatranslation #a11y #l10n

Social Media Grafiken

Mit einem Rechtsklick auf die Bilder und "Grafik speichern als" können Bilder auf den Computer heruntergeladen und in Sozialen Medien verwendet werden.

• 

  Facebook 1200x628
• 

  Instagram 1024x1024
• 

  Instagram Transparent Overlay 1024x1024
• 

  PBF Bug Transparent Overlay

Die Overlay-Bilder sind transparente PNG-Dateien, die in anderen Programmen verwenden werden können, um den PBF-Bug zu Fotos hinzuzufügen und für die Veranstaltung zu werben.

Orte

Das lokale PBF-Engagement in die Liste unten einfügen (dazu braucht es ein JDOCs-Konto. Aber da man während der PBF einen Beitrag zu JDOCS leistet ist das etwas, was man bald haben wird, falls es nicht bereits geschehen ist!).

In diesem Jahr ist alles anders: COVID-19 erlaubt uns keine persönlichen Treffen oder wenn, dann unter sehr erschwerten Bedingungen. Deshalb haben wir uns entschlossen, die Bedingungen so zu gestalten dass sich jeder online beteiligen kann. Bitte berücksichtigen, für den Anmeldevorgang ist eine gültige E-Mail-Adresse erforderlich. Das Konto wird durch eine Bestätigungs-E-Mail an diese Adresse verifiziert.

Ozeanien und Australien

• Australien - West End, Brisbane - Persönliche Treffen
• Australien - Andere Regionen - nur online

Weitere Informationen zur Teilnahme an Australiens PBF 2020.

Registrierung

Schreibrechte im Wiki

Um Schreibzugriff auf dieses Wiki zu erhalten, muss man sich registrieren oder zuerst hier einloggen (siehe auch die Seite Wie man die Joomla!-Dokumentation unterstützt) für weitere Details über die ersten Schritte, um zur Joomla-Dokumentation beizutragen.

Bitte berücksichtigen, für den Anmeldevorgang ist eine gültige E-Mail-Adresse erforderlich. Das Konto wird durch eine Bestätigungs-E-Mail an diese Adresse verifiziert.

Vor Ort

Falls man an einem der oben aufgeführten realen Orte anwesend sein möchte, muss man sich im Voraus anmelden, da der Platz möglicherweise begrenzt ist. Die Anmeldungen liegen in der Verantwortung der Organisatoren der einzelnen Veranstaltungsorte. Für weitere Informationen oben auf den entsprechenden Link klicken.

Bugs, Aufgaben und Pizza

In diesem Jahr liefert PBF die Pizza nicht, also bestellt eine eigene Pizza in der Lieblingspizzeria. Wir haben ein Video über die Zubereitung der eigenen Pizza zusammengestellt.

Teilnahmevoraussetzungen & Bedingungen

Pizza, Bugs & Fun ist eine Veranstaltung die dazu beitragen soll, Joomla's Mission, Vision & Werte zu erfüllen. Zur Joomla!-Community beitragen setzt die Akzeptanz der im Joomla! Verhaltenskodex dargelegten Prinzipien voraus.

• Der Quellcode muss unter der General Public Licence version 2 verfügbar sein.
• Alle Dokumentationsbeiträge müssen unter der Joomla! Elektronische Dokumentation Lizenz zur Verfügung gestellt werden. Weitere Informationen zur JEDL sind in der JEDL Frequently Asked Questions verfügbar.
• Werbung oder Eigenwerbung sind nicht erlaubt. Dies gilt auch für Backlinks zur eigenen oder anderen Webseiten. Als einzige Ausnahme, falls man einen Beitrag geleistet hat, kann seinen Namen und einen optionalen Link auf seine Website zur Liste der Mitwirkenden hinzufügen.
• Alle Beiträge müssen in englischer Sprache verfasst werden. Offizielle Sprache des Joomla-Projekts sind britisches/australisches Englisch.

Kommunikationstools

So arbeitet man im Teamwork heute ;-) Überprüfen der Ortszeit im Vergleich zur UTC.

Glip - PBF20-Kanal

Im Glip/RingCentral-Chatroom können Fragen gestellt und Ideen ausgetauscht werden. Glip und GitHub Wenn zum Beispiel weitere Erläuterungen für einen Patch-Test benötigt werden.

Video-Chat

Man kann dem PBF20-Video-Chat während des Wochenendes von 22:00UTC Freitagnacht (wenn Australien PBF20 startet) bis ~08:00UTC Sonntagmorgen (wenn die Samstagnacht der Westküste der USA endet) beitreten.

Der PBF20 Video-Chat verwendet BigBlueButton. Man kann deren Tutorials ansehen, um zu verstehen, wie man die Funktionen der BigBlueButton-Plattform nutzt.

Google Meet - Ausweichlösung

Für den Fall von Problemen, auf Glip oder den PBF-Video-Chat zu gelangen, haben wir auch das Bugs & Fun @Home Google Meet ab 22:00UTC als Ausweichlösung eingerichtet.

Vorbereitungen und Installationen

Zu verwendende Werkzeuge

Es gibt weitere Werkzeuge, um sich als Bug-Tester oder am Joomla-Projekt insgesamt zu beteiligen. Folgende Links führen zu Seiten über JDOCs, die den Einstieg erleichtern.

• RingCentral (Glip) ist das vom Joomla-Projekt verwendete Kommunikationswerkzeug. Nachdem man RingCentral hinzugefügt wurde den PBF20-Kanal suchen, um an der Konversation teilzunehmen.
• GitHub ist das Werkzeug, das Joomla zur Codepflege für das CMS verwendet. Eine Anmeldung bei GitHub ermöglicht außerdem die Verwendung des Joomla Issues Tracker.
• Joomla!-Dokumentation Hier werden alle Joomla-Hilfedokumente erstellt und verwaltet. Um bei der Dokumentation zu helfen, dort ein Benutzerkonto erstellen und dann die Joomla-Hilfe verbessern.
• Crowdin ist das Werkzeug für Übersetzungen, in dem alle offiziellen Sprachpakete von Joomla verwaltet werden. Wer dort ein Benutzerkonto erstellt kann zu Übersetzungen in die eigene Sprache beitragen.

Schulungsvideos ansehen

Das Schulungsvideo zeigt einige oben genannten Werkzeuge und wie Aufgaben für PBF20 erledigt werden können.

Einrichten der Joomla!-Installation

Erforderlich, wenn man Patches testen möchte. Es gibt zwei Möglichkeiten für eine Joomla!-Installation bei PBF:

• Zugriff auf eine der vorinstallierten Joomla 4 Installationen hier.
  • Server sind in Großbritannien, USA, Deutschland und Spanien verfügbar.
  • Für eine Instanz zum Testen auf die Domain des Servers klicken, einloggen und das Passwort ändern, um die Instanz zu übernehmen.
  • Nach Ändern des Passworts für die Instanz den vorinstallierten Patch-Tester einrichten und mit dem Testen zu beginnen.
  • Eine Nachricht im PBF20 Glip oder in einem der Video-Chats hinterlassen, um zu berichten, welche Instanz übergenommen wurde, damit andere sehen können, was als Nächstes verfügbar ist.
  • Kein Zugriff auf die Instanz, die gerade ausprobiert wird? Sobald das Passwort geändert wurde, wird diese Instanz übernommen, also weiter versuchen, bis man in die Instanz gelangt. Den PBF20 Glip-Kanal verfolgen um zu erfahren, was die nächste verfügbare Instanz sein könnte.
• Eine lokale Installation auf dem Computer einrichten. Es gibt eine Reihe von Alternativen, die man sich bei der Installation ansehen kann. Diesen Artikel aus dem Joomla-Magazin für eine Anleitung zur Installation einer Umgebung mit XAMPP sowie zur Konfiguration des Joomla Patch-Testers und von Joomla 4 lesen.

Auf der Bugs & Fun @Home-Seite gibt es weitere Links für Ressourcen zum Testen von Patches und Einrichten der Testumgebung.

300 PBF Joomla-Instanzen dank IONOS

Aufgabenlisten

Um sich auf das, was getan werden muss, konzentrieren zu können:

• Explorer - Geeignet für Anfänger. Deckt Dokumentations- und Übersetzungsaufgaben ab.
  Die Liste der Wartungsarbeiten enthält viele andere Punkte, falls man unsicher ist, mit der Explorer-Liste anzufangen.
• Adventurer - Deckt Patch-Tests von Pull-Anfragen für Joomla ab.
  Es kommen während der Veranstaltung neue PR's hinzu, weil Code zur Problemlösung erstellt wird. Im Laufe des Tages die Liste der Pull Requests kontrollieren, ob es Neues zu Testen gibt.
• Conquerer - Fortgeschrittene Aufgaben - Das sind Fragen, die zur Lösung Code, Überlegung und Konversation erfordern.
  Wer zusätzlich zur Conqueror-Liste nach einem zu lösenden Problem sucht, die GitHub Issues-Liste hat noch viele andere Problemstellungen, die nach Freiwilligen für Lösungen verlangen…

Joomla Dokumentation

JDoc Beiträge

Wer Patches nicht testen, aber trotzdem der Community etwas zurückgeben und sie unterstützen möchte, hilft die JDocs für Joomla! 4 zu schreiben.

Hier findet man alle Informationen, die man zum Loslegen braucht. Bitte lesen:

• Ein JDoc-Konto erstellen - Wie man die Joomla!-Dokumentation unterstützt
• Die Nutzungsbedingungen lesen
• JDoc Cheatsheet JDoc Wiki Formatierungscodes

JDocs Übersetzungen

Wer Patches nicht testen, aber trotzdem der Community etwas zurückgeben und sie unterstützen möchte, hilft die JDocs für Joomla! 4 zu übersetzen.

Hier findet man alle Informationen, die man zum Loslegen braucht. Bitte lesen: Wie man die Joomla!-Dokumentation unterstützt.

Ein Danke an die PBF20-Teilnehmer

Wer zu PBF20 beigetragen hat, kann seinen Namen festhalten: Liste der Mitwirkenden

Zugehörige Informationen

• Website des Veranstalters pizza-bugs-fun.com
• Joomla (und damit PBF20) ist bei der Hacktoberfest-Veranstaltung registriert. Vier erstellte Pull Requests im Oktober können mit einem Tee oder Baum belohnt werden. Mehr Informationen auf der Webseite.