Changeset 14152

Timestamp:

12/16/2025 05:15:31 PM (5 hours ago)

Author:

espellcaste

Message:

Add pre-filter hook for avatar history.

Add bp_pre_avatar_get_avatars_history filter to allow short-circuiting avatar history retrieval.
Fix typo @parma to @param in bp_core_avatar_handle_upload docblock.

Props GaryJ.

Closes ​https://github.com/buddypress/buddypress/pull/426/
Fixes #9311 (trunk)

Location:

trunk/src/bp-core

Files:

• bp-core-attachments.php (modified) (1 diff)
• bp-core-avatars.php (modified) (3 diffs)

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

@@ -724 +724 @@
     // Enqueue me just once per page, please.
     if ( did_action( 'bp_attachments_enqueue_scripts' ) ) {
-        return;
+        return null;
     }
 

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

@@ -973 +973 @@
      * Filters whether or not to handle uploading.
      *
-     * If you want to override this function, make sure you return false.
+     * If you want to override this function, make sure you return `false`.
      *
      * @since 1.2.4
      *
-     * @param bool   $value             Whether or not to crop.
+     * @param bool   $pre_filter        Whether or not to crop. Defaults to true.
      * @param array  $file              Appropriate entry from $_FILES superglobal.
-     * @parma string $upload_dir_filter A filter to be applied to 'upload_dir'.
+     * @param string $upload_dir_filter A filter to be applied to 'upload_dir'.
      */
     if ( ! apply_filters( 'bp_core_pre_avatar_handle_upload', true, $file, $upload_dir_filter ) ) {
@@ -2224 +2224 @@
      *
      * @param bool $avatar_history True to disable avatar history. False otherwise.
-     *                    Default: `false`.
+     *                             Default: `false`.
      */
     return apply_filters( 'bp_disable_avatar_history', false );
@@ -2276 +2276 @@
  */
 function bp_avatar_get_avatars_history( $item_id = 0, $object = 'user', $type = 'full' ) {
+    /**
+     * Filter to short-circuit the avatars history retrieval process.
+     *
+     * If you want to override this function, make sure you return something other than `null`.
+     *
+     * @since 14.5.0
+     *
+     * @param null|array $pre_filter Null to proceed with the default handling, or an array of avatars to override it.
+     * @param int        $item_id    The item ID we need the avatar version for.
+     * @param string     $object     The object the item ID relates to.
+     * @param string     $type       Get the `full`, `thumb` or `both` versions.
+     */
+    $pre_filter = apply_filters( 'bp_pre_avatar_get_avatars_history', null, $item_id, $object, $type );
+
+    if ( null !== $pre_filter ) {
+        return $pre_filter;
+    }
+
     if ( ! $item_id ) {
         return array();