signup_blog

The timeline below displays how wordpress function signup_blog has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.9

/**
 * Shows a form for a user or visitor to sign up for a new site.
 *
 * @since MU (3.0.0)
 *
 * @param string          $user_name  The username.
 * @param string          $user_email The user's email address.
 * @param string          $blogname   The site name.
 * @param string          $blog_title The site title.
 * @param WP_Error|string $errors     A WP_Error object containing existing errors. Defaults to empty string.
 */
function signup_blog($user_name = '', $user_email = '', $blogname = '', $blog_title = '', $errors = '')
{
    if (!is_wp_error($errors)) {
        $errors = new WP_Error();
    }
    $signup_blog_defaults = array('user_name' => $user_name, 'user_email' => $user_email, 'blogname' => $blogname, 'blog_title' => $blog_title, 'errors' => $errors);
    /**
     * Filters the default site creation variables for the site sign-up form.
     *
     * @since 3.0.0
     *
     * @param array $signup_blog_defaults {
     *     An array of default site creation variables.
     *
     *     @type string   $user_name  The user username.
     *     @type string   $user_email The user email address.
     *     @type string   $blogname   The blogname.
     *     @type string   $blog_title The title of the site.
     *     @type WP_Error $errors     A WP_Error object with possible errors relevant to new site creation variables.
     * }
     */
    $filtered_results = apply_filters('signup_blog_init', $signup_blog_defaults);
    $user_name = $filtered_results['user_name'];
    $user_email = $filtered_results['user_email'];
    $blogname = $filtered_results['blogname'];
    $blog_title = $filtered_results['blog_title'];
    $errors = $filtered_results['errors'];
    if (empty($blogname)) {
        $blogname = $user_name;
    }
    ?>
	<form id="setupform" method="post" action="wp-signup.php">
		<input type="hidden" name="stage" value="validate-blog-signup" />
		<input type="hidden" name="user_name" value="<?php 
    echo esc_attr($user_name);
    ?>" />
		<input type="hidden" name="user_email" value="<?php 
    echo esc_attr($user_email);
    ?>" />
		<?php 
    /** This action is documented in wp-signup.php */
    do_action('signup_hidden_fields', 'validate-site');
    ?>
		<?php 
    show_blog_form($blogname, $blog_title, $errors);
    ?>
		<p class="submit"><input type="submit" name="submit" class="submit" value="<?php 
    esc_attr_e('Sign up');
    ?>" /></p>
	</form>
	<?php 
}

WordPress Version: 5.6

/**
 * Shows a form for a user or visitor to sign up for a new site.
 *
 * @since MU (3.0.0)
 *
 * @param string          $user_name  The username.
 * @param string          $user_email The user's email address.
 * @param string          $blogname   The site name.
 * @param string          $blog_title The site title.
 * @param WP_Error|string $errors     A WP_Error object containing existing errors. Defaults to empty string.
 */
function signup_blog($user_name = '', $user_email = '', $blogname = '', $blog_title = '', $errors = '')
{
    if (!is_wp_error($errors)) {
        $errors = new WP_Error();
    }
    $signup_blog_defaults = array('user_name' => $user_name, 'user_email' => $user_email, 'blogname' => $blogname, 'blog_title' => $blog_title, 'errors' => $errors);
    /**
     * Filters the default site creation variables for the site sign-up form.
     *
     * @since 3.0.0
     *
     * @param array $signup_blog_defaults {
     *     An array of default site creation variables.
     *
     *     @type string   $user_name  The user username.
     *     @type string   $user_email The user email address.
     *     @type string   $blogname   The blogname.
     *     @type string   $blog_title The title of the site.
     *     @type WP_Error $errors     A WP_Error object with possible errors relevant to new site creation variables.
     * }
     */
    $filtered_results = apply_filters('signup_blog_init', $signup_blog_defaults);
    $user_name = $filtered_results['user_name'];
    $user_email = $filtered_results['user_email'];
    $blogname = $filtered_results['blogname'];
    $blog_title = $filtered_results['blog_title'];
    $errors = $filtered_results['errors'];
    if (empty($blogname)) {
        $blogname = $user_name;
    }
    ?>
	<form id="setupform" method="post" action="wp-signup.php">
		<input type="hidden" name="stage" value="validate-blog-signup" />
		<input type="hidden" name="user_name" value="<?php 
    echo esc_attr($user_name);
    ?>" />
		<input type="hidden" name="user_email" value="<?php 
    echo esc_attr($user_email);
    ?>" />
		<?php 
    /** This action is documented in wp-signup.php */
    do_action('signup_hidden_fields', 'validate-site');
    ?>
		<?php 
    show_blog_form($blogname, $blog_title, $errors);
    ?>
		<p class="submit"><input type="submit" name="submit" class="submit" value="<?php 
    esc_attr_e('Signup');
    ?>" /></p>
	</form>
	<?php 
}

