diff --git a/wp-includes/general-template.php b/wp-includes/general-template.php
index c05aed6ef..03a896333 100644
--- a/wp-includes/general-template.php
+++ b/wp-includes/general-template.php
@@ -1,7 +1,20 @@
' . __('Log in') . '';
@@ -53,7 +87,17 @@ function wp_loginout() {
echo apply_filters('loginout', $link);
}
-
+/**
+ * wp_register() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.0
+ * @uses apply_filters()
+ *
+ * @param unknown_type $before
+ * @param unknown_type $after
+ */
function wp_register( $before = '
', $after = '' ) {
if ( ! is_user_logged_in() ) {
@@ -68,21 +112,48 @@ function wp_register( $before = '', $after = '' ) {
echo apply_filters('register', $link);
}
-
+/**
+ * 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.
+ */
function wp_meta() {
do_action('wp_meta');
}
-
+/**
+ * bloginfo() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $show
+ */
function bloginfo($show='') {
echo get_bloginfo($show, 'display');
}
/**
+ * get_bloginfo() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
* Note: some of these values are DEPRECATED. Meaning they could be
* taken out at any time and shouldn't be relied upon. Options
* without "// DEPRECATED" are the preferred and recommended ways
* to get the information.
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $show
+ * @param unknown_type $filter
+ * @return unknown
*/
function get_bloginfo($show = '', $filter = 'raw') {
@@ -173,7 +244,17 @@ function get_bloginfo($show = '', $filter = 'raw') {
return $output;
}
-
+/**
+ * wp_title() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.0.0
+ *
+ * @param unknown_type $sep
+ * @param unknown_type $display
+ * @return unknown
+ */
function wp_title($sep = '»', $display = true, $seplocation = '') {
global $wpdb, $wp_locale, $wp_query;
@@ -279,7 +360,18 @@ function wp_title($sep = '»', $display = true, $seplocation = '') {
}
-
+/**
+ * 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
+ */
function single_post_title($prefix = '', $display = true) {
global $wpdb;
$p = get_query_var('p');
@@ -298,7 +390,17 @@ function single_post_title($prefix = '', $display = true) {
}
}
-
+/**
+ * single_cat_title() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $prefix
+ * @param unknown_type $display
+ * @return unknown
+ */
function single_cat_title($prefix = '', $display = true ) {
$cat = intval( get_query_var('cat') );
if ( !empty($cat) && !(strtoupper($cat) == 'ALL') ) {
@@ -314,7 +416,17 @@ function single_cat_title($prefix = '', $display = true ) {
}
}
-
+/**
+ * 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
+ */
function single_tag_title($prefix = '', $display = true ) {
if ( !is_tag() )
return;
@@ -335,7 +447,17 @@ function single_tag_title($prefix = '', $display = true ) {
}
}
-
+/**
+ * single_month_title() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $prefix
+ * @param unknown_type $display
+ * @return unknown
+ */
function single_month_title($prefix = '', $display = true ) {
global $wp_locale;
@@ -361,8 +483,22 @@ function single_month_title($prefix = '', $display = true ) {
echo $result;
}
-
-/* link navigation hack by Orien http://icecode.com/ */
+/**
+ * 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
+ */
function get_archives_link($url, $text, $format = 'html', $before = '', $after = '') {
$text = wptexturize($text);
$title_text = attribute_escape($text);
@@ -382,7 +518,15 @@ function get_archives_link($url, $text, $format = 'html', $before = '', $after =
return $link_html;
}
-
+/**
+ * wp_get_archives() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.2.0
+ *
+ * @param unknown_type $args
+ */
function wp_get_archives($args = '') {
global $wpdb, $wp_locale;
@@ -548,14 +692,31 @@ function wp_get_archives($args = '') {
}
}
-
-// Used in get_calendar
+/**
+ * calendar_week_mod() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.0
+ * @usedby get_calendar()
+ *
+ * @param unknown_type $num
+ * @return unknown
+ */
function calendar_week_mod($num) {
$base = 7;
return ($num - $base*floor($num/$base));
}
-
+/**
+ * get_calendar() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.0.0
+ *
+ * @param unknown_type $initial
+ */
function get_calendar($initial = true) {
global $wpdb, $m, $monthnum, $year, $wp_locale, $posts;
@@ -748,6 +909,11 @@ function get_calendar($initial = true) {
wp_cache_set( 'get_calendar', $cache, 'calendar' );
}
+/**
+ * delete_get_calendar_cache() - {@internal Missing Short Description}}
+ *
+ * @since 2.1.0
+ */
function delete_get_calendar_cache() {
wp_cache_delete( 'get_calendar', 'calendar' );
}
@@ -757,7 +923,16 @@ 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' );
-
+/**
+ * allowed_tags() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.0.1
+ * @uses $allowedtags
+ *
+ * @return unknown
+ */
function allowed_tags() {
global $allowedtags;
$allowed = '';
@@ -773,17 +948,35 @@ function allowed_tags() {
return htmlentities($allowed);
}
-
/***** Date/Time tags *****/
-
+/**
+ * the_date_xml() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.0.0
+ *
+ */
function the_date_xml() {
global $post;
echo mysql2date('Y-m-d', $post->post_date);
//echo ""+$post->post_date;
}
-
+/**
+ * the_date() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $d
+ * @param unknown_type $before
+ * @param unknown_type $after
+ * @param unknown_type $echo
+ * @return unknown
+ */
function the_date($d='', $before='', $after='', $echo = true) {
global $post, $day, $previousday;
$the_date = '';
@@ -803,12 +996,29 @@ function the_date($d='', $before='', $after='', $echo = true) {
return $the_date;
}
-
+/**
+ * the_modified_date() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ *
+ * @param unknown_type $d
+ */
function the_modified_date($d = '') {
echo apply_filters('the_modified_date', get_the_modified_date($d), $d);
}
-
+/**
+ * get_the_modified_date() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ *
+ * @param unknown_type $d
+ * @return unknown
+ */
function get_the_modified_date($d = '') {
if ( '' == $d )
$the_time = get_post_modified_time(get_option('date_format'));
@@ -817,12 +1027,29 @@ function get_the_modified_date($d = '') {
return apply_filters('get_the_modified_date', $the_time, $d);
}
-
+/**
+ * the_time() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $d
+ */
function the_time( $d = '' ) {
echo apply_filters('the_time', get_the_time( $d ), $d);
}
-
+/**
+ * get_the_time() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.0
+ *
+ * @param unknown_type $d
+ * @return unknown
+ */
function get_the_time( $d = '' ) {
if ( '' == $d )
$the_time = get_post_time(get_option('time_format'));
@@ -831,7 +1058,17 @@ function get_the_time( $d = '' ) {
return apply_filters('get_the_time', $the_time, $d);
}
-
+/**
+ * get_post_time() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.0
+ *
+ * @param unknown_type $d
+ * @param unknown_type $gmt
+ * @return unknown
+ */
function get_post_time( $d = 'U', $gmt = false ) { // returns timestamp
global $post;
if ( $gmt )
@@ -843,12 +1080,29 @@ function get_post_time( $d = 'U', $gmt = false ) { // returns timestamp
return apply_filters('get_post_time', $time, $d, $gmt);
}
-
+/**
+ * the_modified_time() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ *
+ * @param unknown_type $d
+ */
function the_modified_time($d = '') {
echo apply_filters('the_modified_time', get_the_modified_time($d), $d);
}
-
+/**
+ * get_the_modified_time() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ *
+ * @param unknown_type $d
+ * @return unknown
+ */
function get_the_modified_time($d = '') {
if ( '' == $d )
$the_time = get_post_modified_time(get_option('time_format'));
@@ -857,7 +1111,17 @@ function get_the_modified_time($d = '') {
return apply_filters('get_the_modified_time', $the_time, $d);
}
-
+/**
+ * get_post_modified_time() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ *
+ * @param unknown_type $d
+ * @param unknown_type $gmt
+ * @return unknown
+ */
function get_post_modified_time( $d = 'U', $gmt = false ) { // returns timestamp
global $post;
@@ -870,7 +1134,15 @@ function get_post_modified_time( $d = 'U', $gmt = false ) { // returns timestamp
return apply_filters('get_the_modified_time', $time, $d, $gmt);
}
-
+/**
+ * the_weekday() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ * @uses $wp_locale
+ * @uses $post
+ */
function the_weekday() {
global $wp_locale, $post;
$the_weekday = $wp_locale->get_weekday(mysql2date('w', $post->post_date));
@@ -878,7 +1150,16 @@ function the_weekday() {
echo $the_weekday;
}
-
+/**
+ * the_weekday_date() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 0.71
+ *
+ * @param unknown_type $before
+ * @param unknown_type $after
+ */
function the_weekday_date($before='',$after='') {
global $wp_locale, $post, $day, $previousweekday;
$the_weekday_date = '';
@@ -892,29 +1173,77 @@ function the_weekday_date($before='',$after='') {
echo $the_weekday_date;
}
+/**
+ * wp_head() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.2.0
+ * @uses do_action()
+ */
function wp_head() {
do_action('wp_head');
}
+/**
+ * wp_footer() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 1.5.1
+ * @uses do_action()
+ */
function wp_footer() {
do_action('wp_footer');
}
+/**
+ * rsd_link() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ *
+ */
function rsd_link() {
echo '\n";
}
+/**
+ * wlwmanifest_link() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.3.1
+ *
+ */
function wlwmanifest_link() {
echo ' ' . "\n";
}
+/**
+ * noindex() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ */
function noindex() {
// If the blog is not public, tell robots to go away.
if ( '0' == get_option('blog_public') )
echo "\n";
}
+/**
+ * rich_edit_exists() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.1.0
+ *
+ * @return unknown
+ */
function rich_edit_exists() {
global $wp_rich_edit_exists;
if ( !isset($wp_rich_edit_exists) )
@@ -922,6 +1251,15 @@ function rich_edit_exists() {
return $wp_rich_edit_exists;
}
+/**
+ * user_can_richedit() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.0.0
+ *
+ * @return unknown
+ */
function user_can_richedit() {
global $wp_rich_edit, $pagenow;
@@ -939,6 +1277,15 @@ function user_can_richedit() {
return apply_filters('user_can_richedit', $wp_rich_edit);
}
+/**
+ * wp_default_editor() - {@internal Missing Short Description}}
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.5.0
+ *
+ * @return string Either 'tinymce', or 'html', or 'test'
+ */
function wp_default_editor() {
$r = user_can_richedit() ? 'tinymce' : 'html'; // defaults
if ( $user = wp_get_current_user() ) { // look for cookie
@@ -948,6 +1295,17 @@ function wp_default_editor() {
return apply_filters( 'wp_default_editor', $r ); // filter
}
+/**
+ * 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
+ */
function the_editor($content, $id = 'content', $prev_id = 'title', $media_buttons = true, $tab_index = 2) {
$rows = get_option('default_post_edit_rows');
if (($rows < 3) || ($rows > 100))
@@ -1014,14 +1372,40 @@ function the_editor($content, $id = 'content', $prev_id = 'title', $media_button
'%_%', // http://example.com/all_posts.php%_% : %_% is replaced by format (below)
@@ -1136,6 +1530,9 @@ function wp_admin_css_color($key, $name, $url, $colors = array()) {
*
* @see WP_Styles::_css_href and its style_loader_src filter.
*
+ * @since 2.3.0
+ *
+ *
* @param string $file file relative to wp-admin/ without its ".css" extension.
*/
@@ -1193,7 +1590,13 @@ function wp_admin_css( $file = 'wp-admin', $force_echo = false ) {
}
/**
- * Enqueues the default ThickBox js and css.
+ * wp_generator() - Outputs the XHTML generator that is generated on the wp_head hook.
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.5.0
+ * @uses apply_filters()
+ * Enqueues the default ThickBox js and css.
* 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.
@@ -1206,24 +1609,35 @@ function add_thickbox() {
/**
* Outputs the XHTML generator that is generated on the wp_head hook.
*/
-function wp_generator()
-{
+function wp_generator() {
the_generator( apply_filters( 'wp_generator_type', 'xhtml' ) );
}
/**
- * Outputs the generator XML or Comment for RSS, ATOM, etc.
- * @param {String} $type The type of generator to return.
+ * the_generator() - Outputs the generator XML or Comment for RSS, ATOM, etc.
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.5
+ * @uses apply_filters()
+ *
+ * @param string $type The type of generator to return.
*/
-function the_generator ( $type ) {
- echo apply_filters('the_generator',get_the_generator($type),$type) . "\n";
+function the_generator( $type ) {
+ echo apply_filters('the_generator', get_the_generator($type), $type) . "\n";
}
/**
- * Creates the generator XML or Comment for RSS, ATOM, etc.
- * @param {String} $type The type of generator to return.
+ * get_the_generator() - Creates the generator XML or Comment for RSS, ATOM, etc.
+ *
+ * {@internal Missing Long Description}}
+ *
+ * @since 2.5
+ * @uses apply_filters()
+ *
+ * @param string $type The type of generator to return.
*/
-function get_the_generator ( $type ) {
+function get_the_generator( $type ) {
switch ($type) {
case 'html':
$gen = '' . "\n";
@@ -1249,4 +1663,5 @@ function get_the_generator ( $type ) {
}
return apply_filters( "get_the_generator_{$type}", $gen, $type );
}
+
?>