remove plugins.json from project, add sample plugins.json, improve er…

…ror handling if file does not exist and update README.md

README.md

@@ -9,4 +9,12 @@ The following roles are available:
 
 The following environment variables are used:
 - DECLARATIVE_SETUP_MANAGER_PASSWORD: Password for the manager user
-- DECLARATIVE_SETUP_STUDENT_PASSWORD: Password for the student user
+- DECLARATIVE_SETUP_STUDENT_PASSWORD: Password for the student user
+
+## files/plugins.json
+This file is required if `moodle_dev_env` role is not used. Get the current version from
+[ProjektAdLer/MoodleAdlerLMS/files/plugin.json](https://github.com/ProjektAdLer/MoodleAdlerLMS/blob/main/plugins.json).
+See plugins.json.sample for an example.
+
+If this plugin is used in the [AdLer LMS Moodle image](https://github.com/ProjektAdLer/MoodleAdlerLMS), the plugin.json
+file is automatically copied to the `files` directory.

classes/playbook.php

@@ -145,12 +145,15 @@ protected function playbook_implementation(): void {
     }
 
     /**
-     * @throws invalid_parameter_exception
+     * @throws moodle_exception
      * @returns install_plugins_model[]
      */
     private function load_plugins_to_install(): array {
         $filePath = __DIR__ . '/../files/plugins.json';
         $jsonContent = file_get_contents($filePath);
+        if ($jsonContent === false) {
+            throw new moodle_exception('Failed to read files/plugins.json. Does it exist?');
+        }
         $pluginsArray = json_decode($jsonContent, true);
 
         return array_map(function ($plugin) {

files/plugins.json.sample

@@ -0,0 +1,32 @@
+[
+  {
+    "package_repo": "https://packages.projekt-adler.eu/packages/moodle/",
+    "version": "0.1.0",
+    "name": "local_declarativesetup"
+  },
+  {
+    "package_repo": "https://packages.projekt-adler.eu/packages/moodle/",
+    "version": "0.1.0",
+    "name": "playbook_adler"
+  },
+  {
+    "package_repo": "https://packages.projekt-adler.eu/packages/moodle/",
+    "version": "5.0.0",
+    "name": "local_adler"
+  },
+  {
+    "package_repo": "https://packages.projekt-adler.eu/packages/moodle/",
+    "version": "4.0.1",
+    "name": "availability_adler"
+  },
+  {
+    "package_repo": "https://packages.projekt-adler.eu/packages/moodle/",
+    "version": "3.0.0",
+    "name": "mod_adleradaptivity"
+  },
+  {
+    "package_repo": "https://packages.projekt-adler.eu/packages/moodle/",
+    "version": "1.0.0",
+    "name": "local_logging"
+  }
+]