| Dir : /home/trave494/bilosproperties.com/wp-content/plugins/js_composer/include/params/ |
| Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 IP: 209.182.202.254 |
| Dir : /home/trave494/bilosproperties.com/wp-content/plugins/js_composer/include/params/params.php |
<?php
/**
* WPBakery Visual Composer shortcodes attributes class.
*
* This class and functions represents ability which will allow you to create attributes settings fields to
* control new attributes.
* New attributes can be added to shortcode settings by using param array in wp_map function
*
* @package WPBakeryVisualComposer
*
*/
/**
* Shortcode params class allows to create new params types.
* class WpbakeryShortcodeParams
* @since 4.2
*/
class WpbakeryShortcodeParams {
/**
* @since 4.2
* @var array - store shortcode attributes types
*/
protected static $params = array();
/**
* @since 4.2
* @var array - store shortcode javascript files urls
*/
protected static $scripts = array();
/**
* @since 4.2
* @var array
*/
protected static $enqueue_script = array();
/**
* @since 4.2
* @var array
*/
protected static $scripts_to_register = array();
/**
* @since 4.2
* @var bool
*/
protected static $is_enqueue = false;
/**
* @since 4.2
*
* @param $script
*/
public static function registerScript( $script ) {
$script_name = 'vc_edit_form_enqueue_script_' . md5( $script );
self::$enqueue_script[] = array( 'name' => $script_name, 'script' => $script );
}
/**
* @since 4.2
*/
public static function enqueueScripts() {
if ( self::isEnqueue() ) {
foreach ( self::$enqueue_script as $item ) {
wp_register_script( $item['name'], $item['script'], array(
'jquery',
'wp-color-picker',
'wpb_js_composer_js_view'
), WPB_VC_VERSION, true );
wp_enqueue_script( $item['name'] );
}
}
}
/**
* Create new attribute type
*
* @static
* @since 4.2
*
* @param $name - attribute name
* @param $form_field_callback - hook, will be called when settings form is shown and attribute added to shortcode
* param list
* @param $script_url - javascript file url which will be attached at the end of settings form.
*
* @return bool - return true if attribute type created
*/
public static function addField( $name, $form_field_callback, $script_url = null ) {
$result = false;
if ( ! empty( $name ) && ! empty( $form_field_callback ) ) {
self::$params[ $name ] = array(
'callbacks' => array(
'form' => $form_field_callback
)
);
$result = true;
if ( is_string( $script_url ) && ! in_array( $script_url, self::$scripts ) ) {
self::registerScript( $script_url );
self::$scripts[] = $script_url;
}
}
return $result;
}
/**
* Calls hook for attribute type
* @since 4.2
* @static
*
* @param $name - attribute name
* @param $param_settings - attribute settings from shortcode
* @param $param_value - attribute value
* @param $tag - attribute tag
*
* @return mixed|string - returns html which will be render in hook
*/
public static function renderSettingsField( $name, $param_settings, $param_value, $tag ) {
if ( isset( self::$params[ $name ]['callbacks']['form'] ) ) {
return call_user_func( self::$params[ $name ]['callbacks']['form'], $param_settings, $param_value, $tag );
}
return '';
}
/**
* List of javascript files urls for shortcode attributes.
* @since 4.2
* @static
* @return array - list of js scripts
*/
public static function getScripts() {
return self::$scripts;
}
/**
* @since 4.2
*
* @param $value
*/
public static function setEnqueue( $value ) {
self::$is_enqueue = (boolean) $value;
}
/**
* @since 4.2
* @return bool
*/
public static function isEnqueue() {
return self::$is_enqueue;
}
}
/**
* Helper function to register new shortcode attribute hook.
*
* @param $name - attribute name
* @param $form_field_callback - hook, will be called when settings form is shown and attribute added to shortcode
* param list
* @param $script_url - javascript file url which will be attached at the end of settings form.
*
* @since 4.4
* @return bool
*/
function vc_add_shortcode_param( $name, $form_field_callback, $script_url = null ) {
return WpbakeryShortcodeParams::addField( $name, $form_field_callback, $script_url );
}
/**
* Helper function to register new shortcode attribute hook.
*
* @param $name - attribute name
* @param $form_field_callback - hook, will be called when settings form is shown and attribute added to shortcode
* param list
* @param $script_url - javascript file url which will be attached at the end of settings form.
*
* @since 4.2
* @deprecated due to without prefix name
* @return bool
*/
function add_shortcode_param( $name, $form_field_callback, $script_url = null ) {
return vc_add_shortcode_param( $name, $form_field_callback, $script_url );
}
/**
* Call hook for attribute.
*
* @param $name - attribute name
* @param $param_settings - attribute settings from shortcode
* @param $param_value - attribute value
* @param $tag - attribute tag
*
* @since 4.2
* @deprecated due to without prefix function
* @return mixed|string - returns html which will be render in hook
*/
function do_shortcode_param_settings_field( $name, $param_settings, $param_value, $tag ) {
return vc_do_shortcode_param_settings_field( $name, $param_settings, $param_value, $tag );
}
/**
* Call hook for attribute.
*
* @param $name - attribute name
* @param $param_settings - attribute settings from shortcode
* @param $param_value - attribute value
* @param $tag - attribute tag
*
* @since 4.4
* @return mixed|string - returns html which will be render in hook
*/
function vc_do_shortcode_param_settings_field( $name, $param_settings, $param_value, $tag ) {
return WpbakeryShortcodeParams::renderSettingsField( $name, $param_settings, $param_value, $tag );
}
/**
* Helper function to create tag attributes string for linked attributes of shortcode.
*
* @param $settings
*
* @since 4.2
* @return string
* @deprecated
*/
function vc_generate_dependencies_attributes( $settings ) {
return '';
}