feat(plugins): install from plugins directory

Issue #49

defaults/main.yml

@@ -107,8 +107,18 @@ moodle_cfg_forcedsettings: {}
 
 # ------ Extend with Plugins {{{1
 
-# Download plugins from a Git repository in case they are not in the Moodle
-# plugins directory. For example:
+# Download and install plugins from the Moodle Plugins Directory
+# (https://moodle.org/plugins). For each plugin, specify its name and the URL
+# to the zip archive containing a version compatible with the Moodle version. For example:
+#
+# moodle_plugins:
+#   - name: availability_xp
+#     archive: https://moodle.org/plugins/download.php/30440/availability_xp_moodle44_2023110700.zip
+#   - name: mod_customcert
+#     archive: https://moodle.org/plugins/download.php/32229/mod_customcert_moodle43_2023100901.zip
+moodle_plugins: []
+
+# Download plugins from a public Git repository. For example:
 #
 # moodle_plugins_git;
 #   - name: block_todos

molecule/plugins/converge.yml

@@ -37,6 +37,28 @@
         update_cache: true
         cache_valid_time: "{{ 60 * 60 * 24 }}" # seconds => 24 hours
 
-    - name: "Include geoffreyvanwyk.moodle"
+    - name: Help Git overcome unstable Internet connection
+      block:
+        - name: Increase Git HTTP buffer
+          # Attempt to solve:
+          # RPC failed; curl 92 HTTP/2 stream 0 was not closed cleanly:
+          # CANCEL (err 8)
+          community.general.git_config:
+            scope: global
+            name: http.postBuffer
+            value: 2147483648
+
+        - name: Disable Git compression
+          # Attempt to solve:
+          # error: <so-many> bytes of body are still expected
+          # fetch-pack: unexpected disconnect while reading sideband packet
+          # fatal: early EOF
+          # fatal: fetch-pack: invalid index-pack output
+          community.general.git_config:
+            scope: global
+            name: core.compression
+            value: 0
+
+    - name: Include geoffreyvanwyk.moodle
       ansible.builtin.include_role:
         name: "geoffreyvanwyk.moodle"

molecule/plugins/vars/main.yml

@@ -21,7 +21,16 @@
 # @copyright  2023 Geoffrey Bernardo van Wyk (https://geoffreyvanwyk.dev)
 ##
 
+moodle_plugins:
+  - name: availability_relativedate
+    archive: https://moodle.org/plugins/download.php/31728/availability_relativedate_moodle44_2024042000.zip
+  - name: mod_customcert
+    archive: https://moodle.org/plugins/download.php/32229/mod_customcert_moodle43_2023100901.zip
+
 moodle_plugins_git:
+  - name: block_todo
+    repository: https://github.com/davewoloszyn/moodle-block_todo
+    version: master
   - name: theme_learningsandboxonline
     repository: >-
       https://github.com/geoffreyvanwyk/moodle-theme_learningsandboxonline

molecule/plugins/verify.yml

@@ -46,7 +46,12 @@
       register: moodle_additional_plugins_installed
       changed_when: false
 
-    - name: Assert that plugins are installed
+    - name: Assert that plugins are installed from Git repositories
       loop: "{{ moodle_plugins_git }}"
       ansible.builtin.assert:
         that: item.name in moodle_additional_plugins_installed.stdout_lines
+
+    - name: Assert that plugins are installed from Moodle plugins directory 
+      loop: "{{ moodle_plugins }}"
+      ansible.builtin.assert:
+        that: item.name in moodle_additional_plugins_installed.stdout_lines

tasks/deploy_plugins.yml

@@ -16,12 +16,39 @@
 # <https://www.gnu.org/licenses/>.
 
 ##
-# Clone source code of plugins from remote Git repository hosts like GitHub.
+# Download and extract zip archives of plugins, or clone source code of plugins
+# from remote Git repository hosts like GitHub.
 #
 # @copyright  2023 Geoffrey Bernardo van Wyk (https://geoffreyvanwyk.dev)
 ##
 
-- name: Deploy source code of plugins
+- name: Download plugin zip archives
+  loop: "{{ moodle_plugins }}"
+  ansible.builtin.get_url:
+    url: "{{ item.archive }}"
+    dest: /tmp/
+    mode: ugo=rw
+  register: moodle_download_plugin_zip_archives
+
+- name: Install package for extracting zip archives
+  become: true
+  ansible.builtin.apt:
+    package: unzip
+
+- name: Extract plugin zip archives
+  when: moodle_download_plugin_zip_archives.changed
+  loop: "{{ moodle_plugins }}"
+  ansible.builtin.unarchive:
+    src: /tmp/{{ item.archive | regex_search(item.name + '.+\.zip$') }}
+    remote_src: true
+    dest: "{{
+      moodle_deploy_destination + '/' +
+      lookup('geoffreyvanwyk.moodle.plugin_directory',
+      frankenstyle_name=item.name) | dirname
+      }}"
+  notify: Upgrade Moodle
+
+- name: Clone source code of plugins
   loop: "{{ moodle_plugins_git }}"
   ansible.builtin.git:
     repo: "{{ item.repository }}"

tasks/main.yml

@@ -31,7 +31,7 @@
 - name: Deploy Moodle
   ansible.builtin.import_tasks: ./deploy_source_code.yml
 
-- name: Deploy Plugins
+- name: Deploy plugins
   ansible.builtin.import_tasks: ./deploy_plugins.yml
 
 - name: Install and configure web hosting