#225 Allow element plugins to control if they can be added

classes/element.php

@@ -352,6 +352,16 @@ abstract class element {
         return true;
     }
 
+    /**
+     * This defines if an element plugin can be added to a certificate.
+     * Can be overridden if an element plugin wants to take over the control.
+     *
+     * @return bool returns true if the element can be added, false otherwise
+     */
+    public static function allow_add() {
+        return true;
+    }
+
     /**
      * Handles rendering the element on the pdf.
      *

classes/element_helper.php

@@ -412,11 +412,14 @@ class element_helper {
                 $classname = '\\customcertelement_' . $foldername . '\\element';
                 // Ensure the necessary class exists.
                 if (class_exists($classname)) {
+                    // Additionally, check if the user is allowed to add the element at all.
+                    if ($classname::allow_add()) {
                         $component = "customcertelement_{$foldername}";
                         $options[$foldername] = get_string('pluginname', $component);
                     }
                 }
             }
+        }
 
         \core_collator::asort($options);
         return $options;