Adding upstream version 2.12.1.upstream/2.12.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 49 insertions, 0 deletions

diff --git a/library/Icinga/Web/Widget.php b/library/Icinga/Web/Widget.php
new file mode 100644
index 0000000..48ae7bd
--- /dev/null
+++ b/library/Icinga/Web/Widget.php
@@ -0,0 +1,49 @@
+<?php
+/* Icinga Web 2 | (c) 2013 Icinga Development Team | GPLv2+ */
+
+namespace Icinga\Web;
+
+use Icinga\Exception\ProgrammingError;
+use Icinga\Web\Widget\AbstractWidget;
+
+/**
+ * Web widgets make things easier for you!
+ *
+ * This class provides nothing but a static factory method for widget creation.
+ * Usually it will not be used directly as there are widget()-helpers available
+ * in your action controllers and view scripts.
+ *
+ * Usage example:
+ * <code>
+ * $tabs = Widget::create('tabs');
+ * </code>
+ *
+ * @copyright  Copyright (c) 2013 Icinga-Web Team <info@icinga.com>
+ * @author     Icinga-Web Team <info@icinga.com>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU General Public License
+ */
+class Widget
+{
+    /**
+     * Create a new widget
+     *
+     * @param string $name    Widget name
+     * @param array  $options Widget constructor options
+     *
+     * @return AbstractWidget
+     */
+    public static function create($name, $options = array(), $module_name = null)
+    {
+        $class = 'Icinga\\Web\\Widget\\' . ucfirst($name);
+
+        if (! class_exists($class)) {
+            throw new ProgrammingError(
+                'There is no such widget: %s',
+                $name
+            );
+        }
+
+        $widget = new $class($options, $module_name);
+        return $widget;
+    }
+}