Changeset 4183

Timestamp:

04/09/2011 05:32:00 PM (15 years ago)

Author:

boonebgorges

Message:

Adds warning notices to Dashboard when required BP component directory pages are missing. Fixes #3026. Adds warning notices to Dashboard when bp-pages are present but the corresponding component is deactivated. Fixes #3025. Removes root_slug declaration from components that should not have top-level directories.

Location:

trunk

Files:

• bp-core/admin/bp-core-admin.php (modified) (3 diffs)
• bp-core/bp-core-functions.php (modified) (7 diffs)
• bp-friends/bp-friends-loader.php (modified) (2 diffs)
• bp-messages/bp-messages-loader.php (modified) (1 diff)
• bp-settings/bp-settings-loader.php (modified) (1 diff)

trunk/bp-core/admin/bp-core-admin.php

@@ -359 +359 @@
         <h3><?php _e( 'Directory Pages', 'buddypress' ); ?></h3>
         
-        <p><?php _e( 'Choose a WordPress Page to associate with each BuddyPress component directory. Setting to "None" will render that page inaccessible.', 'buddypress' ); ?></p>
+        <p><?php _e( 'Choose a WordPress Page to associate with each BuddyPress component directory. Deactivated components should be set to "None".', 'buddypress' ); ?></p>
 
         <table class="form-table">
@@ -365 +365 @@
 
                         <?php foreach ( $directory_pages as $name => $label ) : ?>
-
-                                <?php if ( bp_is_active( $name ) ) : ?>
-
-                                        <tr valign="top">
-                                                <th scope="row">
-                                                        <label for="bp_pages[<?php echo esc_attr( $name ) ?>]"><?php echo esc_html( $label ) ?></label>
-                                                </th>
-
-                                                <td>
-                                                        <?php echo wp_dropdown_pages( array(
-                                                                'name'             => 'bp_pages[' . esc_attr( $name ) . ']',
-                                                                'echo'             => false,
-                                                                'show_option_none' => __( '- None -', 'buddypress' ),
-                                                                'selected'         => !empty( $existing_pages[$name] ) ? $existing_pages[$name] : false
-                                                        ) ) ?>
-                                                </td>
-                                        </tr>
-
-                                <?php endif; ?>
-
-                        <?php endforeach ?>
-
-                        <?php do_action( 'bp_active_external_directories' ); ?>
-
-                </tbody>
-        </table>
-        
-        <?php
-
-        // Static pages
-        $static_pages = array(
-                'register' => __( 'Sign up Page',    'buddypress' ),
-                'activate' => __( 'Activation Page', 'buddypress' ),
-        ); ?>
-
-        <h3><?php _e( 'Other Pages', 'buddypress' ); ?></h3>
-
-        <p><?php _e( 'Associate WordPress Pages with the following BuddyPress pages. Setting to "None" will render that page inaccessible.', 'buddypress' ); ?></p>
-
-        <table class="form-table">
-                <tbody>
-
-                        <?php foreach ( $static_pages as $name => $label ) : ?>
-
+                                <?php $disabled = !bp_is_active( $name ) ? ' disabled="disabled"' : ''; ?>
+                                
                                 <tr valign="top">
                                         <th scope="row">
-                                                <label for="bp_pages[<?php echo esc_attr( $name ) ?>]"><?php echo esc_html( $label ) ?></label>
+                                                <label for="bp_pages[<?php echo esc_attr( $name ) ?>]"><?php echo esc_html( $label ) ?><?php if ( !bp_is_active( $name ) ) : ?> <span class="description">(deactivated)</span><?php endif ?></label>
                                         </th>
 
@@ -424 +382 @@
                                 </tr>
 
+
+                        <?php endforeach ?>
+
+                        <?php do_action( 'bp_active_external_directories' ); ?>
+
+                </tbody>
+        </table>
+        
+        <?php
+
+        // Static pages
+        $static_pages = array(
+                'register' => __( 'Sign up Page',    'buddypress' ),
+                'activate' => __( 'Activation Page', 'buddypress' ),
+        ); ?>
+
+        <h3><?php _e( 'Other Pages', 'buddypress' ); ?></h3>
+
+        <p><?php _e( 'Associate WordPress Pages with the following BuddyPress pages. Setting to "None" will render that page inaccessible.', 'buddypress' ); ?></p>
+
+        <table class="form-table">
+                <tbody>
+
+                        <?php foreach ( $static_pages as $name => $label ) : ?>
+
+                                <tr valign="top">
+                                        <th scope="row">
+                                                <label for="bp_pages[<?php echo esc_attr( $name ) ?>]"><?php echo esc_html( $label ) ?></label>
+                                        </th>
+
+                                        <td>
+                                                <?php echo wp_dropdown_pages( array(
+                                                        'name'             => 'bp_pages[' . esc_attr( $name ) . ']',
+                                                        'echo'             => false,
+                                                        'show_option_none' => __( '- None -', 'buddypress' ),
+                                                        'selected'         => !empty( $existing_pages[$name] ) ? $existing_pages[$name] : false
+                                                ) ) ?>
+                                        </td>
+                                </tr>
+
                         <?php endforeach ?>
 

