Embedding widgets

Every widget can be embedded five ways; all of them render the same server-side HTML, so the choice is purely about your editing workflow.

Shortcode

[range_trust id="1"]

Any widget setting can be overridden inline for that one placement:

[range_trust id="1" layout="grid" columns="2" min_rating="5"]
[range_trust id="1" sources="3" tags="featured" order="random"]

Override names match the widget editor's settings: layout, style, columns, min_rating, limit, order, language, tags, sources, platforms, truncate, accent, star_color, header, show_avatar, show_date, show_platform, anonymise, and the rest. Booleans accept true/false, 1/0, yes/no.

Block editor

Add the Range Trust Reviews block and pick a widget; the editor shows the real rendered output.

Page builders

• Elementor: the Range Trust Reviews widget (with an optional layout override) under General.
• WPBakery: the Range Trust Reviews element.
• Divi, Bricks, Oxygen, anything else: use the shortcode in the builder's text/code module.
• Classic widget areas: the Range Trust Reviews widget under Appearance → Widgets.

Template tags

For theme code:

range_trust( 1 );                                  // echo widget 1
$html = range_trust( 1, array( 'layout' => 'badge' ), false );

$agg = range_trust_rating();                       // ['rating' => 4.8, 'count' => 212]
$agg = range_trust_rating( array( 'sources' => array( 2 ) ) );

foreach ( range_trust_reviews( array( 'min_rating' => 5, 'limit' => 3 ) ) as $review ) {
	echo esc_html( $review['reviewer'] ) . ': ' . esc_html( $review['content'] );
}

Theme template overrides

Every layout and part is a plain PHP template. Copy any file from the plugin's templates/ directory into a range-trust/ directory in your theme, keeping the relative path, and your copy wins:

wp-content/themes/your-theme/range-trust/layouts/grid.php
wp-content/themes/your-theme/range-trust/parts/card.php

Also see the ACF field type for editorial control over which widget appears where.