WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
05/29/2015 08:16:22 PM (9 years ago)
Author:
wonderboymusic
Message:

Add missing doc blocks to wp-admin/includes/*.
Fix some egregious uses of tabbing.
Some functions can simply return apply_filters(...) instead of setting a variable that is immediately returned.

See #32444.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-admin/includes/class-wp-comments-list-table.php

    r32651 r32654  
    5454    }
    5555
     56    /**
     57     * @return bool
     58     */
    5659    public function ajax_user_can() {
    5760        return current_user_can('edit_posts');
    … …  
    159162         * @param string $comment_status    The comment status name. Default 'All'.
    160163         */
    161         $comments_per_page = apply_filters( 'comments_per_page', $comments_per_page, $comment_status );
    162         return $comments_per_page;
     164        return apply_filters( 'comments_per_page', $comments_per_page, $comment_status );
    163165    }
    164166
    … …  
    231233         *                            Accepts 'All', 'Pending', 'Approved', 'Spam', and 'Trash'.
    232234         */
    233         $status_links = apply_filters( 'comment_status_links', $status_links );
    234         return $status_links;
     235        return apply_filters( 'comment_status_links', $status_links );
    235236    }
    236237
    … …  
    238239     *
    239240     * @global string $comment_status
     241     *
     242     * @return array
    240243     */
    241244    protected function get_bulk_actions() {
    … …  
    267270     * @global string $comment_status
    268271     * @global string $comment_type
     272     *
    269273     * @param string $which
    270274     */
    … …  
    322326    }
    323327
     328    /**
     329     * @return string|false
     330     */
    324331    public function current_action() {
    325332        if ( isset( $_REQUEST['delete_all'] ) || isset( $_REQUEST['delete_all2'] ) )
    … …  
    332339     *
    333340     * @global int $post_id
     341     *
    334342     * @return array
    335343     */
    … …  
    351359    }
    352360
     361    /**
     362     *
     363     * @return array
     364     */
    353365    protected function get_sortable_columns() {
    354366        return array(
    … …  
    407419     * @global WP_Post $post
    408420     * @global object  $comment
     421     *
    409422     * @param object $a_comment
    410423     */
    … …  
    438451     * @param string $primary Primary column name
    439452     *
    440      * @return string
     453     * @return string|void
    441454     */
    442455    protected function handle_row_actions( $comment, $column_name, $primary ) {
    443456        global $comment_status;
    444  
     457
    445458        if ( ! $this->user_can ) {
    446459            return;
    447 
    448460        }
    449461
    … …  
    543555    }
    544556
     557    /**
     558     *
     559     * @param object $comment
     560     */
    545561    public function column_cb( $comment ) {
    546562        if ( $this->user_can ) { ?>
    … …  
    554570     *
    555571     * @global string $comment_status
     572     *
    556573     * @param object $comment
    557574     */
    … …  
    602619     *
    603620     * @global string $comment_status
     621     *
    604622     * @param object $comment
    605623     */
    … …  
    635653    }
    636654
     655    /**
     656     *
     657     * @return string
     658     */
    637659    public function column_date() {
    638660        return get_comment_date( __( 'Y/m/d \a\t g:i a' ) );
    … …  
    667689    }
    668690
     691    /**
     692     *
     693     * @param object $comment
     694     * @param string $column_name
     695     */
    669696    public function column_default( $comment, $column_name ) {
    670697        /**
    … …  
    692719class WP_Post_Comments_List_Table extends WP_Comments_List_Table {
    693720
     721    /**
     722     *
     723     * @return array
     724     */
    694725    protected function get_column_info() {
    695726        return array(
    … …  
    704735    }
    705736
     737    /**
     738     *
     739     * @return array
     740     */
    706741    protected function get_table_classes() {
    707742        $classes = parent::get_table_classes();
    … …  
    710745    }
    711746
     747    /**
     748     *
     749     * @param bool $output_empty
     750     */
    712751    public function display( $output_empty = false ) {
    713752        $singular = $this->_args['singular'];
    … …  
    728767    }
    729768
     769    /**
     770     *
     771     * @param bool $comment_status
     772     * @return int
     773     */
    730774    public function get_per_page( $comment_status = false ) {
    731775        return 10;
Note: See TracChangeset for help on using the changeset viewer.