Changeset 10184 for trunk/src/bp-groups/bp-groups-template.php

Timestamp:

10/04/2015 01:47:36 PM (11 years ago)

Author:

imath

Message:

Improve template loading for Groups single items home pages.

• Make sure an activity sub navigation will be generated if the displayed group has a custom front page.
• Make sure no members sub navigation is generated if the activity component is not active and the Group has no custom front. As, in this case the home page of the group is already displaying the members template.
• Make sure some Groups single item conditional tags are behaving the right way:
  • bp_is_group_home() is true when on the home page of the group (eg: site.url/groups/single-group/).
  • bp_is_group_activity() is true when the activity page of the group is displayed. It can be the home page of the group or its activity page (eg: site.url/groups/single-group/activity).
  • bp_is_group_members() is true when the members page of the group is displayed. It can be the home page of the group or its members page (eg: site.url/groups/single-group/members).
• Introduce a new conditional tag: bp_is_group_custom_front() to check if the home page of the group is using a custom front template.
• Introduce a new template tag bp_groups_front_template_part() used to choose the appropriate template to load for the home page of the group (activity, members, or the custom front).
• Introduce a template hierarchy for the buddypress/groups/single/front.php template so that it is possible to have different front pages according to the ID, slug or status of the Group.
• And finally make sure the introduced improvements are back compatible with themes who forgot to update their buddypress/groups/single/home.php and buddypress/activity/post-form.php templates.

Props r-a-y, boonebgorges, DJPaul, and imath :)

Fixes #6388

File:

• trunk/src/bp-groups/bp-groups-template.php (modified) (1 diff)

trunk/src/bp-groups/bp-groups-template.php

@@ -4344 +4344 @@
 
 /**
+ * Output the contents of the current group's home page.
+ *
+ * You should only use this when on a single group page.
+ *
+ * @since 2.4.0
+ */
+function bp_groups_front_template_part() {
+    $located = bp_groups_get_front_template();
+
+    if ( false !== $located ) {
+        $slug = str_replace( '.php', '', $located );
+
+        /**
+         * Let plugins adding an action to bp_get_template_part get it from here
+         *
+         * @param string $slug Template part slug requested.
+         * @param string $name Template part name requested.
+         */
+        do_action( 'get_template_part_' . $slug, $slug, false );
+
+        load_template( $located, true );
+
+    } else if ( bp_is_active( 'activity' ) ) {
+        bp_get_template_part( 'groups/single/activity' );
+
+    } else if ( bp_is_active( 'members'  ) ) {
+        bp_groups_members_template_part();
+    }
+
+    return $located;
+}
+
+/**
+ * Locate a custom group front template if it exists.
+ *
+ * @since 2.4.0
+ *
+ * @param  BP_Groups_Group|null $group Optional. Falls back to current group if not passed.
+ * @return string|bool                 Path to front template on success; boolean false on failure.
+ */
+function bp_groups_get_front_template( $group = null ) {
+    if ( ! is_a( $group, 'BP_Groups_Group' ) ) {
+        $group = groups_get_current_group();
+    }
+
+    if ( ! isset( $group->id ) ) {
+        return false;
+    }
+
+    if ( isset( $group->front_template ) ) {
+        return $group->front_template;
+    }
+
+    $template_names = apply_filters( 'bp_groups_get_front_template', array(
+        'groups/single/front-id-'     . sanitize_file_name( $group->id )     . '.php',
+        'groups/single/front-slug-'   . sanitize_file_name( $group->slug )   . '.php',
+        'groups/single/front-status-' . sanitize_file_name( $group->status ) . '.php',
+        'groups/single/front.php'
+    ) );
+
+    return bp_locate_template( $template_names, false, true );
+}
+
+/**
  * Output the Group members template
  *