WordPress Version: 4.9

/**
 * Setup the new site signup
 *
 * @since MU (3.0.0)
 *
 * @param string          $user_name  The username.
 * @param string          $user_email The user's email address.
 * @param string          $blogname   The site name.
 * @param string          $blog_title The site title.
 * @param WP_Error|string $errors     A WP_Error object containing existing errors. Defaults to empty string.
 */
function signup_blog($user_name = '', $user_email = '', $blogname = '', $blog_title = '', $errors = '')
{
    if (!is_wp_error($errors)) {
        $errors = new WP_Error();
    }
    $signup_blog_defaults = array('user_name' => $user_name, 'user_email' => $user_email, 'blogname' => $blogname, 'blog_title' => $blog_title, 'errors' => $errors);
    /**
     * Filters the default site creation variables for the site sign-up form.
     *
     * @since 3.0.0
     *
     * @param array $signup_blog_defaults {
     *     An array of default site creation variables.
     *
     *     @type string   $user_name  The user username.
     *     @type string   $user_email The user email address.
     *     @type string   $blogname   The blogname.
     *     @type string   $blog_title The title of the site.
     *     @type WP_Error $errors     A WP_Error object with possible errors relevant to new site creation variables.
     * }
     */
    $filtered_results = apply_filters('signup_blog_init', $signup_blog_defaults);
    $user_name = $filtered_results['user_name'];
    $user_email = $filtered_results['user_email'];
    $blogname = $filtered_results['blogname'];
    $blog_title = $filtered_results['blog_title'];
    $errors = $filtered_results['errors'];
    if (empty($blogname)) {
        $blogname = $user_name;
    }
    ?>
	<form id="setupform" method="post" action="wp-signup.php">
		<input type="hidden" name="stage" value="validate-blog-signup" />
		<input type="hidden" name="user_name" value="<?php 
    echo esc_attr($user_name);
    ?>" />
		<input type="hidden" name="user_email" value="<?php 
    echo esc_attr($user_email);
    ?>" />
		<?php 
    /** This action is documented in wp-signup.php */
    do_action('signup_hidden_fields', 'validate-site');
    ?>
		<?php 
    show_blog_form($blogname, $blog_title, $errors);
    ?>
		<p class="submit"><input type="submit" name="submit" class="submit" value="<?php 
    esc_attr_e('Signup');
    ?>" /></p>
	</form>
	<?php 
}

WordPress Version: 4.6

/**
 * Setup the new site signup
 *
 * @since MU
 *
 * @param string          $user_name  The username.
 * @param string          $user_email The user's email address.
 * @param string          $blogname   The site name.
 * @param string          $blog_title The site title.
 * @param WP_Error|string $errors     A WP_Error object containing existing errors. Defaults to empty string.
 */
function signup_blog($user_name = '', $user_email = '', $blogname = '', $blog_title = '', $errors = '')
{
    if (!is_wp_error($errors)) {
        $errors = new WP_Error();
    }
    $signup_blog_defaults = array('user_name' => $user_name, 'user_email' => $user_email, 'blogname' => $blogname, 'blog_title' => $blog_title, 'errors' => $errors);
    /**
     * Filters the default site creation variables for the site sign-up form.
     *
     * @since 3.0.0
     *
     * @param array $signup_blog_defaults {
     *     An array of default site creation variables.
     *
     *     @type string   $user_name  The user username.
     *     @type string   $user_email The user email address.
     *     @type string   $blogname   The blogname.
     *     @type string   $blog_title The title of the site.
     *     @type WP_Error $errors     A WP_Error object with possible errors relevant to new site creation variables.
     * }
     */
    $filtered_results = apply_filters('signup_blog_init', $signup_blog_defaults);
    $user_name = $filtered_results['user_name'];
    $user_email = $filtered_results['user_email'];
    $blogname = $filtered_results['blogname'];
    $blog_title = $filtered_results['blog_title'];
    $errors = $filtered_results['errors'];
    if (empty($blogname)) {
        $blogname = $user_name;
    }
    ?>
	<form id="setupform" method="post" action="wp-signup.php">
		<input type="hidden" name="stage" value="validate-blog-signup" />
		<input type="hidden" name="user_name" value="<?php 
    echo esc_attr($user_name);
    ?>" />
		<input type="hidden" name="user_email" value="<?php 
    echo esc_attr($user_email);
    ?>" />
		<?php 
    /** This action is documented in wp-signup.php */
    do_action('signup_hidden_fields', 'validate-site');
    ?>
		<?php 
    show_blog_form($blogname, $blog_title, $errors);
    ?>
		<p class="submit"><input type="submit" name="submit" class="submit" value="<?php 
    esc_attr_e('Signup');
    ?>" /></p>
	</form>
	<?php 
}

