Joomla! Patches testen - Eine Kurzanleitung

From Joomla! Documentation

Revision as of 16:47, 15 March 2015 by Joomla-agency (talk | contribs) (Created page with "=== 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 S...")

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
  • Install Joomla at local web server
    • Install with: Test English (GB) sample data
    • Do not remove /installation/ folder!
  • Joomla Patch Tester Component
  • 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”)


Report Bug

  • Search in Issue Tracker if issue has been reported already
  • Create new item [New Item]
    • Title: use descriptive title!
    • Description:
      • Steps to reproduce the issue
      • Expected result & actual result
      • System information (as much as possible). e.g. your PHP information, browser + version
      • Additional comments
    • Priority: default: Medium
    • Build: 3.4.x-dev (at this moment)
    • Categories: select the most appropriate categories


Create Patch

Patch = text file that describes changes in source code.

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