Ticket #7485: 7485.1.diff

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

@@ -962 +962 @@
  *
  * @since 1.0.0
  *
- * @param BP_Groups_Group|null $group Optional. Group object. Default: current group in loop.
+ * @param BP_Groups_Group|null $group     Optional. Group object.
+ *                                        Default: current group in loop.
+ * @param bool                 $html_link Optional. Whether to generate an html
+ *                                        link or just return the URL.
+ *                                        Default: false.
  */
-function bp_group_permalink( $group = null ) {
-        echo bp_get_group_permalink( $group );
+function bp_group_permalink( $group = null, $html_link = false ) {
+        echo bp_get_group_permalink( $group, $html_link );
 }
         /**
          * Return the permalink for the current group in the loop.
          *
          * @since 1.0.0
          *
-         * @param BP_Groups_Group|null $group Optional. Group object. Default: current group in loop.
+         * @param BP_Groups_Group|null $group     Optional. Group object.
+         *                                        Default: current group in loop.
+         * @param bool                 $html_link Optional. Whether to generate an
+         *                                        html link or just return the URL.
+         *                                        Default: false.
          * @return string
          */
-        function bp_get_group_permalink( $group = null ) {
+        function bp_get_group_permalink( $group = null, $html_link = false ) {
                 global $groups_template;
 
                 if ( empty( $group ) ) {
@@ -991 +999 @@
                  * @param string $value Permalink for the current group in the loop.
                  * @param object $group Group object.
                  */
-                return apply_filters( 'bp_get_group_permalink', trailingslashit( bp_get_groups_directory_permalink() . bp_get_group_slug( $group ) . '/' ), $group );
+                $permalink = apply_filters( 'bp_get_group_permalink', trailingslashit( bp_get_groups_directory_permalink() . bp_get_group_slug( $group ) . '/' ), $group );
+
+                if ( $html_link ) {
+                        $permalink = sprintf(
+                                '<a href="%s">%s</a>',
+                                esc_url( bp_get_group_permalink( $group ) ),
+                                esc_html( bp_get_group_name( $group ) )
+                        );
+
+                        /**
+                         * Filters the html version of the permalink for the current group in the loop.
+                         *
+                         * @since 2.9.0
+                         *
+                         * @param string $value HTML permalink for the current group in the loop.
+                         * @param object $group Group object.
+                         */
+                        $permalink = apply_filters( 'bp_get_group_permalink_html', $permalink, $group );
+                }
+
+                return $permalink;
         }
 
 /**