root/tags/2.5.1/wp-includes/general-template.php

<?php

/* Note: these tags go anywhere in the template */

function get_header() {
    do_action( 'get_header' );
    if ( file_exists( TEMPLATEPATH . '/header.php') )
        load_template( TEMPLATEPATH . '/header.php');
    else
        load_template( ABSPATH . 'wp-content/themes/default/header.php');
}


function get_footer() {
    do_action( 'get_footer' );
    if ( file_exists( TEMPLATEPATH . '/footer.php') )
        load_template( TEMPLATEPATH . '/footer.php');
    else
        load_template( ABSPATH . 'wp-content/themes/default/footer.php');
}


function get_sidebar( $name = null ) {
    do_action( 'get_sidebar' );
    if ( isset($name) && file_exists( TEMPLATEPATH . "/sidebar-{$name}.php") )
        load_template( TEMPLATEPATH . "/sidebar-{$name}.php");
    elseif ( file_exists( TEMPLATEPATH . '/sidebar.php') )
        load_template( TEMPLATEPATH . '/sidebar.php');
    else
        load_template( ABSPATH . 'wp-content/themes/default/sidebar.php');
}


function wp_loginout() {
    if ( ! is_user_logged_in() )
        $link = '<a href="' . get_option('siteurl') . '/wp-login.php">' . __('Log in') . '</a>';
    else
        $link = '<a href="' . get_option('siteurl') . '/wp-login.php?action=logout">' . __('Log out') . '</a>';

    echo apply_filters('loginout', $link);
}


function wp_register( $before = '<li>', $after = '</li>' ) {

    if ( ! is_user_logged_in() ) {
        if ( get_option('users_can_register') )
            $link = $before . '<a href="' . get_option('siteurl') . '/wp-login.php?action=register">' . __('Register') . '</a>' . $after;
        else
            $link = '';
    } else {
        $link = $before . '<a href="' . get_option('siteurl') . '/wp-admin/">' . __('Site Admin') . '</a>' . $after;
    }

    echo apply_filters('register', $link);
}


function wp_meta() {
    do_action('wp_meta');
}


function bloginfo($show='') {
    echo get_bloginfo($show, 'display');
}

/**
 * Note: some of these values are DEPRECATED. Meaning they could be
 * taken out at any time and shouldn't be relied upon. Options
 * without "// DEPRECATED" are the preferred and recommended ways
 * to get the information.
 */
function get_bloginfo($show = '', $filter = 'raw') {

    switch($show) {
        case 'url' :
        case 'home' : // DEPRECATED
        case 'siteurl' : // DEPRECATED
            $output = get_option('home');
            break;
        case 'wpurl' :
            $output = get_option('siteurl');
            break;
        case 'description':
            $output = get_option('blogdescription');
            break;
        case 'rdf_url':
            $output = get_feed_link('rdf');
            break;
        case 'rss_url':
            $output = get_feed_link('rss');
            break;
        case 'rss2_url':
            $output = get_feed_link('rss2');
            break;
        case 'atom_url':
            $output = get_feed_link('atom');
            break;
        case 'comments_atom_url':
            $output = get_feed_link('comments_atom');
            break;
        case 'comments_rss2_url':
            $output = get_feed_link('comments_rss2');
            break;
        case 'pingback_url':
            $output = get_option('siteurl') .'/xmlrpc.php';
            break;
        case 'stylesheet_url':
            $output = get_stylesheet_uri();
            break;
        case 'stylesheet_directory':
            $output = get_stylesheet_directory_uri();
            break;
        case 'template_directory':
        case 'template_url':
            $output = get_template_directory_uri();
            break;
        case 'admin_email':
            $output = get_option('admin_email');
            break;
        case 'charset':
            $output = get_option('blog_charset');
            if ('' == $output) $output = 'UTF-8';
            break;
        case 'html_type' :
            $output = get_option('html_type');
            break;
        case 'version':
            global $wp_version;
            $output = $wp_version;
            break;
        case 'language':
            $output = get_locale();
            $output = str_replace('_', '-', $output);
            break;
        case 'text_direction':
            global $wp_locale;
            $output = $wp_locale->text_direction;
            break;
        case 'name':
        default:
            $output = get_option('blogname');
            break;
    }

    $url = true;
    if (strpos($show, 'url') === false &&
        strpos($show, 'directory') === false &&
        strpos($show, 'home') === false)
        $url = false;

    if ( 'display' == $filter ) {
        if ( $url )
            $output = apply_filters('bloginfo_url', $output, $show);
        else
            $output = apply_filters('bloginfo', $output, $show);
    }

    return $output;
}


