display-conditions.php
2 weeks ago
equal-height.php
2 weeks ago
floating-effects.php
2 weeks ago
liquid-glass.php
2 weeks ago
shape-divider.php
2 weeks ago
shapes.php
2 weeks ago
tooltips.php
2 days ago
wrapper-link.php
2 weeks ago
equal-height.php
349 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Class: Equal_Height |
| 4 | * Name: Premium Equal Height |
| 5 | * Slug: premium-equal-height |
| 6 | */ |
| 7 | |
| 8 | namespace PremiumAddons\Addons; |
| 9 | |
| 10 | // PremiumAddons Classes. |
| 11 | use PremiumAddons\Includes\Controls\Premium_Select; |
| 12 | use PremiumAddons\Admin\Includes\Admin_Helper; |
| 13 | use PremiumAddons\Includes\Helper_Functions; |
| 14 | |
| 15 | // Elementor Classes. |
| 16 | use Elementor\Repeater; |
| 17 | use Elementor\Controls_Manager; |
| 18 | |
| 19 | |
| 20 | if ( ! defined( 'ABSPATH' ) ) { |
| 21 | exit; |
| 22 | } |
| 23 | |
| 24 | /** |
| 25 | * Class Equal_Height |
| 26 | * |
| 27 | * @since 4.11.58 |
| 28 | * @access public |
| 29 | * @package PremiumAddons\Addons |
| 30 | */ |
| 31 | class Equal_Height { |
| 32 | |
| 33 | /** |
| 34 | * Load Script |
| 35 | * |
| 36 | * @var bool|null |
| 37 | */ |
| 38 | private static $load_script = null; |
| 39 | |
| 40 | /** |
| 41 | * Class object |
| 42 | * |
| 43 | * @var self|null |
| 44 | */ |
| 45 | private static $instance = null; |
| 46 | |
| 47 | /** |
| 48 | * Class Constructor Function. |
| 49 | */ |
| 50 | public function __construct() { |
| 51 | |
| 52 | // Enqueue the required JS file. |
| 53 | add_action( 'elementor/preview/enqueue_scripts', array( $this, 'enqueue_scripts' ) ); |
| 54 | |
| 55 | // Create Premium Equal Height tab at the end of section layout tab. |
| 56 | add_action( 'elementor/element/section/section_advanced/after_section_end', array( $this, 'register_controls' ), 10 ); |
| 57 | |
| 58 | add_action( 'elementor/section/print_template', array( $this, 'print_template' ), 10, 1 ); |
| 59 | |
| 60 | // Insert data before section rendering. |
| 61 | add_action( 'elementor/frontend/section/before_render', array( $this, 'before_render' ), 10, 1 ); |
| 62 | |
| 63 | // Check if scripts should be loaded. |
| 64 | add_action( 'elementor/frontend/section/before_render', array( $this, 'check_script_enqueue' ) ); |
| 65 | |
| 66 | add_action( 'elementor/element/container/section_layout/after_section_end', array( $this, 'register_controls' ), 10 ); |
| 67 | add_action( 'elementor/container/print_template', array( $this, 'print_template' ), 10, 1 ); |
| 68 | add_action( 'elementor/frontend/container/before_render', array( $this, 'before_render' ), 100, 1 ); |
| 69 | add_action( 'elementor/frontend/container/before_render', array( $this, 'check_script_enqueue' ) ); |
| 70 | } |
| 71 | |
| 72 | /** |
| 73 | * Enqueue scripts. |
| 74 | * |
| 75 | * Registers required dependencies for the extension and enqueues them. |
| 76 | * |
| 77 | * @since 1.6.5 |
| 78 | * @access public |
| 79 | */ |
| 80 | public function enqueue_scripts() { |
| 81 | |
| 82 | if ( ! wp_script_is( 'pa-eq-height', 'enqueued' ) ) { |
| 83 | wp_enqueue_script( 'pa-eq-height' ); |
| 84 | } |
| 85 | } |
| 86 | |
| 87 | /** |
| 88 | * Register Premium Equal Height controls. |
| 89 | * |
| 90 | * @access public |
| 91 | * @param object $element for current element. |
| 92 | */ |
| 93 | public function register_controls( $element ) { |
| 94 | |
| 95 | $element->start_controls_section( |
| 96 | 'section_premium_eq_height', |
| 97 | array( |
| 98 | 'label' => sprintf( '<i class="pa-extension-icon pa-dash-icon"></i> %s', __( 'Equal Height', 'premium-addons-for-elementor' ) ), |
| 99 | 'tab' => Controls_Manager::TAB_ADVANCED, |
| 100 | ) |
| 101 | ); |
| 102 | |
| 103 | $element->add_control( |
| 104 | 'premium_eq_height_update', |
| 105 | array( |
| 106 | 'label' => '<div class="elementor-update-preview editor-pa-preview-update" style="background-color: #fff;"><div class="elementor-update-preview-title">Update changes to page</div><div class="elementor-update-preview-button-wrapper"><button class="elementor-update-preview-button elementor-button elementor-button-success">Apply</button></div></div>', |
| 107 | 'type' => Controls_Manager::RAW_HTML, |
| 108 | ) |
| 109 | ); |
| 110 | |
| 111 | $element->add_control( |
| 112 | 'premium_eq_height_switcher', |
| 113 | array( |
| 114 | 'label' => __( 'Enable Equal Height', 'premium-addons-for-elementor' ), |
| 115 | 'type' => Controls_Manager::SWITCHER, |
| 116 | 'return_value' => 'yes', |
| 117 | 'render_type' => 'template', |
| 118 | 'prefix_class' => 'premium-equal-height-', |
| 119 | 'frontend_available' => true, |
| 120 | ) |
| 121 | ); |
| 122 | |
| 123 | $element->add_control( |
| 124 | 'premium_eq_height_type', |
| 125 | array( |
| 126 | 'label' => __( 'Apply on', 'premium-addons-for-elementor' ), |
| 127 | 'type' => Controls_Manager::SELECT, |
| 128 | 'default' => 'widget', |
| 129 | 'options' => array( |
| 130 | 'widget' => __( 'Widgets', 'premium-addons-for-elementor' ), |
| 131 | 'custom' => __( 'Custom Selector', 'premium-addons-for-elementor' ), |
| 132 | ), |
| 133 | 'condition' => array( |
| 134 | 'premium_eq_height_switcher' => 'yes', |
| 135 | ), |
| 136 | ) |
| 137 | ); |
| 138 | |
| 139 | $element->add_control( |
| 140 | 'premium_eq_height_target', |
| 141 | array( |
| 142 | 'label' => __( 'Widgets', 'premium-addons-for-elementor' ), |
| 143 | 'type' => Premium_Select::TYPE, |
| 144 | 'render_type' => 'template', |
| 145 | 'label_block' => true, |
| 146 | 'multiple' => true, |
| 147 | 'frontend_available' => true, |
| 148 | 'condition' => array( |
| 149 | 'premium_eq_height_switcher' => 'yes', |
| 150 | 'premium_eq_height_type' => 'widget', |
| 151 | ), |
| 152 | ) |
| 153 | ); |
| 154 | |
| 155 | $element->add_control( |
| 156 | 'premium_eq_height_custom_target', |
| 157 | array( |
| 158 | 'label' => __( 'Selectors', 'premium-addons-for-elementor' ), |
| 159 | 'type' => Controls_Manager::TEXT, |
| 160 | 'label_block' => true, |
| 161 | 'placeholder' => __( '.class-name, .class-name2 .my-custom-class', 'premium-addons-for-elementor' ), |
| 162 | 'description' => __( 'Enter selectors separated with \' , \' ', 'premium-addons-for-elementor' ), |
| 163 | 'condition' => array( |
| 164 | 'premium_eq_height_switcher' => 'yes', |
| 165 | 'premium_eq_height_type' => 'custom', |
| 166 | ), |
| 167 | ) |
| 168 | ); |
| 169 | |
| 170 | $element->add_control( |
| 171 | 'premium_eq_height_trigger', |
| 172 | array( |
| 173 | 'label' => __( 'Trigger on', 'premium-addons-for-elementor' ), |
| 174 | 'type' => Controls_Manager::SELECT, |
| 175 | 'options' => array( |
| 176 | 'load' => __( 'Page Load', 'premium-addons-for-elementor' ), |
| 177 | 'scroll' => __( 'Scroll', 'premium-addons-for-elementor' ), |
| 178 | ), |
| 179 | 'default' => 'load', |
| 180 | 'condition' => array( |
| 181 | 'premium_eq_height_switcher' => 'yes', |
| 182 | ), |
| 183 | ) |
| 184 | ); |
| 185 | |
| 186 | $element->add_control( |
| 187 | 'premium_eq_height_enable_on', |
| 188 | array( |
| 189 | 'label' => __( 'Enable Equal Height on', 'premium-addons-for-elementor' ), |
| 190 | 'type' => Controls_Manager::SELECT2, |
| 191 | 'multiple' => true, |
| 192 | 'options' => Helper_Functions::get_all_breakpoints(), |
| 193 | 'label_block' => true, |
| 194 | 'default' => Helper_Functions::get_all_breakpoints( 'keys' ), |
| 195 | 'condition' => array( |
| 196 | 'premium_eq_height_switcher' => 'yes', |
| 197 | ), |
| 198 | ) |
| 199 | ); |
| 200 | |
| 201 | $docs = array( |
| 202 | 'https://premiumaddons.com/docs/elementor-column-equal-height/' => __( 'How to use Premium Equal Height feature »', 'premium-addons-for-elementor' ), |
| 203 | 'https://www.youtube.com/watch?v=ZaZ163p-saA' => __( 'Video tutorial »', 'premium-addons-for-elementor' ), |
| 204 | ); |
| 205 | |
| 206 | $doc_index = 1; |
| 207 | foreach ( $docs as $url => $title ) { |
| 208 | |
| 209 | $doc_url = Helper_Functions::get_campaign_link( $url, 'eq-height-addon', 'wp-editor', 'get-support' ); |
| 210 | |
| 211 | $element->add_control( |
| 212 | 'doc_' . $doc_index, |
| 213 | array( |
| 214 | 'type' => Controls_Manager::RAW_HTML, |
| 215 | 'raw' => sprintf( '<a href="%s" target="_blank">%s</a>', $doc_url, $title ), |
| 216 | 'content_classes' => 'editor-pa-doc', |
| 217 | ) |
| 218 | ); |
| 219 | |
| 220 | ++$doc_index; |
| 221 | |
| 222 | } |
| 223 | |
| 224 | $element->end_controls_section(); |
| 225 | } |
| 226 | |
| 227 | /** |
| 228 | * Render Premium Equal Height output in the editor. |
| 229 | * |
| 230 | * Written as a Backbone JavaScript template and used to generate the live preview. |
| 231 | * |
| 232 | * @since 4.2.5 |
| 233 | * @access public |
| 234 | * @param string $template for current template. |
| 235 | */ |
| 236 | public function print_template( $template ) { |
| 237 | |
| 238 | $old_template = $template; |
| 239 | ob_start(); |
| 240 | |
| 241 | ?> |
| 242 | <# if( 'yes' === settings.premium_eq_height_switcher ) { |
| 243 | |
| 244 | var targetType = settings.premium_eq_height_type, |
| 245 | |
| 246 | target = 'custom' === targetType ? settings.premium_eq_height_custom_target.split(',') : settings.premium_eq_height_target, |
| 247 | |
| 248 | addonSettings = { |
| 249 | 'targetType': targetType, |
| 250 | 'target': target, |
| 251 | 'trigger':settings.premium_eq_height_trigger, |
| 252 | 'enableOn':settings.premium_eq_height_enable_on |
| 253 | }; |
| 254 | |
| 255 | view.addRenderAttribute( 'equal_height', { |
| 256 | 'id' : 'premium-temp-equal-height-' + view.getID(), |
| 257 | 'data-pa-eq-height': JSON.stringify( addonSettings ) |
| 258 | }); |
| 259 | |
| 260 | #> |
| 261 | <div {{{ view.getRenderAttributeString( 'equal_height' ) }}}></div> |
| 262 | <# } #> |
| 263 | <?php |
| 264 | |
| 265 | $element_content = ob_get_contents(); |
| 266 | |
| 267 | ob_end_clean(); |
| 268 | |
| 269 | $template = $element_content . $old_template; |
| 270 | return $template; |
| 271 | } |
| 272 | |
| 273 | /** |
| 274 | * Render Premium Equal Height output on the frontend. |
| 275 | * |
| 276 | * Written in PHP and used to generate the final HTML. |
| 277 | * |
| 278 | * @since 4.2.5 |
| 279 | * @access public |
| 280 | * |
| 281 | * @param object $element for current element. |
| 282 | */ |
| 283 | public function before_render( $element ) { |
| 284 | |
| 285 | $settings = $element->get_settings_for_display(); |
| 286 | |
| 287 | if ( 'yes' === $settings['premium_eq_height_switcher'] ) { |
| 288 | |
| 289 | $target_type = $settings['premium_eq_height_type']; |
| 290 | |
| 291 | $target = ( 'custom' === $target_type ) ? explode( ',', $settings['premium_eq_height_custom_target'] ) : $settings['premium_eq_height_target']; |
| 292 | |
| 293 | $addon_settings = array( |
| 294 | 'targetType' => $target_type, |
| 295 | 'target' => $target, |
| 296 | 'trigger' => $settings['premium_eq_height_trigger'], |
| 297 | 'enableOn' => $settings['premium_eq_height_enable_on'], |
| 298 | ); |
| 299 | |
| 300 | $element->add_render_attribute( '_wrapper', 'data-pa-eq-height', wp_json_encode( $addon_settings ) ); |
| 301 | } |
| 302 | } |
| 303 | |
| 304 | /** |
| 305 | * Check Script Enqueue |
| 306 | * |
| 307 | * Check if the script files should be loaded. |
| 308 | * |
| 309 | * @since 4.7.7 |
| 310 | * @access public |
| 311 | * |
| 312 | * @param object $element for current element. |
| 313 | */ |
| 314 | public function check_script_enqueue( $element ) { |
| 315 | |
| 316 | if ( self::$load_script ) { |
| 317 | return; |
| 318 | } |
| 319 | |
| 320 | if ( 'yes' === $element->get_settings_for_display( 'premium_eq_height_switcher' ) ) { |
| 321 | $this->enqueue_scripts(); |
| 322 | |
| 323 | self::$load_script = true; |
| 324 | |
| 325 | remove_action( 'elementor/frontend/section/before_render', array( $this, 'check_script_enqueue' ) ); |
| 326 | remove_action( 'elementor/frontend/container/before_render', array( $this, 'check_script_enqueue' ) ); |
| 327 | } |
| 328 | } |
| 329 | |
| 330 | /** |
| 331 | * Creates and returns an instance of the class |
| 332 | * |
| 333 | * @since 4.2.5 |
| 334 | * @access public |
| 335 | * |
| 336 | * @return object |
| 337 | */ |
| 338 | public static function get_instance() { |
| 339 | |
| 340 | if ( ! isset( self::$instance ) ) { |
| 341 | |
| 342 | self::$instance = new self(); |
| 343 | |
| 344 | } |
| 345 | |
| 346 | return self::$instance; |
| 347 | } |
| 348 | } |
| 349 |