WordPress Version: 4.1

/**
 * Setup the new site signup
 *
 * @since MU
 *
 * @param string $user_name The username
 * @param string $user_email The user's email address
 * @param string $blogname The site name
 * @param string $blog_title The site title
 * @param array $errors
 */
function signup_blog($user_name = '', $user_email = '', $blogname = '', $blog_title = '', $errors = '')
{
    if (!is_wp_error($errors)) {
        $errors = new WP_Error();
    }
    $signup_blog_defaults = array('user_name' => $user_name, 'user_email' => $user_email, 'blogname' => $blogname, 'blog_title' => $blog_title, 'errors' => $errors);
    /**
     * Filter the default site creation variables for the site sign-up form.
     *
     * @since 3.0.0
     *
     * @param array $signup_blog_defaults {
     *     An array of default site creation variables.
     *
     *     @type string $user_name  The user username.
     *     @type string $user_email The user email address.
     *     @type string $blogname   The blogname.
     *     @type string $blog_title The title of the site.
     *     @type array  $errors     An array of possible errors relevant to new site creation variables.
     * }
     */
    $filtered_results = apply_filters('signup_blog_init', $signup_blog_defaults);
    $user_name = $filtered_results['user_name'];
    $user_email = $filtered_results['user_email'];
    $blogname = $filtered_results['blogname'];
    $blog_title = $filtered_results['blog_title'];
    $errors = $filtered_results['errors'];
    if (empty($blogname)) {
        $blogname = $user_name;
    }
    ?>
	<form id="setupform" method="post" action="wp-signup.php">
		<input type="hidden" name="stage" value="validate-blog-signup" />
		<input type="hidden" name="user_name" value="<?php 
    echo esc_attr($user_name);
    ?>" />
		<input type="hidden" name="user_email" value="<?php 
    echo esc_attr($user_email);
    ?>" />
		<?php 
    /** This action is documented in wp-signup.php */
    do_action('signup_hidden_fields', 'validate-site');
    ?>
		<?php 
    show_blog_form($blogname, $blog_title, $errors);
    ?>
		<p class="submit"><input type="submit" name="submit" class="submit" value="<?php 
    esc_attr_e('Signup');
    ?>" /></p>
	</form>
	<?php 
}

WordPress Version: 3.7

/**
 * Setup the new site signup
 *
 * @since MU
 *
 * @uses apply_filters() to filter $filtered_results
 * @uses show_blog_form() to display the blog signup form
 * @param string $user_name The username
 * @param string $user_email The user's email address
 * @param string $blogname The site name
 * @param string $blog_title The site title
 * @param array $errors
 */
function signup_blog($user_name = '', $user_email = '', $blogname = '', $blog_title = '', $errors = '')
{
    if (!is_wp_error($errors)) {
        $errors = new WP_Error();
    }
    $signup_blog_defaults = array('user_name' => $user_name, 'user_email' => $user_email, 'blogname' => $blogname, 'blog_title' => $blog_title, 'errors' => $errors);
    /**
     * Filter the default site creation variables for the site sign-up form.
     *
     * @since 3.0.0
     *
     * @param array $signup_blog_defaults {
     *     An array of default site creation variables.
     *
     *     @type string $user_name  The user username.
     *     @type string $user_email The user email address.
     *     @type string $blogname   The blogname.
     *     @type string $blog_title The title of the site.
     *     @type array  $errors     An array of possible errors relevant to new site creation variables.
     * }
     */
    $filtered_results = apply_filters('signup_blog_init', $signup_blog_defaults);
    $user_name = $filtered_results['user_name'];
    $user_email = $filtered_results['user_email'];
    $blogname = $filtered_results['blogname'];
    $blog_title = $filtered_results['blog_title'];
    $errors = $filtered_results['errors'];
    if (empty($blogname)) {
        $blogname = $user_name;
    }
    ?>
	<form id="setupform" method="post" action="wp-signup.php">
		<input type="hidden" name="stage" value="validate-blog-signup" />
		<input type="hidden" name="user_name" value="<?php 
    echo esc_attr($user_name);
    ?>" />
		<input type="hidden" name="user_email" value="<?php 
    echo esc_attr($user_email);
    ?>" />
		<?php 
    /** This action is documented in wp-signup.php */
    do_action('signup_hidden_fields', 'validate-site');
    ?>
		<?php 
    show_blog_form($blogname, $blog_title, $errors);
    ?>
		<p class="submit"><input type="submit" name="submit" class="submit" value="<?php 
    esc_attr_e('Signup');
    ?>" /></p>
	</form>
	<?php 
}