trunk/bp-core/bp-core-functions.php

@@ -30 +30 @@
  * Stores BP pages in the meta table, depending on setup
  *
+ * bp-pages data is stored in the options table of the root blog, except when BP_ENABLE_MULTIBLOG
+ * is turned on.
+ *
  * @package BuddyPress Core 
+ * @since 1.3
+ *
+ * @param array $page_ids The IDs of the WP pages corresponding to BP component directories
  */
 function bp_core_update_page_meta( $page_ids ) {
@@ -39 +45 @@
 }
 
+/**
+ * Get bp-pages names and slugs
+ *
+ * @package BuddyPress Core
+ * @since 1.3
+ *
+ * @return obj $pages Page names, IDs, and slugs
+ */
 function bp_core_get_page_names() {
         global $wpdb, $bp;
@@ -50 +64 @@
                 $posts_table_name = is_multisite() && !defined( 'BP_ENABLE_MULTIBLOG' ) ? $wpdb->get_blog_prefix( BP_ROOT_BLOG ) . 'posts' : $wpdb->posts;
                 $page_ids_sql     = implode( ',', (array)$page_ids );
-                $page_names       = $wpdb->get_results( $wpdb->prepare( "SELECT ID, post_name, post_parent FROM {$posts_table_name} WHERE ID IN ({$page_ids_sql}) " ) );
+                $page_names       = $wpdb->get_results( $wpdb->prepare( "SELECT ID, post_name, post_parent FROM {$posts_table_name} WHERE ID IN ({$page_ids_sql}) AND post_status = 'publish' " ) );
 
                 foreach ( (array)$page_ids as $key => $page_id ) {
@@ -222 +236 @@
 
 /**
- * When BuddyPress is activated we must make sure that mod_rewrite is enabled.
- * We must also make sure a BuddyPress compatible theme is enabled. This function
- * will show helpful messages to the administrator.
+ * Verify that some BP prerequisites are set up properly, and notify the admin if not
+ *
+ * On every Dashboard page, this function checks the following:
+ *   - that pretty permalinks are enabled
+ *   - that a BP-compatible theme is activated
+ *   - that every BP component that needs a WP page for a directory has one
+ *   - that no directory WP pages are published for deactivated components
+ * The administrator will be shown a notice for each check that fails.
  *
  * @package BuddyPress Core
@@ -231 +250 @@
         global $wp_rewrite, $wpdb, $bp;
 
+        // Only the super admin gets warnings
+        if ( !is_super_admin() )
+                return;
+        
+        // On multisite installs, don't log on a non-root blog
+        if ( !bp_is_root_blog() )
+                return;
+
+        /**
+         * Are pretty permalinks enabled?
+         */
         if ( isset( $_POST['permalink_structure'] ) )
                 return false;
@@ -237 +267 @@
                 bp_core_add_admin_notice( sprintf( __( '<strong>BuddyPress is almost ready</strong>. You must <a href="%s">update your permalink structure</a> to something other than the default for it to work.', 'buddypress' ), admin_url( 'options-permalink.php' ) ) );
         }
-                
+        
+        /**
+         * Are you using a BP-compatible theme?
+         */
+        
         // Get current theme info
         $ct = current_theme_info();
@@ -245 +279 @@
         if ( !defined( 'BP_SILENCE_THEME_NOTICE' ) && !in_array( 'buddypress', (array)$ct->tags ) ) { 
                 bp_core_add_admin_notice( sprintf( __( "You'll need to <a href='%s'>activate a <strong>BuddyPress-compatible theme</strong></a> to take advantage of all of BuddyPress's features. We've bundled a default theme, but you can always <a href='%s'>install some other compatible themes</a> or <a href='%s'>update your existing WordPress theme</a>.", 'buddypress' ), admin_url( 'themes.php' ), network_admin_url( 'theme-install.php?type=tag&s=buddypress&tab=search' ), network_admin_url( 'plugin-install.php?type=term&tab=search&s=%22bp-template-pack%22' ) ) );
+        }
+                
+        /**
+         * Check for orphaned directory pages (BP component is disabled, WP page exists)
+         */
+         
+        $orphaned_pages = array();
+        foreach( $bp->pages as $component_id => $page ) {
+                
+                // Some members of $bp->pages will not have corresponding $bp->{component}, so we
+                // skip them. Plugins can add themselves here if necessary.
+                $exceptions = apply_filters( 'bp_pages_without_components', array( 'register', 'activate' ) );
+                if ( in_array( $component_id, $exceptions ) )
+                        continue;
+                
+                if ( !isset( $bp->{$component_id} ) ) {
+                        // We'll need to get some more information about the page for the notice
+                        $page_data = get_post( $page->id );
+
+                        $orphaned_pages[] = array(
+                                'id'    => $page_data->ID,
+                                'title' => $page_data->post_title
+                        );
+                }
+                
+        }
+        
+        // If orphaned pages are found, post a notice about them.
+        if ( !empty( $orphaned_pages ) ) {
+                
+                // Create the string of links to the Edit Page screen for the pages
+                $edit_pages_links = array();
+                foreach( $orphaned_pages as $op ) {
+                        $edit_pages_links[] = sprintf( '<a href="%1$s">%2$s</a>', admin_url( 'post.php?action=edit&post=' . $op['id'] ), $op['title'] );
+                }
+                
+                $notice = sprintf( __( 'Some of your WordPress pages are linked to BuddyPress components that have been disabled. These pages may continue to show up in your site navigation. Consider <a href="%1$s">reactivating the components</a>, or unpublishing the pages: <strong>%2$s</strong>', 'buddypress' ), network_admin_url( 'admin.php?page=bp-general-settings' ), implode( ', ', $edit_pages_links ) );
+                
+                bp_core_add_admin_notice( $notice );
+        }
+        
+        /**
+         * Check for orphaned BP components (BP component is enabled, no WP page exists)
+         */
+        
+        $orphaned_components = array();
+        $wp_page_components  = array();
+        
+        // Only some BP components require a WP page to function - those with a non-empty root_slug
+        foreach( $bp->active_components as $component_id => $is_active ) {
+                if ( !empty( $bp->{$component_id}->root_slug ) ) {
+                        $wp_page_components[] = array(
+                                'id'    => $component_id,
+                                'name'  => $bp->{$component_id}->name
+                        );
+                }
+        }
+        
+        // Activate and Register are special cases. They are not components but they need WP pages.
+        // If user registration is disabled, we can skip this step.
+        if ( isset( $bp->site_options['registration'] ) && ( 'user' == $bp->site_options['registration'] || ( 'all' == $bp->site_options['registration'] ) ) ) {
+                $wp_page_components[] = array(
+                        'id'    => 'activate',
+                        'name'  => __( 'Activate', 'buddypress' )
+                );
+                
+                $wp_page_components[] = array(
+                        'id'    => 'register',
+                        'name'  => __( 'Register', 'buddypress' )
+                );
+        }       
+        
+        foreach( $wp_page_components as $component ) {          
+                if ( !isset( $bp->pages->{$component['id']} ) ) {
+                        $orphaned_components[] = $component['name'];
+                }
+        }
+        
+        if ( !empty( $orphaned_components ) ) {
+                $notice = sprintf( __( 'Some BuddyPress components must be associated with WordPress pages for your site to work properly. The following components are missing their required WP pages: <strong>%1$s</strong>. Visit the <a href="%2$s">BuddyPress Components</a> panel, where you can either deactivate unused components or complete the page setup.', 'buddypress' ), implode( ', ', $orphaned_components ), network_admin_url( 'admin.php?page=bp-general-settings' ) );
+                
+                bp_core_add_admin_notice( $notice );
         }
 }

