Preparation: Local webserver
- To test patches in Joomla we need an active local WAMP/LAMP/MAMP stack running
XAMPP download: https://sourceforge.net/projects/xampp/files/ - Make sure Composer AND Node.js are installed:
Composer: https://getcomposer.org
NPM: https://nodejs.org/en
Installing Joomla for testing
For testing we need the latest git repository of Joomla. You can:
- download the repository: https://github.com/joomla/joomla-cms/archive/refs/heads/4.3-dev.zip
- clone the repository: https://github.com/joomla/joomla-cms /
This email address is being protected from spambots. You need JavaScript enabled to view it. :joomla/joomla-cms.git - Make sure all files are extracted. Go to the folder with the command line tool and execute the following commands:
: composer install
: npm ci
- Install Joomla on your local server!
- Don't remove the installation folder!
Installing the Patch Tester
- Download and install the Joomla Patch Tester: https://github.com/joomla-extensions/patchtester/releases
(More info: https://docs.joomla.org/Component_Patchtester_for_Testers/nl) - Make sure you have an active Github account to login to the Joomla issue tracker
- Set the API key in the options of the Joomla patch tester
API key will be created in your GitHub account
Finding a patch to check
All Joomla issues are on the issue tracker:
- Find an issue in the patch tester and check if the bug is still there
- Download the patch via the Patch Tester
- If the patch has Javascript or CSS run via the command line: npm ci
(Just like in the initial installation) - Check if the bug is gone.
- If the patch is fixed report the patch as fixed in the issue tracker.
Important: Be honest in testing. If in any doubt, comment in the pull request.
Tips:
Work together to test the patches.
2 valid tests are needed on two different machines!
You can always download and install the pre-build package with the patch already in it (you need a second clean installation to verify the patch).
Free Joomla website (saas): https://launch.joomla.org