function wp_title($sep = '&raquo;', $display = true, $seplocation = '') {
    global $wpdb, $wp_locale, $wp_query;

    $cat = get_query_var('cat');
    $tag = get_query_var('tag_id');
    $category_name = get_query_var('category_name');
    $author = get_query_var('author');
    $author_name = get_query_var('author_name');
    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');
    $day = get_query_var('day');
    $title = '';

    // If there's a category
    if ( !empty($cat) ) {
            // category exclusion
            if ( !stristr($cat,'-') )
                $title = apply_filters('single_cat_title', get_the_category_by_ID($cat));
    } elseif ( !empty($category_name) ) {
        if ( stristr($category_name,'/') ) {
                $category_name = explode('/',$category_name);
                if ( $category_name[count($category_name)-1] )
                    $category_name = $category_name[count($category_name)-1]; // no trailing slash
                else
                    $category_name = $category_name[count($category_name)-2]; // there was a trailling slash
        }
        $cat = get_term_by('slug', $category_name, 'category', OBJECT, 'display');
        if ( $cat )
            $title = apply_filters('single_cat_title', $cat->name);
    }

    if ( !empty($tag) ) {
        $tag = get_term($tag, 'post_tag', OBJECT, 'display');
        if ( is_wp_error( $tag ) )
            return $tag;
        if ( ! empty($tag->name) )
            $title = apply_filters('single_tag_title', $tag->name);
    }

    // If there's an author
    if ( !empty($author) ) {
        $title = get_userdata($author);
        $title = $title->display_name;
    }
    if ( !empty($author_name) ) {
        // We do a direct query here because we don't cache by nicename.
        $title = $wpdb->get_var($wpdb->prepare("SELECT display_name FROM $wpdb->users WHERE user_nicename = %s", $author_name));
    }

    // If there's a month
    if ( !empty($m) ) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
        $my_day = intval(substr($m, 6, 2));
        $title = "$my_year" . ($my_month ? "$sep $my_month" : "") . ($my_day ? "$sep $my_day" : "");
    }

    if ( !empty($year) ) {
        $title = $year;
        if ( !empty($monthnum) )
            $title .= " $sep " . $wp_locale->get_month($monthnum);
        if ( !empty($day) )
            $title .= " $sep " . zeroise($day, 2);
    }

    // If there is a post
    if ( is_single() || is_page() ) {
        $post = $wp_query->get_queried_object();
        $title = strip_tags( apply_filters( 'single_post_title', $post->post_title ) );
    }

    $prefix = '';
    if ( !empty($title) )
        $prefix = " $sep ";

     // Determines position of the separator
    if ( 'right' == $seplocation )
        $title = $title . $prefix;
    else
        $title = $prefix . $title;

    $title = apply_filters('wp_title', $title, $sep);

    // Send it out
    if ( $display )
        echo $title;
    else
        return $title;

}


function single_post_title($prefix = '', $display = true) {
    global $wpdb;
    $p = get_query_var('p');
    $name = get_query_var('name');

    if ( intval($p) || '' != $name ) {
        if ( !$p )
            $p = $wpdb->get_var($wpdb->prepare("SELECT ID FROM $wpdb->posts WHERE post_name = %s", $name));
        $post = & get_post($p);
        $title = $post->post_title;
        $title = apply_filters('single_post_title', $title);
        if ( $display )
            echo $prefix.strip_tags($title);
        else
            return strip_tags($title);
    }
}


