=== Stoat ===
Contributors: owldraft
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: blog, news, one-column, block-styles, custom-colors, custom-logo, custom-menu, editor-style, featured-images, footer-widgets, sticky-post, theme-options, threaded-comments, translation-ready

Stoat is a fast, privacy-friendly WordPress theme for news sites, magazines, and independent journalists.

== Description ==

Stoat is a WordPress theme for news sites, magazines, newsrooms, and independent journalists. No page builder, no external fonts or scripts, and a single compact stylesheet.

Nothing is requested from a third-party server: type comes from your system fonts or the WordPress Font Library, and the theme ships one small front-end script.

Features:

* WordPress 7.0 ready; PHP 7 and 8 ready.
* No page builder, no external requests. Compact CSS in a single stylesheet and one small front-end script (js/modal.js) that drives the search, mobile menu, and sign-in overlays.
* Self-hosted fonts via WordPress's Font Library (WordPress 7.0+); system-font fallback on older versions.
* Separate font choices for body, headings, navigation, and logo.
* Color options for text, accent, background, meta text, and text selection.
* Three header layouts (logo left, logo center, nav below), a light or dark header skin, and adjustable header padding and border.
* Header call-to-action button, with its own style and a separate state for signed-in readers.
* Search icon that opens the search form in a dialog, at every width.
* Three menu locations: primary, social, and footer.
* Social links in the header and footer, with the right brand icon picked automatically from each link's URL.
* Archive options: feature the newest post as a hero, thumbnail side, ratio and width, excerpt length, and toggles for date, author, avatar, categories, and comment count.
* Single-post options: featured image with a width cap, subtitle, category position, tags, and comments.
* Footer widget area, above the copyright line.
* Content width control, with separate defaults for posts and pages.
* Sticky post styling, wide and full-width blocks, and editor styles so the block editor matches the published page.
* Text or image logo.
* Responsive, looks great on all devices.
* Translation-ready.

Demo: https://stoat.owldraft.com

== Installation ==

1. In your admin panel, go to Appearance -> Themes and click the 'Add New' button.
2. Type in Stoat in the search form and press the 'Enter' key on your keyboard.
3. Click on the 'Install' button, then the 'Activate' button to use your new theme right away.
4. Navigate to Appearance -> Customize in your admin panel to customize the theme to your taste.

Full documentation: https://docs.owldraft.com/stoat/

== Frequently Asked Questions ==

= Does this theme use Google Fonts? =

No. Stoat serves self-hosted fonts only, through the WordPress Font Library (WordPress 7.0+). On older versions it falls back to the native system font stack.

= Does this theme load any JavaScript? =

Almost none. The theme ships one front-end script, js/modal.js, which opens the overlays: the search dialog, the mobile menu, and the sign-in form. Core's comment-reply script loads only on singular views when threaded comments are enabled.

= How do I remove the theme credit in the footer? =

Customize -> Footer -> turn off "Keep theme credit". GPL does not require keeping it.

= Where is the changelog? =

https://docs.owldraft.com/stoat/changelog/

== Changelog ==

= 1.4 =
* Released: September 11, 2026
* New in Customize > Header: "Header layout" — logo left, logo centered, or the navigation on its own full-width row below the logo. A header border and a switch for the search icon come with it.
* New: a Social menu location. Put your profile links in a menu and each one takes the brand icon its URL implies; separate switches show the row in the header, the mobile drawer, and the footer.
* New modal mechanism, shared by every overlay in the theme. One small script replaces the two the theme used to ship (js/search.js and js/a11y.js are gone) and the mobile menu's inline handlers. See MODALS.md.
* The search icon now opens the search form in a dialog, at every width — phones included. The duplicate copy of the form inside the mobile menu is gone.
* The mobile menu is now a modal drawer. Escape-to-close and focus-trapping are always on, so Customize > Misc no longer carries the "Enhanced menu keyboard support" toggle.
* New in Customize > Header: "Button action". Leave it on "Go to a link" for the button you already have, or switch to "Open a modal" for a panel built from any page — a pricing table, a sign-up offer, whatever the page holds.
* With JavaScript off, every dialog now renders as ordinary content at the foot of the page instead of leaving a button that does nothing.
* New: a Footer Widgets area, above the copyright line. Widget titles, link lists, and a "you are here" mark on the current item in nav, pages, and category widgets. The row is drawn only when a widget really prints something, and switching to Stoat no longer sweeps the previous theme's widgets into it — they wait in Inactive Widgets instead.
* New: theme.json, so the editor canvas and the front end share one set of colors, sizes, and spacing — including the content and wide widths that the Wide and Full alignments follow.
* The editor now writes posts on a serif sheet at the width the post will render at; Full-width pages still edit full width.
* New: Appearance > Stoat — one screen carrying the theme's documentation, its changelog, and where to ask for help.
* Archive > "Feature the first post" lifts the lead story above the loop as a half-width hero.
* Author archives put the avatar above the name and bio; search results take a body-size title; the 404 loses its dangling rule.
* A pass over every screen narrower than a tablet: tighter listing rows, a headline and excerpt that step down together, two columns of footer links instead of one long stack, a centered footer strip, comment replies that keep their width, dialogs that stop above the browser's own toolbar, and form fields at 16px so tapping one no longer zooms the page in.
* The subtitle field is now posts only — a headline device belongs to a story, not to an About page. A value left on a page stays hidden rather than showing with no way to edit it. Filter stoat_subtitle_post_types to hand the field back to pages or a CPT.
* New Customize options: logo and nav fonts, button corner radius, category position, author name + avatar, which side the listing thumbnail sits on, and how wide the single featured image runs.
* Customize > Style now opens the Accent color picker on the color the page is actually using, rather than on an empty swatch. Clearing it still returns the accent to the theme default, as every color there does.
* New stoat_entry_flag hook on listing entries, so a plugin can mark an entry (a members or paid chip) without touching a template.
* The search form is capped at 400px.

