Your IP : 216.73.216.162
home/xbodynamge/lebauwcentre/wp-content/plugins/wordpress-seo/src/helpers/image-helper.php 0000644 00000024512 15111767415 0026221 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers;
use WPSEO_Image_Utils;
use Yoast\WP\SEO\Models\SEO_Links;
use Yoast\WP\SEO\Repositories\Indexable_Repository;
/**
* A helper object for images.
*/
class Image_Helper {
/**
* Image types that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_types = [ 'image/jpeg', 'image/gif', 'image/png', 'image/webp' ];
/**
* Image extensions that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_extensions = [ 'jpeg', 'jpg', 'gif', 'png', 'webp' ];
/**
* Represents the indexables repository.
*
* @var Indexable_Repository
*/
protected $indexable_repository;
/**
* The options helper.
*
* @var Options_Helper
*/
private $options_helper;
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url_helper;
/**
* Image_Helper constructor.
*
* @param Indexable_Repository $indexable_repository The indexable repository.
* @param Options_Helper $options The options helper.
* @param Url_Helper $url_helper The URL helper.
*/
public function __construct(
Indexable_Repository $indexable_repository,
Options_Helper $options,
Url_Helper $url_helper
) {
$this->indexable_repository = $indexable_repository;
$this->options_helper = $options;
$this->url_helper = $url_helper;
}
/**
* Determines whether or not the wanted attachment is considered valid.
*
* @param int $attachment_id The attachment ID to get the attachment by.
*
* @return bool Whether or not the attachment is valid.
*/
public function is_valid_attachment( $attachment_id ) {
if ( ! \wp_attachment_is_image( $attachment_id ) ) {
return false;
}
$post_mime_type = \get_post_mime_type( $attachment_id );
if ( $post_mime_type === false ) {
return false;
}
return $this->is_valid_image_type( $post_mime_type );
}
/**
* Checks if the given extension is a valid extension
*
* @param string $image_extension The image extension.
*
* @return bool True when valid.
*/
public function is_extension_valid( $image_extension ) {
return \in_array( $image_extension, static::$valid_image_extensions, true );
}
/**
* Determines whether the passed mime type is a valid image type.
*
* @param string $mime_type The detected mime type.
*
* @return bool Whether or not the attachment is a valid image type.
*/
public function is_valid_image_type( $mime_type ) {
return \in_array( $mime_type, static::$valid_image_types, true );
}
/**
* Retrieves the image source for an attachment.
*
* @param int $attachment_id The attachment.
* @param string $image_size The image size to retrieve.
*
* @return string The image url or an empty string when not found.
*/
public function get_attachment_image_source( $attachment_id, $image_size = 'full' ) {
$attachment = \wp_get_attachment_image_src( $attachment_id, $image_size );
if ( ! $attachment ) {
return '';
}
return $attachment[0];
}
/**
* Retrieves the ID of the featured image.
*
* @param int $post_id The post id to get featured image id for.
*
* @return int|bool ID when found, false when not.
*/
public function get_featured_image_id( $post_id ) {
if ( ! \has_post_thumbnail( $post_id ) ) {
return false;
}
return \get_post_thumbnail_id( $post_id );
}
/**
* Gets the image url from the content.
*
* @param int $post_id The post id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_post_content_image( $post_id ) {
$image_url = $this->get_first_usable_content_image_for_post( $post_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Gets the first image url of a gallery.
*
* @param int $post_id Post ID to use.
*
* @return string The image url or an empty string when not found.
*/
public function get_gallery_image( $post_id ) {
$post = \get_post( $post_id );
if ( \strpos( $post->post_content, '[gallery' ) === false ) {
return '';
}
$images = \get_post_gallery_images( $post );
if ( empty( $images ) ) {
return '';
}
return \reset( $images );
}
/**
* Gets the image url from the term content.
*
* @param int $term_id The term id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_term_content_image( $term_id ) {
$image_url = $this->get_first_content_image_for_term( $term_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Retrieves the caption for an attachment.
*
* @param int $attachment_id Attachment ID.
*
* @return string The caption when found, empty string when no caption is found.
*/
public function get_caption( $attachment_id ) {
$caption = \wp_get_attachment_caption( $attachment_id );
if ( ! empty( $caption ) ) {
return $caption;
}
$caption = \get_post_meta( $attachment_id, '_wp_attachment_image_alt', true );
if ( ! empty( $caption ) ) {
return $caption;
}
return '';
}
/**
* Retrieves the attachment metadata.
*
* @param int $attachment_id Attachment ID.
*
* @return array The metadata, empty array when no metadata is found.
*/
public function get_metadata( $attachment_id ) {
$metadata = \wp_get_attachment_metadata( $attachment_id );
if ( ! $metadata || ! \is_array( $metadata ) ) {
return [];
}
return $metadata;
}
/**
* Retrieves the attachment image url.
*
* @param int $attachment_id Attachment ID.
* @param string $size The size to get.
*
* @return string The url when found, empty string otherwise.
*/
public function get_attachment_image_url( $attachment_id, $size ) {
$url = \wp_get_attachment_image_url( $attachment_id, $size );
if ( ! $url ) {
return '';
}
return $url;
}
/**
* Find the right version of an image based on size.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id Attachment ID.
* @param string $size Size name.
*
* @return array|false Returns an array with image data on success, false on failure.
*/
public function get_image( $attachment_id, $size ) {
return WPSEO_Image_Utils::get_image( $attachment_id, $size );
}
/**
* Retrieves the best attachment variation for the given attachment.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id The attachment id.
*
* @return bool|string The attachment url or false when no variations found.
*/
public function get_best_attachment_variation( $attachment_id ) {
$variations = WPSEO_Image_Utils::get_variations( $attachment_id );
$variations = WPSEO_Image_Utils::filter_usable_file_size( $variations );
// If we are left without variations, there is no valid variation for this attachment.
if ( empty( $variations ) ) {
return false;
}
// The variations are ordered so the first variations is by definition the best one.
return \reset( $variations );
}
/**
* Find an attachment ID for a given URL.
*
* @param string $url The URL to find the attachment for.
*
* @return int The found attachment ID, or 0 if none was found.
*/
public function get_attachment_by_url( $url ) {
// Strip out the size part of an image URL.
$url = \preg_replace( '/(.*)-\d+x\d+\.(jpeg|jpg|png|gif)$/', '$1.$2', $url );
// Don't try to do this for external URLs.
if ( $this->url_helper->get_link_type( $url ) === SEO_Links::TYPE_EXTERNAL ) {
return 0;
}
$indexable = $this->indexable_repository->find_by_permalink( $url );
if ( $indexable && $indexable->object_type === 'post' && $indexable->object_sub_type === 'attachment' ) {
return $indexable->object_id;
}
$post_id = WPSEO_Image_Utils::get_attachment_by_url( $url );
if ( $post_id !== 0 ) {
// Find the indexable, this triggers creating it so it can be found next time.
$this->indexable_repository->find_by_id_and_type( $post_id, 'post' );
}
return $post_id;
}
/**
* Retrieves an attachment ID for an image uploaded in the settings.
*
* Due to self::get_attachment_by_url returning 0 instead of false.
* 0 is also a possibility when no ID is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param string $setting The setting the image is stored in.
*
* @return int|bool The attachment id, or false or 0 if no ID is available.
*/
public function get_attachment_id_from_settings( $setting ) {
return WPSEO_Image_Utils::get_attachment_id_from_settings( $setting );
}
/**
* Based on and image ID return array with the best variation of that image. If it's not saved to the DB, save it to an option.
*
* @param string $setting The setting name. Should be company or person.
*
* @return array|bool Array with image details when the image is found, boolean when it's not found.
*/
public function get_attachment_meta_from_settings( $setting ) {
$image_meta = $this->options_helper->get( $setting . '_meta', false );
if ( ! $image_meta ) {
$image_id = $this->options_helper->get( $setting . '_id', false );
if ( $image_id ) {
// There is not an option to put a URL in an image field in the settings anymore, only to upload it through the media manager.
// This means an attachment always exists, so doing this is only needed once.
$image_meta = $this->get_best_attachment_variation( $image_id );
if ( $image_meta ) {
$this->options_helper->set( $setting . '_meta', $image_meta );
}
}
}
return $image_meta;
}
/**
* Retrieves the first usable content image for a post.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $post_id The post id to extract the images from.
*
* @return string|null
*/
protected function get_first_usable_content_image_for_post( $post_id ) {
return WPSEO_Image_Utils::get_first_usable_content_image_for_post( $post_id );
}
/**
* Gets the term's first usable content image. Null if none is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $term_id The term id.
*
* @return string|null The image URL.
*/
protected function get_first_content_image_for_term( $term_id ) {
return WPSEO_Image_Utils::get_first_content_image_for_term( $term_id );
}
}
home/xbodynamge/www/wp-content/plugins/wordpress-seo/src/helpers/image-helper.php 0000644 00000024512 15113372142 0024354 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers;
use WPSEO_Image_Utils;
use Yoast\WP\SEO\Models\SEO_Links;
use Yoast\WP\SEO\Repositories\Indexable_Repository;
/**
* A helper object for images.
*/
class Image_Helper {
/**
* Image types that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_types = [ 'image/jpeg', 'image/gif', 'image/png', 'image/webp' ];
/**
* Image extensions that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_extensions = [ 'jpeg', 'jpg', 'gif', 'png', 'webp' ];
/**
* Represents the indexables repository.
*
* @var Indexable_Repository
*/
protected $indexable_repository;
/**
* The options helper.
*
* @var Options_Helper
*/
private $options_helper;
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url_helper;
/**
* Image_Helper constructor.
*
* @param Indexable_Repository $indexable_repository The indexable repository.
* @param Options_Helper $options The options helper.
* @param Url_Helper $url_helper The URL helper.
*/
public function __construct(
Indexable_Repository $indexable_repository,
Options_Helper $options,
Url_Helper $url_helper
) {
$this->indexable_repository = $indexable_repository;
$this->options_helper = $options;
$this->url_helper = $url_helper;
}
/**
* Determines whether or not the wanted attachment is considered valid.
*
* @param int $attachment_id The attachment ID to get the attachment by.
*
* @return bool Whether or not the attachment is valid.
*/
public function is_valid_attachment( $attachment_id ) {
if ( ! \wp_attachment_is_image( $attachment_id ) ) {
return false;
}
$post_mime_type = \get_post_mime_type( $attachment_id );
if ( $post_mime_type === false ) {
return false;
}
return $this->is_valid_image_type( $post_mime_type );
}
/**
* Checks if the given extension is a valid extension
*
* @param string $image_extension The image extension.
*
* @return bool True when valid.
*/
public function is_extension_valid( $image_extension ) {
return \in_array( $image_extension, static::$valid_image_extensions, true );
}
/**
* Determines whether the passed mime type is a valid image type.
*
* @param string $mime_type The detected mime type.
*
* @return bool Whether or not the attachment is a valid image type.
*/
public function is_valid_image_type( $mime_type ) {
return \in_array( $mime_type, static::$valid_image_types, true );
}
/**
* Retrieves the image source for an attachment.
*
* @param int $attachment_id The attachment.
* @param string $image_size The image size to retrieve.
*
* @return string The image url or an empty string when not found.
*/
public function get_attachment_image_source( $attachment_id, $image_size = 'full' ) {
$attachment = \wp_get_attachment_image_src( $attachment_id, $image_size );
if ( ! $attachment ) {
return '';
}
return $attachment[0];
}
/**
* Retrieves the ID of the featured image.
*
* @param int $post_id The post id to get featured image id for.
*
* @return int|bool ID when found, false when not.
*/
public function get_featured_image_id( $post_id ) {
if ( ! \has_post_thumbnail( $post_id ) ) {
return false;
}
return \get_post_thumbnail_id( $post_id );
}
/**
* Gets the image url from the content.
*
* @param int $post_id The post id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_post_content_image( $post_id ) {
$image_url = $this->get_first_usable_content_image_for_post( $post_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Gets the first image url of a gallery.
*
* @param int $post_id Post ID to use.
*
* @return string The image url or an empty string when not found.
*/
public function get_gallery_image( $post_id ) {
$post = \get_post( $post_id );
if ( \strpos( $post->post_content, '[gallery' ) === false ) {
return '';
}
$images = \get_post_gallery_images( $post );
if ( empty( $images ) ) {
return '';
}
return \reset( $images );
}
/**
* Gets the image url from the term content.
*
* @param int $term_id The term id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_term_content_image( $term_id ) {
$image_url = $this->get_first_content_image_for_term( $term_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Retrieves the caption for an attachment.
*
* @param int $attachment_id Attachment ID.
*
* @return string The caption when found, empty string when no caption is found.
*/
public function get_caption( $attachment_id ) {
$caption = \wp_get_attachment_caption( $attachment_id );
if ( ! empty( $caption ) ) {
return $caption;
}
$caption = \get_post_meta( $attachment_id, '_wp_attachment_image_alt', true );
if ( ! empty( $caption ) ) {
return $caption;
}
return '';
}
/**
* Retrieves the attachment metadata.
*
* @param int $attachment_id Attachment ID.
*
* @return array The metadata, empty array when no metadata is found.
*/
public function get_metadata( $attachment_id ) {
$metadata = \wp_get_attachment_metadata( $attachment_id );
if ( ! $metadata || ! \is_array( $metadata ) ) {
return [];
}
return $metadata;
}
/**
* Retrieves the attachment image url.
*
* @param int $attachment_id Attachment ID.
* @param string $size The size to get.
*
* @return string The url when found, empty string otherwise.
*/
public function get_attachment_image_url( $attachment_id, $size ) {
$url = \wp_get_attachment_image_url( $attachment_id, $size );
if ( ! $url ) {
return '';
}
return $url;
}
/**
* Find the right version of an image based on size.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id Attachment ID.
* @param string $size Size name.
*
* @return array|false Returns an array with image data on success, false on failure.
*/
public function get_image( $attachment_id, $size ) {
return WPSEO_Image_Utils::get_image( $attachment_id, $size );
}
/**
* Retrieves the best attachment variation for the given attachment.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id The attachment id.
*
* @return bool|string The attachment url or false when no variations found.
*/
public function get_best_attachment_variation( $attachment_id ) {
$variations = WPSEO_Image_Utils::get_variations( $attachment_id );
$variations = WPSEO_Image_Utils::filter_usable_file_size( $variations );
// If we are left without variations, there is no valid variation for this attachment.
if ( empty( $variations ) ) {
return false;
}
// The variations are ordered so the first variations is by definition the best one.
return \reset( $variations );
}
/**
* Find an attachment ID for a given URL.
*
* @param string $url The URL to find the attachment for.
*
* @return int The found attachment ID, or 0 if none was found.
*/
public function get_attachment_by_url( $url ) {
// Strip out the size part of an image URL.
$url = \preg_replace( '/(.*)-\d+x\d+\.(jpeg|jpg|png|gif)$/', '$1.$2', $url );
// Don't try to do this for external URLs.
if ( $this->url_helper->get_link_type( $url ) === SEO_Links::TYPE_EXTERNAL ) {
return 0;
}
$indexable = $this->indexable_repository->find_by_permalink( $url );
if ( $indexable && $indexable->object_type === 'post' && $indexable->object_sub_type === 'attachment' ) {
return $indexable->object_id;
}
$post_id = WPSEO_Image_Utils::get_attachment_by_url( $url );
if ( $post_id !== 0 ) {
// Find the indexable, this triggers creating it so it can be found next time.
$this->indexable_repository->find_by_id_and_type( $post_id, 'post' );
}
return $post_id;
}
/**
* Retrieves an attachment ID for an image uploaded in the settings.
*
* Due to self::get_attachment_by_url returning 0 instead of false.
* 0 is also a possibility when no ID is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param string $setting The setting the image is stored in.
*
* @return int|bool The attachment id, or false or 0 if no ID is available.
*/
public function get_attachment_id_from_settings( $setting ) {
return WPSEO_Image_Utils::get_attachment_id_from_settings( $setting );
}
/**
* Based on and image ID return array with the best variation of that image. If it's not saved to the DB, save it to an option.
*
* @param string $setting The setting name. Should be company or person.
*
* @return array|bool Array with image details when the image is found, boolean when it's not found.
*/
public function get_attachment_meta_from_settings( $setting ) {
$image_meta = $this->options_helper->get( $setting . '_meta', false );
if ( ! $image_meta ) {
$image_id = $this->options_helper->get( $setting . '_id', false );
if ( $image_id ) {
// There is not an option to put a URL in an image field in the settings anymore, only to upload it through the media manager.
// This means an attachment always exists, so doing this is only needed once.
$image_meta = $this->get_best_attachment_variation( $image_id );
if ( $image_meta ) {
$this->options_helper->set( $setting . '_meta', $image_meta );
}
}
}
return $image_meta;
}
/**
* Retrieves the first usable content image for a post.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $post_id The post id to extract the images from.
*
* @return string|null
*/
protected function get_first_usable_content_image_for_post( $post_id ) {
return WPSEO_Image_Utils::get_first_usable_content_image_for_post( $post_id );
}
/**
* Gets the term's first usable content image. Null if none is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $term_id The term id.
*
* @return string|null The image URL.
*/
protected function get_first_content_image_for_term( $term_id ) {
return WPSEO_Image_Utils::get_first_content_image_for_term( $term_id );
}
}
home/xbodynamge/lebauwcentre/wp-content/plugins/wordpress-seo/src/helpers/twitter/image-helper.php 0000644 00000002200 15113746572 0027714 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Twitter;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
/**
* A helper object for Twitter images.
*/
class Image_Helper {
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Base_Image_Helper $image ) {
$this->image = $image;
}
/**
* The image size to use for Twitter.
*
* @return string Image size string.
*/
public function get_image_size() {
/**
* Filter: 'wpseo_twitter_image_size' - Allow changing the Twitter Card image size.
*
* @api string $featured_img Image size string.
*/
return (string) \apply_filters( 'wpseo_twitter_image_size', 'full' );
}
/**
* Retrieves an image url by its id.
*
* @codeCoverageIgnore It is a wrapper method.
*
* @param int $image_id The image id.
*
* @return string The image url.
*/
public function get_by_id( $image_id ) {
return $this->image->get_attachment_image_source( $image_id, $this->get_image_size() );
}
}
home/xbodynamge/namtation/wp-content/plugins/wordpress-seo/src/helpers/image-helper.php 0000644 00000024512 15114046235 0025524 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers;
use WPSEO_Image_Utils;
use Yoast\WP\SEO\Models\SEO_Links;
use Yoast\WP\SEO\Repositories\Indexable_Repository;
/**
* A helper object for images.
*/
class Image_Helper {
/**
* Image types that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_types = [ 'image/jpeg', 'image/gif', 'image/png', 'image/webp' ];
/**
* Image extensions that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_extensions = [ 'jpeg', 'jpg', 'gif', 'png', 'webp' ];
/**
* Represents the indexables repository.
*
* @var Indexable_Repository
*/
protected $indexable_repository;
/**
* The options helper.
*
* @var Options_Helper
*/
private $options_helper;
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url_helper;
/**
* Image_Helper constructor.
*
* @param Indexable_Repository $indexable_repository The indexable repository.
* @param Options_Helper $options The options helper.
* @param Url_Helper $url_helper The URL helper.
*/
public function __construct(
Indexable_Repository $indexable_repository,
Options_Helper $options,
Url_Helper $url_helper
) {
$this->indexable_repository = $indexable_repository;
$this->options_helper = $options;
$this->url_helper = $url_helper;
}
/**
* Determines whether or not the wanted attachment is considered valid.
*
* @param int $attachment_id The attachment ID to get the attachment by.
*
* @return bool Whether or not the attachment is valid.
*/
public function is_valid_attachment( $attachment_id ) {
if ( ! \wp_attachment_is_image( $attachment_id ) ) {
return false;
}
$post_mime_type = \get_post_mime_type( $attachment_id );
if ( $post_mime_type === false ) {
return false;
}
return $this->is_valid_image_type( $post_mime_type );
}
/**
* Checks if the given extension is a valid extension
*
* @param string $image_extension The image extension.
*
* @return bool True when valid.
*/
public function is_extension_valid( $image_extension ) {
return \in_array( $image_extension, static::$valid_image_extensions, true );
}
/**
* Determines whether the passed mime type is a valid image type.
*
* @param string $mime_type The detected mime type.
*
* @return bool Whether or not the attachment is a valid image type.
*/
public function is_valid_image_type( $mime_type ) {
return \in_array( $mime_type, static::$valid_image_types, true );
}
/**
* Retrieves the image source for an attachment.
*
* @param int $attachment_id The attachment.
* @param string $image_size The image size to retrieve.
*
* @return string The image url or an empty string when not found.
*/
public function get_attachment_image_source( $attachment_id, $image_size = 'full' ) {
$attachment = \wp_get_attachment_image_src( $attachment_id, $image_size );
if ( ! $attachment ) {
return '';
}
return $attachment[0];
}
/**
* Retrieves the ID of the featured image.
*
* @param int $post_id The post id to get featured image id for.
*
* @return int|bool ID when found, false when not.
*/
public function get_featured_image_id( $post_id ) {
if ( ! \has_post_thumbnail( $post_id ) ) {
return false;
}
return \get_post_thumbnail_id( $post_id );
}
/**
* Gets the image url from the content.
*
* @param int $post_id The post id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_post_content_image( $post_id ) {
$image_url = $this->get_first_usable_content_image_for_post( $post_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Gets the first image url of a gallery.
*
* @param int $post_id Post ID to use.
*
* @return string The image url or an empty string when not found.
*/
public function get_gallery_image( $post_id ) {
$post = \get_post( $post_id );
if ( \strpos( $post->post_content, '[gallery' ) === false ) {
return '';
}
$images = \get_post_gallery_images( $post );
if ( empty( $images ) ) {
return '';
}
return \reset( $images );
}
/**
* Gets the image url from the term content.
*
* @param int $term_id The term id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_term_content_image( $term_id ) {
$image_url = $this->get_first_content_image_for_term( $term_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Retrieves the caption for an attachment.
*
* @param int $attachment_id Attachment ID.
*
* @return string The caption when found, empty string when no caption is found.
*/
public function get_caption( $attachment_id ) {
$caption = \wp_get_attachment_caption( $attachment_id );
if ( ! empty( $caption ) ) {
return $caption;
}
$caption = \get_post_meta( $attachment_id, '_wp_attachment_image_alt', true );
if ( ! empty( $caption ) ) {
return $caption;
}
return '';
}
/**
* Retrieves the attachment metadata.
*
* @param int $attachment_id Attachment ID.
*
* @return array The metadata, empty array when no metadata is found.
*/
public function get_metadata( $attachment_id ) {
$metadata = \wp_get_attachment_metadata( $attachment_id );
if ( ! $metadata || ! \is_array( $metadata ) ) {
return [];
}
return $metadata;
}
/**
* Retrieves the attachment image url.
*
* @param int $attachment_id Attachment ID.
* @param string $size The size to get.
*
* @return string The url when found, empty string otherwise.
*/
public function get_attachment_image_url( $attachment_id, $size ) {
$url = \wp_get_attachment_image_url( $attachment_id, $size );
if ( ! $url ) {
return '';
}
return $url;
}
/**
* Find the right version of an image based on size.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id Attachment ID.
* @param string $size Size name.
*
* @return array|false Returns an array with image data on success, false on failure.
*/
public function get_image( $attachment_id, $size ) {
return WPSEO_Image_Utils::get_image( $attachment_id, $size );
}
/**
* Retrieves the best attachment variation for the given attachment.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id The attachment id.
*
* @return bool|string The attachment url or false when no variations found.
*/
public function get_best_attachment_variation( $attachment_id ) {
$variations = WPSEO_Image_Utils::get_variations( $attachment_id );
$variations = WPSEO_Image_Utils::filter_usable_file_size( $variations );
// If we are left without variations, there is no valid variation for this attachment.
if ( empty( $variations ) ) {
return false;
}
// The variations are ordered so the first variations is by definition the best one.
return \reset( $variations );
}
/**
* Find an attachment ID for a given URL.
*
* @param string $url The URL to find the attachment for.
*
* @return int The found attachment ID, or 0 if none was found.
*/
public function get_attachment_by_url( $url ) {
// Strip out the size part of an image URL.
$url = \preg_replace( '/(.*)-\d+x\d+\.(jpeg|jpg|png|gif)$/', '$1.$2', $url );
// Don't try to do this for external URLs.
if ( $this->url_helper->get_link_type( $url ) === SEO_Links::TYPE_EXTERNAL ) {
return 0;
}
$indexable = $this->indexable_repository->find_by_permalink( $url );
if ( $indexable && $indexable->object_type === 'post' && $indexable->object_sub_type === 'attachment' ) {
return $indexable->object_id;
}
$post_id = WPSEO_Image_Utils::get_attachment_by_url( $url );
if ( $post_id !== 0 ) {
// Find the indexable, this triggers creating it so it can be found next time.
$this->indexable_repository->find_by_id_and_type( $post_id, 'post' );
}
return $post_id;
}
/**
* Retrieves an attachment ID for an image uploaded in the settings.
*
* Due to self::get_attachment_by_url returning 0 instead of false.
* 0 is also a possibility when no ID is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param string $setting The setting the image is stored in.
*
* @return int|bool The attachment id, or false or 0 if no ID is available.
*/
public function get_attachment_id_from_settings( $setting ) {
return WPSEO_Image_Utils::get_attachment_id_from_settings( $setting );
}
/**
* Based on and image ID return array with the best variation of that image. If it's not saved to the DB, save it to an option.
*
* @param string $setting The setting name. Should be company or person.
*
* @return array|bool Array with image details when the image is found, boolean when it's not found.
*/
public function get_attachment_meta_from_settings( $setting ) {
$image_meta = $this->options_helper->get( $setting . '_meta', false );
if ( ! $image_meta ) {
$image_id = $this->options_helper->get( $setting . '_id', false );
if ( $image_id ) {
// There is not an option to put a URL in an image field in the settings anymore, only to upload it through the media manager.
// This means an attachment always exists, so doing this is only needed once.
$image_meta = $this->get_best_attachment_variation( $image_id );
if ( $image_meta ) {
$this->options_helper->set( $setting . '_meta', $image_meta );
}
}
}
return $image_meta;
}
/**
* Retrieves the first usable content image for a post.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $post_id The post id to extract the images from.
*
* @return string|null
*/
protected function get_first_usable_content_image_for_post( $post_id ) {
return WPSEO_Image_Utils::get_first_usable_content_image_for_post( $post_id );
}
/**
* Gets the term's first usable content image. Null if none is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $term_id The term id.
*
* @return string|null The image URL.
*/
protected function get_first_content_image_for_term( $term_id ) {
return WPSEO_Image_Utils::get_first_content_image_for_term( $term_id );
}
}
home/xbodynamge/crosstraining/wp-content/plugins/wordpress-seo/src/helpers/image-helper.php 0000644 00000024512 15114074665 0026427 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers;
use WPSEO_Image_Utils;
use Yoast\WP\SEO\Models\SEO_Links;
use Yoast\WP\SEO\Repositories\Indexable_Repository;
/**
* A helper object for images.
*/
class Image_Helper {
/**
* Image types that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_types = [ 'image/jpeg', 'image/gif', 'image/png', 'image/webp' ];
/**
* Image extensions that are supported by Open Graph.
*
* @var array
*/
protected static $valid_image_extensions = [ 'jpeg', 'jpg', 'gif', 'png', 'webp' ];
/**
* Represents the indexables repository.
*
* @var Indexable_Repository
*/
protected $indexable_repository;
/**
* The options helper.
*
* @var Options_Helper
*/
private $options_helper;
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url_helper;
/**
* Image_Helper constructor.
*
* @param Indexable_Repository $indexable_repository The indexable repository.
* @param Options_Helper $options The options helper.
* @param Url_Helper $url_helper The URL helper.
*/
public function __construct(
Indexable_Repository $indexable_repository,
Options_Helper $options,
Url_Helper $url_helper
) {
$this->indexable_repository = $indexable_repository;
$this->options_helper = $options;
$this->url_helper = $url_helper;
}
/**
* Determines whether or not the wanted attachment is considered valid.
*
* @param int $attachment_id The attachment ID to get the attachment by.
*
* @return bool Whether or not the attachment is valid.
*/
public function is_valid_attachment( $attachment_id ) {
if ( ! \wp_attachment_is_image( $attachment_id ) ) {
return false;
}
$post_mime_type = \get_post_mime_type( $attachment_id );
if ( $post_mime_type === false ) {
return false;
}
return $this->is_valid_image_type( $post_mime_type );
}
/**
* Checks if the given extension is a valid extension
*
* @param string $image_extension The image extension.
*
* @return bool True when valid.
*/
public function is_extension_valid( $image_extension ) {
return \in_array( $image_extension, static::$valid_image_extensions, true );
}
/**
* Determines whether the passed mime type is a valid image type.
*
* @param string $mime_type The detected mime type.
*
* @return bool Whether or not the attachment is a valid image type.
*/
public function is_valid_image_type( $mime_type ) {
return \in_array( $mime_type, static::$valid_image_types, true );
}
/**
* Retrieves the image source for an attachment.
*
* @param int $attachment_id The attachment.
* @param string $image_size The image size to retrieve.
*
* @return string The image url or an empty string when not found.
*/
public function get_attachment_image_source( $attachment_id, $image_size = 'full' ) {
$attachment = \wp_get_attachment_image_src( $attachment_id, $image_size );
if ( ! $attachment ) {
return '';
}
return $attachment[0];
}
/**
* Retrieves the ID of the featured image.
*
* @param int $post_id The post id to get featured image id for.
*
* @return int|bool ID when found, false when not.
*/
public function get_featured_image_id( $post_id ) {
if ( ! \has_post_thumbnail( $post_id ) ) {
return false;
}
return \get_post_thumbnail_id( $post_id );
}
/**
* Gets the image url from the content.
*
* @param int $post_id The post id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_post_content_image( $post_id ) {
$image_url = $this->get_first_usable_content_image_for_post( $post_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Gets the first image url of a gallery.
*
* @param int $post_id Post ID to use.
*
* @return string The image url or an empty string when not found.
*/
public function get_gallery_image( $post_id ) {
$post = \get_post( $post_id );
if ( \strpos( $post->post_content, '[gallery' ) === false ) {
return '';
}
$images = \get_post_gallery_images( $post );
if ( empty( $images ) ) {
return '';
}
return \reset( $images );
}
/**
* Gets the image url from the term content.
*
* @param int $term_id The term id to extract the images from.
*
* @return string The image url or an empty string when not found.
*/
public function get_term_content_image( $term_id ) {
$image_url = $this->get_first_content_image_for_term( $term_id );
if ( $image_url === null ) {
return '';
}
return $image_url;
}
/**
* Retrieves the caption for an attachment.
*
* @param int $attachment_id Attachment ID.
*
* @return string The caption when found, empty string when no caption is found.
*/
public function get_caption( $attachment_id ) {
$caption = \wp_get_attachment_caption( $attachment_id );
if ( ! empty( $caption ) ) {
return $caption;
}
$caption = \get_post_meta( $attachment_id, '_wp_attachment_image_alt', true );
if ( ! empty( $caption ) ) {
return $caption;
}
return '';
}
/**
* Retrieves the attachment metadata.
*
* @param int $attachment_id Attachment ID.
*
* @return array The metadata, empty array when no metadata is found.
*/
public function get_metadata( $attachment_id ) {
$metadata = \wp_get_attachment_metadata( $attachment_id );
if ( ! $metadata || ! \is_array( $metadata ) ) {
return [];
}
return $metadata;
}
/**
* Retrieves the attachment image url.
*
* @param int $attachment_id Attachment ID.
* @param string $size The size to get.
*
* @return string The url when found, empty string otherwise.
*/
public function get_attachment_image_url( $attachment_id, $size ) {
$url = \wp_get_attachment_image_url( $attachment_id, $size );
if ( ! $url ) {
return '';
}
return $url;
}
/**
* Find the right version of an image based on size.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id Attachment ID.
* @param string $size Size name.
*
* @return array|false Returns an array with image data on success, false on failure.
*/
public function get_image( $attachment_id, $size ) {
return WPSEO_Image_Utils::get_image( $attachment_id, $size );
}
/**
* Retrieves the best attachment variation for the given attachment.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $attachment_id The attachment id.
*
* @return bool|string The attachment url or false when no variations found.
*/
public function get_best_attachment_variation( $attachment_id ) {
$variations = WPSEO_Image_Utils::get_variations( $attachment_id );
$variations = WPSEO_Image_Utils::filter_usable_file_size( $variations );
// If we are left without variations, there is no valid variation for this attachment.
if ( empty( $variations ) ) {
return false;
}
// The variations are ordered so the first variations is by definition the best one.
return \reset( $variations );
}
/**
* Find an attachment ID for a given URL.
*
* @param string $url The URL to find the attachment for.
*
* @return int The found attachment ID, or 0 if none was found.
*/
public function get_attachment_by_url( $url ) {
// Strip out the size part of an image URL.
$url = \preg_replace( '/(.*)-\d+x\d+\.(jpeg|jpg|png|gif)$/', '$1.$2', $url );
// Don't try to do this for external URLs.
if ( $this->url_helper->get_link_type( $url ) === SEO_Links::TYPE_EXTERNAL ) {
return 0;
}
$indexable = $this->indexable_repository->find_by_permalink( $url );
if ( $indexable && $indexable->object_type === 'post' && $indexable->object_sub_type === 'attachment' ) {
return $indexable->object_id;
}
$post_id = WPSEO_Image_Utils::get_attachment_by_url( $url );
if ( $post_id !== 0 ) {
// Find the indexable, this triggers creating it so it can be found next time.
$this->indexable_repository->find_by_id_and_type( $post_id, 'post' );
}
return $post_id;
}
/**
* Retrieves an attachment ID for an image uploaded in the settings.
*
* Due to self::get_attachment_by_url returning 0 instead of false.
* 0 is also a possibility when no ID is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param string $setting The setting the image is stored in.
*
* @return int|bool The attachment id, or false or 0 if no ID is available.
*/
public function get_attachment_id_from_settings( $setting ) {
return WPSEO_Image_Utils::get_attachment_id_from_settings( $setting );
}
/**
* Based on and image ID return array with the best variation of that image. If it's not saved to the DB, save it to an option.
*
* @param string $setting The setting name. Should be company or person.
*
* @return array|bool Array with image details when the image is found, boolean when it's not found.
*/
public function get_attachment_meta_from_settings( $setting ) {
$image_meta = $this->options_helper->get( $setting . '_meta', false );
if ( ! $image_meta ) {
$image_id = $this->options_helper->get( $setting . '_id', false );
if ( $image_id ) {
// There is not an option to put a URL in an image field in the settings anymore, only to upload it through the media manager.
// This means an attachment always exists, so doing this is only needed once.
$image_meta = $this->get_best_attachment_variation( $image_id );
if ( $image_meta ) {
$this->options_helper->set( $setting . '_meta', $image_meta );
}
}
}
return $image_meta;
}
/**
* Retrieves the first usable content image for a post.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $post_id The post id to extract the images from.
*
* @return string|null
*/
protected function get_first_usable_content_image_for_post( $post_id ) {
return WPSEO_Image_Utils::get_first_usable_content_image_for_post( $post_id );
}
/**
* Gets the term's first usable content image. Null if none is available.
*
* @codeCoverageIgnore - We have to write test when this method contains own code.
*
* @param int $term_id The term id.
*
* @return string|null The image URL.
*/
protected function get_first_content_image_for_term( $term_id ) {
return WPSEO_Image_Utils::get_first_content_image_for_term( $term_id );
}
}
home/xbodynamge/crosstraining/wp-content/plugins/wordpress-seo/src/helpers/twitter/image-helper.php 0000644 00000002200 15114236152 0030106 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Twitter;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
/**
* A helper object for Twitter images.
*/
class Image_Helper {
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Base_Image_Helper $image ) {
$this->image = $image;
}
/**
* The image size to use for Twitter.
*
* @return string Image size string.
*/
public function get_image_size() {
/**
* Filter: 'wpseo_twitter_image_size' - Allow changing the Twitter Card image size.
*
* @api string $featured_img Image size string.
*/
return (string) \apply_filters( 'wpseo_twitter_image_size', 'full' );
}
/**
* Retrieves an image url by its id.
*
* @codeCoverageIgnore It is a wrapper method.
*
* @param int $image_id The image id.
*
* @return string The image url.
*/
public function get_by_id( $image_id ) {
return $this->image->get_attachment_image_source( $image_id, $this->get_image_size() );
}
}
xbodynamge/crosstraining/wp-content/plugins/wordpress-seo/src/helpers/open-graph/image-helper.php 0000644 00000005541 15114250037 0030376 0 ustar 00 home <?php
namespace Yoast\WP\SEO\Helpers\Open_Graph;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
use Yoast\WP\SEO\Helpers\Url_Helper;
/**
* A helper object for Open Graph images.
*/
class Image_Helper {
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url;
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Url_Helper $url The url helper.
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Url_Helper $url, Base_Image_Helper $image ) {
$this->url = $url;
$this->image = $image;
}
/**
* Determines whether the passed URL is considered valid.
*
* @param array $image The image array.
*
* @return bool Whether or not the URL is a valid image.
*/
public function is_image_url_valid( array $image ) {
if ( empty( $image['url'] ) || ! \is_string( $image['url'] ) ) {
return false;
}
$image_extension = $this->url->get_extension_from_url( $image['url'] );
$is_valid = $this->image->is_extension_valid( $image_extension );
/**
* Filter: 'wpseo_opengraph_is_valid_image_url' - Allows extra validation for an image url.
*
* @api bool - Current validation result.
*
* @param string $url The image url to validate.
*/
return (bool) \apply_filters( 'wpseo_opengraph_is_valid_image_url', $is_valid, $image['url'] );
}
/**
* Retrieves the overridden image size value.
*
* @return string|null The image size when overriden by filter or null when not.
*/
public function get_override_image_size() {
/**
* Filter: 'wpseo_opengraph_image_size' - Allow overriding the image size used
* for Open Graph sharing. If this filter is used, the defined size will always be
* used for the og:image. The image will still be rejected if it is too small.
*
* Only use this filter if you manually want to determine the best image size
* for the `og:image` tag.
*
* Use the `wpseo_image_sizes` filter if you want to use our logic. That filter
* can be used to add an image size that needs to be taken into consideration
* within our own logic.
*
* @api string|false $size Size string.
*/
return \apply_filters( 'wpseo_opengraph_image_size', null );
}
/**
* Retrieves the image data by a given attachment id.
*
* @param int $attachment_id The attachment id.
*
* @return array|false The image data when found, `false` when not.
*/
public function get_image_by_id( $attachment_id ) {
if ( ! $this->image->is_valid_attachment( $attachment_id ) ) {
return false;
}
$override_image_size = $this->get_override_image_size();
if ( $override_image_size ) {
return $this->image->get_image( $attachment_id, $override_image_size );
}
return $this->image->get_best_attachment_variation( $attachment_id );
}
}
xbodynamge/lebauwcentre/wp-content/plugins/wordpress-seo/src/helpers/open-graph/image-helper.php 0000644 00000005541 15114331153 0030170 0 ustar 00 home <?php
namespace Yoast\WP\SEO\Helpers\Open_Graph;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
use Yoast\WP\SEO\Helpers\Url_Helper;
/**
* A helper object for Open Graph images.
*/
class Image_Helper {
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url;
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Url_Helper $url The url helper.
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Url_Helper $url, Base_Image_Helper $image ) {
$this->url = $url;
$this->image = $image;
}
/**
* Determines whether the passed URL is considered valid.
*
* @param array $image The image array.
*
* @return bool Whether or not the URL is a valid image.
*/
public function is_image_url_valid( array $image ) {
if ( empty( $image['url'] ) || ! \is_string( $image['url'] ) ) {
return false;
}
$image_extension = $this->url->get_extension_from_url( $image['url'] );
$is_valid = $this->image->is_extension_valid( $image_extension );
/**
* Filter: 'wpseo_opengraph_is_valid_image_url' - Allows extra validation for an image url.
*
* @api bool - Current validation result.
*
* @param string $url The image url to validate.
*/
return (bool) \apply_filters( 'wpseo_opengraph_is_valid_image_url', $is_valid, $image['url'] );
}
/**
* Retrieves the overridden image size value.
*
* @return string|null The image size when overriden by filter or null when not.
*/
public function get_override_image_size() {
/**
* Filter: 'wpseo_opengraph_image_size' - Allow overriding the image size used
* for Open Graph sharing. If this filter is used, the defined size will always be
* used for the og:image. The image will still be rejected if it is too small.
*
* Only use this filter if you manually want to determine the best image size
* for the `og:image` tag.
*
* Use the `wpseo_image_sizes` filter if you want to use our logic. That filter
* can be used to add an image size that needs to be taken into consideration
* within our own logic.
*
* @api string|false $size Size string.
*/
return \apply_filters( 'wpseo_opengraph_image_size', null );
}
/**
* Retrieves the image data by a given attachment id.
*
* @param int $attachment_id The attachment id.
*
* @return array|false The image data when found, `false` when not.
*/
public function get_image_by_id( $attachment_id ) {
if ( ! $this->image->is_valid_attachment( $attachment_id ) ) {
return false;
}
$override_image_size = $this->get_override_image_size();
if ( $override_image_size ) {
return $this->image->get_image( $attachment_id, $override_image_size );
}
return $this->image->get_best_attachment_variation( $attachment_id );
}
}
home/xbodynamge/www/wp-content/plugins/wordpress-seo/src/helpers/open-graph/image-helper.php 0000644 00000005541 15114432440 0026414 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Open_Graph;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
use Yoast\WP\SEO\Helpers\Url_Helper;
/**
* A helper object for Open Graph images.
*/
class Image_Helper {
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url;
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Url_Helper $url The url helper.
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Url_Helper $url, Base_Image_Helper $image ) {
$this->url = $url;
$this->image = $image;
}
/**
* Determines whether the passed URL is considered valid.
*
* @param array $image The image array.
*
* @return bool Whether or not the URL is a valid image.
*/
public function is_image_url_valid( array $image ) {
if ( empty( $image['url'] ) || ! \is_string( $image['url'] ) ) {
return false;
}
$image_extension = $this->url->get_extension_from_url( $image['url'] );
$is_valid = $this->image->is_extension_valid( $image_extension );
/**
* Filter: 'wpseo_opengraph_is_valid_image_url' - Allows extra validation for an image url.
*
* @api bool - Current validation result.
*
* @param string $url The image url to validate.
*/
return (bool) \apply_filters( 'wpseo_opengraph_is_valid_image_url', $is_valid, $image['url'] );
}
/**
* Retrieves the overridden image size value.
*
* @return string|null The image size when overriden by filter or null when not.
*/
public function get_override_image_size() {
/**
* Filter: 'wpseo_opengraph_image_size' - Allow overriding the image size used
* for Open Graph sharing. If this filter is used, the defined size will always be
* used for the og:image. The image will still be rejected if it is too small.
*
* Only use this filter if you manually want to determine the best image size
* for the `og:image` tag.
*
* Use the `wpseo_image_sizes` filter if you want to use our logic. That filter
* can be used to add an image size that needs to be taken into consideration
* within our own logic.
*
* @api string|false $size Size string.
*/
return \apply_filters( 'wpseo_opengraph_image_size', null );
}
/**
* Retrieves the image data by a given attachment id.
*
* @param int $attachment_id The attachment id.
*
* @return array|false The image data when found, `false` when not.
*/
public function get_image_by_id( $attachment_id ) {
if ( ! $this->image->is_valid_attachment( $attachment_id ) ) {
return false;
}
$override_image_size = $this->get_override_image_size();
if ( $override_image_size ) {
return $this->image->get_image( $attachment_id, $override_image_size );
}
return $this->image->get_best_attachment_variation( $attachment_id );
}
}
home/xbodynamge/namtation/wp-content/plugins/wordpress-seo/src/helpers/open-graph/image-helper.php 0000644 00000005541 15114447617 0027576 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Open_Graph;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
use Yoast\WP\SEO\Helpers\Url_Helper;
/**
* A helper object for Open Graph images.
*/
class Image_Helper {
/**
* The URL helper.
*
* @var Url_Helper
*/
private $url;
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Url_Helper $url The url helper.
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Url_Helper $url, Base_Image_Helper $image ) {
$this->url = $url;
$this->image = $image;
}
/**
* Determines whether the passed URL is considered valid.
*
* @param array $image The image array.
*
* @return bool Whether or not the URL is a valid image.
*/
public function is_image_url_valid( array $image ) {
if ( empty( $image['url'] ) || ! \is_string( $image['url'] ) ) {
return false;
}
$image_extension = $this->url->get_extension_from_url( $image['url'] );
$is_valid = $this->image->is_extension_valid( $image_extension );
/**
* Filter: 'wpseo_opengraph_is_valid_image_url' - Allows extra validation for an image url.
*
* @api bool - Current validation result.
*
* @param string $url The image url to validate.
*/
return (bool) \apply_filters( 'wpseo_opengraph_is_valid_image_url', $is_valid, $image['url'] );
}
/**
* Retrieves the overridden image size value.
*
* @return string|null The image size when overriden by filter or null when not.
*/
public function get_override_image_size() {
/**
* Filter: 'wpseo_opengraph_image_size' - Allow overriding the image size used
* for Open Graph sharing. If this filter is used, the defined size will always be
* used for the og:image. The image will still be rejected if it is too small.
*
* Only use this filter if you manually want to determine the best image size
* for the `og:image` tag.
*
* Use the `wpseo_image_sizes` filter if you want to use our logic. That filter
* can be used to add an image size that needs to be taken into consideration
* within our own logic.
*
* @api string|false $size Size string.
*/
return \apply_filters( 'wpseo_opengraph_image_size', null );
}
/**
* Retrieves the image data by a given attachment id.
*
* @param int $attachment_id The attachment id.
*
* @return array|false The image data when found, `false` when not.
*/
public function get_image_by_id( $attachment_id ) {
if ( ! $this->image->is_valid_attachment( $attachment_id ) ) {
return false;
}
$override_image_size = $this->get_override_image_size();
if ( $override_image_size ) {
return $this->image->get_image( $attachment_id, $override_image_size );
}
return $this->image->get_best_attachment_variation( $attachment_id );
}
}
home/xbodynamge/namtation/wp-content/plugins/wordpress-seo/src/helpers/twitter/image-helper.php 0000644 00000002200 15114450344 0027214 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Twitter;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
/**
* A helper object for Twitter images.
*/
class Image_Helper {
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Base_Image_Helper $image ) {
$this->image = $image;
}
/**
* The image size to use for Twitter.
*
* @return string Image size string.
*/
public function get_image_size() {
/**
* Filter: 'wpseo_twitter_image_size' - Allow changing the Twitter Card image size.
*
* @api string $featured_img Image size string.
*/
return (string) \apply_filters( 'wpseo_twitter_image_size', 'full' );
}
/**
* Retrieves an image url by its id.
*
* @codeCoverageIgnore It is a wrapper method.
*
* @param int $image_id The image id.
*
* @return string The image url.
*/
public function get_by_id( $image_id ) {
return $this->image->get_attachment_image_source( $image_id, $this->get_image_size() );
}
}
home/xbodynamge/www/wp-content/plugins/wordpress-seo/src/helpers/twitter/image-helper.php 0000644 00000002200 15114514605 0026047 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Twitter;
use Yoast\WP\SEO\Helpers\Image_Helper as Base_Image_Helper;
/**
* A helper object for Twitter images.
*/
class Image_Helper {
/**
* The base image helper.
*
* @var Base_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore
*
* @param Base_Image_Helper $image The image helper.
*/
public function __construct( Base_Image_Helper $image ) {
$this->image = $image;
}
/**
* The image size to use for Twitter.
*
* @return string Image size string.
*/
public function get_image_size() {
/**
* Filter: 'wpseo_twitter_image_size' - Allow changing the Twitter Card image size.
*
* @api string $featured_img Image size string.
*/
return (string) \apply_filters( 'wpseo_twitter_image_size', 'full' );
}
/**
* Retrieves an image url by its id.
*
* @codeCoverageIgnore It is a wrapper method.
*
* @param int $image_id The image id.
*
* @return string The image url.
*/
public function get_by_id( $image_id ) {
return $this->image->get_attachment_image_source( $image_id, $this->get_image_size() );
}
}
home/xbodynamge/crosstraining/wp-content/plugins/wordpress-seo/src/helpers/schema/image-helper.php 0000644 00000013566 15115053366 0027672 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Schema;
use Yoast\WP\SEO\Helpers\Image_Helper as Main_Image_Helper;
/**
* Class Image_Helper.
*/
class Image_Helper {
/**
* The HTML helper.
*
* @var HTML_Helper
*/
private $html;
/**
* The language helper.
*
* @var Language_Helper
*/
private $language;
/**
* Represents the main image helper.
*
* @var Main_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore It handles dependencies.
*
* @param HTML_Helper $html The HTML helper.
* @param Language_Helper $language The language helper.
* @param Main_Image_Helper $image The 'main' image helper.
*/
public function __construct( HTML_Helper $html, Language_Helper $language, Main_Image_Helper $image ) {
$this->html = $html;
$this->language = $language;
$this->image = $image;
}
/**
* Find an image based on its URL and generate a Schema object for it.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param string $url The image URL to base our object on.
* @param string $caption An optional caption.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_url( $schema_id, $url, $caption = '', $add_hash = false ) {
$attachment_id = $this->image->get_attachment_by_url( $url );
if ( $attachment_id > 0 ) {
return $this->generate_from_attachment_id( $schema_id, $attachment_id, $caption, $add_hash );
}
return $this->simple_image_object( $schema_id, $url, $caption, $add_hash );
}
/**
* Retrieve data about an image from the database and use it to generate a Schema object.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param int $attachment_id The attachment to retrieve data from.
* @param string $caption The caption string, if there is one.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_attachment_id( $schema_id, $attachment_id, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$url = $this->image->get_attachment_image_url( $attachment_id, 'full' );
$id_suffix = ( $add_hash ) ? \md5( $url ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $url;
$data['contentUrl'] = $url;
$data = $this->add_image_size( $data, $attachment_id );
$data = $this->add_caption( $data, $attachment_id, $caption );
return $data;
}
/**
* Retrieve data about an image from the database and use it to generate a Schema object.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param array $attachment_meta The attachment metadata.
* @param string $caption The caption string, if there is one.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_attachment_meta( $schema_id, $attachment_meta, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$id_suffix = ( $add_hash ) ? \md5( $attachment_meta['url'] ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $attachment_meta['url'];
$data['contentUrl'] = $data['url'];
$data['width'] = $attachment_meta['width'];
$data['height'] = $attachment_meta['height'];
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
}
return $data;
}
/**
* If we can't find $url in our database, we output a simple ImageObject.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param string $url The image URL.
* @param string $caption A caption, if set.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function simple_image_object( $schema_id, $url, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$id_suffix = ( $add_hash ) ? \md5( $url ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $url;
$data['contentUrl'] = $url;
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
}
return $data;
}
/**
* Retrieves an image's caption if set, or uses the alt tag if that's set.
*
* @param array $data An ImageObject Schema array.
* @param int $attachment_id Attachment ID.
* @param string $caption The caption string, if there is one.
*
* @return array An imageObject with width and height set if available.
*/
private function add_caption( $data, $attachment_id, $caption = '' ) {
if ( $caption !== '' ) {
$data['caption'] = $caption;
return $data;
}
$caption = $this->image->get_caption( $attachment_id );
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
return $data;
}
return $data;
}
/**
* Generates our bare bone ImageObject.
*
* @return array an empty ImageObject
*/
private function generate_object() {
$data = [
'@type' => 'ImageObject',
];
$data = $this->language->add_piece_language( $data );
return $data;
}
/**
* Adds image's width and height.
*
* @param array $data An ImageObject Schema array.
* @param int $attachment_id Attachment ID.
*
* @return array An imageObject with width and height set if available.
*/
private function add_image_size( $data, $attachment_id ) {
$image_meta = $this->image->get_metadata( $attachment_id );
if ( empty( $image_meta['width'] ) || empty( $image_meta['height'] ) ) {
return $data;
}
$data['width'] = $image_meta['width'];
$data['height'] = $image_meta['height'];
return $data;
}
}
home/xbodynamge/namtation/wp-content/plugins/wordpress-seo/src/helpers/schema/image-helper.php 0000644 00000013566 15115053617 0026776 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Schema;
use Yoast\WP\SEO\Helpers\Image_Helper as Main_Image_Helper;
/**
* Class Image_Helper.
*/
class Image_Helper {
/**
* The HTML helper.
*
* @var HTML_Helper
*/
private $html;
/**
* The language helper.
*
* @var Language_Helper
*/
private $language;
/**
* Represents the main image helper.
*
* @var Main_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore It handles dependencies.
*
* @param HTML_Helper $html The HTML helper.
* @param Language_Helper $language The language helper.
* @param Main_Image_Helper $image The 'main' image helper.
*/
public function __construct( HTML_Helper $html, Language_Helper $language, Main_Image_Helper $image ) {
$this->html = $html;
$this->language = $language;
$this->image = $image;
}
/**
* Find an image based on its URL and generate a Schema object for it.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param string $url The image URL to base our object on.
* @param string $caption An optional caption.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_url( $schema_id, $url, $caption = '', $add_hash = false ) {
$attachment_id = $this->image->get_attachment_by_url( $url );
if ( $attachment_id > 0 ) {
return $this->generate_from_attachment_id( $schema_id, $attachment_id, $caption, $add_hash );
}
return $this->simple_image_object( $schema_id, $url, $caption, $add_hash );
}
/**
* Retrieve data about an image from the database and use it to generate a Schema object.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param int $attachment_id The attachment to retrieve data from.
* @param string $caption The caption string, if there is one.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_attachment_id( $schema_id, $attachment_id, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$url = $this->image->get_attachment_image_url( $attachment_id, 'full' );
$id_suffix = ( $add_hash ) ? \md5( $url ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $url;
$data['contentUrl'] = $url;
$data = $this->add_image_size( $data, $attachment_id );
$data = $this->add_caption( $data, $attachment_id, $caption );
return $data;
}
/**
* Retrieve data about an image from the database and use it to generate a Schema object.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param array $attachment_meta The attachment metadata.
* @param string $caption The caption string, if there is one.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_attachment_meta( $schema_id, $attachment_meta, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$id_suffix = ( $add_hash ) ? \md5( $attachment_meta['url'] ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $attachment_meta['url'];
$data['contentUrl'] = $data['url'];
$data['width'] = $attachment_meta['width'];
$data['height'] = $attachment_meta['height'];
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
}
return $data;
}
/**
* If we can't find $url in our database, we output a simple ImageObject.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param string $url The image URL.
* @param string $caption A caption, if set.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function simple_image_object( $schema_id, $url, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$id_suffix = ( $add_hash ) ? \md5( $url ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $url;
$data['contentUrl'] = $url;
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
}
return $data;
}
/**
* Retrieves an image's caption if set, or uses the alt tag if that's set.
*
* @param array $data An ImageObject Schema array.
* @param int $attachment_id Attachment ID.
* @param string $caption The caption string, if there is one.
*
* @return array An imageObject with width and height set if available.
*/
private function add_caption( $data, $attachment_id, $caption = '' ) {
if ( $caption !== '' ) {
$data['caption'] = $caption;
return $data;
}
$caption = $this->image->get_caption( $attachment_id );
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
return $data;
}
return $data;
}
/**
* Generates our bare bone ImageObject.
*
* @return array an empty ImageObject
*/
private function generate_object() {
$data = [
'@type' => 'ImageObject',
];
$data = $this->language->add_piece_language( $data );
return $data;
}
/**
* Adds image's width and height.
*
* @param array $data An ImageObject Schema array.
* @param int $attachment_id Attachment ID.
*
* @return array An imageObject with width and height set if available.
*/
private function add_image_size( $data, $attachment_id ) {
$image_meta = $this->image->get_metadata( $attachment_id );
if ( empty( $image_meta['width'] ) || empty( $image_meta['height'] ) ) {
return $data;
}
$data['width'] = $image_meta['width'];
$data['height'] = $image_meta['height'];
return $data;
}
}
home/xbodynamge/lebauwcentre/wp-content/plugins/wordpress-seo/src/helpers/schema/image-helper.php 0000644 00000013566 15115054725 0027465 0 ustar 00 <?php
namespace Yoast\WP\SEO\Helpers\Schema;
use Yoast\WP\SEO\Helpers\Image_Helper as Main_Image_Helper;
/**
* Class Image_Helper.
*/
class Image_Helper {
/**
* The HTML helper.
*
* @var HTML_Helper
*/
private $html;
/**
* The language helper.
*
* @var Language_Helper
*/
private $language;
/**
* Represents the main image helper.
*
* @var Main_Image_Helper
*/
private $image;
/**
* Image_Helper constructor.
*
* @codeCoverageIgnore It handles dependencies.
*
* @param HTML_Helper $html The HTML helper.
* @param Language_Helper $language The language helper.
* @param Main_Image_Helper $image The 'main' image helper.
*/
public function __construct( HTML_Helper $html, Language_Helper $language, Main_Image_Helper $image ) {
$this->html = $html;
$this->language = $language;
$this->image = $image;
}
/**
* Find an image based on its URL and generate a Schema object for it.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param string $url The image URL to base our object on.
* @param string $caption An optional caption.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_url( $schema_id, $url, $caption = '', $add_hash = false ) {
$attachment_id = $this->image->get_attachment_by_url( $url );
if ( $attachment_id > 0 ) {
return $this->generate_from_attachment_id( $schema_id, $attachment_id, $caption, $add_hash );
}
return $this->simple_image_object( $schema_id, $url, $caption, $add_hash );
}
/**
* Retrieve data about an image from the database and use it to generate a Schema object.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param int $attachment_id The attachment to retrieve data from.
* @param string $caption The caption string, if there is one.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_attachment_id( $schema_id, $attachment_id, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$url = $this->image->get_attachment_image_url( $attachment_id, 'full' );
$id_suffix = ( $add_hash ) ? \md5( $url ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $url;
$data['contentUrl'] = $url;
$data = $this->add_image_size( $data, $attachment_id );
$data = $this->add_caption( $data, $attachment_id, $caption );
return $data;
}
/**
* Retrieve data about an image from the database and use it to generate a Schema object.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param array $attachment_meta The attachment metadata.
* @param string $caption The caption string, if there is one.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function generate_from_attachment_meta( $schema_id, $attachment_meta, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$id_suffix = ( $add_hash ) ? \md5( $attachment_meta['url'] ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $attachment_meta['url'];
$data['contentUrl'] = $data['url'];
$data['width'] = $attachment_meta['width'];
$data['height'] = $attachment_meta['height'];
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
}
return $data;
}
/**
* If we can't find $url in our database, we output a simple ImageObject.
*
* @param string $schema_id The `@id` to use for the returned image.
* @param string $url The image URL.
* @param string $caption A caption, if set.
* @param bool $add_hash Whether a hash will be added as a suffix in the @id.
*
* @return array Schema ImageObject array.
*/
public function simple_image_object( $schema_id, $url, $caption = '', $add_hash = false ) {
$data = $this->generate_object();
$id_suffix = ( $add_hash ) ? \md5( $url ) : '';
$data['@id'] = $schema_id . $id_suffix;
$data['url'] = $url;
$data['contentUrl'] = $url;
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
}
return $data;
}
/**
* Retrieves an image's caption if set, or uses the alt tag if that's set.
*
* @param array $data An ImageObject Schema array.
* @param int $attachment_id Attachment ID.
* @param string $caption The caption string, if there is one.
*
* @return array An imageObject with width and height set if available.
*/
private function add_caption( $data, $attachment_id, $caption = '' ) {
if ( $caption !== '' ) {
$data['caption'] = $caption;
return $data;
}
$caption = $this->image->get_caption( $attachment_id );
if ( ! empty( $caption ) ) {
$data['caption'] = $this->html->smart_strip_tags( $caption );
return $data;
}
return $data;
}
/**
* Generates our bare bone ImageObject.
*
* @return array an empty ImageObject
*/
private function generate_object() {
$data = [
'@type' => 'ImageObject',
];
$data = $this->language->add_piece_language( $data );
return $data;
}
/**
* Adds image's width and height.
*
* @param array $data An ImageObject Schema array.
* @param int $attachment_id Attachment ID.
*
* @return array An imageObject with width and height set if available.
*/
private function add_image_size( $data, $attachment_id ) {
$image_meta = $this->image->get_metadata( $attachment_id );
if ( empty( $image_meta['width'] ) || empty( $image_meta['height'] ) ) {
return $data;
}
$data['width'] = $image_meta['width'];
$data['height'] = $image_meta['height'];
return $data;
}
}