WordPress.org
Get WordPress

Make WordPress Core

Changeset 32654


Ignore:
Timestamp:
05/29/2015 08:16:22 PM (10 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.

Location:
trunk/src/wp-admin
Files:
44 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-admin/credits.php

    r32277 r32654  
    1919 * @since 3.2.0
    2020 *
    21  * @return array|bool A list of all of the contributors, or false on error.
     21 * @return array|false A list of all of the contributors, or false on error.
    2222*/
    2323function wp_credits() {
    … …  
    5656 * @param string $username      The contributor's username.
    5757 * @param string $profiles      URL to the contributor's WordPress.org profile page.
    58  * @return string A contributor's display name, hyperlinked to a WordPress.org profile page.
    5958 */
    6059function _wp_credits_add_profile_link( &$display_name, $username, $profiles ) {
    … …  
    6968 *
    7069 * @param string &$data External library data, passed by reference.
    71  * @return string Link to the external library.
    7270 */
    7371function _wp_credits_build_object_link( &$data ) {

  • trunk/src/wp-admin/custom-background.php

    r32116 r32654  
    109109     */
    110110    public function take_action() {
    111 
    112111        if ( empty($_POST) )
    113112            return;
    … …  
    358357     */
    359358    public function handle_upload() {
    360 
    361359        if ( empty($_FILES) )
    362360            return;
    … …  
    435433     * @since 3.4.0
    436434     * @deprecated 3.5.0
     435     *
     436     * @param array $form_fields
     437     * @return $form_fields
    437438     */
    438439    public function attachment_fields_to_edit( $form_fields ) {
    … …  
    444445     * @since 3.4.0
    445446     * @deprecated 3.5.0
     447     *
     448     * @param $tabs
     449     * @return $tabs
    446450     */
    447451    public function filter_upload_tabs( $tabs ) {

  • trunk/src/wp-admin/custom-header.php

    r32642 r32654  
    318318        }
    319319        ?>
    320 
    321320<script type="text/javascript">
    322321(function($){
    … …  
    926925     *
    927926     * @since 3.4.0
     927     *
     928     * @param array $form_fields
     929     * @return $form_fields
    928930     */
    929931    public function attachment_fields_to_edit( $form_fields ) {
    … …  
    935937     *
    936938     * @since 3.4.0
     939     *
     940     * @param array $tabs
     941     * @return $tabs
    937942     */
    938943    public function filter_upload_tabs( $tabs ) {
    … …  
    951956     *
    952957     * @since 3.4.0
     958     *
     959     * @param array|object|string $choice
    953960     */
    954961    final public function set_header_image( $choice ) {
    … …  
    10021009     */
    10031010    final public function remove_header_image() {
    1004         return $this->set_header_image( 'remove-header' );
     1011        $this->set_header_image( 'remove-header' );
    10051012    }
    10061013
    … …  
    10161023        $default = get_theme_support( 'custom-header', 'default-image' );
    10171024
    1018         if ( ! $default )
    1019             return $this->remove_header_image();
    1020 
     1025        if ( ! $default ) {
     1026            $this->remove_header_image();
     1027            return;
     1028        }
    10211029        $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
    10221030
    … …  
    10361044     * Calculate width and height based on what the currently selected theme supports.
    10371045     *
     1046     * @param array $dimensions
    10381047     * @return array dst_height and dst_width of header image.
    10391048     */
    … …  
    10851094     * Create an attachment 'object'.
    10861095     *
    1087      * @param string $cropped Cropped image URL.
    1088      * @param int $parent_attachment_id Attachment ID of parent image.
     1096     * @param string $cropped              Cropped image URL.
     1097     * @param int    $parent_attachment_id Attachment ID of parent image.
    10891098     *
    10901099     * @return array Attachment object.
    … …  
    11131122     * Insert an attachment and its metadata.
    11141123     *
    1115      * @param array $object Attachment object.
     1124     * @param array  $object Attachment object.
    11161125     * @param string $cropped Cropped image URL.
    11171126     *
    … …  
    12411250    }
    12421251
     1252    /**
     1253     *
     1254     * @param WP_Customize_Manager $wp_customize
     1255     */
    12431256    public function customize_set_last_used( $wp_customize ) {
    12441257        $data = $wp_customize->get_setting( 'header_image_data' )->post_value();
    … …  
    12531266    }
    12541267
     1268    /**
     1269     *
     1270     * @return array
     1271     */
    12551272    public function get_default_header_images() {
    12561273        $this->process_default_headers();
    … …  
    12861303
    12871304        // The rest of the set comes after.
    1288         $header_images = array_merge( $header_images, $this->default_headers );
    1289         return $header_images;
    1290     }
    1291 
     1305        return array_merge( $header_images, $this->default_headers );
     1306    }
     1307
     1308    /**
     1309     *
     1310     * @return array
     1311     */
    12921312    public function get_uploaded_header_images() {
    12931313        $header_images = get_uploaded_header_images();

  • trunk/src/wp-admin/includes/bookmark.php

    r32653 r32654  
    7878 *
    7979 * @param int $link_id ID of the link to delete
    80  * @return bool True
     80 * @return true
    8181 */
    8282function wp_delete_link( $link_id ) {
    … …  
    141141 *
    142142 * @param array $linkdata Elements that make up the link to insert.
    143  * @param bool $wp_error Optional. If true return WP_Error object on failure.
     143 * @param bool  $wp_error Optional. If true return WP_Error object on failure.
    144144 * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
    145145 */

  • 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;

  • trunk/src/wp-admin/includes/class-wp-filesystem-base.php

    r31554 r32654  
    172172     */
    173173    public function find_folder( $folder ) {
    174 
    175174        if ( isset( $this->cache[ $folder ] ) )
    176175            return $this->cache[ $folder ];

  • trunk/src/wp-admin/includes/class-wp-filesystem-ftpext.php

    r32650 r32654  
    1818    public $link;
    1919
    20     public function __construct($opt='') {
     20    /**
     21     *
     22     * @param array $opt
     23     */
     24    public function __construct( $opt = '' ) {
    2125        $this->method = 'ftpext';
    2226        $this->errors = new WP_Error();
    … …  
    5963    }
    6064
     65    /**
     66     *
     67     * @return bool
     68     */
    6169    public function connect() {
    6270        if ( isset($this->options['ssl']) && $this->options['ssl'] && function_exists('ftp_ssl_connect') )

  • trunk/src/wp-admin/includes/class-wp-filesystem-ftpsockets.php

    r31815 r32654  
    2121    public $ftp;
    2222
    23     public function __construct($opt = '') {
     23    /**
     24     *
     25     * @param array $opt
     26     */
     27    public function __construct( $opt  = '' ) {
    2428        $this->method = 'ftpsockets';
    2529        $this->errors = new WP_Error();
    … …  
    5357    }
    5458
     59    /**
     60     *
     61     * @return bool
     62     */
    5563    public function connect() {
    5664        if ( ! $this->ftp )
    … …  
    227235    }
    228236    /**
     237     * @param string   $source
     238     * @param string   $destination
     239     * @param bool     $overwrite
     240     * @param int|bool $mode
     241     * @return bool
     242     */
     243    public function copy($source, $destination, $overwrite = false, $mode = false) {
     244        if ( ! $overwrite && $this->exists($destination) )
     245            return false;
     246
     247        $content = $this->get_contents($source);
     248        if ( false === $content )
     249            return false;
     250
     251        return $this->put_contents($destination, $content, $mode);
     252    }
     253    /**
    229254     * @param string $source
    230255     * @param string $destination
    231      * @param bool $overwrite
    232      * @param int|bool $mode
    233      * @return bool
    234      */
    235     public function copy($source, $destination, $overwrite = false, $mode = false) {
    236         if ( ! $overwrite && $this->exists($destination) )
    237             return false;
    238 
    239         $content = $this->get_contents($source);
    240         if ( false === $content )
    241             return false;
    242 
    243         return $this->put_contents($destination, $content, $mode);
    244     }
    245     /**
    246      * @param string $source
    247      * @param string $destination
    248      * @param bool $overwrite
     256     * @param bool   $overwrite
    249257     * @return bool
    250258     */
    … …  
    254262    /**
    255263     * @param string $file
    256      * @param bool $recursive
     264     * @param bool   $recursive
    257265     * @param string $type
    258266     * @return bool
    … …  
    360368    /**
    361369     * @param string $path
    362      * @param mixed $chmod
    363      * @param mixed $chown
    364      * @param mixed $chgrp
     370     * @param mixed  $chmod
     371     * @param mixed  $chown
     372     * @param mixed  $chgrp
    365373     * @return bool
    366374     */
    … …  
    388396    /**
    389397     * @param string $path
    390      * @param bool $include_hidden
    391      * @param bool $recursive
     398     * @param bool   $include_hidden
     399     * @param bool   $recursive
    392400     * @return bool|array
    393401     */

  • trunk/src/wp-admin/includes/class-wp-filesystem-ssh2.php

    r31686 r32654  
    4343    public $keys = false;
    4444
    45     public function __construct($opt='') {
     45    /**
     46     *
     47     * @param array $opt
     48     */
     49    public function __construct( $opt = '' ) {
    4650        $this->method = 'ssh2';
    4751        $this->errors = new WP_Error();
    … …  
    9094            $this->options['password'] = $opt['password'];
    9195        }
    92 
    93     }
    94 
     96    }
     97
     98    /**
     99     *
     100     * @return bool
     101     */
    95102    public function connect() {
    96103        if ( ! $this->keys ) {
    … …  
    127134     * @return bool|string
    128135     */
    129     public function run_command( $command, $returnbool = false) {
    130 
     136    public function run_command( $command, $returnbool = false ) {
    131137        if ( ! $this->link )
    132138            return false;
    … …  
    167173
    168174    /**
    169      * @param string $file
    170      * @param string $contents
     175     * @param string   $file
     176     * @param string   $contents
    171177     * @param bool|int $mode
    172178     * @return bool
    … …  
    183189    }
    184190
     191    /**
     192     *
     193     * @return bool
     194     */
    185195    public function cwd() {
    186196        $cwd = $this->run_command('pwd');
    … …  
    202212     * @param string $file
    203213     * @param string $group
    204      * @param bool $recursive
     214     * @param bool   $recursive
     215     *
     216     * @return bool
    205217     */
    206218    public function chgrp($file, $group, $recursive = false ) {
    … …  
    214226    /**
    215227     * @param string $file
    216      * @param int $mode
    217      * @param bool $recursive
     228     * @param int    $mode
     229     * @param bool   $recursive
    218230     * @return bool|string
    219231     */
    … …  
    290302
    291303    /**
     304     * @param string   $source
     305     * @param string   $destination
     306     * @param bool     $overwrite
     307     * @param int|bool $mode
     308     * @return bool
     309     */
     310    public function copy($source, $destination, $overwrite = false, $mode = false) {
     311        if ( ! $overwrite && $this->exists($destination) )
     312            return false;
     313        $content = $this->get_contents($source);
     314        if ( false === $content)
     315            return false;
     316        return $this->put_contents($destination, $content, $mode);
     317    }
     318
     319    /**
    292320     * @param string $source
    293321     * @param string $destination
    294      * @param bool $overwrite
    295      * @param int|bool $mode
    296      * @return bool
    297      */
    298     public function copy($source, $destination, $overwrite = false, $mode = false) {
    299         if ( ! $overwrite && $this->exists($destination) )
    300             return false;
    301         $content = $this->get_contents($source);
    302         if ( false === $content)
    303             return false;
    304         return $this->put_contents($destination, $content, $mode);
    305     }
    306 
    307     /**
    308      * @param string $source
    309      * @param string $destination
    310      * @param bool $overwrite
     322     * @param bool   $overwrite
    311323     * @return bool
    312324     */
    … …  
    316328
    317329    /**
    318      * @param string $file
    319      * @param bool $recursive
     330     * @param string      $file
     331     * @param bool        $recursive
    320332     * @param string|bool $type
    321333     * @return bool
    … …  
    404416    /**
    405417     * @param string $file
    406      * @param int $time
    407      * @param int $atime
     418     * @param int    $time
     419     * @param int    $atime
    408420     */
    409421    public function touch($file, $time = 0, $atime = 0) {
    … …  
    413425    /**
    414426     * @param string $path
    415      * @param mixed $chmod
    416      * @param mixed $chown
    417      * @param mixed $chgrp
     427     * @param mixed  $chmod
     428     * @param mixed  $chown
     429     * @param mixed  $chgrp
    418430     * @return bool
    419431     */
    … …  
    436448    /**
    437449     * @param string $path
    438      * @param bool $recursive
     450     * @param bool   $recursive
    439451     * @return bool
    440452     */
    … …  
    445457    /**
    446458     * @param string $path
    447      * @param bool $include_hidden
    448      * @param bool $recursive
     459     * @param bool   $include_hidden
     460     * @param bool   $recursive
    449461     * @return bool|array
    450462     */

  • trunk/src/wp-admin/includes/class-wp-importer.php

    r32642 r32654  
    1515     * @global wpdb $wpdb
    1616     *
     17     * @param string $importer_name
    1718     * @param string $bid
    1819     * @return array
    … …  
    5455     * @global wpdb $wpdb
    5556     *
     57     * @param string $importer_name
    5658     * @param string $bid
    5759     * @return int
    … …  
    121123    }
    122124
     125    /**
     126     *
     127     * @param int $blog_id
     128     * @return int|void
     129     */
    123130    public function set_blog( $blog_id ) {
    124131        if ( is_numeric( $blog_id ) ) {
    … …  
    148155    }
    149156
     157    /**
     158     *
     159     * @param int $user_id
     160     * @return int|void
     161     */
    150162    public function set_user( $user_id ) {
    151163        if ( is_numeric( $user_id ) ) {
    … …  
    180192     * @param string $username
    181193     * @param string $password
    182      * @param bool $head
     194     * @param bool   $head
    183195     * @return array
    184196     */
    … …  
    255267 *
    256268 * @param string $param
    257  * @param bool $required
     269 * @param bool   $required
    258270 * @return mixed
    259271 */

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

    r32644 r32654  
    2727    }
    2828
     29    /**
     30     *
     31     * @return bool
     32     */
    2933    public function ajax_user_can() {
    3034        return current_user_can( 'manage_links' );
    … …  
    6165    }
    6266
     67    /**
     68     *
     69     * @return array
     70     */
    6371    protected function get_bulk_actions() {
    6472        $actions = array();
    … …  
    100108    }
    101109
     110    /**
     111     *
     112     * @return array
     113     */
    102114    public function get_columns() {
    103115        return array(
    … …  
    112124    }
    113125
     126    /**
     127     *
     128     * @return array
     129     */
    114130    protected function get_sortable_columns() {
    115131        return array(

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

    r32650 r32654  
    251251     * @param array $args An associative array with information about the pagination
    252252     * @access protected
     253     *
     254     * @param array|string $args
    253255     */
    254256    protected function set_pagination_args( $args ) {
    … …  
    456458     * @access public
    457459     *
    458      * @return string|bool The action name or False if no action was selected
     460     * @return string|false The action name or False if no action was selected
    459461     */
    460462    public function current_action() {
    … …  
    977979
    978980        $this->display_tablenav( 'top' );
    979 
    980981?>
    981982<table class="wp-list-table <?php echo implode( ' ', $this->get_table_classes() ); ?>">
    … …  
    10931094    }
    10941095
     1096    /**
     1097     *
     1098     * @param object $item
     1099     * @param string $column_name
     1100     */
    10951101    protected function column_default( $item, $column_name ) {}
    10961102
     1103    /**
     1104     *
     1105     * @param object $item
     1106     */
    10971107    protected function column_cb( $item ) {}
    10981108

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

    r32644 r32654  
    3838    }
    3939
     40    /**
     41     *
     42     * @return bool
     43     */
    4044    public function ajax_user_can() {
    4145        return current_user_can('upload_files');
    … …  
    106110    }
    107111
     112    /**
     113     *
     114     * @return array
     115     */
    108116    protected function get_bulk_actions() {
    109117        $actions = array();
    … …  
    152160    }
    153161
     162    /**
     163     *
     164     * @return string
     165     */
    154166    public function current_action() {
    155167        if ( isset( $_REQUEST['found_post_id'] ) && isset( $_REQUEST['media'] ) )
    … …  
    165177    }
    166178
     179    /**
     180     *
     181     * @return bool
     182     */
    167183    public function has_items() {
    168184        return have_posts();
    … …  
    222238    }
    223239
     240    /**
     241     *
     242     * @return array
     243     */
    224244    public function get_columns() {
    225245        $posts_columns = array();
    … …  
    272292         *                             to any posts. Default true.
    273293         */
    274         $posts_columns = apply_filters( 'manage_media_columns', $posts_columns, $this->detached );
    275 
    276         return $posts_columns;
    277     }
    278 
     294        return apply_filters( 'manage_media_columns', $posts_columns, $this->detached );
     295    }
     296
     297    /**
     298     *
     299     * @return array
     300     */
    279301    protected function get_sortable_columns() {
    280302        return array(
    … …  
    496518            echo $this->row_actions( $this->_get_row_actions( $post, $att_title ) );
    497519        }
    498        
     520
    499521        echo '</td>';
    500522    }
    … …  
    520542     * @param WP_Post $post
    521543     * @param string  $att_title
     544     *
     545     * @return array
    522546     */
    523547    private function _get_row_actions( $post, $att_title ) {
    … …  
    568592         *                          to any posts. Default true.
    569593         */
    570         $actions = apply_filters( 'media_row_actions', $actions, $post, $this->detached );
    571 
    572         return $actions;
     594        return apply_filters( 'media_row_actions', $actions, $post, $this->detached );
    573595    }
    574596}

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

    r32644 r32654  
    2727    }
    2828
     29    /**
     30     *
     31     * @return bool
     32     */
    2933    public function ajax_user_can() {
    3034        return current_user_can( 'manage_sites' );
    … …  
    143147    }
    144148
     149    /**
     150     *
     151     * @return array
     152     */
    145153    protected function get_bulk_actions() {
    146154        $actions = array();
    … …  
    167175    }
    168176
     177    /**
     178     *
     179     * @return array
     180     */
    169181    public function get_columns() {
    170182        $blogname_columns = ( is_subdomain_install() ) ? __( 'Domain' ) : __( 'Path' );
    … …  
    188200         *                             'blogname', 'lastupdated', 'registered', 'users'.
    189201         */
    190         $sites_columns = apply_filters( 'wpmu_blogs_columns', $sites_columns );
    191 
    192         return $sites_columns;
    193     }
    194 
     202        return apply_filters( 'wpmu_blogs_columns', $sites_columns );
     203    }
     204
     205    /**
     206     *
     207     * @return array
     208     */
    195209    protected function get_sortable_columns() {
    196210        return array(

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

    r32650 r32654  
    4848    }
    4949
     50    /**
     51     *
     52     * @return array
     53     */
    5054    protected function get_table_classes() {
    5155        // todo: remove and add CSS for .themes
    … …  
    5357    }
    5458
     59    /**
     60     *
     61     * @return bool
     62     */
    5563    public function ajax_user_can() {
    5664        if ( $this->is_site_themes )
    … …  
    224232    }
    225233
     234    /**
     235     *
     236     * @return array
     237     */
    226238    protected function get_sortable_columns() {
    227239        return array(
    … …  
    292304
    293305    /**
    294      *
    295306     * @global string $status
     307     *
    296308     * @return array
    297309     */
    … …  
    323335     * @global string $s
    324336     * @global array $totals
     337     *
    325338     * @param WP_Theme $theme
    326339     */

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

    r32644 r32654  
    99 */
    1010class WP_MS_Users_List_Table extends WP_List_Table {
    11 
     11    /**
     12     *
     13     * @return bool
     14     */
    1215    public function ajax_user_can() {
    1316        return current_user_can( 'manage_network_users' );
    … …  
    8083    }
    8184
     85    /**
     86     *
     87     * @return array
     88     */
    8289    protected function get_bulk_actions() {
    8390        $actions = array();
    … …  
    128135    }
    129136
     137    /**
     138     *
     139     * @return array
     140     */
    130141    public function get_columns() {
    131142        $users_columns = array(
    … …  
    145156         *                             'name', 'email', 'registered', 'blogs'.
    146157         */
    147         $users_columns = apply_filters( 'wpmu_users_columns', $users_columns );
    148 
    149         return $users_columns;
    150     }
    151 
     158        return apply_filters( 'wpmu_users_columns', $users_columns );
     159    }
     160
     161    /**
     162     *
     163     * @return array
     164     */
    152165    protected function get_sortable_columns() {
    153166        return array(
    … …  
    209222                } else {
    210223                    echo "<td $attributes>";
    211                    
     224
    212225                    switch ( $column_name ) {
    213226                        case 'username':

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

    r32642 r32654  
    1616    private $error;
    1717
     18    /**
     19     *
     20     * @return bool
     21     */
    1822    public function ajax_user_can() {
    1923        return current_user_can('install_plugins');
    … …  
    2933     * @since 4.0.0
    3034     * @access protected
     35     *
     36     * @return array
    3137     */
    3238    protected function get_installed_plugin_slugs() {
    … …  
    222228     * @global array $tabs
    223229     * @global string $tab
     230     *
    224231     * @return array
    225232     */
    … …  
    326333    }
    327334
     335    /**
     336     * @return array
     337     */
    328338    protected function get_table_classes() {
    329339        return array( 'widefat', $this->_args['plural'] );
    330340    }
    331 
     341   
     342    /**
     343     * @return array
     344     */
    332345    public function get_columns() {
    333346        return array();

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

    r32650 r32654  
    4141    }
    4242
     43    /**
     44     * @return array
     45     */
    4346    protected function get_table_classes() {
    4447        return array( 'widefat', $this->_args['plural'] );
    4548    }
    4649
     50    /**
     51     * @return bool
     52     */
    4753    public function ajax_user_can() {
    4854        return current_user_can('activate_plugins');
    … …  
    217223     * @staticvar string $term
    218224     * @param array $plugin
    219      * @return boolean
     225     * @return bool
    220226     */
    221227    public function _search_callback( $plugin ) {
    … …  
    283289    }
    284290
     291    /**
     292     * @return array
     293     */
    285294    protected function get_sortable_columns() {
    286295        return array();
    … …  
    366375     * @global string $status
    367376     * @param string $which
    368      * @return null
    369377     */
    370378    public function bulk_actions( $which = '' ) {
    … …  
    380388     * @global string $status
    381389     * @param string $which
    382      * @return null
    383390     */
    384391    protected function extra_tablenav( $which ) {
    … …  
    400407    }
    401408
     409    /**
     410     * @return string
     411     */
    402412    public function current_action() {
    403413        if ( isset($_POST['clear-recent-list']) )
    … …  
    426436     * @global string $s
    427437     * @global array $totals
     438     *
    428439     * @param array $item
    429440     */

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

    r32644 r32654  
    101101    }
    102102
     103    /**
     104     *
     105     * @return bool
     106     */
    103107    public function ajax_user_can() {
    104108        return current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_posts );
    … …  
    148152    }
    149153
     154    /**
     155     *
     156     * @return bool
     157     */
    150158    public function has_items() {
    151159        return have_posts();
    … …  
    164172     * @since 4.2.0
    165173     *
    166      * @return bool Whether the current ivew is the "All" view.
     174     * @return bool Whether the current view is the "All" view.
    167175     */
    168176    protected function is_base_request() {
    … …  
    255263    }
    256264
     265    /**
     266     *
     267     * @return array
     268     */
    257269    protected function get_bulk_actions() {
    258270        $actions = array();
    … …  
    324336    }
    325337
     338    /**
     339     *
     340     * @return string
     341     */
    326342    public function current_action() {
    327343        if ( isset( $_REQUEST['delete_all'] ) || isset( $_REQUEST['delete_all2'] ) )
    … …  
    344360    }
    345361
     362    /**
     363     *
     364     * @return array
     365     */
    346366    protected function get_table_classes() {
    347367        return array( 'widefat', 'fixed', 'striped', is_post_type_hierarchical( $this->screen->post_type ) ? 'pages' : 'posts' );
    348368    }
    349369
     370    /**
     371     *
     372     * @return array
     373     */
    350374    public function get_columns() {
    351375        $post_type = $this->screen->post_type;
    … …  
    428452         * @param array $post_columns An array of column names.
    429453         */
    430         $posts_columns = apply_filters( "manage_{$post_type}_posts_columns", $posts_columns );
    431 
    432         return $posts_columns;
    433     }
    434 
     454        return apply_filters( "manage_{$post_type}_posts_columns", $posts_columns );
     455    }
     456
     457    /**
     458     *
     459     * @return array
     460     */
    435461    protected function get_sortable_columns() {
    436462        return array(
    … …  
    489515     * @param int $pagenum
    490516     * @param int $per_page
    491      * @return false|null
    492517     */
    493518    private function _display_rows_hierarchical( $pages, $pagenum = 1, $per_page = 20 ) {
    … …  
    500525
    501526            if ( ! $pages )
    502                 return false;
     527                return;
    503528        }
    504529
    … …  
    597622     */
    598623    private function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page, &$to_display ) {
    599 
    600624        if ( ! isset( $children_pages[$parent] ) )
    601625            return;
    … …  
    605629
    606630        foreach ( $children_pages[$parent] as $page ) {
    607 
    608631            if ( $count >= $end )
    609632                break;

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

    r32644 r32654  
    5656    }
    5757
     58    /**
     59     *
     60     * @return bool
     61     */
    5862    public function ajax_user_can() {
    5963        return current_user_can( get_taxonomy( $this->screen->taxonomy )->cap->manage_terms );
    … …  
    115119    }
    116120
     121    /**
     122     *
     123     * @return bool
     124     */
    117125    public function has_items() {
    118126        // todo: populate $this->items in prepare_items()
    … …  
    124132    }
    125133
     134    /**
     135     *
     136     * @return array
     137     */
    126138    protected function get_bulk_actions() {
    127139        $actions = array();
    … …  
    131143    }
    132144
     145    /**
     146     *
     147     * @return string
     148     */
    133149    public function current_action() {
    134150        if ( isset( $_REQUEST['action'] ) && isset( $_REQUEST['delete_tags'] ) && ( 'delete' == $_REQUEST['action'] || 'delete' == $_REQUEST['action2'] ) )
    … …  
    138154    }
    139155
     156    /**
     157     *
     158     * @return array
     159     */
    140160    public function get_columns() {
    141161        $columns = array(
    … …  
    155175    }
    156176
     177    /**
     178     *
     179     * @return array
     180     */
    157181    protected function get_sortable_columns() {
    158182        return array(
    … …  
    218242     * @param array $terms
    219243     * @param array $children
    220      * @param int $start
    221      * @param int $per_page
    222      * @param int $count
    223      * @param int $parent
    224      * @param int $level
     244     * @param int   $start
     245     * @param int   $per_page
     246     * @param int   $count
     247     * @param int   $parent
     248     * @param int   $level
    225249     */
    226250    private function _rows( $taxonomy, $terms, &$children, $start, $per_page, &$count, $parent = 0, $level = 0 ) {

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

    r32642 r32654  
    1212    public $features = array();
    1313
     14    /**
     15     *
     16     * @return bool
     17     */
    1418    public function ajax_user_can() {
    1519        return current_user_can( 'install_themes' );
    … …  
    417421     * @global string $tab  Current tab within Themes->Install screen
    418422     * @global string $type Type of search.
     423     *
     424     * @param array $extra_args Unused.
    419425     */
    420426    public function _js_vars( $extra_args = array() ) {

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

    r32116 r32654  
    3030    }
    3131
     32    /**
     33     *
     34     * @return bool
     35     */
    3236    public function ajax_user_can() {
    3337        // Do not check edit_theme_options here. AJAX calls for available themes require switch_themes.
    … …  
    98102    /**
    99103     * @param string $which
    100      * @return null
    101104     */
    102105    public function tablenav( $which = 'top' ) {
    … …  
    125128    }
    126129
     130    /**
     131     *
     132     * @return array
     133     */
    127134    public function get_columns() {
    128135        return array();

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

    r32644 r32654  
    5757     * @since 3.1.0
    5858     * @access public
     59     *
     60     * @return bool
    5961     */
    6062    public function ajax_user_can() {

  • trunk/src/wp-admin/includes/comment.php

    r32642 r32654  
    2121    global $wpdb;
    2222
    23     $comment_author = stripslashes($comment_author);
    24     $comment_date = stripslashes($comment_date);
    25 
    2623    return $wpdb->get_var( $wpdb->prepare("SELECT comment_post_ID FROM $wpdb->comments
    27             WHERE comment_author = %s AND comment_date = %s", $comment_author, $comment_date) );
     24            WHERE comment_author = %s AND comment_date = %s",
     25            stripslashes( $comment_author ),
     26            stripslashes( $comment_date )
     27    ) );
    2828}
    2929
    … …  
    3434 */
    3535function edit_comment() {
    36 
    3736    if ( ! current_user_can( 'edit_comment', (int) $_POST['comment_ID'] ) )
    3837        wp_die ( __( 'You are not allowed to edit comments on this post.' ) );
    … …  
    8180 *
    8281 * @param int $id ID of comment to retrieve.
    83  * @return bool|object Comment if found. False on failure.
     82 * @return object|false Comment if found. False on failure.
    8483 */
    8584function get_comment_to_edit( $id ) {
    … …  
    157156 *
    158157 * @since 2.5.0
    159  * 
     158 *
    160159 * @global object $comment
    161160 *

  • trunk/src/wp-admin/includes/template.php

    r32653 r32654  
    439439 * @global WP_List_Table $wp_list_table
    440440 *
    441  * @param int $position
    442  * @param bool $checkbox
     441 * @param int    $position
     442 * @param bool   $checkbox
    443443 * @param string $mode
    444  * @param bool $table_row
     444 * @param bool   $table_row
    445445 */
    446446function wp_comment_reply( $position = 1, $checkbox = false, $mode = 'single', $table_row = true ) {
    … …  
    10391039 *
    10401040 * @staticvar bool $already_sorted
    1041  * @param string|WP_Screen $screen Screen identifier
    1042  * @param string $context box context
    1043  * @param mixed $object gets passed to the box callback function as first parameter
     1041 * @param string|WP_Screen $screen  Screen identifier
     1042 * @param string           $context box context
     1043 * @param mixed            $object gets passed to the box callback function as first parameter
    10441044 * @return int number of meta_boxes
    10451045 */
    … …  
    11081108 * @global array $wp_meta_boxes
    11091109 *
    1110  * @param string $id String for use in the 'id' attribute of tags.
    1111  * @param string|object $screen The screen on which to show the box (post, page, link).
    1112  * @param string $context The context within the page where the boxes should show ('normal', 'advanced').
     1110 * @param string        $id      String for use in the 'id' attribute of tags.
     1111 * @param string|object $screen  The screen on which to show the box (post, page, link).
     1112 * @param string        $context The context within the page where the boxes should show ('normal', 'advanced').
    11131113 */
    11141114function remove_meta_box($id, $screen, $context) {
    … …  
    11441144 * @uses global $wp_meta_boxes Used to retrieve registered meta boxes.
    11451145 *
    1146  * @param string|object $screen The screen identifier.
    1147  * @param string $context The meta box context.
    1148  * @param mixed $object gets passed to the section callback function as first parameter.
     1146 * @param string|object $screen  The screen identifier.
     1147 * @param string        $context The meta box context.
     1148 * @param mixed         $object gets passed to the section callback function as first parameter.
    11491149 * @return int number of meta boxes as accordion sections.
    11501150 */
    … …  
    12221222 * @global $wp_settings_sections Storage array of all settings sections added to admin pages
    12231223 *
    1224  * @param string $id Slug-name to identify the section. Used in the 'id' attribute of tags.
    1225  * @param string $title Formatted title of the section. Shown as the heading for the section.
     1224 * @param string $id       Slug-name to identify the section. Used in the 'id' attribute of tags.
     1225 * @param string $title    Formatted title of the section. Shown as the heading for the section.
    12261226 * @param string $callback Function that echos out any content at the top of the section (between heading and fields).
    1227  * @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();
     1227 * @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();
    12281228 */
    12291229function add_settings_section($id, $title, $callback, $page) {
    … …  
    17011701}
    17021702
     1703/**
     1704 *
     1705 * @param WP_Post $post
     1706 */
    17031707function _post_states($post) {
    17041708    $post_states = array();
    … …  
    17511755}
    17521756
     1757/**
     1758 *
     1759 * @param WP_Post $post
     1760 */
    17531761function _media_states( $post ) {
    17541762    $media_states = array();

  • trunk/src/wp-admin/includes/theme-install.php

    r32653 r32654  
    5151 *
    5252 * @since 2.8.0
     53 *
     54 * @param bool $type_selector
    5355 */
    5456function install_theme_search_form( $type_selector = true ) {
    … …  
    151153 *
    152154 * @global WP_Theme_Install_List_Table $wp_list_table
     155 *
     156 * @param object $theme
    153157 */
    154158function display_theme( $theme ) {

  • trunk/src/wp-admin/includes/theme.php

    r32653 r32654  
    1616 * @param string $stylesheet Stylesheet of the theme to delete
    1717 * @param string $redirect Redirect to page when complete.
    18  * @return mixed
     18 * @return void|bool|WP_Error When void, echoes content.
    1919 */
    2020function delete_theme($stylesheet, $redirect = '') {
    … …  
    124124 * @see get_theme_update_available()
    125125 *
    126  * @param object $theme Theme data object.
     126 * @param WP_Theme $theme Theme data object.
    127127 */
    128128function theme_update_available( $theme ) {

  • trunk/src/wp-admin/includes/update-core.php

    r32653 r32654  
    778778 *
    779779 * @param string $from New release unzipped path.
    780  * @param string $to Path to old WordPress installation.
     780 * @param string $to   Path to old WordPress installation.
    781781 * @return WP_Error|null WP_Error on failure, null on success.
    782782 */
    … …  
    11191119 * @global WP_Filesystem_Base $wp_filesystem
    11201120 *
    1121  * @param string $from source directory
    1122  * @param string $to destination directory
     1121 * @param string $from     source directory
     1122 * @param string $to       destination directory
    11231123 * @param array $skip_list a list of files/folders to skip copying
    11241124 * @return mixed WP_Error on failure, True on success.
    … …  
    11771177 * @global string $pagenow
    11781178 * @global string $action
     1179 *
     1180 * @param string $new_version
    11791181 */
    11801182function _redirect_to_about_wordpress( $new_version ) {

  • trunk/src/wp-admin/includes/update.php

    r32653 r32654  
    1010 * Selects the first update version from the update_core option.
    1111 *
    12  * @return bool|object The response from the API on success, false on failure.
     12 * @return object|array|false The response from the API on success, false on failure.
    1313 */
    1414function get_preferred_from_update_core() {
    … …  
    2525 *
    2626 * @param array $options Set $options['dismissed'] to true to show dismissed upgrades too,
    27  *  set $options['available'] to false to skip not-dismissed updates.
    28  * @return bool|array Array of the update objects on success, false on failure.
     27 *                       set $options['available'] to false to skip not-dismissed updates.
     28 * @return array|false Array of the update objects on success, false on failure.
    2929 */
    3030function get_core_updates( $options = array() ) {
    … …  
    6868 * @since 3.7.0
    6969 *
    70  * @return bool|array False on failure, otherwise the core update offering.
     70 * @return array|false False on failure, otherwise the core update offering.
    7171 */
    7272function find_core_auto_update() {
    … …  
    129129}
    130130
     131/**
     132 *
     133 * @param object $update
     134 * @return bool
     135 */
    131136function dismiss_core_update( $update ) {
    132137    $dismissed = get_site_option( 'dismissed_update_core' );
    … …  
    135140}
    136141
     142/**
     143 *
     144 * @param string $version
     145 * @param string $locale
     146 * @return bool
     147 */
    137148function undismiss_core_update( $version, $locale ) {
    138149    $dismissed = get_site_option( 'dismissed_update_core' );
    … …  
    146157}
    147158
     159/**
     160 *
     161 * @param string $version
     162 * @param string $locale
     163 * @return object|false
     164 */
    148165function find_core_update( $version, $locale ) {
    149166    $from_api = get_site_transient( 'update_core' );
    … …  
    160177}
    161178
     179/**
     180 *
     181 * @param string $msg
     182 * @return string
     183 */
    162184function core_update_footer( $msg = '' ) {
    163185    if ( !current_user_can('update_core') )
    … …  
    265287}
    266288
     289/**
     290 *
     291 * @param string $file
     292 * @param array  $plugin_data
     293 * @return false|void
     294 */
    267295function wp_plugin_update_row( $file, $plugin_data ) {
    268296    $current = get_site_transient( 'update_plugins' );
    … …  
    331359}
    332360
     361/**
     362 *
     363 * @return array
     364 */
    333365function get_theme_updates() {
    334366    $current = get_site_transient('update_themes');
    … …  
    360392}
    361393
     394/**
     395 *
     396 * @param string   $theme_key
     397 * @param WP_Theme $theme
     398 * @return false|void
     399 */
    362400function wp_theme_update_row( $theme_key, $theme ) {
    363401    $current = get_site_transient( 'update_themes' );

  • trunk/src/wp-admin/includes/upgrade.php

    r32643 r32654  
    166166
    167167    $wpdb->insert( $wpdb->posts, array(
    168                                 'post_author' => $user_id,
    169                                 'post_date' => $now,
    170                                 'post_date_gmt' => $now_gmt,
    171                                 'post_content' => $first_post,
    172                                 'post_excerpt' => '',
    173                                 'post_title' => __('Hello world!'),
    174                                 /* translators: Default post slug */
    175                                 'post_name' => sanitize_title( _x('hello-world', 'Default post slug') ),
    176                                 'post_modified' => $now,
    177                                 'post_modified_gmt' => $now_gmt,
    178                                 'guid' => $first_post_guid,
    179                                 'comment_count' => 1,
    180                                 'to_ping' => '',
    181                                 'pinged' => '',
    182                                 'post_content_filtered' => ''
    183                                 ));
     168        'post_author' => $user_id,
     169        'post_date' => $now,
     170        'post_date_gmt' => $now_gmt,
     171        'post_content' => $first_post,
     172        'post_excerpt' => '',
     173        'post_title' => __('Hello world!'),
     174        /* translators: Default post slug */
     175        'post_name' => sanitize_title( _x('hello-world', 'Default post slug') ),
     176        'post_modified' => $now,
     177        'post_modified_gmt' => $now_gmt,
     178        'guid' => $first_post_guid,
     179        'comment_count' => 1,
     180        'to_ping' => '',
     181        'pinged' => '',
     182        'post_content_filtered' => ''
     183    ));
    184184    $wpdb->insert( $wpdb->term_relationships, array('term_taxonomy_id' => $cat_tt_id, 'object_id' => 1) );
    185185
    … …  
    195195    }
    196196    $wpdb->insert( $wpdb->comments, array(
    197                                 'comment_post_ID' => 1,
    198                                 'comment_author' => $first_comment_author,
    199                                 'comment_author_email' => '',
    200                                 'comment_author_url' => $first_comment_url,
    201                                 'comment_date' => $now,
    202                                 'comment_date_gmt' => $now_gmt,
    203                                 'comment_content' => $first_comment
    204                                 ));
     197        'comment_post_ID' => 1,
     198        'comment_author' => $first_comment_author,
     199        'comment_author_email' => '',
     200        'comment_author_url' => $first_comment_url,
     201        'comment_date' => $now,
     202        'comment_date_gmt' => $now_gmt,
     203        'comment_content' => $first_comment
     204    ));
    205205
    206206    // First Page
    … …  
    218218    $first_post_guid = get_option('home') . '/?page_id=2';
    219219    $wpdb->insert( $wpdb->posts, array(
    220                                 'post_author' => $user_id,
    221                                 'post_date' => $now,
    222                                 'post_date_gmt' => $now_gmt,
    223                                 'post_content' => $first_page,
    224                                 'post_excerpt' => '',
    225                                 'post_title' => __( 'Sample Page' ),
    226                                 /* translators: Default page slug */
    227                                 'post_name' => __( 'sample-page' ),
    228                                 'post_modified' => $now,
    229                                 'post_modified_gmt' => $now_gmt,
    230                                 'guid' => $first_post_guid,
    231                                 'post_type' => 'page',
    232                                 'to_ping' => '',
    233                                 'pinged' => '',
    234                                 'post_content_filtered' => ''
    235                                 ));
     220        'post_author' => $user_id,
     221        'post_date' => $now,
     222        'post_date_gmt' => $now_gmt,
     223        'post_content' => $first_page,
     224        'post_excerpt' => '',
     225        'post_title' => __( 'Sample Page' ),
     226        /* translators: Default page slug */
     227        'post_name' => __( 'sample-page' ),
     228        'post_modified' => $now,
     229        'post_modified_gmt' => $now_gmt,
     230        'guid' => $first_post_guid,
     231        'post_type' => 'page',
     232        'to_ping' => '',
     233        'pinged' => '',
     234        'post_content_filtered' => ''
     235    ));
    236236    $wpdb->insert( $wpdb->postmeta, array( 'post_id' => 2, 'meta_key' => '_wp_page_template', 'meta_value' => 'default' ) );
    237237
    … …  
    393393 * @global int  $wp_db_version
    394394 * @global wpdb $wpdb
    395  *
    396  * @return null If no update is necessary or site isn't completely installed, null.
    397395 */
    398396function wp_upgrade() {
    … …  
    446444 * @global int $wp_current_db_version
    447445 * @global int $wp_db_version
    448  *
    449  * @return null If no update is necessary, null.
    450446 */
    451447function upgrade_all() {
    … …  
    17481744 * @param string $table Database table name.
    17491745 * @param string $index Index name to drop.
    1750  * @return bool True, when finished.
     1746 * @return true True, when finished.
    17511747 */
    17521748function drop_index($table, $index) {
    … …  
    17711767 * @param string $table Database table name.
    17721768 * @param string $index Database table index column.
    1773  * @return bool True, when done with execution.
     1769 * @return true True, when done with execution.
    17741770 */
    17751771function add_clean_index($table, $index) {
    … …  
    17901786 * @param string $column_name The column name to add to the table.
    17911787 * @param string $create_ddl  The SQL statement used to add the column.
    1792  * @return True if already exists or on successful completion, false on error.
     1788 * @return bool True if already exists or on successful completion, false on error.
    17931789 */
    17941790function maybe_add_column($table_name, $column_name, $create_ddl) {
    … …  
    22792275                // Don't copy anything.
    22802276                continue;
    2281                 }
     2277            }
    22822278        }
    22832279
    … …  
    23322328 * @param string $theme_name The name of the theme.
    23332329 * @param string $template   The directory name of the theme.
    2334  * @return null|false
     2330 * @return false|void
    23352331 */
    23362332function make_site_theme_from_default($theme_name, $template) {

  • trunk/src/wp-admin/includes/user.php

    r32653 r32654  
    1212 * @since 2.0.0
    1313 *
    14  * @return null|WP_Error|int Null when adding user, WP_Error or User ID integer when no parameters.
     14 * @return int|WP_Error WP_Error or User ID.
    1515 */
    1616function add_user() {
    … …  
    2626 *
    2727 * @param int $user_id Optional. User ID.
    28  * @return int user id of the updated user
     28 * @return int|WP_Error user id of the updated user
    2929 */
    3030function edit_user( $user_id = 0 ) {
    … …  
    411411/**
    412412 * @since 2.8.0
     413 *
     414 * @param int    $user_ID
     415 * @param object $old_data
    413416 */
    414417function default_password_nag_edit_user($user_ID, $old_data) {

  • trunk/src/wp-admin/includes/widgets.php

    r32650 r32654  
    5555 * @since 3.1.0
    5656 * @access private
     57 *
     58 * @return int
    5759 */
    5860function _sort_name_callback( $a, $b ) {

  • trunk/src/wp-admin/install-helper.php

    r32642 r32654  
    158158 *
    159159 * @param string $table_name Table name
    160  * @param string $col_name Column name
    161  * @param string $col_type Column type
    162  * @param bool $is_null Optional. Check is null.
    163  * @param mixed $key Optional. Key info.
    164  * @param mixed $default Optional. Default value.
    165  * @param mixed $extra Optional. Extra value.
     160 * @param string $col_name   Column name
     161 * @param string $col_type   Column type
     162 * @param bool   $is_null    Optional. Check is null.
     163 * @param mixed  $key        Optional. Key info.
     164 * @param mixed  $default    Optional. Default value.
     165 * @param mixed  $extra      Optional. Extra value.
    166166 * @return bool True, if matches. False, if not matching.
    167167 */

  • trunk/src/wp-admin/install.php

    r32642 r32654  
    5353 *
    5454 * @since 2.5.0
     55 *
     56 * @param string $body_classes
    5557 */
    5658function display_header( $body_classes = '' ) {
    … …  
    8385 *
    8486 * @since 2.8.0
     87 *
     88 * @param string|null $error
    8589 */
    8690function display_setup_form( $error = null ) {

  • trunk/src/wp-admin/load-styles.php

    r28978 r32654  
    8282function wp_guess_url() {}
    8383
     84/**
     85 *
     86 * @param string $path
     87 * @return string
     88 */
    8489function get_file($path) {
    8590

  • trunk/src/wp-admin/menu.php

    r32643 r32654  
    171171
    172172// Add 'Editor' to the bottom of the Appearance menu.
    173 if ( ! is_multisite() )
     173if ( ! is_multisite() ) {
    174174    add_action('admin_menu', '_add_themes_utility_last', 101);
     175}
     176/**
     177 *
     178 */
    175179function _add_themes_utility_last() {
    176180    // Must use API on the admin_menu hook, direct modification is only possible on/before the _admin_menu hook

  • trunk/src/wp-admin/network.php

    r32642 r32654  
    158158 *
    159159 * @global bool $is_apache
     160 *
     161 * @param WP_Error $errors
    160162 */
    161163function network_step1( $errors = false ) {
    … …  
    337339 *
    338340 * @global wpdb $wpdb
     341 *
     342 * @param WP_Error $errors
    339343 */
    340344function network_step2( $errors = false ) {

  • trunk/src/wp-admin/network/users.php

    r32333 r32654  
    1717    wp_die( __( 'You do not have permission to access this page.' ), 403 );
    1818
     19/**
     20 *
     21 * @param array $users
     22 */
    1923function confirm_delete_users( $users ) {
    2024    $current_user = wp_get_current_user();

  • trunk/src/wp-admin/plugins.php

    r32116 r32654  
    149149            @ini_set('display_errors', true); //Ensure that Fatal errors are displayed.
    150150            // Go back to "sandbox" scope so we get the same errors as before
     151            /**
     152             * @param string $plugin
     153             */
    151154            function plugin_sandbox_scrape( $plugin ) {
    152155                wp_register_plugin_realpath( WP_PLUGIN_DIR . '/' . $plugin );

  • trunk/src/wp-admin/post.php

    r32642 r32654  
    6060            }
    6161        } else {
    62                 $message = 'draft' == $status ? 10 : 1;
     62            $message = 'draft' == $status ? 10 : 1;
    6363        }
    6464

  • trunk/src/wp-admin/setup-config.php

    r32642 r32654  
    6565 * @since 2.3.0
    6666 *
    67  * @global string    $wp_version
    6867 * @global string    $wp_local_package
    6968 * @global WP_Locale $wp_locale
     69 *
     70 * @param string|array $body_classes
    7071 */
    7172function setup_config_display_header( $body_classes = array() ) {
    72     global $wp_version;
    7373    $body_classes = (array) $body_classes;
    7474    $body_classes[] = 'wp-core-ui';

  • trunk/src/wp-admin/update-core.php

    r32642 r32654  
    315315
    316316    $form_action = 'update-core.php?action=do-theme-upgrade';
    317 
    318317?>
    319318<h3><?php _e( 'Themes' ); ?></h3>
    … …  
    382381 *
    383382 * @global WP_Filesystem_Base $wp_filesystem Subclass
     383 *
     384 * @param bool $reinstall
    384385 */
    385386function do_core_upgrade( $reinstall = false ) {

  • trunk/src/wp-admin/user-new.php

    r32116 r32654  
    1818
    1919if ( is_multisite() ) {
     20    /**
     21     *
     22     * @param string $text
     23     * @return string
     24     */
    2025    function admin_created_user_email( $text ) {
    2126        $roles = get_editable_roles();

  • trunk/src/wp-admin/widgets.php

    r32116 r32654  
    2222}
    2323
     24/**
     25 *
     26 * @param string $classes
     27 * @return string
     28 */
    2429function wp_widgets_access_body_class($classes) {
    2530    return "$classes widgets_access ";
Note: See TracChangeset for help on using the changeset viewer.