Overview
This document describes the architecture of the Verdant Ride homepage and provides step-by-step instructions for recovering the hero image/slider if it is ever accidentally removed.
Last verified: April 25, 2026
Site URL: https://verdantride.com/
WordPress Theme: Twenty Twenty-Four (twentytwentyfour)
Home page post: “Solid State (Raytrace)” — Post ID 62
Homepage Architecture
The homepage is built from two separate components that work together:
1. The Front Page Template (Site Editor)
This is a WordPress Full Site Editor (FSE) template that wraps the page content. It lives in the Site Editor, not in the regular Pages editor.
Template ID: twentytwentyfour//front-page
How to access: WP Admin → Appearance → Editor → Templates → Front Page
The correct block structure of the Front Page Template is:
<!-- wp:template-part (header, transparent-header) /-->
<!-- wp:shortcode --> <!-- /wp:shortcode -->
<!-- wp:post-content /-->
<!-- wp:template-part (footer) /-->The shortcode renders the rotating hero image slider at the very top of the homepage, above all page content.
2. The Home Page Content (Post ID 62)
This is the actual page content edited via Pages → Solid State (Raytrace).
How to access: WP Admin → Pages → Solid State (Raytrace) → Edit
Direct URL: /wp-admin/post.php?post=62&action=edit
Template assigned: Front Page
Page content block order (top to bottom):
- shortcode — community stats widget + map225Total Rides Logged2,524.3Community Miles176.1Community Hours0.16Avg Efficiency
(miles per % battery)🌊 Where the community is riding
Brand: Lift Flite SiFly Waydoo OtherLocations are jittered ~±4 km to protect rider privacy. Only approximate body of water is shown. - Group → my-plugin/image-button — the “LOG YOUR RIDE” button
- Group → Group → Cover block (Hero1 background image) → “Under Construction” section with heading and image
- Buttons block — “Access a massive library of free music” link
- cb/carousel-v2 with 3 slides — music player carousel (vr_songs shortcodes)
- Cover block → “Join 1500+ subscribers” sign-up section with Sign Up button
How the Hero Image Works
The hero is rendered by the shortcode, which is a custom shortcode registered by a plugin on this site. It outputs a full-width rotating image slider at the top of the page.
Important: This shortcode lives in the Front Page Template — NOT in the page content. If you open the page editor (Pages → Edit), you will not see the hero there. It is in the template layer above.
⚠️ Hero Image Recovery Instructions
If the hero image disappears from the homepage, follow these steps:
Step 1 — Check the Front Page Template
Go to: WP Admin → Appearance → Editor (this opens the Full Site Editor). Click on Templates in the left sidebar, then click Front Page.
Look for a Shortcode block containing between the Header and the page Content block. If it is missing or empty, that is the problem.
Step 2 — Add the shortcode back
In the Front Page Template editor, click the + button to add a new block between the Header and the Content block. Search for Shortcode, add it, and enter:
Click Save. The hero should immediately reappear on the homepage.
Step 3 — Alternative: Restore via browser console (advanced)
If you cannot access the Site Editor UI, paste this into the browser console on any logged-in WP admin page:
wp.apiFetch({
path: '/wp/v2/templates/twentytwentyfour//front-page?context=edit',
method: 'GET'
}).then(data => {
const current = data.content.raw;
if (current.includes(' ')) {
console.log('Hero shortcode already present!');
return;
}
const heroBlock = '
<!-- wp:shortcode --> <!-- /wp:shortcode -->
';
const postContentTag = '<!-- wp:post-content /-->';
const idx = current.indexOf(postContentTag);
const newContent = current.substring(0, idx) + heroBlock + current.substring(idx);
return wp.apiFetch({
path: '/wp/v2/templates/twentytwentyfour//front-page',
method: 'PUT',
data: { content: newContent }
});
}).then(r => r && console.log('Hero restored!'));Common Mistakes to Avoid
- Do not look for the hero in Pages → Edit. The hero shortcode is in the template layer, not the page content. Looking in the Pages editor will not show it.
- Do not delete blocks from the Site Editor without knowing what they are. The shortcode block in the Front Page template is easy to accidentally remove because it looks small and unremarkable.
- If renders as plain text, check that the hero slider plugin is active in WP Admin → Plugins.
- Template changes are immediately live on the homepage as soon as you click Save in the Site Editor.
Reference: Correct Front Page Template (as of April 25, 2026)
The complete raw content of the Front Page Template when working correctly:
<!-- wp:template-part {"slug":"header","theme":"twentytwentyfour","tagName":"header","area":"header","className":"transparent-header"} /-->
<!-- wp:shortcode --> <!-- /wp:shortcode -->
<!-- wp:post-content /-->
<!-- wp:template-part {"slug":"footer","theme":"twentytwentyfour","tagName":"footer","area":"footer"} /-->