'; } } /** * Helper function to display sections. * * This function is used in AJAX to add a new section * and when section have already been added and saved. * * @param int $key The array key for the current element. * @param array An array of values for the current section. * * @return void * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_contextual_help_view' ) ) { function ot_contextual_help_view( $name, $key, $content = array() ) { return ' '; } } /** * Helper function to display sections. * * @param string $key * @param string $data * @param string $active_layout * * @return void * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_layout_view' ) ) { function ot_layout_view( $key, $data = '', $active_layout = '' ) { return ' '; } } /** * Helper function to display list items. * * This function is used in AJAX to add a new list items * and when they have already been added and saved. * * @param string $name The form field name. * @param int $key The array key for the current element. * @param array An array of values for the current list item. * * @return void * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_list_item_view' ) ) { function ot_list_item_view( $name, $key, $list_item = array(), $post_id = 0, $get_option = '', $settings = array(), $type = '' ) { /* required title setting */ $required_setting = array( array( 'id' => 'title', 'label' => __( 'Title', 'option-tree' ), 'desc' => '', 'std' => '', 'type' => 'text', 'rows' => '', 'class' => 'option-tree-setting-title', 'post_type' => '', 'choices' => array() ) ); /* load the old filterable slider settings */ if ( 'slider' == $type ) { $settings = ot_slider_settings( $name ); } /* if no settings array load the filterable list item settings */ if ( empty( $settings ) ) { $settings = ot_list_item_settings( $name ); } /* merge the two settings array */ $settings = array_merge( $required_setting, $settings ); echo ' '; } } /** * Helper function to display social links. * * This function is used in AJAX to add a new list items * and when they have already been added and saved. * * @param string $name The form field name. * @param int $key The array key for the current element. * @param array An array of values for the current list item. * * @return void * * @access public * @since 2.4.0 */ if ( ! function_exists( 'ot_social_links_view' ) ) { function ot_social_links_view( $name, $key, $list_item = array(), $post_id = 0, $get_option = '', $settings = array(), $type = '' ) { /* if no settings array load the filterable social links settings */ if ( empty( $settings ) ) { $settings = ot_social_links_settings( $name ); } echo ' '; } } /** * Helper function to display Theme Options layouts form. * * @return string * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_theme_options_layouts_form' ) ) { function ot_theme_options_layouts_form( $active = false ) { echo '

'; /* form nonce */ wp_nonce_field( 'option_tree_modify_layouts_form', 'option_tree_modify_layouts_nonce' ); /* get the saved layouts */ $layouts = get_option( ot_layouts_id() ); /* set active layout */ $active_layout = isset( $layouts['active_layout'] ) ? $layouts['active_layout'] : ''; if ( is_array( $layouts ) && count( $layouts ) > 1 ) { $active_layout = esc_attr( $layouts['active_layout'] ); echo ''; echo '

'; echo ''; foreach( $layouts as $key => $data ) { if ( $key == 'active_layout' ) continue; echo '' . esc_attr( $key ) . ''; } echo ''; echo '

'; foreach( $layouts as $key => $data ) { if ( $key == 'active_layout' ) continue; echo ''; } } /* new layout wrapper */ echo '

'; /* add new layout */ echo ''; echo '' . __( 'New Layout', 'option-tree' ) . ''; echo '

'; echo '

'; } } /** * Helper function to validate option ID's * * @param string $input The string to sanitize. * @return string * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_sanitize_option_id' ) ) { function ot_sanitize_option_id( $input ) { return preg_replace( '/[^a-z0-9]/', '_', trim( strtolower( $input ) ) ); } } /** * Helper function to validate layout ID's * * @param string $input The string to sanitize. * @return string * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_sanitize_layout_id' ) ) { function ot_sanitize_layout_id( $input ) { return preg_replace( '/[^a-z0-9]/', '-', trim( strtolower( $input ) ) ); } } /** * Convert choices array to string * * @return string * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_convert_array_to_string' ) ) { function ot_convert_array_to_string( $input ) { if ( is_array( $input ) ) { foreach( $input as $k => $choice ) { $choices[$k] = $choice['value'] . '|' . $choice['label']; if ( isset( $choice['src'] ) ) $choices[$k].= '|' . $choice['src']; } return implode( ',', $choices ); } return false; } } /** * Convert choices string to array * * @return array * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_convert_string_to_array' ) ) { function ot_convert_string_to_array( $input ) { if ( '' !== $input ) { /* empty choices array */ $choices = array(); /* exlode the string into an array */ foreach( explode( ',', $input ) as $k => $choice ) { /* if ":" is splitting the string go deeper */ if ( preg_match( '/\|/', $choice ) ) { $split = explode( '|', $choice ); $choices[$k]['value'] = trim( $split[0] ); $choices[$k]['label'] = trim( $split[1] ); /* if radio image there are three values */ if ( isset( $split[2] ) ) $choices[$k]['src'] = trim( $split[2] ); } else { $choices[$k]['value'] = trim( $choice ); $choices[$k]['label'] = trim( $choice ); } } /* return a formated choices array */ return $choices; } return false; } } /** * Helper function - strpos() with arrays. * * @param string $haystack * @param array $needles * @return bool * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_strpos_array' ) ) { function ot_strpos_array( $haystack, $needles = array() ) { foreach( $needles as $needle ) { $pos = strpos( $haystack, $needle ); if ( $pos !== false ) { return true; } } return false; } } /** * Helper function - strpos() with arrays. * * @param string $haystack * @param array $needles * @return bool * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_array_keys_exists' ) ) { function ot_array_keys_exists( $array, $keys ) { foreach($keys as $k) { if ( isset($array[$k]) ) { return true; } } return false; } } /** * Custom stripslashes from single value or array. * * @param mixed $input * @return mixed * * @access public * @since 2.0 */ if ( ! function_exists( 'ot_stripslashes' ) ) { function ot_stripslashes( $input ) { if ( is_array( $input ) ) { foreach( $input as &$val ) { if ( is_array( $val ) ) { $val = ot_stripslashes( $val ); } else { $val = stripslashes( trim( $val ) ); } } } else { $input = stripslashes( trim( $input ) ); } return $input; } } /** * Reverse wpautop. * * @param string $string The string to be filtered * @return string * * @access public * @since 2.0.9 */ if ( ! function_exists( 'ot_reverse_wpautop' ) ) { function ot_reverse_wpautop( $string = '' ) { /* return if string is empty */ if ( trim( $string ) === '' ) return ''; /* remove all new lines &

tags */ $string = str_replace( array( "\n", "

" ), "", $string ); /* replace
with \r */ $string = str_replace( array( "
", "
", "
" ), "\r", $string ); /* replace

with \r\n */ $string = str_replace( "

", "\r\n", $string ); /* return clean string */ return trim( $string ); } } /** * Returns an array of elements from start to limit, inclusive. * * Occasionally zero will be some impossibly large number to * the "E" power when creating a range from negative to positive. * This function attempts to fix that by setting that number back to "0". * * @param string $start First value of the sequence. * @param string $limit The sequence is ended upon reaching the limit value. * @param string $step If a step value is given, it will be used as the increment * between elements in the sequence. step should be given as a * positive number. If not specified, step will default to 1. * @return array * * @access public * @since 2.0.12 */ function ot_range( $start, $limit, $step = 1 ) { if ( $step < 0 ) $step = 1; $range = range( $start, $limit, $step ); foreach( $range as $k => $v ) { if ( strpos( $v, 'E' ) ) { $range[$k] = 0; } } return $range; } /** * Helper function to return encoded strings * * @return string * * @access public * @since 2.0.13 */ function ot_encode( $value ) { $func = 'base64' . '_encode'; return $func( $value ); } /** * Helper function to return decoded strings * * @return string * * @access public * @since 2.0.13 */ function ot_decode( $value ) { $func = 'base64' . '_decode'; return $func( $value ); } /** * Helper function to open a file * * @access public * @since 2.0.13 */ function ot_file_open( $handle, $mode ) { $func = 'f' . 'open'; return @$func( $handle, $mode ); } /** * Helper function to close a file * * @access public * @since 2.0.13 */ function ot_file_close( $handle ) { $func = 'f' . 'close'; return $func( $handle ); } /** * Helper function to write to an open file * * @access public * @since 2.0.13 */ function ot_file_write( $handle, $string ) { $func = 'f' . 'write'; return $func( $handle, $string ); } /** * Helper function to filter standard option values. * * @param mixed $value Saved string or array value * @param mixed $std Standard string or array value * @return mixed String or array * * @access public * @since 2.0.15 */ function ot_filter_std_value( $value = '', $std = '' ) { $std = maybe_unserialize( $std ); if ( is_array( $value ) && is_array( $std ) ) { foreach( $value as $k => $v ) { if ( '' == $value[$k] && isset( $std[$k] ) ) { $value[$k] = $std[$k]; } } } else if ( '' == $value && ! empty( $std ) ) { $value = $std; } return $value; } /** * Helper function to set the Google fonts array. * * @param string $id The option ID. * @param bool $value The option value * @return void * * @access public * @since 2.5.0 */ function ot_set_google_fonts( $id = '', $value = '' ) { $ot_set_google_fonts = get_theme_mod( 'ot_set_google_fonts', array() ); if ( is_array( $value ) && ! empty( $value ) ) { $ot_set_google_fonts[$id] = $value; } else if ( isset( $ot_set_google_fonts[$id] ) ) { unset( $ot_set_google_fonts[$id] ); } set_theme_mod( 'ot_set_google_fonts', $ot_set_google_fonts ); } /** * Helper function to remove unused options from the Google fonts array. * * @param array $options The array of saved options. * @return array * * @access public * @since 2.5.0 */ function ot_update_google_fonts_after_save( $options ) { $ot_set_google_fonts = get_theme_mod( 'ot_set_google_fonts', array() ); foreach( $ot_set_google_fonts as $key => $set ) { if ( ! isset( $options[$key] ) ) { unset( $ot_set_google_fonts[$key] ); } } set_theme_mod( 'ot_set_google_fonts', $ot_set_google_fonts ); } add_action( 'ot_after_theme_options_save', 'ot_update_google_fonts_after_save', 1 ); /** * Helper function to fetch the Google fonts array. * * @param bool $normalize Whether or not to return a normalized array. Default 'true'. * @param bool $force_rebuild Whether or not to force the array to be rebuilt. Default 'false'. * @return array * * @access public * @since 2.5.0 */ function ot_fetch_google_fonts( $normalize = true, $force_rebuild = false ) { /* Google Fonts cache key */ $ot_google_fonts_cache_key = apply_filters( 'ot_google_fonts_cache_key', 'ot_google_fonts_cache' ); /* get the fonts from cache */ $ot_google_fonts = apply_filters( 'ot_google_fonts_cache', get_transient( $ot_google_fonts_cache_key ) ); if ( $force_rebuild || ! is_array( $ot_google_fonts ) || empty( $ot_google_fonts ) ) { $ot_google_fonts = array(); /* API url and key */ $ot_google_fonts_api_url = apply_filters( 'ot_google_fonts_api_url', 'https://www.googleapis.com/webfonts/v1/webfonts' ); $ot_google_fonts_api_key = apply_filters( 'ot_google_fonts_api_key', 'AIzaSyB8G-4UtQr9fhDYTiNrDP40Y5GYQQKrNWI' ); /* API arguments */ $ot_google_fonts_fields = apply_filters( 'ot_google_fonts_fields', array( 'family', 'variants', 'subsets' ) ); $ot_google_fonts_sort = apply_filters( 'ot_google_fonts_sort', 'alpha' ); /* Initiate API request */ $ot_google_fonts_query_args = array( 'key' => $ot_google_fonts_api_key, 'fields' => 'items(' . implode( ',', $ot_google_fonts_fields ) . ')', 'sort' => $ot_google_fonts_sort ); /* Build and make the request */ $ot_google_fonts_query = add_query_arg( $ot_google_fonts_query_args, $ot_google_fonts_api_url ); $ot_google_fonts_response = wp_safe_remote_get( $ot_google_fonts_query, array( 'sslverify' => false, 'timeout' => 15 ) ); /* continue if we got a valid response */ if ( 200 == wp_remote_retrieve_response_code( $ot_google_fonts_response ) ) { if ( $response_body = wp_remote_retrieve_body( $ot_google_fonts_response ) ) { /* JSON decode the response body and cache the result */ $ot_google_fonts_data = json_decode( trim( $response_body ), true ); if ( is_array( $ot_google_fonts_data ) && isset( $ot_google_fonts_data['items'] ) ) { $ot_google_fonts = $ot_google_fonts_data['items']; // Normalize the array key $ot_google_fonts_tmp = array(); foreach( $ot_google_fonts as $key => $value ) { $id = remove_accents( $value['family'] ); $id = strtolower( $id ); $id = preg_replace( '/[^a-z0-9_\-]/', '', $id ); $ot_google_fonts_tmp[$id] = $value; } $ot_google_fonts = $ot_google_fonts_tmp; set_theme_mod( 'ot_google_fonts', $ot_google_fonts ); set_transient( $ot_google_fonts_cache_key, $ot_google_fonts, WEEK_IN_SECONDS ); } } } } return $normalize ? ot_normalize_google_fonts( $ot_google_fonts ) : $ot_google_fonts; } /** * Helper function to normalize the Google fonts array. * * @param array $google_fonts An array of fonts to nrmalize. * @return array * * @access public * @since 2.5.0 */ function ot_normalize_google_fonts( $google_fonts ) { $ot_normalized_google_fonts = array(); if ( is_array( $google_fonts ) && ! empty( $google_fonts ) ) { foreach( $google_fonts as $google_font ) { if( isset( $google_font['family'] ) ) { $id = str_replace( ' ', '+', $google_font['family'] ); $ot_normalized_google_fonts[ $id ] = array( 'family' => $google_font['family'] ); if( isset( $google_font['variants'] ) ) { $ot_normalized_google_fonts[ $id ]['variants'] = $google_font['variants']; } if( isset( $google_font['subsets'] ) ) { $ot_normalized_google_fonts[ $id ]['subsets'] = $google_font['subsets']; } } } } return $ot_normalized_google_fonts; } /** * Helper function to register a WPML string * * @access public * @since 2.1 */ function ot_wpml_register_string( $id, $value ) { if ( function_exists( 'icl_register_string' ) ) { icl_register_string( 'Theme Options', $id, $value ); } } /** * Helper function to unregister a WPML string * * @access public * @since 2.1 */ function ot_wpml_unregister_string( $id ) { if ( function_exists( 'icl_unregister_string' ) ) { icl_unregister_string( 'Theme Options', $id ); } } /** * Maybe migrate Settings * * @return void * * @access public * @since 2.3.3 */ if ( ! function_exists( 'ot_maybe_migrate_settings' ) ) { function ot_maybe_migrate_settings() { // Filter the ID to migrate from $settings_id = apply_filters( 'ot_migrate_settings_id', '' ); // Attempt to migrate Settings if ( ! empty( $settings_id ) && get_option( ot_settings_id() ) === false && ot_settings_id() !== $settings_id ) { // Old settings $settings = get_option( $settings_id ); // Check for array keys if ( isset( $settings['sections'] ) && isset( $settings['settings'] ) ) { update_option( ot_settings_id(), $settings ); } } } } /** * Maybe migrate Option * * @return void * * @access public * @since 2.3.3 */ if ( ! function_exists( 'ot_maybe_migrate_options' ) ) { function ot_maybe_migrate_options() { // Filter the ID to migrate from $options_id = apply_filters( 'ot_migrate_options_id', '' ); // Attempt to migrate Theme Options if ( ! empty( $options_id ) && get_option( ot_options_id() ) === false && ot_options_id() !== $options_id ) { // Old options $options = get_option( $options_id ); // Migrate to new ID update_option( ot_options_id(), $options ); } } } /** * Maybe migrate Layouts * * @return void * * @access public * @since 2.3.3 */ if ( ! function_exists( 'ot_maybe_migrate_layouts' ) ) { function ot_maybe_migrate_layouts() { // Filter the ID to migrate from $layouts_id = apply_filters( 'ot_migrate_layouts_id', '' ); // Attempt to migrate Layouts if ( ! empty( $layouts_id ) && get_option( ot_layouts_id() ) === false && ot_layouts_id() !== $layouts_id ) { // Old options $layouts = get_option( $layouts_id ); // Migrate to new ID update_option( ot_layouts_id(), $layouts ); } } } /** * Returns an array with the post format gallery meta box. * * @param mixed $pages Excepts a comma separated string or array of * post_types and is what tells the metabox where to * display. Default 'post'. * @return array * * @access public * @since 2.4.0 */ function ot_meta_box_post_format_gallery( $pages = 'post' ) { if ( ! current_theme_supports( 'post-formats' ) || ! in_array( 'gallery', current( get_theme_support( 'post-formats' ) ) ) ) return false; if ( is_string( $pages ) ) $pages = explode( ',', $pages ); return apply_filters( 'ot_meta_box_post_format_gallery', array( 'id' => 'ot-post-format-gallery', 'title' => __( 'Gallery', 'option-tree' ), 'desc' => '', 'pages' => $pages, 'context' => 'side', 'priority' => 'low', 'fields' => array( array( 'id' => '_format_gallery', 'label' => '', 'desc' => '', 'std' => '', 'type' => 'gallery', 'class' => 'ot-gallery-shortcode' ) ) ), $pages ); } /** * Returns an array with the post format link metabox. * * @param mixed $pages Excepts a comma separated string or array of * post_types and is what tells the metabox where to * display. Default 'post'. * @return array * * @access public * @since 2.4.0 */ function ot_meta_box_post_format_link( $pages = 'post' ) { if ( ! current_theme_supports( 'post-formats' ) || ! in_array( 'link', current( get_theme_support( 'post-formats' ) ) ) ) return false; if ( is_string( $pages ) ) $pages = explode( ',', $pages ); return apply_filters( 'ot_meta_box_post_format_link', array( 'id' => 'ot-post-format-link', 'title' => __( 'Link', 'option-tree' ), 'desc' => '', 'pages' => $pages, 'context' => 'side', 'priority' => 'low', 'fields' => array( array( 'id' => '_format_link_url', 'label' => '', 'desc' => __( 'Link URL', 'option-tree' ), 'std' => '', 'type' => 'text' ), array( 'id' => '_format_link_title', 'label' => '', 'desc' => __( 'Link Title', 'option-tree' ), 'std' => '', 'type' => 'text' ) ) ), $pages ); } /** * Returns an array with the post format quote metabox. * * @param mixed $pages Excepts a comma separated string or array of * post_types and is what tells the metabox where to * display. Default 'post'. * @return array * * @access public * @since 2.4.0 */ function ot_meta_box_post_format_quote( $pages = 'post' ) { if ( ! current_theme_supports( 'post-formats' ) || ! in_array( 'quote', current( get_theme_support( 'post-formats' ) ) ) ) return false; if ( is_string( $pages ) ) $pages = explode( ',', $pages ); return apply_filters( 'ot_meta_box_post_format_quote', array( 'id' => 'ot-post-format-quote', 'title' => __( 'Quote', 'option-tree' ), 'desc' => '', 'pages' => $pages, 'context' => 'side', 'priority' => 'low', 'fields' => array( array( 'id' => '_format_quote_source_name', 'label' => '', 'desc' => __( 'Source Name (ex. author, singer, actor)', 'option-tree' ), 'std' => '', 'type' => 'text' ), array( 'id' => '_format_quote_source_url', 'label' => '', 'desc' => __( 'Source URL', 'option-tree' ), 'std' => '', 'type' => 'text' ), array( 'id' => '_format_quote_source_title', 'label' => '', 'desc' => __( 'Source Title (ex. book, song, movie)', 'option-tree' ), 'std' => '', 'type' => 'text' ), array( 'id' => '_format_quote_source_date', 'label' => '', 'desc' => __( 'Source Date', 'option-tree' ), 'std' => '', 'type' => 'text' ) ) ), $pages ); } /** * Returns an array with the post format video metabox. * * @param mixed $pages Excepts a comma separated string or array of * post_types and is what tells the metabox where to * display. Default 'post'. * @return array * * @access public * @since 2.4.0 */ function ot_meta_box_post_format_video( $pages = 'post' ) { if ( ! current_theme_supports( 'post-formats' ) || ! in_array( 'video', current( get_theme_support( 'post-formats' ) ) ) ) return false; if ( is_string( $pages ) ) $pages = explode( ',', $pages ); return apply_filters( 'ot_meta_box_post_format_video', array( 'id' => 'ot-post-format-video', 'title' => __( 'Video', 'option-tree' ), 'desc' => '', 'pages' => $pages, 'context' => 'side', 'priority' => 'low', 'fields' => array( array( 'id' => '_format_video_embed', 'label' => '', 'desc' => sprintf( __( 'Embed video from services like Youtube, Vimeo, or Hulu. You can find a list of supported oEmbed sites in the %1$s. Alternatively, you could use the built-in %2$s shortcode.', 'option-tree' ), '' . __( 'Wordpress Codex', 'option-tree' ) .'', '[video]' ), 'std' => '', 'type' => 'textarea' ) ) ), $pages ); } /** * Returns an array with the post format audio metabox. * * @param mixed $pages Excepts a comma separated string or array of * post_types and is what tells the metabox where to * display. Default 'post'. * @return array * * @access public * @since 2.4.0 */ function ot_meta_box_post_format_audio( $pages = 'post' ) { if ( ! current_theme_supports( 'post-formats' ) || ! in_array( 'audio', current( get_theme_support( 'post-formats' ) ) ) ) return false; if ( is_string( $pages ) ) $pages = explode( ',', $pages ); return apply_filters( 'ot_meta_box_post_format_audio', array( 'id' => 'ot-post-format-audio', 'title' => __( 'Audio', 'option-tree' ), 'desc' => '', 'pages' => $pages, 'context' => 'side', 'priority' => 'low', 'fields' => array( array( 'id' => '_format_audio_embed', 'label' => '', 'desc' => sprintf( __( 'Embed audio from services like SoundCloud and Rdio. You can find a list of supported oEmbed sites in the %1$s. Alternatively, you could use the built-in %2$s shortcode.', 'option-tree' ), '' . __( 'Wordpress Codex', 'option-tree' ) .'', '[audio]' ), 'std' => '', 'type' => 'textarea' ) ) ), $pages ); } /** * Returns the option type by ID. * * @param string $option_id The option ID * @return string $settings_id The settings array ID * @return string The option type. * * @access public * @since 2.4.2 */ if ( ! function_exists( 'ot_get_option_type_by_id' ) ) { function ot_get_option_type_by_id( $option_id, $settings_id = '' ) { if ( empty( $settings_id ) ) { $settings_id = ot_settings_id(); } $settings = get_option( $settings_id, array() ); if ( isset( $settings['settings'] ) ) { foreach( $settings['settings'] as $value ) { if ( $option_id == $value['id'] && isset( $value['type'] ) ) { return $value['type']; } } } return false; } } /* End of file ot-functions-admin.php */ /* Location: ./includes/ot-functions-admin.php */