WordPress.org

Make WordPress Core

Changeset 44469


Ignore:
Timestamp:
01/08/2019 08:57:32 AM (17 months ago)
Author:
flixos90
Message:

Multisite: Update @since tags for site management APIs.

Fixes #40364. Fixes #41333.

Location:
trunk/src
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-admin/includes/ms.php

    r43654 r44469  
    5757 *
    5858 * @since 3.0.0
    59  * @since 5.0.0 Use wp_delete_site() internally to delete the site row from the database.
     59 * @since 5.1.0 Use wp_delete_site() internally to delete the site row from the database.
    6060 *
    6161 * @global wpdb $wpdb WordPress database abstraction object.
     
    9898    } else {
    9999        /** This action is documented in wp-includes/ms-blogs.php */
    100         do_action_deprecated( 'delete_blog', array( $blog_id, false ), '5.0.0' );
     100        do_action_deprecated( 'delete_blog', array( $blog_id, false ), '5.1.0' );
    101101
    102102        $users = get_users(
     
    117117
    118118        /** This action is documented in wp-includes/ms-blogs.php */
    119         do_action_deprecated( 'deleted_blog', array( $blog_id, false ), '5.0.0' );
     119        do_action_deprecated( 'deleted_blog', array( $blog_id, false ), '5.1.0' );
    120120    }
    121121
  • trunk/src/wp-includes/ms-blogs.php

    r44468 r44469  
    401401 * Inserts a new site into the database.
    402402 *
    403  * @since 5.0.0
     403 * @since 5.1.0
    404404 *
    405405 * @global wpdb $wpdb WordPress database abstraction object.
     
    465465     * Fires once a site has been inserted into the database.
    466466     *
    467      * @since 5.0.0
     467     * @since 5.1.0
    468468     *
    469469     * @param WP_Site $new_site New site object.
     
    474474     * Fires when a site's initialization routine should be executed.
    475475     *
    476      * @since 5.0.0
     476     * @since 5.1.0
    477477     *
    478478     * @param WP_Site $new_site New site object.
     
    490490         *
    491491         * @since MU (3.0.0)
    492          * @deprecated 5.0.0 Use wp_insert_site
     492         * @deprecated 5.1.0 Use wp_insert_site
    493493         *
    494494         * @param int    $site_id    Site ID.
     
    499499         * @param array  $meta       Meta data. Used to set initial site options.
    500500         */
    501         do_action_deprecated( 'wpmu_new_blog', array( $new_site->id, $user_id, $new_site->domain, $new_site->path, $new_site->network_id, $meta ), '5.0.0', 'wp_insert_site' );
     501        do_action_deprecated( 'wpmu_new_blog', array( $new_site->id, $user_id, $new_site->domain, $new_site->path, $new_site->network_id, $meta ), '5.1.0', 'wp_insert_site' );
    502502    }
    503503
     
    508508 * Updates a site in the database.
    509509 *
    510  * @since 5.0.0
     510 * @since 5.1.0
    511511 *
    512512 * @global wpdb $wpdb WordPress database abstraction object.
     
    549549     * Fires once a site has been updated in the database.
    550550     *
    551      * @since 5.0.0
     551     * @since 5.1.0
    552552     *
    553553     * @param WP_Site $new_site New site object.
     
    562562 * Deletes a site from the database.
    563563 *
    564  * @since 5.0.0
     564 * @since 5.1.0
    565565 *
    566566 * @global wpdb $wpdb WordPress database abstraction object.
     
    589589     * are present, the site will not be deleted.
    590590     *
    591      * @since 5.0.0
     591     * @since 5.1.0
    592592     *
    593593     * @param WP_Error $errors   Error object to add validation errors to.
     
    604604     *
    605605     * @since MU (3.0.0)
    606      * @deprecated 5.0.0
     606     * @deprecated 5.1.0
    607607     *
    608608     * @param int  $site_id The site ID.
    609609     * @param bool $drop    True if site's table should be dropped. Default is false.
    610610     */
    611     do_action_deprecated( 'delete_blog', array( $old_site->id, true ), '5.0.0' );
     611    do_action_deprecated( 'delete_blog', array( $old_site->id, true ), '5.1.0' );
    612612
    613613    /**
    614614     * Fires when a site's uninitialization routine should be executed.
    615615     *
    616      * @since 5.0.0
     616     * @since 5.1.0
    617617     *
    618618     * @param WP_Site $old_site Deleted site object.
     
    636636     * Fires once a site has been deleted from the database.
    637637     *
    638      * @since 5.0.0
     638     * @since 5.1.0
    639639     *
    640640     * @param WP_Site $old_site Deleted site object.
     
    646646     *
    647647     * @since 4.8.0
    648      * @deprecated 5.0.0
     648     * @deprecated 5.1.0
    649649     *
    650650     * @param int  $site_id The site ID.
    651651     * @param bool $drop    True if site's tables should be dropped. Default is false.
    652652     */
    653     do_action_deprecated( 'deleted_blog', array( $old_site->id, true ), '5.0.0' );
     653    do_action_deprecated( 'deleted_blog', array( $old_site->id, true ), '5.1.0' );
    654654
    655655    return $old_site;
     
    825825 * Prepares site data for insertion or update in the database.
    826826 *
    827  * @since 5.0.0
     827 * @since 5.1.0
    828828 *
    829829 * @param array        $data     Associative array of site data passed to the respective function.
     
    848848     * Filters passed site data in order to normalize it.
    849849     *
    850      * @since 5.0.0
     850     * @since 5.1.0
    851851     *
    852852     * @param array $data Associative array of site data passed to the respective function.
     
    865865     * Plugins should amend the `$errors` object via its `WP_Error::add()` method.
    866866     *
    867      * @since 5.0.0
     867     * @since 5.1.0
    868868     *
    869869     * @param WP_Error     $errors   Error object to add validation errors to.
     
    889889 * Normalizes data for a site prior to inserting or updating in the database.
    890890 *
    891  * @since 5.0.0
     891 * @since 5.1.0
    892892 *
    893893 * @param array $data Associative array of site data passed to the respective function.
     
    941941 * Validates data for a site prior to inserting or updating in the database.
    942942 *
    943  * @since 5.0.0
     943 * @since 5.1.0
    944944 *
    945945 * @param WP_Error     $errors   Error object, passed by reference. Will contain validation errors if
     
    10091009 * populating them with defaults.
    10101010 *
    1011  * @since 5.0.0
     1011 * @since 5.1.0
    10121012 *
    10131013 * @global wpdb     $wpdb     WordPress database abstraction object.
     
    10631063     * Filters the arguments for initializing a site.
    10641064     *
    1065      * @since 5.0.0
     1065     * @since 5.1.0
    10661066     *
    10671067     * @param array      $args    Arguments to modify the initialization behavior.
     
    11491149 * This process includes dropping the site's database tables and deleting its uploads directory.
    11501150 *
    1151  * @since 5.0.0
     1151 * @since 5.1.0
    11521152 *
    11531153 * @global wpdb $wpdb WordPress database abstraction object.
     
    12711271 * A site is considered initialized when its database tables are present.
    12721272 *
    1273  * @since 5.0.0
     1273 * @since 5.1.0
    12741274 *
    12751275 * @global wpdb $wpdb WordPress database abstraction object.
     
    12921292     * that value instead.
    12931293     *
    1294      * @since 5.0.0
     1294     * @since 5.1.0
    12951295     *
    12961296     * @param bool|null $pre     The value to return, if not null.
     
    17641764 *
    17651765 * @since MU (3.0.0)
    1766  * @since 5.0.0 Use wp_update_site() internally.
     1766 * @since 5.1.0 Use wp_update_site() internally.
    17671767 *
    17681768 * @global wpdb $wpdb WordPress database abstraction object.
     
    20672067 * Updates the count of sites for a network based on a changed site.
    20682068 *
    2069  * @since 5.0.0
     2069 * @since 5.1.0
    20702070 *
    20712071 * @param WP_Site      $new_site The site object that has been inserted, updated or deleted.
     
    20882088 * Triggers actions on site status updates.
    20892089 *
    2090  * @since 5.0.0
     2090 * @since 5.1.0
    20912091 *
    20922092 * @param WP_Site      $new_site The site object after the update.
     
    22152215 * Cleans the necessary caches after specific site data has been updated.
    22162216 *
    2217  * @since 5.0.0
     2217 * @since 5.1.0
    22182218 *
    22192219 * @param WP_Site $new_site The site object after the update.
     
    22292229 * Updates the `blog_public` option for a given site ID.
    22302230 *
    2231  * @since 5.0.0
     2231 * @since 5.1.0
    22322232 *
    22332233 * @param int    $site_id Site ID.
  • trunk/src/wp-includes/ms-deprecated.php

    r44048 r44469  
    560560 *
    561561 * @since MU (3.0.0)
    562  * @deprecated 5.0.0 Use `wp_insert_site()`
     562 * @deprecated 5.1.0 Use `wp_insert_site()`
    563563 * @see wp_insert_site()
    564564 *
     
    569569 */
    570570function insert_blog($domain, $path, $site_id) {
    571     _deprecated_function( __FUNCTION__, '5.0.0', 'wp_insert_site()' );
     571    _deprecated_function( __FUNCTION__, '5.1.0', 'wp_insert_site()' );
    572572
    573573    $data = array(
     
    595595 *
    596596 * @since MU (3.0.0)
    597  * @deprecated 5.0.0
     597 * @deprecated 5.1.0
    598598 *
    599599 * @global wpdb     $wpdb
     
    606606    global $wpdb, $wp_roles;
    607607
    608     _deprecated_function( __FUNCTION__, '5.0.0' );
     608    _deprecated_function( __FUNCTION__, '5.1.0' );
    609609
    610610    // Cast for security
  • trunk/src/wp-includes/ms-functions.php

    r43654 r44469  
    13481348 *
    13491349 * @since MU (3.0.0)
    1350  * @since 5.0.0 $blog_id now supports input from the {@see 'wp_initialize_site'} action.
     1350 * @since 5.1.0 $blog_id now supports input from the {@see 'wp_initialize_site'} action.
    13511351 *
    13521352 * @param WP_Site|int $blog_id    The new site's object or ID.
     
    19001900 *
    19011901 * @since MU (3.0.0)
    1902  * @since 5.0.0 Parameters now support input from the {@see 'wp_initialize_site'} action.
     1902 * @since 5.1.0 Parameters now support input from the {@see 'wp_initialize_site'} action.
    19031903 *
    19041904 * @global wpdb $wpdb WordPress database abstraction object.
Note: See TracChangeset for help on using the changeset viewer.