functions.php

<?php
/**
 * Alien Ship functions and definitions
 *
 * @package Alien Ship
 * @subpackage Functions
 * @author John Parris
 * @copyright Copyright (c) 2012, John Parris
 * @link http://www.johnparris.com/alienship/
 * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 */

/**
 * Set the content width based on the theme's design and stylesheet.
 * @since Alien Ship 0.1
 */
if ( ! isset( $content_width ) )
  $content_width = 940; /* pixels */


if ( ! function_exists( 'alienship_setup' ) ):
/**
 * Sets up theme defaults and registers support for various WordPress features.
 *
 * Note that this function is hooked into the after_setup_theme hook, which runs
 * before the init hook. The init hook is too late for some features, such as indicating
 * support post thumbnails.
 * @since Alien Ship 0.1
 */
function alienship_setup() {

  /* Custom template tags for this theme. */
  locate_template('/inc/template-tags.php', true);

  /* Clean up header output */
  locate_template('/inc/cleanup.php', true);

  /* Register the navigation menus. */
  locate_template('/inc/menus.php', true);

  /* Register sidebars */
  locate_template('/inc/sidebars.php', true);

  /* Header image */
  locate_template('/inc/header-image.php', true);

    /* Load theme options framework */
  locate_template('/inc/options-panel.php', true);

  /* Breadcrumbs */
  if ( of_get_option('alienship_breadcrumbs',1) ) {
    locate_template('/inc/breadcrumbs.php', true);
  }

  /* Custom functions that act independently of the theme templates */
  locate_template('/inc/tweaks.php', true);

  /* Load the CSS */
  locate_template('/inc/stylesheets.php', true);

  /* Load Bootstrap javascript */
  locate_template('/inc/bootstrap-js.php', true);

  /* Load Theme Layouts extension and add theme support for desired layouts */
  locate_template('/inc/theme-layouts.php', true);
  add_theme_support( 'theme-layouts', array( '1c', '2c-l', '2c-r' ) );

  /**
   * Make theme available for translation
   * Translations can be filed in the /languages/ directory
   * If you're building a theme based on alienship, use a find and replace
   * to change 'alienship' to the name of your theme in all the template files
   */
  load_theme_textdomain( 'alienship', get_template_directory() . '/languages' );


  /* Add default posts and comments RSS feed links to head */
  add_theme_support( 'automatic-feed-links' );


  /* Add support for post-thumbnails */
  add_theme_support('post-thumbnails');


  /* Add support for post formats. To be styled in later release. */
  add_theme_support( 'post-formats', array( 'aside', 'gallery', 'link', 'image', 'quote', 'status', 'video', 'audio', 'chat' ));

}
endif; // alienship_setup
add_action( 'after_setup_theme', 'alienship_setup' );


/*
 * Allow "a", "embed" and "script" tags in theme options text boxes
 */
function optionscheck_change_sanitize() {
  remove_filter( 'of_sanitize_text', 'sanitize_text_field' );
  add_filter( 'of_sanitize_text', 'custom_sanitize_text' );
}
add_action( 'admin_init','optionscheck_change_sanitize', 100 );

function custom_sanitize_text($input) {
  global $allowedposttags;
  $custom_allowedtags["a"] = array(
    "href" => array(),
    "target" => array(),
    "id" => array(),
    "class" => array() );
    $custom_allowedtags = array_merge($custom_allowedtags, $allowedposttags);
    $output = wp_kses( $input, $custom_allowedtags);
  return $output;
}


/* Display a notice about menu functionality */
function alienship_admin_notice_menus() {
  global $current_user ;
  global $pagenow;
    $user_id = $current_user->ID;
    /* Check that we're an admin, that we're on the menus page, and that the user hasn't already ignored the message */
  if ( current_user_can('administrator') && $pagenow =='nav-menus.php' && ! get_user_meta($user_id, 'alienship_admin_notice_menus_ignore_notice') ) {
    echo '<div class="updated"><p>';
    printf(__('Dropdown menus work a little differently in Alien Ship. They do not activate on mouse hover, but on click instead. This means that the top/parent menu item does not click through to a page, but only activates the dropdown. Design your menus with this in mind. For more information, read the <a href="http://www.johnparris.com/alienship/documentation" target="_blank">Alien Ship documentation</a> online. | <a href="%1$s">Hide this notice</a>'), '?alienship_admin_notice_menus_ignore=0');
    echo "</p></div>";
  }
}
add_action('admin_notices', 'alienship_admin_notice_menus');

