term_id] = $term->name;
}
}
} else {
$qt = 'SELECT * FROM ' . $wpdb->terms . ' AS t INNER JOIN ' . $wpdb->term_taxonomy . ' AS tt ON t.term_id = tt.term_id WHERE tt.taxonomy = "' . $taxonomy . '" AND tt.count > 0 ORDER BY t.term_id DESC LIMIT 0 , 30';
$terms = $wpdb->get_results( $qt, ARRAY_A );
if ( $terms && !is_wp_error( $terms ) ) {
foreach ( $terms as $term ) {
$term_coll[$term['term_id']] = $term['name'];
}
}
}
return $term_coll;
}
/**
* Retrieve a comma separated list of taxonomy terms list for the current post
* @param $taxonomy Optional. Default is category.
* @param $separator Optional. By default the list is comma separated
* @param $before Optional. The prefix to add to the output list
* @param $after Optional. The suffix to add to the output list
* @return string A comma separated list of taxonomy terms list for the current post
*/
function lae_entry_terms_list(
$taxonomy = 'category',
$separator = ', ',
$before = ' ',
$after = ' '
) {
global $post;
$output = '';
$output .= get_the_term_list(
$post->ID,
$taxonomy,
$before,
$separator,
$after
);
$output .= '';
return $output;
}
/**
* Get the taxonomy terms, if any, chosen for querying posts.
* We should use these only as filter terms for taxonomy filter. It does not make sense
* to show other terms for the taxonomy since the posts are not present for those
* terms based on the custom query generated by the user.
* @param $query_args The posts query created based on user input
* @return mixed|void An empty array or an array with two elements - chosen terms and chosen taxonomies
*/
function lae_get_chosen_terms( $query_args ) {
$chosen_terms = array();
$taxonomies = array();
if ( !empty( $query_args ) && !empty( $query_args['tax_query'] ) ) {
$term_queries = $query_args['tax_query'];
foreach ( $term_queries as $terms_query ) {
if ( !is_array( $terms_query ) ) {
continue;
}
$field = $terms_query['field'];
$taxonomy = $terms_query['taxonomy'];
$terms = $terms_query['terms'];
if ( empty( $taxonomy ) || empty( $terms ) ) {
continue;
}
if ( !in_array( $taxonomy, $taxonomies ) ) {
$taxonomies[] = $taxonomy;
}
if ( is_array( $terms ) ) {
foreach ( $terms as $term ) {
$chosen_terms[] = get_term_by( $field, $term, $taxonomy );
}
} else {
$chosen_terms[] = get_term_by( $field, $terms, $taxonomy );
}
}
}
// Remove duplicates
$taxonomies = array_unique( $taxonomies );
$return = array($chosen_terms, $taxonomies);
return apply_filters( 'lae_chosen_taxonomy_terms', $return, $query_args );
}
/**
* Obtain the taxonomy information for the current post like the category it belongs
* to or the tags it has. This will be displayed along with other post information
* like the posted date, author, title, thumbnail etc.
* @param $taxonomy The taxonomy (category, tags, portfolio category etc.) for which the terms are returned
* @return string A comma separated list of taxonomy terms for the current post
*/
function lae_get_taxonomy_info( $taxonomy ) {
$output = '';
$terms = get_the_terms( get_the_ID(), $taxonomy );
if ( !empty( $terms ) && !is_wp_error( $terms ) ) {
$output .= '';
$term_count = 0;
foreach ( $terms as $term ) {
$term_link = get_term_link( $term->slug, $taxonomy );
if ( !empty( $term_link ) && !is_wp_error( $term_link ) ) {
if ( $term_count != 0 ) {
$output .= ', ';
}
$output .= '' . $term->name . '';
$term_count = $term_count + 1;
}
}
$output .= '';
}
return apply_filters( 'lae_taxonomy_info', $output, $taxonomy );
}
/**
* Get the taxonomy information for the current post
* @param $taxonomies The taxonomies for which the taxonomy information is requested
* @return string A comma separated list of taxonomy terms for the current post
*/
function lae_get_info_for_taxonomies( $taxonomies ) {
$output = '';
foreach ( $taxonomies as $taxonomy ) {
$output .= lae_get_taxonomy_info( $taxonomy );
}
return apply_filters( 'lae_taxonomies_info', $output, $taxonomies );
}
/**
* Get all the registered taxonomies. We use this to display the list of available
* taxonomies in the database. The user can choose one or more of these to
* filter the posts returned for display in a posts grid or a posts carousel or posts slider
* @return array List of all registered taxonomies in the system
*/
function lae_get_taxonomies_map() {
$map = array();
$taxonomies = lae_get_all_taxonomies();
foreach ( $taxonomies as $taxonomy ) {
$map[$taxonomy] = $taxonomy;
}
return apply_filters( 'lae_taxonomies_map', $map );
}
/**
* Obtain all the taxonomies which are registered in the system and which are public
* @return string[]|WP_Taxonomy[] An array of taxonomy names or objects.
*/
function lae_get_all_taxonomies() {
$taxonomies = get_taxonomies( array(
'public' => true,
'_builtin' => false,
) );
$taxonomies = array_merge( array(
'category' => 'category',
'post_tag' => 'post_tag',
), $taxonomies );
return $taxonomies;
}
/**
* Obtain the posted date/time for the current post
* @param $format Optional. The desired format for the post date
* @return string The posted date/time for the current post
*/
function lae_entry_published( $format = null ) {
if ( empty( $format ) ) {
$format = get_option( 'date_format' );
}
$published = '' . sprintf( get_the_time( $format ) ) . '';
return apply_filters( 'lae_entry_published', $published, $format );
$link = '' . '' . '' . get_the_time( $format ) . '' . '';
return apply_filters( 'lae_entry_published_link', $link, $format );
}
/**
* Obtain the author information for the current post
* @return string The author information for the current post
*/
function lae_entry_author() {
$author = '' . esc_html__( 'By ', 'livemesh-el-addons' ) . '' . esc_html( get_the_author_meta( 'display_name' ) ) . '';
return apply_filters( 'lae_entry_author', $author );
}
/**
* Return the css class names to help achieve the number of columns specified separately
* for desktop, tablet and the mobile resolutions by the user in the settings.
* @param $settings The object which has all the user settings as captured in the widget settings by the user
* @param $columns_field The settings field which captures column information for various resolutions
* @return string The class names capturing column information for various resolutions
*/
function lae_get_grid_classes( $settings, $columns_field = 'per_line' ) {
if ( isset( $settings['column_layout'] ) && $settings['column_layout'] == 'auto' ) {
$grid_classes = ' lae-grid-auto-column-layout';
} else {
$grid_classes = ' lae-grid-desktop-';
$grid_classes .= esc_attr( $settings[$columns_field] );
$grid_classes .= ' lae-grid-tablet-';
$grid_classes .= esc_attr( $settings[$columns_field . '_tablet'] );
$grid_classes .= ' lae-grid-mobile-';
$grid_classes .= esc_attr( $settings[$columns_field . '_mobile'] );
}
return apply_filters(
'lae_grid_classes',
$grid_classes,
$settings,
$columns_field
);
}
/**
* Given a string indicated a true or false value, give me the boolean object.
* Converting string to boolean is a big one in PHP
* @param $value The string which indicates a boolean value
* @return bool The boolean value for the string specified
*/
function lae_to_boolean( $value ) {
if ( !isset( $value ) ) {
return false;
}
if ( $value == 'true' || $value == '1' ) {
$value = true;
} elseif ( $value == 'false' || $value == '0' ) {
$value = false;
}
return (bool) $value;
// Make sure you do not touch the value if the value is not a string
}
/**
* Lightens/darkens a given colour (hex format), returning the altered colour in hex format.7
* @param str $hex Colour as hexadecimal (with or without hash);
* @percent float $percent Decimal ( 0.2 = lighten by 20%(), -0.4 = darken by 40%() )
* @return str Lightened/Darkend colour as hexadecimal (with hash);
*/
function lae_color_luminance( $hex, $percent ) {
// validate hex string
$hex = preg_replace( '/[^0-9a-f]/i', '', $hex );
$new_hex = '#';
if ( strlen( $hex ) < 6 ) {
$hex = $hex[0] + $hex[0] + $hex[1] + $hex[1] + $hex[2] + $hex[2];
}
// convert to decimal and change luminosity
for ($i = 0; $i < 3; $i++) {
$dec = hexdec( substr( $hex, $i * 2, 2 ) );
$dec = min( max( 0, $dec + $dec * $percent ), 255 );
$new_hex .= str_pad(
dechex( $dec ),
2,
0,
STR_PAD_LEFT
);
}
return $new_hex;
}
/**
* Fetch the value of the option specified by the user in the Settings page under Livemesh Addons->Settings
* @param $option_name The name of the option for which the value is desired
* @param $default The default value if the option is not set
* @return string The value of the option specified by the user
*/
function lae_get_option( $option_name, $default = null ) {
$settings = get_option( 'lae_settings' );
if ( !empty( $settings ) && isset( $settings[$option_name] ) ) {
$option_value = $settings[$option_name];
} else {
$option_value = $default;
}
return apply_filters(
'lae_get_option',
$option_value,
$option_name,
$default
);
}
/**
* Update the option in the DB for the option name specified. This is managed in
* the Settings page under Livemesh Addons->Settings
* @param $option_name The name of the option which needs to be updated
* @param $option_value The new value for the option which needs updation
* @return void
*/
function lae_update_option( $option_name, $option_value ) {
$settings = get_option( 'lae_settings' );
if ( empty( $settings ) ) {
$settings = array();
}
$settings[$option_name] = $option_value;
update_option( 'lae_settings', $settings );
}
/**
* Update multiple options in one go for the Settings page under Livemesh Addons->Settings
* @param array $setting_data A collection of settings key value pairs;
*/
function lae_update_options( $setting_data ) {
$settings = get_option( 'lae_settings' );
if ( empty( $settings ) ) {
$settings = array();
}
foreach ( $setting_data as $setting => $value ) {
// because of get_magic_quotes_gpc()
$value = stripslashes( $value );
$settings[$setting] = $value;
}
update_option( 'lae_settings', $settings );
}
/**
* Get system or the server information like the site URL, plugins installed, WP version, PHP Info etc.
* useful for debugging purposes. This is displayed in the Settings page under Livemesh Addons -> Settings.
* @return string The information about the current WP setup
*/
function lae_get_sysinfo() {
global $wpdb;
// Get theme info
$theme_data = wp_get_theme();
$theme = $theme_data->Name . ' ' . $theme_data->Version;
$return = '### Begin System Info ###' . "\n\n";
// Start with the basics...
$return .= '-- Site Info' . "\n\n";
$return .= 'Site URL: ' . site_url() . "\n";
$return .= 'Home URL: ' . home_url() . "\n";
$return .= 'Multisite: ' . (( is_multisite() ? 'Yes' : 'No' )) . "\n";
// Theme info
$plugin = get_plugin_data( LAE_PLUGIN_FILE );
// Plugin configuration
$return .= "\n" . '-- Plugin Configuration' . "\n\n";
$return .= 'Name: ' . $plugin['Name'] . "\n";
$return .= 'Version: ' . $plugin['Version'] . "\n";
// WordPress configuration
$return .= "\n" . '-- WordPress Configuration' . "\n\n";
$return .= 'Version: ' . get_bloginfo( 'version' ) . "\n";
$return .= 'Language: ' . (( defined( 'WPLANG' ) && WPLANG ? WPLANG : 'en_US' )) . "\n";
$return .= 'Permalink Structure: ' . (( get_option( 'permalink_structure' ) ? get_option( 'permalink_structure' ) : 'Default' )) . "\n";
$return .= 'Active Theme: ' . $theme . "\n";
$return .= 'Show On Front: ' . get_option( 'show_on_front' ) . "\n";
// Only show page specs if frontpage is set to 'page'
if ( get_option( 'show_on_front' ) == 'page' ) {
$front_page_id = get_option( 'page_on_front' );
$blog_page_id = get_option( 'page_for_posts' );
$return .= 'Page On Front: ' . (( $front_page_id != 0 ? get_the_title( $front_page_id ) . ' (#' . $front_page_id . ')' : 'Unset' )) . "\n";
$return .= 'Page For Posts: ' . (( $blog_page_id != 0 ? get_the_title( $blog_page_id ) . ' (#' . $blog_page_id . ')' : 'Unset' )) . "\n";
}
$return .= 'ABSPATH: ' . ABSPATH . "\n";
$return .= 'WP_DEBUG: ' . (( defined( 'WP_DEBUG' ) ? ( WP_DEBUG ? 'Enabled' : 'Disabled' ) : 'Not set' )) . "\n";
$return .= 'Memory Limit: ' . WP_MEMORY_LIMIT . "\n";
$return .= 'Registered Post Stati: ' . implode( ', ', get_post_stati() ) . "\n";
// Get plugins that have an update
$updates = get_plugin_updates();
// WordPress active plugins
$return .= "\n" . '-- WordPress Active Plugins' . "\n\n";
$plugins = get_plugins();
$active_plugins = get_option( 'active_plugins', array() );
foreach ( $plugins as $plugin_path => $plugin ) {
if ( !in_array( $plugin_path, $active_plugins ) ) {
continue;
}
$update = ( array_key_exists( $plugin_path, $updates ) ? ' (needs update - ' . $updates[$plugin_path]->update->new_version . ')' : '' );
$return .= $plugin['Name'] . ': ' . $plugin['Version'] . $update . "\n";
}
// WordPress inactive plugins
$return .= "\n" . '-- WordPress Inactive Plugins' . "\n\n";
foreach ( $plugins as $plugin_path => $plugin ) {
if ( in_array( $plugin_path, $active_plugins ) ) {
continue;
}
$update = ( array_key_exists( $plugin_path, $updates ) ? ' (needs update - ' . $updates[$plugin_path]->update->new_version . ')' : '' );
$return .= $plugin['Name'] . ': ' . $plugin['Version'] . $update . "\n";
}
if ( is_multisite() ) {
// WordPress Multisite active plugins
$return .= "\n" . '-- Network Active Plugins' . "\n\n";
$plugins = wp_get_active_network_plugins();
$active_plugins = get_site_option( 'active_sitewide_plugins', array() );
foreach ( $plugins as $plugin_path ) {
$plugin_base = plugin_basename( $plugin_path );
if ( !array_key_exists( $plugin_base, $active_plugins ) ) {
continue;
}
$update = ( array_key_exists( $plugin_path, $updates ) ? ' (needs update - ' . $updates[$plugin_path]->update->new_version . ')' : '' );
$plugin = get_plugin_data( $plugin_path );
$return .= $plugin['Name'] . ': ' . $plugin['Version'] . $update . "\n";
}
}
// Server configuration (really just versioning)
$return .= "\n" . '-- Webserver Configuration' . "\n\n";
$return .= 'PHP Version: ' . PHP_VERSION . "\n";
$return .= 'MySQL Version: ' . $wpdb->db_version() . "\n";
$return .= 'Webserver Info: ' . $_SERVER['SERVER_SOFTWARE'] . "\n";
// PHP configs... now we're getting to the important stuff
$return .= "\n" . '-- PHP Configuration' . "\n\n";
$return .= 'Memory Limit: ' . ini_get( 'memory_limit' ) . "\n";
$return .= 'Upload Max Size: ' . ini_get( 'upload_max_filesize' ) . "\n";
$return .= 'Post Max Size: ' . ini_get( 'post_max_size' ) . "\n";
$return .= 'Upload Max Filesize: ' . ini_get( 'upload_max_filesize' ) . "\n";
$return .= 'Time Limit: ' . ini_get( 'max_execution_time' ) . "\n";
$return .= 'Max Input Vars: ' . ini_get( 'max_input_vars' ) . "\n";
$return .= 'Display Errors: ' . (( ini_get( 'display_errors' ) ? 'On (' . ini_get( 'display_errors' ) . ')' : 'N/A' )) . "\n";
$return = apply_filters( 'edd_sysinfo_after_php_config', $return );
// PHP extensions and such
$return .= "\n" . '-- PHP Extensions' . "\n\n";
$return .= 'cURL: ' . (( function_exists( 'curl_init' ) ? 'Supported' : 'Not Supported' )) . "\n";
$return .= 'fsockopen: ' . (( function_exists( 'fsockopen' ) ? 'Supported' : 'Not Supported' )) . "\n";
$return .= 'SOAP Client: ' . (( class_exists( 'SoapClient' ) ? 'Installed' : 'Not Installed' )) . "\n";
$return .= 'Suhosin: ' . (( extension_loaded( 'suhosin' ) ? 'Installed' : 'Not Installed' )) . "\n";
$return .= "\n" . '### End System Info ###';
return $return;
}
/**
* Fetch the HTML for the image thumbnail displayed on the frontend. This can be post thumbnail or a user chosen
* custom image as in gallery or widgets like team members, features, clients, services etc.
* @param $image_setting The image settings like the post id, URL etc. which enable us to fetch the image
* @param $image_size_key The size of the image desired
* @param $settings The object which has all the user settings as captured in the widget settings by the user
* @param $disable_lazy_load Optional. Whether the lazy load for the image needs to be disabled. By default, lazy load is enabled.
* @return string The HTML which has the image URL with required attributes like class names, lazy load info etc.
*/
function lae_get_image_html(
$image_setting,
$image_size_key,
$settings,
$disable_lazy_load = false
) {
$image_html = '';
$attachment_id = $image_setting['id'];
// Old version of image settings.
if ( !isset( $settings[$image_size_key . '_size'] ) ) {
$settings[$image_size_key . '_size'] = '';
}
$size = $settings[$image_size_key . '_size'];
$image_class = 'lae-image';
if ( $disable_lazy_load ) {
$image_class .= ' ' . lae_disable_lazy_load_classes();
}
if ( isset( $image_setting['class'] ) ) {
$image_class .= ' ' . $image_setting['class'];
}
// If is the new version - with image size.
$image_sizes = get_intermediate_image_sizes();
$image_sizes[] = 'full';
if ( !empty( $attachment_id ) && in_array( $size, $image_sizes ) ) {
$image_class .= " attachment-{$size} size-{$size}";
$image_attrs = array(
'class' => trim( $image_class ),
'alt' => get_the_title( $attachment_id ),
'title' => lae_get_image_alt( $attachment_id ),
);
if ( $disable_lazy_load ) {
$image_attrs = array_merge( $image_attrs, array(
'data-no-lazy' => 1,
'loading' => 'eager',
'decoding' => 'sync',
) );
}
$image_html .= wp_get_attachment_image(
$attachment_id,
$size,
false,
$image_attrs
);
} else {
$image_src = Group_Control_Image_Size::get_attachment_image_src( $attachment_id, $image_size_key, $settings );
if ( !$image_src && isset( $image_setting['url'] ) ) {
$image_src = $image_setting['url'];
}
$size = $settings[$image_size_key . '_size'];
$custom_dimension = $settings[$image_size_key . '_custom_dimension'];
if ( !empty( $image_src ) ) {
$lazy_load_attr = '';
if ( $disable_lazy_load ) {
$lazy_load_attr = 'decoding="sync" loading="eager" data-no-lazy=1';
}
$image_class_html = ( !empty( $image_class ) ? ' class="' . $image_class . '"' : '' );
if ( is_null( $custom_dimension ) ) {
$image_html .= sprintf(
'
',
esc_attr( $lazy_load_attr ),
esc_attr( $image_src ),
get_the_title( $attachment_id ),
lae_get_image_alt( $attachment_id ),
$image_class_html
);
} else {
$image_html .= sprintf(
'',
esc_attr( $custom_dimension['width'] ),
esc_attr( $custom_dimension['height'] ),
esc_attr( $lazy_load_attr ),
esc_attr( $image_src ),
get_the_title( $attachment_id ),
lae_get_image_alt( $attachment_id ),
$image_class_html
);
}
}
}
return apply_filters(
'lae_attachment_image_html',
$image_html,
$image_setting,
$image_size_key,
$settings
);
}
/**
* Obtain the image ALT information from the media library for the attachment id provided
* @param $attachment_id The id of the attachment in the media library
* @return string|void The ALT information for the image attachment id provided
*/
function lae_get_image_alt( $attachment_id ) {
if ( empty( $attachment_id ) ) {
return '';
}
if ( !$attachment_id ) {
return '';
}
$attachment = get_post( $attachment_id );
if ( !$attachment ) {
return '';
}
$alt = get_post_meta( $attachment_id, '_wp_attachment_image_alt', true );
if ( !$alt ) {
$alt = $attachment->post_excerpt;
if ( !$alt ) {
$alt = $attachment->post_title;
}
}
$alt = trim( strip_tags( $alt ) );
return apply_filters( 'lae_image_alt', $alt, $attachment_id );
}
/**
* The isotope library based taxonomy terms filter displayed for the free version of the posts grid or the portfolio widget
* @param $taxonomies The taxonomies whose terms are displayed in the filter
* @param $chosen_terms Optional. If the user has chosen to display posts for only certain taxonomy terms, use the same as terms list
* @return string The HTML which captures the taxonomy terms filter displayed for posts grid
*/
function lae_get_taxonomy_terms_filter( $taxonomies, $chosen_terms = array() ) {
$output = '';
$terms = array();
if ( empty( $chosen_terms ) ) {
foreach ( $taxonomies as $taxonomy ) {
global $wp_version;
if ( version_compare( $wp_version, '4.5', '>=' ) ) {
$taxonomy_terms = get_terms( array(
'taxonomy' => $taxonomy,
) );
} else {
$taxonomy_terms = get_terms( $taxonomy );
}
if ( !empty( $taxonomy_terms ) && !is_wp_error( $taxonomy_terms ) ) {
$terms = array_merge( $terms, $taxonomy_terms );
}
}
} else {
$terms = $chosen_terms;
}
if ( !empty( $terms ) ) {
$output .= '';
$output .= '
';
$segment_count = 1;
foreach ( $terms as $term ) {
$output .= '
';
$segment_count++;
}
$output .= '
';
$output .= $error_string;
$output .= '
';
return $output;
}
/**
* Validates the HTML tags used for displaying titles, headings etc. Defaults to the DIV tag if the tag specified is not supported by the plugin.
* @param $tag The HTML tag which needs validation
* @return mixed|string The HTML tag which is valid
*/
function lae_validate_html_tag( $tag ) {
$allowed_html_tags = [
'article',
'aside',
'div',
'footer',
'h1',
'h2',
'h3',
'h4',
'h5',
'h6',
'header',
'main',
'nav',
'p',
'section',
'span'
];
return ( in_array( strtolower( $tag ), $allowed_html_tags ) ? $tag : 'div' );
}