Post representation: bring back the activitypub_post_locale filter (#1367)

It was removed in #593, but is still neeeded to customize the language of a given post. The filter is used in the WPML integration of this plugin, for example.

Co-authored-by: Matthias Pfefferle <[email protected]>

Author: jeherve

CHANGELOG.md

@@ -37,6 +37,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * Send Update-Activity when "Actor-Mode" is changed.
 * Added delay to `Announce` Activity from the Blog-Actor, to not have race conditions.
 * `Actor` validation in several REST API endpoints.
+* Bring back the `activitypub_post_locale` filter to allow overriding the post's locale.
 
 ## [5.2.0] - 2025-02-13
 

includes/transformer/class-post.php

@@ -77,6 +77,33 @@ public function get_content_visibility() {
 		return $this->content_visibility;
 	}
 
+	/**
+	 * Get the post's locale.
+	 * By default, the post's locale is the same as the blog's locale,
+	 * and is already set in the parent class's get_locale() method.
+	 * This method allows for overriding the locale for a specific post,
+	 * via a `activitypub_post_locale` filter.
+	 *
+	 * @return string The post's locale.
+	 */
+	public function get_locale() {
+		/**
+		 * Filter the locale of the post.
+		 *
+		 * @param string  $lang    The locale of the post.
+		 * @param int     $post_id The post ID.
+		 * @param WP_Post $post    The post object.
+		 *
+		 * @return string The filtered locale of the post.
+		 */
+		return apply_filters(
+			'activitypub_post_locale',
+			parent::get_locale(),
+			$this->item->ID,
+			$this->item
+		);
+	}
+
 	/**
 	 * Returns the User-Object of the Author of the Post.
 	 *

readme.txt

@@ -154,6 +154,7 @@ For reasons of data protection, it is not possible to see the followers of other
 * Fixed: Send Update-Activity when "Actor-Mode" is changed.
 * Fixed: Added delay to `Announce` Activity from the Blog-Actor, to not have race conditions.
 * Fixed: `Actor` validation in several REST API endpoints.
+* Fixed: Bring back the `activitypub_post_locale` filter to allow overriding the post's locale.
 
 = 5.2.0 =