trunk/bp-friends/bp-friends-loader.php

@@ -62 +62 @@
                         define( 'BP_FRIENDS_SLUG', $this->id );
 
-                // Global tables for messaging component
+                // Global tables for the friends component
                 $global_tables = array(
                         'table_name'      => $bp->table_prefix . 'bp_friends',
@@ -68 +68 @@
                 );
 
-                // All globals for messaging component.
+                // All globals for the friends component.
                 // Note that global_tables is included in this array.
                 $globals = array(
                         'path'                  => BP_PLUGIN_DIR,
                         'slug'                  => BP_FRIENDS_SLUG,
-                        'root_slug'             => isset( $bp->pages->friends->slug ) ? $bp->pages->friends->slug : BP_FRIENDS_SLUG,
                         'search_string'         => __( 'Search Friends...', 'buddypress' ),
                         'notification_callback' => 'friends_format_notifications',

trunk/bp-messages/bp-messages-loader.php

@@ -71 +71 @@
                 $globals = array(
                         'slug'                  => BP_MESSAGES_SLUG,
-                        'root_slug'             => isset( $bp->pages->messages->slug ) ? $bp->pages->messages->slug : BP_MESSAGES_SLUG,
                         'notification_callback' => 'messages_format_notifications',
                         'search_string'         => __( 'Search Messages...', 'buddypress' ),

trunk/bp-settings/bp-settings-loader.php

@@ -49 +49 @@
                         define( 'BP_SETTINGS_SLUG', $this->id );
 
-                // All globals for messaging component.
-                // Note that global_tables is included in this array.
+                // All globals for settings component.
                 $globals = array(
                         'slug'      => BP_SETTINGS_SLUG,
-                        'root_slug' => isset( $bp->pages->settings->slug ) ? $bp->pages->settings->slug : BP_SETTINGS_SLUG,
                 );