2004-01-27 10:58:01 +01:00
< ? php
2008-09-05 21:19:01 +02:00
/**
* General template tags that can go anywhere in a template .
*
* @ package WordPress
* @ subpackage Template
*/
2004-01-27 10:58:01 +01:00
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Load header template .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02: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 .
*
* For the parameter , if the file is called " header-special.php " then specify
* " special " .
2008-09-05 21:19:01 +02:00
*
* @ uses locate_template ()
* @ since 1.5 . 0
* @ uses do_action () Calls 'get_header' action .
2008-09-06 08:38:26 +02:00
*
* @ param string $name The name of the specialised header .
2008-09-05 21:19:01 +02:00
*/
2008-08-19 22:57:48 +02:00
function get_header ( $name = null ) {
2006-10-11 05:39:13 +02:00
do_action ( 'get_header' );
2008-08-19 22:57:48 +02:00
$templates = array ();
if ( isset ( $name ) )
$templates [] = " header- { $name } .php " ;
$templates [] = " header.php " ;
if ( '' == locate_template ( $templates , true ))
2008-07-30 08:26:59 +02:00
load_template ( get_theme_root () . '/default/header.php' );
2004-12-30 11:58:06 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Load footer template .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02: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 .
*
* For the parameter , if the file is called " footer-special.php " then specify
* " special " .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ uses locate_template ()
2008-09-05 21:19:01 +02:00
* @ since 1.5 . 0
2008-09-05 23:47:53 +02:00
* @ uses do_action () Calls 'get_footer' action .
2008-09-06 08:38:26 +02:00
*
* @ param string $name The name of the specialised footer .
2008-09-05 21:19:01 +02:00
*/
2008-08-19 22:57:48 +02:00
function get_footer ( $name = null ) {
2006-10-11 05:39:13 +02:00
do_action ( 'get_footer' );
2008-08-19 22:57:48 +02:00
$templates = array ();
if ( isset ( $name ) )
$templates [] = " footer- { $name } .php " ;
$templates [] = " footer.php " ;
if ( '' == locate_template ( $templates , true ))
2008-07-30 08:26:59 +02:00
load_template ( get_theme_root () . '/default/footer.php' );
2004-12-30 11:58:06 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Load sidebar template .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02: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 .
*
* For the parameter , if the file is called " sidebar-special.php " then specify
* " special " .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ uses locate_template ()
2008-09-05 21:19:01 +02:00
* @ since 1.5 . 0
2008-09-05 23:47:53 +02:00
* @ uses do_action () Calls 'get_sidebar' action .
2008-09-06 08:38:26 +02:00
*
* @ param string $name The name of the specialised sidebar .
2008-09-05 21:19:01 +02:00
*/
2008-01-14 05:51:29 +01:00
function get_sidebar ( $name = null ) {
2007-03-29 03:45:29 +02:00
do_action ( 'get_sidebar' );
2008-08-19 22:57:48 +02:00
2008-08-12 22:18:05 +02:00
$templates = array ();
if ( isset ( $name ) )
$templates [] = " sidebar- { $name } .php " ;
2008-08-19 22:57:48 +02:00
2008-08-12 22:18:05 +02:00
$templates [] = " sidebar.php " ;
2008-08-19 22:57:48 +02:00
2008-08-12 22:18:05 +02:00
if ( '' == locate_template ( $templates , true ))
2008-07-30 08:26:59 +02:00
load_template ( get_theme_root () . '/default/sidebar.php' );
2004-12-30 11:58:06 +01:00
}
2008-10-18 22:46:30 +02:00
/**
* Display search form .
*
* Will first attempt to locate the searchform . php file in either the child or
* the parent , then load it . If it doesn ' t exist , then the default search form
2009-01-22 22:17:52 +01:00
* will be displayed . The default search form is HTML , which will be displayed .
* There is a filter applied to the search form HTML in order to edit or replace
* it . The filter is 'get_search_form' .
*
* This function is primarily used by themes which want to hardcode the search
* form into the sidebar and also by the search widget in WordPress .
*
* There is also an action that is called whenever the function is run called ,
* 'get_search_form' . This can be useful for outputting JavaScript that the
* search relies on or various formatting that applies to the beginning of the
* search . To give a few examples of what it can be used for .
2008-10-18 22:46:30 +02:00
*
* @ since 2.7 . 0
*/
2008-10-17 22:39:56 +02:00
function get_search_form () {
do_action ( 'get_search_form' );
if ( '' != locate_template ( array ( 'searchform.php' ), true ) )
return ;
2008-12-07 06:09:47 +01:00
$form = '<form method="get" id="searchform" action="' . get_option ( 'home' ) . ' / " >
2009-01-14 03:40:04 +01:00
< div >< label class = " hidden " for = " s " > ' . __(' Search for : ') . ' </ label >
< input type = " text " value = " ' . attribute_escape(apply_filters('the_search_query', get_search_query())) . ' " name = " s " id = " s " />
2008-12-09 19:03:31 +01:00
< input type = " submit " id = " searchsubmit " value = " '.attribute_escape(__('Search')).' " />
2008-10-17 22:39:56 +02:00
</ div >
</ form > ' ;
echo apply_filters ( 'get_search_form' , $form );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the Log In / Out link .
2008-09-05 21:19:01 +02:00
*
2008-11-20 04:23:15 +01:00
* Displays a link , which allows the user to navigate to the Log In page to log in
* or log out depending on whether or not they are currently logged in .
2008-09-05 21:19:01 +02:00
*
* @ since 1.5 . 0
2008-09-06 08:38:26 +02:00
* @ uses apply_filters () Calls 'loginout' hook on HTML link content .
2008-09-05 21:19:01 +02:00
*/
2004-07-11 01:34:47 +02:00
function wp_loginout () {
2006-02-22 20:08:55 +01:00
if ( ! is_user_logged_in () )
2008-09-28 23:05:37 +02:00
$link = '<a href="' . wp_login_url () . '">' . __ ( 'Log in' ) . '</a>' ;
2005-10-18 01:41:28 +02:00
else
2008-09-28 23:05:37 +02:00
$link = '<a href="' . wp_logout_url () . '">' . __ ( 'Log out' ) . '</a>' ;
2004-07-11 01:34:47 +02:00
echo apply_filters ( 'loginout' , $link );
}
2008-09-28 23:05:37 +02:00
/**
* Returns the Log Out URL .
*
* Returns the URL that allows the user to log out of the site
*
* @ since 2.7
* @ uses wp_nonce_url () To protect against CSRF
* @ uses site_url () To generate the log in URL
2008-12-09 19:03:31 +01:00
*
2008-09-28 23:05:37 +02:00
* @ param string $redirect Path to redirect to on logout .
*/
function wp_logout_url ( $redirect = '' ) {
if ( strlen ( $redirect ) )
$redirect = " &redirect_to= $redirect " ;
2008-12-09 19:03:31 +01:00
2008-09-28 23:05:37 +02:00
return wp_nonce_url ( site_url ( " wp-login.php?action=logout $redirect " , 'login' ), 'log-out' );
}
/**
* Returns the Log In URL .
*
* Returns the URL that allows the user to log in to the site
*
* @ since 2.7
* @ uses site_url () To generate the log in URL
2008-12-09 19:03:31 +01:00
*
2008-09-28 23:05:37 +02:00
* @ param string $redirect Path to redirect to on login .
*/
function wp_login_url ( $redirect = '' ) {
if ( strlen ( $redirect ) )
$redirect = " ?redirect_to= $redirect " ;
2008-12-09 19:03:31 +01:00
2008-09-28 23:05:37 +02:00
return site_url ( " wp-login.php $redirect " , 'login' );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the Registration or Admin link .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Display 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-12-09 19:03:31 +01:00
*
2008-09-05 21:19:01 +02:00
* @ since 1.5 . 0
2008-09-06 08:38:26 +02:00
* @ uses apply_filters () Calls 'register' hook on register / admin link content .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02: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 21:19:01 +02:00
*/
2005-01-24 11:06:53 +01:00
function wp_register ( $before = '<li>' , $after = '</li>' ) {
2004-07-11 01:34:47 +02:00
2006-02-22 20:08:55 +01:00
if ( ! is_user_logged_in () ) {
2006-08-30 23:46:31 +02:00
if ( get_option ( 'users_can_register' ) )
2008-06-11 19:25:55 +02:00
$link = $before . '<a href="' . site_url ( 'wp-login.php?action=register' , 'login' ) . '">' . __ ( 'Register' ) . '</a>' . $after ;
2006-02-22 20:08:55 +01:00
else
$link = '' ;
} else {
2008-06-06 09:39:11 +02:00
$link = $before . '<a href="' . admin_url () . '">' . __ ( 'Site Admin' ) . '</a>' . $after ;
2006-02-22 20:08:55 +01:00
}
2004-07-11 01:34:47 +02:00
echo apply_filters ( 'register' , $link );
}
2008-09-05 21:19:01 +02: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
2008-09-06 08:38:26 +02:00
* @ link http :// trac . wordpress . org / ticket / 1458 Explanation of 'wp_meta' action .
2008-09-05 21:19:01 +02:00
* @ uses do_action () Calls 'wp_meta' hook .
*/
2004-07-11 01:34:47 +02:00
function wp_meta () {
2005-02-01 07:20:54 +01:00
do_action ( 'wp_meta' );
2004-07-11 01:34:47 +02:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display information about the blog .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* @ see get_bloginfo () For possible values for the parameter .
2008-09-05 21:19:01 +02:00
* @ since 0.71
*
2008-09-06 08:38:26 +02:00
* @ param string $show What to display .
2008-09-05 21:19:01 +02:00
*/
2004-01-27 10:58:01 +01:00
function bloginfo ( $show = '' ) {
2007-09-01 01:55:56 +02:00
echo get_bloginfo ( $show , 'display' );
2004-01-27 10:58:01 +01:00
}
2007-03-07 04:05:41 +01:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve information about the blog .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Some show parameter values are deprecated and will be removed in future
* versions . Care should be taken to check the function contents and know what
* the deprecated blog info options are . Options without " // DEPRECATED " are
* the preferred and recommended ways to get the information .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* The possible values for the 'show' parameter are listed below .
* < ol >
* < li >< strong > url < strong > - Blog URI to homepage .</ li >
* < li >< strong > wpurl </ strong > - Blog URI path to WordPress .</ li >
* < li >< strong > description </ strong > - Secondary title </ li >
* </ ol >
*
* The feed URL options can be retrieved from 'rdf_url' ( RSS 0.91 ),
* 'rss_url' ( RSS 1.0 ), 'rss2_url' ( RSS 2.0 ), or 'atom_url' ( Atom feed ) . The
* comment feeds can be retrieved from the 'comments_atom_url' ( Atom comment
* feed ) or 'comments_rss2_url' ( RSS 2.0 comment feed ) .
*
* There are many other options and you should check the function contents :
* { @ source 32 37 }
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
*
2008-09-06 08:38:26 +02:00
* @ param string $show Blog info to retrieve .
* @ param string $filter How to filter what is retrieved .
* @ return string Mostly string values , might be empty .
2007-03-07 04:05:41 +01:00
*/
2007-09-01 01:55:56 +02:00
function get_bloginfo ( $show = '' , $filter = 'raw' ) {
2004-02-05 21:55:50 +01:00
2004-09-30 19:56:16 +02:00
switch ( $show ) {
2005-10-18 01:41:28 +02:00
case 'url' :
2007-03-07 04:05:41 +01:00
case 'home' : // DEPRECATED
case 'siteurl' : // DEPRECATED
2006-08-30 23:46:31 +02:00
$output = get_option ( 'home' );
2005-10-18 01:41:28 +02:00
break ;
case 'wpurl' :
2006-08-30 23:46:31 +02:00
$output = get_option ( 'siteurl' );
2005-10-18 01:41:28 +02:00
break ;
case 'description' :
2006-08-30 23:46:31 +02:00
$output = get_option ( 'blogdescription' );
2005-10-18 01:41:28 +02: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 09:18:30 +01:00
case 'comments_atom_url' :
$output = get_feed_link ( 'comments_atom' );
2007-06-01 00:44:21 +02:00
break ;
2005-10-18 01:41:28 +02:00
case 'comments_rss2_url' :
$output = get_feed_link ( 'comments_rss2' );
break ;
case 'pingback_url' :
2006-08-30 23:46:31 +02:00
$output = get_option ( 'siteurl' ) . '/xmlrpc.php' ;
2005-10-18 01:41:28 +02: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 23:46:31 +02:00
$output = get_option ( 'admin_email' );
2005-10-18 01:41:28 +02:00
break ;
case 'charset' :
2006-08-30 23:46:31 +02:00
$output = get_option ( 'blog_charset' );
2005-10-18 01:41:28 +02: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 21:29:32 +02: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-18 01:41:28 +02:00
case 'name' :
default :
2006-08-30 23:46:31 +02:00
$output = get_option ( 'blogname' );
2005-10-18 01:41:28 +02:00
break ;
2004-09-30 19:56:16 +02:00
}
2007-09-01 01:55:56 +02:00
$url = true ;
if ( strpos ( $show , 'url' ) === false &&
strpos ( $show , 'directory' ) === false &&
strpos ( $show , 'home' ) === false )
$url = false ;
2007-09-04 01:19:20 +02:00
2007-09-01 01:55:56 +02:00
if ( 'display' == $filter ) {
if ( $url )
$output = apply_filters ( 'bloginfo_url' , $output , $show );
else
$output = apply_filters ( 'bloginfo' , $output , $show );
}
2004-09-30 19:56:16 +02:00
return $output ;
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display or retrieve page title for all areas of blog .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* By default , the page title will display the separator before the page title ,
* so that the blog title will be before the page title . This is not good for
* title display , since the blog title shows up on most tabs and not what is
* important , which is the page that the user is looking at .
*
* There are also SEO benefits to having the blog title after or to the 'right'
* or the page title . However , it is mostly common sense to have the blog title
* to the right with most browsers supporting tabs . You can achieve this by
* using the seplocation parameter and setting the value to 'right' . This change
* was introduced around 2.5 . 0 , in case backwards compatibility of themes is
* important .
2008-09-05 21:19:01 +02:00
*
* @ since 1.0 . 0
*
2008-09-12 06:31:41 +02:00
* @ param string $sep Optional , default is '»' . How to separate the various items within the page title .
* @ param bool $display Optional , default is true . Whether to display or retrieve title .
* @ param string $seplocation Optional . Direction to display title , 'right' .
* @ return string | null String on retrieve , null when displaying .
2008-09-05 21:19:01 +02:00
*/
2008-01-02 21:45:17 +01:00
function wp_title ( $sep = '»' , $display = true , $seplocation = '' ) {
2007-03-09 05:06:23 +01:00
global $wpdb , $wp_locale , $wp_query ;
2005-10-18 01:41:28 +02:00
$cat = get_query_var ( 'cat' );
2007-05-23 05:57:20 +02:00
$tag = get_query_var ( 'tag_id' );
2005-10-18 01:41:28 +02:00
$category_name = get_query_var ( 'category_name' );
2005-11-11 01:48:31 +01:00
$author = get_query_var ( 'author' );
$author_name = get_query_var ( 'author_name' );
2007-03-09 05:06:23 +01:00
$m = get_query_var ( 'm' );
$year = get_query_var ( 'year' );
$monthnum = get_query_var ( 'monthnum' );
$day = get_query_var ( 'day' );
2006-10-03 17:41:44 +02:00
$title = '' ;
2005-10-18 01:41:28 +02:00
2008-10-28 05:53:52 +01:00
$t_sep = '%WP_TITILE_SEP%' ; // Temporary separator, for accurate flipping, if necessary
2005-10-18 01:41:28 +02:00
// If there's a category
if ( ! empty ( $cat ) ) {
// category exclusion
if ( ! stristr ( $cat , '-' ) )
2006-08-25 01:50:24 +02:00
$title = apply_filters ( 'single_cat_title' , get_the_category_by_ID ( $cat ));
2007-03-07 02:29:07 +01:00
} elseif ( ! empty ( $category_name ) ) {
2005-10-18 01:41:28 +02: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 19:18:00 +02:00
$cat = get_term_by ( 'slug' , $category_name , 'category' , OBJECT , 'display' );
2007-05-27 21:32:45 +02:00
if ( $cat )
$title = apply_filters ( 'single_cat_title' , $cat -> name );
2005-10-18 01:41:28 +02:00
}
2007-05-23 05:57:20 +02:00
if ( ! empty ( $tag ) ) {
2007-08-26 19:18:00 +02:00
$tag = get_term ( $tag , 'post_tag' , OBJECT , 'display' );
2008-02-05 07:47:27 +01:00
if ( is_wp_error ( $tag ) )
2007-09-18 18:32:22 +02:00
return $tag ;
2007-05-23 05:57:20 +02:00
if ( ! empty ( $tag -> name ) )
2007-08-26 19:18:00 +02:00
$title = apply_filters ( 'single_tag_title' , $tag -> name );
2007-05-23 05:57:20 +02:00
}
2005-11-11 01:48:31 +01: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 20:45:47 +02:00
$title = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT display_name FROM $wpdb->users WHERE user_nicename = %s " , $author_name ));
2005-11-11 01:48:31 +01:00
}
2005-10-18 01:41:28 +02:00
// If there's a month
if ( ! empty ( $m ) ) {
$my_year = substr ( $m , 0 , 4 );
2007-03-29 04:06:16 +02:00
$my_month = $wp_locale -> get_month ( substr ( $m , 4 , 2 ));
2007-03-26 01:47:48 +02:00
$my_day = intval ( substr ( $m , 6 , 2 ));
2008-10-28 05:53:52 +01:00
$title = " $my_year " . ( $my_month ? " $t_sep $my_month " : " " ) . ( $my_day ? " $t_sep $my_day " : " " );
2005-10-18 01:41:28 +02:00
}
if ( ! empty ( $year ) ) {
$title = $year ;
if ( ! empty ( $monthnum ) )
2008-10-28 05:53:52 +01:00
$title .= " $t_sep " . $wp_locale -> get_month ( $monthnum );
2005-10-18 01:41:28 +02:00
if ( ! empty ( $day ) )
2008-10-28 05:53:52 +01:00
$title .= " $t_sep " . zeroise ( $day , 2 );
2005-10-18 01:41:28 +02:00
}
// If there is a post
2008-11-03 07:22:36 +01:00
if ( is_single () || ( is_page () && ! is_front_page () ) ) {
2007-03-09 05:13:42 +01:00
$post = $wp_query -> get_queried_object ();
2007-06-02 00:54:46 +02:00
$title = strip_tags ( apply_filters ( 'single_post_title' , $post -> post_title ) );
2005-10-18 01:41:28 +02:00
}
2008-05-16 05:57:09 +02: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 ;
2008-10-28 05:53:52 +01:00
$title = " $tax $t_sep $term " ;
2008-05-16 05:57:09 +02:00
}
2008-10-26 14:11:34 +01:00
if ( is_404 () ) {
2008-12-09 19:03:31 +01:00
$title = __ ( 'Page not found' );
2008-10-26 14:11:34 +01:00
}
2008-12-09 19:03:31 +01:00
2005-12-06 00:57:41 +01:00
$prefix = '' ;
2006-10-07 20:54:56 +02:00
if ( ! empty ( $title ) )
2005-12-06 00:57:41 +01:00
$prefix = " $sep " ;
2008-10-28 05:53:52 +01:00
// Determines position of the separator and direction of the breadcrumb
if ( 'right' == $seplocation ) { // sep on right, so reverse the order
$title_array = explode ( $t_sep , $title );
$title_array = array_reverse ( $title_array );
$title = implode ( " $sep " , $title_array ) . $prefix ;
} else {
$title_array = explode ( $t_sep , $title );
$title = $prefix . implode ( " $sep " , $title_array );
}
2008-02-05 07:47:27 +01:00
2008-07-23 18:44:06 +02:00
$title = apply_filters ( 'wp_title' , $title , $sep , $seplocation );
2005-12-06 00:57:41 +01:00
2005-10-18 01:41:28 +02:00
// Send it out
2005-12-06 00:57:41 +01:00
if ( $display )
echo $title ;
else
return $title ;
2008-01-02 21:45:17 +01:00
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display or retrieve page title for post .
*
* This is optimized for single . php template file for displaying the post title .
* Only useful for posts , does not support pages for example .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* It does not support placing the separator after the title , but by leaving the
* prefix parameter empty , you can set the title separator manually . The prefix
* does not automatically place a space between the prefix , so if there should
* be a space , the parameter value will need to have it at the end .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
* @ uses $wpdb
*
2008-09-12 06:31:41 +02:00
* @ param string $prefix Optional . What to display before the title .
* @ param bool $display Optional , default is true . Whether to display or retrieve title .
* @ return string | null Title when retrieving , null when displaying or failure .
2008-09-05 21:19:01 +02:00
*/
2004-01-27 10:58:01 +01:00
function single_post_title ( $prefix = '' , $display = true ) {
2005-10-18 01:41:28 +02:00
global $wpdb ;
$p = get_query_var ( 'p' );
$name = get_query_var ( 'name' );
if ( intval ( $p ) || '' != $name ) {
if ( ! $p )
2007-10-02 20:45:47 +02:00
$p = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT ID FROM $wpdb->posts WHERE post_name = %s " , $name ));
2005-10-18 01:41:28 +02: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 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display or retrieve page title for category archive .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* This is useful for category template file or files , because it is optimized
* for category page title and with less overhead than { @ link wp_title ()} .
*
* It does not support placing the separator after the title , but by leaving the
* prefix parameter empty , you can set the title separator manually . The prefix
* does not automatically place a space between the prefix , so if there should
* be a space , the parameter value will need to have it at the end .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
*
2008-09-12 06:31:41 +02:00
* @ param string $prefix Optional . What to display before the title .
* @ param bool $display Optional , default is true . Whether to display or retrieve title .
* @ return string | null Title when retrieving , null when displaying or failure .
2008-09-05 21:19:01 +02:00
*/
2004-01-27 10:58:01 +01:00
function single_cat_title ( $prefix = '' , $display = true ) {
2005-05-27 08:10:41 +02:00
$cat = intval ( get_query_var ( 'cat' ) );
2005-10-18 01:41:28 +02:00
if ( ! empty ( $cat ) && ! ( strtoupper ( $cat ) == 'ALL' ) ) {
2006-08-25 01:50:24 +02:00
$my_cat_name = apply_filters ( 'single_cat_title' , get_the_category_by_ID ( $cat ));
2005-10-18 01:41:28 +02:00
if ( ! empty ( $my_cat_name ) ) {
if ( $display )
2005-05-27 08:10:41 +02:00
echo $prefix . strip_tags ( $my_cat_name );
else
return strip_tags ( $my_cat_name );
}
2007-09-11 20:06:52 +02:00
} else if ( is_tag () ) {
return single_tag_title ( $prefix , $display );
2005-05-27 08:10:41 +02:00
}
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display or retrieve page title for tag post archive .
*
* Useful for tag template files for displaying the tag page title . It has less
* overhead than { @ link wp_title ()}, because of its limited implementation .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* It does not support placing the separator after the title , but by leaving the
* prefix parameter empty , you can set the title separator manually . The prefix
* does not automatically place a space between the prefix , so if there should
* be a space , the parameter value will need to have it at the end .
2008-09-05 21:19:01 +02:00
*
* @ since 2.3 . 0
*
2008-09-12 06:31:41 +02:00
* @ param string $prefix Optional . What to display before the title .
* @ param bool $display Optional , default is true . Whether to display or retrieve title .
* @ return string | null Title when retrieving , null when displaying or failure .
2008-09-05 21:19:01 +02:00
*/
2007-08-21 20:39:45 +02:00
function single_tag_title ( $prefix = '' , $display = true ) {
2007-09-11 20:06:52 +02:00
if ( ! is_tag () )
return ;
2007-08-21 20:39:45 +02:00
$tag_id = intval ( get_query_var ( 'tag_id' ) );
2007-09-11 20:06:52 +02:00
2007-08-21 20:39:45 +02:00
if ( ! empty ( $tag_id ) ) {
2007-09-11 20:06:52 +02:00
$my_tag = & get_term ( $tag_id , 'post_tag' , OBJECT , 'display' );
2008-02-05 07:47:27 +01:00
if ( is_wp_error ( $my_tag ) )
2007-09-21 17:51:00 +02:00
return false ;
2007-08-21 20:39:45 +02:00
$my_tag_name = apply_filters ( 'single_tag_title' , $my_tag -> name );
if ( ! empty ( $my_tag_name ) ) {
if ( $display )
2007-09-11 20:06:52 +02:00
echo $prefix . $my_tag_name ;
2007-08-21 20:39:45 +02:00
else
2007-09-11 20:06:52 +02:00
return $my_tag_name ;
2007-08-21 20:39:45 +02:00
}
}
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display or retrieve page title for post archive based on date .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* Useful for when the template only needs to display the month and year , if
* either are available . Optimized for just this purpose , so if it is all that
* is needed , should be better than { @ link wp_title ()} .
*
* It does not support placing the separator after the title , but by leaving the
* prefix parameter empty , you can set the title separator manually . The prefix
* does not automatically place a space between the prefix , so if there should
* be a space , the parameter value will need to have it at the end .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
*
2008-09-12 06:31:41 +02:00
* @ param string $prefix Optional . What to display before the title .
* @ param bool $display Optional , default is true . Whether to display or retrieve title .
* @ return string | null Title when retrieving , null when displaying or failure .
2008-09-05 21:19:01 +02:00
*/
2004-01-27 10:58:01 +01:00
function single_month_title ( $prefix = '' , $display = true ) {
2007-03-09 05:06:23 +01:00
global $wp_locale ;
$m = get_query_var ( 'm' );
$year = get_query_var ( 'year' );
$monthnum = get_query_var ( 'monthnum' );
2005-10-18 01:41:28 +02:00
if ( ! empty ( $monthnum ) && ! empty ( $year ) ) {
2004-10-19 01:45:26 +02:00
$my_year = $year ;
2006-04-02 02:20:11 +02:00
$my_month = $wp_locale -> get_month ( $monthnum );
2005-10-18 01:41:28 +02:00
} elseif ( ! empty ( $m ) ) {
2004-10-19 01:52:36 +02:00
$my_year = substr ( $m , 0 , 4 );
2006-10-05 05:12:24 +02:00
$my_month = $wp_locale -> get_month ( substr ( $m , 4 , 2 ));
2004-10-19 01:52:36 +02:00
}
2006-10-05 05:12:24 +02:00
if ( empty ( $my_month ) )
return false ;
$result = $prefix . $my_month . $prefix . $my_year ;
if ( ! $display )
return $result ;
echo $result ;
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Retrieve archive link content based on predefined or custom code .
*
* The format can be one of four styles . The 'link' for head element , 'option'
* for use in the select element , 'html' for use in list ( either ol or ul HTML
* elements ) . Custom content is also supported using the before and after
* parameters .
*
* The 'link' format uses the link HTML element with the < em > archives </ em >
* relationship . The before and after parameters are not used . The text
* parameter is used to describe the link .
*
* The 'option' format uses the option HTML element for use in select element .
* The value is the url parameter and the before and after parameters are used
* between the text description .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* The 'html' format , which is the default , uses the li HTML element for use in
* the list HTML elements . The before parameter is before the link and the after
* parameter is after the closing link .
*
* The custom format uses the before parameter before the link ( 'a' HTML
* element ) and the after parameter after the closing link tag . If the above
* three values for the format are not used , then custom format is assumed .
2008-09-05 21:19:01 +02:00
*
* @ since 1.0 . 0
* @ author Orien
* @ link http :// icecode . com / link navigation hack by Orien
*
2008-09-12 06:31:41 +02:00
* @ param string $url URL to archive .
* @ param string $text Archive text description .
* @ param string $format Optional , default is 'html' . Can be 'link' , 'option' , 'html' , or custom .
* @ param string $before Optional .
* @ param string $after Optional .
* @ return string HTML link content for archive .
2008-09-05 21:19:01 +02:00
*/
2004-07-06 19:04:07 +02:00
function get_archives_link ( $url , $text , $format = 'html' , $before = '' , $after = '' ) {
$text = wptexturize ( $text );
2006-12-21 11:10:04 +01:00
$title_text = attribute_escape ( $text );
2007-03-17 09:46:59 +01:00
$url = clean_url ( $url );
2004-07-29 01:09:33 +02:00
2005-10-18 01:41:28 +02:00
if ( 'link' == $format )
2008-05-20 18:43:44 +02:00
$link_html = " \t <link rel='archives' title=' $title_text ' href=' $url ' /> \n " ;
2005-10-18 01:41:28 +02:00
elseif ( 'option' == $format )
2008-05-20 18:43:44 +02:00
$link_html = " \t <option value=' $url '> $before $text $after </option> \n " ;
2005-10-18 01:41:28 +02:00
elseif ( 'html' == $format )
2008-05-20 18:43:44 +02:00
$link_html = " \t <li> $before <a href=' $url ' title=' $title_text '> $text </a> $after </li> \n " ;
2005-10-18 01:41:28 +02:00
else // custom
2008-05-20 18:43:44 +02: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 07:36:14 +02:00
2008-05-20 18:43:44 +02:00
return $link_html ;
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display archive links based on type and format .
*
* The 'type' argument offers a few choices and by default will display monthly
* archive links . The other options for values are 'daily' , 'weekly' , 'monthly' ,
* 'yearly' , 'postbypost' or 'alpha' . Both 'postbypost' and 'alpha' display the
* same archive link list , the difference between the two is that 'alpha'
* will order by post title and 'postbypost' will order by post date .
*
* The date archives will logically display dates with links to the archive post
* page . The 'postbypost' and 'alpha' values for 'type' argument will display
* the post titles .
*
* The 'limit' argument will only display a limited amount of links , specified
* by the 'limit' integer value . By default , there is no limit . The
* 'show_post_count' argument will show how many posts are within the archive .
* By default , the 'show_post_count' argument is set to false .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* For the 'format' , 'before' , and 'after' arguments , see { @ link
* get_archives_link ()} . The values of these arguments have to do with that
* function .
2008-09-05 21:19:01 +02:00
*
* @ since 1.2 . 0
*
2008-09-12 06:31:41 +02:00
* @ param string | array $args Optional . Override defaults .
2008-09-05 21:19:01 +02:00
*/
2004-04-24 21:23:57 +02:00
function wp_get_archives ( $args = '' ) {
2007-05-11 06:01:54 +02:00
global $wpdb , $wp_locale ;
2007-06-14 04:25:30 +02:00
2007-05-11 05:10:05 +02:00
$defaults = array (
2007-09-04 01:32:58 +02:00
'type' => 'monthly' , 'limit' => '' ,
'format' => 'html' , 'before' => '' ,
2008-09-16 06:52:47 +02:00
'after' => '' , 'show_post_count' => false ,
'echo' => 1
2007-05-11 05:10:05 +02:00
);
2007-06-14 04:25:30 +02:00
2007-05-11 05:10:05 +02:00
$r = wp_parse_args ( $args , $defaults );
2007-06-15 00:45:40 +02:00
extract ( $r , EXTR_SKIP );
2005-10-18 01:41:28 +02:00
if ( '' == $type )
$type = 'monthly' ;
if ( '' != $limit ) {
2008-01-29 19:48:38 +01:00
$limit = absint ( $limit );
2005-10-18 01:41:28 +02:00
$limit = ' LIMIT ' . $limit ;
}
2006-06-15 22:28:47 +02:00
2005-10-18 01:41:28 +02: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 23:46:31 +02: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-18 01:41:28 +02:00
}
2007-03-09 05:09:24 +01:00
//filters
$where = apply_filters ( 'getarchives_where' , " WHERE post_type = 'post' AND post_status = 'publish' " , $r );
$join = apply_filters ( 'getarchives_join' , " " , $r );
2008-10-24 22:47:12 +02:00
$output = '' ;
2005-10-18 01:41:28 +02:00
if ( 'monthly' == $type ) {
2007-10-30 07:03:11 +01: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-18 01:41:28 +02:00
if ( $arcresults ) {
$afterafter = $after ;
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $arcresults as $arcresult ) {
2008-09-12 06:31:41 +02:00
$url = get_month_link ( $arcresult -> year , $arcresult -> month );
2006-11-29 22:34:51 +01:00
$text = sprintf ( __ ( '%1$s %2$d' ), $wp_locale -> get_month ( $arcresult -> month ), $arcresult -> year );
2007-09-04 01:32:58 +02:00
if ( $show_post_count )
2005-10-18 01:41:28 +02:00
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
2008-10-24 22:47:12 +02:00
$output .= get_archives_link ( $url , $text , $format , $before , $after );
2005-10-18 01:41:28 +02:00
}
}
2006-08-30 19:23:42 +02:00
} elseif ( 'yearly' == $type ) {
2007-10-30 07:03:11 +01: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 19:23:42 +02:00
if ( $arcresults ) {
2007-02-27 16:24:54 +01:00
$afterafter = $after ;
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $arcresults as $arcresult ) {
2007-02-27 16:24:54 +01:00
$url = get_year_link ( $arcresult -> year );
$text = sprintf ( '%d' , $arcresult -> year );
2006-09-07 19:38:43 +02:00
if ( $show_post_count )
2007-02-27 16:24:54 +01:00
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
2008-10-24 22:47:12 +02:00
$output .= get_archives_link ( $url , $text , $format , $before , $after );
2007-02-27 16:24:54 +01:00
}
}
2005-10-18 01:41:28 +02:00
} elseif ( 'daily' == $type ) {
2007-10-30 07:03:11 +01: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-18 01:41:28 +02:00
if ( $arcresults ) {
2006-09-07 19:38:43 +02:00
$afterafter = $after ;
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-18 01:41:28 +02:00
$url = get_day_link ( $arcresult -> year , $arcresult -> month , $arcresult -> dayofmonth );
2006-12-10 01:23:10 +01:00
$date = sprintf ( '%1$d-%2$02d-%3$02d 00:00:00' , $arcresult -> year , $arcresult -> month , $arcresult -> dayofmonth );
2005-10-18 01:41:28 +02:00
$text = mysql2date ( $archive_day_date_format , $date );
2006-09-07 19:38:43 +02:00
if ( $show_post_count )
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
2008-10-24 22:47:12 +02:00
$output .= get_archives_link ( $url , $text , $format , $before , $after );
2005-10-18 01:41:28 +02:00
}
}
} elseif ( 'weekly' == $type ) {
2006-08-30 23:46:31 +02:00
$start_of_week = get_option ( 'start_of_week' );
2007-10-30 07:03:11 +01: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-18 01:41:28 +02:00
$arc_w_last = '' ;
2006-09-07 19:38:43 +02:00
$afterafter = $after ;
2005-10-18 01:41:28 +02:00
if ( $arcresults ) {
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-18 01:41:28 +02:00
if ( $arcresult -> week != $arc_w_last ) {
$arc_year = $arcresult -> yr ;
$arc_w_last = $arcresult -> week ;
2006-08-30 23:46:31 +02:00
$arc_week = get_weekstartend ( $arcresult -> yyyymmdd , get_option ( 'start_of_week' ));
2005-10-18 01:41:28 +02: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 01:23:10 +01: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-18 01:41:28 +02:00
$text = $arc_week_start . $archive_week_separator . $arc_week_end ;
2006-09-07 19:38:43 +02:00
if ( $show_post_count )
$after = ' (' . $arcresult -> posts . ')' . $afterafter ;
2008-10-24 22:47:12 +02:00
$output .= get_archives_link ( $url , $text , $format , $before , $after );
2005-10-18 01:41:28 +02:00
}
}
}
2006-02-19 03:07:13 +01:00
} elseif ( ( 'postbypost' == $type ) || ( 'alpha' == $type ) ) {
2008-10-24 22:47:12 +02:00
$orderby = ( 'alpha' == $type ) ? " post_title ASC " : " post_date DESC " ;
2007-10-30 07:03:11 +01: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-18 01:41:28 +02:00
if ( $arcresults ) {
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $arcresults as $arcresult ) {
2005-10-18 01:41:28 +02: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-31 01:46:17 +02:00
$text = strip_tags ( apply_filters ( 'the_title' , $arc_title ));
2005-10-18 01:41:28 +02:00
else
$text = $arcresult -> ID ;
2008-10-24 22:47:12 +02:00
$output .= get_archives_link ( $url , $text , $format , $before , $after );
2005-10-18 01:41:28 +02:00
}
}
}
}
2008-10-24 22:47:12 +02:00
if ( $echo )
echo $output ;
else
2008-12-09 19:03:31 +01:00
return $output ;
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Get number of days since the start of the week .
2008-09-05 21:19:01 +02:00
*
* @ since 1.5 . 0
* @ usedby get_calendar ()
*
2008-09-06 08:38:26 +02:00
* @ param int $num Number of day .
2008-09-12 06:31:41 +02:00
* @ return int Days since the start of the week .
2008-09-05 21:19:01 +02:00
*/
2004-09-10 01:07:46 +02:00
function calendar_week_mod ( $num ) {
$base = 7 ;
return ( $num - $base * floor ( $num / $base ));
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display calendar with days that have posts as links .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* The calendar is cached , which will be retrieved , if it exists . If there are
* no posts for the month , then it will not be displayed .
2008-09-05 21:19:01 +02:00
*
* @ since 1.0 . 0
*
2008-09-12 06:31:41 +02:00
* @ param bool $initial Optional , default is true . Use initial calendar names .
2008-09-05 21:19:01 +02:00
*/
2006-04-02 02:20:11 +02:00
function get_calendar ( $initial = true ) {
2007-12-06 20:49:33 +01:00
global $wpdb , $m , $monthnum , $year , $wp_locale , $posts ;
2005-10-18 01:41:28 +02:00
2008-12-19 08:05:00 +01:00
$cache = array ();
2006-11-23 18:56:53 +01:00
$key = md5 ( $m . $monthnum . $year );
if ( $cache = wp_cache_get ( 'get_calendar' , 'calendar' ) ) {
2008-12-19 08:05:00 +01:00
if ( is_array ( $cache ) && isset ( $cache [ $key ] ) ) {
2006-11-23 19:31:27 +01:00
echo $cache [ $key ];
2006-11-23 18:56:53 +01:00
return ;
}
}
2008-12-19 08:05:00 +01:00
if ( ! is_array ( $cache ) )
$cache = array ();
2006-11-23 18:56:53 +01:00
ob_start ();
2005-10-18 01:41:28 +02:00
// Quick check. If we have no posts at all, abort!
if ( ! $posts ) {
2006-02-09 11:03:48 +01: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-18 01:41:28 +02:00
if ( ! $gotsome )
return ;
}
if ( isset ( $_GET [ 'w' ]) )
$w = '' . intval ( $_GET [ 'w' ]);
// week_begins = 0 stands for Sunday
2006-08-30 23:46:31 +02:00
$week_begins = intval ( get_option ( 'start_of_week' ));
2005-10-18 01:41:28 +02: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 13:22:42 +02:00
$thisyear = gmdate ( 'Y' , current_time ( 'timestamp' ));
$thismonth = gmdate ( 'm' , current_time ( 'timestamp' ));
2005-10-18 01:41:28 +02: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 11:03:48 +01:00
AND post_type = 'post' AND post_status = 'publish'
2005-10-18 01:41:28 +02: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 23:55:28 +01:00
AND post_type = 'post' AND post_status = 'publish'
2005-10-18 01:41:28 +02:00
ORDER BY post_date ASC
LIMIT 1 " );
2007-02-23 02:05:59 +01:00
echo '<table id="wp-calendar" summary="' . __ ( 'Calendar' ) . ' " >
2008-01-01 19:38:32 +01:00
< caption > ' . sprintf(_c(' % 1 $s % 2 $s | Used as a calendar caption '), $wp_locale->get_month($thismonth), date(' Y ', $unixmonth)) . ' </ caption >
2005-10-18 01:41:28 +02:00
< thead >
< tr > ' ;
$myweek = array ();
for ( $wdcount = 0 ; $wdcount <= 6 ; $wdcount ++ ) {
2006-04-02 02:20:11 +02:00
$myweek [] = $wp_locale -> get_weekday (( $wdcount + $week_begins ) % 7 );
2005-10-18 01:41:28 +02:00
}
foreach ( $myweek as $wd ) {
2006-04-02 02:20:11 +02: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-18 01:41:28 +02:00
}
echo '
</ tr >
</ thead >
< tfoot >
< tr > ' ;
if ( $previous ) {
2006-04-02 02:20:11 +02: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-18 01:41:28 +02: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 02:20:11 +02: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-18 01:41:28 +02: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 02:02:00 +02:00
FROM $wpdb -> posts WHERE MONTH ( post_date ) = '$thismonth'
AND YEAR ( post_date ) = '$thisyear'
2006-02-09 11:03:48 +01:00
AND post_type = 'post' AND post_status = 'publish'
2005-10-18 01:41:28 +02:00
AND post_date < '" . current_time(' mysql ') . ' \ '' , ARRAY_N );
if ( $dayswithposts ) {
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $dayswithposts as $daywith ) {
2005-10-18 01:41:28 +02:00
$daywithpost [] = $daywith [ 0 ];
}
} else {
$daywithpost = array ();
}
2007-03-07 06:29:15 +01: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-18 01:41:28 +02: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 11:03:48 +01:00
. " AND post_type = 'post' AND post_status = 'publish' "
2005-10-18 01:41:28 +02:00
);
if ( $ak_post_titles ) {
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $ak_post_titles as $ak_post_title ) {
2007-06-14 04:25:30 +02:00
2007-03-10 04:56:35 +01:00
$post_title = apply_filters ( " the_title " , $ak_post_title -> post_title );
$post_title = str_replace ( '"' , '"' , wptexturize ( $post_title ));
2007-06-14 04:25:30 +02:00
2005-10-18 01:41:28 +02: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 04:56:35 +01:00
$ak_titles_for_day [ " $ak_post_title->dom " ] = $post_title ;
2005-10-18 01:41:28 +02:00
else
2007-03-10 04:56:35 +01:00
$ak_titles_for_day [ " $ak_post_title->dom " ] .= $ak_title_separator . $post_title ;
2005-10-18 01:41:28 +02: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 23:46:31 +02: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-18 01:41:28 +02: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 18:56:53 +01:00
$output = ob_get_contents ();
ob_end_clean ();
echo $output ;
$cache [ $key ] = $output ;
2007-09-15 23:50:53 +02:00
wp_cache_set ( 'get_calendar' , $cache , 'calendar' );
2006-11-23 18:56:53 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Purge the cached results of get_calendar .
2008-12-09 19:03:31 +01:00
*
2008-09-05 23:47:53 +02:00
* @ see get_calendar
2008-09-05 21:19:01 +02:00
* @ since 2.1 . 0
*/
2006-11-23 18:56:53 +01:00
function delete_get_calendar_cache () {
wp_cache_delete ( 'get_calendar' , 'calendar' );
2004-01-27 10:58:01 +01:00
}
2006-11-23 18:56:53 +01: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 10:58:01 +01:00
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display all of the allowed tags in HTML format with attributes .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* This is useful for displaying in the comment area , which elements and
* attributes are supported . As well as any plugins which want to display it .
2008-09-05 21:19:01 +02:00
*
* @ since 1.0 . 1
* @ uses $allowedtags
*
2008-09-12 06:31:41 +02:00
* @ return string HTML allowed tags entity encoded .
2008-09-05 21:19:01 +02:00
*/
2004-01-27 10:58:01 +01:00
function allowed_tags () {
2005-10-18 01:41:28 +02:00
global $allowedtags ;
2004-05-08 01:56:33 +02:00
$allowed = '' ;
2008-08-06 22:31:54 +02:00
foreach ( ( array ) $allowedtags as $tag => $attributes ) {
2005-10-18 01:41:28 +02:00
$allowed .= '<' . $tag ;
if ( 0 < count ( $attributes ) ) {
foreach ( $attributes as $attribute => $limits ) {
$allowed .= ' ' . $attribute . '=""' ;
}
}
$allowed .= '> ' ;
}
return htmlentities ( $allowed );
2004-01-27 10:58:01 +01:00
}
/***** Date/Time tags *****/
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Outputs the date in iso8601 format for xml files .
2008-09-05 21:19:01 +02:00
*
* @ since 1.0 . 0
*/
2004-01-27 10:58:01 +01:00
function the_date_xml () {
2005-10-18 01:41:28 +02:00
global $post ;
echo mysql2date ( 'Y-m-d' , $post -> post_date );
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display or Retrieve the date the post was written .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Will only output the date if the current post ' s date is different from the
* previous one output .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
*
2008-09-06 08:38:26 +02:00
* @ param string $d Optional . PHP date format defaults to the date_format option if not specified .
* @ param string $before Optional . Output before the date .
* @ param string $after Optional . Output after the date .
* @ param bool $echo Optional , default is display . Whether to echo the date or return it .
* @ return string | null Null if displaying , string if retrieving .
2008-09-05 21:19:01 +02:00
*/
2004-01-27 10:58:01 +01:00
function the_date ( $d = '' , $before = '' , $after = '' , $echo = true ) {
2007-12-06 20:49:33 +01:00
global $post , $day , $previousday ;
2005-10-18 01:41:28 +02:00
$the_date = '' ;
if ( $day != $previousday ) {
$the_date .= $before ;
if ( $d == '' )
2006-08-30 23:46:31 +02:00
$the_date .= mysql2date ( get_option ( 'date_format' ), $post -> post_date );
2005-10-18 01:41:28 +02:00
else
$the_date .= mysql2date ( $d , $post -> post_date );
$the_date .= $after ;
$previousday = $day ;
2008-12-14 13:13:30 +01:00
2005-10-18 01:41:28 +02:00
$the_date = apply_filters ( 'the_date' , $the_date , $d , $before , $after );
if ( $echo )
echo $the_date ;
else
return $the_date ;
2008-12-14 13:13:30 +01:00
}
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the date on which the post was last modified .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*
2008-09-06 08:38:26 +02:00
* @ param string $d Optional . PHP date format .
2008-09-05 23:47:53 +02:00
* @ return string
2008-09-05 21:19:01 +02:00
*/
2006-08-30 18:46:08 +02:00
function the_modified_date ( $d = '' ) {
echo apply_filters ( 'the_modified_date' , get_the_modified_date ( $d ), $d );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve the date on which the post was last modified .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*
2008-09-06 08:38:26 +02:00
* @ param string $d Optional . PHP date format . Defaults to the " date_format " option
2008-09-05 23:47:53 +02:00
* @ return string
2008-09-05 21:19:01 +02:00
*/
2006-08-30 18:46:08 +02:00
function get_the_modified_date ( $d = '' ) {
if ( '' == $d )
2006-08-30 23:46:31 +02:00
$the_time = get_post_modified_time ( get_option ( 'date_format' ));
2006-08-30 18:46:08 +02:00
else
$the_time = get_post_modified_time ( $d );
return apply_filters ( 'get_the_modified_date' , $the_time , $d );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the time at which the post was written .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
*
2008-09-05 23:47:53 +02:00
* @ param string $d Either 'G' , 'U' , or php date format .
2008-09-05 21:19:01 +02:00
*/
2005-01-07 23:01:59 +01:00
function the_time ( $d = '' ) {
2005-02-06 04:40:08 +01:00
echo apply_filters ( 'the_time' , get_the_time ( $d ), $d );
2005-01-07 23:01:59 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve the time at which the post was written .
2008-09-05 21:19:01 +02:00
*
* @ since 1.5 . 0
*
2008-09-05 23:47:53 +02:00
* @ param string $d Either 'G' , 'U' , or php date format defaults to the value specified in the time_format option .
2008-11-02 22:05:38 +01:00
* @ param int | object $post Optional post ID or object . Default is global $post object .
2008-09-05 23:47:53 +02:00
* @ return string
2008-09-05 21:19:01 +02:00
*/
2008-11-02 22:05:38 +01:00
function get_the_time ( $d = '' , $post = null ) {
$post = get_post ( $post );
2005-01-07 23:01:59 +01:00
if ( '' == $d )
2008-11-02 22:05:38 +01:00
$the_time = get_post_time ( get_option ( 'time_format' ), false , $post );
2005-01-07 23:01:59 +01:00
else
2008-11-02 22:05:38 +01:00
$the_time = get_post_time ( $d , false , $post );
return apply_filters ( 'get_the_time' , $the_time , $d , $post );
2005-01-07 23:01:59 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve the time at which the post was written .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ since 2.0 . 0
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ param string $d Either 'G' , 'U' , or php date format .
* @ param bool $gmt Whether of not to return the gmt time .
2008-11-02 22:05:38 +01:00
* @ param int | object $post Optional post ID or object . Default is global $post object .
2008-09-05 23:47:53 +02:00
* @ return string
2008-09-05 21:19:01 +02:00
*/
2008-11-02 23:24:42 +01:00
function get_post_time ( $d = 'U' , $gmt = false , $post = null ) { // returns timestamp
2008-11-02 22:05:38 +01:00
$post = get_post ( $post );
2005-01-07 23:01:59 +01:00
if ( $gmt )
2005-01-19 03:21:36 +01:00
$time = $post -> post_date_gmt ;
2005-01-07 23:01:59 +01:00
else
2005-01-19 03:21:36 +01:00
$time = $post -> post_date ;
$time = mysql2date ( $d , $time );
2008-04-08 19:33:42 +02:00
return apply_filters ( 'get_post_time' , $time , $d , $gmt );
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the time at which the post was last modified .
2008-09-05 21:19:01 +02:00
*
* @ since 2.0 . 0
*
2008-09-06 08:38:26 +02:00
* @ param string $d Either 'G' , 'U' , or php date format defaults to the value specified in the time_format option .
2008-09-05 21:19:01 +02:00
*/
2005-11-11 00:31:30 +01:00
function the_modified_time ( $d = '' ) {
echo apply_filters ( 'the_modified_time' , get_the_modified_time ( $d ), $d );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve the time at which the post was last modified .
2008-09-05 21:19:01 +02:00
*
* @ since 2.0 . 0
*
2008-09-05 23:47:53 +02: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 21:19:01 +02:00
*/
2005-11-11 00:31:30 +01:00
function get_the_modified_time ( $d = '' ) {
if ( '' == $d )
2006-08-30 23:46:31 +02:00
$the_time = get_post_modified_time ( get_option ( 'time_format' ));
2005-11-11 00:31:30 +01:00
else
$the_time = get_post_modified_time ( $d );
return apply_filters ( 'get_the_modified_time' , $the_time , $d );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve the time at which the post was last modified .
2008-09-05 21:19:01 +02:00
*
* @ since 2.0 . 0
*
2008-09-05 23:47:53 +02:00
* @ param string $d Either 'G' , 'U' , or php date format .
* @ param bool $gmt Whether of not to return the gmt time .
2008-09-06 08:38:26 +02:00
* @ return string Returns timestamp
2008-09-05 21:19:01 +02:00
*/
2008-09-06 08:38:26 +02:00
function get_post_modified_time ( $d = 'U' , $gmt = false ) {
2005-11-11 00:31:30 +01:00
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 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the weekday on which the post was written .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
* @ uses $wp_locale
* @ uses $post
*/
2004-01-27 10:58:01 +01:00
function the_weekday () {
2007-12-06 20:49:33 +01:00
global $wp_locale , $post ;
2006-04-02 02:20:11 +02:00
$the_weekday = $wp_locale -> get_weekday ( mysql2date ( 'w' , $post -> post_date ));
2005-10-18 01:41:28 +02:00
$the_weekday = apply_filters ( 'the_weekday' , $the_weekday );
echo $the_weekday ;
2004-01-27 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the weekday on which the post was written .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Will only output the weekday if the current post ' s weekday is different from
* the previous one output .
2008-09-05 21:19:01 +02:00
*
* @ since 0.71
*
2008-09-05 23:47:53 +02:00
* @ param string $before output before the date .
* @ param string $after output after the date .
*/
2004-01-27 10:58:01 +01:00
function the_weekday_date ( $before = '' , $after = '' ) {
2007-12-06 20:49:33 +01:00
global $wp_locale , $post , $day , $previousweekday ;
2005-10-18 01:41:28 +02:00
$the_weekday_date = '' ;
if ( $day != $previousweekday ) {
$the_weekday_date .= $before ;
2006-04-02 02:20:11 +02:00
$the_weekday_date .= $wp_locale -> get_weekday ( mysql2date ( 'w' , $post -> post_date ));
2005-10-18 01:41:28 +02: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 10:58:01 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Fire the wp_head action
2008-09-05 21:19:01 +02:00
*
* @ since 1.2 . 0
2008-09-06 08:38:26 +02:00
* @ uses do_action () Calls 'wp_head' hook .
2008-09-05 21:19:01 +02:00
*/
2006-06-08 01:17:59 +02:00
function wp_head () {
do_action ( 'wp_head' );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Fire the wp_footer action
2008-09-05 21:19:01 +02:00
*
* @ since 1.5 . 1
2008-09-06 08:38:26 +02:00
* @ uses do_action () Calls 'wp_footer' hook .
2008-09-05 21:19:01 +02:00
*/
2006-06-08 01:17:59 +02:00
function wp_footer () {
do_action ( 'wp_footer' );
}
2009-01-19 06:04:58 +01:00
/**
* Enable / disable automatic general feed link outputting .
*
* @ since 2.8 . 0
*
* @ param boolean $add Add or remove links . Defaults to true .
*/
function automatic_feed_links ( $add = true ) {
if ( $add )
add_action ( 'wp_head' , 'feed_links' , 2 );
else {
remove_action ( 'wp_head' , 'feed_links' , 2 );
remove_action ( 'wp_head' , 'feed_links_extra' , 3 );
}
}
/**
* Display the links to the general feeds .
*
* @ since 2.8 . 0
*
* @ param array $args Optional arguments .
*/
function feed_links ( $args ) {
$defaults = array (
'seperator' => _c ( '»|Seperator character feed titles in theme head' ),
'rsstitle' => __ ( '%s Feed' ),
'comstitle' => __ ( '%s Comments Feed' ),
);
$args = wp_parse_args ( $args , $defaults );
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'rsstitle' ], get_bloginfo ( 'name' ) ) . '" href="' . get_feed_link () . " \" /> \n " ;
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'comstitle' ], get_bloginfo ( 'name' ) ) . '" href="' . get_feed_link ( 'comments_' . get_default_feed () ) . " \" /> \n " ;
}
/**
* Display the links to the extra feeds such as category feeds .
*
* @ since 2.8 . 0
*
* @ param array $args Optional arguments .
*/
function feed_links_extra ( $args ) {
$defaults = array (
'seperator' => _c ( '»|Seperator character feed titles in theme head' ),
'singletitle' => __ ( '%1$s %2$s %3$s Comments Feed' ),
'cattitle' => __ ( '%1$s %2$s %3$s Category Feed' ),
'tagtitle' => __ ( '%1$s %2$s %3$s Tag Feed' ),
'authortitle' => __ ( '%1$s %2$s Posts by %3$s Feed' ),
'searchtitle' => __ ( '%1$s %2$s Search Results for "%3$s" Feed' ),
);
$args = wp_parse_args ( $args , $defaults );
if ( is_single () || is_page () ) {
$post = & get_post ( $id = 0 );
if ( comments_open () || pings_open () || $post -> comment_count > 0 )
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'singletitle' ], get_bloginfo ( 'name' ), $args [ 'seperator' ], get_the_title () ) . '" href="' . get_post_comments_feed_link ( $post -> ID ) . " \" /> \n " ;
}
elseif ( is_category () ) {
$cat_id = intval ( get_query_var ( 'cat' ) );
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'cattitle' ], get_bloginfo ( 'name' ), $args [ 'seperator' ], get_cat_name ( $cat_id ) ) . '" href="' . get_category_feed_link ( $cat_id ) . " \" /> \n " ;
}
elseif ( is_tag () ) {
$tag_id = intval ( get_query_var ( 'tag_id' ) );
$tag = get_tag ( $tag_id );
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'tagtitle' ], get_bloginfo ( 'name' ), $args [ 'seperator' ], $tag -> name ) . '" href="' . get_tag_feed_link ( $tag_id ) . " \" /> \n " ;
}
elseif ( is_author () ) {
$author_id = intval ( get_query_var ( 'author' ) );
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'authortitle' ], get_bloginfo ( 'name' ), $args [ 'seperator' ], get_author_name ( $author_id ) ) . '" href="' . get_author_feed_link ( $author_id ) . " \" /> \n " ;
}
elseif ( is_search () ) {
echo '<link rel="alternate" type="' . feed_content_type () . '" title="' . sprintf ( $args [ 'searchtitle' ], get_bloginfo ( 'name' ), $args [ 'seperator' ], get_search_query () ) . '" href="' . get_search_feed_link () . " \" /> \n " ;
}
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the link to the Really Simple Discovery service endpoint .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ link http :// archipelago . phrasewise . com / rsd
2008-09-05 21:19:01 +02:00
* @ since 2.0 . 0
*/
2005-11-07 10:47:51 +01:00
function rsd_link () {
2008-01-02 19:21:19 +01:00
echo '<link rel="EditURI" type="application/rsd+xml" title="RSD" href="' . get_bloginfo ( 'wpurl' ) . " /xmlrpc.php?rsd \" /> \n " ;
2007-10-05 19:29:34 +02:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the link to the Windows Live Writer manifest file .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ link http :// msdn . microsoft . com / en - us / library / bb463265 . aspx
2008-09-05 21:19:01 +02:00
* @ since 2.3 . 1
*/
2007-10-05 19:29:34 +02:00
function wlwmanifest_link () {
2008-01-02 19:21:19 +01:00
echo '<link rel="wlwmanifest" type="application/wlwmanifest+xml" href="'
. get_bloginfo ( 'wpurl' ) . '/wp-includes/wlwmanifest.xml" /> ' . " \n " ;
2005-11-07 10:47:51 +01:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display a noindex meta tag if required by the blog configuration .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* If a blog is marked as not being public then the noindex meta tag will be
* output to tell web robots not to index the page content .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*/
2006-02-18 08:40:43 +01:00
function noindex () {
// If the blog is not public, tell robots to go away.
2006-06-18 01:38:45 +02:00
if ( '0' == get_option ( 'blog_public' ) )
echo " <meta name='robots' content='noindex,nofollow' /> \n " ;
2006-02-18 08:40:43 +01:00
}
2006-06-08 01:17:59 +02:00
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Determine if TinyMCE is available .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* Checks to see if the user has deleted the tinymce files to slim down there WordPress install .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*
2008-09-05 23:47:53 +02:00
* @ return bool Whether of not TinyMCE exists .
2008-09-05 21:19:01 +02:00
*/
2006-10-24 05:57:19 +02: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-23 00:24:50 +02:00
2008-09-05 21:19:01 +02:00
/**
2008-09-05 23:47:53 +02:00
* Whether or not the user should have a WYSIWIG editor .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Checks that the user requires a WYSIWIG editor and that the editor is
* supported in the users browser .
2008-09-05 21:19:01 +02:00
*
* @ since 2.0 . 0
*
2008-09-05 23:47:53 +02:00
* @ return bool
2008-09-05 21:19:01 +02:00
*/
2006-10-24 05:57:19 +02:00
function user_can_richedit () {
2006-12-07 01:38:54 +01:00
global $wp_rich_edit , $pagenow ;
2007-06-14 04:25:30 +02:00
2007-05-10 03:31:12 +02:00
if ( ! isset ( $wp_rich_edit ) ) {
2007-09-04 01:32:58 +02:00
if ( get_user_option ( 'rich_editing' ) == 'true' &&
( ( preg_match ( '!AppleWebKit/(\d+)!' , $_SERVER [ 'HTTP_USER_AGENT' ], $match ) && intval ( $match [ 1 ]) >= 420 ) ||
2007-07-05 22:11:32 +02:00
! preg_match ( '!opera[ /][2-8]|konqueror|safari!i' , $_SERVER [ 'HTTP_USER_AGENT' ] ) )
&& 'comment.php' != $pagenow ) {
2007-05-10 03:31:12 +02:00
$wp_rich_edit = true ;
} else {
$wp_rich_edit = false ;
}
}
2006-09-23 00:24:50 +02:00
2006-10-24 05:57:19 +02:00
return apply_filters ( 'user_can_richedit' , $wp_rich_edit );
2006-09-23 00:24:50 +02:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Find out which editor should be displayed by default .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Works out which of the two editors to display as the current editor for a
* user .
2008-09-05 21:19:01 +02:00
*
* @ since 2.5 . 0
*
* @ return string Either 'tinymce' , or 'html' , or 'test'
*/
2008-01-06 20:01:32 +01:00
function wp_default_editor () {
$r = user_can_richedit () ? 'tinymce' : 'html' ; // defaults
if ( $user = wp_get_current_user () ) { // look for cookie
2008-08-31 08:34:43 +02:00
$ed = get_user_setting ( 'editor' , 'tinymce' );
$r = ( in_array ( $ed , array ( 'tinymce' , 'html' , 'test' ) ) ) ? $ed : $r ;
2008-01-06 20:01:32 +01:00
}
return apply_filters ( 'wp_default_editor' , $r ); // filter
}
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Display visual editor forms : TinyMCE , or HTML , or both .
*
* The amount of rows the text area will have for the content has to be between
* 3 and 100 or will default at 12. There is only one option used for all users ,
* named 'default_post_edit_rows' .
2008-09-05 21:19:01 +02:00
*
2008-09-12 06:31:41 +02:00
* If the user can not use the rich editor ( TinyMCE ), then the switch button
* will not be displayed .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*
2008-09-12 06:31:41 +02:00
* @ param string $content Textarea content .
* @ param string $id HTML ID attribute value .
* @ param string $prev_id HTML ID name for switching back and forth between visual editors .
* @ param bool $media_buttons Optional , default is true . Whether to display media buttons .
* @ param int $tab_index Optional , default is 2. Tabindex for textarea element .
2008-09-05 21:19:01 +02:00
*/
2008-02-26 05:53:48 +01:00
function the_editor ( $content , $id = 'content' , $prev_id = 'title' , $media_buttons = true , $tab_index = 2 ) {
2006-08-30 23:46:31 +02:00
$rows = get_option ( 'default_post_edit_rows' );
2006-06-08 01:17:59 +02:00
if (( $rows < 3 ) || ( $rows > 100 ))
$rows = 12 ;
2008-11-13 08:45:11 +01:00
if ( ! current_user_can ( 'upload_files' ) )
$media_buttons = false ;
2008-10-31 17:52:55 +01:00
$richedit = user_can_richedit ();
$rows = " rows=' $rows ' " ;
2008-12-09 19:03:31 +01:00
2008-10-31 17:52:55 +01:00
if ( $richedit || $media_buttons ) { ?>
2008-02-18 18:11:12 +01:00
< div id = " editor-toolbar " >
2008-10-31 17:52:55 +01:00
< ? php if ( $richedit ) {
2008-02-18 18:11:12 +01:00
$wp_default_editor = wp_default_editor (); ?>
< div class = " zerosize " >< input accesskey = " e " type = " button " onclick = " switchEditors.go('<?php echo $id ; ?>') " /></ div >
2008-09-28 16:21:00 +02:00
< ? php if ( 'html' == $wp_default_editor ) {
2008-02-18 18:11:12 +01:00
add_filter ( 'the_editor_content' , 'wp_htmledit_pre' ); ?>
2008-09-28 16:21:00 +02:00
< a id = " edButtonHTML " class = " active " onclick = " switchEditors.go('<?php echo $id ; ?>', 'html'); " >< ? php _e ( 'HTML' ); ?> </a>
< a id = " edButtonPreview " onclick = " switchEditors.go('<?php echo $id ; ?>', 'tinymce'); " >< ? php _e ( 'Visual' ); ?> </a>
< ? php } else {
add_filter ( 'the_editor_content' , 'wp_richedit_pre' ); ?>
< a id = " edButtonHTML " onclick = " switchEditors.go('<?php echo $id ; ?>', 'html'); " >< ? php _e ( 'HTML' ); ?> </a>
< a id = " edButtonPreview " class = " active " onclick = " switchEditors.go('<?php echo $id ; ?>', 'tinymce'); " >< ? php _e ( 'Visual' ); ?> </a>
2008-10-31 17:52:55 +01:00
< ? php }
}
2008-03-02 21:17:30 +01:00
2008-10-31 17:52:55 +01:00
if ( $media_buttons ) { ?>
< div id = " media-buttons " class = " hide-if-no-js " >
< ? php do_action ( 'media_buttons' ); ?>
</ div >
< ? php } ?>
2006-09-22 09:04:41 +02:00
</ div >
2008-10-31 17:52:55 +01:00
< ? php } ?>
2008-01-06 20:01:32 +01:00
2006-09-22 09:04:41 +02:00
< div id = " quicktags " >
< ? php wp_print_scripts ( 'quicktags' ); ?>
< script type = " text/javascript " > edToolbar () </ script >
</ div >
2008-01-06 20:01:32 +01:00
2008-08-24 08:56:22 +02: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-08 01:17:59 +02:00
$the_editor_content = apply_filters ( 'the_editor_content' , $content );
printf ( $the_editor , $the_editor_content );
?>
2008-08-24 08:56:22 +02:00
< script type = " text/javascript " >
2009-01-12 14:43:17 +01:00
/* <![CDATA[ */
2008-08-24 08:56:22 +02:00
edCanvas = document . getElementById ( '<?php echo $id; ?>' );
2009-01-12 14:43:17 +01:00
/* ]]> */
2008-08-24 08:56:22 +02:00
</ script >
< ? php
2006-06-08 01:17:59 +02:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Retrieve the contents of the search WordPress query variable .
2008-09-05 21:19:01 +02:00
*
* @ since 2.3 . 0
*
2008-09-05 23:47:53 +02:00
* @ return string
2008-09-05 21:19:01 +02:00
*/
2007-05-24 05:37:10 +02:00
function get_search_query () {
return apply_filters ( 'get_search_query' , stripslashes ( get_query_var ( 's' ) ) );
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the contents of the search query variable .
2008-12-09 19:03:31 +01:00
*
2008-09-06 08:38:26 +02:00
* The search query string is passed through { @ link attribute_escape ()}
* to ensure that it is safe for placing in an html attribute .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ uses attribute_escape
2008-09-05 21:19:01 +02:00
* @ since 2.1 . 0
*/
2006-09-07 19:37:26 +02:00
function the_search_query () {
2007-05-24 05:37:10 +02:00
echo attribute_escape ( apply_filters ( 'the_search_query' , get_search_query () ) );
2006-09-07 19:37:26 +02:00
}
2008-09-05 21:19:01 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the language attributes for the html tag .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* Builds up a set of html attributes containing the text direction and language
* information for the page .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*
2008-09-05 23:47:53 +02:00
* @ param string $doctype The type of html document ( xhtml | html ) .
2008-09-05 21:19:01 +02:00
*/
2007-12-19 18:44:02 +01:00
function language_attributes ( $doctype = 'html' ) {
$attributes = array ();
2006-09-24 22:16:13 +02:00
$output = '' ;
2008-02-05 07:47:27 +01:00
2006-09-24 22:16:13 +02:00
if ( $dir = get_bloginfo ( 'text_direction' ) )
2007-12-19 18:44:02 +01:00
$attributes [] = " dir= \" $dir\ " " ;
2008-02-05 07:47:27 +01:00
2006-09-24 22:16:13 +02:00
if ( $lang = get_bloginfo ( 'language' ) ) {
2008-12-30 19:35:31 +01:00
if ( get_option ( 'html_type' ) == 'text/html' || $doctype == 'html' )
2007-12-19 18:44:02 +01:00
$attributes [] = " lang= \" $lang\ " " ;
2008-02-05 07:47:27 +01:00
2007-12-19 18:44:02 +01:00
if ( get_option ( 'html_type' ) != 'text/html' || $doctype == 'xhtml' )
$attributes [] = " xml:lang= \" $lang\ " " ;
}
2008-02-05 07:47:27 +01:00
2007-12-19 18:44:02 +01:00
$output = implode ( ' ' , $attributes );
$output = apply_filters ( 'language_attributes' , $output );
2006-09-24 22:16:13 +02:00
echo $output ;
}
2006-10-03 09:16:49 +02:00
2008-09-05 21:19:01 +02:00
/**
2008-09-12 06:31:41 +02:00
* Retrieve paginated link for archive post pages .
*
* Technically , the function can be used to create paginated link list for any
* area . The 'base' argument is used to reference the url , which will be used to
* create the paginated links . The 'format' argument is then used for replacing
* the page number . It is however , most likely and by default , to be used on the
* archive post pages .
*
* The 'type' argument controls format of the returned value . The default is
* 'plain' , which is just a string with the links separated by a newline
* character . The other possible values are either 'array' or 'list' . The
* 'array' value will return an array of the paginated link list to offer full
* control of display . The 'list' value will place all of the paginated links in
* an unordered HTML list .
*
* The 'total' argument is the total amount of pages and is an integer . The
* 'current' argument is the current page number and is also an integer .
*
* An example of the 'base' argument is " http://example.com/all_posts.php%_% "
* and the '%_%' is required . The '%_%' will be replaced by the contents of in
* the 'format' argument . An example for the 'format' argument is " ?page=%#% "
* and the '%#%' is also required . The '%#%' will be replaced with the page
* number .
*
* You can include the previous and next links in the list by setting the
* 'prev_next' argument to true , which it is by default . You can set the
* previous text , by using the 'prev_text' argument . You can set the next text
* by setting the 'next_text' argument .
*
* If the 'show_all' argument is set to true , then it will show all of the pages
* instead of a short list of the pages near the current page . By default , the
* 'show_all' is set to false and controlled by the 'end_size' and 'mid_size'
* arguments . The 'end_size' argument is how many numbers on either the start
* and the end list edges , by default is 1. The 'mid_size' argument is how many
* numbers to either side of current page , but not including current page .
*
* It is possible to add query vars to the link by using the 'add_args' argument
* and see { @ link add_query_arg ()} for more information .
2008-09-05 21:19:01 +02:00
*
* @ since 2.1 . 0
*
2008-09-12 06:31:41 +02:00
* @ param string | array $args Optional . Override defaults .
* @ return array | string String of page links or array of page links .
2008-09-05 21:19:01 +02:00
*/
2007-06-15 00:46:59 +02:00
function paginate_links ( $args = '' ) {
2007-09-04 01:32:58 +02:00
$defaults = array (
2007-06-15 00:46:59 +02: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 »' ),
2008-09-12 06:31:41 +02:00
'end_size' => 1 ,
'mid_size' => 2 ,
2007-06-15 00:46:59 +02:00
'type' => 'plain' ,
2008-10-08 00:41:51 +02:00
'add_args' => false , // array of query args to add
'add_fragment' => ''
2007-06-15 00:46:59 +02:00
);
$args = wp_parse_args ( $args , $defaults );
extract ( $args , EXTR_SKIP );
2006-10-03 09:16:49 +02:00
// Who knows what else people pass in $args
2008-09-12 06:31:41 +02:00
$total = ( int ) $total ;
2006-10-03 17:40:26 +02:00
if ( $total < 2 )
return ;
2006-10-03 09:16:49 +02: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 17:40:26 +02:00
$link = str_replace ( '%_%' , 2 == $current ? '' : $format , $base );
$link = str_replace ( '%#%' , $current - 1 , $link );
2006-10-03 09:16:49 +02:00
if ( $add_args )
$link = add_query_arg ( $add_args , $link );
2008-10-08 00:41:51 +02:00
$link .= $add_fragment ;
2007-03-17 09:46:59 +01:00
$page_links [] = " <a class='prev page-numbers' href=' " . clean_url ( $link ) . " '> $prev_text </a> " ;
2006-10-03 09:16:49 +02:00
endif ;
for ( $n = 1 ; $n <= $total ; $n ++ ) :
2008-11-18 02:10:40 +01:00
$n_display = number_format_i18n ( $n );
2006-10-03 09:16:49 +02:00
if ( $n == $current ) :
2008-11-18 02:10:40 +01:00
$page_links [] = " <span class='page-numbers current'> $n_display </span> " ;
2006-10-03 09:16:49 +02:00
$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 17:40:26 +02:00
$link = str_replace ( '%_%' , 1 == $n ? '' : $format , $base );
$link = str_replace ( '%#%' , $n , $link );
2006-10-03 09:16:49 +02:00
if ( $add_args )
$link = add_query_arg ( $add_args , $link );
2008-10-08 00:41:51 +02:00
$link .= $add_fragment ;
2008-11-18 02:10:40 +01:00
$page_links [] = " <a class='page-numbers' href=' " . clean_url ( $link ) . " '> $n_display </a> " ;
2006-10-03 09:16:49 +02: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 17:40:26 +02:00
$link = str_replace ( '%_%' , $format , $base );
$link = str_replace ( '%#%' , $current + 1 , $link );
2006-10-03 09:16:49 +02:00
if ( $add_args )
$link = add_query_arg ( $add_args , $link );
2008-10-08 00:41:51 +02:00
$link .= $add_fragment ;
2007-03-17 09:46:59 +01:00
$page_links [] = " <a class='next page-numbers' href=' " . clean_url ( $link ) . " '> $next_text </a> " ;
2006-10-03 09:16:49 +02: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-29 01:23:38 +02:00
2008-09-05 23:47:53 +02:00
/**
2008-09-06 08:38:26 +02:00
* Registers an admin colour scheme css file .
2008-09-05 23:47:53 +02:00
*
2008-09-06 08:38:26 +02:00
* Allows a plugin to register a new admin colour scheme . For example :
2008-09-05 23:47:53 +02:00
* < code >
2008-09-06 08:38:26 +02:00
* wp_admin_css_color ( 'classic' , __ ( 'Classic' ), admin_url ( " css/colors-classic.css " ),
* array ( '#07273E' , '#14568A' , '#D54E21' , '#2683AE' ));
2008-09-05 23:47:53 +02:00
* </ code >
*
2008-09-06 08:38:26 +02:00
* @ since 2.5 . 0
*
2008-09-05 23:47:53 +02:00
* @ 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 .
*/
2008-03-11 22:06:03 +01: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 23:23:22 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the URL of a WordPress admin CSS file .
2008-05-25 23:23:22 +02:00
*
* @ see WP_Styles :: _css_href and its style_loader_src filter .
*
2008-09-05 21:19:01 +02:00
* @ since 2.3 . 0
*
2008-05-25 23:23:22 +02:00
* @ param string $file file relative to wp - admin / without its " .css " extension .
*/
2007-08-29 01:23:38 +02:00
function wp_admin_css_uri ( $file = 'wp-admin' ) {
2008-03-11 22:06:03 +01:00
if ( defined ( 'WP_INSTALLING' ) ) {
$_file = " ./ $file .css " ;
2007-09-03 22:20:18 +02:00
} else {
2008-05-27 19:46:01 +02:00
$_file = admin_url ( " $file .css " );
2007-09-04 01:32:58 +02:00
}
2008-03-11 22:06:03 +01:00
$_file = add_query_arg ( 'version' , get_bloginfo ( 'version' ), $_file );
2007-08-29 01:23:38 +02:00
return apply_filters ( 'wp_admin_css_uri' , $_file , $file );
}
2008-05-25 23:23:22 +02:00
/**
2008-09-05 23:47:53 +02:00
* Enqueues or directly prints a stylesheet link to the specified CSS file .
2008-05-25 23:23:22 +02:00
*
2008-09-06 08:38:26 +02: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 .
2008-05-25 23:23:22 +02:00
*
2008-09-06 08:38:26 +02:00
* 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 .
2008-05-25 23:23:22 +02:00
*
* @ package WordPress
2008-09-06 08:38:26 +02:00
* @ since 2.3 . 0
2008-05-25 23:23:22 +02:00
* @ 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 02:06:41 +02:00
function wp_admin_css ( $file = 'wp-admin' , $force_echo = false ) {
2008-05-22 01:24:23 +02:00
global $wp_styles ;
if ( ! is_a ( $wp_styles , 'WP_Styles' ) )
$wp_styles = new WP_Styles ();
2008-05-25 23:23:22 +02:00
// For backward compatibility
2008-05-22 01:24:23 +02:00
$handle = 0 === strpos ( $file , 'css/' ) ? substr ( $file , 4 ) : $file ;
2008-03-11 22:06:03 +01:00
2008-05-22 01:24:23 +02:00
if ( $wp_styles -> query ( $handle ) ) {
2008-05-22 02:06:41 +02:00
if ( $force_echo || did_action ( 'wp_print_styles' ) ) // we already printed the style queue. Print this one immediately
2008-05-22 01:24:23 +02:00
wp_print_styles ( $handle );
else // Add to style queue
wp_enqueue_style ( $handle );
return ;
2007-08-29 01:23:38 +02:00
}
2008-05-22 01:24:23 +02: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-29 01:23:38 +02:00
}
2008-05-22 17:27:28 +02:00
/**
2008-12-09 19:03:31 +01:00
* Enqueues the default ThickBox js and css .
*
2008-09-06 08:38:26 +02: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' ) to ensure it is loaded after .
*
* @ since 2.5 . 0
2008-05-22 17:27:28 +02:00
*/
2008-05-20 19:19:33 +02:00
function add_thickbox () {
wp_enqueue_script ( 'thickbox' );
2008-05-22 17:27:28 +02:00
wp_enqueue_style ( 'thickbox' );
2008-05-20 19:19:33 +02:00
}
2007-10-06 08:55:24 +02:00
/**
2008-09-06 08:38:26 +02:00
* Display the XHTML generator that is generated on the wp_head hook .
*
* @ since 2.5 . 0
2007-10-06 08:55:24 +02:00
*/
2008-09-05 21:19:01 +02:00
function wp_generator () {
2007-10-06 08:55:24 +02:00
the_generator ( apply_filters ( 'wp_generator_type' , 'xhtml' ) );
}
/**
2008-09-06 08:38:26 +02:00
* Display the generator XML or Comment for RSS , ATOM , etc .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02: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 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* @ since 2.5 . 0
* @ uses apply_filters () Calls 'the_generator' hook .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ param string $type The type of generator to output - ( html | xhtml | atom | rss2 | rdf | comment | export ) .
2007-10-06 08:55:24 +02:00
*/
2008-09-05 21:19:01 +02:00
function the_generator ( $type ) {
echo apply_filters ( 'the_generator' , get_the_generator ( $type ), $type ) . " \n " ;
2007-10-06 08:55:24 +02:00
}
/**
2008-09-05 23:47:53 +02:00
* Creates the generator XML or Comment for RSS , ATOM , etc .
2008-09-05 21:19:01 +02:00
*
2008-09-06 08:38:26 +02: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 21:19:01 +02:00
*
2008-09-06 08:38:26 +02:00
* @ since 2.5 . 0
* @ uses apply_filters () Calls 'get_the_generator_$type' hook .
2008-09-05 21:19:01 +02:00
*
2008-09-05 23:47:53 +02:00
* @ param string $type The type of generator to return - ( html | xhtml | atom | rss2 | rdf | comment | export ) .
2008-09-06 08:38:26 +02:00
* @ return string The HTML content for the generator .
2007-10-06 08:55:24 +02:00
*/
2008-09-05 21:19:01 +02:00
function get_the_generator ( $type ) {
2007-10-06 08:55:24 +02:00
switch ( $type ) {
case 'html' :
2008-03-28 20:05:22 +01:00
$gen = '<meta name="generator" content="WordPress ' . get_bloginfo ( 'version' ) . '">' . " \n " ;
2007-10-06 08:55:24 +02:00
break ;
case 'xhtml' :
2008-03-28 20:05:22 +01:00
$gen = '<meta name="generator" content="WordPress ' . get_bloginfo ( 'version' ) . '" />' . " \n " ;
2007-10-06 08:55:24 +02: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 20:05:22 +01:00
$gen = '<!-- generator="WordPress/' . get_bloginfo_rss ( 'version' ) . '" created="' . date ( 'Y-m-d H:i' ) . '"-->' ;
2007-10-06 08:55:24 +02:00
break ;
}
return apply_filters ( " get_the_generator_ { $type } " , $gen , $type );
}
2008-09-05 21:19:01 +02:00
2005-11-11 01:48:31 +01:00
?>