ID == '1') {$vtrace = true;}
return $vtrace;
}
// /====================
// === Theme Options ===
// ====================/
// options_theme_options
// options_framework_menu
// options_submenu_position
// options_admin_menu_title
// options_admin_menu_position
// options_admin_menu_icon
// options_themepage_styles
// options_images_url
// options_font_stacks
// options_title_fonts
// /=======================/
// /= Available Theme Options =/
// -----------------------------
add_filter('options_theme_options','muscle_options_theme_options');
function muscle_options_theme_options($voptions) {
// modify available theme options array conditionally
return $voptions;
}
// /= Change Appearance Submenu =/
// -------------------------------
// (for Options Framework only)
// 2.0.9: renamed filter for consistency using compat.php
add_filter('options_framework_menu','muscle_options_submenu',1);
function muscle_options_submenu($vmenu) {
// Default
// $vmenu = array(
// 'mode' => 'submenu',
// 'page_title' => __( 'Theme Options', 'bioship'),
// 'menu_title' => __('Theme Options', 'bioship'),
// 'capability' => 'edit_theme_options',
// 'menu_slug' => 'options-framework',
// 'parent_slug' => 'themes.php',
// );
// Example: Change "Theme Options" submenu title to Child Theme name
# if (is_child_theme()) {
# global $vtheme, $wp_version;
# if (get_bloginfo('version') < '3.4') {$vchildtheme = get_theme_data(get_stylesheet_directory($vtheme).'/style.css');}
# else {$vchildtheme = wp_get_theme($vtheme);}
# if ($vchildtheme['Name'] != '') {$vmenu['page_title'] = $vmenu['menu_title'] = $vchildtheme['Name'].' Options';}
# }
// Note: Position must be changed separately (as not available via add_submenu_page)
// Warning: Do NOT change the menu_slug value! just in case:
$vmenu['menu_slug'] = "options-framework";
return $vmenu;
}
// /= Change Submenu Position =/
// -----------------------------
add_filter('options_submenu_position','muscle_options_submenu_position');
function muscle_options_submenu_position($vposition) {
// default 1 (first in Appearance menu)
# $vposition = '6'; // moves below Themes in Appearance menu
return $vposition;
}
// /= Add Main Theme Menu =/
// -------------------------
// (for Options Framework only - as off by default)
add_filter('muscle_theme_options_menu','muscle_add_theme_options_menu');
function muscle_add_theme_options_menu($vmenu) {
// ref: https://codex.wordpress.org/Function_Reference/add_menu_page
// note: by default, Options Framework does NOT add this page
// default
// $vmenu = array(
// 'mode' => 'menu',
// 'page_title' => __( 'Theme Options', 'bioship'),
// 'menu_title' => __('Theme Options', 'bioship'),
// 'capability' => 'edit_theme_options',
// 'parent_slug' => 'themes.php',
// 'icon_url' => 'dashicons-admin-generic',
// 'position' => '59'
// );
// change the menu icon URL
# global $vthemedirs;
# $vicon = bioship_file_hierarchy('url','theme-options-icon.png',$vthemedirs['image']);
# if ($vicon) {$vmenu['icon_url'] = $vicon;}
// change the menu position
# if (is_admin()) {$vposition = '61';} // after 'Appearance' for admin
# if (is_network_admin()) {$vposition = '29';} // above 'Updates' for network admin
return $vmenu;
}
// /= Options Admin Menu Title =/
// ------------------------------
// 1.8.0: for Titan Framework Main Menu
add_filter('options_admin_menu_title','muscle_admin_menu_title');
function muscle_admin_menu_title($vtitle) {
// default menu title is 'BioShip Options'
# $vtitle = 'Theme Options';
return $vtitle;
}
// /= Options Admin Menu Title =/
// ------------------------------
// 1.8.0: for Titan Framework Main Menu
add_filter('options_admin_menu_position','muscle_admin_menu_position');
function muscle_admin_menu_position($vposition) {
// default position is 60
# $vposition = 5;
return $vposition;
}
// /= Options Admin Menu Icon =/
// -----------------------------
// 1.8.0: for Titan Framework Main Menu
// ref: http://calebserna.com/dashicons-cheatsheet/
add_filter('options_admin_menu_icon','muscle_admin_menu_icon');
function muscle_admin_menu_icon($vicon) {
// default menu icon is 'dashicon-welcome-view-site'
# $vicon = 'dashicon-admin-appearance';
return $vicon;
}
// /= Theme Options Styling =/
// ---------------------------
add_filter('options_themepage_styles','muscle_options_themepage_styles');
function muscle_options_themepage_styles($vstyles) {
// add some extra styling to the Theme Options page
# $vstyles .= ".filterbutton {font-size:12pt; font-weight:bold;}";
return $vstyles;
}
// /= Options Page Images Path =/
// ------------------------------
// for changing image radio buttons path
add_filter('options_images_url','muscle_options_images_url');
function muscle_options_images_url($vpath) {
// eg. change to child theme images directory
# $vpath = get_stylesheet_directory_uri.'/images/';
return $vpath;
}
// /= Font Stack Options =/
// ------------------------
add_filter('options_font_stacks','muscle_font_stacks');
function muscle_font_stacks($vfonts) {
// Here you can replace existing font stacks or add your own
// Format: $vfonts['font1,font2,font3'] = 'DisplayName 1, Display Name 2, Display Name 3';
// eg1. (add):
# $vfonts['"PT Sans",helvetica,arial'] = 'PT Sans, Helvetica, Arial';
// eg2. (replace):
# unset($vfonts['helvetica, arial, "Nimbus Sans L", sans-serif']);
# $vfonts['"Open Sans", helvetica, arial, "Nimbus Sans L", sans-serif'] = 'Open Sans, Helvetica, Arial, Nimbus Sans L, sans-serif';
return $vfonts;
}
// /= Title Font Options =/
// ------------------------
add_filter('options_title_fonts','muscle_title_fonts');
function muscle_title_fonts($vfonts) {
// Here you could add some title font options to the selector
// Loaded from the Google Fonts API: http://www.google.com/fonts
// remember to use + for spaces as in the following example
# $vfonts['Special+Font'] = 'Special Font';
return $vfonts;
}
// /= Theme Recommendations =/
// ---------------------------
add_filter('options_recommendations','muscle_options_recommendations');
function muscle_options_recommendations($vrecommend) {
// Add to the recommendations for this theme
# $vrecommend .= 'Another Awesome Plugin.';
// or even add a panel via a shortcode
# $vpanel = do_shortcode('[feed-panel]')
# return $vpanel.$vrecommend;
return $vrecommend;
}
// /=================
// === Customizer ===
// =================/
// options_customizer_split_options
// options_customizer_extra_styles
// options_customizer_logo_image
// options_customizer_description
// options_customizer_color_accent
// options_customizer_color_back
// options_customizer_panel_width
// /================/
// /= Customizer Split Options =/
add_filter('options_customizer_split_options','muscle_customizer_split_options');
function muscle_customizer_split_options($vsplit) {
// do not split customizer into 'basic' and 'advanced' pages
# $vsplit = false;
return $vsplit;
}
// /= Customizer Extra Styles =/
add_filter('options_customizer_extra_styles','muscle_customizer_extra_styles');
function muscle_customizer_extra_styles($vstyles) {
# TODO: example
return $vstyles;
}
// /= Customizer Logo Image =/
add_filter('options_customizer_logo_image','muscle_customizer_logo_image');
function muscle_customizer_logo_image($vimage) {
# TODO: example
return $vimage;
}
// /= Customizer Description =/
add_filter('options_customizer_description','muscle_customizer_description');
function muscle_customizer_description($vdescription) {
# TODO: example
return $vdescription;
}
// /= Customizer Colour Accent =/
add_filter('options_customizer_color_accent','muscle_customizer_color_accent');
function muscle_customizer_color_accent($vcolor) {
# TODO: example
return $vcolor;
}
// /= Customizer Sidebar Colour =/
add_filter('options_customizer_color_back','muscle_customizer_color_back');
function muscle_customizer_color_back($vcolor) {
# TODO: example
return $vcolor;
}
// /= Customizer Panel Width =/
add_filter('options_customizer_panel_width','muscle_customizer_panel_width');
function muscle_customizer_panel_width($vwidth) {
// Example: set panel width in em units
# $vwidth = '4em';
return $vwidth;
}
// /=============
// === HYBRID ===
// =============/
// hybrid_dirs
// hybrid_content_template_hierarchy
// skeleton_content_template_directory
// skeleton_archive_template_directory
// /============/
// ...see Hybrid docs for more available filters!
// /= Hybrid Directory =/
// ----------------------
add_filter('hybrid_dirs', 'muscle_hybrid_dirs');
function muscle_hybrid_dirs($vdirs) {
// paths to search for hybrid.php
return $vdirs;
}
// /= Content Template Hierarchy =/
// --------------------------------
// for advanced content template control
// see hybrid_get_content_template in hybrid/functions/template.php
add_filter('hybrid_content_template_hierarchy','muscle_content_template_hierarchy');
function muscle_content_template_hierarchy($vtemplates) {
// below is the default hybrid content template hierarchy for reference
# $vtemplates = array(); // optionally clear the hierarchy
# $vposttype = get_post_type(get_the_ID());
# if ($vposttype === 'attachment') {
# $vmimetype = get_post_mime_type();
# list( $type, $subtype ) = false !== strpos( $vmimetype, '/' ) ? explode( '/', $vmimetype ) : array($vmimetype, '' );
# $vtemplates[] = "content-attachment-{$vtype}.php";
# $vtemplates[] = "content/attachment-{$vtype}.php";
# }
# if (post_type_supports($vposttype,'post-formats')) {
# $vpostformat = get_post_format() ? get_post_format() : 'standard';
# $vtemplates[] = 'content-{$vposttype}-{$vpostformat}.php';
# $vtemplates[] = 'content/{$vposttype}-{$vpostformat}.php';
# $vtemplates[] = 'content-{$vpostformat}.php';
# $vtemplates[] = 'content/{$vpostformat}.php';
# }
# $vtemplates[] = 'content-{$vposttype}.php';
# $vtemplates[] = 'content/{$vposttype}.php';
# $vtemplates[] = 'content.php';
# $vtemplates[] = 'content/content.php';
return $vtemplates;
}
// /= Content Template Directory =/
// --------------------------------
// 1.9.5: added this filter for changing content template location
add_filter('skeleton_content_template_directory','muscle_content_template_directory');
function muscle_content_template_directory($vcontentdir) {
// Modify the /content/ location for content templates, default is 'content'
# $vcontentdir = 'singular';
return $vcontentdir;
}
// /= Archive Template Directory =/
// --------------------------------
// 1.9.5: added this filter for optional archive template location
add_filter('skeleton_archive_template_directory','muscle_archive_template_directory');
function muscle_archive_template_directory($varchivedir) {
// Modify the optional /archive/ location for archive templates, default is 'archive'
# $varchivedir = 'multlple';
return $varchivedir;
}
// /============
// === SKULL ===
// ============/
// skeleton_theme_hooks
// skeleton_site_icon
// skeleton_title_tag_support
// skeleton_page_title_tag
// skeleton_generator_meta
// skeleton_mobile_metas
// skeleton_apple_icons
// skeleton_startup_images
// skeleton_google_jquery_version
// /===========/
// note: browser and mobile detection filters:
// muscle_styles_* (auto-added)
// /= Theme Action Hooks =/
// ------------------------
// 2.0.9: added theme hook filtering (see hooks.php)
add_filter('skeleton_theme_hooks','muscle_theme_hooks');
function muscle_theme_hooks($vhooks) {
// allows for changing template hook order etc.
return $vhooks;
}
// /= Title Tag Theme Support =/
// -----------------------------
// 1.8.5: added title-tag theme support
add_filter('skeleton_title_tag_support','muscle_title_tag_support');
function muscle_title_tag_support($vsupport) {
// you can turn off theme title-tag support
// and fallback to use of filtered wp_title
# $vsupport = 0;
return $vsupport;
}
// /= Page Title Tag Filter =/
// ---------------------------
// 1.8.5: for wp_title fallback only
// You could remove the title filter eg. if your SEO plugin handles it
# remove_filter('wp_title','bioship_wp_title',10,2);
// or change the title
add_filter('skeleton_page_title_tag','muscle_page_title_tag');
function muscle_page_title_tag($vtitle) {
// Modify the existing title tag here, eg. for pages
# if (is_page()) {
# $vposttitle = get_the_title();
# $vblogname = esc_attr(get_bloginfo('name','display'));
# $vtitle = $vposttitle." | ".$vblogname;
# }
return $vtitle;
}
// /= Mobile Specific Metas =/
// ---------------------------
add_filter('skeleton_mobile_metas','muscle_mobile_metas');
function muscle_mobile_metas($vmobilemetas) {
// Add your own mobile meta tags
# $vmobilemetas .= '';
return $vmobilemetas;
}
// /= Change the Meta Generator Tag =/
// -----------------------------------
add_filter('skeleton_generator_meta','muscle_generator_meta');
function muscle_generator_meta($vmeta) {
// by default is removed entirely
# $vmeta = 'Custom Theme';
return $vmeta;
}
// /= Apple Touch Icon Sizes =/
// ----------------------------
// https://mathiasbynens.be/notes/touch-icons
# remove_filter('skeleton_apple_icons','skeleton_apple_icon_sizes');
add_filter('skeleton_apple_icons','muscle_apple_icon_sizes');
function muscle_apple_icon_sizes($vsizes) {
// Output your own list of sizes and icon URLs (HTML)
# $vsizes = ''; // etc.
return $vsizes;
}
// /= Apple Startup Images =/
// --------------------------
# remove_filter('skeleton_startup_images','skeleton_apple_startup_images');
add_filter('skeleton_startup_images','muscle_apple_startup_images');
function muscle_apple_startup_images($vimages) {
// Output your own list of startup images (HTML)
# $vimages = ''; // etc.
return $vimages;
}
// /= Custom Browser Detection Styling =/
// --------------------------------------
// Note: These filters are auto-added so there is no need to 'add_filter'
// Any existing relevent theme option values are passed to these filters.
// Works much better with PHP Browser Detection, but is not required.
// https://wordpress.org/plugins/php-browser-detection/
// note: uses browscap.ini http://browscap.org/
# $browser_version = get_browser_version();
# $browser_info = php_browser_info();
// IE (is_ie)
function muscle_custom_styles_ie($vstyles) {
# insert other conditional check here eg.
# if (get_browser_version() < 7) {
# $vstyles .= '#updateyourbrowermessage {display:block;}';
# }
return $vstyles;
}
// Firefox (is_firefox)
function muscle_styles_firefox($vstyles) {
# insert other conditional check here eg.
return $vstyles;
}
// Safari (is_safari)
function muscle_styles_safari($vstyles) {
# insert other conditional check here
return $vstyles;
}
// Chrome (is_chrome)
function muscle_styles_chrome($vstyles) {
# insert other conditional check here
return $vstyles;
}
// Opera (is_opera)
function muscle_styles_opera($vstyles) {
# insert other conditional check here
return $vstyles;
}
// Lynx
function muscle_styles_lynx($vstyles) {
# insert other conditional check here eg.
return $vstyles;
}
// Netscape
function muscle_styles_netscape($vstyles) {
# insert other conditional check here eg.
return $vstyles;
}
// /= Custom Mobile Detection Styling =/
// -------------------------------------
// Note: Dynamic Skin CSS must be on for this to work as added via skin.php
// These mobile detection filters require PHP Browser Detection plugin
// https://wordpress.org/plugins/php-browser-detection/
// Note: These filters are auto-added *when PHP Browser Detection plugin is active*
// ...so there is no need for an add_filter line for these functions.
// Any existing relevent theme option values are passed to these filters.
// Desktop only (is_desktop)
function muscle_styles_desktop($vstyles) {
# insert other conditional check here
return $vstyles;
}
// Mobile only (is_mobile)
function muscle_styles_mobile($vstyles) {
# insert other conditional check here
return $vstyles;
}
// Tablet only (is_tablet)
function muscle_styles_tablet($vstyles) {
# insert other conditional check here
return $vstyles;
}
// Desktop only (is_iphone)
function muscle_styles_iphone($vstyles) {
// insert other conditional check here eg.
# is_phone($version)) {$vstyles .= '';}
return $vstyles;
}
// Ipad only styles (is_ipad)
function muscle_styles_ipad($vstyles) {
// insert other conditional check here eg.
# is_pad($version)) {$vstyles .= '';}
return $vstyles;
}
// Ipod only styles (is_ipod)
function muscle_styles_ipod($vstyles) {
// insert other conditional check here eg.
# eg. is_pod($version)) {$vstyles .= '';}
return $vstyles;
}
// /= Google CDN jQuery Version =/
// -------------------------------
add_filter('skeleton_google_jquery_version','muscle_google_jquery_version');
function muscle_google_jquery_version($vversion) {
// use a different version of jQuery (CAUTION: not a good idea!)
// (matching current WordPress version is used by default)
# $vversion = '1.7.2';
return $vversion;
}
// /=================
// === Thumbnails ===
// =================/
// skeleton_thumbnail_width
// skeleton_thumbnail_height
// skeleton_image_sizes
// skeleton_post_thumbnail_size
// skeleton_list_thumbnail_size
// skeleton_thumbnail_wrapper_classes
// skeleton_thumbnail_classes
// skeleton_thumbnail_override
// /================/
// /= Default Thumbnail Width =/
// -----------------------------
add_filter('skeleton_thumbnail_width','muscle_thumbnail_width');
function muscle_thumbnail_width($vwidth) {
# $vwidth = 200;
return $vwidth;
}
// /= Default Thumbnail Height =/
// ------------------------------
add_filter('skeleton_thumbnail_height','muscle_thumbnail_height');
function muscle_thumbnail_height($vheight) {
# $vheight = 200;
return $vheight;
}
// /= Media Image Sizes =/
// -----------------------
add_filter('skeleton_image_sizes','muscle_image_sizes');
function muscle_image_sizes($vimagesizes) {
// Ref: Default image sizes
// $vimagesizes[0] = array('name' => 'squared150', 'width' => 150, 'height' => 150, 'crop' => true);
// $vimagesizes[1] = array('name' => 'squared250', 'width' => 250, 'height' => 250, 'crop' => true);
// $vimagesizes[2] = array('name' => 'video43', 'width' => 320, 'height' => 240, 'crop' => true);
// $vimagesizes[3] = array('name' => 'video169', 'width' => 320, 'height' => 180, 'crop' => true);
// eg. Add an image size (here 600x600)
# $vimagesizes[] = array('name' => 'squared600', 'width' => 600, 'height' => 600, 'crop' => true);
// eg. Change cropping defaults for an image size
# foreach ($vimagesizes as $vkey => $vimagesize) {
# if ($vimagesize['name'] == 'squared150') {
# $vimagesizes[$vkey]['crop'] = array('top','left');
# }
# }
return $vimagesizes;
}
// /= Post List Thumbnail Size =/
// ------------------------------
add_filter('skeleton_list_thumbnail_size','muscle_list_thumbnail_size');
function muscle_list_thumbnail_size($vsize) {
// eg. Set to 4:3 video size for custom post type of 'video'
# if (is_post_type_archive('video')) {$vsize = 'video43';}
// eg. Set to squared150 for search pages
# if (is_search()) {$vsize = 'squared150';}
return $vsize;
}
// /= Post List Thumbnail Alignment =/
// -----------------------------------
add_filter('skeleton_list_thumbnail_align','muscle_list_thumbnail_align');
function muscle_list_thumbnail_align($valign) {
// change the thumbnail list alignment
# if (is_post_type_archive('video')) {$valign = 'alignright';}
return $valign;
}
// /= Post Thumbnail Size =/
// -------------------------
// note: also used for page featured images
// filter exists at priority 1 for theme options perpost metabox override
add_filter('skeleton_post_thumbnail_size','muscle_post_thumbnail_size',10);
function muscle_post_thumbnail_size($vsize) {
// eg. Set to full size for the 'images' category
# if (is_category('images')) {$vsize = 'full';}
// eg. Set to full size for custom post type of 'image'
# if (get_post_type(get_the_ID()) == 'image') {$vsize = 'full';}
# OR alternatively
# if (is_singular('image')) {$vsize = 'full';}
return $vsize;
}
// /= Post Thumbnail Alignment =/
// ------------------------------
add_filter('skeleton_post_thumbnail_align','muscle_post_thumbnail_align');
function muscle_post_thumbnail_align($valign) {
// change the post thumbnail alignment
# if (get_post_type(get_the_ID()) == 'video')) {$valign = 'alignright';}
return $valign;
}
// /= Thumbnail Wrapper Classes =/
// -------------------------------
add_filter('skeleton_thumbnail_wrapper_classes','muscle_thumbnail_wrapper_classes');
function muscle_thumbnail_wrapper_classes($vclasses) {
// eg. change the default alignment to right for a particular post ID
# if (get_the_ID() == '100') {$vclasses = str_replace('alignleft','alignright',$vclasses);}
return $vclasses;
}
// /= Thumbnail Image Classes =/
// -----------------------------
add_filter('skeleton_thumbnail_classes','muscle_thumbnail_classes');
function muscle_thumbnail_classes($vclasses) {
// eg. add an additional class for all archive type pages
# if (is_archive()) {$vclasses .= ' archive-thumbnail';}
return $vclasses;
}
// /= Thumbnail Override =/
// ------------------------
add_filter('skeleton_thumbnail_override','muscle_thumbnail_override');
function muscle_thumbnail_override($vhtml) {
// completely override the outputted thumbnail HTML
// eg. do not show thumbnails at all on search pages
# if (is_search()) {$vhtml = '';}
// eg. set a different thumbnail size for the first thumbnail
// if on the homepage or frontpage, here medium (300x300)
# if ( (is_home()) || (is_front_page()) ) {
# if (strstr($vhtml,'')) {
# $vhtml = skeleton_get_thumbnail(get_the_ID(),get_post_type(get_the_ID()),'medium');
# }
# }
return $vhtml;
}
// /===============
// === SKELETON ===
// ===============/
// skeleton_html_comments
// skeleton_layout_width
// skeleton_grid_columns
// skeleton_content_grid_columns
// skeleton_container_classes
// skeleton_header_classes
// skeleton_blog_display_name
// skeleton_blog_description
// skeleton_site_title_display
// skeleton_site_title_description
// skeleton_header_logo_url
// skeleton_header_logo_override
// skeleton_logo_resize
// skeleton_header_menu_settings
// skeleton_header_html_extras
// skeleton_navigation_remove
// skeleton_content_classes
// skeleton_content_columns
// skeleton_content_columns_override
// skeleton_content_width
// skeleton_content_padding_width
// skeleton_footer_classes
// skeleton_footer_menu_settings
// skeleton_footer_html_extras
// /==============/
// /= HTML Comment Wrappers (boolean) =/
// -------------------------------------
// 1.8.5: added this filter
add_filter('skeleton_html_comments', 'muscle_html_comments');
function muscle_html_comments($vhtmlcomments) {
// show HTML element comment wrappers on pages only
# if (is_page()) {$vhtmlcomments = 1;}
return $vhtmlcomments;
}
// /= Maximum Layout Width (integer) =/
// ------------------------------------
add_filter('skeleton_layout_width', 'muscle_layout_width');
function muscle_layout_width($vwidth) {
// maximum width to scale up to via media queries
// 1.5.0: original layout width maximums were 960, 1140 or 1200
// but now this can be set to anything in theme options
# $vwidth = 1200;
return $vwidth;
}
// /= Grid Columns Override (integer) =/
// -------------------------------------
// 1.8.5: added override in grid.php
add_filter('skeleton_grid_columns', 'muscle_grid_columns');
function muscle_grid_columns($columns) {
// set different total layout grid columns for a page
// (you would want to filter sidebar and content columns also)
// valid values 12,16,20,24 (word or number)
# $columns = '20';
return $columns;
}
// /= Content Grid Columns Override (integer) =/
// ---------------------------------------------
// 1.9.5: added this option and filter
add_filter('skeleton_content_grid_columns', 'muscle_content_grid_columns');
function muscle_content_grid_columns($columns) {
// set different total content grid columns, eg. for blog page
// valid values 12,16,20,24 (word or number)
# if (is_home()) ($columns = '20';}
return $columns;
}
// /= Wrap Container Div Classes (array) =/
// ----------------------------------------
add_filter('skeleton_container_classes', 'muscle_container_classes');
function muscle_container_classes($classes) {
// default is an array of container classes based on grid
// you can add extra classes, eg.
# if (is_page()) {$classes[] = 'mycontainerclass';}
return $classes;
}
// /= Header Div Classes (array) =/
// --------------------------------
add_filter('skeleton_header_classes', 'muscle_header_classes');
function muscle_header_classes($classes) {
// default is an array of header classes based on grid
// you can add extra classes, eg.
# if (is_page()) {$classes[] = 'myheaderclass';}
return $classes;
}
// /= Blog Title Display Name (string) =/
// --------------------------------------
// 1.8.5: (currently only applies to header blog title output)
add_filter('skeleton_blog_display_name', 'muscle_blog_display_name');
function muscle_blog_display_name($sitename) {
// change the site title display
# eg. recapitalize site title
# $sitename = "Bio Ship";
return $sitename;
}
// /= Blog Description (string) =/
// -------------------------------
// 1.8.5: (currently only applies to header description output)
add_filter('skeleton_blog_description', 'muscle_blog_description');
function muscle_blog_description($description) {
// change the blog description displayed,
# eg. split desciption display up with line breaks
# $description = str_replace(' ', ' ', $description);
return $description;
}
// /= Header Site Title Display (boolean) =/
// -----------------------------------------
// 2.1.1: added missing site title display filter example
add_filter('skeleton_site_title_display', 'muscle_site_title_display');
function muscle_site_title_display($display) {
# eg. only display site title in header on front page
# if (!is_front_page()) {$display = false;} else {$display = true;}
return $display;
}
// /= Header Site Description Display (boolean) =/
// -----------------------------------------------
// 2.1.1: added missing site title description filter example
add_filter('skeleton_site_description_display', 'muscle_site_description_display');
function muscle_site_description_display($display) {
# eg. do not display site description in header on blog page
# if (is_home()) {$display = false;} else {$display = true;}
return $display;
}
// /= Header Logo URL (url) =/
// ---------------------------
add_filter('skeleton_header_logo_url', 'muscle_header_logo_url');
function muscle_header_logo_url($url) {
// to override the logo URL on a per page basis
# eg. change the logo URL for the front page or home page
# if (is_front_page()) {$url = site_url().'/images/frontpage-logo.png';}
# if (is_home()) {$url = site_url().'/images/blogpage-logo.png';}
return $url;
}
// /= Header Logo Override (html) =/
// ---------------------------------
add_filter('skeleton_header_logo_override', 'muscle_header_logo_override');
function muscle_header_logo_override($html) {
// override the entire HTML logo area output
# if (is_front_page()) {$html = my_custom_header_html_function();}
return $html;
}
// /= Header Logo Resize (boolean) =/
// ----------------------------------
add_filter('skeleton_logo_resize', 'muscle_logo_resize_override');
function muscle_logo_resize_override($resize) {
// You could turn logo resize on/off for specific page eg.
# if (is_front_page()) {$resize = 0;}
return $resize;
}
// /= Header Menu Settings (array) =/
// ----------------------------------
add_filter('skeleton_header_menu_settings', 'muscle_header_menu_settings');
function muscle_header_menu_settings($args) {
// change the settings for the header menu display
# eg. change the menu container ID
# $args['container_id'] = 'header_menu';
return $args;
}
// /= Header Extras Output Override (html) =/
// ------------------------------------------
add_filter('skeleton_header_extras', 'muscle_header_extras');
function muscle_header_extras($html) {
// You can set header extra text here as HTML, eg.
# $extras = '
Welcome!
';
// or maybe add shortcode output, eg.
# $extras .= do_shortcode('[header-html]');
return $extras;
}
// /= Navigation Hide Override (boolean) =/
// ----------------------------------------
// 1.5.5: allow override of navigation hide
// TODO: recheck if hide is incorrect name here?
add_filter('skeleton_navigation_remove', 'muscle_navigation_remove');
function muscle_navigation_remove($removenav) {
// "hide" main navigation menu for a specific category
# if (is_category('articles')) {$removenav = true;}
return $removenav;
}
// /= Navigation Menu (html) =/
// ----------------------------
add_filter('skeleton_secondary_menu', 'muscle_secondary_menu');
function muscle_secondary_menu($html) {
// override the secondary navigation output
# example
return $html;
}
// /= Content Classes (array) =/
// -----------------------------
add_filter('skeleton_content_classes', 'muscle_content_classes');
function muscle_content_classes($classes) {
// add CSS classes to the #content div
# if (is_page('home')) {$classes = 'contentclass';}
return $classes;
}
// /= Content Columns (string) =/
// ------------------------------
add_filter('skeleton_content_columns', 'muscle_content_columns');
function muscle_content_columns($vcolumns) {
// modify the content columns layout width value (in columns value as a word)
// (important: differs from $content_width variable! see functions.php)
# $columns = 'ten';
return $vcolumns;
}
// /= Content Columns Override =/
// ------------------------------
// prefer above filter, takes into account sidebar columns
// this one can override regardless of that result
add_filter('skeleton_content_columns_override','muscle_content_columns_override');
function muscle_content_columns_override($vcolumns) {
// eg. override as full width for a specific page
# if (is_page(1)) {$vcolumns = 'sixteen';}
return $vcolumns;
}
// /= Content Width Override (integer) =/
// --------------------------------------
add_filter('skeleton_content_width', 'muscle_content_width');
function muscle_content_width($width) {
// the actual layout content width in pixels
// (default is calculated based on content columns and content padding)
return $width;
}
// /= Content Padding Width Override (integer) =/
// ----------------------------------------------
add_filter('skeleton_content_padding_width', 'muscle_content_padding_width');
function muscle_content_padding_width($width) {
// used to calculate actual content width in pixels
// (default is calculated from theme settings content padding value)
return $width;
}
// /= Footer Div Classes (array) =/
// --------------------------------
add_filter('skeleton_footer_classes', 'muscle_footer_classes');
function muscle_footer_classes($classes) {
// default is an array of footer classes based on grid
// you can add extra classes, eg.
# if (is_page()) {$classes[] = 'myfooterclass';}
return $classes;
}
// /= Footer Menu Settings (array) =/
// ----------------------------------
add_filter('skeleton_footer_menu_settings', 'muscle_footer_menu_settings');
function muscle_footer_menu_settings($settings) {
// change the settings for the footer menu display
return $settings;
}
// /= Footer Extras HTML Override (html) =/
// ----------------------------------------
add_filter('skeleton_footer_html_extras','muscle_footer_extras');
function muscle_footer_extras($extras) {
// You can set footer extra text as HTML, eg. copyright year
# $extras = '
';
return $vwrappers;
}
// /= Sidebar Labels Override =/
// -----------------------------
add_filter('skeleton_sidebar_settings','muscle_sidebar_settings');
function muscle_sidebar_settings($vsettings) {
// can change the registered sidebar label array
// for individual sidebar labels and wrappers by sidebar id
// eg. add a title class to a particular sidebar type
# foreach ($vsettings as $vid => $vsetting) {
# if ($vid == 'search') {
# $vsettings[$vid]['beforetitle'] = '
';
# }
# }
return $vsettings;
}
// /= Sidebar Layout Override =/
// -----------------------------
add_filter('skeleton_sidebar_layout_override','muscle_sidebar_layout_override');
function muscle_sidebar_layout_override($vsidebars) {
# extensive examples and explanation needed for this in guide
return $vsidebars;
}
// /= Change the Header Sidebar Template =/
// ----------------------------------------
add_filter('skeleton_header_sidebar','muscle_header_sidebar_template');
function muscle_header_sidebar_template($vtemplate) {
// eg, look for header-page.php sidebar template for pages
// (note: template file and corresponding widget will need to be created)
# if (get_post_type(get_the_ID()) == 'page') {return 'header-page';}
return $vtemplate;
}
// /= Sidebar Position =/
// ----------------------
// 1.5.0: added this filter
// Valid Values: left, right
add_filter('skeleton_sidebar_position','muscle_sidebar_position');
function muscle_sidebar_position($vposition) {
// eg. swap the from left to right for pages
# if ( (is_page()) && ($vposition == 'left') ) {$vposition = 'right';}
return $vposition;
}
// /= Sidebar Mode =/
// ------------------
// 1.8.5: added missing example
// Valid Values: off, postsonly, pagesonly, dual, unified
add_filter('skeleton_sidebar_mode','muscle_sidebar_mode');
function muscle_sidebar_mode($vmode) {
return $vmode;
}
// /= Sidebar Column Width =/
// --------------------------
// 1.5.0: moved here from old skeleton_set_sidebarwidth function
add_filter('skeleton_sidebar_columns', 'muscle_sidebar_columns');
function muscle_sidebar_columns($vcolumns) {
// eg. change the main sidebar column width for a particlur page
# if (is_page('about')) {return 'three';}
// eg. change the column width for video archive pages
# if (is_post_type_archive('video')) {return 'two';}
return $vcolumns;
}
// /= Sidebar Class Filter =/
// --------------------------
// 1.8.0: allow sidebar classes to be filtered
add_filter('skeleton_sidebar_classes', 'muscle_sidebar_classes');
function muscle_sidebar_classes($vclasses) {
// eg. add an alpha or omega class to fix margins
# $vclasses[] = 'alpha';
return $vclasses;
}
// /= Sidebar Hide =/
// ------------------
// 1.5.5: allow the sidebar to be hidden conditionally
// (perpost meta is checked for this also)
add_filter('skeleton_sidebar_hide', 'muscle_sidebar_hide');
function muscle_sidebar_hide($vhidesidebar) {
// eg. hide the sidebar for a specific category
# is (is_category('articles')) {$vhidesidebar = true;}
return $vhidesidebar;
}
// /= Sidebar Output =/
// --------------------
// 1.9.5: allow the sidebar to be removed conditionally
add_filter('skeleton_sidebar_output', 'muscle_sidebar_output');
function muscle_sidebar_output($voutputsidebar) {
// eg. remove the sidebar for a specific category
# is (is_category('articles')) {$voutputsidebar = false;}
return $voutputsidebar;
}
// /= Sidebar Display Buttons (html) =/
// ------------------------------------
add_filter('skeleton_sidebar_display_buttons', 'muscle_sidebar_display_buttons');
function muscle_sidebar_display_buttons($html) {
// HTML output for sidebar show/hide buttons
return $html;
}
// /= Subsidebar Position =/
// -------------------------
// 1.5.0: added this filter
// Valid Values: internal, external, opposite
add_filter('skeleton_subsidebar_position','muscle_subsidebar_position');
function muscle_subsidebar_position($vposition) {
// eg. swap the from internal to opposite for pages
# if ( (is_page()) && ($vposition == 'internal') ) {$vposition = 'opposite';}
return $vposition;
}
// /= SubSidebar Mode =/
// ------------------
// 1.8.5: added missing example
// Valid Values: off, postsonly, pagesonly, dual, unified
add_filter('skeleton_subsidebar_mode','muscle_subsidebar_mode');
function muscle_subsidebar_mode($vmode) {
return $vmode;
}
// /= SubSidebar Column Width =/
// -----------------------------
// 1.5.0: activated this filter
add_filter('skeleton_subsidebar_columns', 'muscle_subsidebar_columns');
function muscle_subsidebar_columns($vcolumns) {
// eg. change the subsidebar column width for a particlur page
# if (is_page('about')) {return 'three';}
// eg. change the column width for video archive pages
# if (is_post_type_archive('video')) {return 'two';}
return $vcolumns;
}
// = SubSidebar Class Filter =
// ---------------------------
// 1.8.0: allow subsidebar classes to be filtered
add_filter('skeleton_subsidebar_classes', 'muscle_subsidebar_classes');
function muscle_subsidebar_classes($vclasses) {
// eg. add an alpha or omega class to fix margins
# $vclasses[] = 'alpha';
return $vclasses;
}
// /= SubSidebar Hide =/
// ---------------------
// 1.5.5: allow the subsidebar to be hidden conditionally
// (perpost meta is checked for this also)
add_filter('skeleton_subsidebar_hide', 'muscle_subsidebar_hide');
function muscle_subsidebar_hide($vhidesubsidebar) {
// eg. hide the subsidebar for a specific category
# is (is_category('articles')) {$vhidesubsidebar = true;}
return $vhidesubsidebar;
}
// /= SubSidebar Output =/
// -----------------------
// 1.9.5: allow the subsidebar to be removed conditionally
add_filter('skeleton_subsidebar_output', 'muscle_subsidebar_output');
function muscle_subsidebar_output($voutputsubsidebar) {
// eg. remove the subsidebar from a specific category
# is (is_category('articles')) {$voutputsubsidebar = false;}
return $voutputsubsidebar;
}
// /= SubSidebar Display Buttons (html) =/
// ---------------------------------------
add_filter('skeleton_subsidebar_display_buttons', 'muscle_subsidebar_display_buttons');
function muscle_subsidebar_display_buttons($html) {
// HTML output for subsidebar show/hide buttons
return $html;
}
// /= Change the Footer Sidebar Template =/
// ----------------------------------------
add_filter('skeleton_footer_sidebar','muscle_footer_sidebar_template');
function muscle_footer_sidebar_template($vtemplate) {
// eg, look for footer-page.php sidebar template for pages
// (note: template file and corresponding widget will need to be created)
# if (get_post_type(get_the_ID()) == 'page') {return 'footer-page';}
return $vtemplate;
}
// /= Post/Page Sidebars =/
// ------------------------
// (1.8.0 DEPRECATED) use skeleton_sidebar_layout_override instead
// for override post/page sidebar template used
// add_filter('skeleton_sidebar_layout_position','muscle_sidebar_layout_position');
// function muscle_sidebar_layout_position($vposition) {
// // eg. swap the order that sidebars are called
// // (note this does not change the position styling however)
// # if ($vposition == 'left') {$vposition = 'right';}
// # elseif ($vposition == 'right') {$vposition = 'left';}
// // eg. remove a righthand page subsidebar for about page
// // by returning an empty position value
// # if ( (is_page('about')) && ($vposition == 'right') ) {return '';}
// // eg. or call an alternative sidebar template for an about page
// // (note: template file and corresponding widget will need to be created)
// # if ( (is_page('about')) && ($vposition == 'right') ) {
// # hybrid_get_sidebar('about'); return '';
// # }
// return $vposition;
// }
// /= Custom Post Type Sidebars =/
// -------------------------------
// (1.8.0 DEPRECATED) use skeleton_sidebar_layout_override instead
// sidebar_layout_* filter
// calling alternative sidebar templates for custom post type 'customslug'
// called by skeleton_get_sidebar_layout if post type is not 'post' or 'page'
// add_filter('skeleton_sidebar_layout_customslug','muscle_sidebar_layout_customslug');
// function muscle_sidebar_layout_customslug($vposition) {
// // eg, load a custom sidebar for this post type
// # if ($vposition == 'left') {hybrid_get_sidebar('customleft');}
// # if ($vposition == 'right') {hybrid_get_sidebar('customright');}
// // or for 2 left-hand sidebars for this post type
// # if ($vposition == 'left') {
// # hybrid_get_sidebar('customleft');
// # hybrid_get_sidebar('customleft2');
// # }
// // does not output any sidebars by default
// return $vposition;
// }
// /= No Post Type Sidebar =/
// --------------------------
// (1.8.0 DEPRECATED) use skeleton_sidebar_layout_override instead
// catches if post type is passed as empty
// add_filter('skeleton_sidebar_layout_general','muscle_sidebar_layout_general');
// function muscle_sidebar_layout_general($vposition) {
// // probably doesn't ever happen but post type might be empty somehow
// // if sidebars are disappearing because of this you could use a fallback
// # hybrid_get_sidebar('fallback');
// # return 'anything';
// return $vposition;
// }
// /===========
// === META ===
// ===========/
// skeleton_subtitle_key
// skeleton_meta_format_top
// skeleton_meta_format_bottom
// skeleton_list_meta_format_top
// skeleton_list_meta_format_bottom
// skeleton_meta_override_top
// skeleton_meta_override_bottom
// skeleton_author_bio_box
// skeleton_author_bio_box_position
// skeleton_author_bio_avatar_size
// skeleton_about_author_text
// skeleton_author_posts_anchor
// skeleton_comments_avatar_size
// skeleton_comments_popup_size
// skeleton_comments_template
// skeleton_post_type_display
// skeleton_pagenavi_post_types
// skeleton_pagenavi_archive_types
// skeleton_pagenavi_override
// skeleton_breadcrumb_post_types
// skeleton_breadcrumb_archive_types
// skeleton_breadcrumb_override
// /==========/
// TODO: Breadcrumb Filter Examples
// /= Subtitle Key Filter =/
// -------------------------
add_filter('skeleton_subtitle_key','muscle_subtitle_key');
function muscle_subtitle_key($vsubtitlekey) {
// returns the post/page custom field meta key used for subtitles
// default is the WP Subtitle Plugin key: 'wps_subtitle'
// if using another subtitle plugin you may need to change this
// eg. for video posts if subtitle is stored in 'video_subtitle'
# if (get_post_type(get_the_ID()) == 'video') {$vsubtitlekey = 'video_subtitle';}
return $vsubtitlekey;
}
// /= Meta Top Format =/
// ---------------------
add_filter('skeleton_meta_format_top','muscle_meta_format_top');
function muscle_meta_format_top($vargs) {
# $vformat = $vargs['format'];
# $vposttype = $vargs['posttype'];
# $vpostid = $vargs['postid'];
// Here you could return a different meta format
// according to post type or other logic
# if ($vposttype == 'video') {$vargs['format'] = 'Video Metaline.';}
return $vargs;
}
// /= Meta Bottom Format =/
// ------------------------
add_filter('skeleton_meta_format_bottom','muscle_meta_format_bottom');
function muscle_meta_format_bottom($vargs) {
# $vformat = $vargs['format'];
# $vposttype = $vargs['posttype'];
# $vpostid = $vargs['postid'];
// Here you could return a different meta format
// according to post type or other logic, eg.
# if ($vposttype == 'video') {$vargs['format'] = 'Video Metaline.';}
return $vargs;
}
// /= List Entry Meta Top =/
// -------------------------
add_filter('skeleton_list_meta_format_top','muscle_list_meta_format_top');
function muscle_list_meta_format_top($vformat) {
// default is set via theme options
// override whether the entry meta top is shown in a post list
// eg. for a 'video' post type, don't show the entry meta in post list
# if (get_post_type() == 'video') {return '0';}
return $vformat;
}
// /= List Entry Meta Bottom =/
// ----------------------------
add_filter('skeleton_list_meta_format_bottom','muscle_list_meta_format_bottom');
function muscle_list_meta_format_bottom($vformat) {
// default is set via theme options
// override whether the entry meta bottom is shown in a post list
// eg. for a 'video' post type, do show the entry meta bottom in post list
# if (get_post_type() == 'video') {return '1';}
return $vformat;
}
// /= Entry Meta Top Override =/
// -----------------------------
add_filter('skeleton_meta_override_top','muscle_meta_override_top');
function muscle_meta_override_top($vmeta) {
// here you can completely override the entry meta top output
// eg. clear the top meta output for search results
# if (is_search()) {$vmeta = '';}
return $vmeta;
}
// /= Entry Meta Bottom Override =/
// --------------------------------
add_filter('skeleton_meta_override_bottom','muscle_meta_override_bottom');
function muscle_meta_override_bottom($vmeta) {
// here you can completely override the entry meta bottom output
// eg. clear the bottom meta output for all archive pages
# if (is_archive()) {$vmeta = '';}
return $vmeta;
}
// /= Author Bio Box =/
// --------------------
add_filter('skeleton_author_bio_box','muscle_author_bio_box');
function muscle_author_bio_box($vshowbox) {
// override when the author bio box is shown
// set $vshowbox to '1' to display, anything else to not display
// (value is already set for current post type)
// eg. always hide for a particular post category
# if (is_category('Site News')) {$vshowbox = 0;}
return $vshowbox;
}
// /= Author Bio Box Position =/
// -----------------------------
add_filter('skeleton_author_bio_box_position','muscle_author_bio_box_position');
function muscle_author_bio_box_position($vposition) {
// override the selected theme options bio box position
// eg. if bottom by default for a page, switch to top
// remembering to handle to other position or you get two
# if (get_post_type()) == 'page') {
# if ($vposition == 'top') {$vposition == 'bottom';}
# elseif ($vposition == 'bottom') {$vposition == 'top;}
# }
return $vposition;
}
// /= Author Bio Avatar Size =/
// ----------------------------
add_filter('skeleton_author_bio_avatar_size','muscle_author_bio_avatar_size');
function muscle_author_bio_avatar_size($vsize) {
// change the squared size of the Author Avatar in the bio box
// eg. a different size for a video post type
# if (get_post_type() == 'video') {$vsize = '96';}
return $vsize;
}
// /= About Author Text =/
// -----------------------
add_filter('skeleton_about_author_text','muscle_about_author_text');
function muscle_about_author_text($vboxtitle) {
// override the "About {author_name}" box title
// eg. use "{authorname}'s Bio" instead
# $vboxtitle = esc_attr(sprintf(__('%s\'s Bio', 'bioship'), get_the_author() ));
return $vboxtitle;
}
// /= Author Posts Anchor Text =/
// ------------------------------
add_filter('skeleton_author_posts_anchor','muscle_author_posts_anchor');
function muscle_author_posts_anchor($vanchor) {
// override the 'View all {post_type}s by {author_name}' anchor text
// eg. use 'Read more {post_type}s by {author_name}
# global $post; $vposttype = $post->post_type;
# if ( ($vposttype != 'page') && ($vposttype != 'post') ) {
# $vposttypeobject = get_post_type_object($vposttype);
# $vposttypedisplay = $vposttypeobject->labels->singular_name;
# $vposttypedisplay = bioship_apply_filters('skeleton_post_type_display',$vposttypedisplay);
# }
# $vanchor = sprintf(__( 'Read more '.$vposttypedisplay.'s by %s →', 'bioship' ), get_the_author()) );
return $vanchor;
}
// /= Comments Closed Text =/
// --------------------------
add_filter('skeleton_comments_closed_text','muscle_comments_closed_text');
function muscle_comments_closed_text($vtext) {
// default is empty, no text displayed
// eg. say comments are closed
# $vtext = 'Comments are Closed.';
return $vtext;
}
// /= No Comments Text =/
// ----------------------
add_filter('skeleton_no_comments_text','muscle_no_comments_text');
function muscle_no_comments_text($vtext) {
// default is empty, no text displayed
// eg. say Be the first to add a comment
# $vtext = 'Be the first to add a comment...';
return $vtext;
}
// /= Commenter Avatar Size =/
// ---------------------------
add_filter('skeleton_comments_avatar_size','muscle_comments_avatar_size');
function muscle_comments_avatar_size($vsize) {
// change the avatar size in comments, default 48, eg. 32 square
# $vsize = '32';
return $vsize;
}
// /= Comments Template =/
// -----------------------
add_filter('skeleton_comments_template','muscle_comments_template');
function muscle_comments_template($vtemplate) {
// change the default comments template used from comments.php
// note: do not forget the leading / slash or it will fail
// you can already use comments-{posttype}.php via hierarchy
// eg. for an alternative about page comments template
# if (is_page('About')) {$vtemplate = '/about-comments.php';}
return $vtemplate;
}
// /= Comments Popup Size =/
// -------------------------
add_filter('skeleton_comments_popup_size','muscle_comments_popup_size');
function muscle_comments_popup_size($vsizearray) {
// change the comments popup window size (500x500 default)
// eg. for a 640x480 comments popup window
# $vsizearray[0] = 600; $vsizearray[1] = 480;
return $vsizearray;
}
// /= Post Type Display Name =/
// ----------------------------
add_filter('skeleton_post_type_display','muscle_post_type_display');
function muscle_post_type_display($vposttypedisplay) {
// defaults to the label set in post type object
// change a post type display name eg, a CPT slug to display name
# if ($vposttype == 'dwqa-question') {return 'Support Question';}
return $vposttypedisplay;
}
// /= Page Navigation Post Types =/
// --------------------------------
add_filter('skeleton_pagenavi_post_types','muscle_pagenavi_post_types');
function muscle_pagenavi_post_types($vposttype) {
// by default page navigation is off for pages
// eg, you could turn it on for a certain page
# if (is_page('123')) {$vposttype = 'page';}
return $vposttype;
}
// /= Page Navigation Archive Post Types =/
// -----------------------------------
add_filter('skeleton_pagenavi_archive_types','muscle_pagenavi_archive_types');
function muscle_pagenavi_archive_types($vposttype) {
// by default page navigation is off for pages
// eg, you could turn it on for a certain page
# if (is_page('123')) {$vposttype = 'page';}
return $vposttype;
}
// /= Page Navigation Override =/
// ------------------------------
add_filter('skeleton_pagenavi_override','muscle_pagenavi_override');
function muscle_pagenavi_override($vpagenav) {
// override the page navigation output
# $vpagenave = my_custom_pagenav();
return $vpagenav;
}
// /= Breadcrumb Post Types =/
add_filter('skeleton_breadcrumb_post_types','muscle_breadcrumb_post_types');
function muscle_breadcrumb_post_types($vposttypes) {
# TODO: example
return $vposttypes;
}
// /= Breadcrumb Archive Post Types =/
add_filter('skeleton_breadcrumb_archive_types','muscle_breadcrumb_archive_types');
function muscle_breadcrumb_archive_types($varchivetypes) {
# TODO: example
return $varchivetypes;
}
// /= Breadcrumb Override =/
add_filter('skeleton_breadcrumb_override','muscle_breadcrumb_override');
function muscle_breadcrumb_override($vhtml) {
# TODO: example
return $vhtml;
}
// /=============
// === MUSCLE ===
// =============/
// muscle_display_overrides
// muscle_perpage_styles
// muscle_widget_text_shortcodes
// muscle_widget_title_shortcodes
// muscle_smooth_scrolling
// muscle_load_selectivizr
// muscle_load_html5shiv
// muscle_load_supersleight
// muscle_load_ie8dom
// muscle_load_flexibility
// muscle_load_nwwatcher
// muscle_load_nwevents
// muscle_load_mediaqueries
// muscle_load_csssupports
// muscle_load_matchmedia
// muscle_load_modernizr
// muscle_load_matchheight
// muscle_load_prefixfree
// muscle_load_fastclick
// muscle_load_mousewheel
// muscle_load_stickykit
// muscle_sticky_elements
// muscle_load_fitvids
// muscle_fitvids_elements
// muscle_load_scrolltofixed
// muscle_login_header_url
// muscle_login_header_title
// /============/
// /= Display Overrides =/
// -----------------------
add_filter('muscle_display_overrides','muscle_display_override_filter');
function muscle_display_override_filter($voverride) {
// Here you could force enable or disable of a page override eg.
# if (get_post_type(get_the_ID()) == 'video') {
# $voverride['hideheader'] = ''; $voverride['hidesidebar'] = '1';
# }
return $voverride;
}
// /= Perpage Styles =/
// --------------------
add_filter('muscle_perpage_styles','muscle_perpage_styles_filter');
function muscle_perpage_styles_filter($vstyles) {
// Here you could add styles to specific post types eg.
# if (get_post_type(get_the_ID()) == 'video') {
# $vstyles .= '.videocontainer {width:95%;}';
# }
return $vstyles;
}
// /= Do shortcodes in Widget Text =/
// ----------------------------------
add_filter('muscle_widget_text_shortcodes','muscle_widget_text_do_shortcodes');
function muscle_widget_text_do_shortcodes($vswitch) {
// defaults to true, but you can turn them off eg.
# $vswitch = false;
return $vswitch;
}
// /= Do Shortcodes in Widget Titles =/
// ------------------------------------
add_filter('muscle_widget_title_shortcodes','muscle_widget_title_do_shortcodes');
function muscle_widget_title_do_shortcodes($vswitch) {
// defaults to true, but you can turn them off eg.
# $vswitch = false;
return $vswitch;
}
// /= Smooth Scrolling =/
// ----------------------
add_filter('muscle_smooth_scrolling','muscle_custom_smooth_scrolling');
function muscle_custom_smooth_scrolling($vsmoothscrolling) {
// could conditionally load smooth scrolling, eg.
# if (is_page()) {$vsmoothscrolling = 1;}
return $vsmoothscrolling;
}
// /= Selectivizr Loading =/
// -------------------------
// add_filter('muscle_load_selectivizr', '');
// /= HTML5 Shiv Loading =/
// ------------------------
// add_filter('muscle_load_html5shiv', '');
// /= Supersleight Loading =/
// --------------------------
// add_filter('muscle_load_supersleight', '');
// /= IE8 DOM Polyfill Loadin =/
// -----------------------------
// add_filter('muscle_load_ie8dom', '');
// /= Flexibility (Flexbox Polyfill) Loading =/
// --------------------------------------------
// add_filter('muscle_load_flexibility', '');
// /= NW Watcher Loading =/
// ------------------------
// add_filter('muscle_load_nwwatcher', '');
// /= NW Events Loading =/
// -----------------------
// add_filter('muscle_load_nwevents', '');
// /= MediQueries Loading =/
// -------------------------
// add_filter('muscle_load_mediaqueries', '');
// /= CSS Supports Loading =/
// --------------------------
// add_filter('muscle_load_csssupports', '');
// /= MatchMedia Loading =/
// ------------------------
// add_filter('muscle_load_matchmedia', '');
// /= Modernizr Loading =/
// -----------------------
// add_filter('muscle_load_modernizr', '');
// /= MatchHeight Loading =/
// -------------------------
// add_filter('muscle_load_matchheight', '');
// /= Prefix Free Loading =/
// -------------------------
add_filter('muscle_load_prefixfree','muscle_custom_load_prefixfree');
function muscle_custom_load_prefixfree($vprefixfree) {
// could conditionally load prefixfree, eg.
# if (is_page()) {$vprefixfree = 1;}
return $vprefixfree;
}
// /= Fast Click Loading =/
// ------------------------
add_filter('muscle_load_fastclick','muscle_custom_load_fastclick');
function muscle_custom_load_fastclick($vfastclick) {
// could conditionally load fastclick, eg.
# if (is_page()) {$vfastclick = 1;}
return $vfastclick;
}
// /= Mouse Wheel Loading =/
// -------------------------
add_filter('muscle_load_mousewheel','muscle_custom_load_mousewheel');
function muscle_custom_load_mousewheel($vmousewheel) {
// could conditionally load mousewheel, eg.
# if (is_page()) {$vmousewheel = 1;}
return $vmousewheel;
}
// /= StickyKit Loading =/
// -----------------------
add_filter('muscle_load_stickykit','muscle_custom_load_stickykit');
function muscle_custom_load_stickykit($vstickykit) {
// could conditionally load stickykit, eg.
# if (is_page()) {$vstickykit = 1;}
return $vstickykit;
}
// /= Sticky Kit Elements =/
// -------------------------
add_filter('muscle_sticky_elements','muscle_custom_stickykit_elements');
function muscle_custom_stickykit_elements($velements) {
// eg. do not sticky float subsidebar for single posts
# if ( (is_post_type('post')) && (is_singular()) ) {
# $velements = str_replace('#sidebar','',$velements);
# }
return $velements;
}
// /= FitVids Loading =/
// ---------------------
add_filter('muscle_load_fitvids','muscle_custom_load_fitvids');
function muscle_custom_load_fitvids($vfitvids) {
// could conditionally load fitvids, eg.
# if (is_page()) {$vfitvids = 1;}
return $vfitvids;
}
// /= FitVids Elements =/
// ----------------------
add_filter('muscle_fitvids_elements','muscle_custom_fitvids_elements');
function muscle_custom_fitvids_elements($velements) {
// eg. Use fitvids on #sidebar as well as #content for video archives
# if (is_post_type_archive('video')) {$velements .= ',#sidebar';
return $velements;
}
// /= Scroll to Fixed Loading =/
// -----------------------------
add_filter('muscle_load_scrolltofixed','muscle_custom_load_scrolltofixed');
function muscle_custom_load_scrolltofixed($vscrolltofixed) {
// could conditionally load scroll to fixed, eg.
# if (is_page()) {$vscrolltofixed = 1;}
return $vscrolltofixed;
}
// /= Login Header URL =/
// ----------------------
add_filter('muscle_login_header_url', 'muscle_custom_login_header_url');
function muscle_login_header_url($vurl) {
// wrapper for login_headerurl filter
return $vurl;
}
// /= Login Header Title =/
// ------------------------
add_filter('muscle_login_header_title', 'muscle_custom_login_header_title');
function muscle_custom_login_header_title($vtitle) {
// wrapper for login_headertitle filter
return $vtitle;
}
// /= Fullscreen Video Background =/
// ---------------------------------
// TODO: a theme option could be added for this, currently only via filters
// this uses filters to create a hidden input in footer (see muscle.php)
// these launch the video using these values via init.js and video-background.js
// note: javascripts/video-background.js currently only supports 'youtube' mode
// Sitewide Example
# add_filter('muscle_videobackground_type','muscle_video_background_type');
# function muscle_video_background_type() {return 'youtube';}
// note: the youtube video ID ie. http:/youtube.com/?v=myvideoid
# add_filter('muscle_videobackground_id','muscle_video_background_id');
# function muscle_video_background_id() {return 'myvideoid';}
// note: the delay before video start in milliseconds, default 1000
# add_filter('muscle_videobackground_delay','muscle_video_background_delay');
# function muscle_video_background_delay() {return '5000';}
// Frontpage Only Example
# add_filter('muscle_videobackground_type','muscle_video_background_type');
# function muscle_video_background_type() {
# if (is_front_page()) {return 'youtube';}
# }
# add_filter('muscle_videobackground_id','muscle_video_background_id');
# function muscle_video_background_id() {
# if (is_front_page()) {return 'myvideoid';}
# }
# add_filter('muscle_videobackground_delay','muscle_video_background_delay');
# function muscle_video_background_delay() {
# if (is_front_page()) {return '5000';}
# }
// /===========
// === SKIN ===
// ===========/
// skin_dynamic_css
// skin_dynamic_admin_css
// skin_dynamic_login_css
// /==========/
// /= Dynamic CSS Replacement =/
// -----------------------------
add_filter('skin_dynamic_css','muscle_dynamic_css');
function muscle_dynamic_css($vcss) {
// Add some CSS string replacement rules
# if (strstr($vcss,'%SOMETHING%')) {
# $vcss = str_replace('%SOMETHING%','something.png',$vcss);
# }
// or add some extra CSS to your site
// note: conditional page context checks will fail in this filter
// if it is loaded by the (preferred) direct or admin-ajax methods
# $vcss .= '';
return $vcss;
}
// /= Dynamic Admin CSS =/
// -----------------------
add_filter('skin_dynamic_admin_css','muscle_dynamic_admin_css');
function muscle_dynamic_admin_css($vcss) {
// Add some CSS string replacement rules
# if (strstr($vcss,'%SOMETHING%')) {
# $vcss = str_replace('%SOMETHING%','something.png',$vcss);
# }
// or add some extra CSS to the admin
# $vcss .= '';
return $vcss;
}
// /= Dynamic Login CSS =/
// -----------------------
add_filter('skin_dynamic_login_css','muscle_dynamic_login_css');
function muscle_dynamic_login_css($vcss) {
// Add some CSS string replacement rules
# if (strstr($vcss,'%SOMETHING%')) {
# $vcss = str_replace('%SOMETHING%','something.png',$vcss);
# }
// or add some extra CSS to the login page
# $vcss .= '';
return $vcss;
}
// /============
// === ADMIN ===
// ============/
// admin_adminbar_theme_options
// admin_adminbar_menu_icon
// admin_adminbar_theme_options_title
// admin_adminbar_theme_options_icon
// admin_adminbar_howdy_title
// admin_adminbar_remove_items
// admin_admin_footer_text
// admin_page_recommendations
// /===========/
// /= AdminBar Theme Options Link =/
// ---------------------------------
// 1.8.5: changed from option to filter
add_filter('admin_adminbar_theme_options','muscle_admin_bar_theme_options');
function muscle_admin_bar_theme_options($vadminbar) {
// could turn this off
# $vadminbar = 0;
return $vadminbar;
}
// /= Change AdminBar Theme Options menu Title =/
// --------------------------------------------------
add_filter('admin_adminbar_theme_options_title','muscle_adminbar_menu_title');
function muscle_adminbar_menu_title($vtitle) {
// note: default menu title is "Theme Options"
// eg. change to '{Theme Name} Options' for child theme
# if (is_child_theme()) {
# global $vthemename; // $vtheme = wp_get_theme(); $vthemename = $vtheme['Name'];
# $vtitle = $vthemename.' '.__('Options', 'bioship');
# }
return $vtitle;
}
// /= Options AdminBar Icon =/
// ---------------------------
// 1.8.0: for default theme options AdminBar item link
// ref: http://calebserna.com/dashicons-cheatsheet/
add_filter('admin_adminbar_menu_icon','muscle_adminbar_menu_icon');
function muscle_adminbar_menu_icon($vicon) {
// default menu icon is '\\f115'
// note: be sure to escape the backslash!
# $vicon = '\\f100';
return $vicon;
}
// /= Change the Admin Bar Theme Options Icon =/
// ---------------------------------------------
add_filter('admin_adminbar_theme_options_icon','muscle_adminbar_theme_options_icon');
function muscle_adminbar_theme_options_icon($vurl) {
// note: adminbar icon size is forced to 22px by 22px via skin.php
// default searches for /images/theme-icon.png via file hierarchy
// you could change this to a different filename, eg. child-icon.png
# global $vthemedirs;
# $viconurl = bioship_file_hierarchy('url','child-icon.png',$vthemedirs['image']);
# if ($viconurl) {return $viconurl;}
return $vurl;
}
// /= Replace the Admin Bar "Howdy" text =/
// ----------------------------------------
add_filter('admin_adminbar_howdy_title','muscle_loggedinas_message');
function muscle_loggedinas_message($vtitle) {
// note: default already changed to "Logged in as {user_name}"
// eg. change to "Account: {user_name}"
# global $current_user; wp_get_current_user();
# $vusername = $current_user->user_login;
# $vtitle = __('Account: ', 'bioship').$vusername;
return $vtitle;
}
// /= Remove Admin Bar Items =/
// ----------------------------
// 1.8.0: added this filter
add_filter('admin_adminbar_remove_items','muscle_adminbar_remove_items');
function muscle_adminbar_remove_items($vitems) {
// WordPress adminbar items removed by default
# $vitems = array();
return $vitems;
}
// /= Replace the Admin Footer text =/
// -----------------------------------
add_filter('admin_admin_footer_text','muscle_admin_footer_text');
function muscle_admin_footer_text($vtext) {
// default is to remove footer text (return empty)
// You could say anything else here, eg.
# $vtext = "Don't forget to Smile! :-)";
return $vtext;
}
// /= Show Admin Recommendations /=
// --------------------------------
add_filter('admin_show_recommendations', 'muscle_admin_show_recommendations');
function muscle_admin_show_recommendations($vswitch) {
return $vswitch;
}
// /= Admin Page Recommendations /=
// --------------------------------
add_filter('admin_page_recommendations', 'muscle_admin_page_recommendations');
function muscle_admin_page_recommendations($vhtml) {
return $vhtml;
}
// --------------------
// === INTEGRATIONS ===
// --------------------
// /============================
// == Jetpack Infinite Scroll ==
// ============================/
// skeleton_infinite_scroll_numposts
// skeleton_infinite_scroll_settings
// /===========================/
// /= Infinite Scroll Number of Posts each Load =/
// -----------------------------------------------
add_filter('skeleton_infinite_scroll_numposts','muscle_infinite_scroll_numposts');
function muscle_infinite_scroll_numposts($vnumposts) {
// change the number of posts each load
# $vnumposts = 3;
return $vnumposts;
}
// /= Infinite Scroll Settings =/
// ------------------------------
add_filter('skeleton_infinite_scroll_settings','muscle_infinite_scroll_settings');
function muscle_infinite_scroll_settings($vsettings) {
// use an alternative custom loop render function
# $vsettings['render'] = 'my_custom_render_loop';
return $vsettings;
}
// /==================
// === WooCommerce ===
// ==================/
// skeleton_woocommerce_alternative_directory
// skeleton_declare_woocommerce_support
// /=================/
// Even though WooCommerce is "free", all the extensions for WooCommerce are
// ridiculously expensive - probably as a result of the development costs for
// having to integrate with the existing WooCommerce programming. (Just my
// opinion of course, you can compare ecommerce extension costs yourself.)
// So if you have NOT already setup an online store with it, I recommend looking
// at alternatives such as eStore: http://bioship.space/recommends/eStore/
// Even though it is not "free", it is better value overall considering extensions
// that come with it, and it has just as many, actually many more options in-built.
// /= Alternative Template Directory =/
// ------------------------------------
add_filter('skeleton_woocommerce_alternative_directory','muscle_woocommerce_alternative_directory');
function muscle_woocommerce_alternative_directory($vswitch) {
// to turn off alternate /templates/woocommerce/ directory and use /woocommerce/ default
# $vswitch = false;
return $vswitch;
}
// /= Declare WooCommerce Support =/
// ---------------------------------
// ref: http://docs.woothemes.com/document/third-party-custom-theme-compatibility/
add_filter('skeleton_declare_woocommerce_support','muscle_declare_woocommerce_support');
function muscle_declare_woocommerce_support($vswitch) {
// you could turn off woocommerce support declaration
# $vswitch = '0';
return $vswitch;
}
// /========================
// = TGM Plugin Activation =
// ========================/
// tgm_plugins_array
// tgm_config_array
// tgm_theme_page_message
// tgm_plugin_page_message
// tgm_plugin_bundles_path
// /=======================/
// /= TGM Recommended Plugins =/
// -----------------------------
add_filter('tgm_plugins_array','muscle_tgm_plugins_array');
function muscle_tgm_plugins_array($vplugins) {
// Add to or modify the recommended plugins array
// see end of parent functions.php for existing array
// see /includes/tgm-examples.php for in-depth examples
// eg. add back some recommendations from the SMPL Skeleton Theme
# $vplugins[] = array('name'=>'WP-PageNavi','slug'=>'wp-pagenavi','required'=>false);
# $vplugins[] = array('name'=>'Simple Shortcodes','slug'=>'smpl-shortcodes','required'=>false);
return $vplugins;
}
// /= TGM Configuration =/
// -----------------------
add_filter('tgm_config_array','muscle_tgm_config_array');
function muscle_tgm_config_array($vconfig) {
// Add to or modify the TGM configuration array
// see end of parent functions.php for existing array
# $vconfig[''] =
return $vconfig;
}
// /= TGM Theme Page Message =/
// ----------------------------
// note: called inside of the tgm_config_array filter
add_filter('tgm_theme_page_message','muscle_theme_page_message');
function muscle_theme_page_message($vmessage) {
// Here you can change the outputted message on the theme options page.
# $vmessage = 'Theme Plugin Recommendations. ';
return $vmessage;
}
// /= TGM Plugin Page Message =/
// -----------------------------
add_filter('tgm_plugin_page_message','muscle_plugin_page_message');
function muscle_plugin_page_message($vmessage) {
// Here you can change the outputted message on the TGM plugin page.
# $vmessage = 'Plugin Recommendation Installation Page. ';
return $vmessage;
}
// /= TGM Plugins Bundle Path =/
// -----------------------------
add_filter('tgm_plugin_bundles_path','muscle_plugin_bundles_path');
function muscle_plugin_bundles_path($vpath) {
// change bundle path to the child theme subdirectory
# $vpath = get_stylesheet_directory().'/plugins/';
return $vpath;
}
// /==========================
// === Open Graph Protocol ===
// ==========================/
// muscle_open_graph_default_image
// muscle_open_graph_default_image_size
// muscle_open_graph_override_image
// /=========================/
// some custom filters are added here for image handling:
// http://www.itthinx.com/plugins/open-graph-protocol/
// Ref: http://docs.itthinx.com/document/open-graph-protocol-framework/
// note available filters for Open Graph Protocol plugin meta tags:
// open_graph_protocol_meta
// open_graph_protocol_meta_tag
// open_graph_protocol_metas
// open_graph_protocol_echo_metas
// /= Open Graph Default Image =/
// ------------------------------
// Just set the default open graph image (in-built call in muscle.php)
// (if there is no featured image for the post)
add_filter('muscle_open_graph_default_image','muscle_open_graph_default_image_url');
function muscle_open_graph_default_image_url($vurl) {
// override the default open graph url set via theme options
// any valid image URL will do here, 600x600 is optimal (afaik)
# $vurl = site_url().'/images/my-sites-default-image.png';
return $vurl;
}
// /= Open Graph Default Image Size =/
// -----------------------------------
// Set the default image size fallback - for trouble cases only
// (you only need this if both allow_fopen_url is off and url to path fails)
add_filter('muscle_open_graph_default_image_size','muscle_open_graph_default_size');
function muscle_open_graph_default_size($vimagesize) {
// set an explicit width[0] and height[1] for the default image URL
# $vimagesize[0] = '600'; $vimagesize[1] = '600';
return $vimagesize;
}
// /= Open Graph Image Override =/
// -------------------------------
// Override open graph images conditionally (in-built call in muscle.php)
// (even if there is a already a featured image for this post)
// priority set to 1 as we have the existing custom field value override at 0
add_filter('muscle_open_graph_override_image','muscle_open_graph_override_image_custom',1);
function muscle_open_graph_override_image_custom($vimage) {
// override the existing open graph image meta
// return any array with width[0], height[1] and url[2]
// the URL needs to be here at least, width and height better but optional
// for example, setup image URLs for categories based on ID so we can upload to:
// /images/category-image-1.jpg, /images/category-image-2.jpg, etc...
# if (is_category()) {
# global $wp_query; // bizarre: no wp function to get current category ID
# $vi = $wp_query->cat_ID; // so just getting it from the main wp_query
# $vogimage = array();
# $vimagepath = '/images/category-image-'.$vi.'.jpg';
// here we are setting an explicit common width[0] and height[1]
// and the image URL itself [2] to the image array returned
# if (file_exists(ABSPATH.$vimagepath)) {
# $vogimage[0] = '600'; $vogimage[1] = '600';
# $vogimage[2] = site_url().$vimagepath;
# }
# }
# if (isset($vogimage[2])) {if ($vogimage[2] != '') {return $vogimage;} }
return $vimage;
}
// /===== END FILTERS ===== DOC BOUNDARY =====/ //
?>