%2$s
',
esc_attr( $alignment ),
$label_html
);
/* Core/video puts the caption after ; insert before that caption. */
if ( preg_match( '/<\/video>/i', $block_content ) ) {
return preg_replace( '/<\/video>/i', '' . $row_html, $block_content, 1 );
}
if ( preg_match( '/<\/figure>\s*$/i', $block_content ) ) {
return preg_replace( '/<\/figure>\s*$/i', $row_html . '', $block_content, 1 );
}
return $block_content . $row_html;
}
/**
* Add the badge when a theme renders the featured attachment directly.
*
* Some themes call wp_get_attachment_image() instead of the regular
* post-thumbnail template functions. The wp-post-image class prevents the
* same attachment from being labelled when it is used as a normal content image.
*
* @param string $html Image HTML.
* @param int $attachment_id Attachment ID.
* @param string|array $size Requested image size.
* @param bool $icon Whether the image is an icon.
* @param array $attr Image attributes.
* @return string
*/
public function render_featured_attachment_label( $html, $attachment_id, $size, $icon, $attr ) {
if ( empty( $this->settings()['enable_images'] ) ) {
return $html;
}
unset( $size, $icon, $attr );
if ( '' === $html || is_admin() || wp_doing_ajax() || is_feed() ) {
return $html;
}
$library_source_type = $this->attachment_source_type( (int) $attachment_id );
if ( '' !== $library_source_type ) {
$this->register_machine_readable_image(
(int) $attachment_id,
$library_source_type,
$this->extract_image_url( $html )
);
}
if (
false !== strpos( $html, 'gd-ai-featured-wrap' ) ||
false === strpos( $html, 'wp-post-image' )
) {
return $html;
}
/*
* On singular views the queried object is authoritative. In post loops,
* query blocks and archive cards, get_the_ID() identifies the post whose
* image is currently being rendered. This lets themes that call
* wp_get_attachment_image() directly receive the same disclosure as
* themes that use get_the_post_thumbnail().
*/
$post_id = is_singular( $this->post_types() ) ? get_queried_object_id() : get_the_ID();
if (
! $post_id ||
! in_array( get_post_type( $post_id ), $this->post_types(), true ) ||
(int) $attachment_id !== (int) get_post_thumbnail_id( $post_id )
) {
return $html;
}
$plan = $this->featured_label_plan( $post_id, (int) $attachment_id );
if ( false === $plan ) {
return $html;
}
$label_html = $this->label_html( $plan['text'], (int) $attachment_id );
if ( '' === $label_html ) {
return $html;
}
$this->register_machine_readable_image(
(int) $attachment_id,
$plan['source_type'],
$this->extract_image_url( $html )
);
return '' . $html . $label_html . '';
}
/**
* Add the badge to explicitly marked featured images.
*
* @param string $html Featured image HTML.
* @param int $post_id Post ID.
* @param int $post_thumbnail_id Attachment ID.
* @param string|array $size Image size.
* @param string|array $attr Image attributes.
* @return string
*/
public function render_featured_image_label( $html, $post_id, $post_thumbnail_id, $size, $attr ) {
if ( empty( $this->settings()['enable_images'] ) ) {
return $html;
}
unset( $size, $attr );
if (
'' === $html ||
is_admin() ||
wp_doing_ajax() ||
is_feed() ||
false !== strpos( $html, 'gd-ai-featured-wrap' )
) {
return $html;
}
$library_source_type = $this->attachment_source_type( (int) $post_thumbnail_id );
if ( '' !== $library_source_type ) {
$this->register_machine_readable_image(
(int) $post_thumbnail_id,
$library_source_type,
$this->extract_image_url( $html )
);
}
$plan = $this->featured_label_plan( (int) $post_id, (int) $post_thumbnail_id );
if ( false === $plan ) {
return $html;
}
$label_html = $this->label_html( $plan['text'], (int) $post_thumbnail_id );
if ( '' === $label_html ) {
return $html;
}
$this->register_machine_readable_image(
(int) $post_thumbnail_id,
$plan['source_type'],
$this->extract_image_url( $html )
);
return '' . $html . $label_html . '';
}
/**
* Decide whether and how a featured image should be labelled.
*
* Explicit per-post marking takes precedence and keeps its custom text and
* source-type override. When the post is not explicitly marked, optional
* Media Library automatic labelling applies if the featured attachment is
* marked in the Library.
*
* @param int $post_id Post ID.
* @param int $attachment_id Featured attachment ID.
* @return array|false Array with text and source_type keys, or false.
*/
private function featured_label_plan( $post_id, $attachment_id ) {
$post_id = (int) $post_id;
if ( $post_id <= 0 ) {
return false;
}
if ( $this->get_compatible_post_meta( $post_id, self::META_FEATURED_ENABLED, 'featured_enabled' ) ) {
$custom_text = $this->get_compatible_post_meta( $post_id, self::META_FEATURED_TEXT, 'featured_text' );
$custom_text = is_string( $custom_text ) ? trim( sanitize_text_field( $custom_text ) ) : '';
$source_type = get_post_meta( $post_id, self::META_FEATURED_SOURCE_TYPE, true );
return array(
'text' => '' !== $custom_text ? $custom_text : $this->default_label_text_for_usage( $source_type, $attachment_id ),
'source_type' => $source_type,
);
}
if ( ! $this->media_auto_label_enabled() ) {
return false;
}
$media_status = $this->attachment_media_status( $attachment_id );
if ( ! in_array( $media_status, array( 'generated', 'modified' ), true ) ) {
return false;
}
return array(
'text' => $this->label_text_for_media_status( $media_status ),
'source_type' => '',
);
}
/**
* Extract the first image URL from rendered markup.
*
* @param string $html Rendered image markup.
* @return string
*/
private function extract_image_url( $html ) {
if ( class_exists( 'WP_HTML_Tag_Processor' ) ) {
$processor = new WP_HTML_Tag_Processor( (string) $html );
if ( $processor->next_tag( 'img' ) ) {
return esc_url_raw( (string) $processor->get_attribute( 'src' ) );
}
}
if ( preg_match( '/