Handle document options for insertDocument API.

Author: GhaziTriki

src/Enum/DocumentOption.php

@@ -0,0 +1,30 @@
+<?php
+
+/*
+ * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/.
+ *
+ * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below).
+ *
+ * This program is free software; you can redistribute it and/or modify it under the
+ * terms of the GNU Lesser General Public License as published by the Free Software
+ * Foundation; either version 3.0 of the License, or (at your option) any later
+ * version.
+ *
+ * BigBlueButton is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License along
+ * with BigBlueButton; if not, see <https://www.gnu.org/licenses/>.
+ */
+
+namespace BigBlueButton\Enum;
+
+use MabeEnum\Enum;
+
+class DocumentOption extends Enum
+{
+    public const CURRENT      = 'current';
+    public const DOWNLOADABLE = 'downloadable';
+    public const REMOVABLE    = 'removable';
+}

src/Parameters/Config/DocumentOptionsStore.php

@@ -0,0 +1,44 @@
+<?php
+
+/*
+ * BigBlueButton open source conferencing system - https://www.bigbluebutton.org/.
+ *
+ * Copyright (c) 2016-2024 BigBlueButton Inc. and by respective authors (see below).
+ *
+ * This program is free software; you can redistribute it and/or modify it under the
+ * terms of the GNU Lesser General Public License as published by the Free Software
+ * Foundation; either version 3.0 of the License, or (at your option) any later
+ * version.
+ *
+ * BigBlueButton is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License along
+ * with BigBlueButton; if not, see <https://www.gnu.org/licenses/>.
+ */
+
+namespace BigBlueButton\Parameters\Config;
+
+class DocumentOptionsStore
+{
+    private $attributes = [];
+
+    public function __construct(array $attributes = [])
+    {
+        $this->attributes = $attributes;
+    }
+
+    public function addAttribute($name, $value)
+    {
+        if (is_bool($value)) {
+            $value = $value ? 'true' : 'false';
+        }
+        $this->attributes[$name] = $value;
+    }
+
+    public function getAttributes()
+    {
+        return $this->attributes;
+    }
+}

src/Parameters/DocumentableTrait.php

@@ -20,6 +20,8 @@
 
 namespace BigBlueButton\Parameters;
 
+use BigBlueButton\Parameters\Config\DocumentOptionsStore;
+
 trait DocumentableTrait
 {
     /**
@@ -35,40 +37,44 @@ public function getPresentations(): array
         return $this->presentations;
     }
 
-    /**
-     * @param mixed $content
-     */
-    public function addPresentation(string $nameOrUrl, $content = null, ?string $filename = null): self
+    public function addPresentation(string $nameOrUrl, $content = null, ?string $filename = null, DocumentOptionsStore $attributes = null): self
     {
-        if (!$filename) {
-            $this->presentations[$nameOrUrl] = !$content ?: base64_encode($content);
-        } else {
-            $this->presentations[$nameOrUrl] = $filename;
-        }
+        $this->presentations[$nameOrUrl] = [
+            'content' => !$content ?: base64_encode($content),
+            'filename' => $filename,
+            'attributes' => $attributes
+        ];
 
         return $this;
     }
 
     public function getPresentationsAsXML(): string
     {
         $result = '';
-
         if (!empty($this->presentations)) {
             $xml    = new \SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?><modules/>');
             $module = $xml->addChild('module');
             $module->addAttribute('name', 'presentation');
 
-            foreach ($this->presentations as $nameOrUrl => $content) {
+            foreach ($this->presentations as $nameOrUrl => $data) {
+                $presentation = $module->addChild('document');
                 if (0 === mb_strpos($nameOrUrl, 'http')) {
-                    $presentation = $module->addChild('document');
                     $presentation->addAttribute('url', $nameOrUrl);
-                    if (is_string($content)) {
-                        $presentation->addAttribute('filename', $content);
-                    }
                 } else {
-                    $document = $module->addChild('document');
-                    $document->addAttribute('name', $nameOrUrl);
-                    $document[0] = $content;
+                    $presentation->addAttribute('name', $nameOrUrl);
+                }
+
+                if (!empty($data['filename'])) {
+                    $presentation->addAttribute('filename', $data['filename']);
+                }
+
+                if (!empty($data['content'])) {
+                    $presentation[0] = $data['content'];
+                }
+
+                // Add attributes using DocumentAttributes class
+                foreach ($data['attributes']->getAttributes() as $attrName => $attrValue) {
+                    $presentation->addAttribute($attrName, $attrValue);
                 }
             }
             $result = $xml->asXML();