Changeset 14164

Timestamp:

12/23/2025 02:18:42 AM (3 months ago)

Author:

espellcaste

Message:

bp_get_blog_latest_post() make use of the the_title filter hook but only one param is provided.

We are introducing two new getters for the latest post ID. bp_get_blog_latest_post_id and bp_blog_latest_post_id.

Developed in ​https://github.com/buddypress/buddypress/pull/411

Props shawfactor, rollybueno, and dcavins.

See #9286 (14.0).

File:

• branches/14.0/src/bp-blogs/bp-blogs-template.php (modified) (10 diffs)

branches/14.0/src/bp-blogs/bp-blogs-template.php

@@ -490 +490 @@
     }
 
+/**
+ * Output the permalink of the current blog in the loop.
+ *
+ * @since 1.0.0
+ */
 function bp_blog_permalink() {
     echo esc_url( bp_get_blog_permalink() );
 }
+    /**
+     * Return the permalink of the current blog in the loop.
+     *
+     * @since 1.0.0
+     *
+     * @global BP_Blogs_Template $blogs_template The main blog template loop class.
+     *
+     * @return string
+     */
     function bp_get_blog_permalink() {
         global $blogs_template;
@@ -527 +541 @@
      * Return the name of the current blog in the loop.
      *
+     * @global BP_Blogs_Template $blogs_template The main blog template loop class.
+     *
      * @return string The name of the current blog in the loop.
      */
@@ -555 +571 @@
      * @since 1.7.0
      *
+     * @global BP_Blogs_Template $blogs_template The main blog template loop class.
+     *
      * @return int ID of the current blog in the loop.
      */
@@ -586 +604 @@
     /**
      * Return the description of the current blog in the loop.
+     *
+     * @global BP_Blogs_Template $blogs_template The main blog template loop class.
      *
      * @return string Description of the current blog in the loop.
@@ -645 +665 @@
         $classes = array_map( 'sanitize_html_class', apply_filters( 'bp_get_blog_class', $classes ) );
         $classes = array_merge( $classes, array() );
-        $retval  = 'class="' . join( ' ', $classes ) . '"';
-
-        return $retval;
+
+        return 'class="' . join( ' ', $classes ) . '"';
     }
 
@@ -746 +765 @@
         );
 
-        $retval = bp_get_blog_latest_post_title();
+        $retval  = bp_get_blog_latest_post_title();
+        $post_id = bp_get_blog_latest_post_id();
 
         if ( ! empty( $retval ) ) {
@@ -761 +781 @@
                     /* translators: %s: the title of the latest post */
                     __( 'Latest Post: %s', 'buddypress' ),
-                    '<a href="' . $blogs_template->blog->latest_post->guid . '">' . apply_filters( 'the_title', $retval ) . '</a>'
+                    '<a href="' . $blogs_template->blog->latest_post->guid . '">' . apply_filters( 'the_title', $retval, $post_id ) . '</a>'
                 );
             } else {
 
                 /** This filter is documented in bp-blogs/bp-blogs-template.php */
-                $retval = '<a href="' . $blogs_template->blog->latest_post->guid . '">' . apply_filters( 'the_title', $retval ) . '</a>';
+                $retval = '<a href="' . $blogs_template->blog->latest_post->guid . '">' . apply_filters( 'the_title', $retval, $post_id ) . '</a>';
             }
         }
@@ -783 +803 @@
 
 /**
+ * Output the ID of the latest post on the current blog in the loop.
+ *
+ * @since 14.5.0
+ *
+ * @see bp_get_blog_latest_post_id()
+ */
+function bp_blog_latest_post_id() {
+    echo bp_get_blog_latest_post_id();
+}
+    /**
+     * Return the ID of the latest post on the current blog in the loop.
+     *
+     * @since 14.5.0
+     *
+     * @global BP_Blogs_Template $blogs_template The main blog template loop class.
+     *
+     * @return int
+     */
+    function bp_get_blog_latest_post_id() {
+        global $blogs_template;
+
+        $latest_post_id = 0;
+
+        if (
+            ! empty( $blogs_template->blog->latest_post )
+            && ! empty( $blogs_template->blog->latest_post->ID )
+            && is_int( $blogs_template->blog->latest_post->ID )
+        ) {
+            $latest_post_id = $blogs_template->blog->latest_post->ID;
+        }
+
+        /**
+         * Filters the ID of the latest post on the current blog in the loop.
+         *
+         * @since 14.5.0
+         *
+         * @param int $latest_post_id ID of the latest post.
+         */
+        return (int) apply_filters( 'bp_get_blog_latest_post_id', (int) $latest_post_id );
+    }
+
+/**
  * Output the title of the latest post on the current blog in the loop.
  *
@@ -806 +868 @@
         $retval = '';
 
-        if ( ! empty( $blogs_template->blog->latest_post ) && ! empty( $blogs_template->blog->latest_post->post_title ) )
+        if ( ! empty( $blogs_template->blog->latest_post ) && ! empty( $blogs_template->blog->latest_post->post_title ) ) {
             $retval = $blogs_template->blog->latest_post->post_title;
+        }
 
         /**
@@ -834 +897 @@
      * @since 1.7.0
      *
-     * @global BP_Blogs_Template $blogs_template The main blog template loop class.
-     *
      * @return string URL of the blog's latest post.
      */
     function bp_get_blog_latest_post_permalink() {
-        global $blogs_template;
-
-        $retval = '';
-
-        if ( ! empty( $blogs_template->blog->latest_post ) && ! empty( $blogs_template->blog->latest_post->ID ) )
-            $retval = add_query_arg( 'p', $blogs_template->blog->latest_post->ID, bp_get_blog_permalink() );
+        $retval  = '';
+        $post_id = bp_get_blog_latest_post_id();
+
+        if ( ! empty( $post_id ) ) {
+            $retval = add_query_arg( 'p', $post_id, bp_get_blog_permalink() );
+        }
 
         /**