';
if ( ! empty( $args['title'] ) ) {
// if its a shortcode and there is a title try to grab the title wrappers
$shortcode_args = array( 'before_title' => '', 'after_title' => '' );
if ( empty( $instance ) ) {
global $wp_registered_sidebars;
if ( ! empty( $wp_registered_sidebars ) ) {
foreach ( $wp_registered_sidebars as $sidebar ) {
if ( ! empty( $sidebar['before_title'] ) ) {
$shortcode_args['before_title'] = $sidebar['before_title'];
$shortcode_args['after_title'] = $sidebar['after_title'];
break;
}
}
}
}
$output .= $this->output_title( $shortcode_args, $args );
}
$output .= $main_content;
$output .= '
';
} elseif ( $main_content && $no_wrap ) {
$output .= $main_content;
}
// if preview show a placeholder if empty
if ( $this->is_preview() && $output == '' ) {
$output = $this->preview_placeholder_text( "{{" . $this->base_id . "}}" );
}
return apply_filters( 'wp_super_duper_widget_output', $output, $args, $shortcode_args, $this );
}
/**
* Placeholder text to show if output is empty and we are on a preview/builder page.
*
* @param string $name
*
* @return string
*/
public function preview_placeholder_text( $name = '' ) {
return "" . sprintf( __( 'Placeholder for: %s' ), $name ) . "
";
}
/**
* Sometimes booleans values can be turned to strings, so we fix that.
*
* @param $options
*
* @return mixed
*/
public function string_to_bool( $options ) {
// convert bool strings to booleans
foreach ( $options as $key => $val ) {
if ( $val == 'false' ) {
$options[ $key ] = false;
} elseif ( $val == 'true' ) {
$options[ $key ] = true;
}
}
return $options;
}
/**
* Get the argument values that are also filterable.
*
* @param $instance
*
* @return array
*@since 1.0.12 Don't set checkbox default value if the value is empty.
*
*/
public function argument_values( $instance ) {
$argument_values = array();
// set widget instance
$this->instance = $instance;
if ( empty( $this->arguments ) ) {
$this->arguments = $this->get_arguments();
}
if ( ! empty( $this->arguments ) ) {
foreach ( $this->arguments as $key => $args ) {
// set the input name from the key
$args['name'] = $key;
//
$argument_values[ $key ] = isset( $instance[ $key ] ) ? $instance[ $key ] : '';
if ( $args['type'] == 'checkbox' && $argument_values[ $key ] == '' ) {
// don't set default for an empty checkbox
} elseif ( $argument_values[ $key ] == '' && isset( $args['default'] ) ) {
$argument_values[ $key ] = $args['default'];
}
}
}
return $argument_values;
}
/**
* Set arguments in super duper.
*
* @return array Set arguments.
*@since 1.0.0
*
*/
public function set_arguments() {
return $this->arguments;
}
/**
* Get arguments in super duper.
*
* @return array Get arguments.
*@since 1.0.0
*
*/
public function get_arguments() {
if ( empty( $this->arguments ) ) {
$this->arguments = $this->set_arguments();
}
$this->arguments = apply_filters( 'wp_super_duper_arguments', $this->arguments, $this->options, $this->instance );
$this->arguments = $this->add_name_from_key( $this->arguments, true );
return $this->arguments;
}
/**
* This is the main output class for all 3 items, widget, shortcode and block, it is extended in the calling class.
*
* @param array $args
* @param array $widget_args
* @param string $content
*/
public function output( $args = array(), $widget_args = array(), $content = '' ) {
}
/**
* Add the dynamic block code inline when the wp-block in enqueued.
*/
public function register_block() {
wp_add_inline_script( 'wp-blocks', $this->block() );
if ( class_exists( 'SiteOrigin_Panels' ) ) {
wp_add_inline_script( 'wp-blocks', $this->siteorigin_js() );
}
}
/**
* Check if we need to show advanced options.
*
* @return bool
*/
public function block_show_advanced() {
$show = false;
$arguments = $this->get_arguments();
if ( ! empty( $arguments ) ) {
foreach ( $arguments as $argument ) {
if ( isset( $argument['advanced'] ) && $argument['advanced'] ) {
$show = true;
break; // no need to continue if we know we have it
}
}
}
return $show;
}
/**
* Get the url path to the current folder.
*
* @return string
*/
public function get_url() {
$url = $this->url;
if ( ! $url ) {
$content_dir = wp_normalize_path( untrailingslashit( WP_CONTENT_DIR ) );
$content_url = untrailingslashit( WP_CONTENT_URL );
// Replace http:// to https://.
if ( strpos( $content_url, 'http://' ) === 0 && strpos( plugins_url(), 'https://' ) === 0 ) {
$content_url = str_replace( 'http://', 'https://', $content_url );
}
// Check if we are inside a plugin
$file_dir = str_replace( "/includes", "", wp_normalize_path( dirname( __FILE__ ) ) );
$url = str_replace( $content_dir, $content_url, $file_dir );
$url = trailingslashit( $url );
$this->url = $url;
}
return $url;
}
/**
* Get the url path to the current folder.
*
* @return string
*/
public function get_url_old() {
$url = $this->url;
if ( ! $url ) {
// check if we are inside a plugin
$file_dir = str_replace( "/includes", "", dirname( __FILE__ ) );
$dir_parts = explode( "/wp-content/", $file_dir );
$url_parts = explode( "/wp-content/", plugins_url() );
if ( ! empty( $url_parts[0] ) && ! empty( $dir_parts[1] ) ) {
$url = trailingslashit( $url_parts[0] . "/wp-content/" . $dir_parts[1] );
$this->url = $url;
}
}
return $url;
}
/**
* Generate the block icon.
*
* Enables the use of Font Awesome icons.
*
* @note xlink:href is actually deprecated but href is not supported by all so we use both.
*
* @param $icon
*
* @return string
*@since 1.1.0
*/
public function get_block_icon( $icon ) {
// check if we have a Font Awesome icon
$fa_type = '';
if ( substr( $icon, 0, 7 ) === "fas fa-" ) {
$fa_type = 'solid';
} elseif ( substr( $icon, 0, 7 ) === "far fa-" ) {
$fa_type = 'regular';
} elseif ( substr( $icon, 0, 7 ) === "fab fa-" ) {
$fa_type = 'brands';
} else {
$icon = "'" . $icon . "'";
}
// set the icon if we found one
if ( $fa_type ) {
$fa_icon = str_replace( array( "fas fa-", "far fa-", "fab fa-" ), "", $icon );
$icon = "el('svg',{width: 20, height: 20, viewBox: '0 0 20 20'},el('use', {'xlink:href': '" . $this->get_url() . "icons/" . $fa_type . ".svg#" . $fa_icon . "','href': '" . $this->get_url() . "icons/" . $fa_type . ".svg#" . $fa_icon . "'}))";
}
return $icon;
}
public function group_arguments( $arguments ) {
// echo '###';print_r($arguments);
if ( ! empty( $arguments ) ) {
$temp_arguments = array();
$general = __( "General" );
$add_sections = false;
foreach ( $arguments as $key => $args ) {
if ( isset( $args['group'] ) ) {
$temp_arguments[ $args['group'] ][ $key ] = $args;
$add_sections = true;
} else {
$temp_arguments[ $general ][ $key ] = $args;
}
}
// only add sections if more than one
if ( $add_sections ) {
$arguments = $temp_arguments;
}
}
// echo '###';print_r($arguments);
return $arguments;
}
/**
* Output the JS for building the dynamic Guntenberg block.
*
* @return mixed
*@since 1.0.9 Save numbers as numbers and not strings.
* @since 1.1.0 Font Awesome classes can be used for icons.
* @since 1.0.4 Added block_wrap property which will set the block wrapping output element ie: div, span, p or empty for no wrap.
*/
public function block() {
global $sd_is_js_functions_loaded;
ob_start();
$show_advanced = $this->block_show_advanced();
?>
tags for code highlighting, so we strip them from the output.
*/
return str_replace( array(
''
), '', $output );
}
public function block_row_start($key, $args){
// check for row
if(!empty($args['row'])){
if(!empty($args['row']['open'])){
// element require
$element_require = ! empty( $args['element_require'] ) ? $this->block_props_replace( $args['element_require'], true ) . " && " : "";
$device_type = ! empty( $args['device_type'] ) ? esc_attr($args['device_type']) : '';
$device_type_require = ! empty( $args['device_type'] ) ? " deviceType == '" . esc_attr($device_type) . "' && " : '';
$device_type_icon = '';
if($device_type=='Desktop'){
$device_type_icon = '" . esc_attr( $this->options['widget_ops']['description'] ) . "
";
$arguments_raw = $this->get_arguments();
if ( is_array( $arguments_raw ) ) {
$arguments = $this->group_arguments( $arguments_raw );
// Do we have sections?
$has_sections = $arguments == $arguments_raw ? false : true;
if ( $has_sections ) {
$panel_count = 0;
foreach ( $arguments as $key => $args ) {
?>
" . esc_attr( $key ) . " ";
foreach ( $args as $k => $a ) {
$this->widget_inputs_row_start($k, $a);
$this->widget_inputs( $a, $instance );
$this->widget_inputs_row_end($k, $a);
}
echo "
";
$panel_count ++;
}
} else {
foreach ( $arguments as $key => $args ) {
$this->widget_inputs_row_start($key, $args);
$this->widget_inputs( $args, $instance );
$this->widget_inputs_row_end($key, $args);
}
}
}
}
public function widget_inputs_row_start($key, $args){
if(!empty($args['row'])){
// maybe open
if(!empty($args['row']['open'])){
?>
' data-element_require='convert_element_require( $args['row']['element_require'] );
} ?>'>
'>
";
}else{
echo "
";
}
}
}
public function widget_inputs_row_end($key, $args){
if(!empty($args['row'])){
// maybe close
if(!empty($args['row']['close'])){
echo "
";
}
echo "
";
}
}
/**
* Get the hidden input that when added makes the advanced button show on widget settings.
*
* @return string
*/
public function widget_advanced_toggle() {
$output = '';
if ( $this->block_show_advanced() ) {
$val = 1;
} else {
$val = 0;
}
$output .= "
";
return $output;
}
/**
* Convert require element.
*
* @param string $input Input element.
*
* @return string $output
*@since 1.0.0
*
*/
public function convert_element_require( $input ) {
$input = str_replace( "'", '"', $input );// we only want double quotes
$output = esc_attr( str_replace( array( "[%", "%]" ), array(
"jQuery(form).find('[data-argument=\"",
"\"]').find('input,select,textarea').val()"
), $input ) );
return $output;
}
/**
* Builds the inputs for the widget options.
*
* @param $args
* @param $instance
*/
public function widget_inputs( $args, $instance ) {
$class = "";
$element_require = "";
$custom_attributes = "";
// get value
if ( isset( $instance[ $args['name'] ] ) ) {
$value = $instance[ $args['name'] ];
} elseif ( ! isset( $instance[ $args['name'] ] ) && ! empty( $args['default'] ) ) {
$value = is_array( $args['default'] ) ? array_map( "esc_html", $args['default'] ) : esc_html( $args['default'] );
} else {
$value = '';
}
// get placeholder
if ( ! empty( $args['placeholder'] ) ) {
$placeholder = "placeholder='" . esc_html( $args['placeholder'] ) . "'";
} else {
$placeholder = '';
}
// get if advanced
if ( isset( $args['advanced'] ) && $args['advanced'] ) {
$class .= " sd-advanced-setting ";
}
// element_require
if ( isset( $args['element_require'] ) && $args['element_require'] ) {
$element_require = $args['element_require'];
}
// custom_attributes
if ( isset( $args['custom_attributes'] ) && $args['custom_attributes'] ) {
$custom_attributes = $this->array_to_attributes( $args['custom_attributes'], true );
}
// before wrapper
?>
'
data-element_require='convert_element_require( $element_require );
} ?>'
>
class="widefat"
id="get_field_id( $args['name'] ) ); ?>"
name="get_field_name( $args['name'] ) ); ?>"
type=""
value="">
class="widefat" id="get_field_id( $args['name'] ) ); ?>"
name="get_field_name( $args['name'] ) ); ?>" type="checkbox"
value="1">
';
}elseif($icon=='box-right'){
return '
';
}elseif($icon=='box-bottom'){
return '
';
}elseif($icon=='box-left'){
return '
';
}
}
/**
* Get the widget input description html.
*
* @param $args
*
* @return string
* @todo, need to make its own tooltip script
*/
public function widget_field_desc( $args ) {
$description = '';
if ( isset( $args['desc'] ) && $args['desc'] ) {
if ( isset( $args['desc_tip'] ) && $args['desc_tip'] ) {
$description = $this->desc_tip( $args['desc'] );
} else {
$description = '
' . wp_kses_post( $args['desc'] ) . '';
}
}
return $description;
}
/**
* Get the widget input title html.
*
* @param $args
*
* @return string
*/
public function widget_field_title( $args ) {
$title = '';
if ( isset( $args['title'] ) && $args['title'] ) {
if ( isset( $args['icon'] ) && $args['icon'] ) {
$title = self::get_widget_icon( $args['icon'], $args['title'] );
} else {
$title = esc_attr($args['title']);
}
}
return $title;
}
/**
* Get the tool tip html.
*
* @param $tip
* @param bool $allow_html
*
* @return string
*/
function desc_tip( $tip, $allow_html = false ) {
if ( $allow_html ) {
$tip = $this->sanitize_tooltip( $tip );
} else {
$tip = esc_attr( $tip );
}
return '
';
}
/**
* Sanitize a string destined to be a tooltip.
*
* @param string $var
*
* @return string
*/
public function sanitize_tooltip( $var ) {
return htmlspecialchars( wp_kses( html_entity_decode( $var ), array(
'br' => array(),
'em' => array(),
'strong' => array(),
'small' => array(),
'span' => array(),
'ul' => array(),
'li' => array(),
'ol' => array(),
'p' => array(),
) ) );
}
/**
* Processing widget options on save
*
* @param array $new_instance The new options
* @param array $old_instance The previous options
*
* @return array
* @todo we should add some sanitation here.
*/
public function update( $new_instance, $old_instance ) {
//save the widget
$instance = array_merge( (array) $old_instance, (array) $new_instance );
// set widget instance
$this->instance = $instance;
if ( empty( $this->arguments ) ) {
$this->get_arguments();
}
// check for checkboxes
if ( ! empty( $this->arguments ) ) {
foreach ( $this->arguments as $argument ) {
if ( isset( $argument['type'] ) && $argument['type'] == 'checkbox' && ! isset( $new_instance[ $argument['name'] ] ) ) {
$instance[ $argument['name'] ] = '0';
}
}
}
return $instance;
}
/**
* Checks if the current call is a ajax call to get the block content.
*
* This can be used in your widget to return different content as the block content.
*
* @return bool
*@since 1.0.3
*/
public function is_block_content_call() {
$result = false;
if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && $_REQUEST['action'] == 'super_duper_output_shortcode' ) {
$result = true;
}
return $result;
}
/**
* Get an instance hash that will be unique to the type and settings.
*
* @return string
*@since 1.0.20
*/
public function get_instance_hash(){
$instance_string = $this->base_id.serialize($this->instance);
return hash('crc32b',$instance_string);
}
/**
* Generate and return inline styles from CSS rules that will match the unique class of the instance.
*
* @param array $rules
*
* @return string
*@since 1.0.20
*/
public function get_instance_style($rules = array()){
$css = '';
if(!empty($rules)){
$rules = array_unique($rules);
$instance_hash = $this->get_instance_hash();
$css .= "";
}
return $css;
}
/**
* Encode shortcodes tags.
*
* @param string $content Content to search for shortcode tags.
*
*@return string Content with shortcode tags removed.
*@since 1.0.28
*
*/
public function encode_shortcodes( $content ) {
// Avoids existing encoded tags.
$trans = array(
'[' => '[',
']' => ']',
'[' => '[',
']' => ']',
'<' => '&0lt;',
'>' => '&0gt;',
'<' => '&0lt;',
'>' => '&0gt;',
);
$content = strtr( $content, $trans );
$trans = array(
'[' => '[',
']' => ']',
'<' => '<',
'>' => '>',
'"' => '"',
"'" => ''',
);
$content = strtr( $content, $trans );
return $content;
}
/**
* Remove encoded shortcod tags.
*
* @param string $content Content to search for shortcode tags.
*
*@return string Content with decoded shortcode tags.
*@since 1.0.28
*
*/
public function decode_shortcodes( $content ) {
$trans = array(
'[' => '[',
']' => ']',
'[' => '[',
']' => ']',
'<' => '<',
'>' => '>',
'<' => '<',
'>' => '>',
'"' => '"',
''' => "'",
);
$content = strtr( $content, $trans );
$trans = array(
'[' => '[',
']' => ']',
'[' => '[',
']' => ']',
'&0lt;' => '<',
'&0gt;' => '>',
'&0lt;' => '<',
'&0gt;' => '>',
);
$content = strtr( $content, $trans );
return $content;
}
}
}