A patch is a change to the programs of Joomla, for example to fix a bug. To test a patch, the changed programs have to be inserted into an installation. This can be time-consuming and difficult, which is why the Joomla extension "Patch Tester" was developed. The patch tester fetches the required files for a patch, injects them into the application and can also remove them if necessary.

What do I need to install the patch tester?

  • Internet and Browser
  • You need a GitHub account to authenticate in the patch tester. If you need a GitHub account, first go to the https://github.com/ and Sing Up.
  • Joomla! -installation

Quick Start / Quick Start:

  1. Download and install "Patch Tester" ( https : //github.com/joomla-extensions/patchtester/releases code)
  2. Enter GitHub username and password in the options.
  3. Get the patches - please fetch Data right in front of the PBF, so that the new patches will be loaded as well.

Step-by-step guide:

1.Download Patchtester

Download the latest version of the patchtester to your local machine: https://github.com/joomla-extensions/patchtester/releases

2. Log in to Joomla Backend

3. Now change to the extension manager

(Extensions → Manage → Install)

4. Install the patchtester component

In the tab "Upload Package File" you can drag and drop the component into the canvas. The installation then runs automatically.

5. Now switch to patch tester component

6. Click on the "Options" button in the upper right corner of the Patch Tester


Patch Tester

7. GitHub Repository (Source)

The options page will open and you will see three tabs. The first tab is called GitHub Repository (Source). Here you can choose the source you want to use. By default, this is Joomla! CMS.


GitHub Repository (source)
8. GitHub authentication

In the second tab, called "GitHub Authentication", you can enter and save your GitHub username and password.



Note: If you use two-factor authentication for your GitHub account , you must have a personal token to access https://github.com/settings/applications and paste it into the GitHub token field.

Two-factor authentication (token)

After entering your account details, click Save & Close.


9. Click on the button "Fetch Data"

This takes a small time to fetch all patches.

Button

10. All patches will be downloaded

The patch tester is structured as follows:

build the patchtester

1: search box, eg. For example, we can search for the pull ID here. The pull ID is on the list distributed by the PBF.
2: Sort by Joomla version, for example Joomla 4.0
3: Branch indicates for which Joomla version the patch is 4: "Yes" means the patch has already been tested. "No" still needs to be tested.
5: GitHub is accessed
6: The Issue Tracker contains the error description with which you can copy the error. For example, if you're logged in to the Issue Tracker, you can click on the drop-down menu to see if the test has been successfully tested, or leave a message to the patch programmer that failed - what he needs to improve (more on that later) />

7: Only after you have recreated the error, you can apply the patch with a click on "Apply Patch".

It continues:

Readjustment and patching: Manual patch tester