Joomla! Documentation™

Die Testing Joomla! patches Seite beschreibt die Prozedur wie man die Patches testen kann. Dieses Dokument ist die Kurzübersicht mit allen nötigen Schritten.

Joomla Issue Tracker

• http://issues.joomla.org
• Mit dem Github account einloggen (falls Sie noch keinen Account haben, gehen Sie auf https://github.com und richten Sie einen kostenlosen Account ein)
• Statusmeldungen sind: New > Confirmed > Pending > Ready to commit(RTC) > Closed
  • New - gerade gemeldet
  • Confirmed - jemand reproduziert & bestätigte den Fehler
  • Pending - Pending - Es gibt ein Patch (“PR” - pull request);, zwei erfolgreiche Tests sind nötig
  • Ready To Commit - Kann zum Joomla Quelltext hinzugefügt werden
  • Needs Review - Ein erfahrener Entwickler ist nötig um den Patch zu überprüfen.
  • Informationen Erforderlich - Es werden mehr Informationen von der Person benötigt, die das Problem gemeldet hat

Testing Bugs, Reports, Patches

• Have working local web server environment (XAMPP, MAMP ect)
• Get Joomla “staging” from: https://github.com/joomla/joomla-cms
  • Download, unzip to folder
  • or: git clone https://github.com/joomla/joomla-cms.git
• Install Joomla at local web server
  • Install with: Test English (GB) sample data
  • Do not remove /installation/ folder!
• Joomla Patch Tester Component
  • Download from: https://github.com/joomla-extensions/patchtester/releases
  • Installation via Extensions > Install
  • Add your own Github account details under Options (Username + Password)
• Testing found issues
  • Find issue in Joomla Issue Tracker (useful filters: status, category, tests, easy)
  • Reproduce bug (can't reproduce bug? → report)
  • Install Patch in Joomla Patch Tester Component. patch: [#ID of patch – Some descriptive title for problem/patch]
  • Test if bug is solved & report findings (use @test for successful test)
  • Remove Patch (“revert patch”)

Fehler melden

• Suchen Sie im “Issue Tracker” ob das Problem schon gemeldet wurde
• Erstellen Sie eine neues Problem [New Item]
  • Benutzen Sie einen gut beschreibenden Titel
  • Beschreibung:
    • Schritte um den Fehler zu reproduzieren
    • Das erwartete Resultat und das jetzige Resultat
    • Systeminformationen (so viele wie möglich), z.B. die PHP-Version und die Browserversion
    • Zusätzliche Kommentare
  • Die Priorität ist standardmäßig: Medium
  • Version ist im Moment 3.4.x
  • Kategorieangabe: wählen Sie die am besten geeignete Kategorie

Patch erstellen

Patch = Text Datei die Änderungen am Quellcode beschreibt

Methods:

• Use IDE (like Netbeans, PHPStorm)
  • Improve Joomla code in editor & create .diff patch
• Use Github: https://github.com/joomla/joomla-cms
  • Navigate to page with code
  • Click “pencil” icon: “Clicking this button will fork this project so you can edit the file”
  • Add improvements:
    • Make changes in code under “Edit file”
    • Add Commit Summary under Propose file change (50 char or less)
    • Use optional extended description (in case 50 char was not enough)
  • Save & choose Pull Request
• Use Command line “git” (for experienced users)

More information

• Component Patchtester: Component Patchtester for Testers
• Testing Joomla! patches: Testing Joomla! patches
• Testing Checklist: Testing Checklists
• Filing bugs and issues: Filing bugs and issues
• Bug Squad: Bug Squad
• Bug Tracking Process: Bug Tracking Process