embed_fetch_count >= self::MAX_EMBED_FETCHES ) { return false; } ++$this->embed_fetch_count; return true; } /** * Supported audio providers with their configuration. * * @var array */ private const AUDIO_PROVIDERS = array( 'pocket-casts' => array( 'domains' => array( 'pca.st' ), 'base_url' => 'https://pca.st/', ), 'spotify' => array( 'domains' => array( 'open.spotify.com' ), 'base_url' => 'https://open.spotify.com/', ), 'soundcloud' => array( 'domains' => array( 'soundcloud.com' ), 'base_url' => 'https://soundcloud.com/', ), 'mixcloud' => array( 'domains' => array( 'mixcloud.com' ), 'base_url' => 'https://www.mixcloud.com/', ), 'reverbnation' => array( 'domains' => array( 'reverbnation.com' ), 'base_url' => 'https://www.reverbnation.com/', ), ); /** * Supported video providers with their configuration. * * @var array */ private const VIDEO_PROVIDERS = array( 'youtube' => array( 'domains' => array( 'youtube.com', 'youtu.be' ), 'base_url' => 'https://www.youtube.com/', ), 'videopress' => array( 'domains' => array( 'videopress.com', 'video.wordpress.com' ), 'base_url' => 'https://videopress.com/', ), 'vimeo' => array( 'domains' => array( 'vimeo.com', 'player.vimeo.com' ), 'base_url' => 'https://vimeo.com/', ), 'tiktok' => array( 'domains' => array( 'tiktok.com' ), 'base_url' => 'https://www.tiktok.com/', ), 'dailymotion' => array( 'domains' => array( 'dailymotion.com', 'dai.ly' ), 'base_url' => 'https://www.dailymotion.com/', ), ); /** * Get all supported providers (audio and video). * * @return array All supported providers. */ private function get_all_supported_providers(): array { return array_merge( array_keys( self::AUDIO_PROVIDERS ), array_keys( self::VIDEO_PROVIDERS ) ); } /** * Get all provider configurations (audio and video). * * @return array All provider configurations. */ private function get_all_provider_configs(): array { return array_merge( self::AUDIO_PROVIDERS, self::VIDEO_PROVIDERS ); } /** * Detect provider from content by checking against known domains. * * @param string $content Content to check for provider domains. * @return string Provider name or empty string if not found. */ private function detect_provider_from_domains( string $content ): string { $all_providers = $this->get_all_provider_configs(); foreach ( $all_providers as $provider => $config ) { foreach ( $config['domains'] as $domain ) { if ( strpos( $content, $domain ) !== false ) { return $provider; } } } return ''; } /** * Validate URL using both filter_var and wp_http_validate_url. * * @param string $url URL to validate. * @return bool True if URL is valid. */ private function is_valid_url( string $url ): bool { return ! empty( $url ) && filter_var( $url, FILTER_VALIDATE_URL ) && wp_http_validate_url( $url ); } /** * Create fallback attributes for link rendering. * * @param string $url URL for the fallback. * @param string $label Label for the fallback. * @return array Fallback attributes. */ private function create_fallback_attributes( string $url, string $label ): array { return array( 'url' => $url, 'label' => $label, ); } /** * Renders the embed block. * * @param string $block_content Block content. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context. * @return string */ public function render( string $block_content, array $parsed_block, Rendering_Context $rendering_context ): string { // Validate input parameters and required dependencies. if ( ! isset( $parsed_block['attrs'] ) || ! is_array( $parsed_block['attrs'] ) || ! class_exists( '\Automattic\WooCommerce\EmailEditor\Integrations\Utils\Table_Wrapper_Helper' ) ) { return ''; } $rendered = $this->render_embed( $block_content, $parsed_block, $rendering_context ); if ( '' === $rendered ) { return ''; } return $rendered . $this->render_caption( $block_content ); } /** * Renders the embed itself (player, thumbnail, card or link fallback) without the caption. * * @param string $block_content Block content. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context. * @return string */ private function render_embed( string $block_content, array $parsed_block, Rendering_Context $rendering_context ): string { $attr = $parsed_block['attrs']; // Check if this is a supported audio or video provider embed and has a valid URL. $provider = $this->get_supported_provider( $attr, $block_content ); if ( empty( $provider ) ) { // For non-supported embeds, try to render as a rich card using oEmbed data. // Only attempt the embed page fetch for WordPress embeds (type "wp-embed") // to avoid wasted HTTP requests to non-WordPress sites. $url = $this->extract_provider_url( $attr, $block_content ); $is_wp_embed = isset( $attr['type'] ) && 'wp-embed' === $attr['type']; if ( ! empty( $url ) && $is_wp_embed ) { $card_result = $this->render_link_embed_card( $url, $parsed_block, $rendering_context ); if ( ! empty( $card_result ) ) { return $card_result; } // Fetch failed or over the fetch cap — render as compact link card instead of plain link. return $this->render_compact_link_card( $url, $parsed_block, $rendering_context ); } return $this->render_link_fallback( $attr, $block_content, $parsed_block, $rendering_context ); } $url = $this->extract_provider_url( $attr, $block_content ); if ( empty( $url ) ) { // Provider was detected but URL extraction failed - provide graceful fallback. return $this->render_link_fallback( $attr, $block_content, $parsed_block, $rendering_context ); } // If we have a valid audio or video provider embed, proceed with normal rendering. return $this->render_content( $block_content, $parsed_block, $rendering_context ); } /** * Render the block's figcaption (if any) as a centered block appended below the embed output. * * @param string $block_content Block content. * @return string Caption HTML or empty string. */ private function render_caption( string $block_content ): string { if ( ! preg_match( '/]*>(.*?)<\/figcaption>/is', $block_content, $matches ) ) { return ''; } $caption = trim( $matches[1] ); if ( '' === $caption ) { return ''; } return '
' . Html_Processing_Helper::sanitize_caption_html( $caption ) . '
'; } /** * Renders the embed block content. * * @param string $block_content Block content. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context (required by parent contract but unused in this implementation). * @return string */ protected function render_content( string $block_content, array $parsed_block, Rendering_Context $rendering_context ): string { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable $attr = $parsed_block['attrs'] ?? array(); // Get provider and URL (validation already done in render method). $provider = $this->get_supported_provider( $attr, $block_content ); $url = $this->extract_provider_url( $attr, $block_content ); // Check if this is a video provider - render as video block. if ( $this->is_video_provider( $provider ) ) { return $this->render_video_embed( $url, $provider, $parsed_block, $rendering_context, $block_content ); } // For audio providers, use the original audio rendering logic. $label = $this->get_provider_label( $provider, $attr ); // Create a mock audio block structure to reuse the Audio renderer. $mock_audio_block = array( 'blockName' => 'core/audio', 'attrs' => array( 'src' => $url, 'label' => $label, ), 'innerHTML' => '
', ); // Copy email attributes to the mock block. if ( isset( $parsed_block['email_attrs'] ) ) { $mock_audio_block['email_attrs'] = $parsed_block['email_attrs']; } // Use the Audio renderer to render the audio provider embed. $audio_renderer = new Audio(); $audio_result = $audio_renderer->render( $mock_audio_block['innerHTML'], $mock_audio_block, $rendering_context ); // If audio rendering fails, fall back to a simple link. if ( empty( $audio_result ) ) { $fallback_attr = $this->create_fallback_attributes( $url, $label ); return $this->render_link_fallback( $fallback_attr, $block_content, $parsed_block, $rendering_context ); } return $audio_result; } /** * Get supported audio or video provider from block attributes or content. * * @param array $attr Block attributes. * @param string $block_content Block content. * @return string Provider name or empty string if not supported. */ private function get_supported_provider( array $attr, string $block_content ): string { $all_supported_providers = $this->get_all_supported_providers(); // Check provider name slug. if ( isset( $attr['providerNameSlug'] ) && in_array( $attr['providerNameSlug'], $all_supported_providers, true ) ) { return $attr['providerNameSlug']; } // Check for supported domains in URL or content. $url = $attr['url'] ?? ''; $content_to_check = ! empty( $url ) ? $url : $block_content; // Use sophisticated domain detection logic. return $this->detect_provider_from_domains( $content_to_check ); } /** * Extract URL from block content using DOM parsing. * * @param string $block_content Block content HTML. * @return string Extracted URL or empty string. */ private function extract_url_from_content( string $block_content ): string { $dom_helper = new Dom_Document_Helper( $block_content ); // Find the wp-block-embed__wrapper div. $wrapper_element = $dom_helper->find_element( 'div' ); if ( $wrapper_element ) { // Check if this div has the correct class. $class_attr = $dom_helper->get_attribute_value( $wrapper_element, 'class' ); if ( strpos( $class_attr, 'wp-block-embed__wrapper' ) !== false ) { // Get the text content (URL) from the div. $url = trim( $wrapper_element->textContent ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase // Decode HTML entities and validate URL. $url = html_entity_decode( $url, ENT_QUOTES | ENT_HTML5, 'UTF-8' ); // Validate the extracted URL. if ( $this->is_valid_url( $url ) ) { return $url; } } } return ''; } /** * Extract provider URL from block attributes or content. * * @param array $attr Block attributes. * @param string $block_content Block content. * @return string Provider URL or empty string. */ private function extract_provider_url( array $attr, string $block_content ): string { // First, try to get URL from attributes. if ( ! empty( $attr['url'] ) ) { $url = $attr['url']; // Validate the URL from attributes. if ( $this->is_valid_url( $url ) ) { return $url; } return ''; } // If not in attributes, extract from block content. return $this->extract_url_from_content( $block_content ); } /** * Get appropriate label for the provider. * * @param string $provider Provider name. * @param array $attr Block attributes. * @return string Label for the provider. */ private function get_provider_label( string $provider, array $attr ): string { // Use custom label if provided. if ( ! empty( $attr['label'] ) ) { return $attr['label']; } // Get translated label for the provider. return $this->get_translated_provider_label( $provider ); } /** * Get translated label for a provider. * * @param string $provider Provider name. * @return string Translated label for the provider. */ private function get_translated_provider_label( string $provider ): string { switch ( $provider ) { case 'spotify': return __( 'Listen on Spotify', 'woocommerce' ); case 'soundcloud': return __( 'Listen on SoundCloud', 'woocommerce' ); case 'pocket-casts': return __( 'Listen on Pocket Casts', 'woocommerce' ); case 'mixcloud': return __( 'Listen on Mixcloud', 'woocommerce' ); case 'reverbnation': return __( 'Listen on ReverbNation', 'woocommerce' ); case 'youtube': return __( 'Watch on YouTube', 'woocommerce' ); case 'videopress': return __( 'Watch on VideoPress', 'woocommerce' ); case 'vimeo': return __( 'Watch on Vimeo', 'woocommerce' ); case 'tiktok': return __( 'Watch on TikTok', 'woocommerce' ); case 'dailymotion': return __( 'Watch on Dailymotion', 'woocommerce' ); default: return __( 'Listen to the audio', 'woocommerce' ); } } /** * Render a simple link fallback for non-supported embeds. * * @param array $attr Block attributes. * @param string $block_content Block content. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context. * @return string Rendered link or empty string if no valid URL. */ private function render_link_fallback( array $attr, string $block_content, array $parsed_block, Rendering_Context $rendering_context ): string { // Try to get URL from attributes first. $url = $attr['url'] ?? ''; // If no URL in attributes, try to extract from block content. if ( empty( $url ) ) { // First try the standard wrapper div extraction. $url = $this->extract_url_from_content( $block_content ); // If still no URL, try to find any HTTP/HTTPS URL in the entire content. if ( empty( $url ) ) { $dom_helper = new Dom_Document_Helper( $block_content ); $body_element = $dom_helper->find_element( 'body' ); if ( $body_element ) { $text_content = $body_element->textContent; // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase // Look for HTTP/HTTPS URLs in the text content. $url = Html_Processing_Helper::extract_url_from_text( $text_content ); } } } // If still no URL, try to use provider-specific base URL if we have a provider. if ( empty( $url ) && isset( $attr['providerNameSlug'] ) ) { $url = $this->get_provider_base_url( $attr['providerNameSlug'] ); } // Validate URL with both filter_var and wp_http_validate_url. if ( ! $this->is_valid_url( $url ) ) { return ''; } // Get link text - use custom label if provided, otherwise use provider label for base URLs or URL. if ( ! empty( $attr['label'] ) ) { $link_text = $attr['label']; } else { // Check if this is a provider base URL (like https://open.spotify.com/). $provider = $attr['providerNameSlug'] ?? ''; $base_url = $this->get_provider_base_url( $provider ); if ( ! empty( $base_url ) && $url === $base_url ) { // Use provider-specific label for base URLs. $link_text = $this->get_provider_label( $provider, $attr ); } else { // Use the URL itself for specific URLs. $link_text = $url; } } // Get color from email attributes or theme styles. $email_styles = $rendering_context->get_theme_styles(); $link_color = $parsed_block['email_attrs']['color'] ?? $email_styles['color']['text'] ?? '#0073aa'; // Sanitize color value to ensure it's a valid hex color or CSS variable. $link_color = Html_Processing_Helper::sanitize_color( $link_color ); // Create a simple link. $link_html = sprintf( '%s', esc_url( $url ), esc_attr( $link_color ), esc_html( $link_text ) ); // Wrap with spacer if we have email attributes. return $this->add_spacer_with_context( $link_html, $parsed_block['email_attrs'] ?? array(), $rendering_context ); } /** * Get base URL for a provider when specific URL extraction fails. * * @param string $provider Provider name. * @return string Base URL for the provider or empty string. */ private function get_provider_base_url( string $provider ): string { $all_providers = $this->get_all_provider_configs(); return $all_providers[ $provider ]['base_url'] ?? ''; } /** * Check if a provider is a video provider. * * @param string $provider Provider name. * @return bool True if video provider. */ private function is_video_provider( string $provider ): bool { return array_key_exists( $provider, self::VIDEO_PROVIDERS ); } /** * Validate that a URL's host matches the expected provider's domains. * This prevents SSRF when provider is set via user-controlled attributes. * * @param string $url URL to validate. * @param string $provider Provider name. * @return bool True if URL host matches provider domains. */ private function url_matches_provider( string $url, string $provider ): bool { if ( ! $this->is_valid_url( $url ) ) { return false; } $parsed_url = wp_parse_url( $url ); if ( ! isset( $parsed_url['host'] ) ) { return false; } $url_host = strtolower( $parsed_url['host'] ); // Get allowed domains for this provider. $all_providers = $this->get_all_provider_configs(); $allowed_domains = $all_providers[ $provider ]['domains'] ?? array(); foreach ( $allowed_domains as $allowed_domain ) { $allowed_domain = strtolower( $allowed_domain ); if ( $url_host === $allowed_domain || str_ends_with( $url_host, '.' . $allowed_domain ) ) { return true; } } return false; } /** * Render a video embed using the Video renderer. * * @param string $url URL of the video. * @param string $provider Provider name. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context. * @param string $block_content Original block content. * @return string Rendered video embed or fallback. */ private function render_video_embed( string $url, string $provider, array $parsed_block, Rendering_Context $rendering_context, string $block_content ): string { // Validate URL matches the detected provider to prevent SSRF. // Provider can come from user-controlled providerNameSlug attribute, // so we must verify the URL actually belongs to that provider's domains. if ( ! $this->url_matches_provider( $url, $provider ) ) { $fallback_attr = $this->create_fallback_attributes( $url, $url ); return $this->render_link_fallback( $fallback_attr, $block_content, $parsed_block, $rendering_context ); } // Try to get video thumbnail URL. $poster_url = $this->get_video_thumbnail_url( $url, $provider ); // If no poster available, fall back to a simple link. if ( empty( $poster_url ) ) { $fallback_attr = $this->create_fallback_attributes( $url, $url ); return $this->render_link_fallback( $fallback_attr, $block_content, $parsed_block, $rendering_context ); } // Create a mock video block structure to reuse the Video renderer. $mock_video_block = array( 'blockName' => 'core/video', 'attrs' => array( 'poster' => $poster_url, 'videoUrl' => $url, ), 'innerHTML' => '
' . esc_url( $url ) . '
', ); // Copy email attributes to the mock block. if ( isset( $parsed_block['email_attrs'] ) ) { $mock_video_block['email_attrs'] = $parsed_block['email_attrs']; } // Use the Video renderer to render the video provider embed. $video_renderer = new Video(); $video_result = $video_renderer->render( $mock_video_block['innerHTML'], $mock_video_block, $rendering_context ); // If video rendering fails, fall back to a simple link. if ( empty( $video_result ) ) { $fallback_attr = $this->create_fallback_attributes( $url, $url ); return $this->render_link_fallback( $fallback_attr, $block_content, $parsed_block, $rendering_context ); } return $video_result; } /** * Get video thumbnail URL for supported providers. * * @param string $url Video URL. * @param string $provider Provider name. * @return string Thumbnail URL or empty string. */ private function get_video_thumbnail_url( string $url, string $provider ): string { // YouTube thumbnails follow a predictable URL pattern, so no HTTP request is needed. if ( 'youtube' === $provider ) { $thumbnail = $this->get_youtube_thumbnail( $url ); if ( '' !== $thumbnail ) { return $thumbnail; } // YouTube URLs without an extractable video ID (e.g. playlists) // fall through to the oEmbed thumbnail lookup below. } // All other supported video providers (VideoPress, Vimeo, TikTok, Dailymotion) // expose their thumbnails through the WordPress oEmbed API. // Returns empty string on failure, which triggers the link fallback. return $this->get_oembed_thumbnail( $url ); } /** * Extract YouTube video thumbnail URL. * * @param string $url YouTube video URL. * @return string Thumbnail URL or empty string. */ private function get_youtube_thumbnail( string $url ): string { // Extract video ID from various YouTube URL formats. The `videoseries` // token (used by playlist embed URLs like /embed/videoseries?list=…) is // not a real video ID, so it is excluded to fall through to oEmbed. $video_id = ''; if ( preg_match( '/(?:youtube\.com\/(?:watch\?v=|shorts\/|live\/|embed\/)|youtu\.be\/)(?!videoseries\b)([a-zA-Z0-9_-]+)/i', $url, $matches ) ) { $video_id = $matches[1]; } if ( empty( $video_id ) ) { return ''; } // Return YouTube thumbnail URL. // Using 0.jpg format as shown in the example. return 'https://img.youtube.com/vi/' . $video_id . '/0.jpg'; } /** * Extract a video thumbnail URL via the WordPress oEmbed API. * Used by providers that expose thumbnails through oEmbed (e.g. VideoPress, Vimeo). * Results are cached using transients to avoid repeated HTTP requests. * * Note: URL validation against the provider's domains is done in render_video_embed() * via url_matches_provider() before this method is called. * * @param string $url Video URL (pre-validated by caller). * @return string Thumbnail URL or empty string. */ private function get_oembed_thumbnail( string $url ): string { // Generate a cache key based on the URL. // The legacy "vp" prefix is kept so existing VideoPress caches survive; the key is used for all oEmbed video thumbnails. $cache_key = 'wc_email_vp_thumb_' . md5( $url ); // Check for cached thumbnail URL. $cached_thumbnail = get_transient( $cache_key ); if ( false !== $cached_thumbnail ) { // Return cached value (empty string means previous lookup failed). return is_string( $cached_thumbnail ) ? $cached_thumbnail : ''; } // Enforce the per-render fetch cap before making an HTTP request. // The result is intentionally not cached here, so the thumbnail can still be fetched on a later render. if ( ! $this->may_attempt_embed_fetch() ) { return ''; } // Use WP_oEmbed::get_data() to fetch thumbnail from oEmbed endpoint. // URL is pre-validated by render_video_embed() via url_matches_provider(), // ensuring only the matched provider's domains reach this point (SSRF mitigation). $oembed = new \WP_oEmbed(); $oembed_data = $oembed->get_data( $url ); /** * Filter the oEmbed cache time-to-live (TTL). * * This filter matches WordPress core's oembed_ttl filter signature: * - $ttl: Time to live in seconds (default: DAY_IN_SECONDS) * - $url: The URL being embedded * - $attr: Attributes array (empty in this context) * - $post_id: Post ID where embed is used (empty string here since email rendering is not post-specific) * * @param int $ttl Cache TTL in seconds. * @param string $url The embedded URL. * @param array $attr Attributes array. * @param string $post_id Post ID (empty string in email context). */ // Default TTL matches WordPress oEmbed cache (1 day). $cache_ttl = (int) apply_filters( 'oembed_ttl', DAY_IN_SECONDS, $url, array(), '' ); // get_data() returns object|false, so check for false or non-object. if ( false === $oembed_data || ! is_object( $oembed_data ) ) { // Cache empty result to avoid repeated failed lookups. set_transient( $cache_key, '', $cache_ttl ); return ''; } // Extract thumbnail_url from oEmbed response. if ( ! isset( $oembed_data->thumbnail_url ) ) { // Cache empty result. set_transient( $cache_key, '', $cache_ttl ); return ''; } $thumbnail_url = $oembed_data->thumbnail_url; // Validate the thumbnail URL. if ( is_string( $thumbnail_url ) && '' !== $thumbnail_url && $this->is_valid_url( $thumbnail_url ) ) { // Cache the valid thumbnail URL. set_transient( $cache_key, $thumbnail_url, $cache_ttl ); return $thumbnail_url; } // Cache empty result for invalid URLs. set_transient( $cache_key, '', $cache_ttl ); return ''; } /** * Fetch metadata from a WordPress embed page. * * WordPress sites expose a {url}/embed/ endpoint that renders a post preview * containing the title, excerpt, featured image, provider name, and site icon. * This single fetch provides all the data needed for the rich embed card. * * @param string $url URL of the post to fetch metadata for. * @return array{ title: string, thumbnail_url: string, provider_name: string, provider_url: string, excerpt: string, site_icon_url: string } Embed page metadata. */ private function fetch_embed_page_data( string $url ): array { $empty_result = array( 'title' => '', 'thumbnail_url' => '', 'provider_name' => '', 'provider_url' => '', 'excerpt' => '', 'site_icon_url' => '', ); $parsed = wp_parse_url( $url ); if ( empty( $parsed['scheme'] ) || empty( $parsed['host'] ) ) { return $empty_result; } $embed_url = $parsed['scheme'] . '://' . $parsed['host'] . ( isset( $parsed['port'] ) ? ':' . $parsed['port'] : '' ) . trailingslashit( $parsed['path'] ?? '/' ) . 'embed/'; if ( ! $this->is_valid_url( $embed_url ) ) { return $empty_result; } $cache_key = 'wc_email_embed_pg_' . md5( $url ); $cached = get_transient( $cache_key ); if ( false !== $cached && is_array( $cached ) && isset( $cached['title'], $cached['thumbnail_url'], $cached['provider_name'], $cached['provider_url'], $cached['excerpt'], $cached['site_icon_url'] ) && is_string( $cached['title'] ) && is_string( $cached['thumbnail_url'] ) && is_string( $cached['provider_name'] ) && is_string( $cached['provider_url'] ) && is_string( $cached['excerpt'] ) && is_string( $cached['site_icon_url'] ) ) { return array( 'title' => $cached['title'], 'thumbnail_url' => $cached['thumbnail_url'], 'provider_name' => $cached['provider_name'], 'provider_url' => $cached['provider_url'], 'excerpt' => $cached['excerpt'], 'site_icon_url' => $cached['site_icon_url'], ); } if ( is_string( $cached ) ) { // Negative cache (empty string from previous failure). return $empty_result; } // Enforce the per-render fetch cap before making an HTTP request. // The result is intentionally not cached, so the page can still be fetched on a later render. if ( ! $this->may_attempt_embed_fetch() ) { return $empty_result; } /** This filter is documented in packages/php/email-editor/src/Integrations/Core/Renderer/Blocks/class-embed.php */ $cache_ttl = (int) apply_filters( 'oembed_ttl', DAY_IN_SECONDS, $url, array(), '' ); $response = wp_safe_remote_get( $embed_url, array( 'timeout' => 5, 'limit_response_size' => 150 * KB_IN_BYTES, ) ); if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) { set_transient( $cache_key, '', $cache_ttl ); return $empty_result; } $body = wp_remote_retrieve_body( $response ); if ( empty( $body ) ) { set_transient( $cache_key, '', $cache_ttl ); return $empty_result; } // Parse HTML and extract metadata using XPath. $previous_libxml_errors = libxml_use_internal_errors( true ); try { $dom = new \DOMDocument(); $dom->loadHTML( '' . $body, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD ); libxml_clear_errors(); } finally { libxml_use_internal_errors( $previous_libxml_errors ); } $xpath = new \DOMXPath( $dom ); // Extract title from wp-embed-heading. $title = ''; $heading_nodes = $xpath->query( "//*[contains(concat(' ', normalize-space(@class), ' '), ' wp-embed-heading ')]" ); $heading_node = ( false !== $heading_nodes && $heading_nodes->length > 0 ) ? $heading_nodes->item( 0 ) : null; if ( $heading_node instanceof \DOMElement ) { $title = trim( $heading_node->textContent ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase } // Extract thumbnail from featured image. $thumbnail_url = ''; $featured_nodes = $xpath->query( "//*[contains(concat(' ', normalize-space(@class), ' '), ' wp-embed-featured-image ')]//img" ); $featured_node = ( false !== $featured_nodes && $featured_nodes->length > 0 ) ? $featured_nodes->item( 0 ) : null; if ( $featured_node instanceof \DOMElement ) { $img_src = $featured_node->getAttribute( 'src' ); if ( $this->is_valid_url( $img_src ) ) { $thumbnail_url = $img_src; } } // Extract provider name from site title. $provider_name = ''; $site_title_nodes = $xpath->query( "//*[contains(concat(' ', normalize-space(@class), ' '), ' wp-embed-site-title ')]//span" ); $site_title_node = ( false !== $site_title_nodes && $site_title_nodes->length > 0 ) ? $site_title_nodes->item( 0 ) : null; if ( $site_title_node instanceof \DOMElement ) { $provider_name = trim( $site_title_node->textContent ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase } // Extract provider URL from site title link. $provider_url = ''; $site_link_nodes = $xpath->query( "//*[contains(concat(' ', normalize-space(@class), ' '), ' wp-embed-site-title ')]//a" ); $site_link_node = ( false !== $site_link_nodes && $site_link_nodes->length > 0 ) ? $site_link_nodes->item( 0 ) : null; if ( $site_link_node instanceof \DOMElement ) { $href = $site_link_node->getAttribute( 'href' ); if ( $this->is_valid_url( $href ) ) { $provider_url = $href; } } // Extract excerpt. $excerpt = ''; $excerpt_nodes = $xpath->query( "//*[contains(concat(' ', normalize-space(@class), ' '), ' wp-embed-excerpt ')]" ); $excerpt_node = ( false !== $excerpt_nodes && $excerpt_nodes->length > 0 ) ? $excerpt_nodes->item( 0 ) : null; if ( $excerpt_node instanceof \DOMElement ) { $excerpt = trim( $excerpt_node->textContent ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase } // Cap at 200 characters as a safety limit. if ( mb_strlen( $excerpt ) > 200 ) { $excerpt = mb_substr( $excerpt, 0, 200 ); $excerpt = rtrim( $excerpt ) . '…'; } // Extract site icon URL. $site_icon_url = ''; $icon_nodes = $xpath->query( "//img[contains(concat(' ', normalize-space(@class), ' '), ' wp-embed-site-icon ')]" ); $icon_node = ( false !== $icon_nodes && $icon_nodes->length > 0 ) ? $icon_nodes->item( 0 ) : null; if ( $icon_node instanceof \DOMElement ) { $icon_src = $icon_node->getAttribute( 'src' ); if ( $this->is_valid_url( $icon_src ) ) { $site_icon_url = $icon_src; } } $result = array( 'title' => $title, 'thumbnail_url' => $thumbnail_url, 'provider_name' => $provider_name, 'provider_url' => $provider_url, 'excerpt' => $excerpt, 'site_icon_url' => $site_icon_url, ); set_transient( $cache_key, $result, $cache_ttl ); return $result; } /** * Render a link embed as a rich card using data from the WordPress embed page. * * @param string $url URL to render as a card. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context. * @return string Rendered card HTML or empty string if embed page data is insufficient. */ private function render_link_embed_card( string $url, array $parsed_block, Rendering_Context $rendering_context ): string { $embed_data = $this->fetch_embed_page_data( $url ); if ( empty( $embed_data['title'] ) ) { return ''; } $title = $embed_data['title']; $thumbnail_url = $embed_data['thumbnail_url']; $provider_name = ! empty( $embed_data['provider_name'] ) ? $embed_data['provider_name'] : (string) wp_parse_url( $url, PHP_URL_HOST ); $provider_url = $embed_data['provider_url']; $excerpt = $embed_data['excerpt']; $site_icon_url = $embed_data['site_icon_url']; $email_styles = $rendering_context->get_theme_styles(); $text_color = $email_styles['color']['text'] ?? '#1e1e1e'; $text_color = Html_Processing_Helper::sanitize_color( $text_color ); $link_color = $email_styles['elements']['link']['color']['text'] ?? '#0073aa'; $link_color = Html_Processing_Helper::sanitize_color( $link_color ); // Build card rows. $rows_html = ''; // Optional thumbnail row. if ( ! empty( $thumbnail_url ) ) { $thumbnail_cell = Table_Wrapper_Helper::render_table_cell( sprintf( '%s', esc_url( $url ), esc_url( $thumbnail_url ), esc_attr( $title ) ), array( 'style' => 'padding: 0;' ) ); $rows_html .= '' . $thumbnail_cell . ''; } // Build content: title, optional excerpt, provider. $content_parts = sprintf( '%s', esc_url( $url ), esc_attr( $text_color ), esc_html( $title ) ); if ( ! empty( $excerpt ) ) { $content_parts .= sprintf( '
%s', esc_attr( $text_color ), esc_html( $excerpt ) ); $content_parts .= sprintf( ' %s', esc_url( $url ), esc_attr( $link_color ), esc_html__( 'Continue reading', 'woocommerce' ) ); } // Provider row with optional site icon. $provider_text = ! empty( $provider_url ) ? sprintf( '%s', esc_url( $provider_url ), esc_attr( $text_color ), esc_html( $provider_name ) ) : sprintf( '%s', esc_attr( $text_color ), esc_html( $provider_name ) ); if ( ! empty( $site_icon_url ) ) { $content_parts .= sprintf( '' . '' . '' . '' . '
' . '' . '%s
', esc_url( $site_icon_url ), $provider_text ); } else { $content_parts .= '
' . $provider_text; } $content_cell = Table_Wrapper_Helper::render_table_cell( $content_parts, array( 'style' => 'padding: 12px;' ) ); $rows_html .= '' . $content_cell . ''; $card_html = sprintf( '' ); $card_html .= '' . $rows_html . '
'; $outlook_wrapped = Table_Wrapper_Helper::render_outlook_table_wrapper( $card_html, array( 'align' => $rendering_context->get_default_text_align(), 'width' => '100%', ) ); return $this->add_spacer_with_context( $outlook_wrapped, $parsed_block['email_attrs'] ?? array(), $rendering_context ); } /** * Render a compact link card for embeds that exceed the rich card cap. * Displays the URL in a bordered card without making any HTTP requests. * * @param string $url URL to render. * @param array $parsed_block Parsed block. * @param Rendering_Context $rendering_context Rendering context. * @return string Rendered compact link card HTML. */ private function render_compact_link_card( string $url, array $parsed_block, Rendering_Context $rendering_context ): string { $email_styles = $rendering_context->get_theme_styles(); $link_color = $email_styles['elements']['link']['color']['text'] ?? '#0073aa'; $link_color = Html_Processing_Helper::sanitize_color( $link_color ); // Build display text: strip scheme from URL. $display_host = (string) wp_parse_url( $url, PHP_URL_HOST ); $display_path = (string) wp_parse_url( $url, PHP_URL_PATH ); $display_text = $display_host . $display_path; $link_html = sprintf( '%s', esc_url( $url ), esc_attr( $link_color ), esc_html( $display_text ) ); $content_cell = Table_Wrapper_Helper::render_table_cell( $link_html, array( 'style' => 'padding: 12px;' ) ); $card_html = ''; $card_html .= '' . $content_cell . '
'; $outlook_wrapped = Table_Wrapper_Helper::render_outlook_table_wrapper( $card_html, array( 'align' => $rendering_context->get_default_text_align(), 'width' => '100%', ) ); return $this->add_spacer_with_context( $outlook_wrapped, $parsed_block['email_attrs'] ?? array(), $rendering_context ); } }