class-wp-curate.php

<?php
/**
 * WP_Curate class file
 *
 * @package wp-curate
 */

namespace Alley\WP\WP_Curate;

/**
 * WP_Curate class.
 */
class WP_Curate {
	/**
	 * Set things up.
	 */
	public function __construct() {
		add_filter( 'rest_post_query', [ $this, 'add_type_param' ], 10, 2 );
	}

	/**
	 * Add post_type to rest post query if the type param is set.
	 *
	 * @param array<array<int, string>|string> $query_args The existing query args.
	 * @param \WP_REST_Request                 $request The REST request.
	 * @return array<array<int, string>|string>
	 */
	public function add_type_param( $query_args, $request ): array { // @phpstan-ignore-line
		if ( ! empty( $request->get_param( 'type' ) ) && is_string( $request->get_param( 'type' ) ) ) {
			$types                   = explode( ',', $request->get_param( 'type' ) );
			$types                   = array_filter( $types, 'post_type_exists' );
			$query_args['post_type'] = $types;
		}
		return $query_args;
	}

	/**
	 * Get the query heading based on the curation settings.
	 *
	 * @param array<mixed> $curation Curation settings.
	 * @return string Query heading.
	 */
	public static function get_query_heading( array $curation ): string {
		$heading  = '';
		$provider = $curation[ 'provider' ];

		if ( taxonomy_exists( $provider ) && isset( $curation[ $provider ] ) && is_numeric( $curation[ $provider ] ) ) { // @phpstan-ignore-line
			$term = get_term( $curation[ $provider ], $provider ); // @phpstan-ignore-line

			if ( $term instanceof \WP_Term ) {
				$heading = html_entity_decode( $term->name );
			}
		}

		/**
		 * Filters the query heading.
		 *
		 * @param string $heading  Default heading.
		 * @param array  $curation Curation settings.
		 */
		$heading = apply_filters( 'wp_curate_query_heading', $heading, $curation );

		return $heading;
	}
}