=== Specular ===
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 cinematic dark portfolio theme for motion designers and 3D artists: a full-screen showreel, iridescent glass and project pages that open with the film.

== Description ==

Specular frames your reel like a premiere: near-black screens, glass panels, iridescent highlights drawn from lilac, aqua and peach, Syne headlines and Sora text, and 16:9 everywhere. Five heroes (full-screen showreel, glass card over a drifting iridescent field, film strip with frame numbers, a 3D object spotlight with a specular sweep, and the latest featured film beside a split title), project cards with video badges and a moving light edge, featured videos first on every project, a frame-by-frame carousel, credits set as end titles and a full-bleed Next reel. Style variations: Studio Light, Chrome and Infrared, each with its own light and dark tones.

It is built on the Symelo portfolio foundation, so projects are a real content type with their own fields, and everything below works without a page builder:

* **Projects**: a Projects menu with disciplines and industries, client, year, role, duration, location, tools, a live link, a summary, galleries in four layouts, a before/after slider, the challenge / approach / outcome of the case study, results, credits, a client quote, a map and the next project. Values are edited with the free Secure Custom Fields plugin (the theme offers to install it) and keep showing without it.
* **The project index**: every project as a numbered row (title, client, disciplines, year) between hairlines. With a mouse, the row's cover image follows the pointer; on touch screens it shows as a thumbnail, and keyboard focus shows it too.
* **Filterable work**: discipline chips set as mono tags, search and sort; the grid updates without a reload, keeps the address shareable and works without JavaScript.
* **Case studies**: a giant title, a mono facts row, the summary as a lede, the cover or featured video edge to edge, a sticky facts column with the live link and "Start a similar project", numbered sections, results as huge numbers, the gallery, before/after, the quote, credits in columns, the map and a full-width link to the next project.
* **Your studio**: an availability badge ("Available for work from …") in the header, the hero and the footer; studio details, clients as a marquee, awards as an index table, services as a numbered list.
* **Forms**: a project inquiry form (it fills in the project a visitor came from), contact, collaboration request and newsletter forms. Messages are stored in the dashboard and emailed to you.
* **Video**: a background-video showreel hero (a bundled loop with a poster), featured videos for projects and posts, YouTube and Vimeo embeds that load only after a click.
* **Galleries**: Masonry and Carousel gallery styles and a lightbox with captions, swipe and keyboard support.
* **Motion**: clip and word reveals for big type, staggered grids, marquees for clients and disciplines; all of it off for visitors who prefer reduced motion.
* **Light and dark**: a switch in the header that remembers the visitor's choice, and five style variations: Paper (the default), Blueprint, Night, Kraft and Mono, each with its own night or day partner.

Templates: blog home, single post, page, archive, search (projects, posts and pages together), 404, the project page, the projects archive, discipline and industry archives, plus the custom templates Landing page, Wide and Case study. Template parts: header, header over a hero image, footer and a minimal footer.

More than fifty patterns: six heroes (the specular statement, the project index, the showreel, the latest project, a split portrait and a disciplines marquee), selected work, the project index, the filterable grid, spotlight, services, process, the studio in numbers, clients, awards, testimonials, questions, galleries, video sections, forms, journal lists, calls to action, social links and full pages for Home, Work, Studio, Contact and a Landing page.

The demo content (Appearance → Import demo) installs a complete creative studio with nine projects, disciplines, industries, clients, awards and the Home, Work, Studio and Contact pages.

== Frequently Asked Questions ==

= Where do I add projects and studio details? =

Projects have their own menu (Projects → Add Project); the project details are below the editor. Your availability, email, phone, address, clients and awards are under Projects → Studio details. Both need the free Secure Custom Fields plugin, which the theme offers to install in one click. Without it, everything already entered keeps showing.

= Where do form submissions go? =

Every inquiry, message, collaboration request and newsletter signup is saved under **Messages** in the dashboard and emailed to the site's administration email address. To send them somewhere else, open Messages → Settings and enter one or more recipients, or select a form block and set its own recipients in the block settings. Make sure your site can send email (most hosts need an SMTP plugin or service for reliable delivery).

= How does the hover preview of the project index work? =

On a computer with a mouse, the cover image of the row under the pointer follows it. It uses the project's featured image ("Cover image"). On phones and tablets the image shows as a small thumbnail at the start of each row, and keyboard users see it beside the focused row.

= How do I add a featured video to a project or a post? =

In the editor, open the document settings and find the **Featured video** panel. Paste a YouTube or Vimeo link, or choose a video file from the media library. The project page shows it edge to edge in place of the cover image.

= Can I turn the animations off? =

They switch off automatically for visitors who ask their device for reduced motion. To remove an animation from a block, select it and clear the effect in the **Motion** panel (or remove the `sk-…` class under Advanced → Additional CSS classes).

= How does dark mode work? =

The moon / sun button in the header switches between a light and a dark palette and remembers the choice in the visitor's browser. Every style variation has its own partner: Paper and Night swap with each other, Blueprint has a cobalt night, Kraft a dark brown and Mono a pure black version. Pick the variation in Appearance → Editor → Styles.

= Why does the page title sometimes not appear? =

The page template leaves out the title when the page opens with its own hero (a heading, a cover or one of the hero and full-page patterns), so it never appears twice. Use the Landing page template to leave it out everywhere.

== Changelog ==

= 1.0.0 =
* First release.

== Copyright ==

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

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.

== Resources ==

Symelo Theme Kit (inc/kit) and Symelo portfolio foundation (inc/foundation)
License: GPLv2 or later, https://www.gnu.org/licenses/gpl-2.0.html
Copyright: (C) 2026 Symelo LTD

Syne (assets/fonts/syne)
License: SIL Open Font License 1.1, https://openfontlicense.org (assets/fonts/syne/OFL.txt)
Copyright: 2019 The Syne Project Authors (https://gitlab.com/bonjour-monde/fonderie/syne-typeface)
Source: https://github.com/bonjourmonde/Syne

Sora (assets/fonts/sora)
License: SIL Open Font License 1.1, https://openfontlicense.org (assets/fonts/sora/OFL.txt)
Copyright: 2019 The Sora Project Authors (https://github.com/sora-xor/sora-font)
Source: https://github.com/sora-xor/sora-font

Images from the 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/bubbles.webp: abstract-8 (iridescent bubbles)
* assets/images/prism.webp: abstract-10 (glass prism casting a rainbow)
* assets/images/fiber.webp: technology-3 (glowing optical fibres)
* inc/foundation/demo/images (the portfolio foundation's demo images, used in the patterns and the demo content): paper-waves (abstract-1), glass-forms (abstract-2), ink-cloud (abstract-5), copper-ribbon (abstract-6), terracotta-housing (architecture-2), atrium (architecture-12), terracotta-bath and terracotta-bath-before (interiors-7), headphones (technology-8), studio-table (workspace-4)

Video (assets/video/specular-reel.mp4, assets/video/specular-reel-poster.webp)
Made for Specular from three images of the Symelo placeholder library (abstract-8, abstract-10, abstract-2), (C) 2026 Symelo LTD, distributed with the theme under the GPLv2 or later.

The video embeds in the "Video embeds" pattern point to films of the Blender Studio on YouTube (Spring, Tears of Steel, Sintel; Creative Commons Attribution); nothing is loaded from YouTube until a visitor clicks play.
