Joomla Test Extensions for the Packager Action
Purpose:
These test extensions are provided to help you verify the functionality of the Joomla Extension Packager action, learn about Joomla extension structure, and serve as a starting point for your own development.
How to Use:
1. Download or package any of the test extensions from the repository.
2. In your Joomla administrator, go to Extensions > Manage > Install.
3. Upload the ZIP file to install.
4. Enable or publish the extension as needed.
Compatibility:
These examples are designed for Joomla 4.x.
Customize:
Feel free to copy and modify these test extensions for your own projects.
Feedback:
Suggestions and contributions are welcome! See the main README for more information.
Browse the example source code here:
https://github.com/N6REJ/joomla-packager/tree/main/test-extensions
Test Module: mod_test
This is a minimal Joomla module created for testing and demonstrating the Joomla Extension Packager action. It displays a configurable message on the site, allowing you to verify that the packaging and installation process works as expected.
- Manifest: mod_test.xml
- Main file: mod_test.php
- Helper: helper.php
- Template: tmpl/default.php
- Language files: language/en-GB/mod_test.ini, mod_test.sys.ini
After installation, publish the module in a module position. It will display the message set in its parameters.
Where to find this example:
The source files for this module are located in the test-extensions/test-module directory of the repository.
Test Plugin: plg_testplugin
This is a minimal Joomla system plugin created for testing and demonstrating the Joomla Extension Packager action. When enabled, it displays a message in the Joomla message queue (visible in the backend) to confirm the plugin is active and working.
- Manifest: plg_testplugin.xml
- Main file: plg_testplugin.php
- Language files: en-GB.plg_testplugin.ini, en-GB.plg_testplugin.sys.ini
After installation, enable the plugin in the Joomla Plugin Manager. You should see a message like "Test Plugin is active!" in the backend after login or page load.
Where to find this example:
The source files for this plugin are located in the test-extensions/test-plugin directory of the repository.
Test Component: com_testcomponent
This is a minimal Joomla component created for testing and demonstrating the Joomla Extension Packager action. It provides a simple frontend view that displays a static message, confirming the component is installed and working.
- Manifest: com_testcomponent.xml
- Main file: com_testcomponent.php
- Controller: controller.php
- View: views/default/view.html.php
- Template: tmpl/default.php
After installation, access the component via the URL index.php?option=com_testcomponent on your Joomla site. You should see a message confirming the component is working.
Where to find this example:
The source files for this component are located in the test-extensions/test-component directory of the repository.
Test Package: pkg_testpackage
This is a minimal Joomla package created for testing and demonstrating the Joomla Extension Packager action. It bundles the test module and test plugin into a single installable package, allowing you to verify that package-type extensions are handled correctly.
- Manifest: pkg_testpackage.xml
- Includes: test-module (mod_test), test-plugin (plg_testplugin)
After installation, both the test module and test plugin will be installed. You can then publish the module and enable the plugin to see their outputs as described in their respective articles.
Where to find this example:
The source files for this package are located in the test-extensions/test-package directory of the repository. The included module and plugin are in test-extensions/test-module and test-extensions/test-plugin respectively.