Changeset 10474 for trunk/src/bp-core/bp-core-admin.php

Timestamp:

01/27/2016 08:23:37 PM (10 years ago)

Author:

djpaul

Message:

Emails: add post type and taxonomy, and supporting wp-admin customisations.

All of BuddyPress' emails have been moved into email posts. The change includes an installation routine, but this won't be run until the db_version number is bumped in a subsequent commit. Updates to functions using wp_mail will also follow.

Tokens are used to personalise the email content (e.g. to add a link to the recipient’s user profile). Each type of email in BuddyPress has been assigned a unique type, and these are mapped to the email post through a new "email type" taxonomy.

The change includes a new HTML email template based on work by Ted Goas and contributors from the Cerberus email templates project. Ted, thank you very much. Learn more at ​http://tedgoas.github.io/Cerberus/

See #6592. Props timersys, mercime, boonebgorges, hnla, DJPaul.

File:

• trunk/src/bp-core/bp-core-admin.php (modified) (5 diffs)

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

@@ -117 +117 @@
      */
     private function includes() {
+        require( $this->admin_dir . 'bp-core-admin-classes.php'    );
         require( $this->admin_dir . 'bp-core-admin-actions.php'    );
         require( $this->admin_dir . 'bp-core-admin-settings.php'   );
@@ -175 +176 @@
         add_filter( 'ms_user_row_actions', 'bp_core_admin_user_row_actions', 10, 2 );
         add_filter( 'user_row_actions',    'bp_core_admin_user_row_actions', 10, 2 );
+
+        // Emails
+        add_filter( 'bp_admin_menu_order', array( $this, 'emails_admin_menu_order' ), 20 );
     }
 
@@ -296 +300 @@
         );
 
-        // Fudge the highlighted subnav item when on a BuddyPress admin page.
+        $hooks[] = add_theme_page(
+            _x( 'Emails', 'screen heading', 'buddypress' ),
+            _x( 'Emails', 'screen heading', 'buddypress' ),
+            $this->capability,
+            'bp-emails-customizer-redirect',
+            'bp_email_redirect_to_customizer'
+        );
+
         foreach( $hooks as $hook ) {
             add_action( "admin_head-$hook", 'bp_core_modify_admin_menu_highlight' );
@@ -768 +779 @@
                 <a href="https://bbpress.org">bbPress</a>,
                 <a href="https://github.com/ichord/Caret.js">Caret.js</a>,
+                <a href="http://tedgoas.github.io/Cerberus/">Cerberus</a>,
                 <a href="https://github.com/carhartl/jquery-cookie">jquery.cookie</a>,
                 <a href="https://www.mediawiki.org/wiki/MediaWiki">MediaWiki</a>,
@@ -874 +886 @@
         // Done!
         return $display;
+    }
+
+    /**
+     * Add Emails menu item to custom menus array.
+     *
+     * Several BuddyPress components have top-level menu items in the Dashboard,
+     * which all appear together in the middle of the Dashboard menu. This function
+     * adds the Emails screen to the array of these menu items.
+     *
+     * @since 2.4.0
+     *
+     * @param array $custom_menus The list of top-level BP menu items.
+     * @return array $custom_menus List of top-level BP menu items, with Emails added.
+     */
+    public function emails_admin_menu_order( $custom_menus = array() ) {
+        array_push( $custom_menus, 'edit.php?post_type=' . bp_get_email_post_type() );
+        return $custom_menus;
     }