HTML
The document
Write index.html as the content of the page body. The application removes <!DOCTYPE>, <html>, <head>…</head> and <body> and builds the head itself (see render pipeline).
Removed by the sanitizer
Elements: <script> <iframe> <object> <embed> <base> <applet> <frame> <frameset> <meta> <link> <style>. Also every on… event attribute, javascript:/vbscript:/data:text/html URLs, cross-origin form actions, srcdoc, and style attributes with external url(). Put behaviour in script.js and styles in styles.css.
Template directives
Directive names: FOREACH, ENDFOREACH, IF, ELSE, ENDIF, LOOP, ENDLOOP, COUNT, AVG template-engine.js:168
| Form | Meaning |
|---|---|
<!-- IF PATH -->…<!-- ELSE -->…<!-- ENDIF --> | Renders the first branch when PATH is truthy (arrays: non-empty). Comparisons: ==, ===, !=, !==, >, >=, <, <= against a data path, number, true/false/null or quoted string. |
<!-- FOREACH LIST -->…<!-- ENDFOREACH --> | Repeats the body for each item of an array; inside, {ITEM.x}, {INDEX} (1-based) and {EVEN_ODD} are available. |
<!-- LOOP n -->…<!-- ENDLOOP --> | Repeats the body n times; {LOOP_INDEX} and {INDEX_MOD_k} are available. |
<!-- COUNT LIST -->, <!-- COUNT LIST WITH prop -->, <!-- COUNT LIST WITH prop == value --> | Prints a count. |
<!-- AVG LIST prop --> | Prints the average of a numeric property (2 decimals). |
Blocks must be balanced (IF/ENDIF, FOREACH/ENDFOREACH, LOOP/ENDLOOP). An unbalanced template fails to load ("Template parse error") and the previous version stays active.
Placeholders
| Form | Meaning |
|---|---|
{KEY} or {OBJ.prop} | HTML-escaped value. A placeholder whose first part is not a data key is left untouched in the page (so typos stay visible). |
{{{KEY}}} | Raw value without escaping. Note: the page is sanitized after rendering (scripts, event handlers, etc. are removed). |
Available values are listed under Data.
Pages (routes)
The page is a single HTML document. Each storefront route shows the element with id "section-<route>" and class "app-section" and hides the others (class "active" marks the visible one). Elements with data-nav="<route>" or class "nav-link" + data-section="<route>" navigate.
| Route | Element | Hash URL | SEO URL |
|---|---|---|---|
home | #section-home | #home | / |
products | #section-products | #products | /products |
product-detail | #section-product-detail | #product-detail | /product/:id |
featured | #section-featured | #featured | /featured |
wishlist | #section-wishlist | #wishlist | /wishlist |
cart | #section-cart | #cart | /cart |
checkout | #section-checkout | #checkout | /checkout |
profile | #section-profile | #profile | /profile |
terms | #section-terms | #terms | /terms |
refund-policy | #section-refund-policy | #refund-policy | /refund-policy |
privacy-policy | #section-privacy-policy | #privacy-policy | /privacy-policy |
- hash: Default: /#products, /#product-detail?id=…
- path: When the store uses SEO URLs (pos_setting.store.urlStructure = "seo"): /products, /product/:id …
Engine hooks
The storefront engine (/assets/storefront/engine.js) finds its elements by id, class and data attribute. These are the hooks it uses (201 in total). "Used by" counts the installed templates that contain the hook. Hooks marked generated are created by the engine at runtime — style them, don't write them.
Pages and navigation
The page is a single HTML document. Each storefront route shows the element with id "section-<route>" and class "app-section" and hides the others (class "active" marks the visible one). Elements with data-nav="<route>" or class "nav-link" + data-section="<route>" navigate.
| Selector | Description | Used by |
|---|---|---|
.app-section | Every route container. Only the active one should be visible (your CSS: .app-section{display:none} .app-section.active{display:block}). | 15/15 |
.main-nav | Navigation container whose .nav-link items are de-activated on route change. | 14/15 |
.nav-link | Navigation link; gets class "active" for the current route when it has data-section. | 15/15 |
.nav-profile-item | Shown only when a customer is signed in. | 15/15 |
#mainNav | Main navigation. Gets class "open" when #mobileMenuBtn is pressed. | 14/15 |
#mobileMenuBtn | Menu toggle button (aria-expanded is kept in sync; body gets class "sf-nav-open"). | 15/15 |
#mobileNav | Optional separate mobile navigation (takes precedence over #mainNav for the menu button). | 1/15 |
#section-cart | Cart (route "cart"). | 15/15 |
#section-checkout | Checkout (route "checkout"). | 15/15 |
#section-featured | Featured products (route "featured"). | 15/15 |
#section-home | Home page (route "home"). Also the fallback for unknown routes. | 15/15 |
#section-privacy-policy | Privacy policy (route "privacy-policy"). | 15/15 |
#section-product-detail | Single product (route "product-detail"). | 15/15 |
#section-products | Product list with filters (route "products"). | 15/15 |
#section-profile | Account pages (route "profile"; shows the login modal when signed out). | 15/15 |
#section-refund-policy | Refund policy (route "refund-policy"). | 15/15 |
#section-terms | Terms page (route "terms"). | 15/15 |
#section-wishlist | Saved items (route "wishlist"). | 15/15 |
Header counters, account and search
Live counters, the account menu and product search with suggestions.
| Selector | Description | Used by |
|---|---|---|
#cartCount | Number of items in the cart (class "sf-empty-count" when zero). | 15/15 |
#searchClose | Closes the search overlay. | 1/15 |
#searchContainer | Search wrapper toggled with class "open"/"active" by #searchToggleBtn. | 9/15 |
#searchInput | Search box. Typing shows suggestions; Enter searches the products page. | 15/15 |
#searchOverlay | Full-screen search overlay (used instead of #searchPanel when present). | 1/15 |
#searchPanel | Optional dropdown panel toggled together with #searchContainer. | 7/15 |
#searchSuggestions | Suggestion list container (class "active" when open). | 15/15 |
#searchToggle | Alternative id for the search toggle button. | 1/15 |
#searchToggleBtn | Opens/closes the search panel. | 7/15 |
#userMenu | Replaced with "Log in / Register" buttons or the signed-in customer's name, account and logout buttons. | 15/15 |
#wishlistCount | Number of saved items. | 15/15 |
Store selection
When several stores are active the shopper must choose one before products are shown. The engine builds the store chooser itself; a template only decides where it goes and which blocks wait for a store.
| Selector | Description | Used by |
|---|---|---|
[data-sf-store-dependent] | Hidden until a store is selected (use it on anything that only makes sense for a store). | 9/15 |
[data-sf-store-gate] | Where the full-width store chooser is inserted. Without it the chooser goes after the hero (#heroSlider/.hero/[data-sf-hero]) or at the top of #section-home. | 8/15 |
[data-sf-store-pill] | Where the "Shopping at … / Change" button goes. Without it, it is prepended to .header-actions (or similar). | 8/15 |
#sfStoreGate generated | Generated by the engine — do not add it yourself. | 0/15 |
#sfStoreModal generated | Generated by the engine — do not add it yourself. | 0/15 |
#sfStorePill generated | Generated by the engine — do not add it yourself. | 0/15 |
Home page blocks
Blocks filled with the selected store's data. Each hides itself when there is nothing to show.
| Selector | Description | Used by |
|---|---|---|
.announcement-bar | Alternative announcement bar marker. | 2/15 |
.footer-newsletter | Newsletter block in the footer. | 1/15 |
.hero-slide | One slide inside #heroSlider. | 15/15 |
.home-featured | Wrapper of #homeFeaturedGrid; hidden until a store is chosen and when empty. | 14/15 |
.home-products | Wrapper of #homeProductsGrid. | 14/15 |
.newsletter-section | Newsletter block (shown when content.newsletter is true). A form inside with an email input subscribes. | 8/15 |
.promo-banners | Promotion slots (.promo-banner children). Filled from content.promotions or the store's categories. | 6/15 |
.testimonial-section | Testimonials wrapper (hidden when there are none). | 6/15 |
.two-col-banners | Two promotion slots (.two-col-banner children). | 3/15 |
.usp-strip | Alternative marker for service highlights. | 1/15 |
[data-sf-announcement] | Announcement bar filled from content.announcement (hidden when empty). | 9/15 |
[data-sf-category-chips] | Category links ("chips"). Add data-sf-chip-images for thumbnails; wrap in [data-sf-chips-wrap] to hide the wrapper when empty. | 2/15 |
[data-sf-chip-images] | Part of [data-sf-category-chips] (home page blocks). | 2/15 |
[data-sf-chips-wrap] | Part of [data-sf-category-chips] (home page blocks). | 2/15 |
[data-sf-hero] | Marks a hero element (used to place the store chooser after it). | 0/15 |
[data-sf-newsletter] | Newsletter form marker. | 8/15 |
[data-sf-promo] | One promotion slot. | 0/15 |
[data-sf-promos] | Generic promotion container ([data-sf-promo] children). | 0/15 |
[data-sf-section] | Part of [data-sf-testimonials] (home page blocks). | 9/15 |
[data-sf-stats] | Live numbers for the store (products, categories, brands, open now). | 3/15 |
[data-sf-testimonials] | Testimonial track (inside .testimonial-section / [data-sf-section="testimonials"]). Only content.testimonials is shown. | 6/15 |
[data-sf-ticker] | Scrolling strip of category names. | 2/15 |
[data-sf-usps-class] | Part of [data-sf-usps] (home page blocks). | 8/15 |
[data-sf-usps-list] | Part of [data-sf-usps] (home page blocks). | 2/15 |
[data-sf-usps-max] | Part of [data-sf-usps] (home page blocks). | 5/15 |
[data-sf-usps] | Service highlights. data-sf-usps="feature" renders .feature-card items; data-sf-usps-class sets the item class; data-sf-usps-max the count; [data-sf-usps-list] the inner target. | 10/15 |
#heroDots | Dot buttons generated for each slide. | 15/15 |
#heroPaymentLine | Text replaced with the store's payment methods. | 3/15 |
#heroSlider | Slider. Children .hero-slide (first one active), buttons [data-action="hero-prev"/"hero-next"], dots in #heroDots. content.heroSlides in template.json replaces the slides. | 15/15 |
#homeAnimalsGrid | Secondary category showcase (icon cards). | 1/15 |
#homeAnimalsSection | Wrapper of #homeAnimalsGrid. | 1/15 |
#homeBrandsGrid | Brand tiles (shown when the store has 2+ brands). | 13/15 |
#homeBrandsSection | Wrapper of #homeBrandsGrid. | 13/15 |
#homeCategoriesGrid | Category tiles. | 14/15 |
#homeCategoriesSection | Wrapper of #homeCategoriesGrid. | 14/15 |
#homeFeaturedGrid | Featured product cards. | 15/15 |
#homeProductsGrid | Newest product cards. | 15/15 |
#homeRecentlyViewed | Recently viewed products (from this browser, per store). Put a .products-grid inside. | 9/15 |
#megaBrandsList | Brand links inside a mega menu. | 1/15 |
#megaCategoriesList | Category links inside a mega menu. | 1/15 |
#testimonialDots | Testimonial dots. | 6/15 |
Products page
Server-side filtering, sorting and pagination of the selected store's catalogue.
| Selector | Description | Used by |
|---|---|---|
.filter-sidebar | Alternative filter drawer marker. | 1/15 |
#applyFiltersBtn | Applies filters (filters also apply instantly unless StorefrontTheme.instantFilters is false). | 15/15 |
#brandSelect | <select> of brands. | 15/15 |
#categorySelect | <select> of categories (first option value "all"). | 15/15 |
#clearFiltersBtn | Clears filters. | 15/15 |
#featuredGrid | Featured products page grid. | 15/15 |
#featuredStoreRequired | Message area on the featured page when no store is selected. | 10/15 |
#filterToggleMobile | Opens the filter panel on small screens. | 9/15 |
#pagination | Page buttons. | 15/15 |
#priceRange | <input type="range"> maximum price. | 15/15 |
#priceRangeLabel | Shows the chosen maximum price. | 15/15 |
#productDetailContainer | Filled with the product page (gallery, price, variants, quantity, add to cart, related products). | 15/15 |
#productsFiltersSection | Filter panel (class "mobile-open" when opened on small screens). | 10/15 |
#productsGrid | Product cards for the current page. | 15/15 |
#productsStoreRequired | Message area shown when no store is selected. | 10/15 |
#resultsCount | Number of products shown. | 15/15 |
#resultsCounter | Wrapper of the results count. | 10/15 |
#sortSelect | <select> with values default, newest, price-asc, price-desc, name-asc, name-desc, rating. | 15/15 |
#subcategorySelect | <select> of subcategories (enabled after a category is chosen). | 15/15 |
#totalCount | Total number of matching products. | 15/15 |
#wishlistContainer | Filled with saved items. | 15/15 |
Cart
The engine renders the whole cart (lines, coupon, totals) into #cartContainer.
| Selector | Description | Used by |
|---|---|---|
#cartContainer | Cart contents. | 15/15 |
#stickyCartCount | Item count in the sticky bar. | 1/15 |
#stickyCartTotal | Total in the sticky bar. | 1/15 |
#stickyOrderBar | Optional sticky bar with #stickyCartCount and #stickyCartTotal. | 1/15 |
Checkout
Five steps (.checkout-step-content[data-step="1".."5"]): delivery details, billing, delivery method, payment, review. The forms and ids below are read and filled by the engine and must keep these ids.
| Selector | Description | Used by |
|---|---|---|
.checkout-content | Wrapper of the step panels (the order summary is inserted next to it). | 15/15 |
.checkout-step-content | One step panel (class "active" when shown). | 15/15 |
.checkout-steps | Progress indicator; children .step[data-step] get classes active/completed/reachable. | 15/15 |
[data-action="checkout-goto"] | Jump to the step in data-step. | 15/15 |
[data-action="checkout-next"] | Next step button. | 15/15 |
[data-action="checkout-prev"] | Previous step button. | 15/15 |
[data-step] | Part of .checkout-steps (checkout). | 0/15 |
#agreeTerms | Terms checkbox required before placing the order. | 15/15 |
#billingForm | Step 2 form with #sameAsShipping and the #differentBilling fields. | 15/15 |
#checkoutPersistenceBadge | "Your checkout progress has been restored" notice. | 10/15 |
#differentBilling | Part of #billingForm (checkout). | 15/15 |
#discountRow | Part of #reviewSubtotal (checkout). | 15/15 |
#paymentDetailsContainer | Payment instructions for the chosen method. | 15/15 |
#paymentMethods | Step 4: payment methods. | 15/15 |
#placeOrderBtn | Places the order. | 15/15 |
#reviewBilling | Part of #reviewItems (checkout). | 15/15 |
#reviewDiscount | Part of #reviewSubtotal (checkout). | 15/15 |
#reviewItems | Step 5: order lines (with #reviewShipping, #reviewBilling, #reviewPayment). | 15/15 |
#reviewPayment | Part of #reviewItems (checkout). | 15/15 |
#reviewShipping | Part of #reviewItems (checkout). | 15/15 |
#reviewShippingCost | Part of #reviewSubtotal (checkout). | 15/15 |
#reviewSubtotal | Totals: #reviewSubtotal #reviewDiscount #reviewShippingCost #reviewTax #reviewTotal (#discountRow, #summaryNote). | 15/15 |
#reviewTax | Part of #reviewSubtotal (checkout). | 15/15 |
#reviewTotal | Part of #reviewSubtotal (checkout). | 15/15 |
#sameAsShipping | Part of #billingForm (checkout). | 15/15 |
#sfCheckoutBlocked generated | Generated by the engine. | 0/15 |
#sfCheckoutSummary generated | Generated by the engine. | 0/15 |
#sfOrderConfirmation generated | Generated by the engine. | 0/15 |
#shipAddress1 | Part of #shippingForm (checkout). | 15/15 |
#shipAddress2 | Part of #shippingForm (checkout). | 15/15 |
#shipCity | Part of #shippingForm (checkout). | 15/15 |
#shipCountry | Part of #shippingForm (checkout). | 15/15 |
#shipEmail | Part of #shippingForm (checkout). | 15/15 |
#shipFullName | Part of #shippingForm (checkout). | 15/15 |
#shipPhone | Part of #shippingForm (checkout). | 15/15 |
#shippingFeeHint | Part of #shippingLocationContainer (checkout). | 15/15 |
#shippingForm | Step 1 form: #shipFullName #shipEmail #shipPhone #shipAddress1 #shipAddress2 #shipCity #shipState #shipPostalCode #shipCountry. | 15/15 |
#shippingLocationContainer | Delivery area pickers #shippingLocationSelect and #shippingSublocationSelect, and #shippingFeeHint. | 15/15 |
#shippingLocationSelect | Part of #shippingLocationContainer (checkout). | 15/15 |
#shippingMethods | Step 3: delivery options. | 15/15 |
#shippingSublocationSelect | Part of #shippingLocationContainer (checkout). | 15/15 |
#shipPostalCode | Part of #shippingForm (checkout). | 15/15 |
#shipState | Part of #shippingForm (checkout). | 15/15 |
#summaryNote | Part of #reviewSubtotal (checkout). | 15/15 |
Account, login and registration
Modals (.modal, class "active" when open) and the profile page tabs.
| Selector | Description | Used by |
|---|---|---|
.modal | Any modal; clicking its backdrop closes it. | 15/15 |
.profile-tab | Profile tab buttons (data-tab="info|orders|addresses|activity|security"). | 15/15 |
.profile-tab-content | Tab panels with ids profile-tab-<tab>. | 15/15 |
[data-action="close-modal"] | Closes the modal named in data-modal (or the closest .modal). | 15/15 |
[data-action="logout"] | Signs out. | 15/15 |
[data-action="show-login"] | Opens the login modal. | 15/15 |
[data-action="show-register"] | Opens the register modal. | 15/15 |
#addrCountry | Part of #addressModal (account, login and registration). | 15/15 |
#addressForm | Part of #addressModal (account, login and registration). | 15/15 |
#addressModal | Address editor (#addressForm with #addrId #addrFullName … #addrCountry). | 15/15 |
#addrFullName | Part of #addressModal (account, login and registration). | 15/15 |
#addrId | Part of #addressModal (account, login and registration). | 15/15 |
#changePasswordForm | Password form (#currentPassword #newPassword #confirmPassword). | 15/15 |
#confirmPassword | Part of #changePasswordForm (account, login and registration). | 15/15 |
#currentPassword | Part of #changePasswordForm (account, login and registration). | 15/15 |
#loginForm | Part of #loginModal (account, login and registration). | 15/15 |
#loginModal | Login modal containing #loginForm (#loginUsername, #loginPassword). | 15/15 |
#loginPassword | Part of #loginModal (account, login and registration). | 15/15 |
#loginUsername | Part of #loginModal (account, login and registration). | 15/15 |
#newPassword | Part of #changePasswordForm (account, login and registration). | 15/15 |
#profileActivity | Recent activity. | 15/15 |
#profileAddresses | Saved addresses. | 15/15 |
#profileCurrency | Part of #profileName (account, login and registration). | 15/15 |
#profileEmail | Part of #profileName (account, login and registration). | 15/15 |
#profileName | Profile fields: #profileName #profileUsername #profileEmail #profileCurrency. | 15/15 |
#profileOrders | Order history. | 15/15 |
#profileUsername | Part of #profileName (account, login and registration). | 15/15 |
#registerCaptchaContainer | Part of #registerModal (account, login and registration). | 15/15 |
#registerConfirmPassword | Part of #registerModal (account, login and registration). | 15/15 |
#registerEmail | Part of #registerModal (account, login and registration). | 15/15 |
#registerForm | Part of #registerModal (account, login and registration). | 15/15 |
#registerModal | Register modal containing #registerForm (#registerName #registerUsername #registerEmail #registerPhone #registerPassword #registerConfirmPassword, honeypot #registerWebsite, #registerCaptchaContainer). | 15/15 |
#registerName | Part of #registerModal (account, login and registration). | 15/15 |
#registerPassword | Part of #registerModal (account, login and registration). | 15/15 |
#registerPhone | Part of #registerModal (account, login and registration). | 15/15 |
#registerUsername | Part of #registerModal (account, login and registration). | 15/15 |
#registerWebsite | Part of #registerModal (account, login and registration). | 15/15 |
Legal pages and footer
Text from template.json "legal", social links from "social", payment method badges from the store.
| Selector | Description | Used by |
|---|---|---|
[data-sf-payments] | Payment badges marker. | 0/15 |
[data-sf-social] | Wrapper hidden together with #footerSocialLinks. | 8/15 |
#footerPaymentIcons | Payment method badges. | 15/15 |
#footerSocialLinks | Social links (hidden when none are configured). | 15/15 |
#privacyContent | Privacy policy text. | 15/15 |
#refundContent | Refund policy text. | 15/15 |
#termsContent | Terms text. | 15/15 |
Generated by the engine
Created at runtime. Style them, but do not put them in your HTML.
| Selector | Description | Used by |
|---|---|---|
[data-sf-hide-on-error] | Images with this attribute are hidden (instead of replaced by a placeholder) when they fail to load. | 0/15 |
[data-sf-img] generated | Set on images rendered by the engine. | 0/15 |
[data-sf-link] generated | Set by the engine on hero buttons configured in content.heroSlides. | 0/15 |
[data-sf-state] generated | Set on sections by the engine: loading / ready / empty / needs-store (style hidden states with it). | 0/15 |
#couponInput generated | Coupon field inside the cart. | 0/15 |
#pdMainImageWrap generated | Product page gallery (inside #productDetailContainer). | 0/15 |
#pdQty generated | Product page quantity input (with #pdQtyDown / #pdQtyUp). | 0/15 |
#pdQtyDown generated | Product page quantity button. | 0/15 |
#pdQtyUp generated | Product page quantity button. | 0/15 |
#sfRecentWrap generated | Recently viewed block on the product page. | 0/15 |
#sfRelated generated | Related products block on the product page. | 0/15 |
#sfToastStack generated | Toast notifications. | 0/15 |
Elements a feature needs together
Found by comparing the installed templates: when a template has the first element, these are present in every template that has it (the validator warns when some are missing).
| Feature | Also needs |
|---|---|
#section-checkout | #agreeTerms #billingForm #differentBilling #discountRow #paymentDetailsContainer #paymentMethods #placeOrderBtn #reviewBilling #reviewDiscount #reviewItems #reviewPayment #reviewShipping #reviewShippingCost #reviewSubtotal #reviewTax #reviewTotal #sameAsShipping #shippingFeeHint #shippingForm #shippingLocationContainer #shippingLocationSelect #shippingMethods #shippingSublocationSelect #summaryNote |
#section-products | #applyFiltersBtn #brandSelect #categorySelect #clearFiltersBtn #pagination #priceRange #priceRangeLabel #productsGrid #resultsCount #sortSelect #subcategorySelect #totalCount |
#section-profile | #changePasswordForm #confirmPassword #currentPassword #newPassword #profile-tab-activity #profile-tab-addresses #profile-tab-info #profile-tab-orders #profile-tab-security #profileActivity #profileAddresses #profileCurrency #profileEmail #profileName #profileOrders #profileUsername |
#section-cart | #cartContainer |
#section-product-detail | #productDetailContainer |
#section-wishlist | #wishlistContainer |
#section-featured | #featuredGrid |
#loginModal | #loginForm #loginPassword #loginUsername |
#registerModal | #registerCaptchaContainer #registerConfirmPassword #registerForm #registerPassword |
#addressModal | #addrId #addressForm |
#heroSlider | #heroDots |
Reference markup
Markup for each engine block, copied from an installed template (the Studio's Insert panel offers the same). Adjust classes and text freely; keep the ids, classes and data attributes listed in Engine hooks.
#section-checkout (from prestashop)
<section id="section-checkout" class="app-section" aria-labelledby="checkoutHeading">
<div class="section-header">
<div>
<h2 id="checkoutHeading">Checkout</h2>
<p class="section-subtitle">Complete your order in a few steps</p>
</div>
</div>
<div class="checkout-persistence-badge" id="checkoutPersistenceBadge" hidden>
<i class="fas fa-history" aria-hidden="true"></i>
<span>Your checkout progress has been restored.</span>
<button type="button" class="checkout-persistence-dismiss" data-action="dismiss-checkout-badge" aria-label="Dismiss">×</button>
</div>
<div class="checkout-steps" role="list">
<div class="step active" data-step="1" role="listitem"><span class="step-number">1</span><span class="step-label">Delivery</span></div>
<div class="step" data-step="2" role="listitem"><span class="step-number">2</span><span class="step-label">Billing</span></div>
<div class="step" data-step="3" role="listitem"><span class="step-number">3</span><span class="step-label">Delivery Method</span></div>
<div class="step" data-step="4" role="listitem"><span class="step-number">4</span><span class="step-label">Payment</span></div>
<div class="step" data-step="5" role="listitem"><span class="step-number">5</span><span class="step-label">Review</span></div>
</div>
<div class="checkout-content">
<div class="checkout-step-content active" data-step="1">
<h3>Delivery Information</h3>
<form id="shippingForm" class="checkout-form" autocomplete="on" novalidate>
<div class="form-row">
<div class="form-group"><label for="shipFullName">Full Name *</label><input type="text" id="shipFullName" name="fullName" required></div>
<div class="form-group"><label for="shipEmail">Email *</label><input type="email" id="shipEmail" name="email" required></div>
</div>
<div class="form-row">
<div class="form-group"><label for="shipPhone">Phone *</label><input type="tel" id="shipPhone" name="phone" required></div>
<div class="form-group"><label for="shipAddress1">Address Line 1 *</label><input type="text" id="shipAddress1" name="address1" required></div>
</div>
<div class="form-group"><label for="shipAddress2">Address Line 2</label><input type="text" id="shipAddress2" name="address2"></div>
<div class="form-row">
<div class="form-group"><label for="shipCity">City *</label><input type="text" id="shipCity" name="city" required></div>
<div class="form-group"><label for="shipState">State *</label><input type="text" id="shipState" name="state" required></div>
</div>
<div class="form-row">
<div class="form-group"><label for="shipPostalCode">Postal Code *</label><input type="text" id="shipPostalCode" name="postalCode" required></div>
<div class="form-group">
<label for="shipCountry">Country *</label>
<select id="shipCountry" name="country" required>
<option value="">Select Country</option>
<option value="NG">Nigeria</option>
<option value="US">United States</option>
<option value="CA">Canada</option>
<option value="GB">United Kingdom</option>
<option value="AU">Australia</option>
<option value="DE">Germany</option>
<option value="FR">France</option>
<option value="JP">Japan</option>
</select>
</div>
</div>
<div class="form-actions">
<button type="button" class="btn-primary" data-action="checkout-next">
Continue to Billing <i class="fas fa-arrow-right" aria-hidden="true"></i>
</button>
</div>
</form>
</div>
<div class="checkout-step-content" data-step="2">
<h3>Billing Information</h3>
<form id="billingForm" class="checkout-form" novalidate>
<div class="form-group checkbox-group">
<label><input type="checkbox" id="sameAsShipping" checked data-action="toggle-billing"> Same as delivery address</label>
</div>
<div id="differentBilling" style="display:none;">
<div class="form-row">
<div class="form-group"><label for="billFullName">Full Name *</label><input type="text" id="billFullName" name="fullName"></div>
<div class="form-group"><label for="billCompany">Company</label><input type="text" id="billCompany" name="company"></div>
</div>
<div class="form-group"><label for="billAddress">Address *</label><input type="text" id="billAddress" name="address1"></div>
<div class="form-row">
<div class="form-group"><label for="billCity">City *</label><input type="text" id="billCity" name="city"></div>
<div class="form-group"><label for="billState">State *</label><input type="text" id="billState" name="state"></div>
</div>
<div class="form-row">
<div class="form-group"><label for="billPostalCode">Postal Code *</label><input type="text" id="billPostalCode" name="postalCode"></div>
<div class="form-group">
<label for="billCountry">Country *</label>
<select id="billCountry" name="country">
<option value="">Select Country</option>
<option value="NG">Nigeria</option>
<option value="US">United States</option>
<option value="CA">Canada</option>
<option value="GB">United Kingdom</option>
</select>
</div>
</div>
</div>
<div class="form-actions">
<button type="button" class="btn-outline" data-action="checkout-prev"><i class="fas fa-arrow-left" aria-hidden="true"></i> Back</button>
<button type="button" class="btn-primary" data-action="checkout-next">Continue <i class="fas fa-arrow-right" aria-hidden="true"></i></button>
</div>
</form>
</div>
<div class="checkout-step-content" data-step="3">
<h3>Delivery Method</h3>
<div class="shipping-methods" id="shippingMethods" aria-live="polite">
<div class="loading-state"><div class="spinner"></div><p>Loading delivery options…</p></div>
</div>
<div id="shippingLocationContainer" class="shipping-location-container" style="display:none;">
<label for="shippingLocationSelect" class="shipping-location-label">
<i class="fas fa-map-marker-alt" aria-hidden="true"></i> Delivery Location (State / City) *
</label>
<select id="shippingLocationSelect" class="sort-select shipping-location-select">
<option value="">Select a state / city…</option>
</select>
<label for="shippingSublocationSelect" class="shipping-location-label">
<i class="fas fa-location-arrow" aria-hidden="true"></i> Area / Locality *
</label>
<select id="shippingSublocationSelect" class="sort-select shipping-location-select" disabled>
<option value="">Select a state / city first</option>
</select>
<p class="shipping-fee-hint" id="shippingFeeHint"></p>
</div>
<div class="form-actions">
<button type="button" class="btn-outline" data-action="checkout-prev"><i class="fas fa-arrow-left" aria-hidden="true"></i> Back</button>
<button type="button" class="btn-primary" data-action="checkout-next">Continue <i class="fas fa-arrow-right" aria-hidden="true"></i></button>
</div>
</div>
<div class="checkout-step-content" data-step="4">
<h3>Payment Method</h3>
<div class="payment-methods" id="paymentMethods" aria-live="polite">
<div class="loading-state"><div class="spinner"></div><p>Loading payment options…</p></div>
</div>
<div id="paymentDetailsContainer" class="payment-details-container"></div>
<div class="form-actions">
<button type="button" class="btn-outline" data-action="checkout-prev"><i class="fas fa-arrow-left" aria-hidden="true"></i> Back</button>
<button type="button" class="btn-primary" data-action="checkout-next">Review Order <i class="fas fa-arrow-right" aria-hidden="true"></i></button>
</div>
</div>
<div class="checkout-step-content" data-step="5">
<h3>Review Your Order</h3>
<div class="review-section"><h4><i class="fas fa-box" aria-hidden="true"></i> Items</h4><div id="reviewItems"></div></div>
<div class="review-section"><h4><i class="fas fa-truck" aria-hidden="true"></i> Delivery</h4><div id="reviewShipping"></div><button class="btn-link" type="button" data-action="checkout-goto" data-step="1">Edit</button></div>
<div class="review-section"><h4><i class="fas fa-file-invoice" aria-hidden="true"></i> Billing</h4><div id="reviewBilling"></div><button class="btn-link" type="button" data-action="checkout-goto" data-step="2">Edit</button></div>
<div class="review-section"><h4><i class="fas fa-credit-card" aria-hidden="true"></i> Payment</h4><div id="reviewPayment"></div><button class="btn-link" type="button" data-action="checkout-goto" data-step="4">Edit</button></div>
<div class="order-summary" id="orderSummary">
<h4><i class="fas fa-receipt" aria-hidden="true"></i> Order Summary</h4>
<div class="summary-row"><span>Subtotal:</span><span id="reviewSubtotal">—</span></div>
<div class="summary-row discount-row" id="discountRow" style="display:none;"><span>Discount:</span><span id="reviewDiscount">—</span></div>
<div id="discountBreakdownContainer"></div>
<div class="summary-row"><span>Delivery:</span><span id="reviewShippingCost">—</span></div>
<div class="summary-row"><span>Tax:</span><span id="reviewTax">—</span></div>
<div class="summary-row total-row"><span>Total:</span><span id="reviewTotal">—</span></div>
<div class="summary-note" id="summaryNote"></div>
</div>
<div class="form-group checkbox-group">
<label><input type="checkbox" id="agreeTerms" required> I agree to the <a href="#terms" data-nav="terms">Terms & Conditions</a> *</label>
</div>
<div class="form-actions">
<button type="button" class="btn-outline" data-action="checkout-prev"><i class="fas fa-arrow-left" aria-hidden="true"></i> Back</button>
<button type="button" class="btn-primary btn-large" id="placeOrderBtn" data-action="place-order">
<i class="fas fa-check-circle" aria-hidden="true"></i> Place Order
</button>
</div>
</div>
</div>
</section>#section-products (from prestashop)
<section id="section-products" class="app-section" aria-labelledby="productsHeading">
<div class="section-header">
<div>
<h2 id="productsHeading">Our Produce</h2>
<p class="section-subtitle">Browse our full harvest collection</p>
</div>
</div>
<div class="filters-section" id="productsFiltersSection">
<div class="filters-container">
<div class="filter-group">
<label for="categorySelect">Category:</label>
<select id="categorySelect" class="sort-select">
<option value="all">All Categories</option>
</select>
</div>
<div class="filter-group">
<label for="subcategorySelect">Subcategory:</label>
<select id="subcategorySelect" class="sort-select" disabled>
<option value="">All Subcategories</option>
</select>
</div>
<div class="filter-group">
<label for="brandSelect">Farm:</label>
<select id="brandSelect" class="sort-select">
<option value="">All Farms</option>
</select>
</div>
<div class="filter-group">
<label for="priceRange">Max Price: <span id="priceRangeLabel">—</span></label>
<input type="range" id="priceRange" min="0" max="500" value="500" class="price-range" aria-label="Maximum price">
</div>
<div class="filter-group">
<label for="sortSelect">Sort By:</label>
<select id="sortSelect" class="sort-select">
<option value="default">Default</option>
<option value="newest">Newest</option>
<option value="price-asc">Price: Low to High</option>
<option value="price-desc">Price: High to Low</option>
<option value="name-asc">Name: A-Z</option>
<option value="name-desc">Name: Z-A</option>
<option value="rating">Top Rated</option>
</select>
</div>
<div class="filter-group filter-clear-group">
<button class="btn-primary btn-small" type="button" id="applyFiltersBtn">
<i class="fas fa-filter" aria-hidden="true"></i> Apply Filters
</button>
<button class="btn-outline btn-small" type="button" id="clearFiltersBtn">
<i class="fas fa-times" aria-hidden="true"></i> Clear
</button>
</div>
</div>
<div class="results-counter" id="resultsCounter">
Showing <span id="resultsCount">0</span> of <span id="totalCount">0</span> products
</div>
</div>
<div id="productsStoreRequired" class="store-required-state" hidden></div>
<div class="products-grid" id="productsGrid" aria-live="polite"></div>
<nav class="loop-pagination" id="pagination" aria-label="Product pagination"></nav>
</section>#section-profile (from prestashop)
<section id="section-profile" class="app-section" aria-labelledby="profileHeading">
<div class="section-header">
<div>
<h2 id="profileHeading">My Profile</h2>
<p class="section-subtitle">Manage your account and view your activity</p>
</div>
</div>
<div class="profile-tabs" role="tablist">
<button class="profile-tab active" type="button" data-tab="info" role="tab" aria-selected="true"><i class="fas fa-user" aria-hidden="true"></i> Personal Info</button>
<button class="profile-tab" type="button" data-tab="orders" role="tab" aria-selected="false"><i class="fas fa-box" aria-hidden="true"></i> Orders</button>
<button class="profile-tab" type="button" data-tab="addresses" role="tab" aria-selected="false"><i class="fas fa-map-marker-alt" aria-hidden="true"></i> Addresses</button>
<button class="profile-tab" type="button" data-tab="activity" role="tab" aria-selected="false"><i class="fas fa-history" aria-hidden="true"></i> Recent Activity</button>
<button class="profile-tab" type="button" data-tab="security" role="tab" aria-selected="false"><i class="fas fa-lock" aria-hidden="true"></i> Security</button>
</div>
<div class="profile-tab-content active" id="profile-tab-info" role="tabpanel">
<div class="profile-info-grid">
<div class="profile-info-item"><span>Name</span><strong id="profileName">—</strong></div>
<div class="profile-info-item"><span>Username</span><strong id="profileUsername">—</strong></div>
<div class="profile-info-item"><span>Email</span><strong id="profileEmail">—</strong></div>
<div class="profile-info-item"><span>Currency</span><strong id="profileCurrency">—</strong></div>
</div>
<div class="form-actions">
<button class="btn-outline" type="button" data-action="logout"><i class="fas fa-sign-out-alt" aria-hidden="true"></i> Logout</button>
</div>
</div>
<div class="profile-tab-content" id="profile-tab-orders" role="tabpanel">
<div id="profileOrders"><div class="loading-state"><div class="spinner"></div><p>Loading orders…</p></div></div>
</div>
<div class="profile-tab-content" id="profile-tab-addresses" role="tabpanel">
<div id="profileAddresses"><div class="loading-state"><div class="spinner"></div><p>Loading addresses…</p></div></div>
</div>
<div class="profile-tab-content" id="profile-tab-activity" role="tabpanel">
<div id="profileActivity"><div class="loading-state"><div class="spinner"></div><p>Loading activity…</p></div></div>
</div>
<div class="profile-tab-content" id="profile-tab-security" role="tabpanel">
<div class="security-panel">
<h3>Change Password</h3>
<p class="text-muted">Use a strong password with at least 6 characters.</p>
<form id="changePasswordForm" class="checkout-form" novalidate>
<div class="form-group">
<label for="currentPassword">Current Password *</label>
<input type="password" id="currentPassword" required autocomplete="current-password">
</div>
<div class="form-group">
<label for="newPassword">New Password *</label>
<input type="password" id="newPassword" required autocomplete="new-password" minlength="6">
</div>
<div class="form-group">
<label for="confirmPassword">Confirm New Password *</label>
<input type="password" id="confirmPassword" required autocomplete="new-password" minlength="6">
</div>
<div class="form-actions">
<button type="submit" class="btn-primary">
<i class="fas fa-lock" aria-hidden="true"></i> Update Password
</button>
</div>
</form>
</div>
</div>
</section>#section-cart (from prestashop)
<section id="section-cart" class="app-section" aria-labelledby="cartHeading">
<div class="section-header">
<div>
<h2 id="cartHeading">Your Basket</h2>
<p class="section-subtitle">Review the items in your basket</p>
</div>
</div>
<div id="cartContainer" aria-live="polite"></div>
</section>#section-product-detail (from prestashop)
<section id="section-product-detail" class="app-section" aria-labelledby="productDetailHeading">
<div class="section-header">
<div>
<button class="btn-outline btn-small" type="button" data-nav="products">
<i class="fas fa-arrow-left" aria-hidden="true"></i> Back to Produce
</button>
</div>
</div>
<div id="productDetailContainer" aria-live="polite">
<div class="loading-state"><div class="spinner"></div><p>Loading product…</p></div>
</div>
</section>#section-wishlist (from prestashop)
<section id="section-wishlist" class="app-section" aria-labelledby="wishlistHeading">
<div class="section-header">
<div>
<h2 id="wishlistHeading">My Saved Items</h2>
<p class="section-subtitle">Produce you've saved for later</p>
</div>
</div>
<div id="wishlistContainer" aria-live="polite"></div>
</section>#section-featured (from prestashop)
<section id="section-featured" class="app-section" aria-labelledby="featuredHeading">
<div class="section-header">
<div>
<h2 id="featuredHeading">Featured Produce</h2>
<p class="section-subtitle">Hand-picked favourites just for you</p>
</div>
</div>
<div id="featuredStoreRequired" class="store-required-state" hidden></div>
<div class="products-grid" id="featuredGrid" aria-live="polite"></div>
</section>#loginModal (from prestashop)
<div id="loginModal" class="modal" role="dialog" aria-modal="true" aria-labelledby="loginModalTitle">
<div class="modal-content modal-small">
<button class="modal-close" type="button" data-action="close-modal" data-modal="loginModal" aria-label="Close">×</button>
<h2 id="loginModalTitle">Welcome Back</h2>
<form id="loginForm" novalidate>
<div class="form-notification" role="alert" aria-live="polite"></div>
<div class="form-group">
<label for="loginUsername">Email</label>
<input type="text" id="loginUsername" required autocomplete="username">
</div>
<div class="form-group">
<label for="loginPassword">Password</label>
<input type="password" id="loginPassword" required autocomplete="current-password">
</div>
<button type="submit" class="btn-primary btn-block">
<i class="fas fa-sign-in-alt" aria-hidden="true"></i> Login
</button>
</form>
<p class="modal-footer-text">
Don't have an account?
<a href="#" data-action="show-register">Create Account</a>
</p>
</div>
</div>#registerModal (from prestashop)
<div id="registerModal" class="modal" role="dialog" aria-modal="true" aria-labelledby="registerModalTitle">
<div class="modal-content modal-small">
<button class="modal-close" type="button" data-action="close-modal" data-modal="registerModal" aria-label="Close">×</button>
<h2 id="registerModalTitle">Create Account</h2>
<form id="registerForm" novalidate>
<div class="form-notification" role="alert" aria-live="polite"></div>
<div class="form-group"><label for="registerName">Full Name *</label><input type="text" id="registerName" required autocomplete="name"></div>
<div class="form-group"><label for="registerUsername">Username *</label><input type="text" id="registerUsername" required autocomplete="username"></div>
<div class="form-group"><label for="registerEmail">Email *</label><input type="email" id="registerEmail" required autocomplete="email"></div>
<div class="form-group"><label for="registerPhone">Phone Number *</label><input type="tel" id="registerPhone" required autocomplete="tel" placeholder="e.g. +234 801 234 5678"></div>
<div class="form-group"><label for="registerPassword">Password *</label><input type="password" id="registerPassword" required autocomplete="new-password" minlength="6"></div>
<div class="form-group"><label for="registerConfirmPassword">Confirm Password *</label><input type="password" id="registerConfirmPassword" required autocomplete="new-password" minlength="6"></div>
<div class="honeypot-field" aria-hidden="true">
<label for="registerWebsite">Website (leave blank)</label>
<input type="text" id="registerWebsite" name="website" tabindex="-1" autocomplete="off">
</div>
<div id="registerCaptchaContainer" class="captcha-container"></div>
<button type="submit" class="btn-primary btn-block">
<i class="fas fa-user-plus" aria-hidden="true"></i> Register
</button>
</form>
<p class="modal-footer-text">
Already have an account?
<a href="#" data-action="show-login">Login</a>
</p>
</div>
</div>#addressModal (from prestashop)
<div id="addressModal" class="modal" role="dialog" aria-modal="true" aria-labelledby="addressModalTitle">
<div class="modal-content modal-medium">
<button class="modal-close" type="button" data-action="close-modal" data-modal="addressModal" aria-label="Close">×</button>
<h2 id="addressModalTitle">Edit Address</h2>
<form id="addressForm" class="checkout-form" novalidate>
<input type="hidden" id="addrId">
<div class="form-row">
<div class="form-group"><label for="addrFullName">Full Name *</label><input type="text" id="addrFullName" required></div>
<div class="form-group"><label for="addrEmail">Email</label><input type="email" id="addrEmail"></div>
</div>
<div class="form-row">
<div class="form-group"><label for="addrPhone">Phone</label><input type="tel" id="addrPhone"></div>
<div class="form-group"><label for="addrAddress1">Address Line 1 *</label><input type="text" id="addrAddress1" required></div>
</div>
<div class="form-group"><label for="addrAddress2">Address Line 2</label><input type="text" id="addrAddress2"></div>
<div class="form-row">
<div class="form-group"><label for="addrCity">City *</label><input type="text" id="addrCity" required></div>
<div class="form-group"><label for="addrState">State *</label><input type="text" id="addrState" required></div>
</div>
<div class="form-row">
<div class="form-group"><label for="addrPostalCode">Postal Code</label><input type="text" id="addrPostalCode"></div>
<div class="form-group"><label for="addrCountry">Country</label><input type="text" id="addrCountry"></div>
</div>
<div class="form-actions">
<button type="button" class="btn-outline" data-action="close-modal" data-modal="addressModal">Cancel</button>
<button type="submit" class="btn-primary"><i class="fas fa-save" aria-hidden="true"></i> Save Address</button>
</div>
</form>
</div>
</div>#heroSlider (from prestashop)
<div class="hero-slider" id="heroSlider" aria-roledescription="carousel" aria-label="Featured banner">
<div class="hero-slides">
<div class="hero-slide active" data-slide="0">
<div class="hero-content">
<p class="hero-eyebrow">It's about your harvest</p>
<h2 id="homeHeading">Farm-Fresh Produce,<br>Delivered To Your Door.</h2>
<p class="hero-sub">Hand-picked from local growers and delivered with care.</p>
<div class="hero-actions">
<button class="btn-primary btn-large" type="button" data-nav="products">Shop Now</button>
</div>
</div>
</div>
<div class="hero-slide slide-alt-1" data-slide="1">
<div class="hero-content">
<p class="hero-eyebrow">Make us a part of your kitchen</p>
<h2>Harvest Season<br>Is Here.</h2>
<p class="hero-sub">Explore this week's freshest arrivals from our partner farms.</p>
<div class="hero-actions">
<button class="btn-primary btn-large" type="button" data-nav="products">Browse Harvest</button>
</div>
</div>
</div>
<div class="hero-slide slide-alt-2" data-slide="2">
<div class="hero-content">
<p class="hero-eyebrow">Fast & secure checkout</p>
<h2>Multiple Payment Options,<br>Safe Delivery.</h2>
<p class="hero-sub" id="heroPaymentLine">Shop with confidence — secure payments at checkout.</p>
<div class="hero-actions">
<button class="btn-primary btn-large" type="button" data-nav="featured">Shop Featured</button>
</div>
</div>
</div>
</div>
<button class="hero-nav hero-nav-prev" type="button" aria-label="Previous slide" data-action="hero-prev">
<i class="fas fa-chevron-left" aria-hidden="true"></i>
</button>
<button class="hero-nav hero-nav-next" type="button" aria-label="Next slide" data-action="hero-next">
<i class="fas fa-chevron-right" aria-hidden="true"></i>
</button>
<div class="hero-dots" id="heroDots" role="tablist" aria-label="Slides"></div>
</div>#homeFeaturedGrid (from prestashop)
<div id="homeFeaturedGrid" class="products-grid" aria-live="polite"></div>#homeProductsGrid (from prestashop)
<div id="homeProductsGrid" class="products-grid" aria-live="polite"></div>#homeCategoriesSection (from prestashop)
<div class="home-categories" id="homeCategoriesSection">
<div class="section-header centered">
<h2>Shop By Category</h2>
</div>
<div id="homeCategoriesGrid" class="categories-grid" aria-live="polite"></div>
</div>#homeBrandsSection (from prestashop)
<div class="home-brands" id="homeBrandsSection">
<div class="section-header centered">
<h2>Shop By Farm</h2>
</div>
<div id="homeBrandsGrid" class="brands-grid" aria-live="polite"></div>
</div>#homeRecentlyViewed (from prestashop)
<div class="home-recent sf-hidden" id="homeRecentlyViewed">
<div class="section-header centered"><h2>Recently Viewed</h2></div>
<div class="products-grid" aria-live="polite"></div>
</div>#footerSocialLinks (from prestashop)
<div class="social-links" id="footerSocialLinks"></div>#footerPaymentIcons (from prestashop)
<div class="payment-icons" id="footerPaymentIcons"></div>#userMenu (from prestashop)
<div class="user-menu" id="userMenu">
<button class="icon-btn login-btn" type="button" data-action="show-login" title="Login" aria-label="Login">
<i class="fas fa-sign-in-alt" aria-hidden="true"></i> <span>Login</span>
</button>
<button class="icon-btn register-btn" type="button" data-action="show-register" title="Register" aria-label="Register">
<i class="fas fa-user-plus" aria-hidden="true"></i> <span>Register</span>
</button>
</div>#searchContainer (from prestashop)
<div class="search-container" id="searchContainer">
<button class="icon-btn search-toggle-btn" type="button" id="searchToggleBtn" aria-label="Search" aria-expanded="false">
<i class="fas fa-search" aria-hidden="true"></i>
</button>
<div class="search-panel" id="searchPanel">
<label class="visually-hidden" for="searchInput">Search produce</label>
<input type="search" id="searchInput" placeholder="Search product here…" class="search-input" autocomplete="off">
<button class="search-submit-btn" type="button" aria-label="Search" data-action="search">
<i class="fas fa-search" aria-hidden="true"></i>
</button>
<div id="searchSuggestions" class="search-suggestions" role="listbox" aria-live="polite"></div>
</div>
</div>[data-sf-usps] (from prestashop)
<div class="usp-strip" data-sf-usps aria-label="Why shop with us"></div>[data-sf-category-chips] (from boutique)
<div class="k-chips-row sf-hidden" data-sf-chips-wrap>
<div class="k-container"><nav data-sf-category-chips data-sf-chip-images aria-label="Categories"></nav></div>
</div>[data-sf-stats] (from corporate)
<div data-sf-stats class="sf-hidden"></div>[data-sf-ticker] (from boutique)
<div class="k-ticker k-ticker--top sf-hidden" data-sf-ticker></div>[data-sf-store-gate] (from organic)
<div class="k-gate-slot" data-sf-store-gate></div>[data-sf-store-pill] (from organic)
<div class="k-pill-slot" data-sf-store-pill></div>[data-sf-announcement] (from prestashop)
<div class="announcement-bar sf-hidden" data-sf-announcement>
<div class="container">
<p class="announcement-text"></p>
</div>
</div>