Make WordPress Core

Ticket #39265: m-folders.patch

File m-folders.patch, 124.2 KB (added by pbearne, 3 years ago)

the M folders

  • tests/phpunit/tests/media/getAttachmentTaxonomies.php

     
    55 * @group taxonomy
    66 */
    77class Tests_Media_GetAttachmentTaxonomies extends WP_UnitTestCase {
     8        /**
     9         * @covers ::get_attachment_taxonomies
     10         */
    811        public function test_should_return_attachment_taxonomy() {
    912                register_taxonomy( 'wptests_tax', 'attachment' );
    1013
     
    2427                $this->assertSame( $expected, $found );
    2528        }
    2629
     30        /**
     31         * @covers ::get_attachment_taxonomies
     32         */
    2733        public function test_should_return_taxonomy_registered_for_specific_attachment_type() {
    2834                register_taxonomy( 'wptests_tax', 'attachment:image' );
    2935
     
    4349                $this->assertSame( $expected, $found );
    4450        }
    4551
     52        /**
     53         * @covers ::get_attachment_taxonomies
     54         */
    4655        public function test_should_return_taxonomy_registered_for_specific_attachment_mimetype() {
    4756                register_taxonomy( 'wptests_tax', 'attachment:image/jpeg' );
    4857
     
    6271                $this->assertSame( $expected, $found );
    6372        }
    6473
     74        /**
     75         * @covers ::get_attachment_taxonomies
     76         */
    6577        public function test_should_return_taxonomy_registered_for_specific_file_extension() {
    6678                register_taxonomy( 'wptests_tax', 'attachment:jpg' );
    6779
     
    8193                $this->assertSame( $expected, $found );
    8294        }
    8395
     96        /**
     97         * @covers ::get_attachment_taxonomies
     98         */
    8499        public function test_should_not_return_duplicate_taxonomies() {
    85100                register_taxonomy( 'wptests_tax', array( 'attachment', 'attachment:image/jpeg' ) );
    86101
     
    102117
    103118        /**
    104119         * @ticket 37368
     120         *
     121         * @covers ::get_attachment_taxonomies
    105122         */
    106123        public function test_should_respect_output_objects() {
    107124                register_taxonomy( 'wptests_tax2', 'attachment:image' );
     
    126143
    127144        /**
    128145         * @ticket 37368
     146         *
     147         * @covers ::get_attachment_taxonomies
    129148         */
    130149        public function test_should_return_unique_taxonomies_for_output_objects() {
    131150                register_taxonomy( 'wptests_tax2', array( 'attachment:image', 'attachment:image/jpeg' ) );
  • tests/phpunit/tests/menu/walker-nav-menu-edit.php

     
    3030
    3131        /**
    3232         * @ticket 36729
     33         *
     34         * @covers Walker_Nav_Menu::start_el
    3335         */
    3436        function test_original_title_prefix_should_not_be_shown_if_empty() {
    3537                $expected = '';
  • tests/phpunit/tests/menu/walker-nav-menu.php

     
    4040         * Tests when an item's target is _blank, that rel="noopener" is added.
    4141         *
    4242         * @ticket 43290
     43         *
     44         * @covers Walker_Nav_Menu::start_el
    4345         */
    4446        public function test_noopener_no_referrer_for_target_blank() {
    4547                $expected   = '';
     
    7173         * @ticket 47720
    7274         *
    7375         * @dataProvider data_start_el_with_empty_attributes
     76         *
     77         * @covers Walker_Nav_Menu::start_el
    7478         */
    7579        public function test_start_el_with_empty_attributes( $value, $expected ) {
    7680                $output     = '';
  • tests/phpunit/tests/menu/wpAjaxMenuQuickSearch.php

     
    3434         * Test search returns results for pages.
    3535         *
    3636         * @ticket 27042
     37         *
     38         * @covers ::_wp_ajax_menu_quick_search
    3739         */
    3840        public function test_search_returns_results_for_pages() {
    3941                require_once ABSPATH . 'wp-admin/includes/nav-menu.php';
     
    6971         * Test that search only returns results for published posts.
    7072         *
    7173         * @ticket 33742
     74         *
     75         * @covers ::_wp_ajax_menu_quick_search
    7276         */
    7377        public function test_search_returns_results_for_published_posts() {
    7478                require_once ABSPATH . 'wp-admin/includes/nav-menu.php';
     
    125129         * Test that search displays terms that are not assigned to any posts.
    126130         *
    127131         * @ticket 45298
     132         *
     133         * @covers ::_wp_ajax_menu_quick_search
    128134         */
    129135        public function test_search_should_return_unassigned_term_items() {
    130136                register_taxonomy( 'wptests_tax', 'post' );
  • tests/phpunit/tests/menu/wpExpandNavMenuPostData.php

     
    55 * @ticket 36590
    66 */
    77class Tests_Menu_WpExpandNavMenuPostData extends WP_UnitTestCase {
     8        /**
     9         * @covers ::_wp_expand_nav_menu_post_data
     10         */
    811        public function test_unnested_data_should_expand() {
    912                require_once ABSPATH . 'wp-admin/includes/nav-menu.php';
    1013
     
    2831                $this->assertSame( $expected, $_POST );
    2932        }
    3033
     34        /**
     35         * @covers ::_wp_expand_nav_menu_post_data
     36         */
    3137        public function test_multidimensional_nested_array_should_expand() {
    3238                require_once ABSPATH . 'wp-admin/includes/nav-menu.php';
    3339
     
    5864                $this->assertSame( $expected, $_POST );
    5965        }
    6066
     67        /**
     68         * @covers ::_wp_expand_nav_menu_post_data
     69         */
    6170        public function test_multidimensional_nested_array_should_expand_and_merge() {
    6271                require_once ABSPATH . 'wp-admin/includes/nav-menu.php';
    6372
  • tests/phpunit/tests/meta/deleteMetadata.php

     
    44 * @group meta
    55 */
    66class Tests_Meta_DeleteMetadata extends WP_UnitTestCase {
     7        /**
     8         * @covers ::delete_metadata
     9         */
    710        public function test_all_metas_for_key_should_be_deleted_when_no_meta_value_is_provided() {
    811                $vals = array( '0', '1', '2' );
    912                foreach ( $vals as $val ) {
     
    1720                $this->assertSameSets( array(), $m );
    1821        }
    1922
     23        /**
     24         * @covers ::delete_metadata
     25         */
    2026        public function test_with_meta_value() {
    2127                $vals = array( '0', '1', '2' );
    2228                foreach ( $vals as $val ) {
     
    3440
    3541        /**
    3642         * @ticket 32224
     43         *
     44         * @covers ::delete_metadata
    3745         */
    3846        public function test_with_falsey_meta_value_should_not_delete_all_meta() {
    3947                $vals = array( '0', '1', '2' );
     
    5462         * @ticket 32224
    5563         *
    5664         * This is a backwards compatiblity quirk.
     65         *
     66         * @covers ::delete_metadata
    5767         */
    5868        public function test_meta_value_should_be_ignored_when_empty_string() {
    5969                $vals = array( '0', '1', '2', '' );
     
    7080
    7181        /**
    7282         * @ticket 32224
     83         *
     84         * @covers ::delete_metadata
    7385         */
    7486        public function test_meta_value_should_be_ignored_when_null() {
    7587                $vals = array( '0', '1', '2', '' );
     
    8698
    8799        /**
    88100         * @ticket 32224
     101         *
     102         * @covers ::delete_metadata
    89103         */
    90104        public function test_meta_value_should_be_ignored_when_false() {
    91105                $vals = array( '0', '1', '2', '' );
     
    102116
    103117        /**
    104118         * @ticket 35797
     119         *
     120         * @covers ::delete_metadata
    105121         */
    106122        public function test_delete_all_should_only_invalidate_cache_for_objects_matching_meta_value() {
    107123                $p1 = 1234;
     
    125141
    126142        /**
    127143         * @ticket 35797
     144         *
     145         * @covers ::delete_metadata
    128146         */
    129147        public function test_delete_all_should_invalidate_cache_for_all_objects_with_meta_key_when_meta_value_is_not_provided() {
    130148                $p1 = 1234;
     
    147165
    148166        /**
    149167         * @ticket 43561
     168         *
     169         * @covers ::delete_metadata_by_mid
    150170         */
    151171        public function test_object_id_is_int_inside_delete_post_meta() {
    152172                $post_id = self::factory()->post->create();
  • tests/phpunit/tests/meta/isProtectedMeta.php

     
    88
    99        /**
    1010         * @dataProvider protected_data
     11         *
     12         * @covers ::is_protected_meta
    1113         */
    1214        public function test_protected( $key ) {
    1315                $this->assertTrue( is_protected_meta( $key ) );
     
    3032
    3133        /**
    3234         * @dataProvider unprotected_data
     35         *
     36         * @covers ::is_protected_meta
    3337         */
    3438        public function test_unprotected( $key ) {
    3539                $this->assertFalse( is_protected_meta( $key ) );
  • tests/phpunit/tests/meta/query.php

     
    88 */
    99class Tests_Meta_Query extends WP_UnitTestCase {
    1010
     11        /**
     12         * @covers WP_Meta_Query::__construct
     13         */
    1114        public function test_empty_meta_query_param() {
    1215                $query = new WP_Meta_Query();
    1316                $this->assertNull( $query->relation );
    1417        }
    1518
     19        /**
     20         * @covers WP_Meta_Query::__construct
     21         */
    1622        public function test_default_relation() {
    1723                $query = new WP_Meta_Query( array( array( 'key' => 'abc' ) ) );
    1824                $this->assertSame( 'AND', $query->relation );
    1925        }
    2026
     27        /**
     28         * @covers WP_Meta_Query::__construct
     29         */
    2130        public function test_set_relation() {
    2231
    2332                $query = new WP_Meta_Query(
     
    4150
    4251        /**
    4352         * Non-arrays should not be added to the queries array.
     53         *
     54         * @covers WP_Meta_Query::__construct
    4455         */
    4556        public function test_invalid_query_clauses() {
    4657                $query = new WP_Meta_Query(
     
    5970         * Test all key only meta queries use the same INNER JOIN when using relation=OR
    6071         *
    6172         * @ticket 19729
     73         *
     74         * @covers WP_Meta_Query::get_sql
    6275         */
    6376        public function test_single_inner_join_for_keys_only() {
    6477
     
    97110
    98111        /**
    99112         * WP_Query-style query must be at index 0 for order_by=meta_value to work.
     113         *
     114         * @covers WP_Meta_Query::parse_query_vars
    100115         */
    101116        public function test_parse_query_vars_simple_query_index_0() {
    102117                $qv = array(
     
    135150
    136151        /**
    137152         * When no meta_value is provided, no 'value' should be set in the parsed queries.
     153         *
     154         * @covers WP_Meta_Query::parse_query_vars
    138155         */
    139156        public function test_parse_query_vars_with_no_meta_value() {
    140157                $qv = array(
     
    151168
    152169        /**
    153170         * WP_Query sets meta_value to '' by default. It should be removed by parse_query_vars().
     171         *
     172         * @covers WP_Meta_Query::parse_query_vars
    154173         */
    155174        public function test_parse_query_vars_with_default_meta_compare() {
    156175                $qv = array(
     
    169188        /**
    170189         * Test the conversion between "WP_Query" style meta args (meta_value=x&meta_key=y)
    171190         * to a meta query array.
     191         *
     192         * @covers WP_Meta_Query::parse_query_vars
    172193         */
    173194        public function test_parse_query_vars() {
    174195
     
    223244
    224245        /**
    225246         * @ticket 23033
     247         *
     248         * @covers WP_Meta_Query::get_cast_for_type
    226249         */
    227250        public function test_get_cast_for_type() {
    228251                $query = new WP_Meta_Query();
     
    255278                $this->assertSame( 'CHAR', $query->get_cast_for_type( 'ANYTHING ELSE' ) );
    256279        }
    257280
     281        /**
     282         * @covers WP_Meta_Query::sanitize_query
     283         */
    258284        public function test_sanitize_query_single_query() {
    259285                $expected = array(
    260286                        array(
     
    277303                $this->assertSame( $expected, $found );
    278304        }
    279305
     306        /**
     307         * @covers WP_Meta_Query::sanitize_query
     308         */
    280309        public function test_sanitize_query_multiple_first_order_queries_relation_default() {
    281310                $expected = array(
    282311                        array(
     
    307336                $this->assertSame( $expected, $found );
    308337        }
    309338
     339        /**
     340         * @covers WP_Meta_Query::sanitize_query
     341         */
    310342        public function test_sanitize_query_multiple_first_order_queries_relation_or() {
    311343                $expected = array(
    312344                        array(
     
    338370                $this->assertSame( $expected, $found );
    339371        }
    340372
     373        /**
     374         * @covers WP_Meta_Query::sanitize_query
     375         */
    341376        public function test_sanitize_query_multiple_first_order_queries_relation_or_lowercase() {
    342377                $expected = array(
    343378                        array(
     
    369404                $this->assertSame( $expected, $found );
    370405        }
    371406
     407        /**
     408         * @covers WP_Meta_Query::sanitize_query
     409         */
    372410        public function test_sanitize_query_multiple_first_order_queries_invalid_relation() {
    373411                $expected = array(
    374412                        array(
     
    400438                $this->assertSame( $expected, $found );
    401439        }
    402440
     441        /**
     442         * @covers WP_Meta_Query::__construct
     443         */
    403444        public function test_sanitize_query_single_query_which_is_a_nested_query() {
    404445                $expected = array(
    405446                        array(
     
    435476                $this->assertSame( $expected, $found );
    436477        }
    437478
     479        /**
     480         * @covers WP_Meta_Query::sanitize_query
     481         */
    438482        public function test_sanitize_query_multiple_nested_queries() {
    439483                $expected = array(
    440484                        array(
     
    494538
    495539        /**
    496540         * Invalid $type will fail to get a table from _get_meta_table()
     541         *
     542         * @covers WP_Meta_Query::__construct
    497543         */
    498544        public function test_get_sql_invalid_type() {
    499545                $query = new WP_Meta_Query();
     
    502548
    503549        /**
    504550         * @ticket 22096
     551         *
     552         * @covers WP_Meta_Query::__construct
    505553         */
    506554        public function test_empty_value_sql() {
    507555                global $wpdb;
     
    533581
    534582        /**
    535583         * @ticket 22967
     584         *
     585         * @covers WP_Meta_Query::__construct
    536586         */
    537587        public function test_null_value_sql() {
    538588                global $wpdb;
     
    554604        /**
    555605         * "key only queries" are queries that don't need to match a value, so
    556606         * they can be grouped together into a single clause without JOINs
     607         *
     608         * @covers WP_Meta_Query::__construct
    557609         */
    558610        public function test_get_sql_key_only_queries() {
    559611                global $wpdb;
     
    628680
    629681        /**
    630682         * Key-only and regular queries should have the key trimmed
     683         *
     684         * @covers WP_Meta_Query::__construct
    631685         */
    632686        public function test_get_sql_trim_key() {
    633687                global $wpdb;
     
    650704                $this->assertSame( 1, substr_count( $sql['where'], "meta_key = 'bar'" ) );
    651705        }
    652706
     707        /**
     708         * @covers WP_Meta_Query::__construct
     709         */
    653710        public function test_convert_null_value_to_empty_string() {
    654711                global $wpdb;
    655712
     
    667724                $this->assertSame( 1, substr_count( $sql['where'], "$wpdb->postmeta.meta_value = ''" ) );
    668725        }
    669726
     727        /**
     728         * @covers WP_Meta_Query::__construct
     729         */
    670730        public function test_get_sql_convert_lowercase_compare_to_uppercase() {
    671731                global $wpdb;
    672732
     
    685745                $this->assertSame( 1, substr_count( $sql['where'], 'REGEXP' ) );
    686746        }
    687747
     748        /**
     749         * @covers WP_Meta_Query::__construct
     750         */
    688751        public function test_get_sql_empty_meta_compare_with_array_value() {
    689752                global $wpdb;
    690753
     
    702765                $this->assertSame( 1, substr_count( $sql['where'], "$wpdb->postmeta.meta_value IN" ) );
    703766        }
    704767
     768        /**
     769         * @covers WP_Meta_Query::__construct
     770         */
    705771        public function test_get_sql_empty_meta_compare_with_non_array_value() {
    706772                global $wpdb;
    707773
     
    741807         * Verifies only that meta_type_key is passed. See query/metaQuery.php for more complete tests.
    742808         *
    743809         * @ticket 43446
     810         *
     811         * @covers WP_Query::__construct
    744812         */
    745813        public function test_meta_type_key_should_be_passed_to_meta_query() {
    746814                $posts = self::factory()->post->create_many( 3 );
     
    774842
    775843        /**
    776844         * This is the clause that ensures that empty arrays are not valid queries.
     845         *
     846         * @covers WP_Meta_Query::get_sql
    777847         */
    778848        public function test_get_sql_null_value_and_empty_key_should_not_have_table_join() {
    779849                global $wpdb;
     
    794864                $this->assertSame( 0, substr_count( $sql['join'], 'AS mt' ) );
    795865        }
    796866
     867        /**
     868         * @covers WP_Meta_Query::__construct
     869         */
    797870        public function test_get_sql_compare_array_comma_separated_values() {
    798871                global $wpdb;
    799872
     
    843916                $this->assertSame( 1, substr_count( $sql['where'], "('bar','baz','barry')" ) );
    844917        }
    845918
     919        /**
     920         * @covers WP_Meta_Query::__construct
     921         */
    846922        public function test_get_sql_compare_array() {
    847923                global $wpdb;
    848924
     
    863939
    864940        /**
    865941         * Non-array values are trimmed. @todo Why?
     942         *
     943         * @covers WP_Meta_Query::__construct
    866944         */
    867945        public function test_get_sql_trim_string_value() {
    868946                global $wpdb;
     
    881959                $this->assertSame( 1, substr_count( $sql['where'], "$wpdb->postmeta.meta_value = 'bar'" ) );
    882960        }
    883961
     962        /**
     963         * @covers WP_Meta_Query::__construct
     964         */
    884965        public function test_not_exists() {
    885966                global $wpdb;
    886967
     
    904985                $this->assertContains( "{$wpdb->postmeta}.post_id IS NULL", $sql['where'] );
    905986        }
    906987
     988        /**
     989         * @covers WP_Meta_Query::__construct
     990         */
    907991        public function test_empty_compare() {
    908992                global $wpdb;
    909993
     
    9311015
    9321016        /**
    9331017         * @ticket 32592
     1018         *
     1019         * @covers WP_Meta_Query::has_or_relation
    9341020         */
    9351021        public function test_has_or_relation_should_return_false() {
    9361022                $q = new WP_Meta_Query(
     
    9591045
    9601046        /**
    9611047         * @ticket 32592
     1048         *
     1049         * @covers WP_Meta_Query::has_or_relation
    9621050         */
    9631051        public function test_has_or_relation_should_return_true_for_top_level_or() {
    9641052                $q = new WP_Meta_Query(
     
    9871075
    9881076        /**
    9891077         * @ticket 32592
     1078         *
     1079         * @covers WP_Meta_Query::has_or_relation
    9901080         */
    9911081        public function test_has_or_relation_should_return_true_for_nested_or() {
    9921082                $q = new WP_Meta_Query(
  • tests/phpunit/tests/meta/registerMeta.php

     
    3939                return $allowed;
    4040        }
    4141
     42        /**
     43         * @covers ::register_meta
     44         */
    4245        public function test_register_meta_back_compat_with_auth_callback_and_no_sanitize_callback_has_old_style_auth_filter() {
    4346                register_meta( 'post', 'flight_number', null, array( $this, '_old_auth_meta_cb' ) );
    4447                $has_filter = has_filter( 'auth_post_meta_flight_number', array( $this, '_old_auth_meta_cb' ) );
     
    4851                $this->assertSame( 10, $has_filter );
    4952        }
    5053
     54        /**
     55         * @covers ::register_meta
     56         */
    5157        public function test_register_meta_back_compat_with_sanitize_callback_and_no_auth_callback_has_old_style_sanitize_filter() {
    5258                register_meta( 'post', 'flight_number', array( $this, '_old_sanitize_meta_cb' ) );
    5359                $has_filter = has_filter( 'sanitize_post_meta_flight_number', array( $this, '_old_sanitize_meta_cb' ) );
     
    5662                $this->assertSame( 10, $has_filter );
    5763        }
    5864
     65        /**
     66         * @covers ::register_meta
     67         */
    5968        public function test_register_meta_back_compat_with_auth_and_sanitize_callback_has_old_style_filters() {
    6069                register_meta( 'post', 'flight_number', array( $this, '_old_sanitize_meta_cb' ), array( $this, '_old_auth_meta_cb' ) );
    6170                $has_filters             = array();
     
    7382                );
    7483        }
    7584
     85        /**
     86         * @covers ::register_meta
     87         */
    7688        public function test_register_meta_with_post_object_type_returns_true() {
    7789                $result = register_meta( 'post', 'flight_number', array() );
    7890                unregister_meta_key( 'post', 'flight_number' );
     
    8092                $this->assertTrue( $result );
    8193        }
    8294
     95        /**
     96         * @covers ::register_meta
     97         */
    8398        public function test_register_meta_with_post_object_type_populates_wp_meta_keys() {
    8499                global $wp_meta_keys;
    85100
     
    105120                $this->assertSame( $expected, $actual );
    106121        }
    107122
     123        /**
     124         * @covers ::register_meta
     125         */
    108126        public function test_register_meta_with_term_object_type_populates_wp_meta_keys() {
    109127                global $wp_meta_keys;
    110128                register_meta( 'term', 'category_icon', array() );
     
    129147                $this->assertSame( $expected, $actual );
    130148        }
    131149
     150        /**
     151         * @covers ::register_meta
     152         */
    132153        public function test_register_meta_with_deprecated_sanitize_callback_does_not_populate_wp_meta_keys() {
    133154                global $wp_meta_keys;
    134155
     
    140161                $this->assertSame( array(), $actual );
    141162        }
    142163
     164        /**
     165         * @covers ::register_meta
     166         */
    143167        public function test_register_meta_with_deprecated_sanitize_callback_param_returns_false() {
    144168                $actual = register_meta( 'post', 'flight_number', array( $this, '_old_sanitize_meta_cb' ) );
    145169
     
    149173                $this->assertFalse( $actual );
    150174        }
    151175
     176        /**
     177         * @covers ::register_meta
     178         */
    152179        public function test_register_meta_with_deprecated_sanitize_callback_parameter_passes_through_filter() {
    153180                register_meta( 'post', 'old_sanitized_key', array( $this, '_old_sanitize_meta_cb' ) );
    154181                $meta = sanitize_meta( 'old_sanitized_key', 'unsanitized', 'post', 'post' );
     
    159186                $this->assertSame( 'old_sanitized_key old sanitized', $meta );
    160187        }
    161188
     189        /**
     190         * @covers ::register_meta
     191         */
    162192        public function test_register_meta_with_current_sanitize_callback_populates_wp_meta_keys() {
    163193                global $wp_meta_keys;
    164194                register_meta( 'post', 'flight_number', array( 'sanitize_callback' => array( $this, '_new_sanitize_meta_cb' ) ) );
     
    182212                $this->assertSame( $actual, $expected );
    183213        }
    184214
     215        /**
     216         * @covers ::register_meta
     217         */
    185218        public function test_register_meta_with_current_sanitize_callback_returns_true() {
    186219                $result = register_meta( 'post', 'flight_number', array( 'sanitize_callback' => array( $this, '_new_sanitize_meta_cb' ) ) );
    187220                unregister_meta_key( 'post', 'flight_number' );
     
    189222                $this->assertTrue( $result );
    190223        }
    191224
     225        /**
     226         * @covers ::register_meta
     227         */
    192228        public function test_register_meta_with_new_sanitize_callback_parameter() {
    193229                register_meta( 'post', 'new_sanitized_key', array( 'sanitize_callback' => array( $this, '_new_sanitize_meta_cb' ) ) );
    194230                $meta = sanitize_meta( 'new_sanitized_key', 'unsanitized', 'post' );
     
    198234                $this->assertSame( 'new_sanitized_key new sanitized', $meta );
    199235        }
    200236
     237        /**
     238         * @covers ::unregister_meta_key
     239         */
    201240        public function test_register_meta_unregistered_meta_key_removes_sanitize_filter() {
    202241                register_meta( 'post', 'new_sanitized_key', array( 'sanitize_callback' => array( $this, '_new_sanitize_meta_cb' ) ) );
    203242                unregister_meta_key( 'post', 'new_sanitized_key' );
     
    207246                $this->assertFalse( $has_filter );
    208247        }
    209248
     249        /**
     250         * @covers ::unregister_meta_key
     251         */
    210252        public function test_register_meta_unregistered_meta_key_removes_auth_filter() {
    211253                register_meta( 'post', 'new_auth_key', array( 'auth_callback' => array( $this, '_new_auth_meta_cb' ) ) );
    212254                unregister_meta_key( 'post', 'new_auth_key' );
     
    216258                $this->assertFalse( $has_filter );
    217259        }
    218260
     261        /**
     262         * @covers ::unregister_meta_key
     263         */
    219264        public function test_unregister_meta_key_clears_key_from_wp_meta_keys() {
    220265                global $wp_meta_keys;
    221266                register_meta( 'post', 'registered_key', array() );
     
    224269                $this->assertSame( array(), $wp_meta_keys );
    225270        }
    226271
     272        /**
     273         * @covers ::unregister_meta_key
     274         */
    227275        public function test_unregister_meta_key_with_invalid_key_returns_false() {
    228276                $this->assertFalse( unregister_meta_key( 'post', 'not_a_registered_key' ) );
    229277        }
    230278
     279        /**
     280         * @covers ::get_registered_meta_keys
     281         */
    231282        public function test_get_registered_meta_keys() {
    232283                register_meta( 'post', 'registered_key1', array() );
    233284                register_meta( 'post', 'registered_key2', array() );
     
    241292                $this->assertArrayHasKey( 'registered_key2', $meta_keys );
    242293        }
    243294
     295        /**
     296         * @covers ::get_registered_meta_keys
     297         */
    244298        public function test_get_registered_meta_keys_with_invalid_type_is_empty() {
    245299                register_meta( 'post', 'registered_key1', array() );
    246300                register_meta( 'post', 'registered_key2', array() );
     
    253307                $this->assertEmpty( $meta_keys );
    254308        }
    255309
     310
     311        /**
     312         * @covers ::get_registered_meta_keys
     313         */
    256314        public function test_get_registered_meta_keys_description_arg() {
    257315                register_meta( 'post', 'registered_key1', array( 'description' => 'I\'m just a field, take a good look at me' ) );
    258316
     
    263321                $this->assertSame( 'I\'m just a field, take a good look at me', $meta_keys['registered_key1']['description'] );
    264322        }
    265323
     324        /**
     325         * @covers ::get_registered_meta_keys
     326         */
    266327        public function test_get_registered_meta_keys_invalid_arg() {
    267328                register_meta( 'post', 'registered_key1', array( 'invalid_arg' => 'invalid' ) );
    268329
     
    273334                $this->assertArrayNotHasKey( 'invalid_arg', $meta_keys['registered_key1'] );
    274335        }
    275336
     337        /**
     338         * @covers ::get_registered_metadata
     339         */
    276340        public function test_get_registered_metadata() {
    277341                register_meta( 'post', 'flight_number', array() );
    278342                add_post_meta( self::$post_id, 'flight_number', 'Oceanic 815' );
     
    284348                $this->assertSame( 'Oceanic 815', $meta['flight_number'][0] );
    285349        }
    286350
     351        /**
     352         * @covers ::get_registered_metadata
     353         */
    287354        public function test_get_registered_metadata_by_key() {
    288355                register_meta( 'post', 'flight_number', array() );
    289356                add_post_meta( self::$post_id, 'flight_number', 'Oceanic 815' );
     
    295362                $this->assertSame( 'Oceanic 815', $meta[0] );
    296363        }
    297364
     365        /**
     366         * @covers ::get_registered_metadata
     367         */
    298368        public function test_get_registered_metadata_by_key_single() {
    299369                register_meta( 'post', 'flight_number', array( 'single' => true ) );
    300370                add_post_meta( self::$post_id, 'flight_number', 'Oceanic 815' );
     
    306376                $this->assertSame( 'Oceanic 815', $meta );
    307377        }
    308378
     379        /**
     380         * @covers ::get_registered_metadata
     381         */
    309382        public function test_get_registered_metadata_by_invalid_key() {
    310383                register_meta( 'post', 'flight_number', array() );
    311384                add_post_meta( self::$post_id, 'flight_number', 'Oceanic 815' );
     
    317390                $this->assertFalse( $meta );
    318391        }
    319392
     393        /**
     394         * @covers ::get_registered_metadata
     395         */
    320396        public function test_get_registered_metadata_invalid_object_type_returns_empty_array() {
    321397                $meta = get_registered_metadata( 'invalid-type', self::$post_id );
    322398
     
    326402        /**
    327403         * @ticket 38323
    328404         * @dataProvider data_get_types_and_subtypes
     405         *
     406         * @covers ::register_meta
    329407         */
    330408        public function test_register_meta_with_subtype_populates_wp_meta_keys( $type, $subtype ) {
    331409                global $wp_meta_keys;
     
    358436        /**
    359437         * @ticket 38323
    360438         * @dataProvider data_get_types_and_subtypes
     439         *
     440         * @covers ::unregister_meta_key
    361441         */
    362442        public function test_unregister_meta_with_subtype_unpopulates_wp_meta_keys( $type, $subtype ) {
    363443                global $wp_meta_keys;
     
    376456        /**
    377457         * @ticket 38323
    378458         * @dataProvider data_get_types_and_subtypes
     459         *
     460         * @covers ::unregister_meta_key
    379461         */
    380462        public function test_unregister_meta_without_subtype_keeps_subtype_meta_key( $type, $subtype ) {
    381463                global $wp_meta_keys;
     
    411493        /**
    412494         * @ticket 38323
    413495         * @dataProvider data_get_types_and_subtypes
     496         *
     497         * @covers ::get_registered_meta_keys
    414498         */
    415499        public function test_get_registered_meta_keys_with_subtype( $type, $subtype ) {
    416500                register_meta( $type, 'registered_key1', array( 'object_subtype' => $subtype ) );
     
    426510        /**
    427511         * @ticket 38323
    428512         * @dataProvider data_get_types_and_subtypes
     513         *
     514         * @covers ::get_registered_meta_keys
    429515         */
    430516        public function test_get_registered_metadata_with_subtype( $type, $subtype ) {
    431517                register_meta( $type, 'registered_key1', array() );
     
    483569        /**
    484570         * @ticket 38323
    485571         * @dataProvider data_get_types_and_subtypes
     572         *
     573         * @covers ::get_object_subtype
    486574         */
    487575        public function test_get_object_subtype( $type, $expected_subtype ) {
    488576                $object_property_name = $type . '_id';
     
    493581
    494582        /**
    495583         * @ticket 38323
     584         *
     585         * @covers ::get_object_subtype
    496586         */
    497587        public function test_get_object_subtype_custom() {
    498588                add_filter( 'get_object_subtype_customtype', array( $this, 'filter_get_object_subtype_for_customtype' ), 10, 2 );
     
    507597        /**
    508598         * @ticket 43941
    509599         * @dataProvider data_get_default_data
     600         *
     601         * @covers ::get_metadata_default
    510602         */
    511603        public function test_get_default_value( $args, $single, $expected ) {
    512604
     
    552644        /**
    553645         * @ticket 43941
    554646         * @dataProvider data_get_invalid_default_data
     647         *
     648         * @covers ::get_metadata_default
    555649         */
    556650        public function test_get_invalid_default_value( $args, $single, $expected ) {
    557651                $this->setExpectedIncorrectUsage( 'register_meta' );
  • tests/phpunit/tests/meta/slashes.php

     
    3434
    3535        /**
    3636         * Tests the controller function that expects slashed data.
     37         *
     38         * @covers ::add_magic_quotes
    3739         */
    3840        function test_edit_post() {
    3941                $post_id = self::$post_id;
     
    111113
    112114        /**
    113115         * Tests the legacy model function that expects slashed data.
     116         *
     117         * @covers ::add_post_meta
    114118         */
    115119        function test_add_post_meta() {
    116120                $post_id = self::$post_id;
     
    126130
    127131        /**
    128132         * Tests the legacy model function that expects slashed data.
     133         *
     134         * @covers ::update_post_meta
    129135         */
    130136        function test_update_post_meta() {
    131137                $post_id = self::$post_id;
     
    141147
    142148        /**
    143149         * Tests the model function that expects slashed data.
     150         *
     151         * @covers ::add_comment_meta
    144152         */
    145153        function test_add_comment_meta() {
    146154                $comment_id = self::$comment_id;
     
    164172
    165173        /**
    166174         * Tests the model function that expects slashed data.
     175         *
     176         * @covers ::update_comment_meta
    167177         */
    168178        function test_update_comment_meta() {
    169179                $comment_id = self::$comment_id;
     
    191201
    192202        /**
    193203         * Tests the model function that expects slashed data.
     204         *
     205         * @covers ::add_user_meta
    194206         */
    195207        function test_add_user_meta() {
    196208                $user_id = self::$user_id;
     
    214226
    215227        /**
    216228         * Tests the model function that expects slashed data.
     229         *
     230         * @covers ::update_user_meta
    217231         */
    218232        function test_update_user_meta() {
    219233                $user_id = self::$user_id;
  • tests/phpunit/tests/meta/updateMetadata.php

     
    77class Tests_Meta_UpdateMetadata extends WP_UnitTestCase {
    88        /**
    99         * @ticket 35795
     10         *
     11         * @covers ::update_metadata
    1012         */
    1113        public function test_slashed_key_for_new_metadata() {
    1214                update_metadata( 'post', 123, wp_slash( 'foo\foo' ), 'bar' );
     
    1719
    1820        /**
    1921         * @ticket 35795
     22         *
     23         * @covers ::update_metadata
    2024         */
    2125        public function test_slashed_key_for_existing_metadata() {
    2226                global $wpdb;
  • tests/phpunit/tests/multisite/bootstrap.php

     
    122122                 * @param string $domain       The requested domain.
    123123                 * @param string $path         The requested path.
    124124                 * @param string $message      The message to pass for failed tests.
     125                 *
     126                 * @covers ::get_network_by_path
    125127                 */
    126128                function test_get_network_by_path( $expected_key, $domain, $path, $message ) {
    127129                        $network = get_network_by_path( $domain, $path );
     
    153155                 * @param string $domain       The requested domain.
    154156                 * @param string $path         The requested path.
    155157                 * @param string $message      The message to pass for failed tests.
     158                 *
     159                 * @covers ::get_network_by_path
    156160                 */
    157161                public function test_get_network_by_path_with_zero_path_segments( $expected_key, $domain, $path, $message ) {
    158162                        add_filter( 'network_by_path_segments_count', '__return_zero' );
     
    180184                /**
    181185                 * Even if a matching network is available, it should not match if the the filtered
    182186                 * value for network path segments is fewer than the number of paths passed.
     187                 *
     188                 * @covers ::get_network_by_path
    183189                 */
    184190                public function test_get_network_by_path_with_forced_single_path_segment_returns_single_path_network() {
    185191                        add_filter( 'network_by_path_segments_count', array( $this, 'filter_network_path_segments' ) );
     
    202208                 * @param string $domain       The requested domain.
    203209                 * @param string $path         The requested path.
    204210                 * @param int    $segments     Optional. Number of segments to use in `get_site_by_path()`.
     211                 *
     212                 * @covers ::get_site_by_path
    205213                 */
    206214                public function test_get_site_by_path( $expected_key, $domain, $path, $segments = null ) {
    207215                        $site = get_site_by_path( $domain, $path, $segments );
     
    254262                 * @param string $network_key The array key associated with the expected network for the test.
    255263                 * @param string $domain      The requested domain.
    256264                 * @param string $path        The requested path.
     265                 *
     266                 * @covers ::ms_load_current_site_and_network
    257267                 */
    258268                function test_multisite_bootstrap( $site_key, $network_key, $domain, $path ) {
    259269                        global $current_blog;
     
    293303
    294304                /**
    295305                 * @ticket 27884
     306                 *
     307                 * @covers ::ms_load_current_site_and_network
    296308                 */
    297309                public function test_multisite_bootstrap_additional_path_segments() {
    298310                        global $current_blog;
     
    315327
    316328                /**
    317329                 * @ticket 37053
     330                 *
     331                 * @covers ::get_site_by_path
    318332                 */
    319333                public function test_get_site_by_path_returns_wp_site() {
    320334                        add_filter( 'pre_get_site_by_path', array( $this, 'filter_pre_get_site_by_path' ), 10, 3 );
  • tests/phpunit/tests/multisite/cleanDirsizeCache.php

     
    2727                 * Test whether dirsize_cache values are used correctly with a more complex dirsize cache mock.
    2828                 *
    2929                 * @ticket 19879
     30                 *
     31                 * @covers ::recurse_dirsize
    3032                 */
    3133                function test_get_dirsize_cache_in_recurse_dirsize_mock() {
    3234                        $blog_id = self::factory()->blog->create();
     
    7678                 * Test whether the dirsize_cache invalidation works given a file path as input.
    7779                 *
    7880                 * @ticket 19879
     81                 *
     82                 * @covers ::clean_dirsize_cache
    7983                 */
    8084                function test_clean_dirsize_cache_file_input_mock() {
    8185                        $blog_id = self::factory()->blog->create();
     
    124128                 * Test whether the dirsize_cache invalidation works given a directory path as input.
    125129                 *
    126130                 * @ticket 19879
     131                 *
     132                 * @covers ::clean_dirsize_cache
    127133                 */
    128134                function test_clean_dirsize_cache_folder_input_mock() {
    129135                        $blog_id = self::factory()->blog->create();
     
    172178                 * Test whether dirsize_cache values are used correctly with a simple real upload.
    173179                 *
    174180                 * @ticket 19879
     181                 *
     182                 * @covers ::recurse_dirsize
    175183                 */
    176184                function test_get_dirsize_cache_in_recurse_dirsize_upload() {
    177185                        $blog_id = self::factory()->blog->create();
  • tests/phpunit/tests/multisite/getBlogDetails.php

     
    4141                        wp_update_network_site_counts();
    4242                }
    4343
     44                /**
     45                 * @covers ::get_blog_details
     46                 */
    4447                public function test_get_blog_details_with_no_arguments_returns_current_site() {
    4548                        $site = get_blog_details();
    4649                        $this->assertEquals( get_current_blog_id(), $site->blog_id );
    4750                }
    4851
     52                /**
     53                 * @covers ::get_blog_details
     54                 */
    4955                public function test_get_blog_details_with_site_name_string_subdirectory() {
    5056                        if ( is_subdomain_install() ) {
    5157                                $this->markTestSkipped( 'This test is only valid in a subdirectory configuration.' );
     
    5561                        $this->assertEquals( self::$site_ids[ WP_TESTS_DOMAIN . '/foo/' ], $site->blog_id );
    5662                }
    5763
     64                /**
     65                 * @covers ::get_blog_details
     66                 */
    5867                public function test_get_blog_details_with_site_name_string_subdomain() {
    5968                        if ( ! is_subdomain_install() ) {
    6069                                $this->markTestSkipped( 'This test is only valid in a subdomain configuration.' );
     
    6473                        $this->assertEquals( self::$site_ids[ 'foo.' . WP_TESTS_DOMAIN . '/' ], $site->blog_id );
    6574                }
    6675
     76                /**
     77                 * @covers ::get_blog_details
     78                 */
    6779                public function test_get_blog_details_with_invalid_site_name_string() {
    6880                        $site = get_blog_details( 'invalid' );
    6981                        $this->assertFalse( $site );
    7082                }
    7183
     84                /**
     85                 * @covers ::get_blog_details
     86                 */
    7287                public function test_get_blog_details_with_site_id_int() {
    7388                        $site = get_blog_details( self::$site_ids['wordpress.org/'] );
    7489                        $this->assertEquals( self::$site_ids['wordpress.org/'], $site->blog_id );
    7590                }
    7691
     92                /**
     93                 * @covers ::get_blog_details
     94                 */
    7795                public function test_get_blog_details_with_invalid_site_id_int() {
    7896                        $site = get_blog_details( 99999 );
    7997                        $this->assertFalse( $site );
    8098                }
    8199
     100                /**
     101                 * @covers ::get_blog_details
     102                 */
    82103                public function test_get_blog_details_with_blog_id_in_fields() {
    83104                        $site = get_blog_details( array( 'blog_id' => self::$site_ids['wordpress.org/'] ) );
    84105                        $this->assertEquals( self::$site_ids['wordpress.org/'], $site->blog_id );
    85106                }
    86107
     108                /**
     109                 * @covers ::get_blog_details
     110                 */
    87111                public function test_get_blog_details_with_invalid_blog_id_in_fields() {
    88112                        $site = get_blog_details( array( 'blog_id' => 88888 ) );
    89113                        $this->assertFalse( $site );
    90114                }
    91115
     116                /**
     117                 * @covers ::get_blog_details
     118                 */
    92119                public function test_get_blog_details_with_domain_and_path_in_fields() {
    93120                        $site = get_blog_details(
    94121                                array(
     
    99126                        $this->assertEquals( self::$site_ids['wordpress.org/'], $site->blog_id );
    100127                }
    101128
     129                /**
     130                 * @covers ::get_blog_details
     131                 */
    102132                public function test_get_blog_details_with_domain_and_invalid_path_in_fields() {
    103133                        $site = get_blog_details(
    104134                                array(
     
    109139                        $this->assertFalse( $site );
    110140                }
    111141
     142                /**
     143                 * @covers ::get_blog_details
     144                 */
    112145                public function test_get_blog_details_with_path_and_invalid_domain_in_fields() {
    113146                        $site = get_blog_details(
    114147                                array(
     
    119152                        $this->assertFalse( $site );
    120153                }
    121154
     155                /**
     156                 * @covers ::get_blog_details
     157                 */
    122158                public function test_get_blog_details_with_only_domain_in_fields_subdomain() {
    123159                        if ( ! is_subdomain_install() ) {
    124160                                $this->markTestSkipped( 'This test is only valid in a subdomain configuration.' );
     
    128164                        $this->assertSame( self::$site_ids['wordpress.org/'], $site->blog_id );
    129165                }
    130166
     167                /**
     168                 * @covers ::get_blog_details
     169                 */
    131170                public function test_get_blog_details_with_only_domain_in_fields_subdirectory() {
    132171                        if ( is_subdomain_install() ) {
    133172                                $this->markTestSkipped( 'This test is only valid in a subdirectory configuration.' );
     
    137176                        $this->assertFalse( $site );
    138177                }
    139178
     179                /**
     180                 * @covers ::get_blog_details
     181                 */
    140182                public function test_get_blog_details_with_only_path_in_fields() {
    141183                        $site = get_blog_details( array( 'path' => '/foo/' ) );
    142184                        $this->assertFalse( $site );
     
    144186
    145187                /**
    146188                 * @ticket 50391
     189                 *
     190                 * @covers ::get_blog_details
    147191                 */
    148192                public function test_get_blog_details_does_not_switch_to_current_blog() {
    149193                        $count = did_action( 'switch_blog' );
     
    156200                 * @dataProvider data_get_all
    157201                 *
    158202                 * @ticket 40228
     203                 *
     204                 * @covers ::get_blog_details
    159205                 */
    160206                public function test_get_blog_details_get_object_vars( $get_all ) {
    161207                        $site = get_blog_details(
     
    175221                 * @dataProvider data_get_all
    176222                 *
    177223                 * @ticket 40228
     224                 *
     225                 * @covers ::get_blog_details
    178226                 */
    179227                public function test_get_blog_details_iterate_over_result( $get_all ) {
    180228                        $site = get_blog_details(
  • tests/phpunit/tests/multisite/getIdFromBlogname.php

     
    8585
    8686                /**
    8787                 * @ticket 34450
     88                 *
     89                 * @covers ::get_id_from_blogname
    8890                 */
    8991                public function test_get_id_from_blogname_no_www() {
    9092                        global $current_site;
     
    106108
    107109                /**
    108110                 * @ticket 34450
     111                 *
     112                 * @covers ::get_id_from_blogname
    109113                 */
    110114                public function test_get_id_from_blogname_www() {
    111115                        global $current_site;
     
    125129                        $this->assertSame( $expected, $result );
    126130                }
    127131
     132                /**
     133                 * @covers ::get_id_from_blogname
     134                 */
    128135                public function test_get_id_from_blogname_invalid_slug() {
    129136                        global $current_site;
    130137
  • tests/phpunit/tests/multisite/getMainSiteId.php

     
    6969
    7070                /**
    7171                 * @ticket 29684
     72                 *
     73                 * @covers ::get_main_site_id
    7274                 */
    7375                public function test_get_main_site_id_on_main_site_returns_self() {
    7476                        $this->assertSame( get_current_blog_id(), get_main_site_id() );
     
    7678
    7779                /**
    7880                 * @ticket 29684
     81                 *
     82                 * @covers ::get_main_site_id
    7983                 */
    8084                public function test_get_main_site_id_returns_main_site_in_switched_context() {
    8185                        $main_site_id  = get_current_blog_id();
     
    9094
    9195                /**
    9296                 * @ticket 29684
     97                 *
     98                 * @covers ::get_main_site_id
    9399                 */
    94100                public function test_get_main_site_id_with_different_network_returns_correct_id() {
    95101                        $this->assertSame( self::$site_ids['wordpress.org/'], get_main_site_id( self::$network_ids['wordpress.org/'] ) );
     
    97103
    98104                /**
    99105                 * @ticket 29684
     106                 *
     107                 * @covers ::get_main_site_id
    100108                 */
    101109                public function test_get_main_site_id_on_network_without_site_returns_0() {
    102110                        $this->assertSame( 0, get_main_site_id( self::$network_ids['wp.org/'] ) );
     
    104112
    105113                /**
    106114                 * @ticket 29684
     115                 *
     116                 * @covers ::get_main_site_id
    107117                 */
    108118                public function test_get_main_site_id_on_invalid_network_returns_0() {
    109119                        $this->assertSame( 0, get_main_site_id( 333 ) );
     
    111121
    112122                /**
    113123                 * @ticket 29684
     124                 *
     125                 * @covers ::get_main_site_id
    114126                 */
    115127                public function test_get_main_site_id_filtered() {
    116128                        add_filter( 'pre_get_main_site_id', array( $this, 'filter_get_main_site_id' ) );
     
    125137
    126138                /**
    127139                 * @ticket 29684
     140                 *
     141                 * @covers ::get_main_site_id
    128142                 */
    129143                public function test_get_main_site_id_filtered_depending_on_network() {
    130144                        add_filter( 'pre_get_main_site_id', array( $this, 'filter_get_main_site_id_depending_on_network' ), 10, 2 );
     
    144158
    145159                /**
    146160                 * @ticket 41936
     161                 *
     162                 * @covers ::get_main_site_id
    147163                 */
    148164                public function test_get_main_site_id_with_property_value() {
    149165                        global $current_site;
     
    160176
    161177                /**
    162178                 * @ticket 41936
     179                 *
     180                 * @covers ::get_main_site_id
    163181                 */
    164182                public function test_get_main_site_id_filtered_with_property_value() {
    165183                        global $current_site;
  • tests/phpunit/tests/multisite/getSite.php

     
    4040                        wp_update_network_site_counts();
    4141                }
    4242
     43                /**
     44                 * @covers ::get_site
     45                 */
    4346                public function test_get_site_in_switched_state_returns_switched_site() {
    4447                        switch_to_blog( self::$site_ids['wordpress.org/foo/'] );
    4548                        $site = get_site();
  • tests/phpunit/tests/multisite/getSpaceAllowed.php

     
    4343                /**
    4444                 * When no option exists for the site or the network, a fallback of
    4545                 * 100 is expected.
     46                 *
     47                 * @covers ::get_space_allowed
    4648                 */
    4749                public function test_get_space_allowed_default() {
    4850                        delete_option( 'blog_upload_space' );
     
    5456                /**
    5557                 * If an individual site's option is not available, the default network
    5658                 * level option is used as a fallback.
     59                 *
     60                 * @covers ::get_space_allowed
    5761                 */
    5862                public function test_get_space_allowed_no_site_option_fallback_to_network_option() {
    5963                        delete_site_option( 'blog_upload_space' );
     
    6872                 * @param mixed $site_option    Option to assign to the site's `blog_upload_space`.
    6973                 * @param mixed $network_option Option to assign to the network's `blog_upload_space`.
    7074                 * @param int   $expected       Expected return value.
     75                 *
     76                 * @covers ::get_space_allowed
    7177                 */
    7278                public function test_get_space_allowed( $site_option, $network_option, $expected ) {
    7379                        update_option( 'blog_upload_space', $site_option );
     
    100106                        );
    101107                }
    102108
     109                /**
     110                 * @covers ::get_space_allowed
     111                 */
    103112                public function test_get_space_allowed_filtered() {
    104113                        update_option( 'blog_upload_space', 777 );
    105114                        update_site_option( 'blog_upload_space', 888 );
  • tests/phpunit/tests/multisite/getSpaceUsed.php

     
    44
    55        /**
    66         * @group multisite
    7          * @covers ::get_space_used
    87         */
    98        class Tests_Multisite_Get_Space_Used extends WP_UnitTestCase {
    109                protected $suppress = false;
     
    2120                        parent::tearDown();
    2221                }
    2322
     23                /**
     24                 * @covers ::get_space_used
     25                 */
    2426                function test_get_space_used_switched_site() {
    2527                        $blog_id = self::factory()->blog->create();
    2628                        switch_to_blog( $blog_id );
     
    5456                /**
    5557                 * Directories of sub sites on a network should not count against the same spaced used total for
    5658                 * the main site.
     59                 *
     60                 * @covers ::get_space_used
    5761                 */
    5862                function test_get_space_used_main_site() {
    5963                        $space_used = get_space_used();
     
    8993                        restore_current_blog();
    9094                }
    9195
     96                /**
     97                 * @covers ::get_space_used
     98                 */
    9299                function test_get_space_used_pre_get_spaced_used_filter() {
    93100                        add_filter( 'pre_get_space_used', array( $this, '_filter_space_used' ) );
    94101
  • tests/phpunit/tests/multisite/isUploadSpaceAvailable.php

     
    4848                /**
    4949                 * A default of 100MB is used when no `blog_upload_space` option
    5050                 * exists at the site or network level.
     51                 *
     52                 * @covers ::is_upload_space_available
    5153                 */
    5254                public function test_is_upload_space_available_default() {
    5355                        delete_option( 'blog_upload_space' );
     
    6062                        $this->assertTrue( $available );
    6163                }
    6264
     65                /**
     66                 * @covers ::is_upload_space_available
     67                 */
    6368                public function test_is_upload_space_available_check_disabled() {
    6469                        update_site_option( 'blog_upload_space', 10 );
    6570                        update_site_option( 'upload_space_check_disabled', true );
     
    7176                        $this->assertTrue( $available );
    7277                }
    7378
     79                /**
     80                 * @covers ::is_upload_space_available
     81                 */
    7482                public function test_is_upload_space_available_space_used_is_less_then_allowed() {
    7583                        update_option( 'blog_upload_space', 350 );
    7684
     
    8189                        $this->assertTrue( $available );
    8290                }
    8391
     92                /**
     93                 * @covers ::is_upload_space_available
     94                 */
    8495                function test_is_upload_space_available_space_used_is_more_than_allowed() {
    8596                        update_option( 'blog_upload_space', 350 );
    8697
     
    94105                /**
    95106                 * More comprehensive testing a 0 condition is handled in the tests
    96107                 * for `get_space_allowed()`. We cover one scenario here.
     108                 *
     109                 * @covers ::is_upload_space_available
    97110                 */
    98111                function test_is_upload_space_available_upload_space_0_defaults_to_100() {
    99112                        update_option( 'blog_upload_space', 0 );
     
    105118                        $this->assertFalse( $available );
    106119                }
    107120
     121                /**
     122                 * @covers ::is_upload_space_available
     123                 */
    108124                function test_is_upload_space_available_upload_space_negative() {
    109125                        update_site_option( 'blog_upload_space', -1 );
    110126
  • tests/phpunit/tests/multisite/ms-files-rewriting.php

     
    3232                        parent::tearDown();
    3333                }
    3434
     35                /**
     36                 * @covers ::switch_to_blog
     37                 * @covers ::wp_upload_dir
     38                 */
    3539                function test_switch_upload_dir() {
    3640                        $this->assertTrue( is_main_site() );
    3741
     
    5963                 * When a site is deleted with wpmu_delete_blog(), only the files associated with
    6064                 * that site should be removed. When wpmu_delete_blog() is run a second time, nothing
    6165                 * should change with upload directories.
     66                 *
     67                 * @covers ::wpmu_delete_blog
    6268                 */
    6369                function test_upload_directories_after_multiple_wpmu_delete_blog_with_ms_files() {
    6470                        $filename = __FUNCTION__ . '.jpg';
  • tests/phpunit/tests/multisite/network.php

     
    7474
    7575                /**
    7676                 * By default, only one network exists and has a network ID of 1.
     77                 *
     78                 * @covers ::get_main_network_id
    7779                 */
    7880                function test_get_main_network_id_default() {
    7981                        $this->assertSame( 1, get_main_network_id() );
     
    8284                /**
    8385                 * If a second network is created, network ID 1 should still be returned
    8486                 * as the main network ID.
     87                 *
     88                 * @covers ::get_main_network_id
    8589                 */
    8690                function test_get_main_network_id_two_networks() {
    8791                        self::factory()->network->create();
     
    9296                /**
    9397                 * When the `$current_site` global is populated with another network, the
    9498                 * main network should still return as 1.
     99                 *
     100                 * @covers ::get_main_network_id
    95101                 */
    96102                function test_get_main_network_id_after_network_switch() {
    97103                        global $current_site;
     
    109115                 *
    110116                 * @todo In the future, we'll have a smarter way of deleting a network. For now,
    111117                 * fake the process with UPDATE queries.
     118                 *
     119                 * @covers ::get_main_network_id
    112120                 */
    113121                function test_get_main_network_id_after_network_delete() {
    114122                        global $wpdb, $current_site;
     
    135143
    136144                /**
    137145                 * @ticket 37050
     146                 *
     147                 * @covers WP_Network::get_instance
    138148                 */
    139149                function test_wp_network_object_id_property_is_int() {
    140150                        $id = self::factory()->network->create();
     
    146156
    147157                /**
    148158                 * @ticket 22917
     159                 *
     160                 * @covers ::get_blog_count
    149161                 */
    150162                public function test_get_blog_count_no_filter_applied() {
    151163                        wp_update_network_counts();
     
    164176
    165177                /**
    166178                 * @ticket 22917
     179                 *
     180                 * @covers ::get_blog_count
    167181                 */
    168182                public function test_get_blog_count_enable_live_network_counts_false() {
    169183                        wp_update_network_counts();
     
    184198
    185199                /**
    186200                 * @ticket 22917
     201                 *
     202                 * @covers ::get_blog_count
    187203                 */
    188204                public function test_get_blog_count_enabled_live_network_counts_true() {
    189205                        wp_update_network_counts();
     
    204220
    205221                /**
    206222                 * @ticket 37865
     223                 *
     224                 * @covers ::get_blog_count
    207225                 */
    208226                public function test_get_blog_count_on_different_network() {
    209227                        wp_update_network_site_counts( self::$different_network_id );
     
    215233
    216234                /**
    217235                 * @ticket 37866
     236                 *
     237                 * @covers ::get_blog_count
    218238                 */
    219239                public function test_get_user_count_on_different_network() {
    220240                        wp_update_network_user_counts();
     
    232252
    233253                /**
    234254                 * @ticket 22917
     255                 *
     256                 * @covers ::get_blog_count
    235257                 */
    236258                function test_enable_live_network_user_counts_filter() {
    237259                        // False for large networks by default.
     
    262284                        remove_filter( 'enable_live_network_counts', '__return_true' );
    263285                }
    264286
     287                /**
     288                 * @covers ::wp_get_active_network_plugins
     289                 */
    265290                function test_active_network_plugins() {
    266291                        $path = 'hello.php';
    267292
     
    292317
    293318                /**
    294319                 * @ticket 28651
     320                 *
     321                 * @covers ::wp_get_active_network_plugins
    295322                 */
    296323                function test_duplicate_network_active_plugin() {
    297324                        $path = 'hello.php';
     
    313340                        remove_action( 'activate_' . $path, array( $mock, 'action' ) );
    314341                }
    315342
     343                /**
     344                 * @covers ::is_plugin_active_for_network
     345                 */
    316346                function test_is_plugin_active_for_network_true() {
    317347                        activate_plugin( 'hello.php', '', true );
    318348                        $this->assertTrue( is_plugin_active_for_network( 'hello.php' ) );
    319349                }
    320350
     351                /**
     352                 * @covers ::is_plugin_active_for_network
     353                 */
    321354                function test_is_plugin_active_for_network_false() {
    322355                        deactivate_plugins( 'hello.php', false, true );
    323356                        $this->assertFalse( is_plugin_active_for_network( 'hello.php' ) );
     
    327360                        $this->plugin_hook_count++;
    328361                }
    329362
     363                /**
     364                 * @covers ::get_user_count
     365                 */
    330366                function test_get_user_count() {
    331367                        // Refresh the cache.
    332368                        wp_update_network_counts();
     
    346382                        remove_filter( 'enable_live_network_counts', '__return_false' );
    347383                }
    348384
     385                /**
     386                 * @coversNothing
     387                 */
    349388                function test_wp_schedule_update_network_counts() {
    350389                        $this->assertFalse( wp_next_scheduled( 'update_network_counts' ) );
    351390
     
    357396
    358397                /**
    359398                 * @expectedDeprecated get_dashboard_blog
     399                 *
     400                 * @covers ::get_dashboard_blog
    360401                 */
    361402                function test_get_dashboard_blog() {
    362403                        // If there is no dashboard blog set, current blog is used.
     
    375416
    376417                /**
    377418                 * @ticket 37528
     419                 *
     420                 * @covers ::wp_update_network_site_counts
    378421                 */
    379422                function test_wp_update_network_site_counts() {
    380423                        update_network_option( null, 'blog_count', 40 );
     
    397440
    398441                /**
    399442                 * @ticket 37528
     443                 *
     444                 * @covers ::wp_update_network_site_counts
    400445                 */
    401446                function test_wp_update_network_site_counts_on_different_network() {
    402447                        update_network_option( self::$different_network_id, 'blog_count', 40 );
     
    409454
    410455                /**
    411456                 * @ticket 40349
     457                 *
     458                 * @covers ::wp_update_network_site_counts
    412459                 */
    413460                public function test_wp_update_network_user_counts() {
    414461                        global $wpdb;
     
    425472
    426473                /**
    427474                 * @ticket 40349
     475                 *
     476                 * @covers ::wp_update_network_site_counts
    428477                 */
    429478                public function test_wp_update_network_user_counts_on_different_network() {
    430479                        global $wpdb;
     
    441490
    442491                /**
    443492                 * @ticket 40386
     493                 *
     494                 * @covers ::wp_update_network_site_counts
    444495                 */
    445496                public function test_wp_update_network_counts() {
    446497                        delete_network_option( null, 'blog_count' );
     
    456507
    457508                /**
    458509                 * @ticket 40386
     510                 *
     511                 * @covers ::wp_update_network_site_counts
    459512                 */
    460513                public function test_wp_update_network_counts_on_different_network() {
    461514                        delete_network_option( self::$different_network_id, 'blog_count' );
     
    472525                /**
    473526                 * @ticket 40489
    474527                 * @dataProvider data_wp_is_large_network
     528                 *
     529                 * @covers ::wp_is_large_network
    475530                 */
    476531                public function test_wp_is_large_network( $using, $count, $expected, $different_network ) {
    477532                        $network_id     = $different_network ? self::$different_network_id : null;
     
    503558                /**
    504559                 * @ticket 40489
    505560                 * @dataProvider data_wp_is_large_network_filtered_by_component
     561                 *
     562                 * @covers ::wp_is_large_network
    506563                 */
    507564                public function test_wp_is_large_network_filtered_by_component( $using, $count, $expected, $different_network ) {
    508565                        $network_id     = $different_network ? self::$different_network_id : null;
     
    545602                /**
    546603                 * @ticket 40489
    547604                 * @dataProvider data_wp_is_large_network_filtered_by_network
     605                 *
     606                 * @covers ::wp_is_large_network
    548607                 */
    549608                public function test_wp_is_large_network_filtered_by_network( $using, $count, $expected, $different_network ) {
    550609                        $network_id     = $different_network ? self::$different_network_id : null;
     
    586645
    587646                /**
    588647                 * @ticket 38699
     648                 *
     649                 * @covers ::wpmu_create_blog
    589650                 */
    590651                public function test_wpmu_create_blog_updates_correct_network_site_count() {
    591652                        $original_count = get_blog_count( self::$different_network_id );
     
    601662
    602663                /**
    603664                 * @ticket 29684
     665                 *
     666                 * @covers ::get_network
    604667                 */
    605668                public function test_network_blog_id_set() {
    606669                        $network = get_network( self::$different_network_id );
     
    610673
    611674                /**
    612675                 * @ticket 42251
     676                 *
     677                 * @covers ::get_network
    613678                 */
    614679                public function test_get_network_not_found_cache() {
    615680                        global $wpdb;
     
    624689
    625690                /**
    626691                 * @ticket 42251
     692                 *
     693                 * @covers ::get_network
    627694                 */
    628695                public function test_get_network_not_found_cache_clear() {
    629696                        $new_network_id = $this->_get_next_network_id();
  • tests/phpunit/tests/multisite/networkQuery.php

     
    6161                        }
    6262                }
    6363
     64                /**
     65                 * @covers WP_Network_Query::query
     66                 */
    6467                public function test_wp_network_query_by_number() {
    6568                        $q     = new WP_Network_Query();
    6669                        $found = $q->query(
     
    7376                        $this->assertSame( 3, count( $found ) );
    7477                }
    7578
     79                /**
     80                 * @covers WP_Network_Query::query
     81                 */
    7682                public function test_wp_network_query_by_network__in_with_order() {
    7783                        $expected = array( self::$network_ids['wordpress.org/'], self::$network_ids['make.wordpress.org/'] );
    7884
     
    98104                        $this->assertSame( array_reverse( $expected ), $found );
    99105                }
    100106
     107                /**
     108                 * @covers WP_Network_Query::query
     109                 */
    101110                public function test_wp_network_query_by_network__in_with_single_id() {
    102111                        $expected = array( self::$network_ids['wordpress.org/'] );
    103112
     
    112121                        $this->assertSameSets( $expected, $found );
    113122                }
    114123
     124        /**
     125         * @covers WP_Network_Query::query
     126         */
    115127                public function test_wp_network_query_by_network__in_with_multiple_ids() {
    116128                        $expected = array( self::$network_ids['wordpress.org/'], self::$network_ids['www.wordpress.net/'] );
    117129
     
    126138                        $this->assertSameSets( $expected, $found );
    127139                }
    128140
     141                /**
     142                 * @covers WP_Network_Query::query
     143                 */
    129144                public function test_wp_network_query_by_network__in_and_count_with_multiple_ids() {
    130145                        $expected = array( self::$network_ids['wordpress.org/'], self::$network_ids['make.wordpress.org/'] );
    131146
     
    141156                        $this->assertSame( 2, $found );
    142157                }
    143158
     159                /**
     160                 * @covers WP_Network_Query::query
     161                 */
    144162                public function test_wp_network_query_by_network__not_in_with_single_id() {
    145163                        $excluded = array( self::$network_ids['wordpress.org/'] );
    146164                        $expected = array_diff( self::$network_ids, $excluded );
     
    159177                        $this->assertSameSets( $expected, $found );
    160178                }
    161179
     180                /**
     181                 * @covers WP_Network_Query::query
     182                 */
    162183                public function test_wp_network_query_by_network__not_in_with_multiple_ids() {
    163184                        $excluded = array( self::$network_ids['wordpress.org/'], self::$network_ids['www.w.org/foo/'] );
    164185                        $expected = array_diff( self::$network_ids, $excluded );
     
    177198                        $this->assertSameSets( $expected, $found );
    178199                }
    179200
     201                /**
     202                 * @covers WP_Network_Query::query
     203                 */
    180204                public function test_wp_network_query_by_domain() {
    181205                        $q     = new WP_Network_Query();
    182206                        $found = $q->query(
     
    193217                        $this->assertSameSets( $expected, $found );
    194218                }
    195219
     220                /**
     221                 * @covers WP_Network_Query::query
     222                 */
    196223                public function test_wp_network_query_by_domain__in_with_single_domain() {
    197224                        $q     = new WP_Network_Query();
    198225                        $found = $q->query(
     
    209236                        $this->assertSameSets( $expected, $found );
    210237                }
    211238
     239                /**
     240                 * @covers WP_Network_Query::query
     241                 */
    212242                public function test_wp_network_query_by_domain__in_with_multiple_domains() {
    213243                        $q     = new WP_Network_Query();
    214244                        $found = $q->query(
     
    226256                        $this->assertSameSets( $expected, $found );
    227257                }
    228258
     259                /**
     260                 * @covers WP_Network_Query::query
     261                 */
    229262                public function test_wp_network_query_by_domain__in_with_multiple_domains_and_number() {
    230263                        $q     = new WP_Network_Query();
    231264                        $found = $q->query(
     
    243276                        $this->assertSameSets( $expected, $found );
    244277                }
    245278
     279                /**
     280                 * @covers WP_Network_Query::query
     281                 */
    246282                public function test_wp_network_query_by_domain__in_with_multiple_domains_and_number_and_offset() {
    247283                        $q     = new WP_Network_Query();
    248284                        $found = $q->query(
     
    261297                        $this->assertSameSets( $expected, $found );
    262298                }
    263299
     300                /**
     301                 * @covers WP_Network_Query::query
     302                 */
    264303                public function test_wp_network_query_by_domain__not_in_with_single_domain() {
    265304                        $q     = new WP_Network_Query();
    266305                        $found = $q->query(
     
    280319                        $this->assertSameSets( $expected, $found );
    281320                }
    282321
     322                /**
     323                 * @covers WP_Network_Query::query
     324                 */
    283325                public function test_wp_network_query_by_domain__not_in_with_multiple_domains() {
    284326                        $q     = new WP_Network_Query();
    285327                        $found = $q->query(
     
    298340                        $this->assertSameSets( $expected, $found );
    299341                }
    300342
     343                /**
     344                 * @covers WP_Network_Query::query
     345                 */
    301346                public function test_wp_network_query_by_domain__not_in_with_multiple_domains_and_number() {
    302347                        $q     = new WP_Network_Query();
    303348                        $found = $q->query(
     
    316361                        $this->assertSameSets( $expected, $found );
    317362                }
    318363
     364                /**
     365                 * @covers WP_Network_Query::query
     366                 */
    319367                public function test_wp_network_query_by_domain__not_in_with_multiple_domains_and_number_and_offset() {
    320368                        $q     = new WP_Network_Query();
    321369                        $found = $q->query(
     
    335383                        $this->assertSameSets( $expected, $found );
    336384                }
    337385
     386                /**
     387                 * @covers WP_Network_Query::query
     388                 */
    338389                public function test_wp_network_query_by_path_with_expected_results() {
    339390                        $q     = new WP_Network_Query();
    340391                        $found = $q->query(
     
    354405                        $this->assertSameSets( $expected, $found );
    355406                }
    356407
     408                /**
     409                 * @covers WP_Network_Query::query
     410                 */
    357411                public function test_wp_network_query_by_path_and_number_and_offset_with_expected_results() {
    358412                        $q     = new WP_Network_Query();
    359413                        $found = $q->query(
     
    373427                        $this->assertSameSets( $expected, $found );
    374428                }
    375429
     430                /**
     431                 * @covers WP_Network_Query::query
     432                 */
    376433                public function test_wp_network_query_by_path_with_no_expected_results() {
    377434                        $q     = new WP_Network_Query();
    378435                        $found = $q->query(
     
    385442                        $this->assertEmpty( $found );
    386443                }
    387444
     445                /**
     446                 * @covers WP_Network_Query::query
     447                 */
    388448                public function test_wp_network_query_by_search_with_text_in_domain() {
    389449                        $q     = new WP_Network_Query();
    390450                        $found = $q->query(
     
    401461                        $this->assertSameSets( $expected, $found );
    402462                }
    403463
     464                /**
     465                 * @covers WP_Network_Query::query
     466                 */
    404467                public function test_wp_network_query_by_search_with_text_in_path() {
    405468                        $q     = new WP_Network_Query();
    406469                        $found = $q->query(
     
    417480                        $this->assertSameSets( $expected, $found );
    418481                }
    419482
     483                /**
     484                 * @covers WP_Network_Query::query
     485                 */
    420486                public function test_wp_network_query_by_path_order_by_domain_desc() {
    421487                        $q     = new WP_Network_Query();
    422488                        $found = $q->query(
     
    440506
    441507                /**
    442508                 * @ticket 41347
     509                 *
     510                 * @covers WP_Network_Query::query
    443511                 */
    444512                public function test_wp_network_query_cache_with_different_fields_no_count() {
    445513                        global $wpdb;
     
    467535
    468536                /**
    469537                 * @ticket 41347
     538                 *
     539                 * @covers WP_Network_Query::query
    470540                 */
    471541                public function test_wp_network_query_cache_with_different_fields_active_count() {
    472542                        global $wpdb;
     
    496566
    497567                /**
    498568                 * @ticket 41347
     569                 *
     570                 * @covers WP_Network_Query::query
    499571                 */
    500572                public function test_wp_network_query_cache_with_same_fields_different_count() {
    501573                        global $wpdb;
     
    526598                /**
    527599                 * @ticket 45749
    528600                 * @ticket 47599
     601                 *
     602                 * @covers WP_Network_Query::query
    529603                 */
    530604                public function test_networks_pre_query_filter_should_bypass_database_query() {
    531605                        global $wpdb;
     
    557631
    558632                /**
    559633                 * @ticket 51333
     634                 *
     635                 * @covers WP_Network_Query::query
    560636                 */
    561637                public function test_networks_pre_query_filter_should_set_networks_property() {
    562638                        add_filter( 'networks_pre_query', array( __CLASS__, 'filter_networks_pre_query_and_set_networks' ), 10, 2 );
  • tests/phpunit/tests/multisite/site.php

     
    8888                        }
    8989                }
    9090
     91                /**
     92                 * @covers ::restore_current_blog
     93                 */
    9194                function test_switch_restore_blog() {
    9295                        global $_wp_switched_stack, $wpdb;
    9396
     
    135138
    136139                /**
    137140                 * Test the cache keys and database tables setup through the creation of a site.
     141                 *
     142                 * @covers ::get_blog_details
    138143                 */
    139144                function test_created_site_details() {
    140145                        global $wpdb;
     
    192197                        $this->assertSame( 2, (int) get_blog_count() );
    193198                }
    194199
     200                /**
     201                 * @covers ::wp_suspend_cache_invalidation
     202                 */
    195203                public function test_site_caches_should_invalidate_when_invalidation_is_not_suspended() {
    196204                        $site_id = self::factory()->blog->create();
    197205
     
    205213                        $this->assertNotEquals( $details->path, $new_details->path );
    206214                }
    207215
     216                /**
     217                 * @covers ::wp_suspend_cache_invalidation
     218                 */
    208219                public function test_site_caches_should_not_invalidate_when_invalidation_is_suspended() {
    209220                        $site_id = self::factory()->blog->create();
    210221
     
    220231
    221232                /**
    222233                 * When a site is flagged as 'deleted', its data should be cleared from cache.
     234                 *
     235                 * @covers ::wpmu_delete_blog
    223236                 */
    224237                function test_data_in_cache_after_wpmu_delete_blog_drop_false() {
    225238                        $blog_id = self::factory()->blog->create();
     
    238251
    239252                /**
    240253                 * When a site is flagged as 'deleted', its data should remain in the database.
     254                 *
     255                 * @covers ::wpmu_delete_blog
    241256                 */
    242257                function test_data_in_tables_after_wpmu_delete_blog_drop_false() {
    243258                        global $wpdb;
     
    261276
    262277                /**
    263278                 * When a site is fully deleted, its data should be cleared from cache.
     279                 *
     280                 * @covers ::wpmu_delete_blog
    264281                 */
    265282                function test_data_in_cache_after_wpmu_delete_blog_drop_true() {
    266283                        $blog_id = self::factory()->blog->create();
     
    279296
    280297                /**
    281298                 * When a site is fully deleted, its data should be removed from the database.
     299                 *
     300                 * @covers ::wpmu_delete_blog
    282301                 */
    283302                function test_data_in_tables_after_wpmu_delete_blog_drop_true() {
    284303                        global $wpdb;
     
    302321
    303322                /**
    304323                 * When the main site of a network is fully deleted, its data should be cleared from cache.
     324                 *
     325                 * @covers ::wpmu_delete_blog
    305326                 */
    306327                function test_data_in_cache_after_wpmu_delete_blog_main_site_drop_true() {
    307328                        $blog_id = 1; // The main site in our test suite has an ID of 1.
     
    320341
    321342                /**
    322343                 * When the main site of a network is fully deleted, its data should remain in the database.
     344                 *
     345                 * @covers ::wpmu_delete_blog
    323346                 */
    324347                function test_data_in_tables_after_wpmu_delete_blog_main_site_drop_true() {
    325348                        global $wpdb;
     
    343366
    344367                /**
    345368                 * The site count of a network should change when a site is flagged as 'deleted'.
     369                 *
     370                 * @covers ::wpmu_delete_blog
    346371                 */
    347372                function test_network_count_after_wpmu_delete_blog_drop_false() {
    348373                        $blog_id = self::factory()->blog->create();
     
    357382
    358383                /**
    359384                 * The site count of a network should change when a site is fully deleted.
     385                 *
     386                 * @covers ::wpmu_delete_blog
    360387                 */
    361388                function test_blog_count_after_wpmu_delete_blog_drop_true() {
    362389                        $blog_id = self::factory()->blog->create();
     
    373400                 * When a site is deleted with wpmu_delete_blog(), only the files associated with
    374401                 * that site should be removed. When wpmu_delete_blog() is run a second time, nothing
    375402                 * should change with upload directories.
     403                 *
     404                 * @covers ::wpmu_delete_blog
    376405                 */
    377406                function test_upload_directories_after_multiple_wpmu_delete_blog() {
    378407                        $filename = __FUNCTION__ . '.jpg';
     
    400429                        $this->assertFileNotExists( $file2['file'] );
    401430                }
    402431
     432                /**
     433                 *  @covers ::wpmu_update_blogs_date
     434                 */
    403435                function test_wpmu_update_blogs_date() {
    404436                        global $wpdb;
    405437
     
    424456                 * Test cached data for a site that does not exist and then again after it exists.
    425457                 *
    426458                 * @ticket 23405
     459                 *
     460                 * @covers ::get_blog_details
    427461                 */
    428462                function test_get_blog_details_when_site_does_not_exist() {
    429463                        // Create an unused site so that we can then assume an invalid site ID.
     
    450484
    451485                /**
    452486                 * Updating a field returns the sme value that was passed.
     487                 *
     488                 * @covers ::update_blog_status
    453489                 */
    454490                function test_update_blog_status() {
    455491                        $result = update_blog_status( 1, 'spam', 0 );
     
    458494
    459495                /**
    460496                 * Updating an invalid field returns the same value that was passed.
     497                 *
     498                 * @covers ::update_blog_status
    461499                 */
    462500                function test_update_blog_status_invalid_status() {
    463501                        $result = update_blog_status( 1, 'doesnotexist', 'invalid' );
     
    464502                        $this->assertSame( 'invalid', $result );
    465503                }
    466504
     505                /**
     506                 * @covers ::update_blog_status
     507                 */
    467508                function test_update_blog_status_make_ham_blog_action() {
    468509                        global $test_action_counter;
    469510                        $test_action_counter = 0;
     
    488529                        remove_action( 'make_ham_blog', array( $this, '_action_counter_cb' ), 10 );
    489530                }
    490531
     532                /**
     533                 * @covers ::update_blog_status
     534                 */
    491535                function test_content_from_spam_blog_is_not_available() {
    492536                        $spam_blog_id = self::factory()->blog->create();
    493537                        switch_to_blog( $spam_blog_id );
     
    518562                        $this->assertNotContains( "src=\"{$spam_embed_url}#?", $content );
    519563                }
    520564
     565                /**
     566                 * @covers ::update_blog_status
     567                 */
    521568                function test_update_blog_status_make_spam_blog_action() {
    522569                        global $test_action_counter;
    523570                        $test_action_counter = 0;
     
    541588                        remove_action( 'make_spam_blog', array( $this, '_action_counter_cb' ), 10 );
    542589                }
    543590
     591                /**
     592                 * @covers ::update_blog_status
     593                 */
    544594                function test_update_blog_status_archive_blog_action() {
    545595                        global $test_action_counter;
    546596                        $test_action_counter = 0;
     
    564614                        remove_action( 'archive_blog', array( $this, '_action_counter_cb' ), 10 );
    565615                }
    566616
     617                /**
     618                 * @covers ::update_blog_status
     619                 */
    567620                function test_update_blog_status_unarchive_blog_action() {
    568621                        global $test_action_counter;
    569622                        $test_action_counter = 0;
     
    587640                        remove_action( 'unarchive_blog', array( $this, '_action_counter_cb' ), 10 );
    588641                }
    589642
     643                /**
     644                 * @covers ::update_blog_status
     645                 */
    590646                function test_update_blog_status_make_delete_blog_action() {
    591647                        global $test_action_counter;
    592648                        $test_action_counter = 0;
     
    610666                        remove_action( 'make_delete_blog', array( $this, '_action_counter_cb' ), 10 );
    611667                }
    612668
     669                /**
     670                 * @covers ::update_blog_status
     671                 */
    613672                function test_update_blog_status_make_undelete_blog_action() {
    614673                        global $test_action_counter;
    615674                        $test_action_counter = 0;
     
    634693                        remove_action( 'make_undelete_blog', array( $this, '_action_counter_cb' ), 10 );
    635694                }
    636695
     696                /**
     697                 * @covers ::update_blog_status
     698                 */
    637699                function test_update_blog_status_mature_blog_action() {
    638700                        global $test_action_counter;
    639701                        $test_action_counter = 0;
     
    657719                        remove_action( 'mature_blog', array( $this, '_action_counter_cb' ), 10 );
    658720                }
    659721
     722                /**
     723                 * @covers ::update_blog_status
     724                 */
    660725                function test_update_blog_status_unmature_blog_action() {
    661726                        global $test_action_counter;
    662727                        $test_action_counter = 0;
     
    681746                        remove_action( 'unmature_blog', array( $this, '_action_counter_cb' ), 10 );
    682747                }
    683748
     749                /**
     750                 * @covers ::update_blog_status
     751                 */
    684752                function test_update_blog_status_update_blog_public_action() {
    685753                        global $test_action_counter;
    686754                        $test_action_counter = 0;
     
    706774
    707775                /**
    708776                 * @ticket 27952
     777                 *
     778                 * @covers WP_Site::post_count
    709779                 */
    710780                function test_posts_count() {
    711781                        self::factory()->post->create();
     
    718788
    719789                /**
    720790                 * @ticket 26410
     791                 *
     792                 * @covers ::update_option
    721793                 */
    722794                function test_blog_details_cache_invalidation() {
    723795                        update_option( 'blogname', 'foo' );
     
    732804                /**
    733805                 * Test the original and cached responses for a created and then deleted site when
    734806                 * the blog ID is requested through get_blog_id_from_url().
     807                 *
     808                 * @covers ::get_blog_id_from_url
    735809                 */
    736810                function test_get_blog_id_from_url() {
    737811                        $blog_id = self::factory()->blog->create();
     
    745819
    746820                /**
    747821                 * Test the case insensitivity of the site lookup.
     822                 *
     823                 * @covers ::get_blog_id_from_url
    748824                 */
    749825                function test_get_blog_id_from_url_is_case_insensitive() {
    750826                        $blog_id = self::factory()->blog->create(
     
    760836
    761837                /**
    762838                 * Test the first and cached responses for a site that does not exist.
     839                 *
     840                 * @covers ::get_blog_id_from_url
    763841                 */
    764842                function test_get_blog_id_from_url_that_does_not_exist() {
    765843                        $blog_id = self::factory()->blog->create( array( 'path' => '/xyz' ) );
     
    772850                /**
    773851                 * A blog ID is still available if only the `deleted` flag is set for a site. The same
    774852                 * behavior would be expected if passing `false` explicitly to `wpmu_delete_blog()`.
     853                 *
     854                 * @covers ::wpmu_delete_blog
    775855                 */
    776856                function test_get_blog_id_from_url_with_deleted_flag() {
    777857                        $blog_id = self::factory()->blog->create();
     
    786866                /**
    787867                 * When deleted with the drop parameter as true, the cache will first be false, then set to
    788868                 * -1 after an attempt at `get_blog_id_from_url()` is made.
     869                 *
     870                 * @covers ::wpmu_delete_blog
    789871                 */
    790872                function test_get_blog_id_from_url_after_dropped() {
    791873                        $blog_id = self::factory()->blog->create();
     
    800882
    801883                /**
    802884                 * Test with default parameter of site_id as null.
     885                 *
     886                 * @covers ::is_main_site
    803887                 */
    804888                function test_is_main_site() {
    805889                        $this->assertTrue( is_main_site() );
     
    808892                /**
    809893                 * Test with a site id of get_current_blog_id(), which should be the same as the
    810894                 * default parameter tested above.
     895                 *
     896                 * @covers ::is_main_site
    811897                 */
    812898                function test_current_blog_id_is_main_site() {
    813899                        $this->assertTrue( is_main_site( get_current_blog_id() ) );
     
    815901
    816902                /**
    817903                 * Test with a site ID other than the main site to ensure a false response.
     904                 *
     905                 * @covers ::is_main_site
    818906                 */
    819907                function test_is_main_site_is_false_with_other_blog_id() {
    820908                        $blog_id = self::factory()->blog->create();
     
    824912
    825913                /**
    826914                 * Test with no passed ID after switching to another site ID.
     915                 *
     916                 * @covers ::is_main_site
    827917                 */
    828918                function test_is_main_site_is_false_after_switch_to_blog() {
    829919                        $blog_id = self::factory()->blog->create();
     
    834924                        restore_current_blog();
    835925                }
    836926
     927                /**
     928                 * @covers ::switch_to_blog
     929                 * @covers ::wp_upload_dir
     930                 */
    837931                function test_switch_upload_dir() {
    838932                        $this->assertTrue( is_main_site() );
    839933
     
    865959                /**
    866960                 * Test the primary purpose of get_blog_post(), to retrieve a post from
    867961                 * another site on the network.
     962                 *
     963                 * @covers ::get_blog_post
    868964                 */
    869965                function test_get_blog_post_from_another_site_on_network() {
    870966                        $blog_id = self::factory()->blog->create();
     
    880976
    881977                /**
    882978                 * If get_blog_post() is used on the same site, it should still work.
     979                 *
     980                 * @covers ::get_blog_post
    883981                 */
    884982                function test_get_blog_post_from_same_site() {
    885983                        $post_id = self::factory()->post->create();
     
    889987
    890988                /**
    891989                 * A null response should be returned if an invalid post is requested.
     990                 *
     991                 * @covers ::get_blog_post
    892992                 */
    893993                function test_get_blog_post_invalid_returns_null() {
    894994                        $this->assertNull( get_blog_post( 1, 999999 ) );
     
    9061006                        }
    9071007                }
    9081008
     1009                /**
     1010                 * @covers ::domain_exists
     1011                 */
    9091012                function test_domain_exists_with_default_site_id() {
    9101013                        $details = get_site( 1 );
    9111014
     
    9121015                        $this->assertSame( 1, domain_exists( $details->domain, $details->path ) );
    9131016                }
    9141017
     1018                /**
     1019                 * @covers ::domain_exists
     1020                 */
    9151021                function test_domain_exists_with_specified_site_id() {
    9161022                        $details = get_site( 1 );
    9171023
     
    9211027                /**
    9221028                 * When the domain is valid, but the resulting site does not belong to the specified network,
    9231029                 * it is marked as not existing.
     1030                 *
     1031                 * @covers ::domain_exists
    9241032                 */
    9251033                function test_domain_does_not_exist_with_invalid_site_id() {
    9261034                        $details = get_site( 1 );
     
    9281036                        $this->assertNull( domain_exists( $details->domain, $details->path, 999 ) );
    9291037                }
    9301038
     1039                /**
     1040                 * @covers ::domain_exists
     1041                 */
    9311042                function test_invalid_domain_does_not_exist_with_default_site_id() {
    9321043                        $this->assertNull( domain_exists( 'foo', 'bar' ) );
    9331044                }
    9341045
     1046                /**
     1047                 * @covers ::domain_exists
     1048                 */
    9351049                function test_domain_filtered_to_exist() {
    9361050                        add_filter( 'domain_exists', array( $this, '_domain_exists_cb' ), 10, 4 );
    9371051                        $exists = domain_exists( 'foo', 'bar' );
     
    9421056                /**
    9431057                 * When a path is passed to domain_exists, it is immediately trailing slashed. A path
    9441058                 * value with or without the slash should result in the same return value.
     1059                 *
     1060                 * @covers ::domain_exists
    9451061                 */
    9461062                function test_slashed_path_in_domain_exists() {
    9471063                        add_filter( 'domain_exists', array( $this, '_domain_exists_cb' ), 10, 4 );
     
    9551071
    9561072                /**
    9571073                 * Tests returning an address for a given valid ID.
     1074                 *
     1075                 * @covers ::get_blogaddress_by_id
    9581076                 */
    9591077                function test_get_blogaddress_by_id_with_valid_id() {
    9601078                        $blogaddress = get_blogaddress_by_id( 1 );
     
    9631081
    9641082                /**
    9651083                 * Tests returning the appropriate response for a invalid id given.
     1084                 *
     1085                 * @covers ::get_blogaddress_by_id
    9661086                 */
    9671087                function test_get_blogaddress_by_id_with_invalid_id() {
    9681088                        $blogaddress = get_blogaddress_by_id( 42 );
     
    9711091
    9721092                /**
    9731093                 * @ticket 14867
     1094                 *
     1095                 * @covers ::get_blogaddress_by_id
    9741096                 */
    9751097                function test_get_blogaddress_by_id_scheme_reflects_blog_scheme() {
    9761098                        $blog = self::factory()->blog->create();
     
    9841106
    9851107                /**
    9861108                 * @ticket 14867
     1109                 *
     1110                 * @covers ::get_blogaddress_by_id
    9871111                 */
    9881112                function test_get_blogaddress_by_id_scheme_is_unaffected_by_request() {
    9891113                        $blog = self::factory()->blog->create();
     
    10031127                /**
    10041128                 * @ticket 33620
    10051129                 * @dataProvider data_new_blog_url_schemes
     1130                 *
     1131                 * @covers ::set_url_scheme
    10061132                 */
    10071133                function test_new_blog_url_schemes( $home_scheme, $siteurl_scheme, $force_ssl_admin ) {
    10081134                        $current_site = get_current_site();
     
    10621188
    10631189                /**
    10641190                 * @ticket 36918
     1191                 *
     1192                 * @covers ::wpmu_create_blog
    10651193                 */
    10661194                function test_new_blog_locale() {
    10671195                        $current_site = get_current_site();
     
    10971225
    10981226                /**
    10991227                 * @ticket 40503
     1228                 *
     1229                 * @covers ::wpmu_create_blog
    11001230                 */
    11011231                function test_different_network_language() {
    11021232                        $network = get_network( self::$network_ids['make.wordpress.org/'] );
     
    11251255
    11261256                /**
    11271257                 * @ticket 29684
     1258                 *
     1259                 * @covers ::is_main_site
    11281260                 */
    11291261                public function test_is_main_site_different_network() {
    11301262                        $this->assertTrue( is_main_site( self::$site_ids['make.wordpress.org/'], self::$network_ids['make.wordpress.org/'] ) );
     
    11321264
    11331265                /**
    11341266                 * @ticket 29684
     1267                 *
     1268                 * @covers ::is_main_site
    11351269                 */
    11361270                public function test_is_main_site_different_network_random_site() {
    11371271                        $this->assertFalse( is_main_site( self::$site_ids['make.wordpress.org/foo/'], self::$network_ids['make.wordpress.org/'] ) );
     
    11401274                /**
    11411275                 * @ticket 40201
    11421276                 * @dataProvider data_get_site_caches
     1277                 *
     1278                 * @covers ::clean_blog_cache
    11431279                 */
    11441280                public function test_clean_blog_cache( $key, $group ) {
    11451281                        $site = get_site( self::$site_ids['make.wordpress.org/'] );
     
    11661302                /**
    11671303                 * @ticket 40201
    11681304                 * @dataProvider data_get_site_caches
     1305                 *
     1306                 * @covers ::clean_blog_cache
    11691307                 */
    11701308                public function test_clean_blog_cache_with_id( $key, $group ) {
    11711309                        $site = get_site( self::$site_ids['make.wordpress.org/'] );
     
    11911329
    11921330                /**
    11931331                 * @ticket 40201
     1332                 *
     1333                 * @covers ::clean_blog_cache
    11941334                 */
    11951335                public function test_clean_blog_cache_resets_last_changed() {
    11961336                        $site = get_site( self::$site_ids['make.wordpress.org/'] );
     
    12031343
    12041344                /**
    12051345                 * @ticket 40201
     1346                 *
     1347                 * @covers ::clean_blog_cache
    12061348                 */
    12071349                public function test_clean_blog_cache_fires_action() {
    12081350                        $site = get_site( self::$site_ids['make.wordpress.org/'] );
     
    12151357
    12161358                /**
    12171359                 * @ticket 40201
     1360                 *
     1361                 * @covers ::clean_blog_cache
    12181362                 */
    12191363                public function test_clean_blog_cache_bails_on_suspend_cache_invalidation() {
    12201364                        $site = get_site( self::$site_ids['make.wordpress.org/'] );
     
    12291373
    12301374                /**
    12311375                 * @ticket 40201
     1376                 *
     1377                 * @covers ::clean_blog_cache
    12321378                 */
    12331379                public function test_clean_blog_cache_bails_on_empty_input() {
    12341380                        $old_count = did_action( 'clean_site_cache' );
     
    12391385
    12401386                /**
    12411387                 * @ticket 40201
     1388                 *
     1389                 * @covers ::clean_blog_cache
    12421390                 */
    12431391                public function test_clean_blog_cache_bails_on_non_numeric_input() {
    12441392                        $old_count = did_action( 'clean_site_cache' );
     
    12491397
    12501398                /**
    12511399                 * @ticket 40201
     1400                 *
     1401                 * @covers ::clean_blog_cache
    12521402                 */
    12531403                public function test_clean_blog_cache_works_with_deleted_site() {
    12541404                        $site_id = 12345;
     
    12621412                /**
    12631413                 * @ticket 40201
    12641414                 * @dataProvider data_get_site_caches
     1415                 *
     1416                 * @covers ::refresh_blog_details
    12651417                 */
    12661418                public function test_refresh_blog_details( $key, $group ) {
    12671419                        $site = get_site( self::$site_ids['make.wordpress.org/'] );
     
    12871439
    12881440                /**
    12891441                 * @ticket 40201
     1442                 *
     1443                 * @covers ::refresh_blog_details
    12901444                 */
    12911445                public function test_refresh_blog_details_works_with_deleted_site() {
    12921446                        $site_id = 12345;
     
    12991453
    13001454                /**
    13011455                 * @ticket 40201
     1456                 *
     1457                 * @covers ::refresh_blog_details
    13021458                 */
    13031459                public function test_refresh_blog_details_uses_current_site_as_default() {
    13041460                        $site_id = get_current_blog_id();
     
    13231479                /**
    13241480                 * @ticket 40364
    13251481                 * @dataProvider data_wp_insert_site
     1482                 *
     1483                 * @covers ::wp_insert_site
    13261484                 */
    13271485                public function test_wp_insert_site( $site_data, $expected_data ) {
    13281486                        remove_action( 'wp_initialize_site', 'wp_initialize_site', 10 );
     
    14181576
    14191577                /**
    14201578                 * @ticket 50324
     1579                 *
     1580                 * @covers ::wp_insert_site
    14211581                 */
    14221582                public function test_wp_insert_site_with_clean_site_cache() {
    14231583                        remove_action( 'wp_initialize_site', 'wp_initialize_site', 10 );
     
    14441604
    14451605                /**
    14461606                 * @ticket 40364
     1607                 *
     1608                 * @covers ::wp_insert_site
    14471609                 */
    14481610                public function test_wp_insert_site_empty_domain() {
    14491611                        remove_action( 'wp_initialize_site', 'wp_initialize_site', 10 );
     
    15211683
    15221684                /**
    15231685                 * @ticket 40364
     1686                 *
     1687                 * @covers ::wp_update_site
    15241688                 */
    15251689                public function test_wp_update_site_empty_domain() {
    15261690                        $site_id = self::factory()->blog->create();
     
    15331697
    15341698                /**
    15351699                 * @ticket 40364
     1700                 *
     1701                 * @covers ::wp_update_site
    15361702                 */
    15371703                public function test_wp_update_site_invalid_id() {
    15381704                        $result = wp_update_site( 444444, array( 'domain' => 'example.com' ) );
     
    15431709
    15441710                /**
    15451711                 * @ticket 40364
     1712                 *
     1713                 * @covers ::wp_update_site
    15461714                 */
    15471715                public function test_wp_update_site_cleans_cache() {
    15481716                        $site_id = self::factory()->blog->create();
     
    15611729
    15621730                /**
    15631731                 * @ticket 40364
     1732                 *
     1733                 * @covers ::wp_delete_site
    15641734                 */
    15651735                public function test_wp_delete_site() {
    15661736                        $site_id = self::factory()->blog->create();
     
    15751745
    15761746                /**
    15771747                 * @ticket 40364
     1748                 *
     1749                 * @covers ::wp_delete_site
    15781750                 */
    15791751                public function test_wp_delete_site_invalid_id() {
    15801752                        $result = wp_delete_site( 444444 );
     
    15851757
    15861758                /**
    15871759                 * @ticket 41333
     1760                 *
     1761                 * @covers ::wp_delete_site
    15881762                 */
    15891763                public function test_wp_delete_site_validate_site_deletion_action() {
    15901764                        add_action( 'wp_validate_site_deletion', array( $this, 'action_wp_validate_site_deletion_prevent_deletion' ) );
     
    16001774                /**
    16011775                 * @ticket 40364
    16021776                 * @dataProvider data_wp_normalize_site_data
     1777                 *
     1778                 * @covers ::wp_normalize_site_data
    16031779                 */
    16041780                public function test_wp_normalize_site_data( $data, $expected ) {
    16051781                        $result = wp_normalize_site_data( $data );
     
    16791855                /**
    16801856                 * @ticket 40364
    16811857                 * @dataProvider data_wp_validate_site_data
     1858                 *
     1859                 * @covers ::wp_validate_site_data
    16821860                 */
    16831861                public function test_wp_validate_site_data( $data, $expected_errors ) {
    16841862                        $result = new WP_Error();
     
    18071985
    18081986                /**
    18091987                 * @ticket 40364
     1988                 *
     1989                 * @covers ::get_site
    18101990                 */
    18111991                public function test_site_dates_are_gmt() {
    18121992                        $first_date = current_time( 'mysql', true );
     
    18362016
    18372017                /**
    18382018                 * @ticket 40364
     2019                 *
     2020                 * @covers ::wp_delete_site
    18392021                 */
    18402022                public function test_wp_delete_site_cleans_cache() {
    18412023                        $site_id = self::factory()->blog->create();
     
    18492031
    18502032                /**
    18512033                 * @ticket 40364
     2034                 *
     2035                 * @covers ::wp_update_site
    18522036                 */
    18532037                public function test_wp_update_site_cleans_old_cache_on_domain_change() {
    18542038                        $old_domain = 'old.wordpress.org';
     
    19042088
    19052089                /**
    19062090                 * @ticket 40364
     2091                 *
     2092                 * @covers ::wp_update_site
    19072093                 */
    19082094                public function test_wp_update_site_cleans_old_cache_on_path_change() {
    19092095                        $old_path = '/foo/';
     
    19582144                /**
    19592145                 * @ticket 40364
    19602146                 * @dataProvider data_site_status_hook_triggers
     2147                 *
     2148                 * @covers ::wp_insert_site
     2149                 * @covers ::wp_update_site
    19612150                 */
    19622151                public function test_site_status_hook_triggers( $insert_site_data, $expected_insert_hooks, $update_site_data, $expected_update_hooks ) {
    19632152                        // First: Insert a site.
     
    21222311                /**
    21232312                 * @ticket 41333
    21242313                 * @dataProvider data_wp_initialize_site
     2314                 *
     2315                 * @covers ::wp_initialize_site
    21252316                 */
    21262317                public function test_wp_initialize_site( $args, $expected_options, $expected_meta ) {
    21272318                        $result = wp_initialize_site( self::$uninitialized_site_id, $args );
     
    22032394
    22042395                /**
    22052396                 * @ticket 41333
     2397                 *
     2398                 * @covers ::wp_initialize_site
    22062399                 */
    22072400                public function test_wp_initialize_site_user_roles() {
    22082401                        global $wpdb;
     
    22312424
    22322425                /**
    22332426                 * @ticket 41333
     2427                 *
     2428                 * @covers ::wp_initialize_site
    22342429                 */
    22352430                public function test_wp_initialize_site_user_is_admin() {
    22362431                        $result = wp_initialize_site( self::$uninitialized_site_id, array( 'user_id' => 1 ) );
     
    22492444
    22502445                /**
    22512446                 * @ticket 41333
     2447                 *
     2448                 * @covers ::wp_initialize_site
    22522449                 */
    22532450                public function test_wp_initialize_site_args_filter() {
    22542451                        add_filter( 'wp_initialize_site_args', array( $this, 'filter_wp_initialize_site_args' ), 10, 3 );
     
    22742471
    22752472                /**
    22762473                 * @ticket 41333
     2474                 *
     2475                 * @covers ::wp_initialize_site
    22772476                 */
    22782477                public function test_wp_initialize_site_empty_id() {
    22792478                        $result = wp_initialize_site( 0 );
     
    22832482
    22842483                /**
    22852484                 * @ticket 41333
     2485                 *
     2486                 * @covers ::wp_initialize_site
    22862487                 */
    22872488                public function test_wp_initialize_site_invalid_id() {
    22882489                        $result = wp_initialize_site( 123 );
     
    22922493
    22932494                /**
    22942495                 * @ticket 41333
     2496                 *
     2497                 * @covers ::wp_initialize_site
    22952498                 */
    22962499                public function test_wp_initialize_site_already_initialized() {
    22972500                        $result = wp_initialize_site( get_current_blog_id() );
     
    23012504
    23022505                /**
    23032506                 * @ticket 41333
     2507                 *
     2508                 * @covers ::wp_uninitialize_site
    23042509                 */
    23052510                public function test_wp_uninitialize_site() {
    23062511                        $site_id = self::factory()->blog->create();
     
    23122517
    23132518                /**
    23142519                 * @ticket 41333
     2520                 *
     2521                 * @covers ::wp_uninitialize_site
    23152522                 */
    23162523                public function test_wp_uninitialize_site_empty_id() {
    23172524                        $result = wp_uninitialize_site( 0 );
     
    23212528
    23222529                /**
    23232530                 * @ticket 41333
     2531                 *
     2532                 * @covers ::wp_uninitialize_site
    23242533                 */
    23252534                public function test_wp_uninitialize_site_invalid_id() {
    23262535                        $result = wp_uninitialize_site( 123 );
     
    23302539
    23312540                /**
    23322541                 * @ticket 41333
     2542                 *
     2543                 * @covers ::wp_uninitialize_site
    23332544                 */
    23342545                public function test_wp_uninitialize_site_already_uninitialized() {
    23352546                        $result = wp_uninitialize_site( self::$uninitialized_site_id );
     
    23392550
    23402551                /**
    23412552                 * @ticket 41333
     2553                 *
     2554                 * @covers ::wp_is_site_initialized
    23422555                 */
    23432556                public function test_wp_is_site_initialized() {
    23442557                        $this->assertTrue( wp_is_site_initialized( get_current_blog_id() ) );
     
    23472560
    23482561                /**
    23492562                 * @ticket 41333
     2563                 *
     2564                 * @covers ::wp_is_site_initialized
    23502565                 */
    23512566                public function test_wp_is_site_initialized_prefilter() {
    23522567                        add_filter( 'pre_wp_is_site_initialized', '__return_false' );
     
    23582573
    23592574                /**
    23602575                 * @ticket 41333
     2576                 *
     2577                 * @covers ::wp_insert_site
    23612578                 */
    23622579                public function test_wp_insert_site_forwards_args_to_wp_initialize_site() {
    23632580                        $args = array(
     
    23922609
    23932610                /**
    23942611                 * @ticket 46125
     2612                 *
     2613                 * @covers ::wpmu_create_blog
    23952614                 */
    23962615                public function test_wpmu_create_blog_cache_cleanup_backward_compatible() {
    23972616                        add_action( 'populate_options', array( $this, 'populate_options_callback' ) );
     
    24242643                 * @dataProvider data_wpmu_new_blog_action_backward_commpatible
    24252644                 *
    24262645                 * @ticket 46351
     2646                 *
     2647                 * @covers ::wpmu_create_blog
    24272648                 */
    24282649                public function test_wpmu_new_blog_action_backward_compatible( $meta, $expected_meta ) {
    24292650                        // We are testing deprecated hook. Register it to expected deprecated notices.
     
    24392660
    24402661                /**
    24412662                 * @ticket 42251
     2663                 *
     2664                 * @covers ::get_site
    24422665                 */
    24432666                public function test_get_site_not_found_cache() {
    24442667                        global $wpdb;
     
    24532676
    24542677                /**
    24552678                 * @ticket 42251
     2679                 *
     2680                 * @covers ::get_site
    24562681                 */
    24572682                public function test_get_site_not_found_cache_clear() {
    24582683                        $new_site_id = $this->_get_next_site_id();
  • tests/phpunit/tests/multisite/siteDetails.php

     
    1212                 * @dataProvider data_allowed_options
    1313                 *
    1414                 * @ticket 40063
     15                 *
     16                 * @covers ::update_option
    1517                 */
    1618                public function test_update_allowed_option_deletes_site_details_cache( $allowed_option, $temporary_value ) {
    1719                        $site = get_site();
     
    3133                 * @dataProvider data_allowed_options
    3234                 *
    3335                 * @ticket 40063
     36                 *
     37                 * @covers ::update_option
    3438                 */
    3539                public function test_update_allowed_option_deletes_blog_details_cache( $allowed_option, $temporary_value ) {
    3640                        $blog_details = get_blog_details();
     
    5054                 * @dataProvider data_allowed_options
    5155                 *
    5256                 * @ticket 40063
     57                 *
     58                 * @covers ::update_option
    5359                 */
    5460                public function test_update_allowed_option_does_not_delete_site_cache( $allowed_option, $temporary_value ) {
    5561                        $site = get_site();
     
    6975                 * @dataProvider data_allowed_options
    7076                 *
    7177                 * @ticket 40063
     78                 *
     79                 * @covers ::update_option
    7280                 */
    7381                public function test_update_allowed_option_does_not_delete_short_blog_details_cache( $allowed_option, $temporary_value ) {
    7482                        $blog_details = get_blog_details( null, false );
     
    8896                 * @dataProvider data_allowed_options
    8997                 *
    9098                 * @ticket 40063
     99                 *
     100                 * @covers ::update_option
    91101                 */
    92102                public function test_update_allowed_option_does_not_update_sites_last_changed( $allowed_option, $temporary_value ) {
    93103                        $last_changed = wp_cache_get_last_changed( 'sites' );
     
    114124
    115125                /**
    116126                 * @ticket 40063
     127                 *
     128                 * @covers ::update_option
    117129                 */
    118130                public function test_update_random_blog_option_does_not_delete_cache() {
    119131                        $site = get_site();
     
    128140
    129141                /**
    130142                 * @ticket 40247
     143                 *
     144                 * @covers WP_Site::post_count
    131145                 */
    132146                public function test_site_details_cached_including_false_values() {
    133147                        $id = self::factory()->blog->create();
     
    145159                        $this->assertNotFalse( $cached_details );
    146160                }
    147161
     162                /**
     163                 * @covers ::get_site
     164                 */
    148165                public function test_site_details_filter_with_blogname() {
    149166                        add_filter( 'site_details', array( $this, '_filter_site_details_blogname' ) );
    150167                        $site     = get_site();
     
    161178
    162179                /**
    163180                 * @ticket 40458
     181                 *
     182                 * @covers ::get_site
    164183                 */
    165184                public function test_site_details_filter_with_custom_value_isetter() {
    166185                        add_filter( 'site_details', array( $this, '_filter_site_details_custom_value' ) );
     
    173192
    174193                /**
    175194                 * @ticket 40458
     195                 *
     196                 * @covers ::get_site
    176197                 */
    177198                public function test_site_details_filter_with_custom_value_getter() {
    178199                        add_filter( 'site_details', array( $this, '_filter_site_details_custom_value' ) );
  • tests/phpunit/tests/multisite/siteMeta.php

     
    4747                        wp_update_network_site_counts();
    4848                }
    4949
     50                /**
     51                 * @covers ::is_site_meta_supported
     52                 */
    5053                public function test_is_site_meta_supported() {
    5154                        $this->assertTrue( is_site_meta_supported() );
    5255                }
    5356
     57                /**
     58                 * @covers ::is_site_meta_supported
     59                 */
    5460                public function test_is_site_meta_supported_filtered() {
    5561                        add_filter( 'pre_site_option_site_meta_supported', '__return_zero' );
    5662                        $this->assertFalse( is_site_meta_supported() );
    5763                }
    5864
     65                /**
     66                 * @covers ::add_site_meta
     67                 */
    5968                public function test_add() {
    6069                        if ( ! is_site_meta_supported() ) {
    6170                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    6574                        $this->assertSame( 'bar', get_site_meta( self::$site_id, 'foo', true ) );
    6675                }
    6776
     77                /**
     78                 * @covers ::add_site_meta
     79                 */
    6880                public function test_add_unique() {
    6981                        if ( ! is_site_meta_supported() ) {
    7082                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    7486                        $this->assertFalse( add_site_meta( self::$site_id, 'foo', 'bar', true ) );
    7587                }
    7688
     89                /**
     90                 * @covers ::delete_site_meta
     91                 */
    7792                public function test_delete() {
    7893                        if ( ! is_site_meta_supported() ) {
    7994                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    85100                        $this->assertEmpty( get_site_meta( self::$site_id, 'foo', true ) );
    86101                }
    87102
     103                /**
     104                 * @covers ::delete_site_meta
     105                 */
    88106                public function test_delete_with_invalid_meta_key_should_return_false() {
    89107                        if ( ! is_site_meta_supported() ) {
    90108                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    93111                        $this->assertFalse( delete_site_meta( self::$site_id, 'foo' ) );
    94112                }
    95113
     114                /**
     115                 * @covers ::delete_site_meta
     116                 */
    96117                public function test_delete_should_respect_meta_value() {
    97118                        if ( ! is_site_meta_supported() ) {
    98119                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    107128                        $this->assertSame( array( 'baz' ), $metas );
    108129                }
    109130
     131                /**
     132                 * @covers ::get_site_meta
     133                 */
    110134                public function test_get_with_no_key_should_fetch_all_keys() {
    111135                        if ( ! is_site_meta_supported() ) {
    112136                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    124148                        $this->assertSameSets( $expected, $found );
    125149                }
    126150
     151                /**
     152                 * @covers ::get_site_meta
     153                 */
    127154                public function test_get_with_key_should_fetch_all_for_key() {
    128155                        if ( ! is_site_meta_supported() ) {
    129156                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    139166                        $this->assertSameSets( $expected, $found );
    140167                }
    141168
     169                /**
     170                 * @covers ::get_site_meta
     171                 */
    142172                public function test_get_should_respect_single_true() {
    143173                        if ( ! is_site_meta_supported() ) {
    144174                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    151181                        $this->assertSame( 'bar', $found );
    152182                }
    153183
     184                /**
     185                 * @covers ::update_site_meta
     186                 */
    154187                public function test_update_should_pass_to_add_when_no_value_exists_for_key() {
    155188                        if ( ! is_site_meta_supported() ) {
    156189                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    164197                        $this->assertSame( 'bar', $meta );
    165198                }
    166199
     200                /**
     201                 * @covers ::update_site_meta
     202                 */
    167203                public function test_update_should_return_true_when_updating_existing_value_for_key() {
    168204                        if ( ! is_site_meta_supported() ) {
    169205                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    178214                        $this->assertSame( 'baz', $meta );
    179215                }
    180216
     217                /**
     218                 * @covers ::delete_site_meta_by_key
     219                 */
    181220                public function test_delete_by_key() {
    182221                        if ( ! is_site_meta_supported() ) {
    183222                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    195234                        $this->assertSame( '', get_site_meta( self::$site_id2, 'unique_delete_by_key', true ) );
    196235                }
    197236
     237                /**
     238                 * @covers ::wp_delete_site
     239                 */
    198240                public function test_site_meta_should_be_deleted_when_site_is_deleted() {
    199241                        if ( ! is_site_meta_supported() ) {
    200242                                $this->markTestSkipped( 'Test only runs with the blogmeta database table installed.' );
     
    219261                        $this->assertSame( '', get_site_meta( $site_id, 'foo1', true ) );
    220262                }
    221263
     264                /**
     265                 * @covers ::update_sitemeta_cache
     266                 */
    222267                public function test_update_site_meta_cache() {
    223268                        global $wpdb;
    224269
     
    234279                        $this->assertSame( $num_queries, $wpdb->num_queries );
    235280                }
    236281
     282                /**
     283                 * @covers ::update_site_meta
     284                 */
    237285                public function test_query_update_site_meta_cache_true() {
    238286                        global $wpdb;
    239287
     
    255303                        $this->assertSame( $num_queries, $wpdb->num_queries );
    256304                }
    257305
     306                /**
     307                 * @covers ::update_site_meta
     308                 */
    258309                public function test_query_update_site_meta_cache_false() {
    259310                        global $wpdb;
    260311
     
    278329
    279330                /**
    280331                 * @ticket 40229
     332                 *
     333                 * @covers ::add_site_meta
    281334                 */
    282335                public function test_add_site_meta_should_bust_get_sites_cache() {
    283336                        if ( ! is_site_meta_supported() ) {
     
    320373
    321374                /**
    322375                 * @ticket 40229
     376                 *
     377                 * @covers ::update_site_meta
    323378                 */
    324379                public function test_update_site_meta_should_bust_get_sites_cache() {
    325380                        if ( ! is_site_meta_supported() ) {
     
    363418
    364419                /**
    365420                 * @ticket 40229
     421                 *
     422                 * @covers ::delete_site_meta
    366423                 */
    367424                public function test_delete_site_meta_should_bust_get_sites_cache() {
    368425                        if ( ! is_site_meta_supported() ) {
  • tests/phpunit/tests/multisite/siteQuery.php

     
    114114                        wp_update_network_site_counts();
    115115                }
    116116
     117                /**
     118                 * @covers WP_Site_Query::query
     119                 */
    117120                public function test_wp_site_query_by_ID() {
    118121                        $q     = new WP_Site_Query();
    119122                        $found = $q->query(
     
    126129                        $this->assertSameSets( array( self::$site_ids['www.w.org/'] ), $found );
    127130                }
    128131
     132                /**
     133                 * @covers WP_Site_Query::query
     134                 */
    129135                public function test_wp_site_query_by_number() {
    130136                        $q     = new WP_Site_Query();
    131137                        $found = $q->query(
     
    138144                        $this->assertSame( 3, count( $found ) );
    139145                }
    140146
     147                /**
     148                 * @covers WP_Site_Query::query
     149                 */
    141150                public function test_wp_site_query_by_site__in_with_single_id() {
    142151                        $expected = array( self::$site_ids['wordpress.org/foo/'] );
    143152
     
    152161                        $this->assertSameSets( $expected, $found );
    153162                }
    154163
     164                /**
     165                 * @covers WP_Site_Query::query
     166                 */
    155167                public function test_wp_site_query_by_site__in_with_multiple_ids() {
    156168                        $expected = array( self::$site_ids['wordpress.org/'], self::$site_ids['wordpress.org/foo/'] );
    157169
     
    168180
    169181                /**
    170182                 * Test the `count` query var
     183                 *
     184                 * @covers WP_Site_Query::query
    171185                 */
    172186                public function test_wp_site_query_by_site__in_and_count_with_multiple_ids() {
    173187                        $expected = array( self::$site_ids['wordpress.org/'], self::$site_ids['wordpress.org/foo/'] );
     
    184198                        $this->assertSame( 2, $found );
    185199                }
    186200
     201                /**
     202                 * @covers WP_Site_Query::query
     203                 */
    187204                public function test_wp_site_query_by_site__not_in_with_single_id() {
    188205                        $excluded = array( self::$site_ids['wordpress.org/foo/'] );
    189206                        $expected = array_diff( self::$site_ids, $excluded );
     
    202219                        $this->assertSameSets( $expected, $found );
    203220                }
    204221
     222                /**
     223                 * @covers WP_Site_Query::query
     224                 */
    205225                public function test_wp_site_query_by_site__not_in_with_multiple_ids() {
    206226                        $excluded = array( self::$site_ids['wordpress.org/'], self::$site_ids['wordpress.org/foo/'] );
    207227                        $expected = array_diff( self::$site_ids, $excluded );
     
    220240                        $this->assertSameSets( $expected, $found );
    221241                }
    222242
     243                /**
     244                 * @covers WP_Site_Query::query
     245                 */
    223246                public function test_wp_site_query_by_network_id_with_order() {
    224247                        $q     = new WP_Site_Query();
    225248                        $found = $q->query(
     
    251274                        $this->assertSame( array_reverse( $expected ), $found );
    252275                }
    253276
     277                /**
     278                 * @covers WP_Site_Query::query
     279                 */
    254280                public function test_wp_site_query_by_network_id_with_existing_sites() {
    255281                        $q     = new WP_Site_Query();
    256282                        $found = $q->query(
     
    268294                        $this->assertSameSets( $expected, $found );
    269295                }
    270296
     297                /**
     298                 * @covers WP_Site_Query::query
     299                 */
    271300                public function test_wp_site_query_by_network_id_with_no_existing_sites() {
    272301                        $q     = new WP_Site_Query();
    273302                        $found = $q->query(
     
    280309                        $this->assertEmpty( $found );
    281310                }
    282311
     312                /**
     313                 * @covers WP_Site_Query::query
     314                 */
    283315                public function test_wp_site_query_by_domain() {
    284316                        $q     = new WP_Site_Query();
    285317                        $found = $q->query(
     
    299331                        $this->assertSameSets( $expected, $found );
    300332                }
    301333
     334                /**
     335                 * @covers WP_Site_Query::query
     336                 */
    302337                public function test_wp_site_query_by_domain_and_offset() {
    303338                        $q     = new WP_Site_Query();
    304339                        $found = $q->query(
     
    318353                        $this->assertSameSets( $expected, $found );
    319354                }
    320355
     356                /**
     357                 * @covers WP_Site_Query::query
     358                 */
    321359                public function test_wp_site_query_by_domain_and_number_and_offset() {
    322360                        $q     = new WP_Site_Query();
    323361                        $found = $q->query(
     
    337375                        $this->assertSameSets( $expected, $found );
    338376                }
    339377
     378                /**
     379                 * @covers WP_Site_Query::query
     380                 */
    340381                public function test_wp_site_query_by_domain__in_with_single_domain() {
    341382                        $q     = new WP_Site_Query();
    342383                        $found = $q->query(
     
    354395                        $this->assertSameSets( $expected, $found );
    355396                }
    356397
     398                /**
     399                 * @covers WP_Site_Query::query
     400                 */
    357401                public function test_wp_site_query_by_domain__in_with_multiple_domains() {
    358402                        $q     = new WP_Site_Query();
    359403                        $found = $q->query(
     
    374418                        $this->assertSameSets( $expected, $found );
    375419                }
    376420
     421                /**
     422                 * @covers WP_Site_Query::query
     423                 */
    377424                public function test_wp_site_query_by_domain__not_in_with_single_domain() {
    378425                        $q     = new WP_Site_Query();
    379426                        $found = $q->query(
     
    395442                        $this->assertSameSets( $expected, $found );
    396443                }
    397444
     445                /**
     446                 * @covers WP_Site_Query::query
     447                 */
    398448                public function test_wp_site_query_by_domain__not_in_with_multiple_domains() {
    399449                        $q     = new WP_Site_Query();
    400450                        $found = $q->query(
     
    413463                        $this->assertSameSets( $expected, $found );
    414464                }
    415465
     466                /**
     467                 * @covers WP_Site_Query::query
     468                 */
    416469                public function test_wp_site_query_by_path_with_expected_results() {
    417470                        $q     = new WP_Site_Query();
    418471                        $found = $q->query(
     
    430483                        $this->assertSameSets( $expected, $found );
    431484                }
    432485
     486                /**
     487                 * @covers WP_Site_Query::query
     488                 */
    433489                public function test_wp_site_query_by_path_with_no_expected_results() {
    434490                        $q     = new WP_Site_Query();
    435491                        $found = $q->query(
     
    442498                        $this->assertEmpty( $found );
    443499                }
    444500
    445                 // archived, mature, spam, deleted, public.
    446 
     501                /**
     502                 * archived, mature, spam, deleted, public.
     503                 *
     504                 * @covers WP_Site_Query::query
     505                 */
    447506                public function test_wp_site_query_by_archived() {
    448507                        $q     = new WP_Site_Query();
    449508                        $found = $q->query(
     
    458517                        $this->assertSameSets( array_values( self::$site_ids ), $found );
    459518                }
    460519
     520                /**
     521                 * @covers WP_Site_Query::query
     522                 */
    461523                public function test_wp_site_query_by_mature() {
    462524                        $q     = new WP_Site_Query();
    463525                        $found = $q->query(
     
    472534                        $this->assertSameSets( array_values( self::$site_ids ), $found );
    473535                }
    474536
     537                /**
     538                 * @covers WP_Site_Query::query
     539                 */
    475540                public function test_wp_site_query_by_spam() {
    476541                        $q     = new WP_Site_Query();
    477542                        $found = $q->query(
     
    486551                        $this->assertSameSets( array_values( self::$site_ids ), $found );
    487552                }
    488553
     554                /**
     555                 * @covers WP_Site_Query::query
     556                 */
    489557                public function test_wp_site_query_by_deleted() {
    490558                        $q     = new WP_Site_Query();
    491559                        $found = $q->query(
     
    500568                        $this->assertSameSets( array_values( self::$site_ids ), $found );
    501569                }
    502570
     571                /**
     572                 * @covers WP_Site_Query::query
     573                 */
    503574                public function test_wp_site_query_by_deleted_with_no_results() {
    504575                        $q     = new WP_Site_Query();
    505576                        $found = $q->query(
     
    512583                        $this->assertEmpty( $found );
    513584                }
    514585
     586                /**
     587                 * @covers WP_Site_Query::query
     588                 */
    515589                public function test_wp_site_query_by_public() {
    516590                        $q     = new WP_Site_Query();
    517591                        $found = $q->query(
     
    526600                        $this->assertSameSets( array_values( self::$site_ids ), $found );
    527601                }
    528602
     603                /**
     604                 * @covers WP_Site_Query::query
     605                 */
    529606                public function test_wp_site_query_by_lang_id_with_zero() {
    530607                        $q     = new WP_Site_Query();
    531608                        $found = $q->query(
     
    540617                        $this->assertSameSets( array_diff( array_values( self::$site_ids ), array( self::$site_ids['www.w.org/make/'] ) ), $found );
    541618                }
    542619
     620                /**
     621                 * @covers WP_Site_Query::query
     622                 */
    543623                public function test_wp_site_query_by_lang_id() {
    544624                        $q     = new WP_Site_Query();
    545625                        $found = $q->query(
     
    556636                        $this->assertSameSets( $expected, $found );
    557637                }
    558638
     639                /**
     640                 * @covers WP_Site_Query::query
     641                 */
    559642                public function test_wp_site_query_by_lang_id_with_no_results() {
    560643                        $q     = new WP_Site_Query();
    561644                        $found = $q->query(
     
    568651                        $this->assertEmpty( $found );
    569652                }
    570653
     654                /**
     655                 * @covers WP_Site_Query::query
     656                 */
    571657                public function test_wp_site_query_by_lang__in() {
    572658                        $q     = new WP_Site_Query();
    573659                        $found = $q->query(
     
    584670                        $this->assertSameSets( $expected, $found );
    585671                }
    586672
     673                /**
     674                 * @covers WP_Site_Query::query
     675                 */
    587676                public function test_wp_site_query_by_lang__in_with_multiple_ids() {
    588677                        $q     = new WP_Site_Query();
    589678                        $found = $q->query(
     
    598687                        $this->assertSameSets( array_values( self::$site_ids ), $found );
    599688                }
    600689
     690                /**
     691                 * @covers WP_Site_Query::query
     692                 */
    601693                public function test_wp_site_query_by_lang__not_in() {
    602694                        $q     = new WP_Site_Query();
    603695                        $found = $q->query(
     
    614706                        $this->assertSameSets( $expected, $found );
    615707                }
    616708
     709                /**
     710                 * @covers WP_Site_Query::query
     711                 */
    617712                public function test_wp_site_query_by_lang__not_in_with_multiple_ids() {
    618713                        $q     = new WP_Site_Query();
    619714                        $found = $q->query(
     
    626721                        $this->assertEmpty( $found );
    627722                }
    628723
     724                /**
     725                 * @covers WP_Site_Query::query
     726                 */
    629727                public function test_wp_site_query_by_search_with_text_in_domain() {
    630728                        $q     = new WP_Site_Query();
    631729                        $found = $q->query(
     
    643741                        $this->assertSameSets( $expected, $found );
    644742                }
    645743
     744                /**
     745                 * @covers WP_Site_Query::query
     746                 */
    646747                public function test_wp_site_query_by_search_with_text_in_path() {
    647748                        $q     = new WP_Site_Query();
    648749                        $found = $q->query(
     
    663764                        $this->assertSameSets( $expected, $found );
    664765                }
    665766
     767                /**
     768                 * @covers WP_Site_Query::query
     769                 */
    666770                public function test_wp_site_query_by_search_with_text_in_path_and_domain() {
    667771                        $q     = new WP_Site_Query();
    668772                        $found = $q->query(
     
    681785                        $this->assertSameSets( $expected, $found );
    682786                }
    683787
     788                /**
     789                 * @covers WP_Site_Query::query
     790                 */
    684791                public function test_wp_site_query_by_search_with_text_in_path_and_domain_order_by_domain_desc() {
    685792                        $q     = new WP_Site_Query();
    686793                        $found = $q->query(
     
    701808                        $this->assertSame( $expected, $found );
    702809                }
    703810
     811                /**
     812                 * @covers WP_Site_Query::query
     813                 */
    704814                public function test_wp_site_query_by_search_with_text_in_path_exclude_domain_from_search() {
    705815                        $q     = new WP_Site_Query();
    706816                        $found = $q->query(
     
    718828                        $this->assertSame( $expected, $found );
    719829                }
    720830
     831                /**
     832                 * @covers WP_Site_Query::query
     833                 */
    721834                public function test_wp_site_query_by_search_with_text_in_domain_exclude_path_from_search() {
    722835                        $q     = new WP_Site_Query();
    723836                        $found = $q->query(
     
    736849                        $this->assertSame( $expected, $found );
    737850                }
    738851
     852                /**
     853                 * @covers WP_Site_Query::query
     854                 */
    739855                public function test_wp_site_query_by_search_with_wildcard_in_text() {
    740856                        $q     = new WP_Site_Query();
    741857                        $found = $q->query(
     
    754870                        $this->assertSameSets( $expected, $found );
    755871                }
    756872
     873                /**
     874                 * @covers WP_Site_Query::query
     875                 */
    757876                public function test_wp_site_query_by_search_with_wildcard_in_text_exclude_path_from_search() {
    758877                        $q     = new WP_Site_Query();
    759878                        $found = $q->query(
     
    772891                        $this->assertSameSets( $expected, $found );
    773892                }
    774893
     894                /**
     895                 * @covers WP_Site_Query::query
     896                 */
    775897                public function test_wp_site_query_by_search_with_wildcard_in_text_exclude_domain_from_search() {
    776898                        $q     = new WP_Site_Query();
    777899                        $found = $q->query(
     
    791913
    792914                /**
    793915                 * @ticket 41197
     916                 *
     917                 * @covers WP_Site_Query::query
    794918                 */
    795919                public function test_wp_site_query_cache_with_different_fields_no_count() {
    796920                        global $wpdb;
     
    819943
    820944                /**
    821945                 * @ticket 41197
     946                 *
     947                 * @covers WP_Site_Query::query
    822948                 */
    823949                public function test_wp_site_query_cache_with_different_fields_active_count() {
    824950                        global $wpdb;
     
    849975
    850976                /**
    851977                 * @ticket 41197
     978                 *
     979                 * @covers WP_Site_Query::query
    852980                 */
    853981                public function test_wp_site_query_cache_with_same_fields_different_count() {
    854982                        global $wpdb;
     
    8801008                /**
    8811009                 * @ticket 40229
    8821010                 * @dataProvider data_wp_site_query_meta_query
     1011                 *
     1012                 * @covers WP_Site_Query::query
    8831013                 */
    8841014                public function test_wp_site_query_meta_query( $query, $expected, $strict ) {
    8851015                        if ( ! is_site_meta_supported() ) {
     
    10671197                /**
    10681198                 * @ticket 45749
    10691199                 * @ticket 47599
     1200                 *
     1201                 * @covers WP_Site_Query::query
    10701202                 */
    10711203                public function test_sites_pre_query_filter_should_bypass_database_query() {
    10721204                        global $wpdb;
     
    10981230
    10991231                /**
    11001232                 * @ticket 51333
     1233                 *
     1234                 * @covers WP_Site_Query::query
    11011235                 */
    11021236                public function test_sites_pre_query_filter_should_set_sites_property() {
    11031237                        add_filter( 'sites_pre_query', array( __CLASS__, 'filter_sites_pre_query_and_set_sites' ), 10, 2 );
  • tests/phpunit/tests/multisite/updateBlogDetails.php

     
    1010                /**
    1111                 * If `update_blog_details()` is called with any kind of empty arguments, it
    1212                 * should return false.
     13                 *
     14                 * @covers ::update_blog_details
    1315                 */
    1416                function test_update_blog_details_with_empty_args() {
    1517                        $result = update_blog_details( 1, array() );
     
    1820
    1921                /**
    2022                 * If the ID passed is not that of a current site, we should expect false.
     23                 *
     24                 * @covers ::update_blog_details
    2125                 */
    2226                function test_update_blog_details_invalid_blog_id() {
    2327                        $result = update_blog_details( 999, array( 'domain' => 'example.com' ) );
     
    2428                        $this->assertFalse( $result );
    2529                }
    2630
     31                /**
     32                 * @covers ::update_blog_details
     33                 */
    2734                function test_update_blog_details() {
    2835                        $blog_id = self::factory()->blog->create();
    2936
     
    5461                 * @param string $action     The hook expected to fire for the flag name and flag combination.
    5562                 *
    5663                 * @dataProvider data_flag_hooks
     64                 *
     65                 * @covers ::update_blog_details
    5766                 */
    5867                public function test_update_blog_details_flag_action( $flag, $flag_value, $hook ) {
    5968                        global $test_action_counter;
     
    111120                 * should have a leading and trailing slash.
    112121                 *
    113122                 * @dataProvider data_single_directory_path
     123                 *
     124                 * @covers ::update_blog_details
    114125                 */
    115126                public function test_update_blog_details_single_directory_path( $path, $expected ) {
    116127                        update_blog_details( 1, array( 'path' => $path ) );
  • tests/phpunit/tests/multisite/uploadIsUserOverQuota.php

     
    2727                        parent::tearDown();
    2828                }
    2929
     30                /**
     31                 * @covers ::upload_is_user_over_quota
     32                 */
    3033                public function test_upload_is_user_over_quota_allowed_0_used_5() {
    3134                        add_filter( 'get_space_allowed', '__return_zero' );
    3235                        add_filter( 'pre_get_space_used', array( $this, '_filter_space_5' ) );
     
    3740                        $this->assertTrue( $result );
    3841                }
    3942
     43                /**
     44                 * @covers ::upload_is_user_over_quota
     45                 */
    4046                public function test_upload_is_user_over_quota_allowed_0_used_0() {
    4147                        add_filter( 'get_space_allowed', '__return_zero' );
    4248                        add_filter( 'pre_get_space_used', '__return_zero' );
     
    4753                        $this->assertFalse( $result );
    4854                }
    4955
     56                /**
     57                 * @covers ::upload_is_user_over_quota
     58                 */
    5059                public function test_upload_is_user_over_quota_allowed_0_used_100() {
    5160                        add_filter( 'get_space_allowed', '__return_zero' );
    5261                        add_filter( 'pre_get_space_used', array( $this, '_filter_space_100' ) );
     
    5766                        $this->assertTrue( $result );
    5867                }
    5968
     69                /**
     70                 * @covers ::upload_is_user_over_quota
     71                 */
    6072                public function test_upload_is_user_over_quota_allowed_100_used_0() {
    6173                        add_filter( 'get_space_allowed', array( $this, '_filter_space_100' ) );
    6274                        add_filter( 'pre_get_space_used', '__return_zero' );
     
    6779                        $this->assertFalse( $result );
    6880                }
    6981
     82                /**
     83                 * @covers ::upload_is_user_over_quota
     84                 */
    7085                public function test_upload_is_user_over_quota_allowed_100_used_100() {
    7186                        add_filter( 'get_space_allowed', array( $this, '_filter_space_100' ) );
    7287                        add_filter( 'pre_get_space_used', array( $this, '_filter_space_100' ) );
     
    7792                        $this->assertFalse( $result );
    7893                }
    7994
     95                /**
     96                 * @covers ::upload_is_user_over_quota
     97                 */
    8098                public function test_upload_is_user_over_quota_allowed_100_used_200() {
    8199                        add_filter( 'get_space_allowed', array( $this, '_filter_space_100' ) );
    82100                        add_filter( 'pre_get_space_used', array( $this, '_filter_space_200' ) );
     
    87105                        $this->assertTrue( $result );
    88106                }
    89107
     108                /**
     109                 * @covers ::upload_is_user_over_quota
     110                 */
    90111                public function test_upload_is_user_over_quota_allowed_negative_used_100() {
    91112                        add_filter( 'get_space_allowed', array( $this, '_filter_space_negative' ) );
    92113                        add_filter( 'pre_get_space_used', array( $this, '_filter_space_100' ) );
     
    100121                /**
    101122                 * When the upload space check is disabled, using more than the available
    102123                 * quota is allowed.
     124                 *
     125                 * @covers ::upload_is_user_over_quota
    103126                 */
    104127                public function test_upload_is_user_over_check_disabled() {
    105128                        update_site_option( 'upload_space_check_disabled', true );
  • tests/phpunit/tests/multisite/wpGetSites.php

     
    5151
    5252                /**
    5353                 * @expectedDeprecated wp_get_sites
     54                 *
     55                 * @covers ::wp_get_sites
    5456                 */
    5557                public function test_wp_get_sites_site_is_expected_array() {
    5658
     
    8284                 * @param $expected
    8385                 * @param $args
    8486                 * @param $error
     87                 *
     88                 * @covers ::wp_get_sites
    8589                 */
    8690                public function test_wp_get_sites( $expected, $args, $error ) {
    8791                        $this->assertCount( $expected, wp_get_sites( $args ), $error );
  • tests/phpunit/tests/multisite/wpInstallDefaults.php

     
    3030
    3131                /**
    3232                 * @ticket 40036
     33                 *
     34                 * @covers ::get_page_by_path
     35                 * @covers ::get_comments
    3336                 */
    3437                public function test_empty_option_should_fall_back_to_default() {
    3538                        /*
     
    5659
    5760                /**
    5861                 * @ticket 40036
     62                 *
     63                 * @covers ::get_page_by_path
     64                 * @covers ::get_comments
    5965                 */
    6066                public function test_non_default_option_values() {
    6167                        /*
  • tests/phpunit/tests/multisite/wpMSSitesListTable.php

     
    8787                        }
    8888                }
    8989
     90                /**
     91                 * @covers WP_MS_Sites_List_Table::prepare_items
     92                 * @covers WP_MS_Sites_List_Table::items
     93                 */
    9094                public function test_ms_sites_list_table_default_items() {
    9195                        $this->table->prepare_items();
    9296
     
    96100                        $this->assertSameSets( array( 1 ) + self::$site_ids, $items );
    97101                }
    98102
     103                /**
     104                 * @covers WP_MS_Sites_List_Table::prepare_items
     105                 * @covers WP_MS_Sites_List_Table::items
     106                 */
    99107                public function test_ms_sites_list_table_subdirectory_path_search_items() {
    100108                        if ( is_subdomain_install() ) {
    101109                                $this->markTestSkipped( 'Path search is not available for subdomain configurations.' );
     
    122130                        $this->assertSameSets( $expected, $items );
    123131                }
    124132
     133                /**
     134                 * @covers WP_MS_Sites_List_Table::prepare_items
     135                 * @covers WP_MS_Sites_List_Table::items
     136                 */
    125137                public function test_ms_sites_list_table_subdirectory_multiple_path_search_items() {
    126138                        if ( is_subdomain_install() ) {
    127139                                $this->markTestSkipped( 'Path search is not available for subdomain configurations.' );
     
    144156                        $this->assertSameSets( $expected, $items );
    145157                }
    146158
     159                /**
     160                 * @covers WP_MS_Sites_List_Table::prepare_items
     161                 * @covers WP_MS_Sites_List_Table::items
     162                 */
    147163                public function test_ms_sites_list_table_invalid_path_search_items() {
    148164                        $_REQUEST['s'] = 'foobar';
    149165
     
    157173                        $this->assertEmpty( $items );
    158174                }
    159175
     176                /**
     177                 * @covers WP_MS_Sites_List_Table::prepare_items
     178                 * @covers WP_MS_Sites_List_Table::items
     179                 */
    160180                public function test_ms_sites_list_table_subdomain_domain_search_items() {
    161181                        if ( ! is_subdomain_install() ) {
    162182                                $this->markTestSkipped( 'Domain search is not available for subdirectory configurations.' );
     
    181201                        $this->assertSameSets( $expected, $items );
    182202                }
    183203
     204                /**
     205                 * @covers WP_MS_Sites_List_Table::prepare_items
     206                 * @covers WP_MS_Sites_List_Table::items
     207                 */
    184208                public function test_ms_sites_list_table_subdomain_domain_search_items_with_trailing_wildcard() {
    185209                        if ( ! is_subdomain_install() ) {
    186210                                $this->markTestSkipped( 'Domain search is not available for subdirectory configurations.' );
     
    205229                        $this->assertSameSets( $expected, $items );
    206230                }
    207231
     232                /**
     233                 * @covers WP_MS_Sites_List_Table::prepare_items
     234                 * @covers WP_MS_Sites_List_Table::items
     235                 */
    208236                public function test_ms_sites_list_table_subdirectory_path_search_items_with_trailing_wildcard() {
    209237                        if ( is_subdomain_install() ) {
    210238                                $this->markTestSkipped( 'Path search is not available for subdomain configurations.' );
  • tests/phpunit/tests/multisite/wpmuValidateBlogSignup.php

     
    5252
    5353                /**
    5454                 * @dataProvider data_validate_blogname
     55                 *
     56                 * @covers ::wpmu_validate_blog_signup
    5557                 */
    5658                public function test_validate_blogname( $blog_name, $error_message ) {
    5759                        $result = wpmu_validate_blog_signup( $blog_name, 'Foo Site Title', get_userdata( self::$super_admin_id ) );
     
    8183                        return $data;
    8284                }
    8385
     86                /**
     87                 *  @covers ::wpmu_validate_blog_signup
     88                 */
    8489                public function test_validate_empty_blog_title() {
    8590                        $result = wpmu_validate_blog_signup( 'uniqueblogname1234', '', get_userdata( self::$super_admin_id ) );
    8691                        $this->assertContains( 'blog_title', $result['errors']->get_error_codes(), 'Site titles must not be empty.' );
    8792                }
    8893
     94                /**
     95                 *  @covers ::wpmu_validate_blog_signup
     96                 */
    8997                public function test_validate_blogname_from_same_existing_user() {
    9098                        $result = wpmu_validate_blog_signup( self::$existing_user_login, 'Foo Site Title', get_userdata( self::$existing_user_id ) );
    9199                        $this->assertEmpty( $result['errors']->get_error_codes() );
     
    95103                 * @ticket 39676
    96104                 *
    97105                 * @dataProvider data_filter_minimum_site_name_length
     106                 *
     107                 * @covers ::wpmu_validate_blog_signup
    98108                 */
    99109                public function test_filter_minimum_site_name_length( $site_name, $minimum_length, $expect_error ) {
    100110                        $this->minimum_site_name_length = $minimum_length;
     
    129139
    130140                /**
    131141                 * @ticket 43667
     142                 *
     143                 * @covers ::wpmu_validate_blog_signup
    132144                 */
    133145                public function test_signup_nonce_check() {
    134146                        $original_php_self       = $_SERVER['PHP_SELF'];
     
    144156
    145157                /**
    146158                 * @ticket 43667
     159                 *
     160                 * @covers ::wpmu_validate_blog_signup
    147161                 */
    148162                public function test_signup_nonce_check_invalid() {
    149163                        $original_php_self       = $_SERVER['PHP_SELF'];
  • tests/phpunit/tests/multisite/wpmuValidateUserSignup.php

     
    3030                        );
    3131                }
    3232
     33                /**
     34                 *  @covers ::wpmu_validate_user_signup
     35                 */
    3336                public function test_should_fail_for_illegal_names() {
    3437                        $illegal = array( 'foo123', 'bar123' );
    3538                        update_site_option( 'illegal_names', $illegal );
     
    4043                        }
    4144                }
    4245
     46                /**
     47                 *  @covers ::wpmu_validate_user_signup
     48                 */
    4349                public function test_should_fail_for_unsafe_email_address() {
    4450                        add_filter( 'is_email_address_unsafe', '__return_true' );
    4551                        $v = wpmu_validate_user_signup( 'foo123', 'foo@example.com' );
     
    4753                        remove_filter( 'is_email_address_unsafe', '__return_true' );
    4854                }
    4955
     56                /**
     57                 *  @covers ::wpmu_validate_user_signup
     58                 */
    5059                public function test_should_fail_for_invalid_email_address() {
    5160                        add_filter( 'is_email', '__return_false' );
    5261                        $v = wpmu_validate_user_signup( 'foo123', 'foo@example.com' );
     
    5463                        remove_filter( 'is_email', '__return_false' );
    5564                }
    5665
     66                /**
     67                 *  @covers ::wpmu_validate_user_signup
     68                 */
    5769                public function test_should_fail_for_emails_from_disallowed_domains() {
    5870                        $domains = array( 'foo.com', 'bar.org' );
    5971                        update_site_option( 'limited_email_domains', $domains );
     
    6274                        $this->assertContains( 'user_email', $v['errors']->get_error_codes() );
    6375                }
    6476
     77                /**
     78                 *  @covers ::wpmu_validate_user_signup
     79                 */
    6580                public function test_should_not_fail_for_emails_from_allowed_domains_with_mixed_case() {
    6681                        $domains = array( 'foo.com', 'bar.org' );
    6782                        update_site_option( 'limited_email_domains', $domains );
     
    7085                        $this->assertNotContains( 'user_email', $v['errors']->get_error_codes() );
    7186                }
    7287
     88                /**
     89                 *  @covers ::wpmu_validate_user_signup
     90                 */
    7391                public function test_should_fail_for_existing_user_name() {
    7492                        $u = self::factory()->user->create( array( 'user_login' => 'foo123' ) );
    7593                        $v = wpmu_validate_user_signup( 'foo123', 'foo@example.com' );
     
    7694                        $this->assertContains( 'user_name', $v['errors']->get_error_codes() );
    7795                }
    7896
     97                /**
     98                 *  @covers ::wpmu_validate_user_signup
     99                 */
    79100                public function test_should_fail_for_existing_user_email() {
    80101                        $u = self::factory()->user->create( array( 'user_email' => 'foo@example.com' ) );
    81102                        $v = wpmu_validate_user_signup( 'foo123', 'foo@example.com' );
     
    82103                        $this->assertContains( 'user_email', $v['errors']->get_error_codes() );
    83104                }
    84105
     106                /**
     107                 *  @covers ::wpmu_validate_user_signup
     108                 */
    85109                public function test_should_fail_for_existing_signup_with_same_username() {
    86110                        // Don't send notifications.
    87111                        add_filter( 'wpmu_signup_user_notification', '__return_false' );
     
    92116                        $this->assertContains( 'user_name', $v['errors']->get_error_codes() );
    93117                }
    94118
     119                /**
     120                 *  @covers ::wpmu_validate_user_signup
     121                 */
    95122                public function test_should_not_fail_for_existing_signup_with_same_username_if_signup_is_old() {
    96123                        // Don't send notifications.
    97124                        add_filter( 'wpmu_signup_user_notification', '__return_false' );
     
    106133                        $this->assertNotContains( 'user_name', $v['errors']->get_error_codes() );
    107134                }
    108135
     136                /**
     137                 *  @covers ::wpmu_validate_user_signup
     138                 */
    109139                public function test_should_fail_for_existing_signup_with_same_email() {
    110140                        // Don't send notifications.
    111141                        add_filter( 'wpmu_signup_user_notification', '__return_false' );
     
    116146                        $this->assertContains( 'user_email', $v['errors']->get_error_codes() );
    117147                }
    118148
     149                /**
     150                 *  @covers ::wpmu_validate_user_signup
     151                 */
    119152                public function test_should_not_fail_for_existing_signup_with_same_email_if_signup_is_old() {
    120153                        // Don't send notifications.
    121154                        add_filter( 'wpmu_signup_user_notification', '__return_false' );
     
    132165
    133166                /**
    134167                 * @ticket 43232
     168                 *
     169                 *  @covers ::wpmu_validate_user_signup
    135170                 */
    136171                public function test_should_not_fail_for_data_used_by_a_deleted_user() {
    137172                        global $wpdb;
     
    161196                        $this->assertContains( 'user_email', $valid['errors']->get_error_codes() );
    162197                }
    163198
     199                /**
     200                 *  @covers ::wpmu_validate_user_signup
     201                 */
    164202                public function test_invalid_email_address_with_banned_domains_results_in_error() {
    165203                        update_site_option( 'banned_email_domains', 'bar.com' );
    166204                        $valid = wpmu_validate_user_signup( 'validusername', 'invalid-email' );
     
    169207                        $this->assertContains( 'user_email', $valid['errors']->get_error_codes() );
    170208                }
    171209
     210                /**
     211                 *  @covers ::wpmu_validate_user_signup
     212                 */
    172213                public function test_incomplete_email_address_with_no_banned_domains_results_in_error() {
    173214                        $valid = wpmu_validate_user_signup( 'validusername', 'incomplete@email' );
    174215
     
    175216                        $this->assertContains( 'user_email', $valid['errors']->get_error_codes() );
    176217                }
    177218
     219                /**
     220                 *  @covers ::wpmu_validate_user_signup
     221                 */
    178222                public function test_valid_email_address_matching_banned_domain_results_in_error() {
    179223                        update_site_option( 'banned_email_domains', 'bar.com' );
    180224                        $valid = wpmu_validate_user_signup( 'validusername', 'email@bar.com' );
     
    183227                        $this->assertContains( 'user_email', $valid['errors']->get_error_codes() );
    184228                }
    185229
     230                /**
     231                 *  @covers ::wpmu_validate_user_signup
     232                 */
    186233                public function test_valid_email_address_not_matching_banned_domain_returns_in_success() {
    187234                        update_site_option( 'banned_email_domains', 'bar.com' );
    188235                        $valid = wpmu_validate_user_signup( 'validusername', 'email@example.com' );
     
    193240
    194241                /**
    195242                 * @ticket 43667
     243                 *
     244                 *  @covers ::wpmu_validate_user_signup
    196245                 */
    197246                public function test_signup_nonce_check() {
    198247                        $original_php_self       = $_SERVER['PHP_SELF'];
     
    208257
    209258                /**
    210259                 * @ticket 43667
     260                 *
     261                 *  @covers ::wpmu_validate_user_signup
    211262                 */
    212263                public function test_signup_nonce_check_invalid() {
    213264                        $original_php_self       = $_SERVER['PHP_SELF'];