function alienship_admin_notice_menus_ignore() {
  global $current_user;
    $user_id = $current_user->ID;
    /* If user clicks to ignore the notice, add that to their user meta */
    if ( isset($_GET['alienship_admin_notice_menus_ignore']) && '0' == $_GET['alienship_admin_notice_menus_ignore'] ) {
      add_user_meta($user_id, 'alienship_admin_notice_menus_ignore_notice', 'true', true);
  }
}
add_action('admin_init', 'alienship_admin_notice_menus_ignore');


/**
 * Snatched from future release code in WordPress repo.
 *
 * Retrieve the URI of the highest priority template file that exists.
 *
 * Searches in the stylesheet directory before the template directory so themes
 * which inherit from a parent theme can just overload one file.
 *
 * @param string|array $template_names Template file(s) to search for, in order.
 * @return string The URI of the file if one is located.
 */
if ( ! function_exists( 'alienship_locate_template_uri' ) ):
function alienship_locate_template_uri( $template_names ) {
 $located = '';
 foreach ( (array) $template_names as $template_name ) {
   if ( !$template_name )
     continue;
   if ( file_exists(get_stylesheet_directory() . '/' . $template_name)) {
     $located = get_stylesheet_directory_uri() . '/' . $template_name;
     break;
   } else if ( file_exists(get_template_directory() . '/' . $template_name) ) {
     $located = get_template_directory_uri() . '/' . $template_name;
     break;
   }
 }

 return $located;
}
endif;



/**
 * Alien Ship RSS Feed Dashboard Widget
 *
 * Retrieve the latest news from Alien Ship home page
 *
 * @since Alien Ship .63
 *
 */
function alienship_rss_dashboard_widget() {
  echo '<div class="rss-widget">';
  wp_widget_rss_output( array(
    'url' => 'http://www.johnparris.com/alienship/feed',
    'title' => 'Alien Ship News',
    'items' => 3,
    'show_summary' => 1,
    'show_author' => 0,
    'show_date' => 1
  ) );
  echo '</div>';
}

function alienship_custom_dashboard_widgets() {
  wp_add_dashboard_widget( 'dashboard_custom_feed', 'Alien Ship News', 'alienship_rss_dashboard_widget' );
}
add_action('wp_dashboard_setup', 'alienship_custom_dashboard_widgets');


/* Set RSS update time to every 6 hours */
add_filter( 'wp_feed_cache_transient_lifetime', create_function('$a', 'return 21600;') );



/**
 * Creates the title based on current view
 *
 * @since .94
 */
function alienship_wp_title( $title, $sep ) {
  global $paged, $page;

  if ( is_feed() )
    return $title;

  // Add the site name.
  $title .= get_bloginfo( 'name' );

  // Add the site description for the home/front page.
  $site_description = get_bloginfo( 'description', 'display' );
  if ( $site_description && ( is_home() || is_front_page() ) )
    $title = "$title $sep $site_description";

  // Add a page number if necessary.
  if ( $paged >= 2 || $page >= 2 )
    $title = "$title $sep " . sprintf( __( 'Page %s', 'alienship' ), max( $paged, $page ) );

  return $title;
}
add_filter( 'wp_title', 'alienship_wp_title', 10, 2 );



/**
 * Define theme layouts
 * @since .94
 */
function alienship_layouts_strings() {
    $strings = array(
      'default'           => __( 'Default', 'alienship' ),
      '2c-l'              => __( 'Content left. Sidebar right.', 'alienship' ),
      '2c-r'              => __( 'Content right. Sidebar left.', 'alienship' ),
      '1c'                => __( 'Full width. No sidebar.', 'alienship' ),
    );
    return $strings;
}
add_filter( 'theme_layouts_strings', 'alienship_layouts_strings' );