2007-05-25 03:16:21 -04:00
< ? php
2008-10-01 21:03:26 -04:00
/**
* Template WordPress Administration API .
*
* A Big Mess . Also some neat functions that are nicely written .
*
* @ package WordPress
* @ subpackage Administration
*/
2007-05-25 03:16:21 -04:00
//
2008-04-18 13:41:10 -04:00
// Category Checklists
2007-05-25 03:16:21 -04:00
//
2008-10-01 21:03:26 -04:00
/**
2012-04-04 13:32:03 -04:00
* Walker to output an unordered list of category checkbox < input > elements .
2008-10-01 21:03:26 -04:00
*
2012-04-04 13:32:03 -04:00
* @ see Walker
* @ see wp_category_checklist ()
* @ see wp_terms_checklist ()
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 1
2008-10-01 21:03:26 -04:00
*/
2010-08-11 17:54:51 -04:00
class Walker_Category_Checklist extends Walker {
var $tree_type = 'category' ;
var $db_fields = array ( 'parent' => 'parent' , 'id' => 'term_id' ); //TODO: decouple this
2008-06-14 20:45:01 -04:00
2012-01-04 18:03:46 -05:00
function start_lvl ( & $output , $depth = 0 , $args = array () ) {
2010-08-11 17:54:51 -04:00
$indent = str_repeat ( " \t " , $depth );
$output .= " $indent <ul class='children'> \n " ;
2008-06-14 20:45:01 -04:00
}
2012-01-04 18:03:46 -05:00
function end_lvl ( & $output , $depth = 0 , $args = array () ) {
2010-08-11 17:54:51 -04:00
$indent = str_repeat ( " \t " , $depth );
$output .= " $indent </ul> \n " ;
}
2008-02-05 01:47:27 -05:00
2012-01-04 18:03:46 -05:00
function start_el ( & $output , $category , $depth , $args , $id = 0 ) {
2010-08-11 17:54:51 -04:00
extract ( $args );
if ( empty ( $taxonomy ) )
$taxonomy = 'category' ;
2008-06-14 20:45:01 -04:00
2010-08-11 17:54:51 -04:00
if ( $taxonomy == 'category' )
$name = 'post_category' ;
else
$name = 'tax_input[' . $taxonomy . ']' ;
2008-02-05 01:47:27 -05:00
2010-08-11 17:54:51 -04:00
$class = in_array ( $category -> term_id , $popular_cats ) ? ' class="popular-category"' : '' ;
$output .= " \n <li id=' { $taxonomy } - { $category -> term_id } ' $class > " . '<label class="selectit"><input value="' . $category -> term_id . '" type="checkbox" name="' . $name . '[]" id="in-' . $taxonomy . '-' . $category -> term_id . '"' . checked ( in_array ( $category -> term_id , $selected_cats ), true , false ) . disabled ( empty ( $args [ 'disabled' ] ), false , false ) . ' /> ' . esc_html ( apply_filters ( 'the_category' , $category -> name )) . '</label>' ;
2007-12-14 01:20:42 -05:00
}
2008-08-09 01:36:14 -04:00
2012-01-04 18:03:46 -05:00
function end_el ( & $output , $category , $depth = 0 , $args = array () ) {
2010-08-11 17:54:51 -04:00
$output .= " </li> \n " ;
2008-07-12 11:40:57 -04:00
}
2008-06-14 20:45:01 -04:00
}
2010-05-24 17:28:07 -04:00
/**
2012-04-04 13:32:03 -04:00
* Output an unordered list of checkbox < input > elements labelled
* with category names .
2008-10-01 21:03:26 -04:00
*
2012-04-04 13:32:03 -04:00
* @ see wp_terms_checklist ()
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 1
2008-10-01 21:03:26 -04:00
*
2012-04-04 13:32:03 -04:00
* @ param int $post_id Mark categories associated with this post as checked . $selected_cats must not be an array .
* @ param int $descendants_and_self ID of the category to output along with its descendents .
* @ param bool | array $selected_cats List of categories to mark as checked .
* @ param bool | array $popular_cats Override the list of categories that receive the " popular-category " class .
* @ param object $walker Walker object to use to build the output .
* @ param bool $checked_ontop Move checked items out of the hierarchy and to the top of the list .
2008-10-01 21:03:26 -04:00
*/
2010-08-11 17:54:51 -04:00
function wp_category_checklist ( $post_id = 0 , $descendants_and_self = 0 , $selected_cats = false , $popular_cats = false , $walker = null , $checked_ontop = true ) {
2012-04-04 13:32:03 -04:00
wp_terms_checklist ( $post_id , array (
'taxonomy' => 'category' ,
'descendants_and_self' => $descendants_and_self ,
'selected_cats' => $selected_cats ,
'popular_cats' => $popular_cats ,
'walker' => $walker ,
'checked_ontop' => $checked_ontop
) );
2010-08-11 17:54:51 -04:00
}
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
/**
2012-04-04 13:32:03 -04:00
* Output an unordered list of checkbox < input > elements labelled
* with term names . Taxonomy independent version of wp_category_checklist () .
2010-08-11 17:54:51 -04:00
*
2010-12-01 14:24:38 -05:00
* @ since 3.0 . 0
*
2010-08-11 17:54:51 -04:00
* @ param int $post_id
* @ param array $args
*/
function wp_terms_checklist ( $post_id = 0 , $args = array ()) {
$defaults = array (
'descendants_and_self' => 0 ,
'selected_cats' => false ,
'popular_cats' => false ,
'walker' => null ,
'taxonomy' => 'category' ,
'checked_ontop' => true
);
2012-05-02 21:15:18 -04:00
$args = apply_filters ( 'wp_terms_checklist_args' , $args , $post_id );
2010-08-11 17:54:51 -04:00
extract ( wp_parse_args ( $args , $defaults ), EXTR_SKIP );
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
if ( empty ( $walker ) || ! is_a ( $walker , 'Walker' ) )
$walker = new Walker_Category_Checklist ;
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
$descendants_and_self = ( int ) $descendants_and_self ;
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
$args = array ( 'taxonomy' => $taxonomy );
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
$tax = get_taxonomy ( $taxonomy );
$args [ 'disabled' ] = ! current_user_can ( $tax -> cap -> assign_terms );
2008-06-14 20:45:01 -04:00
2010-08-11 17:54:51 -04:00
if ( is_array ( $selected_cats ) )
$args [ 'selected_cats' ] = $selected_cats ;
elseif ( $post_id )
$args [ 'selected_cats' ] = wp_get_object_terms ( $post_id , $taxonomy , array_merge ( $args , array ( 'fields' => 'ids' )));
else
$args [ 'selected_cats' ] = array ();
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
if ( is_array ( $popular_cats ) )
$args [ 'popular_cats' ] = $popular_cats ;
else
$args [ 'popular_cats' ] = get_terms ( $taxonomy , array ( 'fields' => 'ids' , 'orderby' => 'count' , 'order' => 'DESC' , 'number' => 10 , 'hierarchical' => false ) );
2008-06-14 20:45:01 -04:00
2010-08-11 17:54:51 -04:00
if ( $descendants_and_self ) {
$categories = ( array ) get_terms ( $taxonomy , array ( 'child_of' => $descendants_and_self , 'hierarchical' => 0 , 'hide_empty' => 0 ) );
$self = get_term ( $descendants_and_self , $taxonomy );
array_unshift ( $categories , $self );
} else {
$categories = ( array ) get_terms ( $taxonomy , array ( 'get' => 'all' ));
2008-06-14 20:45:01 -04:00
}
2008-08-09 01:36:14 -04:00
2010-08-11 17:54:51 -04:00
if ( $checked_ontop ) {
// Post process $categories rather than adding an exclude to the get_terms() query to keep the query the same across all posts (for any query cache)
$checked_categories = array ();
$keys = array_keys ( $categories );
foreach ( $keys as $k ) {
if ( in_array ( $categories [ $k ] -> term_id , $args [ 'selected_cats' ] ) ) {
$checked_categories [] = $categories [ $k ];
unset ( $categories [ $k ] );
}
}
// Put checked cats on top
echo call_user_func_array ( array ( & $walker , 'walk' ), array ( $checked_categories , 0 , $args ));
}
// Then the rest of them
echo call_user_func_array ( array ( & $walker , 'walk' ), array ( $categories , 0 , $args ));
2007-12-14 01:20:42 -05:00
}
2008-10-01 21:03:26 -04:00
/**
2012-04-04 13:32:03 -04:00
* Retrieve a list of the most popular terms from the specified taxonomy .
*
* If the $echo argument is true then the elements for a list of checkbox
* < input > elements labelled with the names of the selected terms is output .
* If the $post_ID global isn ' t empty then the terms associated with that
* post will be marked as checked .
2008-10-01 21:03:26 -04:00
*
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
2012-04-04 13:32:03 -04:00
* @ param string $taxonomy Taxonomy to retrieve terms from .
* @ param int $default Unused .
* @ param int $number Number of terms to retrieve . Defaults to 10.
* @ param bool $echo Optionally output the list as well . Defaults to true .
* @ return array List of popular term IDs .
2008-10-01 21:03:26 -04:00
*/
2010-08-11 17:54:51 -04:00
function wp_popular_terms_checklist ( $taxonomy , $default = 0 , $number = 10 , $echo = true ) {
global $post_ID ;
2009-02-01 04:45:24 -05:00
2010-08-11 17:54:51 -04:00
if ( $post_ID )
$checked_terms = wp_get_object_terms ( $post_ID , $taxonomy , array ( 'fields' => 'ids' ));
else
$checked_terms = array ();
2010-04-22 15:48:13 -04:00
2010-08-11 17:54:51 -04:00
$terms = get_terms ( $taxonomy , array ( 'orderby' => 'count' , 'order' => 'DESC' , 'number' => $number , 'hierarchical' => false ) );
2010-04-22 18:53:44 -04:00
2010-08-11 17:54:51 -04:00
$tax = get_taxonomy ( $taxonomy );
if ( ! current_user_can ( $tax -> cap -> assign_terms ) )
$disabled = 'disabled="disabled"' ;
else
$disabled = '' ;
2009-02-01 04:45:24 -05:00
2010-08-11 17:54:51 -04:00
$popular_ids = array ();
foreach ( ( array ) $terms as $term ) {
$popular_ids [] = $term -> term_id ;
if ( ! $echo ) // hack for AJAX use
continue ;
$id = " popular- $taxonomy - $term->term_id " ;
$checked = in_array ( $term -> term_id , $checked_terms ) ? 'checked="checked"' : '' ;
?>
2009-02-01 04:45:24 -05:00
2010-08-11 17:54:51 -04:00
< li id = " <?php echo $id ; ?> " class = " popular-category " >
< label class = " selectit " >
< input id = " in-<?php echo $id ; ?> " type = " checkbox " < ? php echo $checked ; ?> value="<?php echo (int) $term->term_id; ?>" <?php echo $disabled ?>/>
< ? php echo esc_html ( apply_filters ( 'the_category' , $term -> name ) ); ?>
</ label >
</ li >
2008-09-19 01:31:00 -04:00
2010-08-11 17:54:51 -04:00
< ? php
2007-05-25 03:16:21 -04:00
}
2010-08-11 17:54:51 -04:00
return $popular_ids ;
2007-05-25 03:16:21 -04:00
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 1
2008-10-01 21:03:26 -04:00
*
2010-08-11 17:54:51 -04:00
* @ param unknown_type $link_id
2008-10-01 21:03:26 -04:00
*/
2010-08-11 17:54:51 -04:00
function wp_link_category_checklist ( $link_id = 0 ) {
$default = 1 ;
2007-05-25 03:16:21 -04:00
2010-08-11 17:54:51 -04:00
if ( $link_id ) {
$checked_categories = wp_get_link_cats ( $link_id );
// No selected categories, strange
if ( ! count ( $checked_categories ) )
$checked_categories [] = $default ;
2009-01-23 17:26:40 -05:00
} else {
2010-08-11 17:54:51 -04:00
$checked_categories [] = $default ;
2009-01-23 17:26:40 -05:00
}
2008-03-02 15:17:30 -05:00
2010-08-11 17:54:51 -04:00
$categories = get_terms ( 'link_category' , array ( 'orderby' => 'name' , 'hide_empty' => 0 ) );
2008-09-28 13:48:55 -04:00
2010-08-11 17:54:51 -04:00
if ( empty ( $categories ) )
return ;
2009-09-04 04:50:55 -04:00
2010-08-11 17:54:51 -04:00
foreach ( $categories as $category ) {
$cat_id = $category -> term_id ;
$name = esc_html ( apply_filters ( 'the_category' , $category -> name ) );
$checked = in_array ( $cat_id , $checked_categories ) ? ' checked="checked"' : '' ;
echo '<li id="link-category-' , $cat_id , '"><label for="in-link-category-' , $cat_id , '" class="selectit"><input value="' , $cat_id , '" type="checkbox" name="link_category[]" id="in-link-category-' , $cat_id , '"' , $checked , '/> ' , $name , " </label></li> " ;
2007-05-25 03:16:21 -04:00
}
}
2010-08-11 17:54:51 -04:00
// adds hidden fields with the data for use in the inline editor for posts and pages
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.7 . 0
2008-10-01 21:03:26 -04:00
*
2010-08-11 17:54:51 -04:00
* @ param unknown_type $post
2008-10-01 21:03:26 -04:00
*/
2010-08-11 17:54:51 -04:00
function get_inline_data ( $post ) {
2010-02-02 12:37:03 -05:00
$post_type_object = get_post_type_object ( $post -> post_type );
2010-08-11 17:54:51 -04:00
if ( ! current_user_can ( $post_type_object -> cap -> edit_post , $post -> ID ) )
return ;
2008-03-02 15:17:30 -05:00
2011-02-07 14:11:17 -05:00
$title = esc_textarea ( trim ( $post -> post_title ) );
2008-08-20 00:06:36 -04:00
2010-08-11 17:54:51 -04:00
echo '
< div class = " hidden " id = " inline_' . $post->ID . ' " >
< div class = " post_title " > ' . $title . ' </ div >
< div class = " post_name " > ' . apply_filters(' editable_slug ', $post->post_name) . ' </ div >
< div class = " post_author " > ' . $post->post_author . ' </ div >
2011-02-07 14:11:17 -05:00
< div class = " comment_status " > ' . esc_html( $post->comment_status ) . ' </ div >
< div class = " ping_status " > ' . esc_html( $post->ping_status ) . ' </ div >
< div class = " _status " > ' . esc_html( $post->post_status ) . ' </ div >
2010-08-11 17:54:51 -04:00
< div class = " jj " > ' . mysql2date( ' d ', $post->post_date, false ) . ' </ div >
< div class = " mm " > ' . mysql2date( ' m ', $post->post_date, false ) . ' </ div >
< div class = " aa " > ' . mysql2date( ' Y ', $post->post_date, false ) . ' </ div >
< div class = " hh " > ' . mysql2date( ' H ', $post->post_date, false ) . ' </ div >
< div class = " mn " > ' . mysql2date( ' i ', $post->post_date, false ) . ' </ div >
< div class = " ss " > ' . mysql2date( ' s ', $post->post_date, false ) . ' </ div >
< div class = " post_password " > ' . esc_html( $post->post_password ) . ' </ div > ' ;
2009-12-24 21:46:40 -05:00
2010-08-11 17:54:51 -04:00
if ( $post_type_object -> hierarchical )
echo '<div class="post_parent">' . $post -> post_parent . '</div>' ;
2008-10-30 11:50:21 -04:00
2010-08-11 17:54:51 -04:00
if ( $post -> post_type == 'page' )
echo '<div class="page_template">' . esc_html ( get_post_meta ( $post -> ID , '_wp_page_template' , true ) ) . '</div>' ;
2009-07-20 23:11:12 -04:00
2012-02-15 12:19:59 -05:00
if ( post_type_supports ( $post -> post_type , 'page-attributes' ) )
2010-08-11 17:54:51 -04:00
echo '<div class="menu_order">' . $post -> menu_order . '</div>' ;
2009-07-20 23:11:12 -04:00
2010-08-11 17:54:51 -04:00
$taxonomy_names = get_object_taxonomies ( $post -> post_type );
foreach ( $taxonomy_names as $taxonomy_name ) {
$taxonomy = get_taxonomy ( $taxonomy_name );
2009-07-20 23:11:12 -04:00
2012-02-07 13:06:12 -05:00
if ( $taxonomy -> hierarchical && $taxonomy -> show_ui ) {
echo '<div class="post_category" id="' . $taxonomy_name . '_' . $post -> ID . '">'
. implode ( ',' , wp_get_object_terms ( $post -> ID , $taxonomy_name , array ( 'fields' => 'ids' ) ) ) . '</div>' ;
} elseif ( $taxonomy -> show_ui ) {
echo '<div class="tags_input" id="' . $taxonomy_name . '_' . $post -> ID . '">'
. esc_html ( str_replace ( ',' , ', ' , get_terms_to_edit ( $post -> ID , $taxonomy_name ) ) ) . '</div>' ;
}
2010-08-11 17:54:51 -04:00
}
2008-10-07 21:18:16 -04:00
2010-08-11 17:54:51 -04:00
if ( ! $post_type_object -> hierarchical )
echo '<div class="sticky">' . ( is_sticky ( $post -> ID ) ? 'sticky' : '' ) . '</div>' ;
2008-10-30 11:50:21 -04:00
2011-09-19 13:02:58 -04:00
if ( post_type_supports ( $post -> post_type , 'post-formats' ) )
echo '<div class="post_format">' . esc_html ( get_post_format ( $post -> ID ) ) . '</div>' ;
2010-08-11 17:54:51 -04:00
echo '</div>' ;
2007-05-25 03:16:21 -04:00
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.7 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $position
* @ param unknown_type $checkbox
* @ param unknown_type $mode
*/
2008-10-30 11:50:21 -04:00
function wp_comment_reply ( $position = '1' , $checkbox = false , $mode = 'single' , $table_row = true ) {
2008-08-24 02:56:22 -04:00
// allow plugin to replace the popup content
2008-10-07 21:18:16 -04:00
$content = apply_filters ( 'wp_comment_reply' , '' , array ( 'position' => $position , 'checkbox' => $checkbox , 'mode' => $mode ) );
2008-09-21 15:45:45 -04:00
2008-08-24 02:56:22 -04:00
if ( ! empty ( $content ) ) {
echo $content ;
return ;
}
2011-01-05 23:11:14 -05:00
2010-12-23 12:21:29 -05:00
if ( $mode == 'single' ) {
2011-01-16 16:47:24 -05:00
$wp_list_table = _get_list_table ( 'WP_Post_Comments_List_Table' );
2010-12-23 12:21:29 -05:00
} else {
2011-01-16 16:47:24 -05:00
$wp_list_table = _get_list_table ( 'WP_Comments_List_Table' );
2010-12-23 12:21:29 -05:00
}
2010-08-11 17:54:51 -04:00
2008-08-24 02:56:22 -04:00
?>
2008-10-08 19:32:34 -04:00
< form method = " get " action = " " >
< ? php if ( $table_row ) : ?>
2010-11-14 13:00:09 -05:00
< table style = " display:none; " >< tbody id = " com-reply " >< tr id = " replyrow " style = " display:none; " >< td colspan = " <?php echo $wp_list_table->get_column_count (); ?> " class = " colspanchange " >
2008-10-08 19:32:34 -04:00
< ? php else : ?>
2009-11-03 03:28:59 -05:00
< div id = " com-reply " style = " display:none; " >< div id = " replyrow " style = " display:none; " >
2008-10-08 19:32:34 -04:00
< ? php endif ; ?>
2011-09-28 17:07:08 -04:00
< div id = " replyhead " style = " display:none; " >< h5 >< ? php _e ( 'Reply to Comment' ); ?> </h5></div>
2012-03-08 20:30:11 -05:00
< div id = " addhead " style = " display:none; " >< h5 >< ? php _e ( 'Add new Comment' ); ?> </h5></div>
2008-10-07 21:18:16 -04:00
< div id = " edithead " style = " display:none; " >
< div class = " inside " >
2010-08-11 17:54:51 -04:00
< label for = " author " >< ? php _e ( 'Name' ) ?> </label>
2008-10-07 21:18:16 -04:00
< input type = " text " name = " newcomment_author " size = " 50 " value = " " tabindex = " 101 " id = " author " />
</ div >
< div class = " inside " >
2010-08-11 17:54:51 -04:00
< label for = " author-email " >< ? php _e ( 'E-mail' ) ?> </label>
2012-03-15 14:09:14 -04:00
< input type = " text " name = " newcomment_author_email " size = " 50 " value = " " tabindex = " 102 " id = " author-email " />
2008-10-07 21:18:16 -04:00
</ div >
< div class = " inside " >
2010-08-11 17:54:51 -04:00
< label for = " author-url " >< ? php _e ( 'URL' ) ?> </label>
2008-10-07 21:18:16 -04:00
< input type = " text " id = " author-url " name = " newcomment_author_url " size = " 103 " value = " " tabindex = " 103 " />
</ div >
< div style = " clear:both; " ></ div >
2008-08-24 02:56:22 -04:00
</ div >
2008-09-21 15:45:45 -04:00
2011-09-28 17:07:08 -04:00
< div id = " replycontainer " >
< ? php
$quicktags_settings = array ( 'buttons' => 'strong,em,link,block,del,ins,img,ul,ol,li,code,spell,close' );
2012-01-03 15:18:31 -05:00
wp_editor ( '' , 'replycontent' , array ( 'media_buttons' => false , 'tinymce' => false , 'quicktags' => $quicktags_settings , 'tabindex' => 104 ) );
2011-09-28 17:07:08 -04:00
?>
</ div >
2008-10-07 21:18:16 -04:00
2008-11-10 21:58:24 -05:00
< p id = " replysubmit " class = " submit " >
< a href = " #comments-form " class = " cancel button-secondary alignleft " tabindex = " 106 " >< ? php _e ( 'Cancel' ); ?> </a>
< a href = " #comments-form " class = " save button-primary alignright " tabindex = " 104 " >
2012-03-08 20:30:11 -05:00
< span id = " addbtn " style = " display:none; " >< ? php _e ( 'Add Comment' ); ?> </span>
2008-12-09 04:07:36 -05:00
< span id = " savebtn " style = " display:none; " >< ? php _e ( 'Update Comment' ); ?> </span>
2008-10-07 21:18:16 -04:00
< span id = " replybtn " style = " display:none; " >< ? php _e ( 'Submit Reply' ); ?> </span></a>
2010-05-03 14:16:22 -04:00
< img class = " waiting " style = " display:none; " src = " <?php echo esc_url( admin_url( 'images/wpspin_light.gif' ) ); ?> " alt = " " />
2008-10-07 21:18:16 -04:00
< span class = " error " style = " display:none; " ></ span >
2008-11-10 21:58:24 -05:00
< br class = " clear " />
2008-10-07 21:18:16 -04:00
</ p >
2010-06-24 11:01:29 -04:00
< input type = " hidden " name = " user_ID " id = " user_ID " value = " <?php echo get_current_user_id(); ?> " />
2008-10-07 21:18:16 -04:00
< input type = " hidden " name = " action " id = " action " value = " " />
2008-08-24 02:56:22 -04:00
< input type = " hidden " name = " comment_ID " id = " comment_ID " value = " " />
< input type = " hidden " name = " comment_post_ID " id = " comment_post_ID " value = " " />
2008-10-07 21:18:16 -04:00
< input type = " hidden " name = " status " id = " status " value = " " />
2008-08-24 02:56:22 -04:00
< input type = " hidden " name = " position " id = " position " value = " <?php echo $position ; ?> " />
< input type = " hidden " name = " checkbox " id = " checkbox " value = " <?php echo $checkbox ? 1 : 0; ?> " />
2009-05-05 15:43:53 -04:00
< input type = " hidden " name = " mode " id = " mode " value = " <?php echo esc_attr( $mode ); ?> " />
2011-09-30 20:19:07 -04:00
< ? php
wp_nonce_field ( 'replyto-comment' , '_ajax_nonce-replyto-comment' , false );
if ( current_user_can ( 'unfiltered_html' ) )
wp_nonce_field ( 'unfiltered-html-comment' , '_wp_unfiltered_html_comment' , false );
?>
2008-10-08 19:32:34 -04:00
< ? php if ( $table_row ) : ?>
2008-10-10 19:54:27 -04:00
</ td ></ tr ></ tbody ></ table >
2008-10-08 19:32:34 -04:00
< ? php else : ?>
2008-10-30 11:50:21 -04:00
</ div ></ div >
2008-10-08 19:32:34 -04:00
< ? php endif ; ?>
2008-10-10 19:54:27 -04:00
</ form >
2008-08-24 02:56:22 -04:00
< ? php
}
2009-10-08 04:24:59 -04:00
/**
* Output 'undo move to trash' text for comments
*
* @ since 2.9 . 0
*/
function wp_comment_trashnotice () {
?>
2009-11-27 05:34:09 -05:00
< div class = " hidden " id = " trash-undo-holder " >
< div class = " trash-undo-inside " >< ? php printf ( __ ( 'Comment by %s moved to the trash.' ), '<strong></strong>' ); ?> <span class="undo untrash"><a href="#"><?php _e('Undo'); ?></a></span></div>
</ div >
< div class = " hidden " id = " spam-undo-holder " >
< div class = " spam-undo-inside " >< ? php printf ( __ ( 'Comment by %s marked as spam.' ), '<strong></strong>' ); ?> <span class="undo unspam"><a href="#"><?php _e('Undo'); ?></a></span></div>
2009-10-08 04:24:59 -04:00
</ div >
< ? php
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 1.2 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $meta
*/
2007-05-25 03:16:21 -04:00
function list_meta ( $meta ) {
// Exit if no meta
2008-11-07 21:15:53 -05:00
if ( ! $meta ) {
echo '
< table id = " list-table " style = " display: none; " >
< thead >
< tr >
2011-06-10 18:13:26 -04:00
< th class = " left " > ' . _x( ' Name ', ' meta name ' ) . ' </ th >
2008-11-07 21:15:53 -05:00
< th > ' . __( ' Value ' ) . ' </ th >
</ tr >
</ thead >
< tbody id = " the-list " class = " list:meta " >
< tr >< td ></ td ></ tr >
</ tbody >
</ table > ' ; //TBODY needed for list-manipulation JS
2007-05-25 03:16:21 -04:00
return ;
}
$count = 0 ;
?>
2008-11-07 21:15:53 -05:00
< table id = " list-table " >
2007-05-25 03:16:21 -04:00
< thead >
< tr >
2011-06-10 18:13:26 -04:00
< th class = " left " >< ? php _ex ( 'Name' , 'meta name' ) ?> </th>
2010-08-11 17:54:51 -04:00
< th >< ? php _e ( 'Value' ) ?> </th>
2007-05-25 03:16:21 -04:00
</ tr >
</ thead >
2007-10-09 18:49:42 -04:00
< tbody id = 'the-list' class = 'list:meta' >
2007-05-25 03:16:21 -04:00
< ? php
2007-10-09 18:49:42 -04:00
foreach ( $meta as $entry )
echo _list_meta_row ( $entry , $count );
2008-11-07 21:15:53 -05:00
?>
</ tbody >
</ table >
< ? php
2007-10-09 18:49:42 -04:00
}
2007-05-25 03:16:21 -04:00
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $entry
* @ param unknown_type $count
* @ return unknown
*/
2007-10-09 18:49:42 -04:00
function _list_meta_row ( $entry , & $count ) {
2008-03-22 04:15:48 -04:00
static $update_nonce = false ;
2011-05-22 19:19:42 -04:00
2011-07-20 18:04:35 -04:00
if ( is_protected_meta ( $entry [ 'meta_key' ], 'post' ) )
2011-05-22 19:19:42 -04:00
return ;
2008-03-22 04:15:48 -04:00
if ( ! $update_nonce )
$update_nonce = wp_create_nonce ( 'add-meta' );
2007-10-09 18:49:42 -04:00
$r = '' ;
++ $count ;
if ( $count % 2 )
$style = 'alternate' ;
else
$style = '' ;
if ( is_serialized ( $entry [ 'meta_value' ] ) ) {
if ( is_serialized_string ( $entry [ 'meta_value' ] ) ) {
// this is a serialized string, so we should display it
$entry [ 'meta_value' ] = maybe_unserialize ( $entry [ 'meta_value' ] );
} else {
// this is a serialized array/object so we should NOT display it
-- $count ;
return ;
}
2007-05-25 03:16:21 -04:00
}
2007-10-09 18:49:42 -04:00
2009-05-05 15:43:53 -04:00
$entry [ 'meta_key' ] = esc_attr ( $entry [ 'meta_key' ]);
2010-11-17 12:12:01 -05:00
$entry [ 'meta_value' ] = esc_textarea ( $entry [ 'meta_value' ] ); // using a <textarea />
2007-10-09 18:49:42 -04:00
$entry [ 'meta_id' ] = ( int ) $entry [ 'meta_id' ];
2008-03-22 04:15:48 -04:00
$delete_nonce = wp_create_nonce ( 'delete-meta_' . $entry [ 'meta_id' ] );
2007-10-09 18:49:42 -04:00
$r .= " \n \t <tr id='meta- { $entry [ 'meta_id' ] } ' class=' $style '> " ;
2009-05-12 18:40:56 -04:00
$r .= " \n \t \t <td class='left'><label class='screen-reader-text' for='meta[ { $entry [ 'meta_id' ] } ][key]'> " . __ ( 'Key' ) . " </label><input name='meta[ { $entry [ 'meta_id' ] } ][key]' id='meta[ { $entry [ 'meta_id' ] } ][key]' tabindex='6' type='text' size='20' value=' { $entry [ 'meta_key' ] } ' /> " ;
2008-11-07 21:15:53 -05:00
2010-10-28 17:56:43 -04:00
$r .= " \n \t \t <div class='submit'> " ;
$r .= get_submit_button ( __ ( 'Delete' ), " delete:the-list:meta- { $entry [ 'meta_id' ] } ::_ajax_nonce= $delete_nonce deletemeta " , " deletemeta[ { $entry [ 'meta_id' ] } ] " , false , array ( 'tabindex' => '6' ) );
$r .= " \n \t \t " ;
$r .= get_submit_button ( __ ( 'Update' ), " add:the-list:meta- { $entry [ 'meta_id' ] } ::_ajax_nonce-add-meta= $update_nonce updatemeta " , 'updatemeta' , false , array ( 'tabindex' => '6' ) );
$r .= " </div> " ;
2008-03-22 04:15:48 -04:00
$r .= wp_nonce_field ( 'change-meta' , '_ajax_nonce' , false , false );
2008-11-07 21:15:53 -05:00
$r .= " </td> " ;
2008-12-09 13:03:31 -05:00
2009-05-12 18:40:56 -04:00
$r .= " \n \t \t <td><label class='screen-reader-text' for='meta[ { $entry [ 'meta_id' ] } ][value]'> " . __ ( 'Value' ) . " </label><textarea name='meta[ { $entry [ 'meta_id' ] } ][value]' id='meta[ { $entry [ 'meta_id' ] } ][value]' tabindex='6' rows='2' cols='30'> { $entry [ 'meta_value' ] } </textarea></td> \n \t </tr> " ;
2007-10-09 18:49:42 -04:00
return $r ;
2007-05-25 03:16:21 -04:00
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 1.2 . 0
2008-10-01 21:03:26 -04:00
*/
2007-05-25 03:16:21 -04:00
function meta_form () {
global $wpdb ;
$limit = ( int ) apply_filters ( 'postmeta_form_limit' , 30 );
$keys = $wpdb -> get_col ( "
SELECT meta_key
FROM $wpdb -> postmeta
GROUP BY meta_key
2009-05-05 01:40:03 -04:00
HAVING meta_key NOT LIKE '\_%'
2010-02-28 08:15:54 -05:00
ORDER BY meta_key
2007-05-25 03:16:21 -04:00
LIMIT $limit " );
2009-05-05 01:40:03 -04:00
if ( $keys )
2007-05-25 03:16:21 -04:00
natcasesort ( $keys );
?>
2010-08-11 17:54:51 -04:00
< p >< strong >< ? php _e ( 'Add New Custom Field:' ) ?> </strong></p>
2008-11-07 21:15:53 -05:00
< table id = " newmeta " >
< thead >
< tr >
2011-06-10 18:13:26 -04:00
< th class = " left " >< label for = " metakeyselect " >< ? php _ex ( 'Name' , 'meta name' ) ?> </label></th>
2010-08-11 17:54:51 -04:00
< th >< label for = " metavalue " >< ? php _e ( 'Value' ) ?> </label></th>
2007-05-25 03:16:21 -04:00
</ tr >
2008-11-07 21:15:53 -05:00
</ thead >
< tbody >
< tr >
< td id = " newmetaleft " class = " left " >
2008-11-30 19:29:14 -05:00
< ? php if ( $keys ) { ?>
2007-05-25 03:16:21 -04:00
< select id = " metakeyselect " name = " metakeyselect " tabindex = " 7 " >
2010-01-21 16:37:43 -05:00
< option value = " #NONE# " >< ? php _e ( '— Select —' ); ?> </option>
2007-05-25 03:16:21 -04:00
< ? php
foreach ( $keys as $key ) {
2010-08-11 17:54:51 -04:00
echo " \n <option value=' " . esc_attr ( $key ) . " '> " . esc_html ( $key ) . " </option> " ;
2007-05-25 03:16:21 -04:00
}
?>
2008-11-07 21:15:53 -05:00
</ select >
< input class = " hide-if-js " type = " text " id = " metakeyinput " name = " metakeyinput " tabindex = " 7 " value = " " />
2010-02-28 14:39:06 -05:00
< a href = " #postcustomstuff " class = " hide-if-no-js " onclick = " jQuery('#metakeyinput, #metakeyselect, #enternew, #cancelnew').toggle();return false; " >
2008-11-07 21:15:53 -05:00
< span id = " enternew " >< ? php _e ( 'Enter new' ); ?> </span>
2008-11-30 19:29:14 -05:00
< span id = " cancelnew " class = " hidden " >< ? php _e ( 'Cancel' ); ?> </span></a>
< ? php } else { ?>
< input type = " text " id = " metakeyinput " name = " metakeyinput " tabindex = " 7 " value = " " />
< ? php } ?>
2007-05-25 03:16:21 -04:00
</ td >
2008-11-07 21:15:53 -05:00
< td >< textarea id = " metavalue " name = " metavalue " rows = " 2 " cols = " 25 " tabindex = " 8 " ></ textarea ></ td >
</ tr >
< tr >< td colspan = " 2 " class = " submit " >
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Add Custom Field' ), 'add:the-list:newmeta' , 'addmeta' , false , array ( 'id' => 'addmetasub' , 'tabindex' => '9' ) ); ?>
2010-05-26 00:55:21 -04:00
< ? php wp_nonce_field ( 'add-meta' , '_ajax_nonce-add-meta' , false ); ?>
2007-10-09 18:49:42 -04:00
</ td ></ tr >
2008-11-07 21:15:53 -05:00
</ tbody >
2007-05-25 03:16:21 -04:00
</ table >
< ? php
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 0.71
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $edit
* @ param unknown_type $for_post
* @ param unknown_type $tab_index
* @ param unknown_type $multi
*/
2008-09-10 18:47:03 -04:00
function touch_time ( $edit = 1 , $for_post = 1 , $tab_index = 0 , $multi = 0 ) {
2007-05-25 03:16:21 -04:00
global $wp_locale , $post , $comment ;
if ( $for_post )
2010-03-19 17:15:00 -04:00
$edit = ! ( in_array ( $post -> post_status , array ( 'draft' , 'pending' ) ) && ( ! $post -> post_date_gmt || '0000-00-00 00:00:00' == $post -> post_date_gmt ) );
2008-02-05 01:47:27 -05:00
2007-09-11 15:08:26 -04:00
$tab_index_attribute = '' ;
if ( ( int ) $tab_index > 0 )
$tab_index_attribute = " tabindex= \" $tab_index\ " " ;
2007-06-13 22:25:30 -04:00
2008-03-16 19:05:16 -04:00
// echo '<label for="timestamp" style="display: block;"><input type="checkbox" class="checkbox" name="edit_date" value="1" id="timestamp"'.$tab_index_attribute.' /> '.__( 'Edit timestamp' ).'</label><br />';
2007-05-25 03:16:21 -04:00
2009-12-30 12:56:09 -05:00
$time_adj = current_time ( 'timestamp' );
2007-05-25 03:16:21 -04:00
$post_date = ( $for_post ) ? $post -> post_date : $comment -> comment_date ;
2009-05-13 22:00:32 -04:00
$jj = ( $edit ) ? mysql2date ( 'd' , $post_date , false ) : gmdate ( 'd' , $time_adj );
$mm = ( $edit ) ? mysql2date ( 'm' , $post_date , false ) : gmdate ( 'm' , $time_adj );
$aa = ( $edit ) ? mysql2date ( 'Y' , $post_date , false ) : gmdate ( 'Y' , $time_adj );
$hh = ( $edit ) ? mysql2date ( 'H' , $post_date , false ) : gmdate ( 'H' , $time_adj );
$mn = ( $edit ) ? mysql2date ( 'i' , $post_date , false ) : gmdate ( 'i' , $time_adj );
$ss = ( $edit ) ? mysql2date ( 's' , $post_date , false ) : gmdate ( 's' , $time_adj );
2007-05-25 03:16:21 -04:00
2008-10-29 15:22:56 -04:00
$cur_jj = gmdate ( 'd' , $time_adj );
$cur_mm = gmdate ( 'm' , $time_adj );
$cur_aa = gmdate ( 'Y' , $time_adj );
$cur_hh = gmdate ( 'H' , $time_adj );
$cur_mn = gmdate ( 'i' , $time_adj );
2008-09-10 18:47:03 -04:00
$month = " <select " . ( $multi ? '' : 'id="mm" ' ) . " name= \" mm \" $tab_index_attribute > \n " ;
2007-07-17 15:26:03 -04:00
for ( $i = 1 ; $i < 13 ; $i = $i + 1 ) {
2011-10-01 16:50:08 -04:00
$monthnum = zeroise ( $i , 2 );
$month .= " \t \t \t " . '<option value="' . $monthnum . '"' ;
2007-07-17 15:26:03 -04:00
if ( $i == $mm )
2008-02-22 18:13:02 -05:00
$month .= ' selected="selected"' ;
2012-02-02 19:23:25 -05:00
/* translators: 1: month number (01, 02, etc.), 2: month abbreviation */
$month .= '>' . sprintf ( __ ( '%1$s-%2$s' ), $monthnum , $wp_locale -> get_month_abbrev ( $wp_locale -> get_month ( $i ) ) ) . " </option> \n " ;
2007-07-17 15:26:03 -04:00
}
2008-02-22 18:13:02 -05:00
$month .= '</select>' ;
2012-03-19 15:30:07 -04:00
$day = '<input type="text" ' . ( $multi ? '' : 'id="jj" ' ) . 'name="jj" value="' . $jj . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" />' ;
$year = '<input type="text" ' . ( $multi ? '' : 'id="aa" ' ) . 'name="aa" value="' . $aa . '" size="4" maxlength="4"' . $tab_index_attribute . ' autocomplete="off" />' ;
$hour = '<input type="text" ' . ( $multi ? '' : 'id="hh" ' ) . 'name="hh" value="' . $hh . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" />' ;
$minute = '<input type="text" ' . ( $multi ? '' : 'id="mn" ' ) . 'name="mn" value="' . $mn . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" />' ;
2009-12-03 04:56:20 -05:00
echo '<div class="timestamp-wrap">' ;
2009-03-02 14:20:19 -05:00
/* translators: 1: month input, 2: day input, 3: year input, 4: hour input, 5: minute input */
printf ( __ ( '%1$s%2$s, %3$s @ %4$s : %5$s' ), $month , $day , $year , $hour , $minute );
2008-09-10 18:47:03 -04:00
2009-12-03 04:56:20 -05:00
echo '</div><input type="hidden" id="ss" name="ss" value="' . $ss . '" />' ;
2008-11-15 07:04:38 -05:00
2008-09-10 18:47:03 -04:00
if ( $multi ) return ;
2008-09-21 15:45:45 -04:00
2008-03-16 19:05:16 -04:00
echo " \n \n " ;
2008-10-29 15:22:56 -04:00
foreach ( array ( 'mm' , 'jj' , 'aa' , 'hh' , 'mn' ) as $timeunit ) {
2008-03-16 19:05:16 -04:00
echo '<input type="hidden" id="hidden_' . $timeunit . '" name="hidden_' . $timeunit . '" value="' . $$timeunit . '" />' . " \n " ;
2008-10-29 15:22:56 -04:00
$cur_timeunit = 'cur_' . $timeunit ;
echo '<input type="hidden" id="' . $cur_timeunit . '" name="' . $cur_timeunit . '" value="' . $$cur_timeunit . '" />' . " \n " ;
}
2007-05-25 03:16:21 -04:00
?>
2008-03-16 19:05:16 -04:00
2008-10-29 04:19:15 -04:00
< p >
2008-08-20 00:06:36 -04:00
< a href = " #edit_timestamp " class = " save-timestamp hide-if-no-js button " >< ? php _e ( 'OK' ); ?> </a>
2008-09-14 08:58:00 -04:00
< a href = " #edit_timestamp " class = " cancel-timestamp hide-if-no-js " >< ? php _e ( 'Cancel' ); ?> </a>
2008-10-29 04:19:15 -04:00
</ p >
2007-05-25 03:16:21 -04:00
< ? php
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 1.5 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $default
*/
2007-05-25 03:16:21 -04:00
function page_template_dropdown ( $default = '' ) {
$templates = get_page_templates ();
ksort ( $templates );
foreach ( array_keys ( $templates ) as $template )
: if ( $default == $templates [ $template ] )
$selected = " selected='selected' " ;
else
$selected = '' ;
echo " \n \t <option value=' " . $templates [ $template ] . " ' $selected > $template </option> " ;
endforeach ;
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 1.5 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $default
* @ param unknown_type $parent
* @ param unknown_type $level
* @ return unknown
*/
2007-05-25 03:16:21 -04:00
function parent_dropdown ( $default = 0 , $parent = 0 , $level = 0 ) {
global $wpdb , $post_ID ;
2008-04-14 12:13:25 -04:00
$items = $wpdb -> get_results ( $wpdb -> prepare ( " SELECT ID, post_parent, post_title FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'page' ORDER BY menu_order " , $parent ) );
2007-05-25 03:16:21 -04:00
if ( $items ) {
foreach ( $items as $item ) {
// A page cannot be its own parent.
if ( ! empty ( $post_ID ) ) {
if ( $item -> ID == $post_ID ) {
continue ;
}
}
$pad = str_repeat ( ' ' , $level * 3 );
if ( $item -> ID == $default )
$current = ' selected="selected"' ;
else
$current = '' ;
2010-08-11 17:54:51 -04:00
echo " \n \t <option class='level- $level ' value=' $item->ID ' $current > $pad " . esc_html ( $item -> post_title ) . " </option> " ;
2007-05-25 03:16:21 -04:00
parent_dropdown ( $default , $item -> ID , $level + 1 );
}
} else {
return false ;
}
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.0 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $id
* @ return unknown
*/
2007-05-25 03:16:21 -04:00
function the_attachment_links ( $id = false ) {
$id = ( int ) $id ;
$post = & get_post ( $id );
if ( $post -> post_type != 'attachment' )
return false ;
2010-02-25 19:41:23 -05:00
$icon = wp_get_attachment_image ( $post -> ID , 'thumbnail' , true );
2007-05-25 03:16:21 -04:00
$attachment_data = wp_get_attachment_metadata ( $id );
$thumb = isset ( $attachment_data [ 'thumb' ] );
?>
< form id = " the-attachment-links " >
< table >
< col />
< col class = " widefat " />
< tr >
2010-08-11 17:54:51 -04:00
< th scope = " row " >< ? php _e ( 'URL' ) ?> </th>
2010-11-17 12:12:01 -05:00
< td >< textarea rows = " 1 " cols = " 40 " type = " text " class = " attachmentlinks " readonly = " readonly " >< ? php echo esc_textarea ( wp_get_attachment_url () ); ?> </textarea></td>
2007-05-25 03:16:21 -04:00
</ tr >
< ? php if ( $icon ) : ?>
< tr >
< th scope = " row " >< ? php $thumb ? _e ( 'Thumbnail linked to file' ) : _e ( 'Image linked to file' ); ?> </th>
2010-08-11 17:54:51 -04:00
< td >< textarea rows = " 1 " cols = " 40 " type = " text " class = " attachmentlinks " readonly = " readonly " >< a href = " <?php echo wp_get_attachment_url(); ?> " >< ? php echo $icon ?> </a></textarea></td>
2007-05-25 03:16:21 -04:00
</ tr >
< tr >
< th scope = " row " >< ? php $thumb ? _e ( 'Thumbnail linked to page' ) : _e ( 'Image linked to page' ); ?> </th>
2010-08-11 17:54:51 -04:00
< td >< textarea rows = " 1 " cols = " 40 " type = " text " class = " attachmentlinks " readonly = " readonly " >< a href = " <?php echo get_attachment_link( $post->ID ) ?> " rel = " attachment wp-att-<?php echo $post->ID ; ?> " >< ? php echo $icon ?> </a></textarea></td>
2007-05-25 03:16:21 -04:00
</ tr >
< ? php else : ?>
< tr >
2010-08-11 17:54:51 -04:00
< th scope = " row " >< ? php _e ( 'Link to file' ) ?> </th>
2008-09-21 15:45:45 -04:00
< td >< textarea rows = " 1 " cols = " 40 " type = " text " class = " attachmentlinks " readonly = " readonly " >< a href = " <?php echo wp_get_attachment_url(); ?> " class = " attachmentlink " >< ? php echo basename ( wp_get_attachment_url () ); ?> </a></textarea></td>
2007-05-25 03:16:21 -04:00
</ tr >
< tr >
2010-08-11 17:54:51 -04:00
< th scope = " row " >< ? php _e ( 'Link to page' ) ?> </th>
< td >< textarea rows = " 1 " cols = " 40 " type = " text " class = " attachmentlinks " readonly = " readonly " >< a href = " <?php echo get_attachment_link( $post->ID ) ?> " rel = " attachment wp-att-<?php echo $post->ID ?> " >< ? php the_title (); ?> </a></textarea></td>
2007-05-25 03:16:21 -04:00
</ tr >
< ? php endif ; ?>
</ table >
</ form >
< ? php
}
2008-10-01 21:03:26 -04:00
/**
2010-09-07 07:21:11 -04:00
* Print out < option > html elements for role selectors
2008-10-01 21:03:26 -04:00
*
2010-12-01 14:24:38 -05:00
* @ since 2.1 . 0
2008-10-01 21:03:26 -04:00
*
2010-09-07 07:21:11 -04:00
* @ param string $selected slug for the role that should be already selected
2008-10-01 21:03:26 -04:00
*/
2008-12-31 12:40:05 -05:00
function wp_dropdown_roles ( $selected = false ) {
2008-08-14 13:00:37 -04:00
$p = '' ;
2007-05-25 03:16:21 -04:00
$r = '' ;
2009-02-01 04:45:24 -05:00
2009-01-06 17:00:05 -05:00
$editable_roles = get_editable_roles ();
2009-02-01 04:45:24 -05:00
2010-02-19 21:01:46 -05:00
foreach ( $editable_roles as $role => $details ) {
2009-03-10 19:02:29 -04:00
$name = translate_user_role ( $details [ 'name' ] );
2010-09-07 07:21:11 -04:00
if ( $selected == $role ) // preselect specified role
2009-05-05 15:43:53 -04:00
$p = " \n \t <option selected='selected' value=' " . esc_attr ( $role ) . " '> $name </option> " ;
2007-05-25 03:16:21 -04:00
else
2009-05-05 15:43:53 -04:00
$r .= " \n \t <option value=' " . esc_attr ( $role ) . " '> $name </option> " ;
2008-02-19 15:28:54 -05:00
}
2007-05-25 03:16:21 -04:00
echo $p . $r ;
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.3 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $size
* @ return unknown
*/
2007-08-28 19:13:16 -04:00
function wp_convert_hr_to_bytes ( $size ) {
$size = strtolower ( $size );
$bytes = ( int ) $size ;
if ( strpos ( $size , 'k' ) !== false )
$bytes = intval ( $size ) * 1024 ;
elseif ( strpos ( $size , 'm' ) !== false )
$bytes = intval ( $size ) * 1024 * 1024 ;
elseif ( strpos ( $size , 'g' ) !== false )
$bytes = intval ( $size ) * 1024 * 1024 * 1024 ;
return $bytes ;
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.3 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $bytes
* @ return unknown
*/
2007-08-28 19:13:16 -04:00
function wp_convert_bytes_to_hr ( $bytes ) {
$units = array ( 0 => 'B' , 1 => 'kB' , 2 => 'MB' , 3 => 'GB' );
$log = log ( $bytes , 1024 );
$power = ( int ) $log ;
$size = pow ( 1024 , $log - $power );
return $size . $units [ $power ];
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
* @ return unknown
*/
2008-01-25 14:21:11 -05:00
function wp_max_upload_size () {
2007-08-28 19:13:16 -04:00
$u_bytes = wp_convert_hr_to_bytes ( ini_get ( 'upload_max_filesize' ) );
$p_bytes = wp_convert_hr_to_bytes ( ini_get ( 'post_max_size' ) );
2008-01-25 14:21:11 -05:00
$bytes = apply_filters ( 'upload_size_limit' , min ( $u_bytes , $p_bytes ), $u_bytes , $p_bytes );
return $bytes ;
}
2008-10-01 21:03:26 -04:00
/**
2009-09-23 02:59:20 -04:00
* Outputs the form used by the importers to accept the data to be imported
2008-10-01 21:03:26 -04:00
*
2010-12-01 14:24:38 -05:00
* @ since 2.0 . 0
2008-10-01 21:03:26 -04:00
*
2009-09-23 02:59:20 -04:00
* @ param string $action The action attribute for the form .
2008-10-01 21:03:26 -04:00
*/
2008-01-25 14:21:11 -05:00
function wp_import_upload_form ( $action ) {
$bytes = apply_filters ( 'import_upload_size_limit' , wp_max_upload_size () );
2007-08-28 19:13:16 -04:00
$size = wp_convert_bytes_to_hr ( $bytes );
2009-02-12 14:39:35 -05:00
$upload_dir = wp_upload_dir ();
if ( ! empty ( $upload_dir [ 'error' ] ) ) :
?> <div class="error"><p><?php _e('Before you can upload your import file, you will need to fix the following error:'); ?></p>
2009-03-17 22:43:45 -04:00
< p >< strong >< ? php echo $upload_dir [ 'error' ]; ?> </strong></p></div><?php
else :
2007-05-25 03:16:21 -04:00
?>
2009-09-23 02:59:20 -04:00
< form enctype = " multipart/form-data " id = " import-upload-form " method = " post " action = " <?php echo esc_attr(wp_nonce_url( $action , 'import-upload')); ?> " >
2007-05-25 03:16:21 -04:00
< p >
2007-08-28 19:13:16 -04:00
< label for = " upload " >< ? php _e ( 'Choose a file from your computer:' ); ?> </label> (<?php printf( __('Maximum size: %s' ), $size ); ?>)
2007-05-25 03:16:21 -04:00
< input type = " file " id = " upload " name = " import " size = " 25 " />
< input type = " hidden " name = " action " value = " save " />
< input type = " hidden " name = " max_file_size " value = " <?php echo $bytes ; ?> " />
</ p >
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Upload file and import' ), 'button' ); ?>
2007-05-25 03:16:21 -04:00
</ form >
< ? php
2009-02-12 14:39:35 -05:00
endif ;
2007-05-25 03:16:21 -04:00
}
2008-02-08 13:51:37 -05:00
/**
2008-10-01 21:03:26 -04:00
* Add a meta box to an edit form .
2008-02-08 13:51:37 -05:00
*
2008-10-01 21:03:26 -04:00
* @ since 2.5 . 0
2008-02-08 13:51:37 -05:00
*
* @ param string $id String for use in the 'id' attribute of tags .
2008-10-01 21:03:26 -04:00
* @ param string $title Title of the meta box .
2008-09-21 15:45:45 -04:00
* @ param string $callback Function that fills the box with the desired content . The function should echo its output .
2011-10-20 11:53:57 -04:00
* @ param string | object $screen Optional . The screen on which to show the box ( post , page , link ) . Defaults to current screen .
2011-10-19 19:01:55 -04:00
* @ param string $context Optional . The context within the page where the boxes should show ( 'normal' , 'advanced' ) .
* @ param string $priority Optional . The priority within the context where the boxes should show ( 'high' , 'low' ) .
2008-02-08 13:51:37 -05:00
*/
2011-10-19 19:01:55 -04:00
function add_meta_box ( $id , $title , $callback , $screen = null , $context = 'advanced' , $priority = 'default' , $callback_args = null ) {
2008-02-08 13:51:37 -05:00
global $wp_meta_boxes ;
2011-10-19 17:43:02 -04:00
if ( empty ( $screen ) )
$screen = get_current_screen ();
elseif ( is_string ( $screen ) )
$screen = convert_to_screen ( $screen );
$page = $screen -> id ;
2008-09-21 15:45:45 -04:00
if ( ! isset ( $wp_meta_boxes ) )
2008-02-08 16:06:15 -05:00
$wp_meta_boxes = array ();
if ( ! isset ( $wp_meta_boxes [ $page ]) )
$wp_meta_boxes [ $page ] = array ();
if ( ! isset ( $wp_meta_boxes [ $page ][ $context ]) )
$wp_meta_boxes [ $page ][ $context ] = array ();
2008-08-20 00:06:36 -04:00
foreach ( array_keys ( $wp_meta_boxes [ $page ]) as $a_context ) {
2010-11-20 14:20:32 -05:00
foreach ( array ( 'high' , 'core' , 'default' , 'low' ) as $a_priority ) {
if ( ! isset ( $wp_meta_boxes [ $page ][ $a_context ][ $a_priority ][ $id ]) )
continue ;
2010-12-13 16:21:50 -05:00
2010-11-20 14:20:32 -05:00
// If a core box was previously added or removed by a plugin, don't add.
if ( 'core' == $priority ) {
// If core box previously deleted, don't add
if ( false === $wp_meta_boxes [ $page ][ $a_context ][ $a_priority ][ $id ] )
return ;
// If box was added with default priority, give it core priority to maintain sort order
if ( 'default' == $a_priority ) {
$wp_meta_boxes [ $page ][ $a_context ][ 'core' ][ $id ] = $wp_meta_boxes [ $page ][ $a_context ][ 'default' ][ $id ];
unset ( $wp_meta_boxes [ $page ][ $a_context ][ 'default' ][ $id ]);
}
2008-05-14 04:22:01 -04:00
return ;
}
2010-11-20 14:20:32 -05:00
// If no priority given and id already present, use existing priority
if ( empty ( $priority ) ) {
$priority = $a_priority ;
2011-09-03 10:18:10 -04:00
// else if we're adding to the sorted priority, we don't know the title or callback. Grab them from the previously added context/priority.
2010-11-20 14:20:32 -05:00
} elseif ( 'sorted' == $priority ) {
$title = $wp_meta_boxes [ $page ][ $a_context ][ $a_priority ][ $id ][ 'title' ];
$callback = $wp_meta_boxes [ $page ][ $a_context ][ $a_priority ][ $id ][ 'callback' ];
$callback_args = $wp_meta_boxes [ $page ][ $a_context ][ $a_priority ][ $id ][ 'args' ];
}
// An id can be in only one priority and one context
if ( $priority != $a_priority || $context != $a_context )
unset ( $wp_meta_boxes [ $page ][ $a_context ][ $a_priority ][ $id ]);
2008-08-20 00:06:36 -04:00
}
2008-05-14 04:22:01 -04:00
}
if ( empty ( $priority ) )
2008-08-20 00:06:36 -04:00
$priority = 'low' ;
2008-05-14 04:22:01 -04:00
if ( ! isset ( $wp_meta_boxes [ $page ][ $context ][ $priority ]) )
$wp_meta_boxes [ $page ][ $context ][ $priority ] = array ();
2008-12-18 14:12:26 -05:00
$wp_meta_boxes [ $page ][ $context ][ $priority ][ $id ] = array ( 'id' => $id , 'title' => $title , 'callback' => $callback , 'args' => $callback_args );
2008-02-08 13:51:37 -05:00
}
2008-10-01 21:03:26 -04:00
/**
2010-05-19 15:11:33 -04:00
* Meta - Box template function
2008-10-01 21:03:26 -04:00
*
2010-05-19 15:11:33 -04:00
* @ since 2.5 . 0
2008-10-01 21:03:26 -04:00
*
2011-10-19 17:43:02 -04:00
* @ param string | object $screen Screen identifier
2010-05-19 15:11:33 -04:00
* @ param string $context box context
* @ param mixed $object gets passed to the box callback function as first parameter
2008-10-08 19:32:34 -04:00
* @ return int number of meta_boxes
2008-10-01 21:03:26 -04:00
*/
2011-10-19 17:43:02 -04:00
function do_meta_boxes ( $screen , $context , $object ) {
2008-02-08 13:51:37 -05:00
global $wp_meta_boxes ;
2008-08-20 00:06:36 -04:00
static $already_sorted = false ;
2008-02-08 13:51:37 -05:00
2011-10-19 17:43:02 -04:00
if ( empty ( $screen ) )
$screen = get_current_screen ();
elseif ( is_string ( $screen ) )
$screen = convert_to_screen ( $screen );
$page = $screen -> id ;
$hidden = get_hidden_meta_boxes ( $screen );
2008-08-22 14:58:42 -04:00
2010-05-25 22:42:15 -04:00
printf ( '<div id="%s-sortables" class="meta-box-sortables">' , htmlspecialchars ( $context ));
2008-02-08 13:51:37 -05:00
2008-08-20 00:06:36 -04:00
$i = 0 ;
2008-09-21 15:45:45 -04:00
do {
// Grab the ones the user has manually sorted. Pull them out of their previous context/priority and into the one the user chose
2010-01-06 19:01:52 -05:00
if ( ! $already_sorted && $sorted = get_user_option ( " meta-box-order_ $page " ) ) {
2011-06-12 21:03:55 -04:00
foreach ( $sorted as $box_context => $ids ) {
2011-06-15 15:23:35 -04:00
foreach ( explode ( ',' , $ids ) as $id ) {
2011-06-18 11:05:46 -04:00
if ( $id && 'dashboard_browser_nag' !== $id )
2011-10-19 17:43:02 -04:00
add_meta_box ( $id , null , null , $screen , $box_context , 'sorted' );
2011-06-12 20:24:47 -04:00
}
2011-06-12 21:03:55 -04:00
}
2008-08-20 00:06:36 -04:00
}
$already_sorted = true ;
2008-08-08 13:05:10 -04:00
2008-08-20 00:06:36 -04:00
if ( ! isset ( $wp_meta_boxes ) || ! isset ( $wp_meta_boxes [ $page ]) || ! isset ( $wp_meta_boxes [ $page ][ $context ]) )
break ;
foreach ( array ( 'high' , 'sorted' , 'core' , 'default' , 'low' ) as $priority ) {
2008-08-25 17:50:11 -04:00
if ( isset ( $wp_meta_boxes [ $page ][ $context ][ $priority ]) ) {
foreach ( ( array ) $wp_meta_boxes [ $page ][ $context ][ $priority ] as $box ) {
if ( false == $box || ! $box [ 'title' ] )
continue ;
$i ++ ;
$style = '' ;
2010-05-04 18:28:51 -04:00
$hidden_class = in_array ( $box [ 'id' ], $hidden ) ? ' hide-if-js' : '' ;
echo '<div id="' . $box [ 'id' ] . '" class="postbox ' . postbox_classes ( $box [ 'id' ], $page ) . $hidden_class . '" ' . '>' . " \n " ;
2011-05-18 13:06:04 -04:00
if ( 'dashboard_browser_nag' != $box [ 'id' ] )
echo '<div class="handlediv" title="' . esc_attr__ ( 'Click to toggle' ) . '"><br /></div>' ;
2008-11-30 20:31:57 -05:00
echo " <h3 class='hndle'><span> { $box [ 'title' ] } </span></h3> \n " ;
2008-08-25 17:50:11 -04:00
echo '<div class="inside">' . " \n " ;
call_user_func ( $box [ 'callback' ], $object , $box );
echo " </div> \n " ;
echo " </div> \n " ;
}
2008-08-20 00:06:36 -04:00
}
2008-05-14 04:22:01 -04:00
}
2008-08-20 00:06:36 -04:00
} while ( 0 );
2010-08-11 17:54:51 -04:00
echo " </div> " ;
2008-08-20 00:06:36 -04:00
return $i ;
2008-02-08 13:51:37 -05:00
}
2008-05-14 04:22:01 -04:00
/**
2008-10-01 21:03:26 -04:00
* Remove a meta box from an edit form .
2008-05-14 04:22:01 -04:00
*
2008-10-01 21:03:26 -04:00
* @ since 2.6 . 0
2008-05-14 04:22:01 -04:00
*
* @ param string $id String for use in the 'id' attribute of tags .
2011-10-19 17:43:02 -04:00
* @ param string | object $screen The screen on which to show the box ( post , page , link ) .
2008-10-01 21:03:26 -04:00
* @ param string $context The context within the page where the boxes should show ( 'normal' , 'advanced' ) .
2008-05-14 04:22:01 -04:00
*/
2011-10-19 17:43:02 -04:00
function remove_meta_box ( $id , $screen , $context ) {
2008-05-14 04:22:01 -04:00
global $wp_meta_boxes ;
2011-10-19 17:43:02 -04:00
if ( empty ( $screen ) )
$screen = get_current_screen ();
elseif ( is_string ( $screen ) )
$screen = convert_to_screen ( $screen );
$page = $screen -> id ;
2008-09-21 15:45:45 -04:00
if ( ! isset ( $wp_meta_boxes ) )
2008-05-14 04:22:01 -04:00
$wp_meta_boxes = array ();
if ( ! isset ( $wp_meta_boxes [ $page ]) )
$wp_meta_boxes [ $page ] = array ();
if ( ! isset ( $wp_meta_boxes [ $page ][ $context ]) )
$wp_meta_boxes [ $page ][ $context ] = array ();
foreach ( array ( 'high' , 'core' , 'default' , 'low' ) as $priority )
$wp_meta_boxes [ $page ][ $context ][ $priority ][ $id ] = false ;
}
2008-09-09 18:31:22 -04:00
/**
2008-10-01 21:03:26 -04:00
* Add a new section to a settings page .
2008-09-09 18:31:22 -04:00
*
2010-02-17 12:50:42 -05:00
* Part of the Settings API . Use this to define new settings sections for an admin page .
* Show settings sections in your admin page callback function with do_settings_sections () .
* Add settings fields to your section with add_settings_field ()
*
2010-06-06 01:16:32 -04:00
* The $callback argument should be the name of a function that echoes out any
2010-02-17 12:50:42 -05:00
* content you want to show at the top of the settings section before the actual
* fields . It can output nothing if you want .
*
2008-10-01 21:03:26 -04:00
* @ since 2.7 . 0
2008-09-09 18:31:22 -04:00
*
2010-02-17 12:50:42 -05:00
* @ global $wp_settings_sections Storage array of all settings sections added to admin pages
2010-06-09 16:21:43 -04:00
*
2010-02-17 12:50:42 -05:00
* @ param string $id Slug - name to identify the section . Used in the 'id' attribute of tags .
2010-03-17 12:27:25 -04:00
* @ param string $title Formatted title of the section . Shown as the heading for the section .
2010-06-09 16:21:43 -04:00
* @ param string $callback Function that echos out any content at the top of the section ( between heading and fields ) .
* @ param string $page The slug - name of the settings page on which to show the section . Built - in pages include 'general' , 'reading' , 'writing' , 'discussion' , 'media' , etc . Create your own using add_options_page ();
2008-09-09 18:31:22 -04:00
*/
function add_settings_section ( $id , $title , $callback , $page ) {
global $wp_settings_sections ;
2010-03-18 13:32:27 -04:00
if ( 'misc' == $page ) {
_deprecated_argument ( __FUNCTION__ , '3.0' , __ ( 'The miscellaneous options group has been removed. Use another settings group.' ) );
2010-03-18 03:50:43 -04:00
$page = 'general' ;
2010-03-18 13:32:27 -04:00
}
2010-03-18 03:50:43 -04:00
2008-09-21 15:45:45 -04:00
if ( ! isset ( $wp_settings_sections ) )
2008-09-09 18:31:22 -04:00
$wp_settings_sections = array ();
if ( ! isset ( $wp_settings_sections [ $page ]) )
$wp_settings_sections [ $page ] = array ();
if ( ! isset ( $wp_settings_sections [ $page ][ $id ]) )
$wp_settings_sections [ $page ][ $id ] = array ();
$wp_settings_sections [ $page ][ $id ] = array ( 'id' => $id , 'title' => $title , 'callback' => $callback );
}
/**
2010-02-17 12:50:42 -05:00
* Add a new field to a section of a settings page
*
* Part of the Settings API . Use this to define a settings field that will show
* as part of a settings section inside a settings page . The fields are shown using
* do_settings_fields () in do_settings - sections ()
*
* The $callback argument should be the name of a function that echoes out the
2011-09-03 10:18:10 -04:00
* html input tags for this setting field . Use get_option () to retrieve existing
2010-03-17 12:27:25 -04:00
* values to show .
2008-09-09 18:31:22 -04:00
*
2008-10-01 21:03:26 -04:00
* @ since 2.7 . 0
2008-09-09 18:31:22 -04:00
*
2010-02-17 12:50:42 -05:00
* @ global $wp_settings_fields Storage array of settings fields and info about their pages / sections
*
* @ param string $id Slug - name to identify the field . Used in the 'id' attribute of tags .
* @ param string $title Formatted title of the field . Shown as the label for the field during output .
* @ param string $callback Function that fills the field with the desired form inputs . The function should echo its output .
* @ param string $page The slug - name of the settings page on which to show the section ( general , reading , writing , ... ) .
2011-09-03 10:18:10 -04:00
* @ param string $section The slug - name of the section of the settings page in which to show the box ( default , ... ) .
2008-09-09 18:31:22 -04:00
* @ param array $args Additional arguments
*/
function add_settings_field ( $id , $title , $callback , $page , $section = 'default' , $args = array ()) {
global $wp_settings_fields ;
2010-03-18 13:32:27 -04:00
if ( 'misc' == $page ) {
_deprecated_argument ( __FUNCTION__ , '3.0' , __ ( 'The miscellaneous options group has been removed. Use another settings group.' ) );
2010-03-18 03:50:43 -04:00
$page = 'general' ;
2010-03-18 13:32:27 -04:00
}
2010-03-18 03:50:43 -04:00
2008-09-21 15:45:45 -04:00
if ( ! isset ( $wp_settings_fields ) )
2008-09-09 18:31:22 -04:00
$wp_settings_fields = array ();
if ( ! isset ( $wp_settings_fields [ $page ]) )
$wp_settings_fields [ $page ] = array ();
if ( ! isset ( $wp_settings_fields [ $page ][ $section ]) )
$wp_settings_fields [ $page ][ $section ] = array ();
$wp_settings_fields [ $page ][ $section ][ $id ] = array ( 'id' => $id , 'title' => $title , 'callback' => $callback , 'args' => $args );
}
2008-10-01 21:03:26 -04:00
/**
2010-02-17 12:50:42 -05:00
* Prints out all settings sections added to a particular settings page
2008-10-01 21:03:26 -04:00
*
2010-02-17 12:50:42 -05:00
* Part of the Settings API . Use this in a settings page callback function
* to output all the sections and fields that were added to that $page with
* add_settings_section () and add_settings_field ()
*
* @ global $wp_settings_sections Storage array of all settings sections added to admin pages
* @ global $wp_settings_fields Storage array of settings fields and info about their pages / sections
2010-12-01 14:24:38 -05:00
* @ since 2.7 . 0
2008-10-01 21:03:26 -04:00
*
2010-02-17 12:50:42 -05:00
* @ param string $page The slug name of the page whos settings sections you want to output
2008-10-01 21:03:26 -04:00
*/
2008-09-09 18:31:22 -04:00
function do_settings_sections ( $page ) {
global $wp_settings_sections , $wp_settings_fields ;
if ( ! isset ( $wp_settings_sections ) || ! isset ( $wp_settings_sections [ $page ]) )
return ;
foreach ( ( array ) $wp_settings_sections [ $page ] as $section ) {
2011-07-11 16:22:24 -04:00
if ( $section [ 'title' ] )
echo " <h3> { $section [ 'title' ] } </h3> \n " ;
2008-09-09 18:31:22 -04:00
call_user_func ( $section [ 'callback' ], $section );
if ( ! isset ( $wp_settings_fields ) || ! isset ( $wp_settings_fields [ $page ]) || ! isset ( $wp_settings_fields [ $page ][ $section [ 'id' ]]) )
continue ;
echo '<table class="form-table">' ;
do_settings_fields ( $page , $section [ 'id' ]);
echo '</table>' ;
}
}
2008-10-01 21:03:26 -04:00
/**
2010-02-17 12:50:42 -05:00
* Print out the settings fields for a particular settings section
*
* Part of the Settings API . Use this in a settings page to output
* a specific section . Should normally be called by do_settings_sections ()
* rather than directly .
*
* @ global $wp_settings_fields Storage array of settings fields and their pages / sections
2008-10-01 21:03:26 -04:00
*
2010-12-01 14:24:38 -05:00
* @ since 2.7 . 0
2008-10-01 21:03:26 -04:00
*
2010-02-17 12:50:42 -05:00
* @ param string $page Slug title of the admin page who ' s settings fields you want to show .
* @ param section $section Slug title of the settings section who ' s fields you want to show .
2008-10-01 21:03:26 -04:00
*/
2008-09-09 18:31:22 -04:00
function do_settings_fields ( $page , $section ) {
global $wp_settings_fields ;
if ( ! isset ( $wp_settings_fields ) || ! isset ( $wp_settings_fields [ $page ]) || ! isset ( $wp_settings_fields [ $page ][ $section ]) )
return ;
foreach ( ( array ) $wp_settings_fields [ $page ][ $section ] as $field ) {
echo '<tr valign="top">' ;
if ( ! empty ( $field [ 'args' ][ 'label_for' ]) )
echo '<th scope="row"><label for="' . $field [ 'args' ][ 'label_for' ] . '">' . $field [ 'title' ] . '</label></th>' ;
else
echo '<th scope="row">' . $field [ 'title' ] . '</th>' ;
echo '<td>' ;
2009-11-19 12:37:50 -05:00
call_user_func ( $field [ 'callback' ], $field [ 'args' ]);
2008-09-09 18:31:22 -04:00
echo '</td>' ;
echo '</tr>' ;
2008-09-21 15:45:45 -04:00
}
2008-09-09 18:31:22 -04:00
}
2010-02-17 12:50:42 -05:00
/**
* Register a settings error to be displayed to the user
*
* Part of the Settings API . Use this to show messages to users about settings validation
* problems , missing settings or anything else .
*
* Settings errors should be added inside the $sanitize_callback function defined in
* register_setting () for a given setting to give feedback about the submission .
*
* By default messages will show immediately after the submission that generated the error .
* Additional calls to settings_errors () can be used to show errors even when the settings
* page is first accessed .
*
2010-12-01 14:24:38 -05:00
* @ since 3.0 . 0
*
2010-02-17 12:50:42 -05:00
* @ global array $wp_settings_errors Storage array of errors registered during this pageload
2010-03-17 12:27:25 -04:00
*
2010-02-17 12:50:42 -05:00
* @ param string $setting Slug title of the setting to which this error applies
2010-02-18 14:43:44 -05:00
* @ param string $code Slug - name to identify the error . Used as part of 'id' attribute in HTML output .
2010-02-17 12:50:42 -05:00
* @ param string $message The formatted message text to display to the user ( will be shown inside styled < div > and < p > )
* @ param string $type The type of message it is , controls HTML class . Use 'error' or 'updated' .
*/
2010-02-18 14:43:44 -05:00
function add_settings_error ( $setting , $code , $message , $type = 'error' ) {
2010-02-17 12:50:42 -05:00
global $wp_settings_errors ;
if ( ! isset ( $wp_settings_errors ) )
$wp_settings_errors = array ();
$new_error = array (
'setting' => $setting ,
2010-02-18 14:43:44 -05:00
'code' => $code ,
2010-02-17 12:50:42 -05:00
'message' => $message ,
'type' => $type
);
$wp_settings_errors [] = $new_error ;
}
/**
* Fetch settings errors registered by add_settings_error ()
*
* Checks the $wp_settings_errors array for any errors declared during the current
* pageload and returns them .
*
2010-12-03 05:59:20 -05:00
* If changes were just submitted ( $_GET [ 'settings-updated' ]) and settings errors were saved
2010-02-17 12:50:42 -05:00
* to the 'settings_errors' transient then those errors will be returned instead . This
* is used to pass errors back across pageloads .
*
* Use the $sanitize argument to manually re - sanitize the option before returning errors .
* This is useful if you have errors or notices you want to show even when the user
* hasn ' t submitted data ( i . e . when they first load an options page , or in admin_notices action hook )
*
2010-12-01 14:24:38 -05:00
* @ since 3.0 . 0
*
2010-02-17 12:50:42 -05:00
* @ global array $wp_settings_errors Storage array of errors registered during this pageload
*
* @ param string $setting Optional slug title of a specific setting who ' s errors you want .
* @ param boolean $sanitize Whether to re - sanitize the setting value before returning errors .
* @ return array Array of settings errors
*/
2012-01-05 15:50:54 -05:00
function get_settings_errors ( $setting = '' , $sanitize = false ) {
2010-02-17 12:50:42 -05:00
global $wp_settings_errors ;
// If $sanitize is true, manually re-run the sanitizisation for this option
// This allows the $sanitize_callback from register_setting() to run, adding
// any settings errors you want to show by default.
if ( $sanitize )
sanitize_option ( $setting , get_option ( $setting ));
// If settings were passed back from options.php then use them
2011-09-03 10:18:10 -04:00
// Ignore transients if $sanitize is true, we don't want the old values anyway
2010-12-03 05:59:20 -05:00
if ( isset ( $_GET [ 'settings-updated' ]) && $_GET [ 'settings-updated' ] && get_transient ( 'settings_errors' ) ) {
2010-02-17 12:50:42 -05:00
$settings_errors = get_transient ( 'settings_errors' );
delete_transient ( 'settings_errors' );
// Otherwise check global in case validation has been run on this pageload
} elseif ( count ( $wp_settings_errors ) ) {
$settings_errors = $wp_settings_errors ;
} else {
return ;
}
// Filter the results to those of a specific setting if one was set
if ( $setting ) {
foreach ( ( array ) $settings_errors as $key => $details )
if ( $setting != $details [ 'setting' ] )
unset ( $settings_errors [ $key ] );
}
return $settings_errors ;
}
/**
* Display settings errors registered by add_settings_error ()
*
* Part of the Settings API . Outputs a < div > for each error retrieved by get_settings_errors () .
2010-03-17 12:27:25 -04:00
*
2010-02-17 12:50:42 -05:00
* This is called automatically after a settings page based on the Settings API is submitted .
* Errors should be added during the validation callback function for a setting defined in register_setting ()
*
* The $sanitize option is passed into get_settings_errors () and will re - run the setting sanitization
* on its current value .
*
* The $hide_on_update option will cause errors to only show when the settings page is first loaded .
* if the user has already saved new values it will be hidden to avoid repeating messages already
* shown in the default error reporting after submission . This is useful to show general errors like missing
* settings when the user arrives at the settings page .
*
2010-12-01 14:24:38 -05:00
* @ since 3.0 . 0
*
2010-02-17 12:50:42 -05:00
* @ param string $setting Optional slug title of a specific setting who ' s errors you want .
* @ param boolean $sanitize Whether to re - sanitize the setting value before returning errors .
* @ param boolean $hide_on_update If set to true errors will not be shown if the settings page has already been submitted .
*/
2012-01-05 15:50:54 -05:00
function settings_errors ( $setting = '' , $sanitize = false , $hide_on_update = false ) {
2010-02-17 12:50:42 -05:00
2012-01-13 13:15:55 -05:00
if ( $hide_on_update && ! empty ( $_GET [ 'settings-updated' ] ) )
return ;
2010-02-22 18:12:48 -05:00
2010-02-17 12:50:42 -05:00
$settings_errors = get_settings_errors ( $setting , $sanitize );
2012-01-13 13:15:55 -05:00
if ( ! is_array ( $settings_errors ) )
return ;
2010-02-17 12:50:42 -05:00
2010-08-11 17:54:51 -04:00
$output = '' ;
2010-02-17 12:50:42 -05:00
foreach ( $settings_errors as $key => $details ) {
2010-02-18 14:43:44 -05:00
$css_id = 'setting-error-' . $details [ 'code' ];
2010-04-07 23:36:52 -04:00
$css_class = $details [ 'type' ] . ' settings-error' ;
2010-08-11 17:54:51 -04:00
$output .= " <div id=' $css_id ' class=' $css_class '> \n " ;
$output .= " <p><strong> { $details [ 'message' ] } </strong></p> " ;
$output .= " </div> \n " ;
2010-02-17 12:50:42 -05:00
}
2010-08-11 17:54:51 -04:00
echo $output ;
2010-02-17 12:50:42 -05:00
}
2008-10-01 21:03:26 -04:00
/**
* { @ internal Missing Short Description }}
*
2010-12-01 14:24:38 -05:00
* @ since 2.7 . 0
2008-10-01 21:03:26 -04:00
*
* @ param unknown_type $found_action
*/
2008-09-16 00:24:28 -04:00
function find_posts_div ( $found_action = '' ) {
?>
< div id = " find-posts " class = " find-box " style = " display:none; " >
< div id = " find-posts-head " class = " find-box-head " >< ? php _e ( 'Find Posts or Pages' ); ?> </div>
< div class = " find-box-inside " >
< div class = " find-box-search " >
< ? php if ( $found_action ) { ?>
2009-05-05 15:43:53 -04:00
< input type = " hidden " name = " found_action " value = " <?php echo esc_attr( $found_action ); ?> " />
2008-09-16 00:24:28 -04:00
< ? php } ?>
2008-09-21 15:45:45 -04:00
2008-09-16 00:24:28 -04:00
< input type = " hidden " name = " affected " id = " affected " value = " " />
< ? php wp_nonce_field ( 'find-posts' , '_ajax_nonce' , false ); ?>
2009-05-12 18:40:56 -04:00
< label class = " screen-reader-text " for = " find-posts-input " >< ? php _e ( 'Search' ); ?> </label>
2009-04-16 00:41:05 -04:00
< input type = " text " id = " find-posts-input " name = " ps " value = " " />
2010-10-22 15:23:00 -04:00
< input type = " button " id = " find-posts-search " value = " <?php esc_attr_e( 'Search' ); ?> " class = " button " />< br />
2008-09-16 00:24:28 -04:00
2010-05-24 22:18:07 -04:00
< ? php
$post_types = get_post_types ( array ( 'public' => true ), 'objects' );
foreach ( $post_types as $post ) {
if ( 'attachment' == $post -> name )
continue ;
?>
2011-12-14 12:36:38 -05:00
< input type = " radio " name = " find-posts-what " id = " find-posts-<?php echo esc_attr( $post->name ); ?> " value = " <?php echo esc_attr( $post->name ); ?> " < ? php checked ( $post -> name , 'post' ); ?> />
2010-05-24 22:18:07 -04:00
< label for = " find-posts-<?php echo esc_attr( $post->name ); ?> " >< ? php echo $post -> label ; ?> </label>
< ? php
} ?>
2008-09-16 00:24:28 -04:00
</ div >
< div id = " find-posts-response " ></ div >
</ div >
< div class = " find-box-buttons " >
2010-10-22 15:23:00 -04:00
< input id = " find-posts-close " type = " button " class = " button alignleft " value = " <?php esc_attr_e('Close'); ?> " />
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Select' ), 'button-primary alignright' , 'find-posts-submit' , false ); ?>
2008-09-16 00:24:28 -04:00
</ div >
</ div >
< ? php
}
2008-09-21 17:10:14 -04:00
/**
* Display the post password .
2008-10-07 21:18:16 -04:00
*
2009-05-05 15:43:53 -04:00
* The password is passed through { @ link esc_attr ()} to ensure that it
2008-10-01 21:03:26 -04:00
* is safe for placing in an html attribute .
2008-09-21 17:10:14 -04:00
*
2009-04-28 01:58:45 -04:00
* @ uses attr
2008-09-21 17:10:14 -04:00
* @ since 2.7 . 0
*/
function the_post_password () {
global $post ;
2010-08-11 17:54:51 -04:00
if ( isset ( $post -> post_password ) ) echo esc_attr ( $post -> post_password );
2008-09-21 17:10:14 -04:00
}
2008-09-25 19:49:24 -04:00
2008-09-30 17:32:13 -04:00
/**
* Get the post title .
2008-10-07 21:18:16 -04:00
*
2008-10-01 21:03:26 -04:00
* The post title is fetched and if it is blank then a default string is
* returned .
2008-09-30 17:32:13 -04:00
*
* @ since 2.7 . 0
2010-09-07 07:21:11 -04:00
* @ param int $post_id The post id . If not supplied the global $post is used .
* @ return string The post title if set
2008-09-30 17:32:13 -04:00
*/
2010-09-07 07:21:11 -04:00
function _draft_or_post_title ( $post_id = 0 ) {
2008-09-30 17:32:13 -04:00
$title = get_the_title ( $post_id );
if ( empty ( $title ) )
2008-10-05 00:43:52 -04:00
$title = __ ( '(no title)' );
2008-09-30 17:32:13 -04:00
return $title ;
}
2008-10-01 21:03:26 -04:00
2008-10-02 23:06:43 -04:00
/**
* Display the search query .
2008-10-07 21:18:16 -04:00
*
2008-10-02 23:06:43 -04:00
* A simple wrapper to display the " s " parameter in a GET URI . This function
* should only be used when { @ link the_search_query ()} cannot .
*
2009-04-28 01:58:45 -04:00
* @ uses attr
2008-10-02 23:06:43 -04:00
* @ since 2.7 . 0
2008-10-07 21:18:16 -04:00
*
2008-10-02 23:06:43 -04:00
*/
function _admin_search_query () {
2011-01-14 22:40:52 -05:00
echo isset ( $_REQUEST [ 's' ]) ? esc_attr ( stripslashes ( $_REQUEST [ 's' ] ) ) : '' ;
2008-10-13 19:39:56 -04:00
}
/**
* Generic Iframe header for use with Thickbox
*
* @ since 2.7 . 0
* @ param string $title Title of the Iframe page .
* @ param bool $limit_styles Limit styles to colour - related styles only ( unless others are enqueued ) .
*
*/
2009-05-16 15:21:29 -04:00
function iframe_header ( $title = '' , $limit_styles = false ) {
2010-10-23 15:49:25 -04:00
show_admin_bar ( false );
2011-10-23 14:01:33 -04:00
global $hook_suffix , $current_user , $admin_body_class , $wp_locale ;
2010-12-12 00:43:35 -05:00
$admin_body_class = preg_replace ( '/[^a-z0-9_-]+/i' , '-' , $hook_suffix );
2010-12-13 16:21:50 -05:00
2011-10-23 14:01:33 -04:00
$current_screen = get_current_screen ();
2011-10-17 16:57:32 -04:00
_wp_admin_html_begin ();
?>
2010-08-11 17:54:51 -04:00
< title >< ? php bloginfo ( 'name' ) ?> › <?php echo $title ?> — <?php _e('WordPress'); ?></title>
2008-10-13 19:39:56 -04:00
< ? php
2010-08-11 17:54:51 -04:00
wp_enqueue_style ( 'colors' );
2008-10-13 19:39:56 -04:00
?>
< script type = " text/javascript " >
//<![CDATA[
2009-03-19 20:14:57 -04:00
addLoadEvent = function ( func ){ if ( typeof jQuery != " undefined " ) jQuery ( document ) . ready ( func ); else if ( typeof wpOnload != 'function' ){ wpOnload = func ;} else { var oldonload = wpOnload ; wpOnload = function (){ oldonload (); func ();}}};
function tb_close (){ var win = window . dialogArguments || opener || parent || top ; win . tb_remove ();}
2010-12-12 00:43:35 -05:00
var userSettings = {
'url' : '<?php echo SITECOOKIEPATH; ?>' ,
'uid' : '<?php if ( ! isset($current_user) ) $current_user = wp_get_current_user(); echo $current_user->ID; ?>' ,
'time' : '<?php echo time() ?>'
},
2012-02-08 11:12:11 -05:00
ajaxurl = '<?php echo admin_url( ' admin - ajax . php ', ' relative ' ); ?>' ,
2010-12-12 00:43:35 -05:00
pagenow = '<?php echo $current_screen->id; ?>' ,
2011-11-17 13:01:08 -05:00
typenow = '<?php echo $current_screen->post_type; ?>' ,
2010-12-12 00:43:35 -05:00
adminpage = '<?php echo $admin_body_class; ?>' ,
thousandsSeparator = '<?php echo addslashes( $wp_locale->number_format[' thousands_sep '] ); ?>' ,
decimalPoint = '<?php echo addslashes( $wp_locale->number_format[' decimal_point '] ); ?>' ,
isRtl = < ? php echo ( int ) is_rtl (); ?> ;
2008-10-13 19:39:56 -04:00
//]]>
</ script >
< ? php
2010-12-12 00:43:35 -05:00
do_action ( 'admin_enqueue_scripts' , $hook_suffix );
do_action ( " admin_print_styles- $hook_suffix " );
2010-08-11 17:54:51 -04:00
do_action ( 'admin_print_styles' );
2010-12-12 00:43:35 -05:00
do_action ( " admin_print_scripts- $hook_suffix " );
2010-08-11 17:54:51 -04:00
do_action ( 'admin_print_scripts' );
2010-12-12 00:43:35 -05:00
do_action ( " admin_head- $hook_suffix " );
2010-08-11 17:54:51 -04:00
do_action ( 'admin_head' );
2012-02-03 19:54:42 -05:00
$admin_body_class .= ' locale-' . sanitize_html_class ( strtolower ( str_replace ( '_' , '-' , get_locale () ) ) );
2008-10-13 19:39:56 -04:00
?>
</ head >
2011-12-14 12:36:38 -05:00
< body < ? php if ( isset ( $GLOBALS [ 'body_id' ]) ) echo ' id="' . $GLOBALS [ 'body_id' ] . '"' ; ?> class="wp-admin no-js iframe <?php echo apply_filters( 'admin_body_class', '' ) . ' ' . $admin_body_class; ?>">
2010-04-17 08:27:13 -04:00
< script type = " text/javascript " >
//<![CDATA[
( function (){
var c = document . body . className ;
c = c . replace ( / no - js / , 'js' );
document . body . className = c ;
})();
//]]>
</ script >
2008-10-13 19:39:56 -04:00
< ? php
}
/**
* Generic Iframe footer for use with Thickbox
*
* @ since 2.7 . 0
*
*/
function iframe_footer () {
2009-05-16 15:21:29 -04:00
//We're going to hide any footer output on iframe pages, but run the hooks anyway since they output Javascript or other needed content. ?>
< div class = " hidden " >
< ? php
do_action ( 'admin_footer' , '' );
do_action ( 'admin_print_footer_scripts' ); ?>
</ div >
< script type = " text/javascript " > if ( typeof wpOnload == " function " ) wpOnload (); </ script >
</ body >
</ html >
< ? php
2008-10-02 23:06:43 -04:00
}
2008-10-13 23:49:57 -04:00
function _post_states ( $post ) {
$post_states = array ();
2011-11-14 22:51:28 -05:00
if ( isset ( $_REQUEST [ 'post_status' ] ) )
$post_status = $_REQUEST [ 'post_status' ];
2008-10-13 23:49:57 -04:00
else
$post_status = '' ;
if ( ! empty ( $post -> post_password ) )
2011-03-23 14:57:12 -04:00
$post_states [ 'protected' ] = __ ( 'Password protected' );
2008-10-13 23:49:57 -04:00
if ( 'private' == $post -> post_status && 'private' != $post_status )
2011-03-23 14:57:12 -04:00
$post_states [ 'private' ] = __ ( 'Private' );
2008-10-13 23:49:57 -04:00
if ( 'draft' == $post -> post_status && 'draft' != $post_status )
2011-03-23 14:57:12 -04:00
$post_states [ 'draft' ] = __ ( 'Draft' );
2008-10-13 23:49:57 -04:00
if ( 'pending' == $post -> post_status && 'pending' != $post_status )
2009-03-02 14:20:19 -05:00
/* translators: post state */
2011-03-23 14:57:12 -04:00
$post_states [ 'pending' ] = _x ( 'Pending' , 'post state' );
2009-02-17 14:13:31 -05:00
if ( is_sticky ( $post -> ID ) )
2011-03-23 14:57:12 -04:00
$post_states [ 'sticky' ] = __ ( 'Sticky' );
2008-10-13 23:49:57 -04:00
2009-02-04 11:52:36 -05:00
$post_states = apply_filters ( 'display_post_states' , $post_states );
2008-10-13 23:49:57 -04:00
if ( ! empty ( $post_states ) ) {
$state_count = count ( $post_states );
$i = 0 ;
2008-10-14 02:07:49 -04:00
echo ' - ' ;
2008-10-13 23:49:57 -04:00
foreach ( $post_states as $state ) {
++ $i ;
( $i == $state_count ) ? $sep = '' : $sep = ', ' ;
echo " <span class='post-state'> $state $sep </span> " ;
}
}
2010-12-30 23:49:27 -05:00
if ( get_post_format ( $post -> ID ) )
echo ' - <span class="post-state-format">' . get_post_format_string ( get_post_format ( $post -> ID ) ) . '</span>' ;
2008-10-13 23:49:57 -04:00
}
2011-05-04 14:28:31 -04:00
function _media_states ( $post ) {
$media_states = array ();
$stylesheet = get_option ( 'stylesheet' );
if ( current_theme_supports ( 'custom-header' ) ) {
$meta_header = get_post_meta ( $post -> ID , '_wp_attachment_is_custom_header' , true );
if ( ! empty ( $meta_header ) && $meta_header == $stylesheet )
$media_states [] = __ ( 'Header Image' );
}
if ( current_theme_supports ( 'custom-background' ) ) {
$meta_background = get_post_meta ( $post -> ID , '_wp_attachment_is_custom_background' , true );
if ( ! empty ( $meta_background ) && $meta_background == $stylesheet )
$media_states [] = __ ( 'Background Image' );
}
$media_states = apply_filters ( 'display_media_states' , $media_states );
if ( ! empty ( $media_states ) ) {
$state_count = count ( $media_states );
$i = 0 ;
echo ' - ' ;
foreach ( $media_states as $state ) {
++ $i ;
( $i == $state_count ) ? $sep = '' : $sep = ', ' ;
echo " <span class='post-state'> $state $sep </span> " ;
}
}
}
2009-01-14 09:18:51 -05:00
/**
2009-01-26 07:59:10 -05:00
* Test support for compressing JavaScript from PHP
2009-01-14 09:18:51 -05:00
*
* Outputs JavaScript that tests if compression from PHP works as expected
* and sets an option with the result . Has no effect when the current user
* is not an administrator . To run the test again the option 'can_compress_scripts'
2009-02-01 04:45:24 -05:00
* has to be deleted .
2009-01-14 09:18:51 -05:00
*
* @ since 2.8 . 0
*/
function compression_test () {
?>
< script type = " text/javascript " >
/* <![CDATA[ */
2009-02-01 04:45:24 -05:00
var testCompression = {
get : function ( test ) {
var x ;
if ( window . XMLHttpRequest ) {
x = new XMLHttpRequest ();
} else {
try { x = new ActiveXObject ( 'Msxml2.XMLHTTP' );} catch ( e ){ try { x = new ActiveXObject ( 'Microsoft.XMLHTTP' );} catch ( e ){};}
}
if ( x ) {
x . onreadystatechange = function () {
var r , h ;
if ( x . readyState == 4 ) {
r = x . responseText . substr ( 0 , 18 );
h = x . getResponseHeader ( 'Content-Encoding' );
testCompression . check ( r , h , test );
}
}
2010-12-02 09:15:25 -05:00
x . open ( 'GET' , ajaxurl + '?action=wp-compression-test&test=' + test + '&' + ( new Date ()) . getTime (), true );
2009-02-01 04:45:24 -05:00
x . send ( '' );
}
},
check : function ( r , h , test ) {
if ( ! r && ! test )
this . get ( 1 );
if ( 1 == test ) {
if ( h && ( h . match ( / deflate / i ) || h . match ( / gzip / i ) ) )
this . get ( 'no' );
else
this . get ( 2 );
return ;
}
if ( 2 == test ) {
if ( '"wpCompressionTest' == r )
this . get ( 'yes' );
else
this . get ( 'no' );
}
2009-01-14 09:18:51 -05:00
}
2009-02-01 04:45:24 -05:00
};
testCompression . check ();
2009-01-14 09:18:51 -05:00
/* ]]> */
</ script >
< ? php
}
2010-10-14 15:58:06 -04:00
/**
2010-10-28 17:56:43 -04:00
* Echos a submit button , with provided text and appropriate class
2010-10-14 15:58:06 -04:00
*
* @ since 3.1 . 0
*
* @ param string $text The text of the button ( defaults to 'Save Changes' )
* @ param string $type The type of button . One of : primary , secondary , delete
2010-10-28 17:56:43 -04:00
* @ param string $name The HTML name of the submit button . Defaults to " submit " . If no id attribute
* is given in $other_attributes below , $name will be used as the button ' s id .
* @ param bool $wrap True if the output button should be wrapped in a paragraph tag ,
* false otherwise . Defaults to true
* @ param array | string $other_attributes Other attributes that should be output with the button ,
* mapping attributes to their values , such as array ( 'tabindex' => '1' ) .
2011-09-03 10:18:10 -04:00
* These attributes will be output as attribute = " value " , such as tabindex = " 1 " .
2010-10-28 17:56:43 -04:00
* Defaults to no other attributes . Other attributes can also be provided as a
* string such as 'tabindex="1"' , though the array format is typically cleaner .
2010-10-14 15:58:06 -04:00
*/
2012-01-05 15:50:54 -05:00
function submit_button ( $text = null , $type = 'primary' , $name = 'submit' , $wrap = true , $other_attributes = null ) {
2010-10-28 17:56:43 -04:00
echo get_submit_button ( $text , $type , $name , $wrap , $other_attributes );
2010-10-14 15:58:06 -04:00
}
/**
2010-10-28 17:56:43 -04:00
* Returns a submit button , with provided text and appropriate class
2010-10-14 15:58:06 -04:00
*
* @ since 3.1 . 0
*
* @ param string $text The text of the button ( defaults to 'Save Changes' )
* @ param string $type The type of button . One of : primary , secondary , delete
2010-10-28 17:56:43 -04:00
* @ param string $name The HTML name of the submit button . Defaults to " submit " . If no id attribute
* is given in $other_attributes below , $name will be used as the button ' s id .
* @ param bool $wrap True if the output button should be wrapped in a paragraph tag ,
* false otherwise . Defaults to true
* @ param array | string $other_attributes Other attributes that should be output with the button ,
* mapping attributes to their values , such as array ( 'tabindex' => '1' ) .
2011-09-03 10:18:10 -04:00
* These attributes will be output as attribute = " value " , such as tabindex = " 1 " .
2010-10-28 17:56:43 -04:00
* Defaults to no other attributes . Other attributes can also be provided as a
* string such as 'tabindex="1"' , though the array format is typically cleaner .
2010-10-14 15:58:06 -04:00
*/
2012-01-05 15:50:54 -05:00
function get_submit_button ( $text = null , $type = 'primary' , $name = 'submit' , $wrap = true , $other_attributes = null ) {
2010-10-14 15:58:06 -04:00
switch ( $type ) :
case 'primary' :
case 'secondary' :
$class = 'button-' . $type ;
break ;
case 'delete' :
$class = 'button-secondary delete' ;
break ;
default :
$class = $type ; // Custom cases can just pass in the classes they want to be used
endswitch ;
2012-01-05 15:50:54 -05:00
$text = ( null == $text ) ? __ ( 'Save Changes' ) : $text ;
2010-11-17 13:47:34 -05:00
2010-11-24 11:30:40 -05:00
// Default the id attribute to $name unless an id was specifically provided in $other_attributes
$id = $name ;
if ( is_array ( $other_attributes ) && isset ( $other_attributes [ 'id' ] ) ) {
$id = $other_attributes [ 'id' ];
unset ( $other_attributes [ 'id' ] );
}
2010-10-28 17:56:43 -04:00
$attributes = '' ;
if ( is_array ( $other_attributes ) ) {
foreach ( $other_attributes as $attribute => $value ) {
$attributes .= $attribute . '="' . esc_attr ( $value ) . '" ' ; // Trailing space is important
}
} else if ( ! empty ( $other_attributes ) ) { // Attributes provided as a string
$attributes = $other_attributes ;
}
2010-11-17 13:47:34 -05:00
2010-10-30 02:14:15 -04:00
$button = '<input type="submit" name="' . esc_attr ( $name ) . '" id="' . esc_attr ( $id ) . '" class="' . esc_attr ( $class );
2010-10-28 17:56:43 -04:00
$button .= '" value="' . esc_attr ( $text ) . '" ' . $attributes . ' />' ;
2010-11-17 13:47:34 -05:00
2010-10-28 17:56:43 -04:00
if ( $wrap ) {
$button = '<p class="submit">' . $button . '</p>' ;
}
2010-11-17 13:47:34 -05:00
2010-10-28 17:56:43 -04:00
return $button ;
2010-10-14 15:58:06 -04:00
}
2011-09-18 17:17:09 -04:00
2011-10-17 16:57:32 -04:00
function _wp_admin_html_begin () {
2012-06-07 18:05:01 -04:00
$admin_html_class = ( is_admin_bar_showing () ) ? 'wp-toolbar' : '' ;
2011-10-17 16:57:32 -04:00
?>
<! DOCTYPE html >
<!-- [ if IE 8 ] >
2012-06-07 18:05:01 -04:00
< html xmlns = " http://www.w3.org/1999/xhtml " class = " ie8 <?php echo $admin_html_class ; ?> " < ? php do_action ( 'admin_xml_ns' ); ?> <?php language_attributes(); ?>>
2011-10-17 16:57:32 -04:00
<! [ endif ] -->
<!-- [ if ! ( IE 8 ) ] ><!-->
2012-06-07 18:05:01 -04:00
< html xmlns = " http://www.w3.org/1999/xhtml " class = " <?php echo $admin_html_class ; ?> " < ? php do_action ( 'admin_xml_ns' ); ?> <?php language_attributes(); ?>>
2011-10-17 16:57:32 -04:00
<!--<! [ endif ] -->
< head >
< meta http - equiv = " Content-Type " content = " <?php bloginfo('html_type'); ?>; charset=<?php echo get_option('blog_charset'); ?> " />
< ? php
}
2011-11-21 17:39:48 -05:00
final class WP_Internal_Pointers {
/**
* Initializes the new feature pointers .
*
* @ since 3.3 . 0
*
* All pointers can be disabled using the following :
* remove_action ( 'admin_enqueue_scripts' , array ( 'WP_Internal_Pointers' , 'enqueue_scripts' ) );
*
2011-11-21 18:04:35 -05:00
* Individual pointers ( e . g . wp330_toolbar ) can be disabled using the following :
2011-11-21 17:39:48 -05:00
* remove_action ( 'admin_print_footer_scripts' , array ( 'WP_Internal_Pointers' , 'pointer_wp330_toolbar' ) );
*/
public static function enqueue_scripts ( $hook_suffix ) {
/*
* Register feature pointers
* Format : array ( hook_suffix => pointer_id )
*/
2011-11-22 16:50:50 -05:00
2011-11-21 17:39:48 -05:00
$registered_pointers = array (
2011-11-21 18:04:35 -05:00
'index.php' => 'wp330_toolbar' ,
'post-new.php' => 'wp330_media_uploader' ,
'post.php' => 'wp330_media_uploader' ,
2012-05-11 16:29:08 -04:00
'themes.php' => array ( 'wp330_saving_widgets' , 'wp340_customize_current_theme_link' ),
2012-05-21 16:34:20 -04:00
'appearance_page_custom-header' => 'wp340_choose_image_from_library' ,
'appearance_page_custom-background' => 'wp340_choose_image_from_library' ,
2011-11-21 17:39:48 -05:00
);
// Check if screen related pointer is registered
if ( empty ( $registered_pointers [ $hook_suffix ] ) )
return ;
2011-09-18 17:17:09 -04:00
2012-05-11 16:29:08 -04:00
$pointers = ( array ) $registered_pointers [ $hook_suffix ];
2011-10-10 19:31:36 -04:00
2011-11-30 10:59:55 -05:00
$caps_required = array (
'wp330_media_uploader' => array ( 'upload_files' ),
'wp330_saving_widgets' => array ( 'edit_theme_options' , 'switch_themes' ),
2012-05-11 16:29:08 -04:00
'wp340_customize_current_theme_link' => array ( 'edit_theme_options' ),
2012-05-21 16:34:20 -04:00
'wp340_choose_image_from_library' => array ( 'edit_theme_options' ),
2011-11-30 10:59:55 -05:00
);
2011-11-21 17:39:48 -05:00
// Get dismissed pointers
$dismissed = explode ( ',' , ( string ) get_user_meta ( get_current_user_id (), 'dismissed_wp_pointers' , true ) );
2012-05-11 16:29:08 -04:00
$got_pointers = false ;
foreach ( array_diff ( $pointers , $dismissed ) as $pointer ) {
if ( isset ( $caps_required [ $pointer ] ) ) {
foreach ( $caps_required [ $pointer ] as $cap ) {
if ( ! current_user_can ( $cap ) )
continue 2 ;
}
}
2011-11-21 17:39:48 -05:00
2012-05-11 16:29:08 -04:00
// Bind pointer print function
add_action ( 'admin_print_footer_scripts' , array ( 'WP_Internal_Pointers' , 'pointer_' . $pointer ) );
$got_pointers = true ;
}
if ( ! $got_pointers )
return ;
2011-09-18 17:17:09 -04:00
2011-11-21 17:39:48 -05:00
// Add pointers script and style to queue
2011-09-18 17:17:09 -04:00
wp_enqueue_style ( 'wp-pointer' );
wp_enqueue_script ( 'wp-pointer' );
}
2011-11-21 17:39:48 -05:00
/**
* Print the pointer javascript data .
*
* @ since 3.3 . 0
*
* @ param string $pointer_id The pointer ID .
* @ param string $selector The HTML elements , on which the pointer should be attached .
* @ param array $args Arguments to be passed to the pointer JS ( see wp - pointer . dev . js ) .
*/
private static function print_js ( $pointer_id , $selector , $args ) {
if ( empty ( $pointer_id ) || empty ( $selector ) || empty ( $args ) || empty ( $args [ 'content' ] ) )
return ;
2011-09-18 17:17:09 -04:00
2011-11-21 17:39:48 -05:00
?>
< script type = " text/javascript " >
//<![CDATA[
2012-05-24 02:45:49 -04:00
( function ( $ ){
var options = < ? php echo json_encode ( $args ); ?> , setup;
2011-11-21 17:39:48 -05:00
if ( ! options )
return ;
options = $ . extend ( options , {
close : function () {
$ . post ( ajaxurl , {
pointer : '<?php echo $pointer_id; ?>' ,
action : 'dismiss-wp-pointer'
});
}
2011-10-10 19:31:36 -04:00
});
2011-11-21 17:39:48 -05:00
2012-05-24 02:45:49 -04:00
setup = function () {
$ ( '<?php echo $selector; ?>' ) . pointer ( options ) . pointer ( 'open' );
};
2012-05-24 18:50:30 -04:00
if ( options . position && options . position . defer_loading )
2012-05-24 02:45:49 -04:00
$ ( window ) . bind ( 'load.wp-pointers' , setup );
else
$ ( document ) . ready ( setup );
})( jQuery );
2011-11-21 17:39:48 -05:00
//]]>
</ script >
< ? php
}
public static function pointer_wp330_toolbar () {
2012-01-03 13:04:56 -05:00
$content = '<h3>' . __ ( 'New Feature: Toolbar' ) . '</h3>' ;
$content .= '<p>' . __ ( 'We’ve combined the admin bar and the old Dashboard header into one persistent toolbar. Hover over the toolbar items to see what’s new.' ) . '</p>' ;
2011-11-21 17:39:48 -05:00
if ( is_multisite () && is_super_admin () )
2012-01-03 13:04:56 -05:00
$content .= '<p>' . __ ( 'Network Admin is now located in the My Sites menu.' ) . '</p>' ;
2011-11-21 17:39:48 -05:00
2011-11-21 18:04:35 -05:00
WP_Internal_Pointers :: print_js ( 'wp330_toolbar' , '#wpadminbar' , array (
2011-11-21 17:39:48 -05:00
'content' => $content ,
'position' => array ( 'edge' => 'top' , 'align' => 'center' ),
) );
}
/**
* Print 'Updated Media Uploader' for 3.3 . 0.
*
* @ since 3.3 . 0
*/
public static function pointer_wp330_media_uploader () {
2012-01-03 13:04:56 -05:00
$content = '<h3>' . __ ( 'Updated Media Uploader' ) . '</h3>' ;
$content .= '<p>' . __ ( 'The single media icon now launches the uploader for all file types, and the new drag and drop interface makes uploading a breeze.' ) . '</p>' ;
2011-11-21 17:39:48 -05:00
2011-11-21 18:04:35 -05:00
WP_Internal_Pointers :: print_js ( 'wp330_media_uploader' , '#content-add_media' , array (
2011-11-21 17:39:48 -05:00
'content' => $content ,
2011-11-23 13:53:11 -05:00
'position' => array ( 'edge' => is_rtl () ? 'right' : 'left' , 'align' => 'center' ),
2011-11-21 17:39:48 -05:00
) );
}
/**
* Print 'New Feature: Saving Widgets' for 3.3 . 0.
*
* @ since 3.3 . 0
*/
public static function pointer_wp330_saving_widgets () {
2012-01-03 13:04:56 -05:00
$content = '<h3>' . __ ( 'New Feature: Saving Widgets' ) . '</h3>' ;
2012-01-03 13:06:03 -05:00
$content .= '<p>' . __ ( 'If you change your mind and revert to your previous theme, we’ll put the widgets back the way you had them.' ) . '</p>' ;
2011-11-21 17:39:48 -05:00
2011-11-21 18:04:35 -05:00
WP_Internal_Pointers :: print_js ( 'wp330_saving_widgets' , '#message2' , array (
2011-11-21 17:39:48 -05:00
'content' => $content ,
2011-11-23 13:53:11 -05:00
'position' => array ( 'edge' => 'top' , 'align' => is_rtl () ? 'right' : 'left' ),
2011-11-21 17:39:48 -05:00
) );
}
2011-11-30 11:05:59 -05:00
2012-05-11 16:29:08 -04:00
/**
* Print 'New Feature: Current Theme Customize Link' for 3.4 . 0.
*
* @ since 3.4 . 0
*/
public static function pointer_wp340_customize_current_theme_link () {
$content = '<h3>' . __ ( 'New Feature: Customizer' ) . '</h3>' ;
$content .= '<p>' . __ ( 'Click Customize to change the header, background, title and menus of the current theme, all in one place.' ) . '</p>' ;
2012-05-23 15:49:14 -04:00
$content .= '<p>' . __ ( 'Click the Live Preview links in the Available Themes list below to customize and preview another theme before activating it.' ) . '</p>' ;
2012-05-11 16:29:08 -04:00
WP_Internal_Pointers :: print_js ( 'wp340_customize_current_theme_link' , '#customize-current-theme-link' , array (
'content' => $content ,
2012-05-24 12:34:51 -04:00
'position' => array ( 'edge' => 'top' , 'align' => is_rtl () ? 'right' : 'left' , 'offset' => is_rtl () ? '32 0' : '-32 0' ),
2012-05-11 16:29:08 -04:00
) );
}
2012-05-21 16:34:20 -04:00
/**
* Print 'New Feature: Choose Image from Library' for 3.4 . 0.
*
* @ since 3.4 . 0
*/
public static function pointer_wp340_choose_image_from_library () {
$content = '<h3>' . __ ( 'New Feature: Choose Image from Library' ) . '</h3>' ;
$content .= '<p>' . __ ( 'Want to use an image you uploaded earlier? Select it from your media library instead of uploading it again.' ) . '</p>' ;
WP_Internal_Pointers :: print_js ( 'wp340_choose_image_from_library' , '#choose-from-library-link' , array (
'content' => $content ,
2012-05-24 03:02:25 -04:00
'position' => array ( 'edge' => 'top' , 'align' => is_rtl () ? 'right' : 'left' , 'defer_loading' => true ),
2012-05-21 16:34:20 -04:00
) );
}
2011-11-30 11:05:59 -05:00
/**
* Prevents new users from seeing existing 'new feature' pointers .
*
* @ since 3.3 . 0
*/
public static function dismiss_pointers_for_new_users ( $user_id ) {
add_user_meta ( $user_id , 'dismissed_wp_pointers' , 'wp330_toolbar,wp330_media_uploader,wp330_saving_widgets' );
}
2011-10-01 16:50:08 -04:00
}
2011-11-21 17:39:48 -05:00
2011-11-30 11:05:59 -05:00
add_action ( 'admin_enqueue_scripts' , array ( 'WP_Internal_Pointers' , 'enqueue_scripts' ) );
2011-12-08 16:55:39 -05:00
add_action ( 'user_register' , array ( 'WP_Internal_Pointers' , 'dismiss_pointers_for_new_users' ) );
2011-11-23 16:29:33 -05:00
/**
* Convert a screen string to a screen object
*
* @ since 3.0 . 0
*
* @ param string $hook_name The hook name ( also known as the hook suffix ) used to determine the screen .
* @ return WP_Screen Screen object .
*/
function convert_to_screen ( $hook_name ) {
2011-11-25 00:15:28 -05:00
if ( ! class_exists ( 'WP_Screen' ) ) {
2011-11-23 16:29:33 -05:00
_doing_it_wrong ( 'convert_to_screen(), add_meta_box()' , __ ( " Likely direct inclusion of wp-admin/includes/template.php in order to use add_meta_box(). This is very wrong. Hook the add_meta_box() call into the add_meta_boxes action instead. " ), '3.3' );
return ( object ) array ( 'id' => '_invalid' , 'base' => '_are_belong_to_us' );
}
return WP_Screen :: get ( $hook_name );
2012-01-13 13:15:55 -05:00
}