<h2>File Contents: /home/planet5/public_html/wp-includes/rest-api/search/class-wp-rest-post-search-handler.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/rest-api/search/class-wp-rest-post-search-handler.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * REST API: WP_REST_Post_Search_Handler class
 *
 * @package WordPress
 * @subpackage REST_API
 * @since 5.0.0
 */

/**
 * Core class representing a search handler for posts in the REST API.
 *
 * @since 5.0.0
 *
 * @see WP_REST_Search_Handler
 */
class WP_REST_Post_Search_Handler extends WP_REST_Search_Handler {

	/**
	 * Constructor.
	 *
	 * @since 5.0.0
	 */
	public function __construct() {
		$this-&gt;type = &#039;post&#039;;

		// Support all public post types except attachments.
		$this-&gt;subtypes = array_diff(
			array_values(
				get_post_types(
					array(
						&#039;public&#039;       =&gt; true,
						&#039;show_in_rest&#039; =&gt; true,
					),
					&#039;names&#039;
				)
			),
			array( &#039;attachment&#039; )
		);
	}

	/**
	 * Searches posts for a given search request.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full REST request.
	 * @return array {
	 *     Associative array containing found IDs and total count for the matching search results.
	 *
	 *     @type int[] $ids   Array containing the matching post IDs.
	 *     @type int   $total Total count for the matching search results.
	 * }
	 */
	public function search_items( WP_REST_Request $request ) {

		// Get the post types to search for the current request.
		$post_types = $request[ WP_REST_Search_Controller::PROP_SUBTYPE ];
		if ( in_array( WP_REST_Search_Controller::TYPE_ANY, $post_types, true ) ) {
			$post_types = $this-&gt;subtypes;
		}

		$query_args = array(
			&#039;post_type&#039;           =&gt; $post_types,
			&#039;post_status&#039;         =&gt; &#039;publish&#039;,
			&#039;paged&#039;               =&gt; (int) $request[&#039;page&#039;],
			&#039;posts_per_page&#039;      =&gt; (int) $request[&#039;per_page&#039;],
			&#039;ignore_sticky_posts&#039; =&gt; true,
		);

		if ( ! empty( $request[&#039;search&#039;] ) ) {
			$query_args[&#039;s&#039;] = $request[&#039;search&#039;];
		}

		if ( ! empty( $request[&#039;exclude&#039;] ) ) {
			$query_args[&#039;post__not_in&#039;] = $request[&#039;exclude&#039;];
		}

		if ( ! empty( $request[&#039;include&#039;] ) ) {
			$query_args[&#039;post__in&#039;] = $request[&#039;include&#039;];
		}

		/**
		 * Filters the query arguments for a REST API post search request.
		 *
		 * Enables adding extra arguments or setting defaults for a post search request.
		 *
		 * @since 5.1.0
		 *
		 * @param array           $query_args Key value array of query var to query value.
		 * @param WP_REST_Request $request    The request used.
		 */
		$query_args = apply_filters( &#039;rest_post_search_query&#039;, $query_args, $request );

		$query = new WP_Query();
		$posts = $query-&gt;query( $query_args );
		// Querying the whole post object will warm the object cache, avoiding an extra query per result.
		$found_ids = wp_list_pluck( $posts, &#039;ID&#039; );
		$total     = $query-&gt;found_posts;

		return array(
			self::RESULT_IDS   =&gt; $found_ids,
			self::RESULT_TOTAL =&gt; $total,
		);
	}

	/**
	 * Prepares the search result for a given post ID.
	 *
	 * @since 5.0.0
	 *
	 * @param int   $id     Post ID.
	 * @param array $fields Fields to include for the post.
	 * @return array {
	 *     Associative array containing fields for the post based on the `$fields` parameter.
	 *
	 *     @type int    $id    Optional. Post ID.
	 *     @type string $title Optional. Post title.
	 *     @type string $url   Optional. Post permalink URL.
	 *     @type string $type  Optional. Post type.
	 * }
	 */
	public function prepare_item( $id, array $fields ) {
		$post = get_post( $id );

		$data = array();

		if ( in_array( WP_REST_Search_Controller::PROP_ID, $fields, true ) ) {
			$data[ WP_REST_Search_Controller::PROP_ID ] = (int) $post-&gt;ID;
		}

		if ( in_array( WP_REST_Search_Controller::PROP_TITLE, $fields, true ) ) {
			if ( post_type_supports( $post-&gt;post_type, &#039;title&#039; ) ) {
				add_filter( &#039;protected_title_format&#039;, array( $this, &#039;protected_title_format&#039; ) );
				add_filter( &#039;private_title_format&#039;, array( $this, &#039;protected_title_format&#039; ) );
				$data[ WP_REST_Search_Controller::PROP_TITLE ] = get_the_title( $post-&gt;ID );
				remove_filter( &#039;protected_title_format&#039;, array( $this, &#039;protected_title_format&#039; ) );
				remove_filter( &#039;private_title_format&#039;, array( $this, &#039;protected_title_format&#039; ) );
			} else {
				$data[ WP_REST_Search_Controller::PROP_TITLE ] = &#039;&#039;;
			}
		}

		if ( in_array( WP_REST_Search_Controller::PROP_URL, $fields, true ) ) {
			$data[ WP_REST_Search_Controller::PROP_URL ] = get_permalink( $post-&gt;ID );
		}

		if ( in_array( WP_REST_Search_Controller::PROP_TYPE, $fields, true ) ) {
			$data[ WP_REST_Search_Controller::PROP_TYPE ] = $this-&gt;type;
		}

		if ( in_array( WP_REST_Search_Controller::PROP_SUBTYPE, $fields, true ) ) {
			$data[ WP_REST_Search_Controller::PROP_SUBTYPE ] = $post-&gt;post_type;
		}

		return $data;
	}

	/**
	 * Prepares links for the search result of a given ID.
	 *
	 * @since 5.0.0
	 *
	 * @param int $id Item ID.
	 * @return array Links for the given item.
	 */
	public function prepare_item_links( $id ) {
		$post = get_post( $id );

		$links = array();

		$item_route = rest_get_route_for_post( $post );
		if ( ! empty( $item_route ) ) {
			$links[&#039;self&#039;] = array(
				&#039;href&#039;       =&gt; rest_url( $item_route ),
				&#039;embeddable&#039; =&gt; true,
			);
		}

		$links[&#039;about&#039;] = array(
			&#039;href&#039; =&gt; rest_url( &#039;wp/v2/types/&#039; . $post-&gt;post_type ),
		);

		return $links;
	}

	/**
	 * Overwrites the default protected and private title format.
	 *
	 * By default, WordPress will show password protected or private posts with a title of
	 * &quot;Protected: %s&quot; or &quot;Private: %s&quot;, as the REST API communicates the status of a post
	 * in a machine-readable format, we remove the prefix.
	 *
	 * @since 5.0.0
	 *
	 * @return string Title format.
	 */
	public function protected_title_format() {
		return &#039;%s&#039;;
	}

	/**
	 * Attempts to detect the route to access a single item.
	 *
	 * @since 5.0.0
	 * @deprecated 5.5.0 Use rest_get_route_for_post()
	 * @see rest_get_route_for_post()
	 *
	 * @param WP_Post $post Post object.
	 * @return string REST route relative to the REST base URI, or empty string if unknown.
	 */
	protected function detect_rest_item_route( $post ) {
		_deprecated_function( __METHOD__, &#039;5.5.0&#039;, &#039;rest_get_route_for_post()&#039; );

		return rest_get_route_for_post( $post );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Frest-api%2Fsearch'>⬅ Back to Directory</a>