function single_cat_title($prefix = '', $display = true ) {
    $cat = intval( get_query_var('cat') );
    if ( !empty($cat) && !(strtoupper($cat) == 'ALL') ) {
        $my_cat_name = apply_filters('single_cat_title', get_the_category_by_ID($cat));
        if ( !empty($my_cat_name) ) {
            if ( $display )
                echo $prefix.strip_tags($my_cat_name);
            else
                return strip_tags($my_cat_name);
        }
    } else if ( is_tag() ) {
        return single_tag_title($prefix, $display);
    }
}


function single_tag_title($prefix = '', $display = true ) {
    if ( !is_tag() )
        return;

    $tag_id = intval( get_query_var('tag_id') );

    if ( !empty($tag_id) ) {
        $my_tag = &get_term($tag_id, 'post_tag', OBJECT, 'display');
        if ( is_wp_error( $my_tag ) )
            return false;
        $my_tag_name = apply_filters('single_tag_title', $my_tag->name);
        if ( !empty($my_tag_name) ) {
            if ( $display )
                echo $prefix . $my_tag_name;
            else
                return $my_tag_name;
        }
    }
}


function single_month_title($prefix = '', $display = true ) {
    global $wp_locale;

    $m = get_query_var('m');
    $year = get_query_var('year');
    $monthnum = get_query_var('monthnum');

    if ( !empty($monthnum) && !empty($year) ) {
        $my_year = $year;
        $my_month = $wp_locale->get_month($monthnum);
    } elseif ( !empty($m) ) {
        $my_year = substr($m, 0, 4);
        $my_month = $wp_locale->get_month(substr($m, 4, 2));
    }

    if ( empty($my_month) )
        return false;

    $result = $prefix . $my_month . $prefix . $my_year;

    if ( !$display )
        return $result;
    echo $result;
}


/* link navigation hack by Orien http://icecode.com/ */
function get_archives_link($url, $text, $format = 'html', $before = '', $after = '') {
    $text = wptexturize($text);
    $title_text = attribute_escape($text);
    $url = clean_url($url);

    if ('link' == $format)
        return "\t<link rel='archives' title='$title_text' href='$url' />\n";
    elseif ('option' == $format)
        return "\t<option value='$url'>$before $text $after</option>\n";
    elseif ('html' == $format)
        return "\t<li>$before<a href='$url' title='$title_text'>$text</a>$after</li>\n";
    else // custom
        return "\t$before<a href='$url' title='$title_text'>$text</a>$after\n";
}


