=== Kestrel ===
Contributors: symelo
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A rugged, technical outdoor gear store theme for WooCommerce, with spec chips, gear checklists, spec sheets, a repair and rental form and trip reports.

== Description ==

Kestrel is built for outdoor brands and bike, climbing and hiking shops that sell on numbers: weights, temperatures and waterproof ratings come first. Condensed uppercase headlines, spec chips, heavy 2px rules, angled corners and dark topographic bands give the store a field-tested look, in light and dark.

* **Store templates:** a technical product page (gallery with thumbnails and zoom, sticky summary with badges, highlights, add to cart, size guide, spec list, delivery and details), a catalog with filters always open on desktop and the results bar in a dark band, product search, cart, checkout, order confirmation and a mini-cart drawer with the free-shipping threshold.
* **Product extras:** badges (Limited, Eco… plus automatic New, Sale, Sold out and low stock), highlights, specifications, materials, care, product video and shared size guides that open in a dialog. They use the free Secure Custom Fields plugin, which the theme offers to install.
* **Store extras:** announcement bar, selling points, trust badges, shipping and returns, free-shipping threshold, all under Products → Store extras.
* **Patterns:** summit, trail-video, conditions, gear-list and latest-trip heroes; a conditions marquee, activity tiles, a new-gear carousel, a numbered gear checklist, a spec comparison table, a field-tested strip, a repair band, field stats, field reports, gear questions, the crew, a brands marquee, trail films, field photo galleries, the trail journal, forms (contact, newsletter, repair and rental request) and complete pages (home, about, contact, landing, repairs, films and photos).
* **Trail journal:** a blog home with the newest report wide, trip-report cards with reading time, and a "Trip report" template with a full-width photo header and a sticky route card (table of contents, sharing).
* **Demo store:** Appearance → Import demo creates products, categories, badges, a size guide, Home, About, Contact and Shipping pages, the menu and the store extras, and removes them again with one click.
* **Built in, no extra plugins:** forms with a Messages screen, galleries with lightbox and carousel, click-to-load video, motion (reduced for visitors who ask for it), light and dark color schemes with a switch, four style variations (Night trail, Alpine, Forest, Field).

== Frequently Asked Questions ==

= Do I need WooCommerce? =

Yes, Kestrel is a store theme. Without WooCommerce your posts and pages still work, and the dashboard links to the WooCommerce installer.

= Where do badges, highlights, specifications and size guides come from? =

From the Product extras box on each product (with Secure Custom Fields active) and from Products → Badges and Products → Size guides. Weights and dimensions entered in WooCommerce are added to the specifications automatically. Store-wide texts (announcement bar, selling points, trust badges, shipping and returns) are under Products → Store extras.

= Where do form messages go? =

Every form submission, including repair and rental requests, is saved under Messages in the dashboard and, unless the form says otherwise, emailed to the address in Messages → Settings (the site's admin email by default). Newsletter forms only store the address.

= How do I add a product video? =

Paste a YouTube, Vimeo or video file link in Product extras → Video. YouTube and Vimeo load only when a visitor presses play.

= How do I use the trip report layout? =

Edit a post, open Template in the post settings and choose "Trip report (photo header)". Its featured image becomes the header and its headings fill the route card's table of contents.

= Can I turn off the animations or dark mode? =

Animations stop for visitors who prefer reduced motion, and the trail video pauses with its own button. Dark mode follows the visitor's system setting until they use the switch in the header; choose a style variation in Appearance → Editor → Styles to change the default (Night trail starts dark).

== Changelog ==

= 1.0.0 =
* First release.

== Copyright ==

Kestrel WordPress Theme, (C) 2026 Symelo LTD. Kestrel is distributed under the terms of the GNU GPL.

This theme bundles the following third-party resources:

Big Shoulders Display, Copyright 2019 The Big Shoulders Project Authors (https://github.com/xotypeco/big_shoulders)
License: SIL Open Font License, Version 1.1 (assets/fonts/big-shoulders-display/OFL.txt)
Source: https://fontsource.org/fonts/big-shoulders-display

Rubik, Copyright 2015 The Rubik Project Authors (https://github.com/googlefonts/rubik)
License: SIL Open Font License, Version 1.1 (assets/fonts/rubik/OFL.txt)
Source: https://fontsource.org/fonts/rubik

Symelo placeholder library (https://dev.symelo.com/tools/placeholder-images), (C) 2026 Symelo LTD, distributed with the theme under the GPLv2 or later:
assets/images/alpine-lake.webp (nature-5), assets/images/misty-lake.webp (nature-1), assets/images/waterfall.webp (nature-3), assets/images/ice-lake.webp (nature-11), assets/images/alpine-village.webp (travel-7), assets/images/viaduct.webp (travel-3), the video loop assets/video/kestrel-loop.mp4 (made from nature-1, nature-3 and travel-7), and the shop foundation's demo images in inc/foundation/demo/images (abstract-2, abstract-9, abstract-11, abstract-3, technology-8, workspace-1, workspace-12, food-10, interiors-1, workspace-6).

Symelo Theme Kit and Symelo shop foundation (inc/kit, inc/foundation), (C) 2026 Symelo LTD, GPLv2 or later.

Icons in the shop foundation are drawn for it, (C) 2026 Symelo LTD, GPLv2 or later.

The trail film patterns link to open films by the Blender Foundation and Blender Studio (CC BY) on YouTube; they are not bundled and load only when a visitor presses play.
