action.yml | ||
CHANGELOG.md | ||
Dockerfile | ||
entrypoint.sh | ||
README.md |
Koha Plugin kpz Builder
This action builds a kpz file from a given name and version. The file will be in your GitHub workspace after the action is run.
Inputs
release-version
Required Version for this koha plugin release, e.g. v1.0.3
release-name
Required Name of plugin, should almost always be the repo name, e.g. koha-plugin-kitchen-sink
minimmum-version
Required Minimum version of Koha this plugin is compatible with, e.g. 19.11
or 19.11.03
plugin-module
Optional Path to the plugin module file, relative to the plugin root directory. If not provided, action will attempt to auto-detect the module path.
Best practice is to keep plugins compatible across all currently supported versions of Koha
Outputs
filename
The name of the built kpz file
Example usage
- name: Build Koha Plugin kpz artifact
id: kpz
uses: "bywatersolutions/github-action-koha-plugin-create-kpz@master"
with:
release-version: ${{ steps.semvers.outputs.v_patch }}
release-name: ${{ steps.myvars.outputs.GITHUB_REPO }}
minimum-version: ${{ steps.koha-version-oldstable.outputs.version-major-minor }}
plugin-module: 'Path/To/Plugin/Module.pm"
Take a look at https://github.com/bywatersolutions/koha-plugin-kitchen-sink/blob/master/.github/workflows/main.yml for a real world usage.