themes-wordpress/toujours/functions.php
George Stephanis 8347656eb8 Add filter to change bundled google fonts.
Initially intended as a part-fix for #3134 to enable child themes to swap typefaces that get included more easily, this also extends that change across to many themes using the common patterns.

It explicitly does not change the following themes:

Spearhead (uses different endpoint and method)

And the following themes that have multiple functions that generate typeface includes so as to avoid confusion:

* canard
* gazette
* illustratr
* publication
2021-02-18 10:20:38 -05:00

490 lines
13 KiB
PHP

<?php
/**
* toujours functions and definitions.
*
* @link https://developer.wordpress.org/themes/basics/theme-functions/
*
* @package Toujours
*/
if ( ! function_exists( 'toujours_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 for post thumbnails.
*/
function toujours_setup() {
/*
* Make theme available for translation.
* Translations can be filed in the /languages/ directory.
* If you're building a theme based on toujours, use a find and replace
* to change 'toujours' to the name of your theme in all the template files.
*/
load_theme_textdomain( 'toujours', get_template_directory() . '/languages' );
// Add default posts and comments RSS feed links to head.
add_theme_support( 'automatic-feed-links' );
/*
* Let WordPress manage the document title.
* By adding theme support, we declare that this theme does not use a
* hard-coded <title> tag in the document head, and expect WordPress to
* provide it for us.
*/
add_theme_support( 'title-tag' );
// 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__( 'Blue', 'toujours' ),
'slug' => 'blue',
'color' => '#2590ec',
),
array(
'name' => esc_html__( 'Dark Gray', 'toujours' ),
'slug' => 'dark-gray',
'color' => '#404040',
),
array(
'name' => esc_html__( 'Medium Gray', 'toujours' ),
'slug' => 'medium-gray',
'color' => '#666',
),
array(
'name' => esc_html__( 'Light Gray', 'toujours' ),
'slug' => 'light-gray',
'color' => '#eee',
),
array(
'name' => esc_html__( 'White', 'toujours' ),
'slug' => 'white',
'color' => '#fff',
),
)
);
/*
* Editor styles
*/
add_editor_style( array( get_template_directory_uri() . '/editor-style.css', toujours_fonts_url() ) );
/*
* Enable support for Post Thumbnails on posts and pages.
*
* @link https://developer.wordpress.org/themes/functionality/featured-images-post-thumbnails/
*/
add_theme_support( 'post-thumbnails' );
/*
* Custom image sizes
*/
add_image_size( 'toujours-banner', 1160, 600, true );
add_image_size( 'toujours-featured', 940, 9999 );
add_image_size( 'toujours-trio', 680, 383, true ); /* image size larger for mobile */
/*
* Register menu locations
*
* Include check to see if jetpack_social_menu supported
*/
if ( ! function_exists( 'jetpack_social_menu' ) ) {
register_nav_menus(
array(
'primary' => esc_html__( 'Primary Menu', 'toujours' ),
'social' => esc_html__( 'Social Menu', 'toujours' ),
)
);
} else {
register_nav_menus(
array(
'primary' => esc_html__( 'Primary Menu', 'toujours' ),
)
);
}
/*
* 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',
)
);
/*
* Enable support for Post Formats.
* See https://developer.wordpress.org/themes/functionality/post-formats/
*/
add_theme_support(
'post-formats',
array(
'aside',
'audio',
'gallery',
'image',
'video',
'quote',
'link',
'status',
)
);
// Set up the WordPress core custom background feature.
add_theme_support(
'custom-background',
apply_filters(
'toujours_custom_background_args',
array(
'default-color' => 'eeeeee',
/*
* We're using a unique filename for the background image
* to avoid users uploading a file with the same filename
* and avoiding conflict with the `user-background` body_class
* in inc/extras.php and assets/js/customizer.js
*/
'default-image' => esc_url( get_template_directory_uri() ) . '/images/toujoursbackground20160105.png',
)
)
);
}
endif; // toujours_setup
add_action( 'after_setup_theme', 'toujours_setup' );
/**
* Set the content width in pixels, based on the theme's design and stylesheet.
*
* Priority 0 to make it available to lower priority callbacks.
*
* @global int $content_width
*/
function toujours_content_width() {
$GLOBALS['content_width'] = apply_filters( 'toujours_content_width', 760 );
}
add_action( 'after_setup_theme', 'toujours_content_width', 0 );
function toujours_excerpt_length( $length ) {
return 35;
}
add_filter( 'excerpt_length', 'toujours_excerpt_length', 999 );
/**
* Replaces the excerpt "more" text by a link
*/
if ( ! function_exists( 'toujours_excerpt_continue_reading' ) ) {
function toujours_excerpt_continue_reading() {
return '&hellip; <a href="' . esc_url( get_permalink() ) . '">' . sprintf( esc_html__( 'More', 'toujours' ), '<span class="screen-reader-text"> "' . get_the_title() . '"</span>' ) . '</a>';
}
}
add_filter( 'excerpt_more', 'toujours_excerpt_continue_reading' );
/**
*
*/
function toujours_recent_three_posts() {
// Return early if this feature has been disabled.
if ( ! get_theme_mod( 'toujours_recent_posts' ) ) {
return false;
}
if ( false === ( $latest_post_ids = get_transient( 'latest_post_ids' ) ) ) {
/*
Check if Featured Content option 'Display tag content in all listings' is checked
If not, exclude those posts from the three recent posts as well
*/
$exclude_tag = '';
if ( toujours_has_banner_posts( 1 ) ) {
$featured_options = get_option( 'featured-content' );
$featured_tag_id = $featured_options['tag-id'];
$featured_show = $featured_options['show-all'];
if ( 0 == $featured_show ) {
$exclude_tag = $featured_tag_id;
}
}
$args = array(
'ignore_sticky_posts' => 1,
'post__not_in' => get_option( 'sticky_posts' ),
'posts_per_page' => '3',
'tag__not_in' => array( $exclude_tag ),
);
$latest = new WP_Query();
$latest->query( $args );
while ( $latest->have_posts() ) {
$latest->the_post();
$latest_post_ids[] = $latest->post->ID;
}
wp_reset_postdata();
}
return $latest_post_ids;
}
add_filter( 'toujours-recent-posts', 'toujours_recent_three_posts' );
/**
* Filter the home page posts, and remove any featured post IDs from it. Hooked
* onto the 'pre_get_posts' action, this changes the parameters of the query
* before it gets any posts.
*
* @global array $featured_post_id
* @param WP_Query $query
* @return WP_Query Possibly modified WP_query
*/
function toujours_home_posts( $query = false ) {
// Bail if not home, not a query, not main query.
if ( ! is_home() || ! is_a( $query, 'WP_Query' ) || ! $query->is_main_query() ) {
return $query;
}
$recent = apply_filters( 'toujours-recent-posts', false );
// Bail if no featured posts.
if ( ! $recent ) {
return $query;
}
// Exclude featured posts from the main query.
$query->query_vars['post__not_in'] = (array) $recent;
return $query;
}
add_action( 'pre_get_posts', 'toujours_home_posts' );
/**
* Wrap avatars in HTML for easier styling
*/
function toujours_get_avatar( $avatar ) {
if ( ! is_admin() ) {
$avatar = '<span class="avatar-container"><span class="avatar-crop">' . $avatar . '</span></span>';
}
return $avatar;
}
add_filter( 'get_avatar', 'toujours_get_avatar', 10, 5 );
/**
* Enqueuing Google Fonts
*/
function toujours_fonts_url() {
$fonts_url = '';
/* Translators: If there are characters in your language that are not
* supported by Alegreya Sans, translate this to 'off'. Do not translate
* into your own language.
*/
$alegreya_sans = esc_html_x( 'on', 'Alegreya Sans font: on or off', 'toujours' );
/* Translators: If there are characters in your language that are not
* supported by Open Sans, translate this to 'off'. Do not translate
* into your own language.
*/
$merriweather = esc_html_x( 'on', 'Merriweather font: on or off', 'toujours' );
if ( 'off' !== $alegreya_sans || 'off' !== $merriweather ) {
$font_families = array();
if ( 'off' !== $alegreya_sans ) {
$font_families[] = 'Alegreya Sans:300,500,300italic,500italic';
}
if ( 'off' !== $merriweather ) {
$font_families[] = 'Merriweather:700italic,400,400italic,700,600';
}
/**
* 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' );
}
return esc_url_raw( $fonts_url );
}
/**
* Register widget area.
*
* @link https://developer.wordpress.org/themes/functionality/sidebars/#registering-a-sidebar
*/
function toujours_widgets_init() {
register_sidebar(
array(
'name' => esc_html__( 'Sidebar', 'toujours' ),
'id' => 'sidebar-1',
'description' => '',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
)
);
register_sidebar(
array(
'name' => esc_html__( 'Footer', 'toujours' ),
'id' => 'footer',
'description' => '',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
)
);
}
add_action( 'widgets_init', 'toujours_widgets_init' );
/**
* Counts the number of widgets in a specific sidebar
*
* @param string $id
* @return integer number of widgets in the sidebar
*/
function toujours_count_widgets( $id ) {
$count = 0;
$sidebars_widgets = wp_get_sidebars_widgets();
if ( array_key_exists( $id, $sidebars_widgets ) ) {
$count = (int) count( (array) $sidebars_widgets[ $id ] );
}
return $count;
}
/**
* Widget column class helper
*
* @param string $id
* @return string grid class
*/
function toujours_widget_column_class( $widget_id ) {
$count = toujours_count_widgets( $widget_id );
$class = '';
if ( $count >= 4 ) {
$class .= 'widgets-four';
} elseif ( 3 === $count ) {
$class .= 'widgets-three';
} elseif ( 2 === $count ) {
$class .= 'widgets-two';
} else {
$class .= 'widget-one';
}
return $class;
}
/**
* Return the post URL.
*
* @uses get_url_in_content() to get the URL in the post meta (if it exists) or
* the first link found in the post content.
*
* Falls back to the post permalink if no URL is found in the post.
*
* Borrowed from Twenty Thirteen.
*/
function toujours_get_link_url() {
$content = get_the_content();
$has_url = get_url_in_content( $content );
return ( $has_url ) ? $has_url : apply_filters( 'the_permalink', get_permalink() );
}
/**
* Enqueue scripts and styles.
*/
function toujours_scripts() {
wp_enqueue_style( 'toujours-style', get_stylesheet_uri() );
wp_enqueue_style( 'toujours-fonts', toujours_fonts_url(), array(), null );
// Gutenberg styles
wp_enqueue_style( 'toujours-blocks', get_template_directory_uri() . '/blocks.css' );
wp_enqueue_script( 'flexslider', get_template_directory_uri() . '/js/jquery.flexslider.js', array( 'jquery' ), '20160104', true );
wp_enqueue_script( 'imagesloaded', get_template_directory_uri() . '/js/imagesloaded.pk.js', array( 'jquery' ), '20151221', true );
wp_enqueue_script( 'toujours-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '20120206', true );
wp_enqueue_script( 'toujours-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20130115', true );
wp_enqueue_script( 'toujours-global', get_template_directory_uri() . '/js/global.js', array( 'jquery', 'flexslider', 'masonry' ), '20151215', true );
// Localize 'Previous' and 'Next' links in slideshow
$translation_array = array(
'next_link' => esc_html__( 'Next Slide', 'toujours' ),
'previous_link' => esc_html__( 'Previous Slide', 'toujours' ),
);
wp_localize_script( 'toujours-global', 'toujours_script_strings', $translation_array );
if ( wp_style_is( 'genericons', 'registered' ) ) {
wp_enqueue_style( 'genericons' );
} else {
wp_enqueue_style( 'genericons', get_template_directory_uri() . '/genericons/genericons.css', array(), null );
}
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
wp_enqueue_script( 'comment-reply' );
}
}
add_action( 'wp_enqueue_scripts', 'toujours_scripts' );
/**
* Gutenberg Editor Styles
*/
function toujours_editor_styles() {
wp_enqueue_style( 'toujours-editor-block-style', get_template_directory_uri() . '/editor-blocks.css' );
wp_enqueue_style( 'toujours-fonts', toujours_fonts_url(), array(), null );
}
add_action( 'enqueue_block_editor_assets', 'toujours_editor_styles' );
/**
* 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';