= 1.3.2 =
* Released: September 3, 2026
* Documentation has moved to https://docs.owldraft.com/stoat/ and the demo to https://stoat.owldraft.com.
* The theme description now points to the new demo address.

= 1.3.1 =
* Released: August 8, 2026
* The theme is now published by Owldraft. Theme author, author URI, and theme URI have been updated.
* Documentation has moved to https://themedocs.github.io/stoat.
* The footer theme credit links to the new theme URL.

= 1.3 =
* Released: July 17, 2026
* New Customize > Layout section: set the content width and the narrow reading column in pixels, then pick Narrow or Full for archives, pages, and posts independently.
* New per-page override: the page editor's "Page options" box can set a page's content width to Narrow or Full, or leave it on the Customizer default.
* New Customize > Header section: "Header skin" (Light or Dark), "Header background color" and "Header text color" (leave either empty to follow the skin), and "Header padding".
* New header button: give it text and a link in Customize > Header to add a call-to-action to the header bar, in Primary, Black, White, or Outline style, optionally opening in a new tab. On mobile it moves into the off-canvas menu, full width.
* New in Customize > Single Post: "Show featured image (top)", which puts the featured image above the post content along with its caption. Off by default.
* New in Customize > Footer: "Footer padding".
* The footer now follows the content width set above it instead of always using the reading column.
* Button blocks in the editor now match the front end, and the Details block is styled.

= 1.2.2 =
* Released: July 16, 2026
* New in Customize > Typography: "Navigation font" (defaults to whatever the headings use), "Heading font weight", and "Heading letter case".
* New in Customize > Style: "Meta text color", for the date, categories, and comment count.
* New in Customize > Blog / Archive: "Thumbnail ratio" (square, landscape, portrait, or the image's original ratio) and "Thumbnail width" (a pixel size, or a percentage that tracks the post row).
* Styled the core Query Loop blocks — post title, featured image, date, terms, author, excerpt, and pagination now match the theme's own archive.
* Fixed: a 404 URL rendered the full post archive underneath the "Nothing found" heading instead of just the message and a search form.
* Fixed: two roles sharing one font family emitted that family's @font-face rules twice.
* Heading spacing and list indentation now apply everywhere, not only inside post content.
* Footer credit links to the canonical theme URL.

= 1.2.1 =
* Released: June 23, 2026
* Updated screenshot.jpg and documented the CC0 license/credits for the images used in it.

= 1.2 =
* Released: June 19, 2026
* Minor style refinements.

= 1.1.1 =
* Released: June 9, 2026
* Mobile menu open/close is now pure CSS + inline handlers; Esc and focus-trap moved to an optional js/a11y.js (Customize > Misc).
* Removed the classic-editor toggle (use the official Classic Editor plugin instead).
* "Disable pages in search results" now defaults off.

= 1.1 =
* Released: June 8, 2026

= 1.0 =
* Initial release.

== Copyright ==

Stoat WordPress Theme, (C) 2026 Owldraft.
Stoat is distributed under the terms of the GNU GPL v2 or later.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

This theme bundles the following third-party resources:

Normalize.css, (C) Nicolas Gallagher and Jonathan Neal.
License: MIT.
Source: https://necolas.github.io/normalize.css/

Screenshot images, all licensed CC0 (https://creativecommons.org/publicdomain/zero/1.0/):

Photo by Ghost Presenter.
Source: https://stocksnap.io/photo/grayscale-puppy-LPXVEYAQCA

Photo by Azer Koçulu.
Source: https://stocksnap.io/photo/people-old-QDJJ8Y5Q54

Photo by Sergei Gussev.
Source: https://stocksnap.io/photo/lake-mountain-EO9QUOWDTS

Photo by World Wildlife.
Source: https://stocksnap.io/photo/lion-animal-GBV4APX0N7
