Joomla Package (pkg) Packaging Workflow Example

This article demonstrates how to use the GitHub Actions workflow for packaging and releasing a Joomla package (pkg) using the Joomla Extension Packager composite action. This is useful for bundling multiple extensions (modules, plugins, components) into a single installable package.

How to Use

1. Copy the following YAML workflow into your repository's .github/workflows/ directory (e.g., package-packager.yml).
2. Edit the with: section to match your package's details.
3. Push to your repository or trigger the workflow manually from the GitHub Actions tab.

Workflow Code

# Example workflow for a Joomla package (pkg)
name: Package and Release Package

on:
  workflow_dispatch:

jobs:
  package:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
          token: ${{ secrets.GH_PAT }}
      - name: Joomla Extension Packager
        uses: N6REJ/joomla-packager@2025.6.23
        id: packager
        with:
          extension-name: 'pkg_example'
          extension-xml: 'pkg_example.xml'
          extension-type: 'package'
          author: 'Your Name'
          copyright-holder: 'Your Company'
          copyright-start-year: '2024'
          github-token: ${{ secrets.GH_PAT }}

After the workflow runs, your packaged package ZIP and changelog will be available in the repository's Releases section.