WordPress 4.0
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-terms-list-table.php
index bf31468a6b37643b5c59ceee4c9a63bc7203c95b..743dfde45a8994b99dc6914775162cf144c9ccf2 100644 (file)
@@ -9,9 +9,19 @@
  */
 class WP_Terms_List_Table extends WP_List_Table {
 
-       var $callback_args;
+       public $callback_args;
 
-       function __construct( $args = array() ) {
+       /**
+        * Constructor.
+        *
+        * @since 3.1.0
+        * @access public
+        *
+        * @see WP_List_Table::__construct() for more information on default arguments.
+        *
+        * @param array $args An associative array of arguments.
+        */
+       public function __construct( $args = array() ) {
                global $post_type, $taxonomy, $action, $tax;
 
                parent::__construct( array(
@@ -38,11 +48,11 @@ class WP_Terms_List_Table extends WP_List_Table {
 
        }
 
-       function ajax_user_can() {
+       public function ajax_user_can() {
                return current_user_can( get_taxonomy( $this->screen->taxonomy )->cap->manage_terms );
        }
 
-       function prepare_items() {
+       public function prepare_items() {
                $tags_per_page = $this->get_items_per_page( 'edit_' . $this->screen->taxonomy . '_per_page' );
 
                if ( 'post_tag' == $this->screen->taxonomy ) {
@@ -97,26 +107,26 @@ class WP_Terms_List_Table extends WP_List_Table {
                ) );
        }
 
-       function has_items() {
+       public function has_items() {
                // todo: populate $this->items in prepare_items()
                return true;
        }
 
-       function get_bulk_actions() {
+       protected function get_bulk_actions() {
                $actions = array();
                $actions['delete'] = __( 'Delete' );
 
                return $actions;
        }
 
-       function current_action() {
+       public function current_action() {
                if ( isset( $_REQUEST['action'] ) && isset( $_REQUEST['delete_tags'] ) && ( 'delete' == $_REQUEST['action'] || 'delete' == $_REQUEST['action2'] ) )
                        return 'bulk-delete';
 
                return parent::current_action();
        }
 
-       function get_columns() {
+       public function get_columns() {
                $columns = array(
                        'cb'          => '<input type="checkbox" />',
                        'name'        => _x( 'Name', 'term name' ),
@@ -127,14 +137,13 @@ class WP_Terms_List_Table extends WP_List_Table {
                if ( 'link_category' == $this->screen->taxonomy ) {
                        $columns['links'] = __( 'Links' );
                } else {
-                       $post_type_object = get_post_type_object( $this->screen->post_type );
-                       $columns['posts'] = $post_type_object ? $post_type_object->labels->name : __( 'Posts' );
+                       $columns['posts'] = _x( 'Count', 'Number/count of items' );
                }
 
                return $columns;
        }
 
-       function get_sortable_columns() {
+       protected function get_sortable_columns() {
                return array(
                        'name'        => 'name',
                        'description' => 'description',
@@ -144,7 +153,7 @@ class WP_Terms_List_Table extends WP_List_Table {
                );
        }
 
-       function display_rows_or_placeholder() {
+       public function display_rows_or_placeholder() {
                $taxonomy = $this->screen->taxonomy;
 
                $args = wp_parse_args( $this->callback_args, array(
@@ -154,46 +163,46 @@ class WP_Terms_List_Table extends WP_List_Table {
                        'hide_empty' => 0
                ) );
 
-               extract( $args, EXTR_SKIP );
+               $page = $args['page'];
+
+               // Set variable because $args['number'] can be subsequently overridden.
+               $number = $args['number'];
 
                $args['offset'] = $offset = ( $page - 1 ) * $number;
 
-               // convert it to table rows
+               // Convert it to table rows.
                $count = 0;
 
-               $terms = array();
-
-               if ( is_taxonomy_hierarchical( $taxonomy ) && !isset( $orderby ) ) {
+               if ( is_taxonomy_hierarchical( $taxonomy ) && ! isset( $args['orderby'] ) ) {
                        // We'll need the full set of terms then.
                        $args['number'] = $args['offset'] = 0;
                }
                $terms = get_terms( $taxonomy, $args );
 
                if ( empty( $terms ) ) {
-                       list( $columns, $hidden ) = $this->get_column_info();
                        echo '<tr class="no-items"><td class="colspanchange" colspan="' . $this->get_column_count() . '">';
                        $this->no_items();
                        echo '</td></tr>';
                        return;
                }
 
-               if ( is_taxonomy_hierarchical( $taxonomy ) && !isset( $orderby ) ) {
-                       if ( !empty( $search ) ) // Ignore children on searches.
+               if ( is_taxonomy_hierarchical( $taxonomy ) && ! isset( $args['orderby'] ) ) {
+                       if ( ! empty( $args['search'] ) ) {// Ignore children on searches.
                                $children = array();
-                       else
+                       } else {
                                $children = _get_term_hierarchy( $taxonomy );
-
+                       }
                        // Some funky recursion to get the job done( Paging & parents mainly ) is contained within, Skip it for non-hierarchical taxonomies for performance sake
                        $this->_rows( $taxonomy, $terms, $children, $offset, $number, $count );
                } else {
                        $terms = get_terms( $taxonomy, $args );
-                       foreach ( $terms as $term )
+                       foreach ( $terms as $term ) {
                                $this->single_row( $term );
-                       $count = $number; // Only displaying a single page.
+                       }
                }
        }
 
-       function _rows( $taxonomy, $terms, &$children, $start, $per_page, &$count, $parent = 0, $level = 0 ) {
+       private function _rows( $taxonomy, $terms, &$children, $start, $per_page, &$count, $parent = 0, $level = 0 ) {
 
                $end = $start + $per_page;
 
@@ -241,7 +250,10 @@ class WP_Terms_List_Table extends WP_List_Table {
                }
        }
 
-       function single_row( $tag, $level = 0 ) {
+       public function single_row( $tag, $level = 0 ) {
+               global $taxonomy;
+               $tag = sanitize_term( $tag, $taxonomy );
+
                static $row_class = '';
                $row_class = ( $row_class == '' ? ' class="alternate"' : '' );
 
@@ -252,7 +264,7 @@ class WP_Terms_List_Table extends WP_List_Table {
                echo '</tr>';
        }
 
-       function column_cb( $tag ) {
+       public function column_cb( $tag ) {
                $default_term = get_option( 'default_' . $this->screen->taxonomy );
 
                if ( current_user_can( get_taxonomy( $this->screen->taxonomy )->cap->delete_terms ) && $tag->term_id != $default_term )
@@ -262,7 +274,7 @@ class WP_Terms_List_Table extends WP_List_Table {
                return '&nbsp;';
        }
 
-       function column_name( $tag ) {
+       public function column_name( $tag ) {
                $taxonomy = $this->screen->taxonomy;
                $tax = get_taxonomy( $taxonomy );
 
@@ -336,16 +348,16 @@ class WP_Terms_List_Table extends WP_List_Table {
                return $out;
        }
 
-       function column_description( $tag ) {
+       public function column_description( $tag ) {
                return $tag->description;
        }
 
-       function column_slug( $tag ) {
+       public function column_slug( $tag ) {
                /** This filter is documented in wp-admin/edit-tag-form.php */
                return apply_filters( 'editable_slug', $tag->slug );
        }
 
-       function column_posts( $tag ) {
+       public function column_posts( $tag ) {
                $count = number_format_i18n( $tag->count );
 
                $tax = get_taxonomy( $this->screen->taxonomy );
@@ -369,14 +381,14 @@ class WP_Terms_List_Table extends WP_List_Table {
                return "<a href='" . esc_url ( add_query_arg( $args, 'edit.php' ) ) . "'>$count</a>";
        }
 
-       function column_links( $tag ) {
+       public function column_links( $tag ) {
                $count = number_format_i18n( $tag->count );
                if ( $count )
                        $count = "<a href='link-manager.php?cat_id=$tag->term_id'>$count</a>";
                return $count;
        }
 
-       function column_default( $tag, $column_name ) {
+       public function column_default( $tag, $column_name ) {
                /**
                 * Filter the displayed columns in the terms list table.
                 *
@@ -397,7 +409,7 @@ class WP_Terms_List_Table extends WP_List_Table {
         *
         * @since 3.1.0
         */
-       function inline_edit() {
+       public function inline_edit() {
                $tax = get_taxonomy( $this->screen->taxonomy );
 
                if ( ! current_user_can( $tax->cap->edit_terms ) )