WordPress 4.4

[autoinstalls/wordpress.git] / wp-includes / class-wp-widget-factory.php

diff --git a/wp-includes/class-wp-widget-factory.php b/wp-includes/class-wp-widget-factory.php
new file mode 100644 (file)
index 0000000..c7abcc8
--- /dev/null
+++ b/wp-includes/class-wp-widget-factory.php
@@ -0,0 +1,82 @@
+<?php
+/**
+ * Widget API: WP_Widget_Factory class
+ *
+ * @package WordPress
+ * @subpackage Widgets
+ * @since 4.4.0
+ */
+
+/**
+ * Singleton that registers and instantiates WP_Widget classes.
+ *
+ * @since 2.8.0
+ * @since 4.4.0 Moved to its own file from wp-includes/widgets.php
+ */
+class WP_Widget_Factory {
+       public $widgets = array();
+
+       /**
+        * PHP5 constructor.
+        */
+       public function __construct() {
+               add_action( 'widgets_init', array( $this, '_register_widgets' ), 100 );
+       }
+
+       /**
+        * PHP4 constructor.
+        */
+       public function WP_Widget_Factory() {
+               _deprecated_constructor( 'WP_Widget_Factory', '4.2.0' );
+               self::__construct();
+       }
+
+       /**
+        * Register a widget subclass.
+        *
+        * @since 2.8.0
+        * @access public
+        *
+        * @param string $widget_class The name of a {@see WP_Widget} subclass.
+        */
+       public function register( $widget_class ) {
+               $this->widgets[$widget_class] = new $widget_class();
+       }
+
+       /**
+        * Un-register a widget subclass.
+        *
+        * @since 2.8.0
+        * @access public
+        *
+        * @param string $widget_class The name of a {@see WP_Widget} subclass.
+        */
+       public function unregister( $widget_class ) {
+               unset( $this->widgets[ $widget_class ] );
+       }
+
+       /**
+        * Utility method for adding widgets to the registered widgets global.
+        *
+        * @since 2.8.0
+        * @access public
+        *
+        * @global array $wp_registered_widgets
+        */
+       public function _register_widgets() {
+               global $wp_registered_widgets;
+               $keys = array_keys($this->widgets);
+               $registered = array_keys($wp_registered_widgets);
+               $registered = array_map('_get_widget_id_base', $registered);
+
+               foreach ( $keys as $key ) {
+                       // don't register new widget if old widget with the same id is already registered
+                       if ( in_array($this->widgets[$key]->id_base, $registered, true) ) {
+                               unset($this->widgets[$key]);
+                               continue;
+                       }
+
+                       $this->widgets[$key]->_register();
+               }
+       }
+}