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

Timestamp:

10/04/2015 01:47:36 PM (9 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-core/bp-core-template.php (modified) (3 diffs)

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

@@ -2553 +2553 @@
  */
 function bp_is_group_activity() {
-    return (bool) ( bp_is_single_item() && bp_is_groups_component() && bp_is_current_action( 'activity' ) );
+    $retval = false;
+
+    if ( bp_is_single_item() && bp_is_groups_component() && bp_is_current_action( 'activity' ) ) {
+        $retval = true;
+    }
+
+    if ( bp_is_group_home() && bp_is_active( 'activity' ) && ! bp_is_group_custom_front() ) {
+        $retval = true;
+    }
+
+    return $retval;
 }
 
@@ -2586 +2596 @@
  */
 function bp_is_group_members() {
-    return (bool) ( bp_is_single_item() && bp_is_groups_component() && bp_is_current_action( 'members' ) );
+    $retval = false;
+
+    if ( bp_is_single_item() && bp_is_groups_component() && bp_is_current_action( 'members' ) ) {
+        $retval = true;
+    }
+
+    if ( bp_is_group_home() && ! bp_is_active( 'activity' ) && ! bp_is_group_custom_front() ) {
+        $retval = true;
+    }
+
+    return $retval;
 }
 
@@ -2631 +2651 @@
 function bp_is_group_single() {
     return (bool) ( bp_is_groups_component() && bp_is_single_item() );
+}
+
+/**
+ * Is the current group page a custom front?
+ *
+ * @since 2.4.0
+ *
+ * @return bool True if the current group page is a custom front.
+ */
+function bp_is_group_custom_front() {
+    $bp = buddypress();
+    return (bool) bp_is_group_home() && ! empty( $bp->groups->current_group->front_template );
 }