bp_core_admin_components_options()
Creates reusable markup for component setup on the Components and Pages dashboard panel.
Description Description
Source Source
File: bp-core/admin/bp-core-admin-components.php
function bp_core_admin_components_options() {
// Declare local variables.
$deactivated_components = array();
/**
* Filters the array of available components.
*
* @since 1.5.0
*
* @param mixed $value Active components.
*/
$active_components = apply_filters( 'bp_active_components', bp_get_option( 'bp-active-components' ) );
// The default components (if none are previously selected).
$default_components = array(
'xprofile' => array(
'title' => __( 'Extended Profiles', 'buddypress' ),
'description' => __( 'Customize your community with fully editable profile fields that allow your users to describe themselves.', 'buddypress' )
),
'settings' => array(
'title' => __( 'Account Settings', 'buddypress' ),
'description' => __( 'Allow your users to modify their account and notification settings directly from within their profiles.', 'buddypress' )
),
'notifications' => array(
'title' => __( 'Notifications', 'buddypress' ),
'description' => __( 'Notify members of relevant activity with a toolbar bubble and/or via email, and allow them to customize their notification settings.', 'buddypress' )
),
);
$optional_components = bp_core_admin_get_components( 'optional' );
$required_components = bp_core_admin_get_components( 'required' );
$retired_components = bp_core_admin_get_components( 'retired' );
// Merge optional and required together.
$all_components = $optional_components + $required_components;
// If this is an upgrade from before BuddyPress 1.5, we'll have to convert
// deactivated components into activated ones.
if ( empty( $active_components ) ) {
$deactivated_components = bp_get_option( 'bp-deactivated-components' );
if ( !empty( $deactivated_components ) ) {
// Trim off namespace and filename.
$trimmed = array();
foreach ( array_keys( (array) $deactivated_components ) as $component ) {
$trimmed[] = str_replace( '.php', '', str_replace( 'bp-', '', $component ) );
}
// Loop through the optional components to create an active component array.
foreach ( array_keys( (array) $optional_components ) as $ocomponent ) {
if ( !in_array( $ocomponent, $trimmed ) ) {
$active_components[$ocomponent] = 1;
}
}
}
}
// On new install, set active components to default.
if ( empty( $active_components ) ) {
$active_components = $default_components;
}
// Core component is always active.
$active_components['core'] = $all_components['core'];
$inactive_components = array_diff( array_keys( $all_components ) , array_keys( $active_components ) );
/** Display **************************************************************
*/
// Get the total count of all plugins.
$all_count = count( $all_components );
$page = bp_core_do_network_admin() ? 'settings.php' : 'options-general.php';
$action = !empty( $_GET['action'] ) ? $_GET['action'] : 'all';
switch( $action ) {
case 'all' :
$current_components = $all_components;
break;
case 'active' :
foreach ( array_keys( $active_components ) as $component ) {
$current_components[$component] = $all_components[$component];
}
break;
case 'inactive' :
foreach ( $inactive_components as $component ) {
$current_components[$component] = $all_components[$component];
}
break;
case 'mustuse' :
$current_components = $required_components;
break;
case 'retired' :
$current_components = $retired_components;
break;
} ?>
<h3 class="screen-reader-text"><?php
/* translators: accessibility text */
_e( 'Filter components list', 'buddypress' );
?></h3>
<ul class="subsubsub">
<li><a href="<?php echo esc_url( add_query_arg( array( 'page' => 'bp-components', 'action' => 'all' ), bp_get_admin_url( $page ) ) ); ?>" <?php if ( $action === 'all' ) : ?>class="current"<?php endif; ?>><?php printf( _nx( 'All <span class="count">(%s)</span>', 'All <span class="count">(%s)</span>', $all_count, 'plugins', 'buddypress' ), number_format_i18n( $all_count ) ); ?></a> | </li>
<li><a href="<?php echo esc_url( add_query_arg( array( 'page' => 'bp-components', 'action' => 'active' ), bp_get_admin_url( $page ) ) ); ?>" <?php if ( $action === 'active' ) : ?>class="current"<?php endif; ?>><?php printf( _n( 'Active <span class="count">(%s)</span>', 'Active <span class="count">(%s)</span>', count( $active_components ), 'buddypress' ), number_format_i18n( count( $active_components ) ) ); ?></a> | </li>
<li><a href="<?php echo esc_url( add_query_arg( array( 'page' => 'bp-components', 'action' => 'inactive' ), bp_get_admin_url( $page ) ) ); ?>" <?php if ( $action === 'inactive' ) : ?>class="current"<?php endif; ?>><?php printf( _n( 'Inactive <span class="count">(%s)</span>', 'Inactive <span class="count">(%s)</span>', count( $inactive_components ), 'buddypress' ), number_format_i18n( count( $inactive_components ) ) ); ?></a> | </li>
<li><a href="<?php echo esc_url( add_query_arg( array( 'page' => 'bp-components', 'action' => 'mustuse' ), bp_get_admin_url( $page ) ) ); ?>" <?php if ( $action === 'mustuse' ) : ?>class="current"<?php endif; ?>><?php printf( _n( 'Must-Use <span class="count">(%s)</span>', 'Must-Use <span class="count">(%s)</span>', count( $required_components ), 'buddypress' ), number_format_i18n( count( $required_components ) ) ); ?></a> | </li>
<li><a href="<?php echo esc_url( add_query_arg( array( 'page' => 'bp-components', 'action' => 'retired' ), bp_get_admin_url( $page ) ) ); ?>" <?php if ( $action === 'retired' ) : ?>class="current"<?php endif; ?>><?php printf( _n( 'Retired <span class="count">(%s)</span>', 'Retired <span class="count">(%s)</span>', count( $retired_components ), 'buddypress' ), number_format_i18n( count( $retired_components ) ) ); ?></a></li>
</ul>
<h3 class="screen-reader-text"><?php
/* translators: accessibility text */
_e( 'Components list', 'buddypress' );
?></h3>
<table class="wp-list-table widefat plugins">
<thead>
<tr>
<td id="cb" class="manage-column column-cb check-column"><input id="cb-select-all-1" type="checkbox" <?php checked( empty( $inactive_components ) ); ?>>
<label class="screen-reader-text" for="cb-select-all-1"><?php
/* translators: accessibility text */
_e( 'Enable or disable all optional components in bulk', 'buddypress' );
?></label></td>
<th scope="col" id="name" class="manage-column column-title column-primary"><?php _e( 'Component', 'buddypress' ); ?></th>
<th scope="col" id="description" class="manage-column column-description"><?php _e( 'Description', 'buddypress' ); ?></th>
</tr>
</thead>
<tbody id="the-list">
<?php if ( !empty( $current_components ) ) : ?>
<?php foreach ( $current_components as $name => $labels ) : ?>
<?php if ( !in_array( $name, array( 'core', 'members' ) ) ) :
$class = isset( $active_components[esc_attr( $name )] ) ? 'active' : 'inactive';
else :
$class = 'active';
endif; ?>
<tr id="<?php echo esc_attr( $name ); ?>" class="<?php echo esc_attr( $name ) . ' ' . esc_attr( $class ); ?>">
<th scope="row" class="check-column">
<?php if ( !in_array( $name, array( 'core', 'members' ) ) ) : ?>
<input type="checkbox" id="<?php echo esc_attr( "bp_components[$name]" ); ?>" name="<?php echo esc_attr( "bp_components[$name]" ); ?>" value="1"<?php checked( isset( $active_components[esc_attr( $name )] ) ); ?> /><label for="<?php echo esc_attr( "bp_components[$name]" ); ?>" class="screen-reader-text"><?php
/* translators: accessibility text */
printf( __( 'Select %s', 'buddypress' ), esc_html( $labels['title'] ) ); ?></label>
<?php endif; ?>
</th>
<td class="plugin-title column-primary">
<label for="<?php echo esc_attr( "bp_components[$name]" ); ?>">
<span aria-hidden="true"></span>
<strong><?php echo esc_html( $labels['title'] ); ?></strong>
</label>
</td>
<td class="column-description desc">
<div class="plugin-description">
<p><?php echo $labels['description']; ?></p>
</div>
</td>
</tr>
<?php endforeach ?>
<?php else : ?>
<tr class="no-items">
<td class="colspanchange" colspan="3"><?php _e( 'No components found.', 'buddypress' ); ?></td>
</tr>
<?php endif; ?>
</tbody>
<tfoot>
<tr>
<td class="manage-column column-cb check-column"><input id="cb-select-all-2" type="checkbox" <?php checked( empty( $inactive_components ) ); ?>>
<label class="screen-reader-text" for="cb-select-all-2"><?php
/* translators: accessibility text */
_e( 'Enable or disable all optional components in bulk', 'buddypress' );
?></label></td>
<th class="manage-column column-title column-primary"><?php _e( 'Component', 'buddypress' ); ?></th>
<th class="manage-column column-description"><?php _e( 'Description', 'buddypress' ); ?></th>
</tr>
</tfoot>
</table>
<input type="hidden" name="bp_components[members]" value="1" />
<?php
}
Changelog Changelog
| Version | Description |
|---|---|
| 1.6.0 | Introduced. |