Description

This repository contains the github workflow for the Moodle-Plugin-CI pipeline. It is used to automate the testing and deployment of Moodle plugins hosted by the Learnweb organization.

The goal of this repository is to provide a reusable and configurable workflow for the different plugins, allowing them to be tested and deployed with minimal configuration and without writing the workflow file in each plugin repository. The workflow itself runs different steps like checking the code style, running unit tests and behat test agains different php versions, databases and Moodle versions. The release workflow deploys the plugin to the Moodle plugin directory for a new release.

How to use the repository

To use the repository in a plugin no installation or cloning is required. In the plugin .github/workflows/ directory three files are required:

• config.json: The configuration file for the plugins workflow.
• moodle-ci.yml: The file that calls this repository workflow to test the plugin against different.
• moodle-release.yml: The file that calls the release workflow.

The configuration file

The config.json file is crucial as it defines the plugins configuration for the workflow. The config file needs to define the following properties:

• moodle-plugin-ci: The version of the official Moodle-Plugin-CI repository repository to use. Look up the tags and choose the latest version.
• main-moodle: The main Moodle branch that the plugin is developed against. Look up the Moodle branches and choose a stable version.
• main-php: The main PHP version for the plugin.
• main-db: The main database for the plugin. This can be pgsql, mariadb or mysqli.

Important, but not clearly necessary is:

• moodle-testmatrix: The Moodle test matrix. The test matrix defines different Moodle versions, php versions and databases that the plugin should be tested against the PHPUnit and Behat tests. If not defined, the workflow will only use the main-moodle, main-php and main-db properties. If the plugin wants to support multiple Moodle versions, the test matrix should be defined.

Optional property:

• additional_plugins: An array of additional plugins. When plugins depend on other plugins, this property can be used to define the additional plugins that should be installed during the tests, as otherwise the workflow fails

A example config file with different options for the testmatrix looks like the example under (remove the // comments before using it). Check on the Moodle Releases which Moodle versions are supported and check on Moodle PHP versions which PHP versions are supported for each Moodle version. Then choose which tests you want to include:

{
  "moodle-plugin-ci": "4.5.7",
  "main-moodle": "MOODLE_500_STABLE",
  "main-php": "8.3",
  "main-db": "pgsql",
  "moodle-testmatrix": { // Defines a matrix with all tests that will be run
    "MOODLE_401_STABLE": {  // This will test moodle 4.1 against pgsql and php 8.0 + 8.1
      "php": ["8.0", "8.1"]
    },
    "MOODLE_404_STABLE": { // This will test moodle 4.4 against php 8.3 and mariadb 
      "db": ["mariadb"]
    },
    "MOODLE_405_STABLE": { // This will test moodle 4.5 against php 8.3 and pgsql
      
    },
    "MOODLE_500_STABLE": { // This will test moodle 5.0 against php 8.2, 8.3 and 8.4, each against pgsql, mariadb and mysqli
      "php": ["8.2", "8.3", "8.4"],
      "db": ["pgsql", "mariadb", "mysqli"]
    }
  },
  "additional_plugins": [ // How to include additional plugins. The plugin is the github repository url.
    "learnweb/moodle-mod_moodleoverflow",
    "learnweb/moodle-block_townsquare",
    "moodlehq/moodle-local_codechecker"
  ]
}

The workflow files

The moodle-ci.yml and moodle-release.yml call the workflow. The moodle-ci.yml is always the same:

name: Moodle Plugin CI
on: [ push, pull_request ]

jobs:
  call:
    name: ""
    uses: learnweb/moodle-workflows-learnweb/.github/workflows/moodle-ci.yml@main
    with:
      allow-mustache-lint-error: true

The moodle-release.yml needs the plugin name (e.g. 'mod_moodleoverflow' or block_townsquare):

name: Moodle Plugin Release

on:
  release:
    types: [ published ]

jobs:
  call-moodle-release-workflow:
    uses: learnweb/moodle-workflows-learnweb/.github/workflows/moodle-release.yml@main
    with:
      plugin-name: 'plugin_name'
    secrets: inherit