2004-01-27 09:58:01 +00:00
< ? php
2008-09-05 19:19:01 +00:00
/**
* General template tags that can go anywhere in a template .
*
* @ package WordPress
* @ subpackage Template
*/
2004-01-27 09:58:01 +00:00
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Load header template .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Includes the header template for a theme or if a name is specified then a specialised header will be included .
* If the theme contains no header . php file then the header from the default theme will be included .
2008-09-05 19:19:01 +00:00
*
* @ uses locate_template ()
* @ since 1.5 . 0
* @ uses do_action () Calls 'get_header' action .
2008-09-05 21:47:53 +00:00
* @ param $name String The name of the specialised header . If the file is called " header-special.php " then specify " special " .
2008-09-05 19:19:01 +00:00
*/
2008-08-19 20:57:48 +00:00
function get_header ( $name = null ) {
2006-10-11 03:39:13 +00:00
do_action ( 'get_header' );
2008-08-19 20:57:48 +00:00
$templates = array ();
if ( isset ( $name ) )
$templates [] = " header- { $name } .php " ;
$templates [] = " header.php " ;
if ( '' == locate_template ( $templates , true ))
2008-07-30 06:26:59 +00:00
load_template ( get_theme_root () . '/default/header.php' );
2004-12-30 10:58:06 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Load footer template .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Includes the footer template for a theme or if a name is specified then a specialised footer will be included .
* If the theme contains no footer . php file then the footer from the default theme will be included .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ uses locate_template ()
2008-09-05 19:19:01 +00:00
* @ since 1.5 . 0
2008-09-05 21:47:53 +00:00
* @ uses do_action () Calls 'get_footer' action .
* @ param $name String The name of the specialised footer . If the file is called " footer-special.php " then specify " special " .
2008-09-05 19:19:01 +00:00
*/
2008-08-19 20:57:48 +00:00
function get_footer ( $name = null ) {
2006-10-11 03:39:13 +00:00
do_action ( 'get_footer' );
2008-08-19 20:57:48 +00:00
$templates = array ();
if ( isset ( $name ) )
$templates [] = " footer- { $name } .php " ;
$templates [] = " footer.php " ;
if ( '' == locate_template ( $templates , true ))
2008-07-30 06:26:59 +00:00
load_template ( get_theme_root () . '/default/footer.php' );
2004-12-30 10:58:06 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Load sidebar template .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Includes the sidebar template for a theme or if a name is specified then a specialised sidebar will be included .
* If the theme contains no sidebar . php file then the sidebar from the default theme will be included .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ uses locate_template ()
2008-09-05 19:19:01 +00:00
* @ since 1.5 . 0
2008-09-05 21:47:53 +00:00
* @ uses do_action () Calls 'get_sidebar' action .
* @ param $name String The name of the specialised sidebar . If the file is called " sidebar-special.php " then specify " special " .
2008-09-05 19:19:01 +00:00
*/
2008-01-14 04:51:29 +00:00
function get_sidebar ( $name = null ) {
2007-03-29 01:45:29 +00:00
do_action ( 'get_sidebar' );
2008-08-19 20:57:48 +00:00
2008-08-12 20:18:05 +00:00
$templates = array ();
if ( isset ( $name ) )
$templates [] = " sidebar- { $name } .php " ;
2008-08-19 20:57:48 +00:00
2008-08-12 20:18:05 +00:00
$templates [] = " sidebar.php " ;
2008-08-19 20:57:48 +00:00
2008-08-12 20:18:05 +00:00
if ( '' == locate_template ( $templates , true ))
2008-07-30 06:26:59 +00:00
load_template ( get_theme_root () . '/default/sidebar.php' );
2004-12-30 10:58:06 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Echo the Log In / Out link
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Echos out a link which allows the user to navigate to the Login page to login or logout depending on whether or not they are currently logged in .
2008-09-05 19:19:01 +00:00
*
* @ since 1.5 . 0
* @ uses apply_filters ()
*/
2004-07-10 23:34:47 +00:00
function wp_loginout () {
2006-02-22 19:08:55 +00:00
if ( ! is_user_logged_in () )
2008-06-11 17:25:55 +00:00
$link = '<a href="' . site_url ( 'wp-login.php' , 'login' ) . '">' . __ ( 'Log in' ) . '</a>' ;
2005-10-17 23:41:28 +00:00
else
2008-06-11 17:25:55 +00:00
$link = '<a href="' . site_url ( 'wp-login.php?action=logout' , 'login' ) . '">' . __ ( 'Log out' ) . '</a>' ;
2004-07-10 23:34:47 +00:00
echo apply_filters ( 'loginout' , $link );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Echo the Registration or Admin link
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Echos out a link which allows the user to navigate to the registration page if not logged in and registration is enabled or to the dashboard if logged in .
*
2008-09-05 19:19:01 +00:00
* @ since 1.5 . 0
* @ uses apply_filters ()
*
2008-09-05 21:47:53 +00:00
* @ param String $before Text to output before the link ( defaults to < li > ) .
* @ param String $after Text to output after the link ( defaults to </ li > ) .
2008-09-05 19:19:01 +00:00
*/
2005-01-24 10:06:53 +00:00
function wp_register ( $before = '<li>' , $after = '</li>' ) {
2004-07-10 23:34:47 +00:00
2006-02-22 19:08:55 +00:00
if ( ! is_user_logged_in () ) {
2006-08-30 21:46:31 +00:00
if ( get_option ( 'users_can_register' ) )
2008-06-11 17:25:55 +00:00
$link = $before . '<a href="' . site_url ( 'wp-login.php?action=register' , 'login' ) . '">' . __ ( 'Register' ) . '</a>' . $after ;
2006-02-22 19:08:55 +00:00
else
$link = '' ;
} else {
2008-06-06 07:39:11 +00:00
$link = $before . '<a href="' . admin_url () . '">' . __ ( 'Site Admin' ) . '</a>' . $after ;
2006-02-22 19:08:55 +00:00
}
2004-07-10 23:34:47 +00:00
echo apply_filters ( 'register' , $link );
}
2008-09-05 19:19:01 +00:00
/**
* Theme container function for the 'wp_meta' action .
*
* The 'wp_meta' action can have several purposes , depending on how you use it ,
* but one purpose might have been to allow for theme switching .
*
* @ since 1.5 . 0
* @ link http :// trac . wordpress . org / ticket / 1458 Explaination of 'wp_meta' action .
* @ uses do_action () Calls 'wp_meta' hook .
*/
2004-07-10 23:34:47 +00:00
function wp_meta () {
2005-02-01 06:20:54 +00:00
do_action ( 'wp_meta' );
2004-07-10 23:34:47 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* bloginfo () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 0.71
*
* @ param unknown_type $show
*/
2004-01-27 09:58:01 +00:00
function bloginfo ( $show = '' ) {
2007-08-31 23:55:56 +00:00
echo get_bloginfo ( $show , 'display' );
2004-01-27 09:58:01 +00:00
}
2007-03-07 03:05:41 +00:00
/**
2008-09-05 19:19:01 +00:00
* get_bloginfo () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
2007-09-03 23:32:58 +00:00
* 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
2007-03-07 03:05:41 +00:00
* to get the information .
2008-09-05 19:19:01 +00:00
*
* @ since 0.71
*
* @ param unknown_type $show
* @ param unknown_type $filter
* @ return unknown
2007-03-07 03:05:41 +00:00
*/
2007-08-31 23:55:56 +00:00
function get_bloginfo ( $show = '' , $filter = 'raw' ) {
2004-02-05 20:55:50 +00:00
2004-09-30 17:56:16 +00:00
switch ( $show ) {
2005-10-17 23:41:28 +00:00
case 'url' :
2007-03-07 03:05:41 +00:00
case 'home' : // DEPRECATED
case 'siteurl' : // DEPRECATED
2006-08-30 21:46:31 +00:00
$output = get_option ( 'home' );
2005-10-17 23:41:28 +00:00
break ;
case 'wpurl' :
2006-08-30 21:46:31 +00:00
$output = get_option ( 'siteurl' );
2005-10-17 23:41:28 +00:00
break ;
case 'description' :
2006-08-30 21:46:31 +00:00
$output = get_option ( 'blogdescription' );
2005-10-17 23:41:28 +00:00
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 ;
2007-02-23 08:18:30 +00:00
case 'comments_atom_url' :
$output = get_feed_link ( 'comments_atom' );
2007-05-31 22:44:21 +00:00
break ;
2005-10-17 23:41:28 +00:00
case 'comments_rss2_url' :
$output = get_feed_link ( 'comments_rss2' );
break ;
case 'pingback_url' :
2006-08-30 21:46:31 +00:00
$output = get_option ( 'siteurl' ) . '/xmlrpc.php' ;
2005-10-17 23:41:28 +00:00
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' :
2006-08-30 21:46:31 +00:00
$output = get_option ( 'admin_email' );
2005-10-17 23:41:28 +00:00
break ;
case 'charset' :
2006-08-30 21:46:31 +00:00
$output = get_option ( 'blog_charset' );
2005-10-17 23:41:28 +00:00
if ( '' == $output ) $output = 'UTF-8' ;
break ;
case 'html_type' :
$output = get_option ( 'html_type' );
break ;
case 'version' :
global $wp_version ;
$output = $wp_version ;
break ;
2006-09-24 19:29:32 +00:00
case 'language' :
$output = get_locale ();
$output = str_replace ( '_' , '-' , $output );
break ;
case 'text_direction' :
global $wp_locale ;
$output = $wp_locale -> text_direction ;
break ;
2005-10-17 23:41:28 +00:00
case 'name' :
default :
2006-08-30 21:46:31 +00:00
$output = get_option ( 'blogname' );
2005-10-17 23:41:28 +00:00
break ;
2004-09-30 17:56:16 +00:00
}
2007-08-31 23:55:56 +00:00
$url = true ;
if ( strpos ( $show , 'url' ) === false &&
strpos ( $show , 'directory' ) === false &&
strpos ( $show , 'home' ) === false )
$url = false ;
2007-09-03 23:19:20 +00:00
2007-08-31 23:55:56 +00:00
if ( 'display' == $filter ) {
if ( $url )
$output = apply_filters ( 'bloginfo_url' , $output , $show );
else
$output = apply_filters ( 'bloginfo' , $output , $show );
}
2004-09-30 17:56:16 +00:00
return $output ;
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* wp_title () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 1.0 . 0
*
* @ param unknown_type $sep
* @ param unknown_type $display
* @ return unknown
*/
2008-01-02 20:45:17 +00:00
function wp_title ( $sep = '»' , $display = true , $seplocation = '' ) {
2007-03-09 04:06:23 +00:00
global $wpdb , $wp_locale , $wp_query ;
2005-10-17 23:41:28 +00:00
$cat = get_query_var ( 'cat' );
2007-05-23 03:57:20 +00:00
$tag = get_query_var ( 'tag_id' );
2005-10-17 23:41:28 +00:00
$category_name = get_query_var ( 'category_name' );
2005-11-11 00:48:31 +00:00
$author = get_query_var ( 'author' );
$author_name = get_query_var ( 'author_name' );
2007-03-09 04:06:23 +00:00
$m = get_query_var ( 'm' );
$year = get_query_var ( 'year' );
$monthnum = get_query_var ( 'monthnum' );
$day = get_query_var ( 'day' );
2006-10-03 15:41:44 +00:00
$title = '' ;
2005-10-17 23:41:28 +00:00
// If there's a category
if ( ! empty ( $cat ) ) {
// category exclusion
if ( ! stristr ( $cat , '-' ) )
2006-08-24 23:50:24 +00:00
$title = apply_filters ( 'single_cat_title' , get_the_category_by_ID ( $cat ));
2007-03-07 01:29:07 +00:00
} elseif ( ! empty ( $category_name ) ) {
2005-10-17 23:41:28 +00:00
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
}
2007-08-26 17:18:00 +00:00
$cat = get_term_by ( 'slug' , $category_name , 'category' , OBJECT , 'display' );
2007-05-27 19:32:45 +00:00
if ( $cat )
$title = apply_filters ( 'single_cat_title' , $cat -> name );
2005-10-17 23:41:28 +00:00
}
2007-05-23 03:57:20 +00:00
if ( ! empty ( $tag ) ) {
2007-08-26 17:18:00 +00:00
$tag = get_term ( $tag , 'post_tag' , OBJECT , 'display' );
2008-02-05 06:47:27 +00:00
if ( is_wp_error ( $tag ) )
2007-09-18 16:32:22 +00:00
return $tag ;
2007-05-23 03:57:20 +00:00
if ( ! empty ( $tag -> name ) )
2007-08-26 17:18:00 +00:00
$title = apply_filters ( 'single_tag_title' , $tag -> name );
2007-05-23 03:57:20 +00:00
}
2005-11-11 00:48:31 +00:00
// 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.
2007-10-02 18:45:47 +00:00
$title = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT display_name FROM $wpdb->users WHERE user_nicename = %s " , $author_name ));
2005-11-11 00:48:31 +00:00
}
2005-10-17 23:41:28 +00:00
// If there's a month
if ( ! empty ( $m ) ) {
$my_year = substr ( $m , 0 , 4 );
2007-03-29 02:06:16 +00:00
$my_month = $wp_locale -> get_month ( substr ( $m , 4 , 2 ));
2007-03-25 23:47:48 +00:00
$my_day = intval ( substr ( $m , 6 , 2 ));
$title = " $my_year " . ( $my_month ? " $sep $my_month " : " " ) . ( $my_day ? " $sep $my_day " : " " );
2005-10-17 23:41:28 +00:00
}
if ( ! empty ( $year ) ) {
$title = $year ;
if ( ! empty ( $monthnum ) )
2007-03-09 04:06:23 +00:00
$title .= " $sep " . $wp_locale -> get_month ( $monthnum );
2005-10-17 23:41:28 +00:00
if ( ! empty ( $day ) )
2007-03-09 04:06:23 +00:00
$title .= " $sep " . zeroise ( $day , 2 );
2005-10-17 23:41:28 +00:00
}
// If there is a post
if ( is_single () || is_page () ) {
2007-03-09 04:13:42 +00:00
$post = $wp_query -> get_queried_object ();
2007-06-01 22:54:46 +00:00
$title = strip_tags ( apply_filters ( 'single_post_title' , $post -> post_title ) );
2005-10-17 23:41:28 +00:00
}
2008-05-16 03:57:09 +00:00
// If there's a taxonomy
if ( is_tax () ) {
$taxonomy = get_query_var ( 'taxonomy' );
$tax = get_taxonomy ( $taxonomy );
$tax = $tax -> label ;
$term = $wp_query -> get_queried_object ();
$term = $term -> name ;
if ( 'right' == $seplocation )
$title = " $term $sep $tax " ;
else
$title = " $tax $sep $term " ;
}
2005-12-05 23:57:41 +00:00
$prefix = '' ;
2006-10-07 18:54:56 +00:00
if ( ! empty ( $title ) )
2005-12-05 23:57:41 +00:00
$prefix = " $sep " ;
2008-01-02 20:45:17 +00:00
// Determines position of the separator
if ( 'right' == $seplocation )
$title = $title . $prefix ;
else
$title = $prefix . $title ;
2008-02-05 06:47:27 +00:00
2008-07-23 16:44:06 +00:00
$title = apply_filters ( 'wp_title' , $title , $sep , $seplocation );
2005-12-05 23:57:41 +00:00
2005-10-17 23:41:28 +00:00
// Send it out
2005-12-05 23:57:41 +00:00
if ( $display )
echo $title ;
else
return $title ;
2008-01-02 20:45:17 +00:00
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* single_post_title () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 0.71
* @ uses $wpdb
*
* @ param unknown_type $prefix
* @ param unknown_type $display
* @ return unknown
*/
2004-01-27 09:58:01 +00:00
function single_post_title ( $prefix = '' , $display = true ) {
2005-10-17 23:41:28 +00:00
global $wpdb ;
$p = get_query_var ( 'p' );
$name = get_query_var ( 'name' );
if ( intval ( $p ) || '' != $name ) {
if ( ! $p )
2007-10-02 18:45:47 +00:00
$p = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT ID FROM $wpdb->posts WHERE post_name = %s " , $name ));
2005-10-17 23:41:28 +00:00
$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 );
}
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* single_cat_title () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 0.71
*
* @ param unknown_type $prefix
* @ param unknown_type $display
* @ return unknown
*/
2004-01-27 09:58:01 +00:00
function single_cat_title ( $prefix = '' , $display = true ) {
2005-05-27 06:10:41 +00:00
$cat = intval ( get_query_var ( 'cat' ) );
2005-10-17 23:41:28 +00:00
if ( ! empty ( $cat ) && ! ( strtoupper ( $cat ) == 'ALL' ) ) {
2006-08-24 23:50:24 +00:00
$my_cat_name = apply_filters ( 'single_cat_title' , get_the_category_by_ID ( $cat ));
2005-10-17 23:41:28 +00:00
if ( ! empty ( $my_cat_name ) ) {
if ( $display )
2005-05-27 06:10:41 +00:00
echo $prefix . strip_tags ( $my_cat_name );
else
return strip_tags ( $my_cat_name );
}
2007-09-11 18:06:52 +00:00
} else if ( is_tag () ) {
return single_tag_title ( $prefix , $display );
2005-05-27 06:10:41 +00:00
}
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* single_tag_title () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 2.3 . 0
*
* @ param unknown_type $prefix
* @ param unknown_type $display
* @ return unknown
*/
2007-08-21 18:39:45 +00:00
function single_tag_title ( $prefix = '' , $display = true ) {
2007-09-11 18:06:52 +00:00
if ( ! is_tag () )
return ;
2007-08-21 18:39:45 +00:00
$tag_id = intval ( get_query_var ( 'tag_id' ) );
2007-09-11 18:06:52 +00:00
2007-08-21 18:39:45 +00:00
if ( ! empty ( $tag_id ) ) {
2007-09-11 18:06:52 +00:00
$my_tag = & get_term ( $tag_id , 'post_tag' , OBJECT , 'display' );
2008-02-05 06:47:27 +00:00
if ( is_wp_error ( $my_tag ) )
2007-09-21 15:51:00 +00:00
return false ;
2007-08-21 18:39:45 +00:00
$my_tag_name = apply_filters ( 'single_tag_title' , $my_tag -> name );
if ( ! empty ( $my_tag_name ) ) {
if ( $display )
2007-09-11 18:06:52 +00:00
echo $prefix . $my_tag_name ;
2007-08-21 18:39:45 +00:00
else
2007-09-11 18:06:52 +00:00
return $my_tag_name ;
2007-08-21 18:39:45 +00:00
}
}
}
2008-09-05 19:19:01 +00:00
/**
* single_month_title () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 0.71
*
* @ param unknown_type $prefix
* @ param unknown_type $display
* @ return unknown
*/
2004-01-27 09:58:01 +00:00
function single_month_title ( $prefix = '' , $display = true ) {
2007-03-09 04:06:23 +00:00
global $wp_locale ;
$m = get_query_var ( 'm' );
$year = get_query_var ( 'year' );
$monthnum = get_query_var ( 'monthnum' );
2005-10-17 23:41:28 +00:00
if ( ! empty ( $monthnum ) && ! empty ( $year ) ) {
2004-10-18 23:45:26 +00:00
$my_year = $year ;
2006-04-02 00:20:11 +00:00
$my_month = $wp_locale -> get_month ( $monthnum );
2005-10-17 23:41:28 +00:00
} elseif ( ! empty ( $m ) ) {
2004-10-18 23:52:36 +00:00
$my_year = substr ( $m , 0 , 4 );
2006-10-05 03:12:24 +00:00
$my_month = $wp_locale -> get_month ( substr ( $m , 4 , 2 ));
2004-10-18 23:52:36 +00:00
}
2006-10-05 03:12:24 +00:00
if ( empty ( $my_month ) )
return false ;
$result = $prefix . $my_month . $prefix . $my_year ;
if ( ! $display )
return $result ;
echo $result ;
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* get_archives_link () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 1.0 . 0
* @ author Orien
* @ link http :// icecode . com / link navigation hack by Orien
*
* @ param unknown_type $url
* @ param unknown_type $text
* @ param unknown_type $format
* @ param unknown_type $before
* @ param unknown_type $after
* @ return unknown
*/
2004-07-06 17:04:07 +00:00
function get_archives_link ( $url , $text , $format = 'html' , $before = '' , $after = '' ) {
$text = wptexturize ( $text );
2006-12-21 10:10:04 +00:00
$title_text = attribute_escape ( $text );
2007-03-17 08:46:59 +00:00
$url = clean_url ( $url );
2004-07-28 23:09:33 +00:00
2005-10-17 23:41:28 +00:00
if ( 'link' == $format )
2008-05-20 16:43:44 +00:00
$link_html = " \t <link rel='archives' title=' $title_text ' href=' $url ' /> \n " ;
2005-10-17 23:41:28 +00:00
elseif ( 'option' == $format )
2008-05-20 16:43:44 +00:00
$link_html = " \t <option value=' $url '> $before $text $after </option> \n " ;
2005-10-17 23:41:28 +00:00
elseif ( 'html' == $format )
2008-05-20 16:43:44 +00:00
$link_html = " \t <li> $before <a href=' $url ' title=' $title_text '> $text </a> $after </li> \n " ;
2005-10-17 23:41:28 +00:00
else // custom
2008-05-20 16:43:44 +00:00
$link_html = " \t $before <a href=' $url ' title=' $title_text '> $text </a> $after\n " ;
$link_html = apply_filters ( " get_archives_link " , $link_html );
2008-08-09 05:36:14 +00:00
2008-05-20 16:43:44 +00:00
return $link_html ;
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* wp_get_archives () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 1.2 . 0
*
* @ param unknown_type $args
*/
2004-04-24 19:23:57 +00:00
function wp_get_archives ( $args = '' ) {
2007-05-11 04:01:54 +00:00
global $wpdb , $wp_locale ;
2007-06-14 02:25:30 +00:00
2007-05-11 03:10:05 +00:00
$defaults = array (
2007-09-03 23:32:58 +00:00
'type' => 'monthly' , 'limit' => '' ,
'format' => 'html' , 'before' => '' ,
2007-05-11 03:10:05 +00:00
'after' => '' , 'show_post_count' => false
);
2007-06-14 02:25:30 +00:00
2007-05-11 03:10:05 +00:00
$r = wp_parse_args ( $args , $defaults );
2007-06-14 22:45:40 +00:00
extract ( $r , EXTR_SKIP );
2005-10-17 23:41:28 +00:00
if ( '' == $type )
$type = 'monthly' ;
if ( '' != $limit ) {
2008-01-29 18:48:38 +00:00
$limit = absint ( $limit );
2005-10-17 23:41:28 +00:00
$limit = ' LIMIT ' . $limit ;
}
2006-06-15 20:28:47 +00:00
2005-10-17 23:41:28 +00:00
// this is what will separate dates on weekly archive links
$archive_week_separator = '–' ;
// 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 ) {
2006-08-30 21:46:31 +00:00
$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' );
2005-10-17 23:41:28 +00:00
}
2007-03-09 04:09:24 +00:00
//filters
$where = apply_filters ( 'getarchives_where' , " WHERE post_type = 'post' AND post_status = 'publish' " , $r );
$join = apply_filters ( 'getarchives_join' , " " , $r );
2005-10-17 23:41:28 +00:00
if ( 'monthly' == $type ) {
2007-10-30 06:03:11 +00:00
$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 ];
}
2005-10-17 23:41:28 +00:00
if ( $arcresults ) {
$afterafter = $after ;
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-17 23:41:28 +00:00
$url = get_month_link ( $arcresult -> year , $arcresult -> month );
2006-11-29 21:34:51 +00:00
$text = sprintf ( __ ( '%1$s %2$d' ), $wp_locale -> get_month ( $arcresult -> month ), $arcresult -> year );
2007-09-03 23:32:58 +00:00
if ( $show_post_count )
2005-10-17 23:41:28 +00:00
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
echo get_archives_link ( $url , $text , $format , $before , $after );
}
}
2006-08-30 17:23:42 +00:00
} elseif ( 'yearly' == $type ) {
2007-10-30 06:03:11 +00:00
$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 ];
}
2006-08-30 17:23:42 +00:00
if ( $arcresults ) {
2007-02-27 15:24:54 +00:00
$afterafter = $after ;
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $arcresults as $arcresult ) {
2007-02-27 15:24:54 +00:00
$url = get_year_link ( $arcresult -> year );
$text = sprintf ( '%d' , $arcresult -> year );
2006-09-07 17:38:43 +00:00
if ( $show_post_count )
2007-02-27 15:24:54 +00:00
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
echo get_archives_link ( $url , $text , $format , $before , $after );
}
}
2005-10-17 23:41:28 +00:00
} elseif ( 'daily' == $type ) {
2007-10-30 06:03:11 +00:00
$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 ];
}
2005-10-17 23:41:28 +00:00
if ( $arcresults ) {
2006-09-07 17:38:43 +00:00
$afterafter = $after ;
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-17 23:41:28 +00:00
$url = get_day_link ( $arcresult -> year , $arcresult -> month , $arcresult -> dayofmonth );
2006-12-10 00:23:10 +00:00
$date = sprintf ( '%1$d-%2$02d-%3$02d 00:00:00' , $arcresult -> year , $arcresult -> month , $arcresult -> dayofmonth );
2005-10-17 23:41:28 +00:00
$text = mysql2date ( $archive_day_date_format , $date );
2006-09-07 17:38:43 +00:00
if ( $show_post_count )
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
2005-10-17 23:41:28 +00:00
echo get_archives_link ( $url , $text , $format , $before , $after );
}
}
} elseif ( 'weekly' == $type ) {
2006-08-30 21:46:31 +00:00
$start_of_week = get_option ( 'start_of_week' );
2007-10-30 06:03:11 +00:00
$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 = 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 ];
}
2005-10-17 23:41:28 +00:00
$arc_w_last = '' ;
2006-09-07 17:38:43 +00:00
$afterafter = $after ;
2005-10-17 23:41:28 +00:00
if ( $arcresults ) {
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-17 23:41:28 +00:00
if ( $arcresult -> week != $arc_w_last ) {
$arc_year = $arcresult -> yr ;
$arc_w_last = $arcresult -> week ;
2006-08-30 21:46:31 +00:00
$arc_week = get_weekstartend ( $arcresult -> yyyymmdd , get_option ( 'start_of_week' ));
2005-10-17 23:41:28 +00:00
$arc_week_start = date_i18n ( $archive_week_start_date_format , $arc_week [ 'start' ]);
$arc_week_end = date_i18n ( $archive_week_end_date_format , $arc_week [ 'end' ]);
2006-12-10 00:23:10 +00:00
$url = sprintf ( '%1$s/%2$s%3$sm%4$s%5$s%6$sw%7$s%8$d' , get_option ( 'home' ), '' , '?' , '=' , $arc_year , '&' , '=' , $arcresult -> week );
2005-10-17 23:41:28 +00:00
$text = $arc_week_start . $archive_week_separator . $arc_week_end ;
2006-09-07 17:38:43 +00:00
if ( $show_post_count )
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
2005-10-17 23:41:28 +00:00
echo get_archives_link ( $url , $text , $format , $before , $after );
}
}
}
2006-02-19 02:07:13 +00:00
} elseif ( ( 'postbypost' == $type ) || ( 'alpha' == $type ) ) {
( 'alpha' == $type ) ? $orderby = " post_title ASC " : $orderby = " post_date DESC " ;
2007-10-30 06:03:11 +00:00
$query = " SELECT * FROM $wpdb->posts $join $where ORDER BY $orderby $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 ];
}
2005-10-17 23:41:28 +00:00
if ( $arcresults ) {
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-17 23:41:28 +00:00
if ( $arcresult -> post_date != '0000-00-00 00:00:00' ) {
$url = get_permalink ( $arcresult );
$arc_title = $arcresult -> post_title ;
if ( $arc_title )
2007-03-30 23:46:17 +00:00
$text = strip_tags ( apply_filters ( 'the_title' , $arc_title ));
2005-10-17 23:41:28 +00:00
else
$text = $arcresult -> ID ;
echo get_archives_link ( $url , $text , $format , $before , $after );
}
}
}
}
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* calendar_week_mod () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 1.5 . 0
* @ usedby get_calendar ()
*
* @ param unknown_type $num
* @ return unknown
*/
2004-09-09 23:07:46 +00:00
function calendar_week_mod ( $num ) {
$base = 7 ;
return ( $num - $base * floor ( $num / $base ));
}
2008-09-05 19:19:01 +00:00
/**
* get_calendar () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 1.0 . 0
*
* @ param unknown_type $initial
*/
2006-04-02 00:20:11 +00:00
function get_calendar ( $initial = true ) {
2007-12-06 19:49:33 +00:00
global $wpdb , $m , $monthnum , $year , $wp_locale , $posts ;
2005-10-17 23:41:28 +00:00
2006-11-23 17:56:53 +00:00
$key = md5 ( $m . $monthnum . $year );
if ( $cache = wp_cache_get ( 'get_calendar' , 'calendar' ) ) {
if ( isset ( $cache [ $key ] ) ) {
2006-11-23 18:31:27 +00:00
echo $cache [ $key ];
2006-11-23 17:56:53 +00:00
return ;
}
}
ob_start ();
2005-10-17 23:41:28 +00:00
// Quick check. If we have no posts at all, abort!
if ( ! $posts ) {
2006-02-09 10:03:48 +00:00
$gotsome = $wpdb -> get_var ( " SELECT ID from $wpdb->posts WHERE post_type = 'post' AND post_status = 'publish' ORDER BY post_date DESC LIMIT 1 " );
2005-10-17 23:41:28 +00:00
if ( ! $gotsome )
return ;
}
if ( isset ( $_GET [ 'w' ]) )
$w = '' . intval ( $_GET [ 'w' ]);
// week_begins = 0 stands for Sunday
2006-08-30 21:46:31 +00:00
$week_begins = intval ( get_option ( 'start_of_week' ));
2005-10-17 23:41:28 +00:00
// Let's figure out when we are
if ( ! empty ( $monthnum ) && ! empty ( $year ) ) {
$thismonth = '' . zeroise ( intval ( $monthnum ), 2 );
$thisyear = '' . intval ( $year );
} elseif ( ! empty ( $w ) ) {
// We need to get the month from MySQL
$thisyear = '' . intval ( substr ( $m , 0 , 4 ));
$d = (( $w - 1 ) * 7 ) + 6 ; //it seems MySQL's weeks disagree with PHP's
$thismonth = $wpdb -> get_var ( " SELECT DATE_FORMAT((DATE_ADD(' ${ thisyear } 0101', INTERVAL $d DAY) ), '%m') " );
} elseif ( ! empty ( $m ) ) {
$thisyear = '' . intval ( substr ( $m , 0 , 4 ));
if ( strlen ( $m ) < 6 )
$thismonth = '01' ;
else
$thismonth = '' . zeroise ( intval ( substr ( $m , 4 , 2 )), 2 );
} else {
2006-10-06 11:22:42 +00:00
$thisyear = gmdate ( 'Y' , current_time ( 'timestamp' ));
$thismonth = gmdate ( 'm' , current_time ( 'timestamp' ));
2005-10-17 23:41:28 +00:00
}
$unixmonth = mktime ( 0 , 0 , 0 , $thismonth , 1 , $thisyear );
// Get the next and previous month and year with at least one post
$previous = $wpdb -> get_row ( " SELECT DISTINCT MONTH(post_date) AS month, YEAR(post_date) AS year
FROM $wpdb -> posts
WHERE post_date < '$thisyear-$thismonth-01'
2006-02-09 10:03:48 +00:00
AND post_type = 'post' AND post_status = 'publish'
2005-10-17 23:41:28 +00:00
ORDER BY post_date DESC
LIMIT 1 " );
$next = $wpdb -> get_row ( " SELECT DISTINCT MONTH(post_date) AS month, YEAR(post_date) AS year
FROM $wpdb -> posts
WHERE post_date > '$thisyear-$thismonth-01'
AND MONTH ( post_date ) != MONTH ( '$thisyear-$thismonth-01' )
2006-11-24 22:55:28 +00:00
AND post_type = 'post' AND post_status = 'publish'
2005-10-17 23:41:28 +00:00
ORDER BY post_date ASC
LIMIT 1 " );
2007-02-23 01:05:59 +00:00
echo '<table id="wp-calendar" summary="' . __ ( 'Calendar' ) . ' " >
2008-01-01 18:38:32 +00:00
< caption > ' . sprintf(_c(' % 1 $s % 2 $s | Used as a calendar caption '), $wp_locale->get_month($thismonth), date(' Y ', $unixmonth)) . ' </ caption >
2005-10-17 23:41:28 +00:00
< thead >
< tr > ' ;
$myweek = array ();
for ( $wdcount = 0 ; $wdcount <= 6 ; $wdcount ++ ) {
2006-04-02 00:20:11 +00:00
$myweek [] = $wp_locale -> get_weekday (( $wdcount + $week_begins ) % 7 );
2005-10-17 23:41:28 +00:00
}
foreach ( $myweek as $wd ) {
2006-04-02 00:20:11 +00:00
$day_name = ( true == $initial ) ? $wp_locale -> get_weekday_initial ( $wd ) : $wp_locale -> get_weekday_abbrev ( $wd );
echo " \n \t \t <th abbr= \" $wd\ " scope = \ " col \" title= \" $wd\ " > $day_name </ th > " ;
2005-10-17 23:41:28 +00:00
}
echo '
</ tr >
</ thead >
< tfoot >
< tr > ' ;
if ( $previous ) {
2006-04-02 00:20:11 +00:00
echo " \n \t \t " . '<td abbr="' . $wp_locale -> get_month ( $previous -> month ) . '" colspan="3" id="prev"><a href="' .
get_month_link ( $previous -> year , $previous -> month ) . '" title="' . sprintf ( __ ( 'View posts for %1$s %2$s' ), $wp_locale -> get_month ( $previous -> month ),
date ( 'Y' , mktime ( 0 , 0 , 0 , $previous -> month , 1 , $previous -> year ))) . '">« ' . $wp_locale -> get_month_abbrev ( $wp_locale -> get_month ( $previous -> month )) . '</a></td>' ;
2005-10-17 23:41:28 +00:00
} else {
echo " \n \t \t " . '<td colspan="3" id="prev" class="pad"> </td>' ;
}
echo " \n \t \t " . '<td class="pad"> </td>' ;
if ( $next ) {
2006-04-02 00:20:11 +00:00
echo " \n \t \t " . '<td abbr="' . $wp_locale -> get_month ( $next -> month ) . '" colspan="3" id="next"><a href="' .
get_month_link ( $next -> year , $next -> month ) . '" title="' . sprintf ( __ ( 'View posts for %1$s %2$s' ), $wp_locale -> get_month ( $next -> month ),
date ( 'Y' , mktime ( 0 , 0 , 0 , $next -> month , 1 , $next -> year ))) . '">' . $wp_locale -> get_month_abbrev ( $wp_locale -> get_month ( $next -> month )) . ' »</a></td>' ;
2005-10-17 23:41:28 +00:00
} else {
echo " \n \t \t " . '<td colspan="3" id="next" class="pad"> </td>' ;
}
echo '
</ tr >
</ tfoot >
< tbody >
< tr > ' ;
// Get days with posts
$dayswithposts = $wpdb -> get_results ( " SELECT DISTINCT DAYOFMONTH(post_date)
2006-04-22 00:02:00 +00:00
FROM $wpdb -> posts WHERE MONTH ( post_date ) = '$thismonth'
AND YEAR ( post_date ) = '$thisyear'
2006-02-09 10:03:48 +00:00
AND post_type = 'post' AND post_status = 'publish'
2005-10-17 23:41:28 +00:00
AND post_date < '" . current_time(' mysql ') . ' \ '' , ARRAY_N );
if ( $dayswithposts ) {
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $dayswithposts as $daywith ) {
2005-10-17 23:41:28 +00:00
$daywithpost [] = $daywith [ 0 ];
}
} else {
$daywithpost = array ();
}
2007-03-07 05:29:15 +00:00
if ( strpos ( $_SERVER [ 'HTTP_USER_AGENT' ], 'MSIE' ) !== false || strpos ( strtolower ( $_SERVER [ 'HTTP_USER_AGENT' ]), 'camino' ) !== false || strpos ( strtolower ( $_SERVER [ 'HTTP_USER_AGENT' ]), 'safari' ) !== false )
2005-10-17 23:41:28 +00:00
$ak_title_separator = " \n " ;
else
$ak_title_separator = ', ' ;
$ak_titles_for_day = array ();
$ak_post_titles = $wpdb -> get_results ( " SELECT post_title, DAYOFMONTH(post_date) as dom "
. " FROM $wpdb->posts "
. " WHERE YEAR(post_date) = ' $thisyear ' "
. " AND MONTH(post_date) = ' $thismonth ' "
. " AND post_date < ' " . current_time ( 'mysql' ) . " ' "
2006-02-09 10:03:48 +00:00
. " AND post_type = 'post' AND post_status = 'publish' "
2005-10-17 23:41:28 +00:00
);
if ( $ak_post_titles ) {
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $ak_post_titles as $ak_post_title ) {
2007-06-14 02:25:30 +00:00
2007-03-10 03:56:35 +00:00
$post_title = apply_filters ( " the_title " , $ak_post_title -> post_title );
$post_title = str_replace ( '"' , '"' , wptexturize ( $post_title ));
2007-06-14 02:25:30 +00:00
2005-10-17 23:41:28 +00:00
if ( empty ( $ak_titles_for_day [ 'day_' . $ak_post_title -> dom ]) )
$ak_titles_for_day [ 'day_' . $ak_post_title -> dom ] = '' ;
if ( empty ( $ak_titles_for_day [ " $ak_post_title->dom " ]) ) // first one
2007-03-10 03:56:35 +00:00
$ak_titles_for_day [ " $ak_post_title->dom " ] = $post_title ;
2005-10-17 23:41:28 +00:00
else
2007-03-10 03:56:35 +00:00
$ak_titles_for_day [ " $ak_post_title->dom " ] .= $ak_title_separator . $post_title ;
2005-10-17 23:41:28 +00:00
}
}
// See how much we should pad in the beginning
$pad = calendar_week_mod ( date ( 'w' , $unixmonth ) - $week_begins );
if ( 0 != $pad )
echo " \n \t \t " . '<td colspan="' . $pad . '" class="pad"> </td>' ;
$daysinmonth = intval ( date ( 't' , $unixmonth ));
for ( $day = 1 ; $day <= $daysinmonth ; ++ $day ) {
if ( isset ( $newrow ) && $newrow )
echo " \n \t </tr> \n \t <tr> \n \t \t " ;
$newrow = false ;
2006-08-30 21:46:31 +00:00
if ( $day == gmdate ( 'j' , ( time () + ( get_option ( 'gmt_offset' ) * 3600 ))) && $thismonth == gmdate ( 'm' , time () + ( get_option ( 'gmt_offset' ) * 3600 )) && $thisyear == gmdate ( 'Y' , time () + ( get_option ( 'gmt_offset' ) * 3600 )) )
2005-10-17 23:41:28 +00:00
echo '<td id="today">' ;
else
echo '<td>' ;
if ( in_array ( $day , $daywithpost ) ) // any posts today?
echo '<a href="' . get_day_link ( $thisyear , $thismonth , $day ) . " \" title= \" $ak_titles_for_day[$day] \" > $day </a> " ;
else
echo $day ;
echo '</td>' ;
if ( 6 == calendar_week_mod ( date ( 'w' , mktime ( 0 , 0 , 0 , $thismonth , $day , $thisyear )) - $week_begins ) )
$newrow = true ;
}
$pad = 7 - calendar_week_mod ( date ( 'w' , mktime ( 0 , 0 , 0 , $thismonth , $day , $thisyear )) - $week_begins );
if ( $pad != 0 && $pad != 7 )
echo " \n \t \t " . '<td class="pad" colspan="' . $pad . '"> </td>' ;
echo " \n \t </tr> \n \t </tbody> \n \t </table> " ;
2006-11-23 17:56:53 +00:00
$output = ob_get_contents ();
ob_end_clean ();
echo $output ;
$cache [ $key ] = $output ;
2007-09-15 21:50:53 +00:00
wp_cache_set ( 'get_calendar' , $cache , 'calendar' );
2006-11-23 17:56:53 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Purge the cached results of get_calendar .
*
* @ see get_calendar
2008-09-05 19:19:01 +00:00
* @ since 2.1 . 0
*/
2006-11-23 17:56:53 +00:00
function delete_get_calendar_cache () {
wp_cache_delete ( 'get_calendar' , 'calendar' );
2004-01-27 09:58:01 +00:00
}
2006-11-23 17:56:53 +00:00
add_action ( 'save_post' , 'delete_get_calendar_cache' );
add_action ( 'delete_post' , 'delete_get_calendar_cache' );
add_action ( 'update_option_start_of_week' , 'delete_get_calendar_cache' );
add_action ( 'update_option_gmt_offset' , 'delete_get_calendar_cache' );
add_action ( 'update_option_start_of_week' , 'delete_get_calendar_cache' );
2004-01-27 09:58:01 +00:00
2008-09-05 19:19:01 +00:00
/**
* allowed_tags () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 1.0 . 1
* @ uses $allowedtags
*
* @ return unknown
*/
2004-01-27 09:58:01 +00:00
function allowed_tags () {
2005-10-17 23:41:28 +00:00
global $allowedtags ;
2004-05-07 23:56:33 +00:00
$allowed = '' ;
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $allowedtags as $tag => $attributes ) {
2005-10-17 23:41:28 +00:00
$allowed .= '<' . $tag ;
if ( 0 < count ( $attributes ) ) {
foreach ( $attributes as $attribute => $limits ) {
$allowed .= ' ' . $attribute . '=""' ;
}
}
$allowed .= '> ' ;
}
return htmlentities ( $allowed );
2004-01-27 09:58:01 +00:00
}
/***** Date/Time tags *****/
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the date in iso8601 format for xml files ,
2008-09-05 19:19:01 +00:00
*
* @ since 1.0 . 0
*/
2004-01-27 09:58:01 +00:00
function the_date_xml () {
2005-10-17 23:41:28 +00:00
global $post ;
echo mysql2date ( 'Y-m-d' , $post -> post_date );
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Echos or Returns the date the post was written .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Will only output the date if the current post ' s date is different from the previous one output .
2008-09-05 19:19:01 +00:00
*
* @ since 0.71
*
2008-09-05 21:47:53 +00:00
* @ param string $d php date format defaults to the date_format option if not specified .
* @ param string $before output before the date .
* @ param string $after output after the date .
* @ param bool $echo Whether to echo the date or return it .
2008-09-05 19:19:01 +00:00
* @ return unknown
*/
2004-01-27 09:58:01 +00:00
function the_date ( $d = '' , $before = '' , $after = '' , $echo = true ) {
2007-12-06 19:49:33 +00:00
global $post , $day , $previousday ;
2005-10-17 23:41:28 +00:00
$the_date = '' ;
if ( $day != $previousday ) {
$the_date .= $before ;
if ( $d == '' )
2006-08-30 21:46:31 +00:00
$the_date .= mysql2date ( get_option ( 'date_format' ), $post -> post_date );
2005-10-17 23:41:28 +00:00
else
$the_date .= mysql2date ( $d , $post -> post_date );
$the_date .= $after ;
$previousday = $day ;
}
$the_date = apply_filters ( 'the_date' , $the_date , $d , $before , $after );
if ( $echo )
echo $the_date ;
else
return $the_date ;
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the date on which the post was last modified .
2008-09-05 19:19:01 +00:00
*
* @ since 2.1 . 0
*
2008-09-05 21:47:53 +00:00
* @ param string $d php date format .
* @ return string
2008-09-05 19:19:01 +00:00
*/
2006-08-30 16:46:08 +00:00
function the_modified_date ( $d = '' ) {
echo apply_filters ( 'the_modified_date' , get_the_modified_date ( $d ), $d );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Returns the date on which the post was last modified .
2008-09-05 19:19:01 +00:00
*
* @ since 2.1 . 0
*
2008-09-05 21:47:53 +00:00
* @ param string $d php date format . Defaults to the " date_format " option
* @ return string
2008-09-05 19:19:01 +00:00
*/
2006-08-30 16:46:08 +00:00
function get_the_modified_date ( $d = '' ) {
if ( '' == $d )
2006-08-30 21:46:31 +00:00
$the_time = get_post_modified_time ( get_option ( 'date_format' ));
2006-08-30 16:46:08 +00:00
else
$the_time = get_post_modified_time ( $d );
return apply_filters ( 'get_the_modified_date' , $the_time , $d );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Output the time at which the post was written .
2008-09-05 19:19:01 +00:00
*
* @ since 0.71
*
2008-09-05 21:47:53 +00:00
* @ param string $d Either 'G' , 'U' , or php date format .
2008-09-05 19:19:01 +00:00
*/
2005-01-07 22:01:59 +00:00
function the_time ( $d = '' ) {
2005-02-06 03:40:08 +00:00
echo apply_filters ( 'the_time' , get_the_time ( $d ), $d );
2005-01-07 22:01:59 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Returns the time at which the post was written .
2008-09-05 19:19:01 +00:00
*
* @ since 1.5 . 0
*
2008-09-05 21:47:53 +00:00
* @ param string $d Either 'G' , 'U' , or php date format defaults to the value specified in the time_format option .
* @ return string
2008-09-05 19:19:01 +00:00
*/
2005-01-07 22:01:59 +00:00
function get_the_time ( $d = '' ) {
if ( '' == $d )
2006-08-30 21:46:31 +00:00
$the_time = get_post_time ( get_option ( 'time_format' ));
2005-01-07 22:01:59 +00:00
else
2005-01-19 02:21:36 +00:00
$the_time = get_post_time ( $d );
2005-02-06 03:40:08 +00:00
return apply_filters ( 'get_the_time' , $the_time , $d );
2005-01-07 22:01:59 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Returns the time at which the post was written
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ since 2.0 . 0
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ param string $d Either 'G' , 'U' , or php date format .
* @ param bool $gmt Whether of not to return the gmt time .
* @ return string
2008-09-05 19:19:01 +00:00
*/
2005-01-19 02:21:36 +00:00
function get_post_time ( $d = 'U' , $gmt = false ) { // returns timestamp
2005-01-07 22:01:59 +00:00
global $post ;
if ( $gmt )
2005-01-19 02:21:36 +00:00
$time = $post -> post_date_gmt ;
2005-01-07 22:01:59 +00:00
else
2005-01-19 02:21:36 +00:00
$time = $post -> post_date ;
$time = mysql2date ( $d , $time );
2008-04-08 17:33:42 +00:00
return apply_filters ( 'get_post_time' , $time , $d , $gmt );
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
* the_modified_time () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 2.0 . 0
*
* @ param unknown_type $d
*/
2005-11-10 23:31:30 +00:00
function the_modified_time ( $d = '' ) {
echo apply_filters ( 'the_modified_time' , get_the_modified_time ( $d ), $d );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Returns the time at which the post was last modified .
2008-09-05 19:19:01 +00:00
*
* @ since 2.0 . 0
*
2008-09-05 21:47:53 +00:00
* @ param string $d Either 'G' , 'U' , or php date format defaults to the value specified in the time_format option .
* @ return string
2008-09-05 19:19:01 +00:00
*/
2005-11-10 23:31:30 +00:00
function get_the_modified_time ( $d = '' ) {
if ( '' == $d )
2006-08-30 21:46:31 +00:00
$the_time = get_post_modified_time ( get_option ( 'time_format' ));
2005-11-10 23:31:30 +00:00
else
$the_time = get_post_modified_time ( $d );
return apply_filters ( 'get_the_modified_time' , $the_time , $d );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Returns the time at which the post was last modified .
2008-09-05 19:19:01 +00:00
*
* @ since 2.0 . 0
*
2008-09-05 21:47:53 +00:00
* @ param string $d Either 'G' , 'U' , or php date format .
* @ param bool $gmt Whether of not to return the gmt time .
* @ return string
2008-09-05 19:19:01 +00:00
*/
2005-11-10 23:31:30 +00:00
function get_post_modified_time ( $d = 'U' , $gmt = false ) { // returns timestamp
global $post ;
if ( $gmt )
$time = $post -> post_modified_gmt ;
else
$time = $post -> post_modified ;
$time = mysql2date ( $d , $time );
return apply_filters ( 'get_the_modified_time' , $time , $d , $gmt );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the weekday on which the post was written .
2008-09-05 19:19:01 +00:00
*
* @ since 0.71
* @ uses $wp_locale
* @ uses $post
*/
2004-01-27 09:58:01 +00:00
function the_weekday () {
2007-12-06 19:49:33 +00:00
global $wp_locale , $post ;
2006-04-02 00:20:11 +00:00
$the_weekday = $wp_locale -> get_weekday ( mysql2date ( 'w' , $post -> post_date ));
2005-10-17 23:41:28 +00:00
$the_weekday = apply_filters ( 'the_weekday' , $the_weekday );
echo $the_weekday ;
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the weekday on which the post was written .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Will only output the weekday if the current post ' s weekday is different from the previous one output .
2008-09-05 19:19:01 +00:00
*
* @ since 0.71
*
2008-09-05 21:47:53 +00:00
* @ param string $before output before the date .
* @ param string $after output after the date .
*/
2004-01-27 09:58:01 +00:00
function the_weekday_date ( $before = '' , $after = '' ) {
2007-12-06 19:49:33 +00:00
global $wp_locale , $post , $day , $previousweekday ;
2005-10-17 23:41:28 +00:00
$the_weekday_date = '' ;
if ( $day != $previousweekday ) {
$the_weekday_date .= $before ;
2006-04-02 00:20:11 +00:00
$the_weekday_date .= $wp_locale -> get_weekday ( mysql2date ( 'w' , $post -> post_date ));
2005-10-17 23:41:28 +00:00
$the_weekday_date .= $after ;
$previousweekday = $day ;
}
$the_weekday_date = apply_filters ( 'the_weekday_date' , $the_weekday_date , $before , $after );
echo $the_weekday_date ;
2004-01-27 09:58:01 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Fire the wp_head action
2008-09-05 19:19:01 +00:00
*
* @ since 1.2 . 0
* @ uses do_action ()
*/
2006-06-07 23:17:59 +00:00
function wp_head () {
do_action ( 'wp_head' );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Fire the wp_footer action
2008-09-05 19:19:01 +00:00
*
* @ since 1.5 . 1
* @ uses do_action ()
*/
2006-06-07 23:17:59 +00:00
function wp_footer () {
do_action ( 'wp_footer' );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the link to the Really Simple Discovery service endpoint .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ link http :// archipelago . phrasewise . com / rsd
2008-09-05 19:19:01 +00:00
* @ since 2.0 . 0
*/
2005-11-07 09:47:51 +00:00
function rsd_link () {
2008-01-02 18:21:19 +00:00
echo '<link rel="EditURI" type="application/rsd+xml" title="RSD" href="' . get_bloginfo ( 'wpurl' ) . " /xmlrpc.php?rsd \" /> \n " ;
2007-10-05 17:29:34 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the link to the Windows Live Writer manifest file .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ link http :// msdn . microsoft . com / en - us / library / bb463265 . aspx
2008-09-05 19:19:01 +00:00
* @ since 2.3 . 1
*/
2007-10-05 17:29:34 +00:00
function wlwmanifest_link () {
2008-01-02 18:21:19 +00:00
echo '<link rel="wlwmanifest" type="application/wlwmanifest+xml" href="'
. get_bloginfo ( 'wpurl' ) . '/wp-includes/wlwmanifest.xml" /> ' . " \n " ;
2005-11-07 09:47:51 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs a noindex meta tag if required by the blog configuration .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* If a blog is marked as not being public then the noindex meta tag will be ouput to tell web robots not to index the page content .
2008-09-05 19:19:01 +00:00
*
* @ since 2.1 . 0
*/
2006-02-18 07:40:43 +00:00
function noindex () {
// If the blog is not public, tell robots to go away.
2006-06-17 23:38:45 +00:00
if ( '0' == get_option ( 'blog_public' ) )
echo " <meta name='robots' content='noindex,nofollow' /> \n " ;
2006-02-18 07:40:43 +00:00
}
2006-06-07 23:17:59 +00:00
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Determine if TinyMCE is available .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Checks to see if the user has deleted the tinymce files to slim down there WordPress install .
2008-09-05 19:19:01 +00:00
*
* @ since 2.1 . 0
*
2008-09-05 21:47:53 +00:00
* @ return bool Whether of not TinyMCE exists .
2008-09-05 19:19:01 +00:00
*/
2006-10-24 03:57:19 +00:00
function rich_edit_exists () {
global $wp_rich_edit_exists ;
if ( ! isset ( $wp_rich_edit_exists ) )
$wp_rich_edit_exists = file_exists ( ABSPATH . WPINC . '/js/tinymce/tiny_mce.js' );
return $wp_rich_edit_exists ;
}
2006-09-22 22:24:50 +00:00
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Whether or not the user should have a WYSIWIG editor .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Checks that the user requires a WYSIWIG editor and that the editor is supported in the users browser .
2008-09-05 19:19:01 +00:00
*
* @ since 2.0 . 0
*
2008-09-05 21:47:53 +00:00
* @ return bool
2008-09-05 19:19:01 +00:00
*/
2006-10-24 03:57:19 +00:00
function user_can_richedit () {
2006-12-07 00:38:54 +00:00
global $wp_rich_edit , $pagenow ;
2007-06-14 02:25:30 +00:00
2007-05-10 01:31:12 +00:00
if ( ! isset ( $wp_rich_edit ) ) {
2007-09-03 23:32:58 +00:00
if ( get_user_option ( 'rich_editing' ) == 'true' &&
( ( preg_match ( '!AppleWebKit/(\d+)!' , $_SERVER [ 'HTTP_USER_AGENT' ], $match ) && intval ( $match [ 1 ]) >= 420 ) ||
2007-07-05 20:11:32 +00:00
! preg_match ( '!opera[ /][2-8]|konqueror|safari!i' , $_SERVER [ 'HTTP_USER_AGENT' ] ) )
&& 'comment.php' != $pagenow ) {
2007-05-10 01:31:12 +00:00
$wp_rich_edit = true ;
} else {
$wp_rich_edit = false ;
}
}
2006-09-22 22:24:50 +00:00
2006-10-24 03:57:19 +00:00
return apply_filters ( 'user_can_richedit' , $wp_rich_edit );
2006-09-22 22:24:50 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Find out which editor should be displayed by default
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Works out which of the two editors to display as the current editor for a user .
2008-09-05 19:19:01 +00:00
*
* @ since 2.5 . 0
*
* @ return string Either 'tinymce' , or 'html' , or 'test'
*/
2008-01-06 19:01:32 +00:00
function wp_default_editor () {
$r = user_can_richedit () ? 'tinymce' : 'html' ; // defaults
if ( $user = wp_get_current_user () ) { // look for cookie
2008-08-31 06:34:43 +00:00
$ed = get_user_setting ( 'editor' , 'tinymce' );
$r = ( in_array ( $ed , array ( 'tinymce' , 'html' , 'test' ) ) ) ? $ed : $r ;
2008-01-06 19:01:32 +00:00
}
return apply_filters ( 'wp_default_editor' , $r ); // filter
}
2008-09-05 19:19:01 +00:00
/**
* the_editor () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 2.1 . 0
*
* @ param unknown_type $content
* @ param unknown_type $id
* @ param unknown_type $prev_id
*/
2008-02-26 04:53:48 +00:00
function the_editor ( $content , $id = 'content' , $prev_id = 'title' , $media_buttons = true , $tab_index = 2 ) {
2006-08-30 21:46:31 +00:00
$rows = get_option ( 'default_post_edit_rows' );
2006-06-07 23:17:59 +00:00
if (( $rows < 3 ) || ( $rows > 100 ))
$rows = 12 ;
2008-02-18 17:11:12 +00:00
$rows = " rows=' $rows ' " ; ?>
< div id = " editor-toolbar " >
2008-08-24 14:19:05 +00:00
< ? php if ( user_can_richedit () ) {
2008-02-18 17:11:12 +00:00
$wp_default_editor = wp_default_editor (); ?>
< div class = " zerosize " >< input accesskey = " e " type = " button " onclick = " switchEditors.go('<?php echo $id ; ?>') " /></ div >
< ? php if ( 'tinymce' == $wp_default_editor ) {
add_filter ( 'the_editor_content' , 'wp_richedit_pre' ); ?>
< a id = " edButtonHTML " onclick = " switchEditors.go('<?php echo $id ; ?>'); " >< ? php _e ( 'HTML' ); ?> </a>
< a id = " edButtonPreview " class = " active " >< ? php _e ( 'Visual' ); ?> </a>
< ? php } elseif ( 'html' == $wp_default_editor ) {
add_filter ( 'the_editor_content' , 'wp_htmledit_pre' ); ?>
< a id = " edButtonHTML " class = " active " >< ? php _e ( 'HTML' ); ?> </a>
< a id = " edButtonPreview " onclick = " switchEditors.go('<?php echo $id ; ?>'); " >< ? php _e ( 'Visual' ); ?> </a>
< ? php }
2008-08-24 14:19:05 +00:00
}
2008-03-02 20:17:30 +00:00
2008-08-20 21:42:31 +00:00
/* if ( $media_buttons ) { ?>
2008-03-26 20:06:18 +00:00
< div id = " media-buttons " class = " hide-if-no-js " >
2008-02-22 05:53:47 +00:00
< ? php do_action ( 'media_buttons' ); ?>
2008-02-18 17:11:12 +00:00
</ div >
2008-08-20 21:42:31 +00:00
< ? php } */ ?>
2006-09-22 07:04:41 +00:00
</ div >
2008-01-06 19:01:32 +00:00
2006-09-22 07:04:41 +00:00
< div id = " quicktags " >
< ? php wp_print_scripts ( 'quicktags' ); ?>
< script type = " text/javascript " > edToolbar () </ script >
</ div >
2008-01-06 19:01:32 +00:00
2008-08-24 06:56:22 +00:00
< ? php $the_editor = apply_filters ( 'the_editor' , " <div id='editorcontainer'><textarea $rows cols='40' name=' $id ' tabindex=' $tab_index ' id=' $id '>%s</textarea></div> \n " );
2006-06-07 23:17:59 +00:00
$the_editor_content = apply_filters ( 'the_editor_content' , $content );
printf ( $the_editor , $the_editor_content );
?>
2008-08-24 06:56:22 +00:00
< script type = " text/javascript " >
// <![CDATA[
edCanvas = document . getElementById ( '<?php echo $id; ?>' );
< ? php if ( user_can_richedit () && $prev_id ) { ?>
// If tinyMCE is defined.
if ( typeof tinyMCE != 'undefined' ) {
// This code is meant to allow tabbing from Title to Post (TinyMCE).
document . getElementById ( '<?php echo $prev_id; ?>' ) . onkeydown = function ( e ) {
e = e || window . event ;
if ( e . keyCode == 9 && ! e . shiftKey && ! e . controlKey && ! e . altKey ) {
if ( tinyMCE . activeEditor ) {
if ( ( jQuery ( " #post_ID " ) . val () < 1 ) && ( jQuery ( " #title " ) . val () . length > 0 ) ) { autosave (); }
e = null ;
if ( tinyMCE . activeEditor . isHidden () ) return true ;
tinyMCE . activeEditor . focus ();
return false ;
}
return true ;
}
}
}
< ? php } ?>
// ]]>
</ script >
< ? php
2006-06-07 23:17:59 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Returns the contents of the search query variable 's'
2008-09-05 19:19:01 +00:00
*
* @ since 2.3 . 0
*
2008-09-05 21:47:53 +00:00
* @ return string
2008-09-05 19:19:01 +00:00
*/
2007-05-24 03:37:10 +00:00
function get_search_query () {
return apply_filters ( 'get_search_query' , stripslashes ( get_query_var ( 's' ) ) );
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the contents of the search query variable 's'
*
* The search query string is paseed through attribute_escape to ensure that it is safe for placing in an html attribute
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ uses attribute_escape
2008-09-05 19:19:01 +00:00
* @ since 2.1 . 0
*
*/
2006-09-07 17:37:26 +00:00
function the_search_query () {
2007-05-24 03:37:10 +00:00
echo attribute_escape ( apply_filters ( 'the_search_query' , get_search_query () ) );
2006-09-07 17:37:26 +00:00
}
2008-09-05 19:19:01 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the language attributes for the html tag .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Builds up a set of html attributes containing the text direction and language information for the page .
2008-09-05 19:19:01 +00:00
*
* @ since 2.1 . 0
*
2008-09-05 21:47:53 +00:00
* @ param string $doctype The type of html document ( xhtml | html ) .
2008-09-05 19:19:01 +00:00
*/
2007-12-19 17:44:02 +00:00
function language_attributes ( $doctype = 'html' ) {
$attributes = array ();
2006-09-24 20:16:13 +00:00
$output = '' ;
2008-02-05 06:47:27 +00:00
2006-09-24 20:16:13 +00:00
if ( $dir = get_bloginfo ( 'text_direction' ) )
2007-12-19 17:44:02 +00:00
$attributes [] = " dir= \" $dir\ " " ;
2008-02-05 06:47:27 +00:00
2006-09-24 20:16:13 +00:00
if ( $lang = get_bloginfo ( 'language' ) ) {
2007-12-19 17:44:02 +00:00
if ( get_option ( 'html_type' ) == 'text/html' || $doctype == 'xhtml' )
$attributes [] = " lang= \" $lang\ " " ;
2008-02-05 06:47:27 +00:00
2007-12-19 17:44:02 +00:00
if ( get_option ( 'html_type' ) != 'text/html' || $doctype == 'xhtml' )
$attributes [] = " xml:lang= \" $lang\ " " ;
}
2008-02-05 06:47:27 +00:00
2007-12-19 17:44:02 +00:00
$output = implode ( ' ' , $attributes );
$output = apply_filters ( 'language_attributes' , $output );
2006-09-24 20:16:13 +00:00
echo $output ;
}
2006-10-03 07:16:49 +00:00
2008-09-05 19:19:01 +00:00
/**
* paginate_links () - { @ internal Missing Short Description }}
*
* { @ internal Missing Long Description }}
*
* @ since 2.1 . 0
*
* @ param unknown_type $args
* @ return unknown
*/
2007-06-14 22:46:59 +00:00
function paginate_links ( $args = '' ) {
2007-09-03 23:32:58 +00:00
$defaults = array (
2007-06-14 22:46:59 +00:00
'base' => '%_%' , // http://example.com/all_posts.php%_% : %_% is replaced by format (below)
'format' => '?page=%#%' , // ?page=%#% : %#% is replaced by the page number
'total' => 1 ,
'current' => 0 ,
'show_all' => false ,
'prev_next' => true ,
'prev_text' => __ ( '« Previous' ),
'next_text' => __ ( 'Next »' ),
'end_size' => 1 , // How many numbers on either end including the end
'mid_size' => 2 , // How many numbers to either side of current not including current
'type' => 'plain' ,
'add_args' => false // array of query args to aadd
);
$args = wp_parse_args ( $args , $defaults );
extract ( $args , EXTR_SKIP );
2006-10-03 07:16:49 +00:00
// Who knows what else people pass in $args
2008-08-06 20:31:54 +00:00
$total = ( int ) $total ;
2006-10-03 15:40:26 +00:00
if ( $total < 2 )
return ;
2006-10-03 07:16:49 +00:00
$current = ( int ) $current ;
$end_size = 0 < ( int ) $end_size ? ( int ) $end_size : 1 ; // Out of bounds? Make it the default.
$mid_size = 0 <= ( int ) $mid_size ? ( int ) $mid_size : 2 ;
$add_args = is_array ( $add_args ) ? $add_args : false ;
$r = '' ;
$page_links = array ();
$n = 0 ;
$dots = false ;
if ( $prev_next && $current && 1 < $current ) :
2006-10-03 15:40:26 +00:00
$link = str_replace ( '%_%' , 2 == $current ? '' : $format , $base );
$link = str_replace ( '%#%' , $current - 1 , $link );
2006-10-03 07:16:49 +00:00
if ( $add_args )
$link = add_query_arg ( $add_args , $link );
2007-03-17 08:46:59 +00:00
$page_links [] = " <a class='prev page-numbers' href=' " . clean_url ( $link ) . " '> $prev_text </a> " ;
2006-10-03 07:16:49 +00:00
endif ;
for ( $n = 1 ; $n <= $total ; $n ++ ) :
if ( $n == $current ) :
$page_links [] = " <span class='page-numbers current'> $n </span> " ;
$dots = true ;
else :
if ( $show_all || ( $n <= $end_size || ( $current && $n >= $current - $mid_size && $n <= $current + $mid_size ) || $n > $total - $end_size ) ) :
2006-10-03 15:40:26 +00:00
$link = str_replace ( '%_%' , 1 == $n ? '' : $format , $base );
$link = str_replace ( '%#%' , $n , $link );
2006-10-03 07:16:49 +00:00
if ( $add_args )
$link = add_query_arg ( $add_args , $link );
2007-03-17 08:46:59 +00:00
$page_links [] = " <a class='page-numbers' href=' " . clean_url ( $link ) . " '> $n </a> " ;
2006-10-03 07:16:49 +00:00
$dots = true ;
elseif ( $dots && ! $show_all ) :
$page_links [] = " <span class='page-numbers dots'>...</span> " ;
$dots = false ;
endif ;
endif ;
endfor ;
if ( $prev_next && $current && ( $current < $total || - 1 == $total ) ) :
2006-10-03 15:40:26 +00:00
$link = str_replace ( '%_%' , $format , $base );
$link = str_replace ( '%#%' , $current + 1 , $link );
2006-10-03 07:16:49 +00:00
if ( $add_args )
$link = add_query_arg ( $add_args , $link );
2007-03-17 08:46:59 +00:00
$page_links [] = " <a class='next page-numbers' href=' " . clean_url ( $link ) . " '> $next_text </a> " ;
2006-10-03 07:16:49 +00:00
endif ;
switch ( $type ) :
case 'array' :
return $page_links ;
break ;
case 'list' :
$r .= " <ul class='page-numbers'> \n \t <li> " ;
$r .= join ( " </li> \n \t <li> " , $page_links );
$r .= " </li> \n </ul> \n " ;
break ;
default :
$r = join ( " \n " , $page_links );
break ;
endswitch ;
return $r ;
}
2007-08-28 23:23:38 +00:00
2008-09-05 21:47:53 +00:00
/**
* Registers a admin colour scheme css file .
*
* Allows a plugin to register a new admin colour scheme .
* For Example :
* < code >
* wp_admin_css_color ( 'classic' , __ ( 'Classic' ), admin_url ( " css/colors-classic.css " ), array ( '#07273E' , '#14568A' , '#D54E21' , '#2683AE' ));
* </ code >
*
* @ param string $key The unique key for this theme .
* @ param string $name The name of the theme .
* @ param string $url The url of the css file containing the colour scheme .
* @ param array @ colors An array of CSS color definitions which are used to give the user a feel for the theme .
*
* @ since 2.5 . 0
*/
2008-03-11 21:06:03 +00:00
function wp_admin_css_color ( $key , $name , $url , $colors = array ()) {
global $_wp_admin_css_colors ;
if ( ! isset ( $_wp_admin_css_colors ) )
$_wp_admin_css_colors = array ();
$_wp_admin_css_colors [ $key ] = ( object ) array ( 'name' => $name , 'url' => $url , 'colors' => $colors );
}
2008-05-25 21:23:22 +00:00
/**
2008-09-05 21:47:53 +00:00
* Outputs the URL of a WordPress admin CSS file
2008-05-25 21:23:22 +00:00
*
* @ see WP_Styles :: _css_href and its style_loader_src filter .
*
2008-09-05 19:19:01 +00:00
* @ since 2.3 . 0
*
2008-05-25 21:23:22 +00:00
* @ param string $file file relative to wp - admin / without its " .css " extension .
*/
2007-08-28 23:23:38 +00:00
function wp_admin_css_uri ( $file = 'wp-admin' ) {
2008-03-11 21:06:03 +00:00
if ( defined ( 'WP_INSTALLING' ) ) {
$_file = " ./ $file .css " ;
2007-09-03 20:20:18 +00:00
} else {
2008-05-27 17:46:01 +00:00
$_file = admin_url ( " $file .css " );
2007-09-03 23:32:58 +00:00
}
2008-03-11 21:06:03 +00:00
$_file = add_query_arg ( 'version' , get_bloginfo ( 'version' ), $_file );
2007-08-28 23:23:38 +00:00
return apply_filters ( 'wp_admin_css_uri' , $_file , $file );
}
2008-05-25 21:23:22 +00:00
/**
2008-09-05 21:47:53 +00:00
* Enqueues or directly prints a stylesheet link to the specified CSS file .
2008-05-25 21:23:22 +00:00
*
* " Intelligently " decides to enqueue or to print the CSS file .
* If the wp_print_styles action has * not * yet been called , the CSS file will be enqueued .
* If the wp_print_styles action * has * been called , the CSS link will be printed .
* Printing may be forced by passing TRUE as the $force_echo ( second ) parameter .
*
* For backward compatibility with WordPress 2.3 calling method :
* If the $file ( first ) parameter does not correspond to a registered CSS file , we assume $file is a
* file relative to wp - admin / without its " .css " extension . A stylesheet link to that generated URL is printed .
*
* @ package WordPress
* @ since 2.3
*
* @ uses $wp_styles WordPress Styles Object
*
* @ param string $file Style handle name or file name ( without " .css " extension ) relative to wp - admin /
* @ param bool $force_echo Optional . Force the stylesheet link to be printed rather than enqueued .
*/
2008-05-22 00:06:41 +00:00
function wp_admin_css ( $file = 'wp-admin' , $force_echo = false ) {
2008-05-21 23:24:23 +00:00
global $wp_styles ;
if ( ! is_a ( $wp_styles , 'WP_Styles' ) )
$wp_styles = new WP_Styles ();
2008-05-25 21:23:22 +00:00
// For backward compatibility
2008-05-21 23:24:23 +00:00
$handle = 0 === strpos ( $file , 'css/' ) ? substr ( $file , 4 ) : $file ;
2008-03-11 21:06:03 +00:00
2008-05-21 23:24:23 +00:00
if ( $wp_styles -> query ( $handle ) ) {
2008-05-22 00:06:41 +00:00
if ( $force_echo || did_action ( 'wp_print_styles' ) ) // we already printed the style queue. Print this one immediately
2008-05-21 23:24:23 +00:00
wp_print_styles ( $handle );
else // Add to style queue
wp_enqueue_style ( $handle );
return ;
2007-08-28 23:23:38 +00:00
}
2008-05-21 23:24:23 +00:00
echo apply_filters ( 'wp_admin_css' , " <link rel='stylesheet' href=' " . clean_url ( wp_admin_css_uri ( $file ) ) . " ' type='text/css' /> \n " , $file );
if ( 'rtl' == get_bloginfo ( 'text_direction' ) )
echo apply_filters ( 'wp_admin_css' , " <link rel='stylesheet' href=' " . clean_url ( wp_admin_css_uri ( " $file -rtl " ) ) . " ' type='text/css' /> \n " , " $file -rtl " );
2007-08-28 23:23:38 +00:00
}
2008-05-22 15:27:28 +00:00
/**
2008-09-05 19:19:01 +00:00
* Enqueues the default ThickBox js and css .
2008-09-05 21:47:53 +00:00
*
2008-05-22 15:27:28 +00:00
* If any of the settings need to be changed , this can be done with another js file
* similar to media - upload . js and theme - preview . js . That file should require array ( 'thickbox' )
2008-08-09 05:36:14 +00:00
* to ensure it is loaded after .
2008-09-05 21:47:53 +00:00
*
* @ since 0.0
2008-05-22 15:27:28 +00:00
*/
2008-05-20 17:19:33 +00:00
function add_thickbox () {
wp_enqueue_script ( 'thickbox' );
2008-05-22 15:27:28 +00:00
wp_enqueue_style ( 'thickbox' );
2008-05-20 17:19:33 +00:00
}
2007-10-06 06:55:24 +00:00
/**
* Outputs the XHTML generator that is generated on the wp_head hook .
2008-09-05 21:47:53 +00:00
*
* @ since 2.5
2007-10-06 06:55:24 +00:00
*/
2008-09-05 19:19:01 +00:00
function wp_generator () {
2007-10-06 06:55:24 +00:00
the_generator ( apply_filters ( 'wp_generator_type' , 'xhtml' ) );
}
/**
2008-09-05 21:47:53 +00:00
* Outputs the generator XML or Comment for RSS , ATOM , etc .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Returns the correct generator type for the requested output format .
*
* Allows for a plugin to filter generators overall the the_generator filter .
2008-09-05 19:19:01 +00:00
*
* @ since 2.5
2008-09-05 21:47:53 +00:00
* @ uses apply_filters () the_generator
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ param string $type The type of generator to output - ( html | xhtml | atom | rss2 | rdf | comment | export ) .
2007-10-06 06:55:24 +00:00
*/
2008-09-05 19:19:01 +00:00
function the_generator ( $type ) {
echo apply_filters ( 'the_generator' , get_the_generator ( $type ), $type ) . " \n " ;
2007-10-06 06:55:24 +00:00
}
/**
2008-09-05 21:47:53 +00:00
* Creates the generator XML or Comment for RSS , ATOM , etc .
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* Returns the correct generator type for the requested output format .
*
* Allows for a plugin to filter generators on an individual basis using the get_the_generator_ { $type } filter .
2008-09-05 19:19:01 +00:00
*
* @ since 2.5
2008-09-05 21:47:53 +00:00
* @ uses apply_filters () get_the_generator_ { $type }
2008-09-05 19:19:01 +00:00
*
2008-09-05 21:47:53 +00:00
* @ param string $type The type of generator to return - ( html | xhtml | atom | rss2 | rdf | comment | export ) .
2007-10-06 06:55:24 +00:00
*/
2008-09-05 19:19:01 +00:00
function get_the_generator ( $type ) {
2007-10-06 06:55:24 +00:00
switch ( $type ) {
case 'html' :
2008-03-28 19:05:22 +00:00
$gen = '<meta name="generator" content="WordPress ' . get_bloginfo ( 'version' ) . '">' . " \n " ;
2007-10-06 06:55:24 +00:00
break ;
case 'xhtml' :
2008-03-28 19:05:22 +00:00
$gen = '<meta name="generator" content="WordPress ' . get_bloginfo ( 'version' ) . '" />' . " \n " ;
2007-10-06 06:55:24 +00:00
break ;
case 'atom' :
$gen = '<generator uri="http://wordpress.org/" version="' . get_bloginfo_rss ( 'version' ) . '">WordPress</generator>' ;
break ;
case 'rss2' :
$gen = '<generator>http://wordpress.org/?v=' . get_bloginfo_rss ( 'version' ) . '</generator>' ;
break ;
case 'rdf' :
$gen = '<admin:generatorAgent rdf:resource="http://wordpress.org/?v=' . get_bloginfo_rss ( 'version' ) . '" />' ;
break ;
case 'comment' :
$gen = '<!-- generator="WordPress/' . get_bloginfo ( 'version' ) . '" -->' ;
break ;
case 'export' :
2008-03-28 19:05:22 +00:00
$gen = '<!-- generator="WordPress/' . get_bloginfo_rss ( 'version' ) . '" created="' . date ( 'Y-m-d H:i' ) . '"-->' ;
2007-10-06 06:55:24 +00:00
break ;
}
return apply_filters ( " get_the_generator_ { $type } " , $gen , $type );
}
2008-09-05 19:19:01 +00:00
2005-11-11 00:48:31 +00:00
?>