);
if ( $_POST ) {
- do_action( 'wpmuadminedit' , '' );
+ /** This action is documented in wp-admin/network/edit.php */
+ do_action( 'wpmuadminedit' );
check_admin_referer( 'siteoptions' );
update_site_option( $option_name, $value );
}
- // Update more options here
+ /**
+ * Fires after the network options are updated.
+ *
+ * @since MU
+ */
do_action( 'update_wpmu_options' );
wp_redirect( add_query_arg( 'updated', 'true', network_admin_url( 'settings.php' ) ) );
?>
<div class="wrap">
- <?php screen_icon('options-general'); ?>
<h2><?php echo esc_html( $title ); ?></h2>
<form method="post" action="settings.php">
<?php wp_nonce_field( 'siteoptions' ); ?>
<h3><?php _e( 'Operational Settings' ); ?></h3>
<table class="form-table">
<tr valign="top">
- <th scope="row"><label for="site_name"><?php _e( 'Network Name' ) ?></label></th>
+ <th scope="row"><label for="site_name"><?php _e( 'Network Title' ) ?></label></th>
<td>
<input name="site_name" type="text" id="site_name" class="regular-text" value="<?php echo esc_attr( $current_site->site_name ) ?>" />
- <br />
- <?php _e( 'What you would like to call this network.' ) ?>
</td>
</tr>
<th scope="row"><label for="admin_email"><?php _e( 'Network Admin Email' ) ?></label></th>
<td>
<input name="admin_email" type="text" id="admin_email" class="regular-text" value="<?php echo esc_attr( get_site_option('admin_email') ) ?>" />
- <br />
- <?php printf( __( 'Registration and support emails will come from this address. An address such as <code>support@%s</code> is recommended.' ), $current_site->domain ); ?>
+ <p class="description">
+ <?php _e( 'This email address will receive notifications. Registration and support emails will also come from this address.' ); ?>
+ </p>
</td>
</tr>
</table>
<label><input name="registration" type="radio" id="registration1" value="none"<?php checked( $reg, 'none') ?> /> <?php _e( 'Registration is disabled.' ); ?></label><br />
<label><input name="registration" type="radio" id="registration2" value="user"<?php checked( $reg, 'user') ?> /> <?php _e( 'User accounts may be registered.' ); ?></label><br />
<label><input name="registration" type="radio" id="registration3" value="blog"<?php checked( $reg, 'blog') ?> /> <?php _e( 'Logged in users may register new sites.' ); ?></label><br />
- <label><input name="registration" type="radio" id="registration4" value="all"<?php checked( $reg, 'all') ?> /> <?php _e( 'Both sites and user accounts can be registered.' ); ?></label><br />
- <?php if ( is_subdomain_install() )
+ <label><input name="registration" type="radio" id="registration4" value="all"<?php checked( $reg, 'all') ?> /> <?php _e( 'Both sites and user accounts can be registered.' ); ?></label>
+ <p class="description">
+ <?php if ( is_subdomain_install() )
_e( 'If registration is disabled, please set <code>NOBLOGREDIRECT</code> in <code>wp-config.php</code> to a URL you will redirect visitors to if they visit a non-existent site.' );
?>
+ </p>
</td>
</tr>
<th scope="row"><label for="illegal_names"><?php _e( 'Banned Names' ) ?></label></th>
<td>
<input name="illegal_names" type="text" id="illegal_names" class="large-text" value="<?php echo esc_attr( implode( " ", (array) get_site_option( 'illegal_names' ) ) ); ?>" size="45" />
- <br />
- <?php _e( 'Users are not allowed to register these sites. Separate names by spaces.' ) ?>
+ <p class="description">
+ <?php _e( 'Users are not allowed to register these sites. Separate names by spaces.' ) ?>
+ </p>
</td>
</tr>
$limited_email_domains = str_replace( ' ', "\n", $limited_email_domains ); ?>
<textarea name="limited_email_domains" id="limited_email_domains" cols="45" rows="5">
<?php echo esc_textarea( $limited_email_domains == '' ? '' : implode( "\n", (array) $limited_email_domains ) ); ?></textarea>
- <br />
- <?php _e( 'If you want to limit site registrations to certain domains. One domain per line.' ) ?>
+ <p class="description">
+ <?php _e( 'If you want to limit site registrations to certain domains. One domain per line.' ) ?>
+ </p>
</td>
</tr>
<td>
<textarea name="banned_email_domains" id="banned_email_domains" cols="45" rows="5">
<?php echo esc_textarea( get_site_option( 'banned_email_domains' ) == '' ? '' : implode( "\n", (array) get_site_option( 'banned_email_domains' ) ) ); ?></textarea>
- <br />
- <?php _e( 'If you want to ban domains from site registrations. One domain per line.' ) ?>
+ <p class="description">
+ <?php _e( 'If you want to ban domains from site registrations. One domain per line.' ) ?>
+ </p>
</td>
</tr>
<td>
<textarea name="welcome_email" id="welcome_email" rows="5" cols="45" class="large-text">
<?php echo esc_textarea( get_site_option( 'welcome_email' ) ) ?></textarea>
- <br />
- <?php _e( 'The welcome email sent to new site owners.' ) ?>
+ <p class="description">
+ <?php _e( 'The welcome email sent to new site owners.' ) ?>
+ </p>
</td>
</tr>
<tr valign="top">
<td>
<textarea name="welcome_user_email" id="welcome_user_email" rows="5" cols="45" class="large-text">
<?php echo esc_textarea( get_site_option( 'welcome_user_email' ) ) ?></textarea>
- <br />
- <?php _e( 'The welcome email sent to new users.' ) ?>
+ <p class="description">
+ <?php _e( 'The welcome email sent to new users.' ) ?>
+ </p>
</td>
</tr>
<tr valign="top">
<td>
<textarea name="first_post" id="first_post" rows="5" cols="45" class="large-text">
<?php echo esc_textarea( get_site_option( 'first_post' ) ) ?></textarea>
- <br />
- <?php _e( 'The first post on a new site.' ) ?>
+ <p class="description">
+ <?php _e( 'The first post on a new site.' ) ?>
+ </p>
</td>
</tr>
<tr valign="top">
<td>
<textarea name="first_page" id="first_page" rows="5" cols="45" class="large-text">
<?php echo esc_textarea( get_site_option( 'first_page' ) ) ?></textarea>
- <br />
- <?php _e( 'The first page on a new site.' ) ?>
+ <p class="description">
+ <?php _e( 'The first page on a new site.' ) ?>
+ </p>
</td>
</tr>
<tr valign="top">
<td>
<textarea name="first_comment" id="first_comment" rows="5" cols="45" class="large-text">
<?php echo esc_textarea( get_site_option( 'first_comment' ) ) ?></textarea>
- <br />
- <?php _e( 'The first comment on a new site.' ) ?>
+ <p class="description">
+ <?php _e( 'The first comment on a new site.' ) ?>
+ </p>
</td>
</tr>
<tr valign="top">
<th scope="row"><label for="first_comment_author"><?php _e( 'First Comment Author' ) ?></label></th>
<td>
<input type="text" size="40" name="first_comment_author" id="first_comment_author" value="<?php echo get_site_option('first_comment_author') ?>" />
- <br />
- <?php _e( 'The author of the first comment on a new site.' ) ?>
+ <p class="description">
+ <?php _e( 'The author of the first comment on a new site.' ) ?>
+ </p>
</td>
</tr>
<tr valign="top">
<th scope="row"><label for="first_comment_url"><?php _e( 'First Comment URL' ) ?></label></th>
<td>
<input type="text" size="40" name="first_comment_url" id="first_comment_url" value="<?php echo esc_attr( get_site_option( 'first_comment_url' ) ) ?>" />
- <br />
- <?php _e( 'The URL for the first comment on a new site.' ) ?>
+ <p class="description">
+ <?php _e( 'The URL for the first comment on a new site.' ) ?>
+ </p>
</td>
</tr>
</table>
<td>
<?php
$menu_perms = get_site_option( 'menu_items' );
+ /**
+ * Filter available network-wide administration menu options.
+ *
+ * Options returned to this filter are output as individual checkboxes that, when selected,
+ * enable site administrator access to the specified administration menu in certain contexts.
+ *
+ * Adding options for specific menus here hinges on the appropriate checks and capabilities
+ * being in place in the site dashboard on the other side. For instance, when the single
+ * default option, 'plugins' is enabled, site administrators are granted access to the Plugins
+ * screen in their individual sites' dashboards.
+ *
+ * @since MU
+ *
+ * @param array $admin_menus The menu items available.
+ */
$menu_items = apply_filters( 'mu_menu_items', array( 'plugins' => __( 'Plugins' ) ) );
foreach ( (array) $menu_items as $key => $val ) {
echo "<label><input type='checkbox' name='menu_items[" . $key . "]' value='1'" . ( isset( $menu_perms[$key] ) ? checked( $menu_perms[$key], '1', false ) : '' ) . " /> " . esc_html( $val ) . "</label><br/>";
</tr>
</table>
- <?php do_action( 'wpmu_options' ); // Add more options here ?>
-
+ <?php
+ /**
+ * Fires at the end of the Network Settings form, before the submit button.
+ *
+ * @since MU
+ */
+ do_action( 'wpmu_options' ); ?>
<?php submit_button(); ?>
</form>
</div>