themes-wordpress/libretto/functions.php
2023-09-27 10:46:26 -05:00

423 lines
13 KiB
PHP

<?php
/**
* Libretto functions and definitions
*
* @package Libretto
*/
/**
* Set the content width based on the theme's design and stylesheet.
*/
if ( ! isset( $content_width ) ) {
$content_width = 720; /* 680px wide plus a 40px buffer */
}
if ( ! function_exists( 'libretto_setup' ) ) :
/**
* Sets up theme defaults and registers support for various WordPress features.
*
* Note that this function is hooked into the after_setup_theme hook, which runs
* before the init hook. The init hook is too late for some features, such as indicating
* support post thumbnails.
*/
function libretto_setup() {
/**
* Make theme available for translation
* Translations can be filed in the /languages/ directory
* If you're building a theme based on Libretto, use a find and replace
* to change 'libretto' to the name of your theme in all the template files
*/
load_theme_textdomain( 'libretto', get_template_directory() . '/languages' );
/**
* Add default posts and comments RSS feed links to head
*/
add_theme_support( 'automatic-feed-links' );
/**
* Enable support for Post Thumbnails
*/
add_theme_support( 'post-thumbnails' );
/**
* Add custom image sizes for:
* 1. The site logo
* 2. Large images that overlap the content area a smidge
* 3. Full-page images (primarily used for featured images)
*/
add_image_size( 'libretto-logo', 200, 200, false );
add_image_size( 'libretto-oversized', 900, 600, false );
add_image_size( 'libretto-fullpage', 1600, 1000, false );
// Add support for responsive embeds.
add_theme_support( 'responsive-embeds' );
// Add custom colors to Gutenberg
add_theme_support(
'editor-color-palette',
array(
array(
'name' => esc_html__( 'Black', 'libretto' ),
'slug' => 'black',
'color' => '#26231e',
),
array(
'name' => esc_html__( 'Dark Gray', 'libretto' ),
'slug' => 'dark-gray',
'color' => '#787065',
),
array(
'name' => esc_html__( 'Medium Gray', 'libretto' ),
'slug' => 'medium-gray',
'color' => '#a09a92',
),
array(
'name' => esc_html__( 'Light Gray', 'libretto' ),
'slug' => 'light-gray',
'color' => '#d9d6d0',
),
array(
'name' => esc_html__( 'White', 'libretto' ),
'slug' => 'white',
'color' => '#ffffff',
),
array(
'name' => esc_html__( 'Red', 'libretto' ),
'slug' => 'red',
'color' => '#932817',
),
array(
'name' => esc_html__( 'Dark Red', 'libretto' ),
'slug' => 'dark-red',
'color' => '#712012',
),
)
);
/**
* This theme uses wp_nav_menu() in two locations:
* one at the top of the page, and one for social media links in the footer
*/
register_nav_menus(
array(
'primary' => __( 'Primary Menu', 'libretto' ),
'social' => __( 'Social Media Menu', 'libretto' ),
)
);
/**
* Enable support for Post Formats
*/
add_theme_support(
'post-formats',
array(
'aside',
'image',
'video',
'quote',
'link',
'audio',
'chat',
'gallery',
'status',
)
);
/**
* Enable support for custom background
*/
add_theme_support(
'custom-background',
array(
'default-color' => '#f2f1ed',
)
);
/**
* Enable support for proper titles
*/
add_theme_support( 'title-tag' );
/**
* Use editor admin styles.
*/
add_editor_style( array( 'css/editor-style.css', libretto_fonts_url() ) );
/**
* Switch default core markup for search form, comment form, and comments
* to output valid HTML5.
*/
add_theme_support(
'html5',
array(
'search-form',
'comment-form',
'comment-list',
'gallery',
'caption',
)
);
} // libretto_setup()
endif;
add_action( 'after_setup_theme', 'libretto_setup' );
/**
* Register widgetized area and update sidebar with default widgets
*/
function libretto_widgets_init() {
register_sidebar(
array(
'name' => __( 'First Footer Sidebar', 'libretto' ),
'id' => 'sidebar-1',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
)
);
register_sidebar(
array(
'name' => __( 'Second Footer Sidebar', 'libretto' ),
'id' => 'sidebar-2',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
)
);
register_sidebar(
array(
'name' => __( 'Third Footer Sidebar', 'libretto' ),
'id' => 'sidebar-3',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
)
);
register_sidebar(
array(
'name' => __( 'Fourth Footer Sidebar', 'libretto' ),
'id' => 'sidebar-4',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
)
);
}
add_action( 'widgets_init', 'libretto_widgets_init' );
/**
* Generate URLs for our custom fonts (via Google)
*/
function libretto_fonts_url() {
$fonts_url = '';
/* Translators: If there are characters in your language that are not
* supported by Libre Baskerville, translate this to 'off'. Do not translate
* into your own language.
*/
$libre_baskerville = _x( 'on', 'Libre Baskerville font: on or off', 'libretto' );
/* Translators: If there are characters in your language that are not
* supported by Montserrat, translate this to 'off'. Do not translate
* into your own language.
*/
$montserrat = _x( 'on', 'Montserrat font: on or off', 'libretto' );
/* Translators: If there are characters in your language that are not
* supported by Playfair Display, translate this to 'off'. Do not translate
* into your own language.
*/
$playfair_display = _x( 'on', 'Playfair Display font: on or off', 'libretto' );
/* Translators: If there are characters in your language that are not
* supported by Droid Mono, translate this to 'off'. Do not translate
* into your own language.
*/
$droid_mono = _x( 'on', 'Droid Sans Mono font: on or off', 'libretto' );
if ( 'off' !== $libre_baskerville || 'off' !== $montserrat || 'off' !== $playfair_display || 'off' !== $droid_mono ) :
$font_families = array();
if ( 'off' !== $libre_baskerville ) {
$font_families[] = 'Libre Baskerville:400,700,400italic';
}
if ( 'off' !== $playfair_display ) {
$font_families[] = 'Playfair Display:400,700,400italic,700italic';
$font_families[] = 'Playfair Display SC:700,700italic';
}
if ( 'off' !== $montserrat ) {
$font_families[] = 'Montserrat:400';
}
if ( 'off' !== $droid_mono ) {
$font_families[] = 'Droid Sans Mono:400';
}
/**
* A filter to enable child themes to add/change/omit font families.
*
* @param array $font_families An array of font families to be imploded for the Google Font API
*/
$font_families = apply_filters( 'included_google_font_families', $font_families );
$query_args = array(
'family' => urlencode( implode( '|', $font_families ) ),
'subset' => urlencode( 'latin,latin-ext' ),
);
$fonts_url = add_query_arg( $query_args, 'https://fonts.googleapis.com/css' );
endif;
return $fonts_url;
}
/**
* Enqueue scripts and styles
*/
function libretto_scripts() {
// General site stylesheet & JS
wp_enqueue_style( 'libretto-style', get_stylesheet_uri() );
wp_enqueue_script( 'libretto-script', get_template_directory_uri() . '/js/libretto.js', array( 'jquery' ), '20140331' );
// Gutenberg styles
wp_enqueue_style( 'libretto-blocks', get_template_directory_uri() . '/css/blocks.css' );
// Fonts
wp_enqueue_style( 'libretto-fonts', libretto_fonts_url(), array(), null );
wp_enqueue_style( 'libretto-custom-icons', get_template_directory_uri() . '/icons/icons.css', array(), null );
// Navigation
wp_enqueue_script( 'libretto-touche', get_template_directory_uri() . '/js/touche.js', '20150604', true );
wp_enqueue_script( 'libretto-navigation', get_template_directory_uri() . '/js/navigation.js', array( 'jquery' ), '20150115', true );
wp_enqueue_script( 'libretto-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20130115', true );
// Comments
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
wp_enqueue_script( 'comment-reply' );
}
}
add_action( 'wp_enqueue_scripts', 'libretto_scripts' );
/**
* Gutenberg Editor Styles
*/
function libretto_editor_styles() {
wp_enqueue_style( 'libretto-editor-block-style', get_template_directory_uri() . '/css/editor-blocks.css' );
wp_enqueue_style( 'libretto-fonts', libretto_fonts_url(), array(), null );
}
add_action( 'enqueue_block_editor_assets', 'libretto_editor_styles' );
/**
* Create a reusable array of available sidebars.
* Used in sidebar.php and in inc/jetpack.php to adjust footer area according to usage.
*/
function libretto_get_active_sidebars() {
// Loop through all possible sidebar areas to determine if they're active or not
$available_sidebars = array( 'sidebar-1', 'sidebar-2', 'sidebar-3', 'sidebar-4' );
$active_sidebars = array();
foreach ( $available_sidebars as $sidebar_name ) :
if ( is_active_sidebar( $sidebar_name ) ) {
$active_sidebars[] = $sidebar_name;
}
endforeach;
return $active_sidebars;
}
/*
* Get information about the header image for our current page.
*
* We want to use an image in the background of our masthead in two cases:
* if there's a featured image for the post, or if there's a header image set for the site.
* In either case, we're going to need know the dimensions of the image and the URL.
* Usage: libretto_get_header_image( 'height' );
* You can pass a variable to request a particular type of information. Default is URL.
*/
function libretto_get_header_image( $request = '' ) {
$libretto_header_image_height = null;
// If there's a featured image set for the post/page, use that
if ( libretto_has_post_thumbnail() && is_single() && libretto_jetpack_featured_image_display() ) :
$libretto_featured_image = libretto_get_attachment_image_src( get_the_ID(), get_post_thumbnail_id( get_the_ID() ), 'libretto-fullpage' );
$libretto_header_image = $libretto_featured_image;
$libretto_header_image_height = 1000;
elseif ( has_post_thumbnail() && is_singular() && libretto_jetpack_featured_image_display() ) :
$libretto_featured_image = wp_get_attachment_image_src( get_post_thumbnail_id(), 'libretto-fullpage' );
$libretto_header_image = $libretto_featured_image[0];
$libretto_header_image_height = $libretto_featured_image[2];
// Otherwise, use the header image
// Otherwise, use the header image
elseif ( get_header_image() ) :
$libretto_header_image = get_header_image();
$libretto_header_image_height = get_custom_header()->height;
endif;
// We'll return different information depending on the parameter passed
// This allows us to use the same function for two things
if ( isset( $libretto_header_image ) ) :
if ( 'height' === $request ) {
return $libretto_header_image_height;
} else {
return $libretto_header_image;
}
endif;
}
/**
* Use a bare ellipsis after post excerpts.
*/
function libretto_excerpt_more( $more ) {
return '&hellip;';
}
add_filter( 'excerpt_more', 'libretto_excerpt_more' );
/**
* Add a blockquote tag around the content of a quote post format,
* if the content of the post doesn't already contain one.
*/
function libretto_add_blockquote_to_quote( $content ) {
if ( is_singular() || is_archive() || is_home() ) :
// Only run on quote post types, and only for those that don't already contain a blockquote
// Note: we look for "<blockquote" specifically so as to catch instances of blockquotes with additional attributes
if ( 'quote' === get_post_format() && strpos( $content, '<blockquote' ) === false ) {
$content = '<blockquote>' . $content . '</blockquote>';
}
endif;
return $content;
}
add_filter( 'the_content', 'libretto_add_blockquote_to_quote' );
add_filter( 'get_the_excerpt', 'libretto_add_blockquote_to_quote' );
/**
* Implement the Custom Header feature.
*/
require get_template_directory() . '/inc/custom-header.php';
/**
* Custom template tags for this theme.
*/
require get_template_directory() . '/inc/template-tags.php';
/**
* Custom functions that act independently of the theme templates.
*/
require get_template_directory() . '/inc/extras.php';
/**
* Customizer additions.
*/
require get_template_directory() . '/inc/customizer.php';
/**
* Load Jetpack compatibility file.
*/
require get_template_directory() . '/inc/jetpack.php';