An action for GitHub to upload your REDAXO AddOn automatically into the REDAXO installer with every GitHub release based on your GitHub repository and main branch.
Please note: The AddOn must already be created in MyREDAXO.
Notice You don't need to be part of FriendsOfREDAXO to use this action. Just follow the instructions for evers repository.
This step is not required for REDAXO AddOns within the FriendsOfREDAXO GitHub organization. Continue with step 2.
Add your MyREDAXO credentials to your organization secrets or repository secrets, e.g. via https://github.com/YOUR_GITHUB_NAME/YOUR_REPOSITORY/settings/secrets/actions
(GitHub Docs).
secret name | value |
---|---|
MYREDAXO_USERNAME |
Your REDAXO login user |
MYREDAXO_API_KEY |
Your MyREDAXO API key |
example value for MYREDAXO_API_KEY
named secret:
Create a new release workflow by creating a new file in your repository called .github/workflows/publish-to-redaxo-org.yml
with the following content or follow the instructions on https://github.com/YOUR_GITHUB_NAME/YOUR_REPOSITORY/actions/new.
# Instructions: https://github.com/FriendsOfREDAXO/installer-action/
name: Publish to REDAXO.org
on:
release:
types:
- published
jobs:
redaxo_publish:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- if: hashFiles('composer.json') != ''
uses: shivammathur/setup-php@v2
with:
php-version: "8.2"
- if: hashFiles('composer.json') != ''
uses: ramsey/composer-install@v2
with:
composer-options: "--no-dev"
- uses: FriendsOfREDAXO/installer-action@v1
with:
myredaxo-username: ${{ secrets.MYREDAXO_USERNAME }}
myredaxo-api-key: ${{ secrets.MYREDAXO_API_KEY }}
description: ${{ github.event.release.body }}
version: ${{ github.event.release.tag_name }}
As soon as you publish a new release on GitHub, this workflow is triggered and your AddOn is uploaded to myREDAXO.
We recommend to create a new tag with the same name of the version defined in the package.yml
of your REDAXO AddOn.
We also recommend to use a nice description with information about the date of the relase, new features or instructions for other developers, e.g. any important changes or tasks to do before or after the installation. It's possible to use markdown syntax.
# My Addon Name | Published on XX.XX.202X | Version
One line about the main new feature.
> **Important:** An warning about breaking changes, new preconditions or additional instructions
## What's new
* A list of features or changes with reference to contributing GitHub users , e.g. @friendsofredaxo
* A list of features or changes with reference to contributing GitHub users , e.g. @friendsofredaxo
* A list of features or changes with reference to contributing GitHub users , e.g. @friendsofredaxo
## Changes
* A list of features or changes with reference to contributing GitHub users , e.g. @friendsofredaxo
* A list of features or changes with reference to contributing GitHub users , e.g. @friendsofredaxo
Changelog: https://www.example.org/
You can monitor the status of the workflow under https://github.com/YOUR_GITHUB_NAME/YOUR_REPOSITORY/actions. Once completed, the result is your REDAXO AddOn published through MyREDAXO and live in ever REDAXO 5 installer.