Theme Setup

Bootstrap

The iPress theme has a number of configurable constant values that can be changed depending on what you decide the overall theme name to be called. These are in the bootstrap.php file of the child & standalone themes.

As of yet WordPress can not use a variable as a language definition, which is more of a PHP limitation. See the languages section for more details.

Configuration

The sections below will take you through the options available for theme setup. The Custom Hooks section in the configuration file is where these hooks should be placed.

// Set content width for image manipulation
add_filter( 'ipress_content_width', function() {
  return 960;
} );
    

// Set thumbnail post types, default post
add_filter( 'ipress_post_thumbnails_post_types', function() { 
  return [ 'post', 'course' ];
);
    

// Set thumbnail default size: width, height, crop
add_filter( 'ipress_post_thumbnail_size', function() { 
  return [
    50, 50, [ 'center', 'center' ]
  ];
);
    

// Core image sizes overrides
add_filter( 'ipress_image_size_default, function() { 
  return [
    'large',
    'medium',
    'thumbnail'
  ];
);
    

// Add custom image size, override at lower priority
add_filter( 'ipress_add_image_size', function() {
 return [
    'ipress_small' => [ 200, 150, true ],
    'ipress_square' => [ 500, 500 ]
  ];
} );
    

// Turn off big image support, override at lower priority
add_filter('ipress_big_image_size', '__return_false' );
    

// Register default menu locations, override at lower priority
add_filter( 'ipress_nav_menus', function() {
  return [
    'primary' => __( 'Primary Menu', 'ipress' ),
    'footer-nav-1' => __( 'Footer column navigation 1', 'ipress' ),
    'footer-nav-2' => __( 'Footer column navigation 2', 'ipress' ),
    'footer-nav-3' => __( 'Footer column navigation 3', 'ipress' ),
    'footer-nav-4' => __( 'Footer column navigation 4', 'ipress' )
  ];
} );
    

// Enable support for HTML5 markup, override at lower priority
add_filter( 'ipress_html5', function() {
  return [ 'search-form', 'comment-form', 'comment-list', 'gallery' ];
} );
    

// Enable support for post-formats, override at lower priority
add_filter( 'ipress_post_formats', function() {
  return [ 'aside', 'image', 'gallery' ];
} );
    

// Enable theme support, override at lower priority
add_filter( 'ipress_theme_support', function() {
  return [ 'align-wide', 'responsive-embeds' ];
} );
    

// Disable theme support, override at lower priority
add_filter( 'ipress_remove_theme_support', function() {
  return [ 'align-wide', 'responsive-embeds' ];
} );
    

// Custom title tag features, override at lower priority
add_filter( 'ipress_custom_title_tag', '__return_true' );

// Set title separator
add_filter( 'ipress_document_title_separator', function() {
  return '-';
} );

// Append or prepend?
add_filter( 'ipress_home_doctitle_append', '__return_true' );

// Set doctitle separator
add_filter( 'ipress_doctitle_separator', function() {
  return '|';
} );
    

Customizer

The WordPress customizer is a modern method for real-time modification of theme pages. There are a number of optional sections to the customizer that can be enabled & disabled as needed. The sections below will take you through the options available for theme customizer setup. The Custom Hooks section in the configuration file is where these hooks should be placed.

// Set custom logo parameters
add_filter( 'ipress_custom_logo_args', function() {
  return [
    'width' => 360,
    'height' => 200
  ];
} );
    

// Enable custom header
add_filter( 'ipress_custom_header', '__return_true' );

// Set custom header default image, requires custom header to be active
add_filter( 'ipress_custom_header_default_image', function() {
  return $image_url;
} );

// Set custom header parameters, required custom header to be active
add_filter( 'ipress_custom_header_args', function() {
  return [
    'header-text' => true,
    'width' => 1740,
    'height' => 360
  ];
} );

// Force custom header uploads, requires custom headers to be active
add_filter( 'ipress_custom_header_uploads', '__return_true' );

// Filterable default header settings, requires custom headers to be active
add_filter( 'ipress_default_headers', '__return_true' );

// Set custom header parameters, required custom header to be active
add_filter( 'ipress_default_header_args', function() {
  'ipress_default_header_args', [
    'default-image' => [
    'url'           => '%s/assets/images/header.jpg',
    'thumbnail_url' => '%s/assets/images/header.jpg',
    'description'   => __( 'Default Header Image', 'ipress' ),
  ]
} );
    

// Enable custom background
add_filter( 'ipress_custom_background', '__return_true' );

// Set custom background default image, requires custom background to be active
add_filter( 'ipress_custom_background_default_image', function() {
  return $image_url;
} );

// Set custom background default color, requires custom background to be active
add_filter( 'ipress_custom_background_default_color', function() {
  return '#eee';
} );

// Set custom background parameters, required custom background to be active
add_filter( 'ipress_custom_background_args', function() {
  return [
    'default-image' => esc_url_raw( $image_url ),
    'default-color' => '#aaa'
  ];
} );
    

// Disable selective refresh
add_filter( 'ipress_custom_selective_refresh', '__return_false' );
    

// Disable header partials
add_filter( 'ipress_customize_header_partials', '__return_false' );
    

// Register control type
add_filter( 'ipress_customize_register_control_type, function() {
  return [];
} );
    

// Register control sectiom
add_filter( 'ipress_customize_register_control_section, function() {
  return [];
} );
    

// Enable customizer JS sections, requires boolean
add_filter( 'ipress_custom_js, '__return_true' );
    

Editor

Adds callback for custom TinyMCE editor stylesheets. Allows theme developers to link a custom stylesheet file to the TinyMCE visual editor.

// Enable editor styles support, requires boolean
add_filter( 'ipress_editor_styles', '__return_true' );

// Register editor font sizes, requires editor styles to be active
add_filter( 'ipress_editor_font_sizes', function() {
  return [
    [
      'name' => __( 'Large', 'ipress' ),
      'size' => 28,
      'slug' => 'large'
    ],
    [
      'name' => __( 'Big', 'ipress' ),
      'size' => 32,
      'slug' => 'big'
    ],
  ];
} );

// Register editor font styles, requires editor styles to be active
add_filter( 'ipress_editor_styles_url', function() {
  return esc_url_raw( $url );
} );
    

Header

The header section of any web page contains a number of specific tags to define what a page is and does, as well as scripts and styles. WordPress injects much of this through the wp_head() functionality. Some of this is legacy code and some extraneous. The iPress theme can modify a lot of this to provide a semantically cleaner head section.

// Enable editor styles support, requires boolean, default false
add_filter( 'ipress_header_clean', '__return_true' );

// Remove feed & rsd links, requires boolean, default false, requires clean header to be active
add_filter( 'ipress_header_links', '__return_true' );

// Remove index & rel links, requires boolean, default false, requires clean header to be active
add_filter( 'ipress_header_index', '__return_true' );

// Remove WordPress XHTML generator, default false, requires clean header to be active
add_filter( 'ipress_header_generator', '__return_true' );

// Remove versioning from scripts, default false, requires clean header to be active
add_filter( 'ipress_header_version', '__return_true' );

// Clean CSS tags from enqueued stylesheets & gallery, default false, requires clean header to be active
add_filter( 'ipress_header_css', '__return_true' );

// Remove inline recent comment styles from wp_head(), default false, requires clean header to be active
add_filter( 'ipress_header_comments', '__return_true' );

// Canonical refereneces, default false, requires clean header to be active
add_filter( 'ipress_header_canonical', '__return_true' );

    

// Remove Comments funtionality from the admin UI & frontend: Admin UI comments links, Post-type support, Frontend display
add_filter( 'ipress_comments_clean', '__return_true' );
    

// Remove emojicons support - hurrah!, default false
add_filter( 'ipress_disable_emojicons', '__return_true' );
    

Body

The body_class function is normally placed inside the html tag. WordPress injects specific classes based on post & page type, and available functionality. The iPress theme can modify this class sequence prior to display

// Modify body classes, always return the existing classes value
add_filter( 'ipress_body_class', function( $classes ) {
	
  // Front Page
  if ( is_front_page() ) {
    $classes[] = 'is-front-page';
  }

  // 404 page
  if ( is_404() ) {
    $classes[] = 'is-page-404';
  }

  // Case Studies
  if ( is_singular( 'case_studies' ) ) {
    $parent_id = get_page_by_path( 'case-studies' )->ID;
    $parent_name = 'case-studies';
    $classes[] = 'case-study-single';
    $classes[] = 'parent_id-' . $parent_id;
    $classes[] = 'parent_name-' . $parent_name; 
  }

  return $classes;
} );