';
foreach ( $reviews as $review ) {
$response .= self::get_review( $review );
}
$response .= '
';
}
$load_more = self::render_load_more_button( $reviews_count, $reviews_needed, $offset );
return array( 'reviews' => $response, 'load_more' => $load_more );
}
/**
* Render a "load more" button if additional reviews exist.
*
* @since 2.2.5
*
* @param int $total Total review count.
* @param int $per_page Reviews per page.
* @param int $offset Current offset.
*
* @return string HTML or empty string.
*/
private static function render_load_more_button( int $total, int $per_page, int $offset ): string {
if ( $total <= $per_page || $offset + $per_page >= $total ) {
return '';
}
return ''
. '' . esc_html__( 'Load more', 'merchant' ) . ' '
. '
';
}
// ───────────────────────────────────────────────────────────────
// Single review rendering
// ───────────────────────────────────────────────────────────────
/**
* Render a single review comment as HTML.
*
* @since 1.10.4
*
* @param int $review_id The WooCommerce review (comment) ID.
*
* @return string Rendered review HTML.
*/
public static function get_review( $review_id ) {
$review = get_comment( $review_id );
if ( ! $review ) {
/** @since 1.10.4 */
return apply_filters( 'merchant_single_review_item_rendered', '', null );
}
$product = wc_get_product( $review->comment_post_ID );
if ( ! $product ) {
/** @since 1.10.4 */
return apply_filters( 'merchant_single_review_item_rendered', '', $review );
}
$response = self::render_review_header( $review, $product );
$response .= self::render_review_body( $review, $product );
$response .= self::render_review_actions( $review );
$response .= '';
/** @since 1.10.4 */
return apply_filters( 'merchant_single_review_item_rendered', $response, $review );
}
/**
* Render review header: checkbox + author + product image/name + rating.
*
* @since 2.2.5
*
* @param object $review Comment object.
* @param WC_Product $product Product object.
*
* @return string HTML.
*/
private static function render_review_header( $review, $product ): string {
$edit_link = get_edit_post_link( $product->get_id() );
$rating = get_comment_meta( $review->comment_ID, 'rating', true );
$status = wp_get_comment_status( $review->comment_ID );
$html = '';
$html .= '
';
$html .= '
' . esc_html( $review->comment_author ) . '
';
$html .= '
';
$html .= '
';
$html .= '
' . wc_get_rating_html( $rating ) . '
';
$html .= '
' . esc_html( $status ) . '
';
return $html;
}
/**
* Render review body: content + photos + date + edit link.
*
* @since 2.2.5
*
* @param object $review Comment object.
* @param WC_Product $product Product object.
*
* @return string HTML.
*/
private static function render_review_body( $review, $product ): string {
$html = '
' . esc_html( wp_trim_words( $review->comment_content, 8, '...' ) ) . '
';
$html .= '
';
$html .= '
'
. '
' . esc_attr__( 'View customer\'s uploaded review photos.', 'merchant' ) . '
'
. self::get_review_main_photo( $review->comment_ID )
. '
';
$html .= '
' . esc_html( get_comment_date( 'j/n/Y', $review->comment_ID ) ) . '
';
$html .= '
';
return $html;
}
/**
* Render review action buttons: delete + move.
*
* @since 2.2.5
*
* @param object $review Comment object.
*
* @return string HTML.
*/
private static function render_review_actions( $review ): string {
$html = '
';
$html .= '
';
return $html;
}
/**
* Get the primary photo thumbnail for a review.
*
* @since 1.10.4
*
* @param int $comment_id The review (comment) ID.
*
* @return string Rendered HTML or empty string.
*/
public static function get_review_main_photo( $comment_id ) {
$photos_ids = get_comment_meta( $comment_id, 'review_images', true );
if ( empty( $photos_ids ) ) {
return '';
}
$response = '';
$first_image = wp_get_attachment_image_url( $photos_ids[0], array( 60, 60 ) );
$counter = '';
if ( count( $photos_ids ) > 1 ) {
$counter = '
' . count( $photos_ids ) . ' ';
}
$response .= '
' . $counter . '
';
return $response;
}
// ───────────────────────────────────────────────────────────────
// Product data list item
// ───────────────────────────────────────────────────────────────
/**
* Render a product as an `
` element for the product selector.
*
* @since 2.2.5
*
* @param WC_Product $product The WooCommerce product object.
* @param bool|array $search Whether this is a search result (true = "Add" button).
* @param bool $hierarchy Whether to apply hierarchy indentation.
*
* @return string Rendered HTML.
*/
public static function product_data_li( $product, $search = false, $hierarchy = false ): string {
$attrs = self::build_product_li_attributes( $product, $hierarchy );
$html = ' ';
$html .= self::render_product_image_html( $product );
$html .= self::render_product_data_html( $product );
$html .= self::render_product_type_and_button( $product, $search );
$html .= ' ';
return $html;
}
/**
* Build HTML attributes for a product list item.
*
* @since 2.2.5
*
* @param WC_Product $product Product object.
* @param bool $hierarchy Whether to show hierarchy.
*
* @return string Attribute string.
*/
private static function build_product_li_attributes( $product, bool $hierarchy ): string {
$product_id = $product->get_id();
$product_sku = $product->get_sku();
$product_name = $product->get_name();
$price = $product->get_price();
$key = $product_id . '_' . $product_sku;
$item_class = 'product-item';
if ( $hierarchy && $product->is_type( 'variation' ) ) {
$item_class .= ' hierarchy-style';
}
return 'class="' . esc_attr( $item_class ) . '"'
. ' data-key="' . esc_attr( $key ) . '"'
. ' data-name="' . esc_attr( $product_name ) . '"'
. ' data-sku="' . esc_attr( $product_sku ) . '"'
. ' data-id="' . esc_attr( $product_id ) . '"'
. ' data-price="' . esc_attr( $price ) . '"';
}
/**
* Render the product image with wp_kses.
*
* @since 2.2.5
*
* @param WC_Product $product Product object.
*
* @return string Sanitized image HTML.
*/
private static function render_product_image_html( $product ): string {
/** @since 1.9.1 */
$product_image = apply_filters(
'merchant_product_item_product_image',
'
' . $product->get_image( array( 30, 30 ) ) . ' ',
$product
);
return wp_kses( $product_image, array(
'span' => array( 'class' => true ),
'img' => array(
'src' => true, 'alt' => true, 'decoding' => true, 'srcset' => true,
'loading' => true, 'sizes' => true, 'class' => true, 'width' => true, 'height' => true,
),
) );
}
/**
* Render product name, price, and sold-individually notice.
*
* @since 2.2.5
*
* @param WC_Product $product Product object.
*
* @return string HTML.
*/
private static function render_product_data_html( $product ): string {
$price_html = wp_kses( $product->get_price_html(), array(
'span' => array( 'class' => true ),
'del' => array( 'aria-hidden' => true ),
'ins' => array(),
'bdi' => array(),
) );
$sold_individually = $product->is_sold_individually()
? '
' . esc_html__( 'sold individually', 'merchant' ) . ' '
: '';
return '
'
. '' . esc_html( $product->get_name() ) . ' '
. '' . $price_html . ' '
. $sold_individually
. ' ';
}
/**
* Render product type badge and add/remove button.
*
* @since 2.2.5
*
* @param WC_Product $product Product object.
* @param bool $search True for "Add" button, false for "Remove".
*
* @return string HTML.
*/
private static function render_product_type_and_button( $product, bool $search ): string {
$product_id = $product->get_id();
$edit_link = get_edit_post_link( $product_id );
if ( $product->is_type( 'variation' ) ) {
$edit_link = get_edit_post_link( $product->get_parent_id() );
}
/** @since 1.9.0 */
$product_info = apply_filters( 'merchant_pro_product_bundle_item_product_info', $product->get_type() . '
#' . $product_id, $product );
$btn_label = $search
? esc_html__( 'Add', 'merchant' )
: esc_html__( 'Remove', 'merchant' );
$btn_char = $search ? '+' : '×';
$remove_btn = '
' . $btn_char . ' ';
return '
' . wp_kses_post( $product_info ) . ' '
. wp_kses( $remove_btn, array( 'span' => array( 'class' => true, 'aria-label' => true ) ) );
}
// ───────────────────────────────────────────────────────────────
// Variation helpers
// ───────────────────────────────────────────────────────────────
/**
* Check if all variation attributes are set for a product variation.
*
* @since 2.2.5
*
* @param WC_Product_Variation $variation The variation product object.
*
* @return bool True if all attributes are set, false otherwise.
*/
public static function are_variation_attributes_set( $variation ) {
if ( $variation && $variation->is_type( 'variation' ) ) {
$variation_attributes = $variation->get_variation_attributes();
foreach ( $variation_attributes as $attribute => $value ) {
if ( empty( $value ) ) {
return false;
}
}
return true;
}
return false;
}
}
// Initialize.
new Merchant_Admin_Ajax();