Skip to content

leotiger/agnosis-theme

Repository files navigation

Agnosis Theme

A minimal gallery-focused FSE block theme, purpose-built for the Agnosis artist platform.

Artwork-first layout, a high-contrast black-and-white palette by default, subdomain-routing support, and Full Site Editing templates for the agnosis_artwork, agnosis_biography, and agnosis_event post types the Agnosis plugin registers.

This theme is a companion to the Agnosis plugin, not a standalone product — most of its templates render blocks the plugin provides (agnosis/gallery-overview, agnosis/artist-breadcrumb, agnosis/artwork-copyright, and others), and several template parts assume the plugin is active. It will activate and render without the plugin, but most of what makes it "the Agnosis theme" comes from that pairing.

Requirements

Minimum
WordPress 6.4
PHP 8.1
Agnosis plugin Recommended, not enforced — several templates render plugin-provided blocks and will show nothing useful in their place without it. Individual features note their own minimum plugin version in CHANGELOG.md (e.g. the artwork copyright line needs plugin 0.9.37+).

Style variations

The theme's own default (theme.json, no variation selected) is a dark palette — near-black background, light foreground. Four additional light-palette variations ship under styles/, switchable from Appearance → Editor → Styles without touching a template:

Variation Palette
antiqva Warm beige/stone
Guarani Green
Guava Pink and navy
Wax Plum and cream

Templates

FSE templates under templates/, backed by shared parts under parts/:

  • home.html — front page (gallery overview)
  • archive-agnosis_artwork.html, archive-agnosis_event.html, archive.html — archive listings
  • single-agnosis_artwork.html, single-agnosis_biography.html, single-agnosis_event.html, single.html — single-post views
  • page.html, page-join.html — generic pages, and the /join/ artist-application page specifically
  • search.html, 404.html, index.html — the usual fallbacks

parts/header.html / header-pages.html and parts/footer.html / footer-pages.html are two header/footer pairs — the -pages variant is a lighter header/footer used by the single-CPT templates, keeping full site navigation off artwork/biography/event detail pages.

Installation

  1. Install and activate the Agnosis plugin first — the theme's templates assume its custom post types and blocks exist.
  2. Upload the agnosis-theme folder to /wp-content/themes/.
  3. Activate via Appearance → Themes.
  4. Pick a style variation from Appearance → Editor → Styles, if you want something other than the default.

Development

There's no build step — this is a hand-authored theme with no bundled JS/CSS tooling, no npm/Composer dependencies, and no test suite. Edit style.css, theme.json, functions.php, or anything under templates//parts//patterns//styles/ directly.

  • theme.json — settings (palette, spacing, typography scale) and base styles. Font files live under assets/fonts/ and are declared as local fontFace sources here, not loaded from a CDN.
  • functions.php — theme support declarations (custom-logo, editor styles), style/script enqueue, and a couple of small render filters (documented inline — e.g. the footer copyright year swap).
  • patterns/ — PHP-registered block patterns (404 content, footer/header building blocks, comments).
  • A local wp-env/Docker setup isn't provided here; the Agnosis plugin's own dev environment expects this repo as a sibling checkout and activates both together for local testing.

See CONTRIBUTING.md for the full contributor workflow.

Release

Packaged from the sibling agnosis repo's dev/bin/build-theme-zip.sh (composer build-theme-zip, run from agnosis/dev/), which reads this repo's own .distignore to decide what ships in the ZIP.

License

GPL v2 or later — see LICENSE. Forked from Feature (Automattic, GPLv2), itself forked from Issue (Automattic, GPLv2) — see readme.txt's Copyright section for the full attribution chain, including bundled font licenses.

About

A minimal gallery-focused FSE block theme, purpose-built for the Agnosis artist platform.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors