n6rej/Joomla Extension Packager

A composite action to package and release Joomla extensions (modules, plugins, components)

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Maintainedlast commit Sep 17, 2025
License
GPL 3.0

Pinned Snippet

workflow.ymlSHA-pinned
uses: n6rej/joomla-packager@6299aa6cf6d18d55c0567784b01832e1b9a1acdd # 2025.9.17

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
extension-nameExtension folder and file prefix (e.g. mod_example, plg_system_example). If not specified, derived from repository nameno""
extension-xmlMain XML file (e.g. mod_example.xml). If not specified, derived from extension nameno""
extension-typeType of extension (module, plugin, component). If not specified, derived from repository name prefix.no""
authorAuthor name or handle. If not specified, uses the repository owner.no""
copyright-holderCopyright string (e.g. YourName (YourHandle))no""
copyright-start-yearCopyright start yearno""
github-tokenGitHub token for authenticationyes
manual-versionManual version override (e.g. 1.2.3). If not specified, uses automatic date-based versioningno""
php-versionPHP version to useno8.1
changelog-fileChangelog filenamenoCHANGELOG.md
helper-fileHelper PHP filenohelper.php
license-fileLicense filenoLicense.txt
favicon-fileFavicon file (leave empty to skip)nofavicon.ico
updates-xml-fileUpdates XML filenoupdates.xml
css-dirCSS directorynocss
js-dirJS directorynojs
tmpl-dirTemplate directorynotmpl
language-dirLanguage directorynolanguage
package-dirPackage output directory (always uses build/)nobuild
dir-tree-fileDirectory tree output file (leave empty to skip)nodirectory-structure.txt
file-updatesWhether to update version and copyright in filesnotrue
generate-changelogWhether to generate changelog from commitsnotrue
create-releaseWhether to create a GitHub releasenotrue
upload-artifactWhether to upload as GitHub artifactnotrue
update-joomla-serverWhether to update Joomla update server XMLnotrue
readmeInclude README.md in the package (true/false)nofalse
namedescription
versionThe generated version number
creation-dateThe creation date
package-pathPath to the created package
release-urlURL of the created release
dir-tree-pathPath to the directory tree file