=== DIGISTARTER ===

Contributors: digistalter
Requires at least: 6.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GNU General Public License v3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Tags: full-site-editing, block-patterns, block-styles, style-variations, custom-colors, custom-logo, custom-menu, editor-style, featured-images, one-column, threaded-comments, translation-ready, wide-blocks, rtl-language-support

A block theme starter kit with a large pattern library and three corner-radius styles, built to be extended through child themes.

== Description ==

DIGISTARTER is a starter theme for the WordPress Site Editor. It ships the technical groundwork of a block theme - design tokens in theme.json, a small set of block styles, and a card component shared by the blog, the archive and the search results - and leaves the design decisions to you. On top of that it provides a preconfigured header and footer, a blog layout with a featured post and a reading suggestion picked at random, an archive and search grid, a single post layout with comments and related posts, and a 404 page. Over forty ready-made section patterns cover openers, text, media, pricing, testimonials, statistics, FAQs and other dynamic content, so a page or a blog comes together from existing pieces. Three corner styles - square, rounded and extra rounded - are available in light and dark, six style variations in total. Since a variation changes only colour and shape, layouts stay comparable side by side while you decide on a look. Everything visual is expressed through theme.json tokens, so colours, radii and type belong in a child theme and need no changes to any template. The theme adds CSS only where a block support does not exist, and every such rule carries the reason in a comment. This makes DIGISTARTER a solid foundation to build a fully custom design, or additional patterns, on top of - without ever touching the parent theme.

== Installation ==

1. In your site's dashboard go to Appearance > Themes and click Add New.
2. Click Upload Theme, choose the ZIP file and click Install Now.
3. Click Activate.

== Frequently Asked Questions ==

= How do I change the look? =

The theme ships six style variations that you can switch under Appearance > Editor > Styles, without touching any code.

To add your own, place a JSON file in the /styles/ folder of a child theme - inside this theme it would be lost on the next update. Use theme.json as the blueprint for its structure: a variation only needs the settings it actually changes.

= How do I build my own design on top of DIGISTARTER? =

Create a child theme and point it at digistarter as the parent. Override colours, type or spacing through your own theme.json, add patterns in your own /patterns/ folder, or replace a single file from /inc/ by filtering digistarter_modules - none of it touches the parent theme, so updates stay safe.

= Why is there no page title on my pages? =

The page template deliberately renders the content only. Add a heading as the first block, or start the page with one of the opener patterns. Posts do show their title.

= The images in the patterns look like coloured squares. =

Those are placeholders. Select the image block and replace it with your own picture; the pattern keeps its proportions.

= How do I add legal links to the footer? =

Activation creates two empty menus for the footer, Footer-Menu 1 and Footer-Menu 2. Add your privacy policy, imprint or other required pages to Footer-Menu 2 under Appearance > Editor > Navigation - the footer already points to it. The theme makes no assumption about which pages exist.

== Copyright ==

DIGISTARTER WordPress Theme, (C) 2026 DIGISTALTER GmbH
DIGISTARTER is distributed under the terms of the GNU GPL.

This theme bundles the following third-party resources:

Saira Variable font
Copyright (c) Omnibus-Type
License: SIL Open Font License, 1.1
Source: https://fonts.google.com/specimen/Saira
Full licence text: assets/fonts/LICENSE.txt

== Changelog ==

