diff options
Diffstat (limited to 'plugins/jetpack/modules/theme-tools/site-logo/inc/functions.php')
-rw-r--r-- | plugins/jetpack/modules/theme-tools/site-logo/inc/functions.php | 176 |
1 files changed, 0 insertions, 176 deletions
diff --git a/plugins/jetpack/modules/theme-tools/site-logo/inc/functions.php b/plugins/jetpack/modules/theme-tools/site-logo/inc/functions.php deleted file mode 100644 index 3b27b32f..00000000 --- a/plugins/jetpack/modules/theme-tools/site-logo/inc/functions.php +++ /dev/null @@ -1,176 +0,0 @@ -<?php -/** - * Functions and template tags for using site logos. - * - * @package Jetpack - */ - -/** - * Retrieve the site logo URL or ID (URL by default). Pass in the string 'id' for ID. - * - * @uses get_option() - * @uses esc_url_raw() - * @uses set_url_scheme() - * @return mixed The URL or ID of our site logo, false if not set - * @since 1.0 - */ -function jetpack_get_site_logo( $show = 'url' ) { - $logo = site_logo()->logo; - - // Return false if no logo is set - if ( ! isset( $logo['id'] ) || 0 == $logo['id'] ) { - return false; - } - - // Return the ID if specified, otherwise return the URL by default - if ( 'id' == $show ) { - return $logo['id']; - } else { - return esc_url_raw( set_url_scheme( $logo['url'] ) ); - } -} - -/** - * Retrieve an array of the dimensions of the Site Logo. - * - * @uses Site_Logo::theme_size() - * @uses get_option( 'thumbnail_size_w' ) - * @uses get_option( 'thumbnail_size_h' ) - * @uses global $_wp_additional_image_sizes; - * - * @since 3.6.0 - * - * @return array $dimensions { - * An array of dimensions of the Site Logo. - * - * @type string $width Width of the logo in pixels. - * @type string $height Height of the logo in pixels. - * } - */ -function jetpack_get_site_logo_dimensions() { - // Get the image size to use with the logo. - $size = site_logo()->theme_size(); - - // If the size is the default `thumbnail`, get its dimensions. Otherwise, get them from $_wp_additional_image_sizes - if ( empty( $size ) ) { - return false; - } elseif ( 'thumbnail' == $size ) { - $dimensions = array( - 'width' => get_option( 'thumbnail_size_w' ), - 'height' => get_option( 'thumbnail_size_h' ), - ); - } else { - global $_wp_additional_image_sizes; - - if ( ! isset( $_wp_additional_image_sizes[ $size ] ) ) { - return false; - } - - $dimensions = array( - 'width' => $_wp_additional_image_sizes[ $size ]['width'], - 'height' => $_wp_additional_image_sizes[ $size ]['height'], - ); - } - - return $dimensions; -} - -/** - * Determine if a site logo is assigned or not. - * - * @uses get_option - * @return boolean True if there is an active logo, false otherwise - */ -function jetpack_has_site_logo() { - return site_logo()->has_site_logo(); -} - -/** - * Output an <img> tag of the site logo, at the size specified - * in the theme's add_theme_support() declaration. - * - * @uses Site_Logo::logo - * @uses Site_Logo::theme_size() - * @uses jetpack_has_site_logo() - * @uses jetpack_is_customize_preview() - * @uses esc_url() - * @uses home_url() - * @uses esc_attr() - * @uses wp_get_attachment_image() - * @uses apply_filters() - * @since 1.0 - */ -function jetpack_the_site_logo() { - $logo = site_logo()->logo; - $logo_id = get_theme_mod( 'custom_logo' ); // Check for WP 4.5 Site Logo - $logo_id = $logo_id ? $logo_id : $logo['id']; // Use WP Core logo if present, otherwise use Jetpack's. - $size = site_logo()->theme_size(); - $html = ''; - - // If no logo is set, but we're in the Customizer, leave a placeholder (needed for the live preview). - if ( ! jetpack_has_site_logo() ) { - if ( jetpack_is_customize_preview() ) { - $html = sprintf( - '<a href="%1$s" class="site-logo-link" style="display:none;"><img class="site-logo" data-size="%2$s" /></a>', - esc_url( home_url( '/' ) ), - esc_attr( $size ) - ); - } - } - - // We have a logo. Logo is go. - else { - $html = sprintf( - '<a href="%1$s" class="site-logo-link" rel="home" itemprop="url">%2$s</a>', - esc_url( home_url( '/' ) ), - wp_get_attachment_image( - $logo_id, - $size, - false, - array( - 'class' => "site-logo attachment-$size", - 'data-size' => $size, - 'itemprop' => 'logo', - ) - ) - ); - } - - /** - * Filter the Site Logo output. - * - * @module theme-tools - * - * @since 3.2.0 - * - * @param string $html Site Logo HTML output. - * @param array $logo Array of Site Logo details. - * @param string $size Size specified in add_theme_support declaration, or 'thumbnail' default. - */ - echo apply_filters( 'jetpack_the_site_logo', $html, $logo, $size ); -} - -/** - * Whether the site is being previewed in the Customizer. - * Duplicate of core function until 4.0 is released. - * - * @global WP_Customize_Manager $wp_customize Customizer instance. - * @return bool True if the site is being previewed in the Customizer, false otherwise. - */ -function jetpack_is_customize_preview() { - global $wp_customize; - - return is_a( $wp_customize, 'WP_Customize_Manager' ) && $wp_customize->is_preview(); -} - -/** - * Sanitize the string of classes used for header text. - * Limit to A-Z,a-z,0-9,(space),(comma),_,- - * - * @return string Sanitized string of CSS classes. - */ -function jetpack_sanitize_header_text_classes( $classes ) { - $classes = preg_replace( '/[^A-Za-z0-9\,\ ._-]/', '', $classes ); - - return $classes; -} |