=== Invasion ===

Version: 1.2.0
Requires at least: 6.3
Tested up to: 6.8
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: two-columns, right-sidebar, left-sidebar, grid-layout, custom-background, custom-colors, custom-header, custom-logo, custom-menu, footer-widgets, theme-options, threaded-comments, translation-ready, blog

Invasion, by AshPaz, is a fast, clean blog theme for download and software sites, styled after the classic Invision Community forum look: a slate menu bar with a blue current tab, slate widget title bars, square corners and a two-tone site title with a spaced capital tagline. Posts appear as white cards with a coloured right and bottom edge and an animated Download button, in a list or a grid.

== Installation ==

1. Appearance > Themes > Add New > Upload Theme, choose the .zip and click Install Now.
2. Activate it.
3. Customize it under Appearance > Customize > Theme Options.

== Customizer options (Appearance > Customize > Theme Options) ==

* Styling (arranged in five groups):
  1. Layout: sidebar position (right or left) for the default view, and default view (with sidebar) or full view (no sidebar, full page width) separately for the homepage / archives / search, single posts and pages.
  2. Colour preset: 78 presets in groups (forums, social networks, video / music / streaming including Netflix and Spotify in light and dark, tech and shopping, code editor themes, light colour themes, dark themes) or Custom with three colour pickers. Dark presets switch the whole theme to a dark scheme. Edit or add presets in inc/presets.php.
  3. Primary menu: look (bar, pills, underline), menu bar colour and hover colour (19 colour swatches or a custom colour), and hover animation (slide up, underline, lift, fade, none).
  4. Links: colour and hover colour of post links and of widget links (the same swatches or a custom colour).
  5. Fonts: heading and body font (24 choices).
* Page layout box in the post and page editor: choose the layout of one post or page (theme setting, default view or full view). The posts and pages lists show a Layout column.
* Reset: puts every Theme Options setting back to its default (saved only when you click Publish).
* Homepage:
  - Static homepage (full size) content width, 600 to 1400 px (default 900).
  - Show the site title, Show the tagline, Show the primary menu: untick to hide them on the homepage only.
  - Latest posts view (list or grid, 2 or 3 columns), Download button, posts (article) width, widgets (sidebar) width, sticky sidebar, excerpt length, pagination.
* Single Post: breadcrumb, tags, related posts, author box.

== Notes ==

* Static homepage: set a page as the homepage in Settings > Reading. It is shown full size without sidebar or comments. The same layout is available for any page as the page template "Static Homepage (full size)".
* When the site title is hidden on a blog homepage it is still printed for screen readers and search engines (one hidden h1). Hidden tagline and menu are not printed at all.
* Hidden options apply to the homepage only. Every other page shows the title, tagline and menu.
* The comment form has Name, Email and the comment field only. Replies are joined to their parent by connection lines, one colour per level.
* The primary menu is a slate bar on desktop and a slide-in drawer on small screens.
* Widget areas: Sidebar, Header Ad (up to 550px wide), Footer 1-3. The footer shows widget columns only.
* Code and preformatted text blocks use the purple code box style (style.css, section 17).
* Page content that uses --mu-* CSS variables follows the Invasion colours through a small alias block at the top of style.css (delete it if unused).

== Performance ==

* Google Fonts load without blocking the first paint (preconnect + non-blocking stylesheet); only four weights are requested; system font options load nothing.
* No jQuery on the front end: theme.js is plain JavaScript, loaded deferred in the footer.
* The mobile menu animates with transform only; the Download button shine plays on hover only.
* Related posts use one cached ID query (6 hours) instead of ORDER BY RAND(); no extra image size is generated on upload.
* Card excerpts do not run the_content filters; Customizer values are read once per list instead of once per card.
* The emoji script, wp-embed script and unneeded head links are removed. The icon font is a single 4.7 KB file.

== Licence and credits ==

This theme is released under the GNU General Public License v2 or later and is derived from GPL-licensed theme code. As the licence requires, the copyright notices of that code are retained: Ribbon Lite, (C) MyThemeShop; Underscores, (C) 2012-2015 Automattic, Inc.; normalize.css, Nicolas Gallagher and Jonathan Neal (MIT).

* Icon font: a Font Awesome subset by Dave Gandy, http://fontawesome.io (SIL OFL 1.1).

== Changelog ==

= 1.2.0 =
* Fixed: colour presets now colour everything. Comment cards, form fields, reply lines, buttons and the footer no longer use fixed white or slate, so dark presets are readable; text on buttons, bars and the footer switches between light and dark automatically; links, muted text and body text were checked for contrast in every preset and adjusted where they were too faint.
* New: 78 colour presets in groups, including Netflix and Spotify in light and dark, more social, forum and tech looks, code editor themes (Dracula, Nord, Solarized, Tokyo Night, Gruvbox, Catppuccin and more), light colour themes and dark themes. The preset list shows a colour sample for each.
* New: Styling is arranged in five groups (Layout, Colour preset, Primary menu, Links, Fonts).
* New: default view or full view (no sidebar) separately for the homepage / archives, posts and pages, and a Page layout box in the editor for one post or page.
* New: rebuilt primary menu with three looks, a menu bar colour and a hover colour with colour swatches, and five hover animations. The drawer on small screens follows the same colours.
* New: post links and widget links colour and hover colour with colour swatches.
* Changed: the single Layout option of 1.1 is split into the options above; the old choice is carried over on the first page load after the update.

= 1.1.0 =
* New: colour presets (29 plus Custom) under Styling, with light and dark schemes.
* New: full view layout without sidebar; the sidebar is not loaded at all in that mode.
* New: Reset option (Theme Options > Reset) to restore every option to its default.
* Author: AshPaz.

= 1.0.0 =
* First release as Invasion, rebuilt from the previous theme with all old names, files and leftover code removed.
* New: static homepage (full size) with adjustable content width; options to hide the site title, tagline and primary menu on the homepage.
* New: purple code and preformatted text style.
* Performance pass (see Performance above). Single h1 per page. Invalid and unused code removed.
