?HAMA

Navigation

Breadcrumbs

/ / home / nshryvcy / blissfulnepal.com / wp-content / plugins / wordpress-seo / src / helpers

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.42 KB

/home/nshryvcy/blissfulnepal.com/wp-content/plugins/wordpress-seo/src/helpers/post-helper.php

Text Base64

<?php

namespace Yoast\WP\SEO\Helpers;

use WP_Post;
use Yoast\WP\SEO\Repositories\Indexable_Repository;

/**
 * A helper object for post related things.
 */
class Post_Helper {

/**
	 * Holds the String_Helper instance.
	 *
	 * @var String_Helper
	 */
	private $string;

/**
	 * Holds the Post_Type_Helper instance.
	 *
	 * @var Post_Type_Helper
	 */
	private $post_type;

/**
	 * Represents the indexables repository.
	 *
	 * @var Indexable_Repository
	 */
	private $repository;

/**
	 * Post_Helper constructor.
	 *
	 * @codeCoverageIgnore It only sets dependencies.
	 *
	 * @param String_Helper    $string_helper    The string helper.
	 * @param Post_Type_Helper $post_type_helper The string helper.
	 */
	public function __construct( String_Helper $string_helper, Post_Type_Helper $post_type_helper ) {
		$this->string    = $string_helper;
		$this->post_type = $post_type_helper;
	}

/**
	 * Sets the indexable repository. Done to avoid circular dependencies.
	 *
	 * @required
	 *
	 * @param Indexable_Repository $repository The indexable repository.
	 *
	 * @return void
	 */
	public function set_indexable_repository( Indexable_Repository $repository ) {
		$this->repository = $repository;
	}

/**
	 * Removes all shortcode tags from the given content.
	 *
	 * @codeCoverageIgnore It only wraps a WordPress function.
	 *
	 * @param string $content Content to remove all the shortcode tags from.
	 *
	 * @return string Content without shortcode tags.
	 */
	public function strip_shortcodes( $content ) {
		return \strip_shortcodes( $content );
	}

/**
	 * Retrieves the post excerpt (without tags).
	 *
	 * @codeCoverageIgnore It only wraps another helper method.
	 *
	 * @param int $post_id Post ID.
	 *
	 * @return string Post excerpt (without tags).
	 */
	public function get_the_excerpt( $post_id ) {
		return $this->string->strip_all_tags( \get_the_excerpt( $post_id ) );
	}

/**
	 * Retrieves the post type of the current post.
	 *
	 * @codeCoverageIgnore It only wraps a WordPress function.
	 *
	 * @param WP_Post|null $post The post.
	 *
	 * @return string|false Post type on success, false on failure.
	 */
	public function get_post_type( $post = null ) {
		return \get_post_type( $post );
	}

/**
	 * Retrieves the post title with fallback to `No title`.
	 *
	 * @param int $post_id Optional. Post ID.
	 *
	 * @return string The post title with fallback to `No title`.
	 */
	public function get_post_title_with_fallback( $post_id = 0 ) {
		$post_title = \get_the_title( $post_id );
		if ( $post_title ) {
			return $post_title;
		}

return \__( 'No title', 'wordpress-seo' );
	}

/**
	 * Retrieves post data given a post ID.
	 *
	 * @codeCoverageIgnore It wraps a WordPress function.
	 *
	 * @param int $post_id Post ID.
	 *
	 * @return WP_Post|null The post.
	 */
	public function get_post( $post_id ) {
		return \get_post( $post_id );
	}

/**
	 * Updates the has_public_posts field on attachments for a post_parent.
	 *
	 * An attachment is represented by their post parent when:
	 * - The attachment has a post parent.
	 * - The attachment inherits the post status.
	 *
	 * @codeCoverageIgnore It relies too much on dependencies.
	 *
	 * @param int $post_parent      Post ID.
	 * @param int $has_public_posts Whether the parent is public.
	 *
	 * @return bool Whether the update was successful.
	 */
	public function update_has_public_posts_on_attachments( $post_parent, $has_public_posts ) {
		$query = $this->repository->query()
			->select( 'id' )
			->where( 'object_type', 'post' )
			->where( 'object_sub_type', 'attachment' )
			->where( 'post_status', 'inherit' )
			->where( 'post_parent', $post_parent );

if ( $has_public_posts !== null ) {
			$query->where_raw( '( has_public_posts IS NULL OR has_public_posts <> %s )', [ $has_public_posts ] );
		}
		else {
			$query->where_not_null( 'has_public_posts' );
		}
		$results = $query->find_array();

if ( empty( $results ) ) {
			return true;
		}

$updated = $this->repository->query()
			->set( 'has_public_posts', $has_public_posts )
			->where_id_in( \wp_list_pluck( $results, 'id' ) )
			->update_many();

return $updated !== false;
	}

/**
	 * Determines if the post can be indexed.
	 *
	 * @param int $post_id Post ID to check.
	 *
	 * @return bool True if the post can be indexed.
	 */
	public function is_post_indexable( $post_id ) {
		// Don't index posts which are not public (i.e. viewable).
		$post_type = \get_post_type( $post_id );

if ( ! $this->post_type->is_of_indexable_post_type( $post_type ) ) {
			return false;
		}

// Don't index excluded post statuses.
		if ( \in_array( \get_post_status( $post_id ), $this->get_excluded_post_statuses(), true ) ) {
			return false;
		}

// Don't index revisions of posts.
		if ( \wp_is_post_revision( $post_id ) ) {
			return false;
		}

// Don't index autosaves that are not caught by the auto-draft check.
		if ( \wp_is_post_autosave( $post_id ) ) {
			return false;
		}

return true;
	}

/**
	 * Retrieves the list of excluded post statuses.
	 *
	 * @return array The excluded post statuses.
	 */
	public function get_excluded_post_statuses() {
		return [ 'auto-draft' ];
	}

/**
	 * Retrieves the list of public posts statuses.
	 *
	 * @return array The public post statuses.
	 */
	public function get_public_post_statuses() {
		/**
		 * Filter: 'wpseo_public_post_statuses' - List of public post statuses.
		 *
		 * @param array $post_statuses Post status list, defaults to array( 'publish' ).
		 */
		return \apply_filters( 'wpseo_public_post_statuses', [ 'publish' ] );
	}
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 3 × Files: 48

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
open-graph DIR	-	drwxr-xr-x	2026-06-03 14:57:42	Edit Download recursive recursive
schema DIR	-	drwxr-xr-x	2026-06-03 14:57:42	Edit Download recursive recursive
twitter DIR	-	drwxr-xr-x	2026-06-03 14:57:42	Edit Download recursive recursive
aioseo-helper.php	1.24 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
asset-helper.php	2.51 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
attachment-cleanup-helper.php	2.24 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
author-archive-helper.php	5.25 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
blocks-helper.php	2.32 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
capability-helper.php	2.07 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
crawl-cleanup-helper.php	8.10 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
curl-helper.php	655 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
current-page-helper.php	15.63 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
date-helper.php	3.13 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
environment-helper.php	793 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
first-time-configuration-notice-helper.php	5.36 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
home-url-helper.php	681 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
image-helper.php	11.69 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
import-cursor-helper.php	1.36 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
import-helper.php	716 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
indexable-helper.php	9.24 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
indexable-to-postmeta-helper.php	6.75 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
indexing-helper.php	12.69 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
language-helper.php	2.65 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
lock-helper.php	2.84 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
meta-helper.php	2.91 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
notification-helper.php	2.01 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
options-helper.php	4.65 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
pagination-helper.php	5.68 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
permalink-helper.php	1.60 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
post-helper.php	5.42 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
post-type-helper.php	7.18 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
primary-term-helper.php	1.37 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
product-helper.php	1.08 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
redirect-helper.php	1.73 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
require-file-helper.php	326 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
robots-helper.php	1.74 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
robots-txt-helper.php	3.40 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
route-helper.php	694 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
sanitization-helper.php	1.03 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
score-icon-helper.php	2.78 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
short-link-helper.php	3.52 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
site-helper.php	566 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
social-profiles-helper.php	10.73 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
string-helper.php	1.19 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
taxonomy-helper.php	4.98 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
url-helper.php	8.13 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
user-helper.php	3.93 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
wincher-helper.php	2.51 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
woocommerce-helper.php	1.27 KB	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
wordpress-helper.php	512 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive
wpdb-helper.php	937 B	lrw-r--r--	2026-06-03 14:57:42	Edit Download recursive recursive