Foundra changelog

  1. 1.2.0

    Stable

    The look of a store becomes a set of choices: four header layouts, a header and footer colour, a transparent header over the hero, a centered footer, a page background, corners, a heading font beside the body font with four faces served from the site, and the shape of the product card's picture. Two Foundra stores set up from these alone no longer read as the same template. Every choice is a template option, so it is edited in Template Styles and, on Solidshop 1.8.0, in the new Look screen beside a live preview. Still runs on Solidshop 1.7.0, where the Look screen is absent and the options are reached through Template Styles.

    Added

    • Header layout. Logo on the left (the header as it was), Logo in the middle, menu below, Large logo above the menu and Menu split either side of the logo, the boutique header. The centered and split layouts put the search, cart and account controls on a strip above; on phones every layout is the same bar with the menu in the drawer. The split header renders the menu as two lists through a Foundra layout for the Menu module that is otherwise Joomla's own
    • Header colour. Plain (the page's surface), Primary colour or Dark. The menu, its hover pills, the icons, the theme and menu toggles and the store notices bar below the header follow the colour; dropdown panels keep the page's surface. A coloured header shows the dark-mode logo when one is set, and so does the transparent header while it lies over the hero
    • Header position and Pin the header. The old Header Style is now the layout and, separately, whether the header lies transparent over the first block of the page; a store can also let the header scroll away
    • Footer layout and colour. Columns or Centered, which opens with the logo and lays the modules out in one column with menus as a row of links; Dark (as it was), Plain or Primary colour. The footer's colours are tokens, so the social icons, the contact lines, the currency switcher and the bottom strip follow the choice
    • Page background and corners. Soft grey, Warm and Tinted with the primary colour behind any preset, each with a dark-mode shade; Sharp, Softly rounded and Round corners on cards, inputs and buttons, buttons becoming pills on Round. Preset default keeps the preset's own, so no store changes on update
    • Heading font and body font, each chosen from fonts on the visitor's device (System, Sans-serif, Serif) or the four faces Foundra now ships: Inter, Manrope, EB Garamond and, for headings, Noto Serif Display. The shipped faces are subsetted per script (Latin, Latin extended with Vietnamese, Cyrillic, Greek) and served from the site, one small file per face on most pages, preloaded only when chosen; the default style still loads no font. The old Font Family becomes the body font on update
    • Product picture ratio. Square, Portrait or Landscape on product cards, over the preset's own
    • Pictures of the presets for the Look screen's preset picker
    • Per-page body classes — the component, view, layout, task, menu item and page class, as Cassiopeia writes them — so Custom CSS can target one page
    • Custom CSS is a CodeMirror editor, applies to the error, offline and component pages too, and takes CSS only: @import rules are removed
    • The Look screen's preview. The template draws the home page with the values the Look screen signs, when Solidshop 1.8.0 is installed

    Changed

    • The template options are grouped in tabs: Brand, Style, Header, Footer, Shop, Features and Custom Code
    • The header's and footer's colours, the buttons' radius and the card's picture ratio are tokens (--foundra-header-*, --foundra-footer-*, --foundra-radius-button, --foundra-card-ratio), so a child template or Custom CSS can re-point them in one rule
    • The Inter the system font stack falls back to on Linux is the shipped subset, fetched only where no native font of the stack exists

    Fixed

    • The header's dropdown menus open on hover, keyboard and touch again on Joomla 6.1 and later. Joomla 6.1's menu script marks every submenu hidden for assistive technology when the page loads, and Joomla's menu stylesheet hides a submenu so marked; Foundra's hover rule only changed the panel's opacity, so on Joomla 6.1 and 6.2 a dropdown opened only from the chevron button. The panel keeps its box now, and the template script opens and closes it on hover, on focus, from the chevron and on a tap, keeping the hidden flag and the button's expanded state in step with what is on screen; Escape closes it. The drawer's submenu toggle reports its state the same way, and no longer fights Joomla's click handler
    • The transparent header showed the light logo over the hero photo
    • The checkout no longer shows its e-mail error before anything is typed. "The email address must be valid and cannot be left blank." was on screen from the moment the checkout opened. It now appears only when the address given is not valid, and goes once it is
    • Red reads in dark mode. Sale prices, field errors and required-field stars were 3.1:1 on a dark card, and a red button's label 3.9:1; the dark red is lighter now and clears 5.4:1. A focused or hovered outlined button, such as the checkout's Continue, kept a dark label on dark grey (2.5:1) and now fills with a light grey
  2. 1.1.0

    Stable

    Smart Search gets a Foundra results page and search box, the Menu module gains a row-of-chips layout, and the product page shows Solidshop 1.7.0's colour and image swatches and specification rows. Right-to-left sites now load Bootstrap's right-to-left build. An accessibility pass gives every page a main heading and brings brand-colour text, statuses and muted text to readable contrast in every preset, light and dark. Requires Solidshop 1.7.0 or later: the option overrides call core classes that first ship in that release, and the install script refuses an older core with a plain message.

    The release a Solidshop 1.7.0 site needs. With Foundra 1.0.1 on 1.7.0, option values stay text buttons, specification rows never appear, and the System page's Template overrides tab lists every Foundra override as Unknown age.

    Added

    • Colour and image swatches on the product page. When an option is set to Colour swatches or Image swatches (new in Solidshop 1.7.0), Foundra shows a round colour chip or a square image tile for each value. Chips and tiles are the same height as the text buttons beside them and at least 44px tall, a comfortable touch target, so a row that mixes the two (a Multi button among colours) stays on one line. A ring separated from the chip by the page background marks the selected chip, so the ring shows on a chip of any colour, the page's own included. The outline-button hover and active fills are kept off chips, so the swatch stays visible in every state. Each option is a fieldset with a legend, so its values form one radio group for screen readers, and once a value is picked the legend names it ("Colour: Navy"). Swatches work in dark mode and right to left.
    • Specification rows on the product page. The label and value rows a merchant adds to one product in Solidshop 1.7.0 appear in the Specifications tab after the product's custom fields. They close the ungrouped section, or form it when the product has no ungrouped fields. Rows are plain text and are shown exactly as typed, so <5 mm reads <5 mm. The standard, Downloadable and Service product templates all render the tab through this one layout, so the rows show on all three.
    • No quantity box for a product sold one per order. With Solidshop 1.7.0's Limit to one per order switch on, the product page shows only the stock badge, and the cart and the mini-cart state the quantity as text beside the Remove button.
    • Smart Search results page and search box, in Foundra's form controls, cards and colour tokens instead of Joomla's Bootstrap markup:
      • Search box (the Smart Search module): a labelled field with the button attached. Its search landmark takes the module's title as its name, so a docs search in the sidebar and a site search in the header can be told apart, and Joomla's untranslated "search" label is gone. In a sidebar the button shows only its icon, and screen readers still read its label.
      • Results page: each result has its own h2, so screen-reader users can jump from result to result by heading. Excerpts are cut around the first match, as Joomla cuts them. Sorting is a row of chip links instead of a dropdown, and advanced search is a native disclosure (<details>) instead of a Bootstrap collapse.
      • Results pages are served noindex, follow, because a page of results is a thin copy of pages indexed in their own right. A Robots value set on the menu item wins.
      • Dark mode and right to left: Joomla's Smart Search stylesheet is no longer loaded (its fixed greys vanished on a dark background). The suggestion list under the box is restyled with the colour tokens and positioned with logical properties, so it follows dark mode and mirrors in right-to-left languages. Highlighted terms use the warning tint, which dark mode redefines.
    • A Chips layout for the Menu module (foundra:chips in the module's Layout option) draws one level of links as a row of pills, such as a blog's topics or a catalogue's sections above the listing. With Start Level set to the level under a section, the section's own page leads the row as "All", so every page in the row links back to it. The current chip is announced as the current page, or as the current location on a page below it, the way Joomla's own menu announces it. A menu alias counts as current when the page it points to is. Headings, separators and deeper levels are skipped. The row wraps instead of scrolling, chips are 40px tall for touch, and the current chip is filled with the primary colour, so presets and dark mode follow.

    Changed

    • Bootstrap's right-to-left build on right-to-left sites. Joomla ships only the left-to-right build of Bootstrap, which Foundra loads for Joomla's own views, the Solidshop add-ons and third-party extensions. On a Persian, Arabic or Hebrew page, checkboxes sat apart from their labels, input groups were rounded on their inner corners, and spacing and alignment classes (ms-auto, text-end, ps-*) landed on the wrong side. Foundra now bundles Bootstrap 5.3.8's unmodified right-to-left build (the version Joomla 6 ships) and loads it in place of the left-to-right one on right-to-left pages. An extension that loads Bootstrap itself gets the right-to-left file too, and the two builds never load together.
    • Overrides are dated. Each Foundra override of a Solidshop view or layout states the version of the file it was last checked against. Solidshop 1.7.0's Template overrides tab (System page) uses that version to list them as up to date, or to flag one that falls behind after a later Solidshop update.
    • The error page prints the custom code slots. Custom Head Code, Custom Body Start Code and Custom Body End Code now appear on the error page in the same places as on every other page. An analytics or tag-manager snippet now records visitors who land on a broken link. Custom CSS and Custom JavaScript stay on regular pages only.

    Fixed

    • A booking waiting for its payment says so. The account Bookings page showed a booking on an order not paid yet (a bank transfer on its way) as Confirmed. With the Service add-on 1.0.1 it reads Awaiting payment until the order is paid.
    • In right-to-left languages, the breadcrumb separator pointed down. It now points toward the next crumb.
    • On blog and tag pages, screen readers announced the raw language key JLIB_HTML_PAGE_NAVIGATION, a key Joomla does not define, as the name of the pagination landmark. That wrapper also put one navigation landmark inside another. It is now a plain container, and the pagination keeps its single Pagination landmark.
    • Order statuses are readable in any colour. The account pages, order tracking and the order confirmation showed a status as its colour on a tint of that colour, which the pale default statuses cannot pass: Archived was 1.2:1, Draft 1.3:1. A status is now a neutral chip in the text colour with its colour as a dot, in light and dark mode. Needs Solidshop 1.7.0's order/status.php layout.
    • The cart, the checkout and order tracking have a main heading. The checkout and the tracking page had none, and the cart's disappeared while the cart was empty. With Show Page Heading on in their menu item, these pages and the account pages print the item's page heading as the main heading, with the page's own title under it. Product names on the wishlist page no longer skip a heading level.
    • The order tables name their last column, "Actions", for screen readers; the Downloads page read the raw key JACTIONS there. The checkout summary's edit button is named Edit cart, not Your cart.
    • On a narrow screen, the order items table of the order page and the tracking page now scrolls from the keyboard: it is a focusable region named after its card.
    • Text in the brand colour reads on every surface, preset and scheme. Ghost and outline buttons, links, the coupon toggle and badges used the button fill as their text colour: 4.1:1 on a card in dark mode. The active menu item was 4.2:1 on its tint (3.1:1 in dark mode). Text now takes a readable shade of the colour, and a Primary Color you set gets readable shades worked out from it, with dark button labels when your colour is light. Electronics' buttons carry dark labels (white was 2.8:1 on its sky blue), and Marketplace's green is one shade deeper (white was 3.3:1). In dark mode a hovered button brightens instead of darkening, which kept its label at 3.6:1.
    • Muted and footer text clears 4.5:1. The muted grey is a step darker, so it reads on the grey and tinted surfaces it sits on (the account sidebar's e-mail was 4.4:1). The footer's copyright line was 3.7:1, and grey buttons (the currency switcher's Change, Buy now) had near-black labels in dark mode, 1.8:1.
    • The newsletter and account bands print their text in full white (85% white was 4.2:1). On Minimal in dark mode, where the bands turn light grey, they use black text.
    • Downloads and invoices. A file that cannot be downloaded faded its whole row to half opacity, taking its Expired badge and "Link Expired" below readable contrast; now only its name is muted. The invoice type badge used a colour value browsers ignore, and a light yellow for credit notes that stayed light in dark mode; both are theme badges now.
    • No content outside a landmark. The top bar is a landmark named "Store notices", and the copyright strip sits inside the footer landmark. The footer's module titles are second-level headings whatever a module's Header Tag says, so they no longer skip a level after a page's main heading.
    • The closed mobile menu takes no focus. It was hidden from screen readers while its links stayed in the keyboard order; it is now inert until opened, and without JavaScript it still shows in the page.
    • Star ratings on My Reviews are named in the site's language ("4 out of 5") rather than in English, on an element that can carry a name.
    • The checkout's saved-address card showed a house for an office address and a building for a home.
    • The checkout summary includes the tax on shipping. With Solidshop 1.7.0, a rate marked On Shipping taxes the shipping; the summary's tax lines add it to the rate's line, so they match what the order records.
  3. 1.0.1

    Stable

    Tag pages get a Foundra template, the header menu's items line up, and the storefront overrides follow Solidshop 1.6.0's product-page switches and structured-data fixes. Requires Solidshop 1.6.0 or later — the overrides call core classes that first ship in that release; the install script refuses an older core with a plain message.

    Added

    • Tag pages (com_tags, a tag's list of tagged items) have a Foundra template. They used to fall through to Joomla's Bootstrap list group, with a heading that skipped from h1 to h3 and no card; they now render the blog listing's blocks, each item as the leading-article card, so a tag page and the blog read as one surface. Joomla's behaviour is kept — the filter form and its limit box, the "no items" notice, the content-plugin hooks and the truncation limit — with three improvements: the filter form renders only when it holds a control, an unpublished item is labelled as such rather than only tinted, and the teaser is cut as plain text, so the ellipsis stays on the paragraph's last line and no stray space sits before a comma or full stop.
    • Product page switches. The product page templates (standard, Downloadable and Service) and the stats and share / wishlist layouts honour the new Storefront settings in Solidshop 1.6.0: the sold count, the share button and the wishlist button can each be switched off per store. When both buttons are off, the empty row they sat in is left out.

    Changed

    • Only one Product per product page. A Products or Recently viewed module placed below a product page no longer marks every card up as a schema.org Product of its own. Handed several candidates, a search engine declined the page's rich result; the cards now yield to the product the page is about. Listing pages and home-page strips, where each card is a product in its own right, keep their markup.
    • Product cards carry an image, description and SKU in their structured data. A card used to declare a name, URL and price only, and a missing image is a critical error in Google's Rich Results Test, so every tile on a shop listing failed it. The image is the large rendition, falling back to the original when a store has no large thumbnail size.
    • Checkout summary tax is worked out at the shipping address, matching what the order records, with the store's address standing in until the shopper has entered one.

    Fixed

    • The sold count on the product page was hard-coded English. It is now translated in all 23 locales, plural-aware, and uses the language's thousands separator.
    • In the header menu, a Menu Heading or Separator parent lost its start padding and crowded the item before it. The trim that seats the chevron against the label now applies only when a link sits beside the toggle.
    • In the header menu, an item with no submenu sat a pixel lower than one with a submenu — most visible in Firefox. Every top-level item now shares one baseline.
  4. 1.0.0

    Stable

    First public release of Foundra (tpl_foundra), the Joomla 6 site template built for Solidshop. Requires Solidshop 1.5.0 or later — the release that ships the slideshow, categories, brands and recently-viewed modules the template styles, and the extension catalogue its account pages link to when an add-on is missing. Establishes the baseline that all future changelog entries are deltas against.

    Added

    • Five storefront presets — Default, Boutique, Electronics, Marketplace and Minimal — chosen from the template style. A preset is a small stylesheet that restyles the design tokens (palette, corner radius, shadows, spacing, the product card's picture ratio); only the active preset's stylesheet is loaded, switching presets moves no module and changes no content.
    • Template options: primary and accent colour (hex-validated; left at their defaults the preset's own palette applies, once changed the colour wins on every preset and the lighter and darker tints are derived from it), font family (the visitor's system font, or the bundled self-hosted Inter — no Google Fonts request), products per row (2 / 3 / 4, the preset decides when left at the default), product card style (standard, overlay, minimal), header style (standard sticky bar, centered, transparent-over-hero that turns solid on scroll), container width (1140 / 1320 / 1536 px, or fluid), logo as image or wordmark with a separate dark-mode logo, favicon, and a back-to-top button.
    • Dark mode, four ways: follow the visitor's system, force light, force dark, or a sun / moon toggle in the header whose choice is remembered in the browser. Dark values are a second set of colour tokens applied on the root element, so every override, module and add-on surface follows; the dark logo follows the class and the media query alike.
    • Custom code slots on their own tab — inline CSS, inline JavaScript, raw head markup, body-start and body-end markup — all stored in the style's settings, so they survive a template update. templates/foundra/css/custom.css and js/custom.js load automatically when present (a non-empty .min sibling is preferred); .dist starter files are shipped beside them.
    • Nineteen module positions — banner, top, header, nav, breadcrumb, fullwidth, main-top, sidebar-left, sidebar-right, content-top, content-bottom, main-bottom, footer-fullwidth, footer-1 to footer-4, footer-bottom and debug. Each renders only when it holds a published module; either sidebar switches the page to a sidebar layout, both give three columns. The nav module serves the header and the mobile drawer at once.
    • Every Solidshop storefront view has a Foundra template: product page (including the Downloadable and Service layouts the add-ons register), product listing with its toolbar, grid and pagination, cart, checkout with its empty and confirmation states, order tracking, wishlist, and all customer account pages — overview, orders, order detail, addresses, profile, wishlist, invoices, downloads, bookings, reviews and subscriptions. Where an add-on is not installed, its account page shows a short notice linking to the add-on through the extension catalogue instead of an empty table.
    • Every Solidshop layout the views render through: the product card, media gallery, name, price, options, variants, quantity, custom fields, related products, share / wishlist controls, product and download stats; the mini-cart drawer; checkout and account address forms and lists; the account sidebar; the coupon form; checkout policies; promotion notices; order and line custom fields; the bank-transfer instructions; the invoice view.
    • Storefront module overrides: mini-cart, products, slideshow, categories, brands, recently viewed, reviews and the language switcher — plus Joomla's breadcrumbs, pagination and Articles module.
    • Three layouts of its own for the Slideshow module, listed in the module's Layout option as foundra:split, foundra:centered and foundra:banner beside the default full-bleed hero:
      • Split — the picture on the inline-end half in a fixed 4:3 box, the text on a plain surface on the other half with no scrim; the two stack picture-first below the large breakpoint.
      • Centered — the full-bleed photo with the text centred in a narrower measure, the dots under it and the Previous / Next arrows on either side.
      • Banner — a slim strip (eyebrow, heading and button on one line) for a promotion above a listing or on a category page; one slide is a static band, several a small slideshow.
    • Three layouts of its own for the Categories module, listed in its Layout option as foundra:editorial, foundra:compact and foundra:cards beside the default picture tiles. Every display option (picture, name, product count, heading level, columns, class suffix) and the accessibility contract (one link per tile, the picture's alt empty while the name is visible) hold in all three:
      • Editorial — the first category as a feature tile two columns wide and two rows tall, the rest packed beside and below it; the even grid again under the large breakpoint.
      • Compact — a row of small round-cornered thumbnails with the name beneath and no scrim, cells capped at 7rem, for a sidebar or a thin band; a row of chips with the picture off.
      • Cards — the picture in a fixed 4:3 box, the name and count on a surface panel below, bordered like the product card; for light or busy pictures that an overlaid label reads badly on.
    • The rest of the site, not just the shop. Foundra's own templates for the Joomla views a storefront leans on: a single article and the category blog (com_content), the Contact page (com_contact), sign-in, logout, registration, password reminder, every step of password reset and the profile (com_users), and the shared joomla.content.* layouts for images, read-more, tags and the info line. Joomla's physical image float classes map to logical foundra__figure--start / --end, so an article's picture sits on the reading-start side in Persian too. The blog page and the "From the blog" module render the same card.
    • Error and offline pages on the same tokens: the error page keeps the template's header and logo; the offline page is a single card with the logo, the offline message and the sign-in form.
    • Bootstrap re-skinned, not removed. Foundra's own templates use no Bootstrap grid or physical spacing classes, but Joomla's Bootstrap stylesheet still loads for the add-ons and third-party extensions that render its classes, and that chrome — pagination, forms, alerts, tabs, plugin-rendered order sections and review / booking fragments — is retokened onto Foundra's palette in both colour schemes.
    • Right-to-left by construction: logical CSS properties throughout, so margins, padding, borders and positioning flip with the text direction, and the slideshow and gallery arrows mirror with them.
    • Accessibility: skip links to the content and the search, translated landmark labels, a mobile menu that traps focus while open and closes on Escape, visible focus states, and animation that stands down under prefers-reduced-motion.
    • Inheritable. Joomla's Create Child Template works out of the box; a child carries only the files it overrides and reads everything else from Foundra, so a template update leaves it untouched.
    • 23 locales for the template's own strings (en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, ar-AA, he-IL, fa-IR, zh-CN, zh-TW, ja-JP, ko-KR, ru-RU, tr-TR, vi-VN, th-TH, id-ID, pl-PL, cs-CZ, el-GR, hi-IN).
    • Installer guard and update stream. The install script refuses to install or update against a Solidshop core older than 1.5.0, or without Solidshop at all, with a plain message instead of a fatal error. Updates arrive through Joomla's extension updater from the solidshop.app update server.