Add bbPress support (#23)

Author: ethitter

classes/class-init.php

@@ -213,6 +213,7 @@ private function _query_for_ids_to_keep(): void {
 	 */
 	private function _get_query_args_instances(): array {
 		$query_args = [
+			new Query_Args\bbPress(),
 			new Query_Args\CoAuthors_Plus(),
 			new Query_Args\Nav_Menu_Item(),
 			new Query_Args\OEmbed_Cache(),

classes/query-args/class-bbpress.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * Retain recent bbPress replies, along with their topics and forums.
+ *
+ * @package pmc-wp-local-data-cli
+ */
+
+declare( strict_types = 1 );
+
+namespace PMC\WP_Local_Data_CLI\Query_Args;
+
+use PMC\WP_Local_Data_CLI\Query_Args;
+
+/**
+ * Class bbPress.
+ */
+// phpcs:ignore PEAR.NamingConventions.ValidClassName.StartWithCapital, Squiz.Commenting.ClassComment.Missing
+final class bbPress extends Query_Args {
+	/**
+	 * Backfill is not required as we query from replies and use their meta to
+	 * capture the topic and forum.
+	 *
+	 * @var bool
+	 */
+	public static bool $skip_backfill = true;
+
+	/**
+	 * Build array of `WP_Query` arguments used to retrieve IDs to retain.
+	 *
+	 * @return array
+	 */
+	public static function get_query_args(): array {
+		// Short-circuit this handler when reply post type is unknown.
+		if ( ! function_exists( 'bbp_get_reply_post_type' ) ) {
+			return [
+				'post_type'  => 'abcdef0123456789',
+				'date_query' => [
+					[
+						'after' => '+500 years',
+					],
+				],
+			];
+		}
+
+		return [
+			'post_type'  => bbp_get_reply_post_type(),
+			'date_query' => [
+				[
+					'after' => '-1 months',
+				],
+			],
+		];
+	}
+
+	/**
+	 * Gather reply's parent objects.
+	 *
+	 * @param int    $id        Post ID.
+	 * @param string $post_type Post type of given ID.
+	 * @return array
+	 */
+	// Declaration must be compatible with overridden method.
+	// phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundInExtendedClassAfterLastUsed, Squiz.Commenting.FunctionComment.Missing, VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+	public static function get_linked_ids( int $id, string $post_type ): array {
+		$ids = [];
+
+		$ancestors = array_filter(
+			[
+				(int) get_post_meta( $id, '_bbp_topic_id', true ),
+				(int) get_post_meta( $id, '_bbp_forum_id', true ),
+			]
+		);
+
+		foreach ( $ancestors as $ancestor ) {
+			$ids[] = [
+				'ID'        => $ancestor,
+				'post_type' => get_post_type( $ancestor ),
+			];
+		}
+
+		return $ids;
+	}
+}