This is the repository of the JoomGallery component for Joomla! 4 and newer.
Project-Website: https://www.joomgalleryfriends.net/
Support-Forum: https://www.forum.joomgalleryfriends.net
Non-binding roadmap (DE): https://www.forum.joomgalleryfriends.net/forum/index.php?thread/483-unverbindliche-roadmap/&postID=2880#post2880
Project Presentation (DE): https://docs.google.com/presentation/d/1kXGfGRrHswU0M3yh0zUvOwW1fYqB07cksHzNxzcEyxI
JoomGallery is an OpenSource project and is developed by users for users. So if you are using JoomGallery feel free to contribute to the project...
The JoomGallery component is developed following the current Joomla! 4+ Paradigm. Following you find some online resources explaining them.
- Robbies video series on Joomla 4 component development
- Official Joomla! Programmers Documentation
- Official Joomla! 4 component development docs
- Nicholas book on Joomla 4 development
- Mattermost channel for Joomla developers
Just like the CMS Joomla!, the gallery component JoomGallery is an Open Source project and exists because of its community. Which means that everything in the project is developed and maintained by users of the JoomGallery. Therefore we ask you to use your skills and knowledge to contribute to the project. Here on GitHub you can help coding and developing the extension.
Following the JoomGalleries coding documentation:
https://docs.joomla.org/Setting_up_your_workstation_for_Joomla_development
Webserver recommendation:
- https://wampserver.aviatechno.net/ (Windows only)
- https://www.apachefriends.org/index.html (Windows, Linux and macOS)
IDE/Editor recommendation:
- https://www.jetbrains.com/phpstorm/ (Windows, Linux and macOS)
- https://code.visualstudio.com/ (Windows, Linux and macOS)
Git-Client recommendation:
- https://desktop.github.com/ (Windows and macOS)
Recommendet approach for proper versioning with Git:
- Checkout the repo into a folder of your choice
- Download the source code of the dev-branch as zip file and install it on Joomla
- Remove the installed component folders within your Joomla installation
- administrator/components/com_joomgallery
- components/com_joomgallery
- media/com_joomgallery
- plugins/finder/joomgallerycategories
- plugins/finder/joomgalleryimages
- plugins/privacy/joomgalleryimages
- plugins/webservices/joomgallery
- Create symbolic links from those folders to the corresponding folders within the checked out copy of the repository
- The referenced copy of your component can be properly versioned using Git
Symbolic link generator tool for windows: https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html
Testing is an integrate part of the development process and can be done even without coding skills. Just look at the tab Pull requests to see which code changes need testing. If you want to test a code change, this is how to do it:
- Open the Pull request (PR) you want to test
- Scroll down the comments feed of the PR all the way to the bottom
- Open the accordion All checks have passed
- Open the link PR Build Artifact / build-pr-zip
- Change on the left navigation to Summary
- Click the link in the Artifacts section which has the name "JoomGallery-PRname"
- A zip file of the PR gets created and downloaded
- Install the zip file in your Joomla!
- Perform tests where the PR changes anything
- If you find a bug or unexpected behaviour, post a comment in the pull request with the following content:
List the steps to perform in order to reproduce the issue you found
What would you have expected should have happen?
What did really happen?
- PHP-Version
- Database type and version
- (ImageMagick version)
Anything else that you think is important for the developer to fix the issue