# master-addons/3.1.2/inc/admin/widget-builder/class-control-manager.php Master Addons for Elementor – Elementor Addons, Widgets, Mega Menu Builder, Popup Builder, Widget Builder & Template Kits, version 3.1.2. 244 lines. - Page: https://pluginprobe.com/plugins/master-addons/3.1.2/code/inc/admin/widget-builder/class-control-manager.php - Raw: https://pluginprobe.com/plugins/master-addons/3.1.2/raw/inc/admin/widget-builder/class-control-manager.php - Modified: 2026-06-08T14:32:24+00:00 Line numbers below start at 1. Link to a line or a range by appending a fragment to the page URL, for example `https://pluginprobe.com/plugins/master-addons/3.1.2/code/inc/admin/widget-builder/class-control-manager.php#L10-L20`. ```php load_controls(); } /** * Load all control classes */ private function load_controls() { // Load base class first require_once __DIR__ . '/controls/class-control-base.php'; // Load FREE control type classes only $control_files = [ 'color', 'heading', 'hidden', 'text', 'textarea', 'url', ]; foreach ($control_files as $file) { $file_path = __DIR__ . '/controls/' . $file . '.php'; if (file_exists($file_path)) { require_once $file_path; } } // Allow Pro to load additional controls do_action('jltma_widget_builder_load_controls'); } /** * Get control builder instance by type * * @param string $type Control type (TEXT, TEXTAREA, etc.) - can be uppercase or lowercase * @return Controls\Control_Base|null */ public function get_control($type) { // Convert to uppercase for consistency (React UI sends lowercase, but we need uppercase for mapping) $type = strtoupper($type); // Return cached instance if exists if (isset($this->controls[$type])) { return $this->controls[$type]; } // Map control types to classes (FREE controls only) $class_map = [ 'COLOR' => 'Color', 'HEADING' => 'Heading', 'HIDDEN' => 'Hidden', 'TEXT' => 'Text', 'TEXTAREA' => 'Textarea', 'URL' => 'Url', ]; // Allow Pro to add additional control class mappings $class_map = apply_filters('jltma_widget_builder_control_class_map', $class_map); if (!isset($class_map[$type])) { return null; } // Check if class_map value is a full class name (from Pro) or just class name (free) if (strpos($class_map[$type], '\\') !== false) { $class_name = $class_map[$type]; } else { $class_name = '\\MasterAddons\\Inc\\Admin\\WidgetBuilder\\Controls\\' . $class_map[$type]; } if (!class_exists($class_name)) { return null; } // Create and cache instance $this->controls[$type] = new $class_name(); return $this->controls[$type]; } /** * Build control output * * @param string $control_key Control key * @param array $field Field configuration * @param string $type Control type * @return string */ public function build_control($control_key, $field, $type) { $control = $this->get_control($type); if (!$control) { // Fallback for unknown control types return $this->build_fallback_control($control_key, $field, $type); } return $control->build($control_key, $field); } /** * Build control config ARRAY (runtime equivalent of build_control()). * Consumed by Dynamic_Widget::register_controls() so no PHP file is generated. * * @param string $control_key Control key * @param array $field Field configuration * @param string $type Control type * @return array ['key' => string, 'responsive' => bool, 'args' => array] */ public function build_control_config($control_key, $field, $type) { $control = $this->get_control($type); if (!$control || !method_exists($control, 'get_config')) { return $this->build_fallback_control_config($control_key, $field, $type); } return $control->get_config($control_key, $field); } /** * Fallback control config for unknown types (array equivalent of build_fallback_control()). * * @param string $control_key Control key * @param array $field Field configuration * @param string $type Control type * @return array */ private function build_fallback_control_config($control_key, $field, $type) { $type_const = strtoupper(preg_replace('/[^A-Za-z0-9_]/', '', (string) $type)); if ('' === $type_const) { $type_const = 'TEXT'; } $const = '\\Elementor\\Controls_Manager::' . $type_const; $args = [ // translators: dynamic user-defined control label. 'label' => esc_html(!empty($field['label']) ? $field['label'] : 'Control'), 'type' => defined($const) ? constant($const) : 'text', ]; // REPEATER must always carry a 'fields' array. if ('REPEATER' === $type_const) { $args['fields'] = []; } if (isset($field['default'])) { $args['default'] = $field['default']; } return [ 'key' => $control_key, 'responsive' => !empty($field['responsive']), 'args' => $args, ]; } /** * Build fallback control for unknown types * * @param string $control_key Control key * @param array $field Field configuration * @param string $type Control type * @return string */ private function build_fallback_control($control_key, $field, $type) { $label = !empty($field['label']) ? esc_js($field['label']) : 'Control'; // Elementor control constants are upper-case (e.g. REPEATER, SELECT). Normalise // the type to a safe constant name so the generated PHP is always valid. $type_const = strtoupper(preg_replace('/[^A-Za-z0-9_]/', '', (string) $type)); if ('' === $type_const) { $type_const = 'TEXT'; } $content = "\t\t\$this->add_control(\n"; $content .= "\t\t\t'{$control_key}',\n"; $content .= "\t\t\t[\n"; $content .= "\t\t\t\t'label' => esc_html__('{$label}', 'master-addons'),\n"; $content .= "\t\t\t\t'type' => Controls_Manager::{$type_const},\n"; // REPEATER must always carry a 'fields' array, otherwise Elementor's // sanitize_settings() throws a TypeError when iterating null fields. if ('REPEATER' === $type_const) { $content .= "\t\t\t\t'fields' => array(),\n"; } if (isset($field['default'])) { $default = $this->export_default_value($field['default']); $content .= "\t\t\t\t'default' => {$default},\n"; } $content .= "\t\t\t]\n"; $content .= "\t\t);\n\n"; return $content; } /** * Convert a control default value into a valid PHP literal for the generated file. * Arrays (e.g. repeater/group-control defaults) must never be interpolated directly, * which would emit the literal token "Array" and produce a fatal parse error. * * @param mixed $value * @return string */ private function export_default_value($value) { if (is_array($value)) { // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_var_export -- generating PHP source, not debug output return var_export($value, true); } if (is_bool($value)) { return $value ? 'true' : 'false'; } if (is_int($value) || is_float($value)) { return (string) $value; } if (null === $value) { return "''"; } return "'" . esc_js((string) $value) . "'"; } } ```