= 1.0.2 =
* New: four section styles - On accent, On neutral, On primary, On secondary - that set a band's background and text colour together, so one pattern serves every surface.
* New: a video stack opener, three full height films that slide over one another while scrolling.
* New: the text-and-image pattern is built on core/media-text, so its media can be a video as readily as an image. A video now takes the same frame an image would have anywhere in the theme.
* New: a sticky quote pattern - a quote and a person stay in view while a line of numbered steps scrolls past beside them, filling as the visitor reaches each one. Line, dots and fill are currentColor throughout, so the pattern reads correctly on every section style without a rule of its own for each one.
* New: a text reveal pattern - a statement stays in view and lights up as the visitor scrolls, then hands off to the rest of the page once it is fully lit. The heading is a plain, fully editable core/heading; assets/js/scroll-progress.js now drives both this and the sticky quote's line from the same shared script.
* Change: the sticky quote's step labels and the text reveal's lit fill now read accent, and the dash before a testimonial's name does too - all three step down to primary on an accent surface, the same rule already applied wherever a badge or button meets the same collision.
* Fix: the text reveal heading pinned to the top of the viewport instead of sitting centred between an equal gap top and bottom. Gutenberg's flex layout wires "Justify items" to align-items rather than justify-content for a vertical stack, which centred the heading horizontally but left the vertical centring undone.
* Fix: a post with comments switched off left an empty band of colour behind, up to 260px tall, where the comments would have been.
* Fix: a primary coloured button or badge disappeared once its own band was switched to the "On primary" section style - it now steps down a shade, the same rule already applied where the two collide through a background colour attribute instead.
* Fix: the same disappearing act on three more combinations the section styles made reachable - an accent badge or the default button on an "On accent" band, a badge or link hovering to secondary on an "On secondary" band, and an outline button's own fill on a primary or secondary band (white text was landing on the button's own white fill).
* Fix: the image carousel hid two of its three slides and showed two buttons that did nothing when its script did not run. All slides now stay reachable, and the controls appear only once the carousel works.
* Fix: the carousel built its dots from a fixed count, so adding or removing a slide left the row disagreeing with the slides.
* Fix: a page whose content brings no heading of its own keeps its title, instead of shipping with no first level heading at all.
* Fix: the fallback template showed an untranslatable "Nothing found." and a post list that ignored the theme's own card. It now uses the same pattern as the archive.
* Change: the accent, neutral and primary copies of the CTA banner, logo strip, quote section and statistics patterns are gone, replaced by one pattern each plus a section style.
* Change: the four pricing patterns and the four testimonials patterns are each one pattern now. Card, badge and button colours follow the band's own section style in CSS, so the two stay coordinated when the style is switched.
* Change: the carousel script is only loaded on pages that actually contain a carousel.
* Change: the theme no longer creates two navigation menus when it is activated. A menu named footer-menu-1 or footer-menu-2 is picked up if one exists.
* Change: the logo strip, CTA banner and quote section patterns ship on the plain page surface instead of the accent colour.
* Change: the "Hero: centered on colour" pattern is gone - the same opener already exists as "Hero: centered" on the plain page surface.
* Change: the style variations demo's own band ships on the plain page surface too - only its four cards are meant to carry colour.

= 1.0.1 =
* New patterns: a bento-style feature grid and a media variant of it, a style variations showcase, a colour system reference, an image carousel, progress bars, a menu list in two forms, and a timeline.
* New: the page title is shown while editing a page and left off the published page, so an opener pattern's own headline is not doubled up.
* Fix: a button on the primary colour did not switch to the secondary colour on hover, outweighed by core's own background colour class.
* Fix: the current item in a menu is now underlined in the accent colour, sized to the word rather than the whole clickable area.
* Fix: a hand-typed navigation link (no page picked from the list) was never marked as the current page, even while viewing it.
* Fix: the logo strips stacked their logos in the editor instead of laying them out in a row.
* Fix: on the pricing band over the primary colour, the outer two buttons were filled white while the middle one was outlined.
* Fix: the cached list of pattern files is cleared when the theme is switched, so a child theme cannot inherit a stale one.
* Fix: an outline button on a coloured surface changed only its border on hover, and changed it to a colour that vanished into the surface. Border and label now dim together.
* Fix: the progress bars run the full wide width, while the heading and intro above them keep the reading measure.

= 1.0.0 =
* Initial release: design tokens, block styles as theme.json partials, a documented module architecture, over forty section patterns, and three corner styles in light and dark.
