Appearance
Template Element Rendering Actions
This is the primary "customize the output" seam. Each template renders through a family of action hooks. Every hook has a default handler in core (app/Hooks/actions.php) and a richer override in Pro — which is exactly how Pro upgrades the free templates. Hook the same action to replace or augment a single piece of output without touching the template.
How to override a single element
Pattern — remove the core default, add your own on the same hook
php
add_action('wp_social_reviews_loaded_v2', function () {
// Replace the reviewer avatar output in review templates
remove_all_actions('wpsocialreviews/reviewer_image');
add_action('wpsocialreviews/reviewer_image', function ($review) {
echo '<img class="wpsr-avatar" src="' . esc_url($review['reviewer_img']) . '" alt="" />';
});
});TIP
Prefer targeting a specific callback with remove_action() (passing the exact handler) over remove_all_actions() when you want Pro's other enhancements to remain.
Reviews
Reviews element hooks
reviews_template_item_wrappers_before / _after, reviewer_image, reviewer_name, reviewer_rating, review_platform, review_date, review_content, review_title, review_images, review_ai_summary_list, render_ai_summary_total_reviews, author_position, author_website_logo, render_reviews_template_business_info, render_reviews_write_a_review_btn, reviews_template_wrapper_start / _end.
Registered in: app/Hooks/actions.php · Fired in: Views/public/reviews-templates/* (all hooks are prefixed wpsocialreviews/).
Testimonials
wpsocialreviews/review_video Pro 4.4.0 — The testimonial video block
When it runs: Fired in the Pro testimonial templates, immediately after wpsocialreviews/review_images and before the review header. Pro's ReviewsTemplateHandlerPro::renderReviewVideo() is the default handler; it decides between Fluent Player, an iframe, a file player, and a watch link.
Parameters:
$template_meta(array): the formatted template settings.$review(object): the review row — note this is an object, not an array, unlike the feed seams above.
Fired in: Pro Views/public/testimonial-templates/testimonial1.php, testimonial2.php
Usage:
php
add_action('wpsocialreviews/review_video', function ($template_meta, $review) {
if (empty($review->id)) {
return;
}
echo '<figcaption class="wpsr-video-credit">' . esc_html($review->reviewer_name) . '</figcaption>';
}, 20, 2);Playback itself is tuned through the Fluent Player filters on the Pro filters page.
Twitter / X
Twitter element hooks
tweet_author_avatar, tweet_author_info, tweet_author_username, tweet_time, tweet_content, tweet_actions, tweet_image, tweet_video, tweet_external_link, tweet_quoted_status, tweet_retweeted_status, tweeter_profile_banner, tweeter_user_profile_picture / _info / _description / _statistics / _follow_btn, tweeter_user_address.
YouTube
YouTube element hooks
youtube_feed_template_item_wrapper_before, youtube_channel_banner / _logo / _name / _statistics / _description / _subscribe_btn, youtube_feed_preview_image / _title / _statistics / _description, youtube_popup_content, youtube_template_wrapper_start / _end, render_youtube_prev_next_pagination.
Instagram
Instagram element hooks
instagram_feed_template_item_wrapper_before, instagram_post_media / _caption / _statistics, instagram_icon, instagram_user_avatar, instagram_header_statistics, instagram_follow_button, instagram_shoppable_button / _icon, instagram_post_author, instagram_post_date.
Since 4.5.0, core has its own handlers on instagram_follow_button and instagram_header_statistics, so the Follow button and the header counts work without Pro. Both return early when Pro is active, and Pro then renders its own versions.
instagram_post_author · instagram_post_date 4.5.0 — Author row and post time
Core Instagram templates fire both hooks for every post. Each hook passes 2 arguments, $feed, $template_meta. They are fired from template1.php (Classic Grid) and template2.php (Caption Card). They also run for the two templates that reuse those views: template6 (Author Bar, built on template1) and template5 (Author Card, built on template2).
Hook (wpsocialreviews/ prefixed) | Default handler | Renders on |
|---|---|---|
instagram_post_author | InstagramTemplateHandler::renderPostAuthor | template5, template6 only: header avatar, username, and post time |
instagram_post_date | InstagramTemplateHandler::renderPostDate | every template except template5 / template6 |
The two hooks split the work between templates, so a post's time is never printed twice. Both handlers use renderPostTime() ("3 days ago"). It prints nothing when post_settings.display_date is not 'true' or the post has no timestamp. The author row's avatar comes from $template_meta['_header_data']['avatar_url'].
Fired in: app/Views/public/feeds-templates/instagram/template1.php, template2.php
Usage:
php
add_action('wpsocialreviews/instagram_post_date', function ($feed, $template_meta) {
if (empty($feed['permalink'])) {
return;
}
echo '<a class="wpsr-ig-permalink" href="' . esc_url($feed['permalink']) . '">' . esc_html__('View', 'my-plugin') . '</a>';
}, 20, 2);Instagram overlay-card seams and their exact arguments 4.4.0
Instagram templates 3 and 4 (Pro) fire the seams below. The argument counts are what the templates actually pass — register with the matching count or your callback receives null.
Hook (wpsocialreviews/ prefixed) | Args | Signature |
|---|---|---|
instagram_feed_template_item_wrapper_before | 1 | $template_meta |
instagram_post_media | 4 | $feed, $template_meta, $index, $display_optimize_image |
instagram_post_avatar | 2 | $feed, $template_meta |
instagram_post_user_details | 2 | $feed, $template_meta |
instagram_post_time | 2 | $feed, $template_meta |
instagram_post_caption | 2 | $feed, $template_meta |
instagram_post_statistics | 2 | $feed, $template_meta |
instagram_icon | 0 | — |
instagram_shoppable_icon | 0 | — |
instagram_post_time is nested: it fires from inside Pro's renderPostUserDetails() handler, not from the template, so removing the instagram_post_user_details default also removes the time output.
instagram_icon fires twice per post in template 3 (the overlay bar and the hover state), and instagram_shoppable_icon fires only when the post carries shoppable options and the template's shoppable_settings.display_shoppable_icon is 'true'.
Fired in: Pro Views/public/feeds-templates/instagram/template3.php, template4.php, and Hooks/Handlers/InstagramTemplateHandlerPro.php
Usage:
php
add_action('wpsocialreviews/instagram_post_statistics', function ($feed, $template_meta) {
if (empty($feed['id'])) {
return;
}
echo '<span class="wpsr-ig-post-id">' . esc_html($feed['id']) . '</span>';
}, 20, 2);Facebook
Facebook element hooks
facebook_feed_template_item_wrapper_before, facebook_feed_template_content_wrapper_before, facebook_feed_author / _description / _media / _summary_card / _date / _statistics / _videos / _events / _album / _image / _like_button / _share_button / _photo_feed_image / _album_feed_info / _summary_card_image, load_more_button, facebook_feed_handle_album_photo.
TikTok
TikTok element hooks (custom_feed_for_tiktok/ namespace)
custom_feed_for_tiktok/tiktok_feed_template_item_wrapper_before, tiktok_feed_media / _author / _author_name / _description / _icon / _statistics / _date / _bio_description, tiktok_header_statistics, tiktok_follow_button, load_more_tiktok_button.
Fired in: TikTok Views/public/feeds-templates/tiktok/*
Asset loading
wpsocialreviews/load_template_assets · enqueue_product_context_styles
| Hook | Args | Purpose |
|---|---|---|
wpsocialreviews/load_template_assets | $templateId | Enqueue assets for a template |
wpsocialreviews/enqueue_product_context_styles | $post_id | Enqueue product-context styles |
Source: app/Hooks/Handlers/ShortcodeHandler.php
See also the Rendering & Template HTML filters for replacing whole template blocks (rather than a single element).