article
Changelog
= 1.0.21 =
- The Homepage tab's master switch now carries a highlighted note spelling out that Bootstrap 5 is available to every HTML box on the tab: the theme already loads Bootstrap 5.3.3, its JavaScript bundle and Bootstrap Icons 1.11.3 on the front end, so markup typed into the banner or a custom HTML slot can use the grid, buttons, utilities, icons and the components driven by
data-bs-*attributes without adding a stylesheet. - Fields can carry a
notealongside theirdesc, rendered under it with a tinted background and a rule in the brand colour. It is a separate key rather than markup inside a description because descriptions are escaped on purpose — the two on the Header & Footer tab have to print<head>and</body>as the literal tag names a reader is being told to paste. - Section 2 — Product Categories now has a Products Categories checkbox list, so the cards are chosen rather than taken from the top of the alphabet. Ticked categories appear in the order set by dragging them on Products → Categories, and a category holding no products yet is included, because ticking one is an explicit instruction to show it. Tick nothing and the section behaves exactly as it did before — the first n by name, empty categories hidden — so an existing homepage keeps its category row across the upgrade. The Products Categories numbers field now applies only to that fallback.
- The card body is the category's own subcategories, listed as text links one per line, in place of the category description. Three lines are reserved whether they are filled or not, so the cards across a row stay level and their images keep a common baseline; a category with no subcategories shows the card with the space empty. At most twenty are listed, so one crowded category cannot stretch every card beside it. Direct subcategories only — a deeper tree printed flat would lose the nesting that gave it its meaning.
- The product count chip and the "View products" line are gone from the card, and the arrow that sat on that line now follows the category name in the heading. The image and the heading both lead to the category, each subcategory name leads to its own archive, and the subcategories are text links with no image of their own.
- Because the card now holds several destinations, it is no longer one link wrapped around everything — an anchor cannot be nested inside another anchor, and a whole-card link would have swallowed the subcategory links. The image is marked decorative and taken out of the tab order, so assistive technology and keyboard users reach the category once through the heading rather than twice per card.
= 1.0.20 =
- The footer's contact details moved out of their own column and into the first one, between the company introduction and the social links, so who the company is and how to reach them read as a single block. The column that held them is now free for a menu.
- New Foot Menu 3 location, rendering a fourth footer column at the right-hand end, plus a matching Footer Column 3 widget area that overrides it the same way the other two do. Assign it under Appearance → Menus; left unassigned, no column is rendered, so an existing site's footer looks exactly as it did apart from the contact details moving.
- New Custom code section on the Header & Footer tab: two boxes, "Custom HTML on header" and "Custom HTML on footer", printed inside
<head>and just before</body>on every page. For analytics and tag manager snippets, a verification meta tag, a<style>block or a chat widget. Printed exactly as typed — no paragraph tags, no shortcode pass — because a reformatted tracking snippet is a broken one. - The header box is printed after the theme stylesheet, so CSS there overrides the theme; the footer box after the theme's own scripts, so JavaScript there can call into them. Both are empty by default and print nothing at all while empty. A
<script>tag needs theunfiltered_htmlcapability to survive saving, which an administrator has on a single-site install; without it the snippet is filtered on save as post content is. - New search icon in the header bar, at the right-hand end next to the CTA button. Clicking it drops a panel out of the bar with a search field and a GO button; Enter or GO runs the search and lands on the results page. Escape, a second click on the icon, or a click anywhere outside closes the panel, and on a results page the field arrives holding the query that produced it.
- The icon is beside the hamburger on phones and tablets rather than inside the menu, so searching does not mean opening the menu first. The panel is positioned off the bar rather than inside it, so opening it does not push the page down.
- The search itself is a plain GET to the site root — the same request the theme's other search forms make — so results come from WordPress's own search and the panel needs no JavaScript to submit. With scripts blocked the panel stays closed rather than opening with no way to shut it.
= 1.0.19 =
- New Import / Export tab. Shows every setting from the other tabs as JSON, grouped by tab and in the same order as the tabs themselves. Copy it to the clipboard, or download it as a dated
.jsonfile, to keep a record of a configuration before changing it or to move one to another site running the theme. - Importing accepts either a pasted document or an uploaded
.jsonfile, and writes only the settings the file contains — anything it does not mention keeps its current value, so a file trimmed by hand is safe to import. Entries that are not settings of this theme are counted and ignored rather than stored, and every value is put through the same checks as a value typed into its own field, so an import can write nothing the options panel could not. - License details are in neither the export nor anything an import is permitted to write. A license belongs to the site it was activated on, so it does not travel with the settings. The Import / Export tab holds no settings of its own and therefore cannot appear in its own export.
= 1.0.18 =
- Fixed unreadable buttons in the content area. A prose rule,
.pf-content a, was one step more specific than Bootstrap's.btnand so overrode the text colour of every button placed inside a page's content — including the Latest News button, the Editor's Choice buttons and the add-to-cart buttons in the homepage product grids. Since that rule's colour defaults toinherit, a brand-filled button came out as body ink on dark teal. Buttons are now excluded from it and each one keeps its own colour again. - The outline button variant is now transparent rather than white, so it reads as an outline on the tinted section backgrounds as well. On white it looks exactly as it did.
- The Latest News button is now the outline variant — a border on a transparent background — instead of the solid brand fill, which sat awkwardly at the foot of a tinted section.
= 1.0.17 =
- New Homepage section, 3A — Editor's Choice: a tab per product category, with a grid of that category's newest products under it. Tick the categories to offer on the Homepage tab, set how many products each tab shows, and the grid swaps as a visitor moves the pointer across the tabs or taps one. Tab order follows the drag-and-drop order on Products → Categories.
- Every tab's grid is rendered into the page, not fetched on demand, so switching costs no round trip, the products are all indexed, and the first tab still shows a full grid with JavaScript off. The tabs are a proper tablist: arrow keys move between them and the open one keeps its highlight after the pointer leaves. A category holding no visible products is dropped rather than left as a tab that opens onto nothing.
- New
termsoption field type: a checkbox per term of a taxonomy, stored as an array of term IDs. Unticking every box now saves as "none chosen" instead of leaving the previous selection in place, which is what an ordinary checkbox group would have done.
= 1.0.16 =
- Four custom HTML slots on the Homepage tab, one after the banner, one after Latest Products, one after About Us and one after Latest News, each with its own Enable box. They take raw HTML and shortcodes and print them exactly as typed — no paragraph tags are inserted, unlike the banner and About Us copy fields — so a row the five built-in sections do not cover can be hand-built between them. An empty slot renders nothing.
= 1.0.15 =
- Added a Homepage tab to Theme Options and a
layout_homepage.phppage template. One master switch — off by default — turns the front page into five independently switchable sections: a shortcode-capable banner, WooCommerce product categories, the newest products, an About Us block with a video, and the newest posts. While the switch is off nothing changes: the switch works throughtemplate_include, so the template hierarchy is untouched, and the front page's own content is never altered. - The About Us video loads nothing from YouTube or Vimeo until a visitor presses play. The cover image is shown with a play button over it and the player is swapped in on the first click; a direct
.mp4uses<video>with the cover as its poster instead. The oEmbed lookup is cached for a day, keyed by the address. - The Homepage template is also selectable by hand as "Homepage (PlayForge)" under Page Attributes, for laying the design out on a draft before switching it on for the live front page.
- New option field types behind the tab:
numberwith clamped bounds,richtextfor copy that carries shortcodes and embeds — kept as typed for an author withunfiltered_html, the same rule core applies to post content, sincewp_kses_post()would otherwise strip the<iframe>out of a banner — andheading, which renders a group separator inside a tab's table.
= 1.0.14 =
- Both sidebars are now 20% of the container wide instead of a third, from 992px up, with the main column taking the remaining 80%. Set by the new
--sidebar-widthtoken, which drives the main column too, so the pair cannot disagree. - The product grid is four per row in every layout. It used to drop to three beside a sidebar, which a 20% sidebar no longer calls for, and it means Products per page is a whole number of rows either way.
- Blog, archive and search cards are three per row in both layouts for the same reason; they were two per row beside the old wider sidebar.
= 1.0.13 =
- The product detail header band no longer repeats the short description. It already appears beside the gallery in the product summary, so the banner showed it twice.
- The product list description moved out of the header band to a new
.pf-shop-introblock below the breadcrumb, at the full content width — room for a long introduction with images rather than a lead trimmed to 32 words and stripped of its HTML. On the shop page it is the shop page's content (its excerpt as a fallback); on a product category or tag it is the term description. - Shortcodes, blocks and inline HTML now render in that introduction: the content passes through
do_blocks(),wp_kses_post()andwc_format_content(), in that order. - Removed
woocommerce_taxonomy_archive_descriptionandwoocommerce_product_archive_descriptionfromwoocommerce_archive_description, which were printing the same description a second time above the grid. playforge_page_header()now takes'lead' => nullas its default and resolves the automatic lead in the newplayforge_page_header_lead(), filterable viaplayforge_page_header_lead. Passing an empty string is an explicit "no lead" — previously the automatic one filled it back in.
= 1.0.12 =
- Added a WooCommerce Sidebar widget area (
playforge-woo-sidebar), used by the two-column shop layouts in place of the general Sidebar. Product filters, category lists and a mini cart now live beside the shop only, and the blog's widgets no longer appear on product pages. Registered while WooCommerce is active. - Which area a request uses is resolved by the new
playforge_sidebar_id()and filterable viaplayforge_sidebar_id— returnplayforge-sidebarto restore the single shared sidebar. playforge_has_sidebar(), thepf-no-sidebarbody class andsidebar.phpall test the resolved area rather than the general one, so a shop page with an empty WooCommerce Sidebar collapses to one column even when the general Sidebar is full.- The sidebar column now carries a
pf-sidebar--wooorpf-sidebar--generalmodifier beside the sharedpf-sidebarclass, so one can be restyled without the two diverging by accident.
= 1.0.11 =
- Added a WooCommerce tab to Theme Options, shown while WooCommerce is active. The product list (shop page, product category and tag archives) and the product detail page now each carry their own layout default — full width, or two columns with a left sidebar — instead of borrowing the Blog & archives and Pages settings.
- Added a Products per page setting to the same tab: 12, 16 or 20, each a whole number of four-product rows. Previously fixed at 12 in code.
- The "PlayForge Layout" box now appears on the product edit screen, so a single product can override the detail default.
playforge_get_layout()already honoured layout meta on any singular view; only the control to write it was missing. - Select fields in the options panel now resolve their choices through one
playforge_option_choices()helper shared by the renderer and the sanitizer, so a select can no longer offer a value the sanitizer would reject, and an out-of-range value falls back to that field's registered default rather than a hardcodedfull-box.
= 1.0.10 =
- Fixed the add-to-cart / "Read more" buttons in WooCommerce block grids — the product grid the cart page renders while the cart is empty, and the All Products block — rendering in the block editor's own dark slate (#32373c) instead of anything from the palette. They are now a white outline button with a grey border, brand tinted on hover, driven by the new
--block-btn-*tokens.
= 1.0.9 =
- style.css is now fully tokenised: every colour, font, weight, radius, shadow and band background is a CSS custom property declared in one
:rootblock, and no rule outside it holds a literal colour. assets/css/woocommerce.css reads the same tokens. See "Design Tokens". - Added a Bootstrap bridge, mapping
--bs-primary,--bs-link-color,--bs-border-color,--bs-border-radiusand--bs-focus-ring-coloronto the theme palette, so Bootstrap components, Elementor widgets and plugin markup follow the brand colour..btn-primaryand.btn-outline-primarynow render as brand buttons, and a.nav-linkon hover no longer turns Bootstrap indigo. - Fixed
.btn-brandand.btn-outline-brandgoing transparent when pressed or disabled, and showing no focus ring: Bootstrap leaves those variables unset on a bare.btn, and the theme only filled in the resting state. Both variants now declare the full hover / active / disabled / focus set. Added a matching.btn-accent. - Narrow-screen spacing moved from retuned tokens to dedicated
-smtokens applied at rule level, so a child theme's:rootcan no longer shadow it and silently restore the desktop padding on phones. - The navbar no longer carries Bootstrap's
.bg-white, which is!importantand made it the one surface a child theme could not retint. Its background comes from--surfaceinstead,#fffby default. - Under a child theme, the parent stylesheet is now enqueued separately and after Bootstrap. Previously the parent sheet was only ever loaded by the child's own boilerplate enqueue, which placed it before Bootstrap and let Bootstrap's reboot beat the parent's base rules.
- Accessibility: the email floating contact button was white on amber (1.9:1) and is now dark ink on amber. Themed
::selection. - Removed a stray trailing divider under the last item of
.capability-list. - playforge-child-blue (renamed from playforge-child-blank) rewritten as a variable-only child theme: 1010 lines to about 430, same design. Its redundant stylesheet enqueue and a broken
@importof an uninstalled theme's rtl.css are gone.
= 1.0.8 =
- A product with no price, or a price of exactly zero, no longer renders a price line at all — WooCommerce's single-product template emitted an empty
<p class="price">and its loop template printed $0.00. Variable and grouped products are exempt, since their price html is a range.
= 1.0.7 =
- Shop listing: dropped the theme's CSS Grid override, which fought WooCommerce's own item widths, so the arrangement is once again WooCommerce's stock float layout. Default is now four products per row and twelve per page (three per row alongside a sidebar), and related products and upsells follow at four.
- Loop thumbnails scale with the column (square by aspect ratio) instead of being pinned to a 220px height, so they no longer look undersized in a wide container.
- Fixed the loop add-to-cart button being 2rem wider than its card, and clipped as a result: it no longer carries Bootstrap's
w-100.
= 1.0.5 =
- Added the
elementor-boxedpage layout: bare like Full Canvas — no page header band, no breadcrumb, no vertical spacing — but width-limited by--box-widthinstead of edge to edge.
= 1.0.4 =
- Added the
--box-width,--page-paddingand--page-margindesign tokens for setting the boxed page width and the content area's default padding and margin. See "Design Tokens".
= 1.0.3 =
- Added the
elementor-full-canvaspage layout: no page header band, no breadcrumb and none of the theme's own spacing.
= 1.0.2 =
- Fixed the second- and third-level menu items of the current page rendering as white-on-blue instead of following the theme palette, and limited
aria-current="page"to the item that is actually the current page.
= 1.0.1 =
- Main menu: a parent item's text is now a working link. Submenus open on hover on the desktop layout and from a chevron button on touch screens and in the collapsed menu, at unlimited nesting depth.
= 1.0.0 =
- Initial release. Port of the Hugo theme "Playforge" to a classic WordPress theme.