Changeset 40930

Timestamp:

06/25/2017 05:47:27 AM (6 years ago)

Author:

DrewAPicture

Message:

Docs: Add more complete documentation about expected values in the $meta parameter for wpmu_create_blog().

See #41017.

File:

• trunk/src/wp-includes/ms-functions.php (modified) (1 diff)

trunk/src/wp-includes/ms-functions.php

@@ -1148 +1148 @@
  * @param string $title   The new site's title.
  * @param int    $user_id The user ID of the new site's admin.
- * @param array  $meta    Optional. Used to set initial site options.
+ * @param array  $meta    Optional. Array of key=>value pairs used to set initial site options.
+ *                        If valid status keys are included ('public', 'archived', 'mature',
+ *                        'spam', 'deleted', or 'lang_id') the given site status(es) will be
+ *                        updated. Otherwise, keys and values will be used to set options for
+ *                        the new site. Default empty array.
  * @param int    $site_id Optional. Only relevant on multi-network installs.
  * @return int|WP_Error Returns WP_Error object on failure, int $blog_id on success