*/ class WC_Structured_Data { /** * @var array $_data */ private $_data = array(); /** * Constructor. */ public function __construct() { // Generate structured data. add_action( 'woocommerce_before_main_content', array( $this, 'generate_website_data' ), 30 ); add_action( 'woocommerce_breadcrumb', array( $this, 'generate_breadcrumblist_data' ), 10 ); add_action( 'woocommerce_shop_loop', array( $this, 'generate_product_data' ), 10 ); add_action( 'woocommerce_single_product_summary', array( $this, 'generate_product_data' ), 60 ); add_action( 'woocommerce_review_meta', array( $this, 'generate_review_data' ), 20 ); add_action( 'woocommerce_email_order_details', array( $this, 'generate_order_data' ), 20, 3 ); // Output structured data. add_action( 'woocommerce_email_order_details', array( $this, 'output_email_structured_data' ), 30, 3 ); add_action( 'wp_footer', array( $this, 'output_structured_data' ), 10 ); } /** * Sets data. * * @param array $data Structured data. * @param bool $reset Unset data (default: false). * @return bool */ public function set_data( $data, $reset = false ) { if ( ! isset( $data['@type'] ) || ! preg_match( '|^[a-zA-Z]{1,20}$|', $data['@type'] ) ) { return false; } if ( $reset && isset( $this->_data ) ) { unset( $this->_data ); } $this->_data[] = $data; return true; } /** * Gets data. * * @return array */ public function get_data() { return $this->_data; } /** * Structures and returns data. * * List of types available by default for specific request: * * 'product', * 'review', * 'breadcrumblist', * 'website', * 'order', * * @param array $types Structured data types. * @return array */ public function get_structured_data( $types ) { $data = array(); // Put together the values of same type of structured data. foreach ( $this->get_data() as $value ) { $data[ strtolower( $value['@type'] ) ][] = $value; } // Wrap the multiple values of each type inside a graph... Then add context to each type. foreach ( $data as $type => $value ) { if ( 1 < count( $value ) ) { $data[ $type ] = apply_filters( 'woocommerce_structured_data_context', array( '@context' => 'https://schema.org/' ), $data, $type, $value ) + array( '@graph' => $value ); } else { $data[ $type ] = $value[0]; } } // If requested types, pick them up... Finally change the associative array to an indexed one. $data = $types ? array_values( array_intersect_key( $data, array_flip( $types ) ) ) : array_values( $data ); if ( ! empty( $data ) ) { if ( 1 < count( $data ) ) { $data = apply_filters( 'woocommerce_structured_data_context', array( '@context' => 'https://schema.org/' ), $data, '', '' ) + array( '@graph' => $data ); } else { $data = $data[0]; } } return $data; } /** * Get data types for pages. * * @return array */ protected function get_data_type_for_page() { $types = array(); $types[] = is_shop() || is_product_category() || is_product() ? 'product' : ''; $types[] = is_shop() && is_front_page() ? 'website' : ''; $types[] = is_product() ? 'review' : ''; $types[] = ! is_shop() ? 'breadcrumblist' : ''; $types[] = 'order'; return array_filter( apply_filters( 'woocommerce_structured_data_type_for_page', $types ) ); } /** * Makes sure email structured data only outputs on non-plain text versions. * * @param WP_Order $order Order data. * @param bool $sent_to_admin Send to admin (default: false). * @param bool $plain_text Plain text email (default: false). */ public function output_email_structured_data( $order, $sent_to_admin = false, $plain_text = false ) { if ( $plain_text ) { return; } echo '
'; $this->output_structured_data(); echo '
'; } /** * Sanitizes, encodes and outputs structured data. * * Hooked into `wp_footer` action hook. * Hooked into `woocommerce_email_order_details` action hook. */ public function output_structured_data() { $types = $this->get_data_type_for_page(); if ( $data = wc_clean( $this->get_structured_data( $types ) ) ) { echo ''; } } /* |-------------------------------------------------------------------------- | Generators |-------------------------------------------------------------------------- | | Methods for generating specific structured data types: | | - Product | - Review | - BreadcrumbList | - WebSite | - Order | | The generated data is stored into `$this->_data`. | See the methods above for handling `$this->_data`. | */ /** * Generates Product structured data. * * Hooked into `woocommerce_single_product_summary` action hook. * Hooked into `woocommerce_shop_loop` action hook. * * @param WC_Product $product Product data (default: null). */ public function generate_product_data( $product = null ) { if ( ! is_object( $product ) ) { global $product; } if ( ! is_a( $product, 'WC_Product' ) ) { return; } $shop_name = get_bloginfo( 'name' ); $shop_url = home_url(); $currency = get_woocommerce_currency(); $markup = array( '@type' => 'Product', '@id' => get_permalink( $product->get_id() ), 'name' => $product->get_name(), ); if ( apply_filters( 'woocommerce_structured_data_product_limit', is_product_taxonomy() || is_shop() ) ) { $markup['url'] = $markup['@id']; $this->set_data( apply_filters( 'woocommerce_structured_data_product_limited', $markup, $product ) ); return; } $markup['image'] = wp_get_attachment_url( $product->get_image_id() ); $markup['description'] = $product->get_short_description() ?: $product->get_description(); $markup['sku'] = $product->get_sku(); if ( '' !== $product->get_price() ) { if ( $product->is_type( 'variable' ) ) { $prices = $product->get_variation_prices(); $lowest = reset( $prices['price'] ); $highest = end( $prices['price'] ); if ( $lowest === $highest ) { $markup_offer = array( '@type' => 'Offer', 'price' => wc_format_decimal( $lowest, wc_get_price_decimals() ), ); } else { $markup_offer = array( '@type' => 'AggregateOffer', 'lowPrice' => wc_format_decimal( $lowest, wc_get_price_decimals() ), 'highPrice' => wc_format_decimal( $highest, wc_get_price_decimals() ), ); } } else { $markup_offer = array( '@type' => 'Offer', 'price' => wc_format_decimal( $product->get_price(), wc_get_price_decimals() ), ); } $markup_offer += array( 'priceCurrency' => $currency, 'availability' => 'https://schema.org/' . ( $product->is_in_stock() ? 'InStock' : 'OutOfStock' ), 'url' => $markup['@id'], 'seller' => array( '@type' => 'Organization', 'name' => $shop_name, 'url' => $shop_url, ), ); $markup['offers'] = array( apply_filters( 'woocommerce_structured_data_product_offer', $markup_offer, $product ) ); } if ( $product->get_rating_count() ) { $markup['aggregateRating'] = array( '@type' => 'AggregateRating', 'ratingValue' => $product->get_average_rating(), 'ratingCount' => $product->get_rating_count(), 'reviewCount' => $product->get_review_count(), ); } $this->set_data( apply_filters( 'woocommerce_structured_data_product', $markup, $product ) ); } /** * Generates Review structured data. * * Hooked into `woocommerce_review_meta` action hook. * * @param WP_Comment $comment Comment data. */ public function generate_review_data( $comment ) { $markup = array(); $markup['@type'] = 'Review'; $markup['@id'] = get_comment_link( $comment->comment_ID ); $markup['datePublished'] = get_comment_date( 'c', $comment->comment_ID ); $markup['description'] = get_comment_text( $comment->comment_ID ); $markup['itemReviewed'] = array( '@type' => 'Product', 'name' => get_the_title( $comment->comment_post_ID ), ); if ( $rating = get_comment_meta( $comment->comment_ID, 'rating', true ) ) { $markup['reviewRating'] = array( '@type' => 'rating', 'ratingValue' => $rating, ); // Skip replies unless they have a rating. } elseif ( $comment->comment_parent ) { return; } $markup['author'] = array( '@type' => 'Person', 'name' => get_comment_author( $comment->comment_ID ), ); $this->set_data( apply_filters( 'woocommerce_structured_data_review', $markup, $comment ) ); } /** * Generates BreadcrumbList structured data. * * Hooked into `woocommerce_breadcrumb` action hook. * * @param WC_Breadcrumb $breadcrumbs Breadcrumb data. */ public function generate_breadcrumblist_data( $breadcrumbs ) { $crumbs = $breadcrumbs->get_breadcrumb(); if ( empty( $crumbs ) || ! is_array( $crumbs ) ) { return; } $markup = array(); $markup['@type'] = 'BreadcrumbList'; $markup['itemListElement'] = array(); foreach ( $crumbs as $key => $crumb ) { $markup['itemListElement'][ $key ] = array( '@type' => 'ListItem', 'position' => $key + 1, 'item' => array( 'name' => $crumb[0], ), ); if ( ! empty( $crumb[1] ) && sizeof( $crumbs ) !== $key + 1 ) { $markup['itemListElement'][ $key ]['item'] += array( '@id' => $crumb[1] ); } } $this->set_data( apply_filters( 'woocommerce_structured_data_breadcrumblist', $markup, $breadcrumbs ) ); } /** * Generates WebSite structured data. * * Hooked into `woocommerce_before_main_content` action hook. */ public function generate_website_data() { $markup = array(); $markup['@type'] = 'WebSite'; $markup['name'] = get_bloginfo( 'name' ); $markup['url'] = home_url(); $markup['potentialAction'] = array( '@type' => 'SearchAction', 'target' => home_url( '?s={search_term_string}&post_type=product' ), 'query-input' => 'required name=search_term_string', ); $this->set_data( apply_filters( 'woocommerce_structured_data_website', $markup ) ); } /** * Generates Order structured data. * * Hooked into `woocommerce_email_order_details` action hook. * * @param WP_Order $order Order data. * @param bool $sent_to_admin Send to admin (default: false). * @param bool $plain_text Plain text email (default: false). */ public function generate_order_data( $order, $sent_to_admin = false, $plain_text = false ) { if ( $plain_text || ! is_a( $order, 'WC_Order' ) ) { return; } $shop_name = get_bloginfo( 'name' ); $shop_url = home_url(); $order_url = $sent_to_admin ? admin_url( 'post.php?post=' . absint( $order->get_id() ) . '&action=edit' ) : $order->get_view_order_url(); $order_statuses = array( 'pending' => 'https://schema.org/OrderPaymentDue', 'processing' => 'https://schema.org/OrderProcessing', 'on-hold' => 'https://schema.org/OrderProblem', 'completed' => 'https://schema.org/OrderDelivered', 'cancelled' => 'https://schema.org/OrderCancelled', 'refunded' => 'https://schema.org/OrderReturned', 'failed' => 'https://schema.org/OrderProblem', ); $markup_offers = array(); foreach ( $order->get_items() as $item ) { if ( ! apply_filters( 'woocommerce_order_item_visible', true, $item ) ) { continue; } $product = apply_filters( 'woocommerce_order_item_product', $order->get_product_from_item( $item ), $item ); $product_exists = is_object( $product ); $is_visible = $product_exists && $product->is_visible(); $markup_offers[] = array( '@type' => 'Offer', 'price' => $order->get_line_subtotal( $item ), 'priceCurrency' => $order->get_currency(), 'priceSpecification' => array( 'price' => $order->get_line_subtotal( $item ), 'priceCurrency' => $order->get_currency(), 'eligibleQuantity' => array( '@type' => 'QuantitativeValue', 'value' => apply_filters( 'woocommerce_email_order_item_quantity', $item['qty'], $item ), ), ), 'itemOffered' => array( '@type' => 'Product', 'name' => apply_filters( 'woocommerce_order_item_name', $item['name'], $item, $is_visible ), 'sku' => $product_exists ? $product->get_sku() : '', 'image' => $product_exists ? wp_get_attachment_image_url( $product->get_image_id() ) : '', 'url' => $is_visible ? get_permalink( $product->get_id() ) : get_home_url(), ), 'seller' => array( '@type' => 'Organization', 'name' => $shop_name, 'url' => $shop_url, ), ); } $markup = array(); $markup['@type'] = 'Order'; $markup['url'] = $order_url; $markup['orderStatus'] = isset( $order_statuses[ $order->get_status() ] ) ? $order_statuses[ $order->get_status() ] : ''; $markup['orderNumber'] = $order->get_order_number(); $markup['orderDate'] = $order->get_date_created()->format( 'c' ); $markup['acceptedOffer'] = $markup_offers; $markup['discount'] = $order->get_total_discount(); $markup['discountCurrency'] = $order->get_currency(); $markup['price'] = $order->get_total(); $markup['priceCurrency'] = $order->get_currency(); $markup['priceSpecification'] = array( 'price' => $order->get_total(), 'priceCurrency' => $order->get_currency(), 'valueAddedTaxIncluded' => true, ); $markup['billingAddress'] = array( '@type' => 'PostalAddress', 'name' => $order->get_formatted_billing_full_name(), 'streetAddress' => $order->get_billing_address_1(), 'postalCode' => $order->get_billing_postcode(), 'addressLocality' => $order->get_billing_city(), 'addressRegion' => $order->get_billing_state(), 'addressCountry' => $order->get_billing_country(), 'email' => $order->get_billing_email(), 'telephone' => $order->get_billing_phone(), ); $markup['customer'] = array( '@type' => 'Person', 'name' => $order->get_formatted_billing_full_name(), ); $markup['merchant'] = array( '@type' => 'Organization', 'name' => $shop_name, 'url' => $shop_url, ); $markup['potentialAction'] = array( '@type' => 'ViewAction', 'name' => 'View Order', 'url' => $order_url, 'target' => $order_url, ); $this->set_data( apply_filters( 'woocommerce_structured_data_order', $markup, $sent_to_admin, $order ), true ); } }