function wp_get_archives($args = '') {
    global $wpdb, $wp_locale;

    $defaults = array(
        'type' => 'monthly', 'limit' => '',
        'format' => 'html', 'before' => '',
        'after' => '', 'show_post_count' => false
    );

    $r = wp_parse_args( $args, $defaults );
    extract( $r, EXTR_SKIP );

    if ( '' == $type )
        $type = 'monthly';

    if ( '' != $limit ) {
        $limit = absint($limit);
        $limit = ' LIMIT '.$limit;
    }

    // this is what will separate dates on weekly archive links
    $archive_week_separator = '&#8211;';

    // over-ride general date format ? 0 = no: use the date format set in Options, 1 = yes: over-ride
    $archive_date_format_over_ride = 0;

    // options for daily archive (only if you over-ride the general date format)
    $archive_day_date_format = 'Y/m/d';

    // options for weekly archive (only if you over-ride the general date format)
    $archive_week_start_date_format = 'Y/m/d';
    $archive_week_end_date_format    = 'Y/m/d';

    if ( !$archive_date_format_over_ride ) {
        $archive_day_date_format = get_option('date_format');
        $archive_week_start_date_format = get_option('date_format');
        $archive_week_end_date_format = get_option('date_format');
    }

    //filters
    $where = apply_filters('getarchives_where', "WHERE post_type = 'post' AND post_status = 'publish'", $r );
    $join = apply_filters('getarchives_join', "", $r);

    if ( 'monthly' == $type ) {
        $query = "SELECT DISTINCT YEAR(post_date) AS `year`, MONTH(post_date) AS `month`, count(ID) as posts FROM $wpdb->posts $join $where GROUP BY YEAR(post_date), MONTH(post_date) ORDER BY post_date DESC $limit";
        $key = md5($query);
        $cache = wp_cache_get( 'wp_get_archives' , 'general');
        if ( !isset( $cache[ $key ] ) ) {
            $arcresults = $wpdb->get_results($query);
            $cache[ $key ] = $arcresults;
            wp_cache_add( 'wp_get_archives', $cache, 'general' );
        } else {
            $arcresults = $cache[ $key ];
        }
        if ( $arcresults ) {
            $afterafter = $after;
            foreach ( $arcresults as $arcresult ) {
                $url    = get_month_link($arcresult->year,    $arcresult->month);
                $text = sprintf(__('%1$s %2$d'), $wp_locale->get_month($arcresult->month), $arcresult->year);
                if ( $show_post_count )
                    $after = '&nbsp;('.$arcresult->posts.')' . $afterafter;
                echo get_archives_link($url, $text, $format, $before, $after);
            }
        }
    } elseif ('yearly' == $type) {
        $query = "SELECT DISTINCT YEAR(post_date) AS `year`, count(ID) as posts FROM $wpdb->posts $join $where GROUP BY YEAR(post_date) ORDER BY post_date DESC $limit";
        $key = md5($query);
        $cache = wp_cache_get( 'wp_get_archives' , 'general');
        if ( !isset( $cache[ $key ] ) ) {
            $arcresults = $wpdb->get_results($query);
            $cache[ $key ] = $arcresults;
            wp_cache_add( 'wp_get_archives', $cache, 'general' );
        } else {
            $arcresults = $cache[ $key ];
        }
        if ($arcresults) {
            $afterafter = $after;
            foreach ($arcresults as $arcresult) {
                $url = get_year_link($arcresult->year);
                $text = sprintf('%d', $arcresult->year);
                if ($show_post_count)
                    $after = '&nbsp;('.$arcresult->posts.')' . $afterafter;
                echo get_archives_link($url, $text, $format, $before, $after);
            }
        }
    } elseif ( 'daily' == $type ) {
        $query = "SELECT DISTINCT YEAR(post_date) AS `year`, MONTH(post_date) AS `month`, DAYOFMONTH(post_date) AS `dayofmonth`, count(ID) as posts FROM $wpdb->posts $join $where GROUP BY YEAR(post_date), MONTH(post_date), DAYOFMONTH(post_date) ORDER BY post_date DESC $limit";
        $key = md5($query);
        $cache = wp_cache_get( 'wp_get_archives' , 'general');
        if ( !isset( $cache[ $key ] ) ) {
            $arcresults = $wpdb->get_results($query);
            $cache[ $key ] = $arcresults;
            wp_cache_add( 'wp_get_archives', $cache, 'general' );
        } else {
            $arcresults = $cache[ $key ];
        }
        if ( $arcresults ) {
            $afterafter = $after;
            foreach ( $arcresults as $arcresult ) {
                $url    = get_day_link($arcresult->year, $arcresult->month, $arcresult->dayofmonth);
                $date = sprintf('%1$d-%2$02d-%3$02d 00:00:00', $arcresult->year, $arcresult->month, $arcresult->dayofmonth);
                $text = mysql2date($archive_day_date_format, $date);
                if ($show_post_count)
                    $after = '&nbsp;('.$arcresult->posts.')'.$afterafter;
                echo get_archives_link($url, $text, $format, $before, $after);
            }
        }
    } elseif ( 'weekly' == $type ) {
        $start_of_week = get_option('start_of_week');
        $query = "SELECT DISTINCT WEEK(post_date, $start_of_week) AS `week`, YEAR(post_date) AS yr, DATE_FORMAT(post_date, '%Y-%m-%d') AS yyyymmdd, count(ID) as posts FROM $wpdb->posts $join $where GROUP BY WEEK(post_date, $start_of_week), YEAR(post_date) ORDER BY post_date DESC $limit";
        $key