tags and breaking and non breaking spaces as well
*
* @since 1.0.0
* @access public
* @param string $content
* @return array
*/
function hoot_trim( $content ) {
$content = trim( $content, " \t\n\r\0\x0B\xC2\xA0" ); // trim non breaking spaces as well
$content = preg_replace('/^(?:
\s*)+/', '', $content);
$content = preg_replace('/(?:
\s*)+$/', '', $content);
$content = trim( $content, " \t\n\r\0\x0B\xC2\xA0" ); // trim non breaking spaces as well
return $content;
}
/**
* Trim a string to defined length
*
* @since 2.1.6
* @access public
* @param string $content
* @param int $words
* @return string
*/
function hoot_trim_content( $raw, $words ) {
$content = explode( ' ', $raw, $words );
$excerpt_more = apply_filters( 'excerpt_more', ' ' . '[…]' );
if ( count( $content ) >= $words ) {
array_pop( $content );
$content = implode( " ", $content ) . $excerpt_more ;
} else {
$content = implode( " ", $content );
}
$content = preg_replace( '/\[.+\]/', '', $content );
$content = apply_filters( 'hoot_trim_content', $content, $words, $excerpt_more );
$content = apply_filters( 'wp_trim_excerpt', $content, $raw );
$content = str_replace( ']]>', ']]>', $content );
return $content;
}
/**
* Insert into associative array at a specific location
*
* @since 1.1.1
* @access public
* @param array $insert
* @param array $target
* @param int|string $location 0 based position, or key in $target
* @param string $order 'before' or 'after'
* @return array
*/
function hoot_array_insert( $insert, $target, $location, $order = 'before' ) {
if ( !is_array( $insert ) || !is_array( $target ) )
return $target;
if ( is_int( $location ) ) {
if ( $order == 'after' )
$location++;
$target = array_slice( $target, 0, $location, true ) +
$insert +
array_slice( $target, $location, count( $target ) - 1, true );
return $target;
} elseif ( is_string( $location ) ) {
$count = ( $order == 'after' ) ? 1 : 0;
foreach ( $target as $key => $value ) {
if ( $key === $location ) {
$target = array_slice( $target, 0, $count, true ) +
$insert +
array_slice( $target, $count, count( $target ) - 1, true );
return $target;
}
$count++;
}
// $location not found. So lets just return a simple array merge
return array_merge( $target, $insert );
}
// Just for brevity
return $target;
}
/**
* Function for grabbing a WP nav menu theme location name.
*
* @since 1.0.0
* @access public
* @param string $location
* @return string
*/
function hoot_get_menu_location_name( $location ) {
$locations = get_registered_nav_menus();
return $locations[ $location ];
}
/**
* Function for grabbing a dynamic sidebar name.
*
* @since 1.0.0
* @access public
* @param string $sidebar_id
* @return string
*/
function hoot_get_sidebar_name( $sidebar_id ) {
global $wp_registered_sidebars;
if ( isset( $wp_registered_sidebars[ $sidebar_id ] ) )
return $wp_registered_sidebars[ $sidebar_id ]['name'];
}
/**
* Helper function for getting the minified script uri if available.
*
* @since 2.0.0
* @access public
* @param string $location
* @param string $return uri or path
* @return string
*/
function hoot_locate_script( $location, $return = 'uri' ) {
$location = preg_replace( array(
'/\.min\.css$/',
'/\.css$/',
), '', $location );
return hoot_locate_uri( $location, 'js', $return );
}
/**
* Helper function for getting the minified style uri if available.
*
* @since 2.0.0
* @access public
* @param string $location
* @param string $return uri or path
* @return string
*/
function hoot_locate_style( $location, $return = 'uri' ) {
$location = preg_replace( array(
'/\.min\.js$/',
'/\.js$/',
), '', $location );
return hoot_locate_uri( $location, 'css', $return );
}
/**
* Helper function for getting the minified script/style uri if available.
*
* @since 2.0.0
* @access public
* @param string $location absolute or relative path
* @param string $type
* @param string $return uri or path
* @return string
*/
function hoot_locate_uri( $location, $type, $return = 'uri' ) {
$location = str_replace( array(
trailingslashit( THEME_URI ) . 'premium/',
trailingslashit( THEME_DIR ) . 'premium/',
trailingslashit( THEME_URI ),
trailingslashit( THEME_DIR ),
), '', $location );
$pattern = apply_filters( 'hoot_locate_uri_extension_pattern', array( '/\.min\.' . $type . '$/', '/\.' . $type . '$/' ) );
$location = preg_replace( $pattern, '', $location );
if ( defined( 'HOOT_DEBUG' ) )
$loadminified = ( HOOT_DEBUG ) ? false : true;
else
$loadminified = hoot_get_mod( 'load_minified', 0 );
/** Prepare Locations **/
$locations = array();
if ( is_child_theme() ) {
if ( $loadminified )
$locations['child-premium-min'] = array(
'path' => trailingslashit( CHILD_THEME_DIR ) . 'premium/' . $location . '.min.' . $type,
'uri' => trailingslashit( CHILD_THEME_URI ) . 'premium/' . $location . '.min.' . $type,
);
$locations['child-premium'] = array(
'path' => trailingslashit( CHILD_THEME_DIR ) . 'premium/' . $location . '.' . $type,
'uri' => trailingslashit( CHILD_THEME_URI ) . 'premium/' . $location . '.' . $type,
);
if ( $loadminified )
$locations['child-default-min'] = array(
'path' => trailingslashit( CHILD_THEME_DIR ) . $location . '.min.' . $type,
'uri' => trailingslashit( CHILD_THEME_URI ) . $location . '.min.' . $type,
);
$locations['child-default'] = array(
'path' => trailingslashit( CHILD_THEME_DIR ) . $location . '.' . $type,
'uri' => trailingslashit( CHILD_THEME_URI ) . $location . '.' . $type,
);
}
if ( $loadminified )
$locations['premium-min'] = array(
'path' => trailingslashit( THEME_DIR ) . 'premium/' . $location . '.min.' . $type,
'uri' => trailingslashit( THEME_URI ) . 'premium/' . $location . '.min.' . $type,
);
$locations['premium'] = array(
'path' => trailingslashit( THEME_DIR ) . 'premium/' . $location . '.' . $type,
'uri' => trailingslashit( THEME_URI ) . 'premium/' . $location . '.' . $type,
);
if ( $loadminified )
$locations['default-min'] = array(
'path' => trailingslashit( THEME_DIR ) . $location . '.min.' . $type,
'uri' => trailingslashit( THEME_URI ) . $location . '.min.' . $type,
);
$locations['default'] = array(
'path' => trailingslashit( THEME_DIR ) . $location . '.' . $type,
'uri' => trailingslashit( THEME_URI ) . $location . '.' . $type,
);
$locations = apply_filters( 'hoot_locate_uri', $locations, $location, $type );
/** Locate the file **/
$located = array( 'path' => '', 'uri' => '' );
foreach ( $locations as $locate ) {
if ( file_exists( $locate['path'] ) ) {
$located = $locate;
break;
}
}
if ( $return == 'path' )
return $located['path'];
else
return $located['uri'];
}
/**
* Function for checking if 404 page is being displayed.
* This is an extension to the WordPress 'is_404()' conditional tag, as it checks if the main query is
* altered to display a custom page as 404 page by the Hoot framework.
*
* @since 1.0.0
* @access public
* @return bool
*/
function hoot_is_404() {
global $hoot;
if ( isset( $hoot->is_404 ) && is_bool( $hoot->is_404 ) )
return $hoot->is_404;
else
return is_404();
}
/**
* A class of helper functions to cache and build options
*
* @since 1.0.0
*/
class Hoot_Options_Helper {
/**
* Utility functions for processing list count
*
* @since 2.0.0
* @return int
*/
static function countval( $number ){
if ( $number===false)
return HOOT_ADMIN_LIST_ITEM_COUNT;
$number = intval( $number );
if ( empty( $number ) || $number < 0 )
return 0;
return $number;
}
/**
* Get pages array
*
* @since 1.0.0
* @param int $number
* @param string $post_type for custom post types
* @return array
*/
static function get_pages( $number, $post_type = 'page' ){
$number = ( !$number ) ? -1 : $number;
$pages = array();
global $post;
$static = $post; // $post could be null
$the_query = new WP_Query( array( 'post_type' => $post_type, 'posts_per_page' => $number, 'orderby' => 'post_title', 'order' => 'ASC', 'post_status' => 'publish' ) );
if ( $the_query->have_posts() ) :
while ( $the_query->have_posts() ) : $the_query->the_post();
$pages[ get_the_ID() ] = get_the_title();
endwhile;
wp_reset_postdata();
if ( empty( $static ) ) $post = $static; // Prcetabe plug
endif;
return $pages;
}
/**
* Get posts array
*
* @since 1.0.0
* @param int $number
* @return array
*/
static function get_posts( $number ){
$number = ( !$number ) ? '' : $number;
$posts = array();
$object = get_posts("numberposts=$number");
foreach ( $object as $post ) {
$posts[ $post->ID ] = $post->post_title;
}
return $posts;
}
/**
* Get terms array
*
* @since 2.0.0
* @param int $number
* @param string $taxonomy
* @return array
*/
static function get_terms( $number, $taxonomy = 'category' ){
$number = ( !$number ) ? '' : $number;
$terms = array();
$object = (array) get_terms( $taxonomy, array( 'number' => $number ) );
foreach ( $object as $term )
$terms[$term->term_id] = $term->name;
return $terms;
}
/**
* Pull all the categories into an array
*
* @since 1.0.0
* @param int $number false for default, empty or -1 for all
* @return array
*/
static function categories( $number = false ){
$number = self::countval( $number );
if ( $number == HOOT_ADMIN_LIST_ITEM_COUNT ) {
static $options_categories_default = array();
if ( empty( $options_categories_default ) )
$options_categories_default = self::get_terms( $number, 'category' );
return $options_categories_default;
}
elseif ( empty( $number ) ) {
static $options_categories = array();
if ( empty( $options_categories ) )
$options_categories = self::get_terms( $number, 'category' );
return $options_categories;
}
else
return self::get_terms( $number, 'category' );
}
/**
* Pull all the tags into an array
*
* @since 1.0.0
* @param int $number false for default, empty or -1 for all
* @return array
*/
static function tags( $number = false ){
$number = self::countval( $number );
if ( $number == HOOT_ADMIN_LIST_ITEM_COUNT ) {
static $options_tags_default = array();
if ( empty( $options_tags_default ) )
$options_tags_default = self::get_terms( $number, 'post_tag' );
return $options_tags_default;
}
elseif ( empty( $number ) ) {
static $options_tags = array();
if ( empty( $options_tags ) )
$options_tags = self::get_terms( $number, 'post_tag' );
return $options_tags;
}
else
return self::get_terms( $number, 'post_tag' );
}
/**
* Pull all the pages into an array
*
* @since 1.0.0
* @param int $number false for default, empty or -1 for all
* @return array
*/
static function pages( $number = false ){
$number = self::countval( $number );
if ( $number == HOOT_ADMIN_LIST_ITEM_COUNT ) {
static $options_pages_default = array();
if ( empty( $options_pages_default ) )
$options_pages_default = self::get_pages( $number, 'page' );
return $options_pages_default;
}
elseif ( empty( $number ) ) {
static $options_pages = array();
if ( empty( $options_pages ) )
$options_pages = self::get_pages( $number, 'page' );
return $options_pages;
}
else
return self::get_pages( $number, 'page' );
}
/**
* Pull all the posts into an array
*
* @since 1.0.0
* @param int $number false for default, empty or -1 for all
* @return array
*/
static function posts( $number = false ){
$number = self::countval( $number );
if ( $number == HOOT_ADMIN_LIST_ITEM_COUNT ) {
static $options_posts_default = array();
if ( empty( $options_posts_default ) )
$options_posts_default = self::get_posts( $number );
return $options_posts_default;
}
elseif ( empty( $number ) ) {
static $options_posts = array();
if ( empty( $options_posts ) )
$options_posts = self::get_posts( $number );
return $options_posts;
}
else
return self::get_posts( $number );
}
/**
* Pull all the cpt posts into an array
*
* @since 1.1.1
* @param string $post_type for custom post types
* @param int $number Set to -1 for all pages
* @param string $append Append a value
* @return array
*/
static function cpt( $post_type = 'page', $number = false, $append = false ){
$number = self::countval( $number );
if ( $number == HOOT_ADMIN_LIST_ITEM_COUNT ) {
static $cpt_default = array();
if ( empty( $cpt_default[ $post_type ] ) )
$cpt_default[ $post_type ] = self::get_pages( $number, $post_type );
$return = $cpt_default[ $post_type ];
}
elseif ( empty( $number ) ) {
static $cpt = array();
if ( empty( $cpt[ $post_type ] ) )
$cpt[ $post_type ] = self::get_pages( $number, $post_type );
$return = $cpt[ $post_type ];
}
else
$return = self::get_pages( $number, $post_type );
$return = ( $append ) ? array( $append ) + $return : $return;
return $return;
}
/**
* Create font families array
*
* @since 1.0.0
* @param string $return array to return websafe|google-fonts
* @return array
*/
static function fonts( $return = 'websafe' ) {
if ( $return == 'websafe' ) {
if ( function_exists('hoot_fonts_list') )
return hoot_fonts_list();
else
return array();
}
if ( $return == 'google-fonts' || $return == 'google-font' ) {
if ( function_exists('hoot_googlefonts_list') )
return hoot_googlefonts_list();
else
return apply_filters( 'hoot_google_fonts', array() );
}
return array();
}
/**
* Return icon list array
*
* @since 1.0.0
* @param string $return array to return list|icons|sections
* @return array
*/
static function icons( $return = 'list' ) {
if ( !function_exists('hoot_fonticons_list') )
return array();
if ( $return == 'sections' || $return == 'section' )
return hoot_fonticons_list('sections');
$iconsArray = hoot_fonticons_list('icons');
if ( $return == 'icons' || $return == 'icon' )
return $iconsArray;
if ( $return == 'lists' || $return == 'list' ) {
$iconsList = array();
foreach ( $iconsArray as $name => $array ) {
$iconsList = array_merge( $iconsList, $array );
}
return $iconsList;
}
return array();
}
}