* @copyright 2026 webhead GmbH */ declare( strict_types=1 ); namespace Webhead\WP\SearchCloud\Shortcodes; use Webhead\WP\SearchCloud\DTO\Products_Placement; use Webhead\WP\SearchCloud\Frontend\Placement_Config; use Webhead\WP\SearchCloud\Frontend\Search_Surface; use Webhead\WP\SearchCloud\Dependencies\Webhead\WP\Framework\Shortcodes\Abstract_Shortcode; defined( 'ABSPATH' ) || exit; /** * @since 1.4.0 */ final class Products_Shortcode extends Abstract_Shortcode { public const TAG = 'searcio_products'; public function __construct( private Placement_Config $config, private Search_Surface $surface ) {} public function tag(): string { return self::TAG; } public function description(): string { return __( 'A row of products from Searcio: similar to the product on the page, or a category listing.', 'searcio' ); } /** * @return array */ public function defaults(): array { return $this->config->products()->to_shortcode_defaults() + [ 'id' => '', 'field' => '', 'value' => '', 'class' => '', ]; } /** * @param array $attributes */ public function render( array $attributes = [], ?string $content = null, string $tag = '' ): string { $placement = Products_Placement::from_array( $attributes, $this->config->products() ); return $this->surface->products( $placement, [ 'documentId' => is_string( $attributes['id'] ?? null ) ? $attributes['id'] : '', 'filterField' => is_string( $attributes['field'] ?? null ) ? $attributes['field'] : '', 'filterValue' => is_string( $attributes['value'] ?? null ) ? $attributes['value'] : '', 'className' => is_string( $attributes['class'] ?? null ) ? $attributes['class'] : '', ] ); } }