=== Vitrena ===

Contributors: rcube
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: e-commerce, full-site-editing, block-patterns, block-styles, wide-blocks, custom-colors, custom-logo, custom-menu, featured-images, translation-ready, style-variations

Vitrena is a block theme for authorised dealers and premium electronics showrooms running WooCommerce.

== Description ==

Vitrena is built for a dealer that sells brands, not bargains: cordovan on paper, Archivo caps set
with wide tracking over a hairline rule, and savings shown in currency rather than percentages. The
storefront runs a campaign promo wall, a dense featured-product grid, department tiles, a dark
showcase band, an eighteen-brand wall, a curated watch showcase and four dealer promises.

Every section is a registered pattern, so the whole homepage can be rearranged in
Appearance → Editor without touching code. Colours, type scale, spacing and radii are theme.json
tokens, so a palette change carries through every pattern. Noir and Sand style variations switch the
whole storefront in one click.

WooCommerce is optional but expected: with the plugin active the theme supplies templates for the
shop, product categories and tags, the single product, product search, cart, checkout and order
confirmation, and the product rows read live stock, sale prices and ratings. Without it the theme
still works as a blog and pages theme, and the shop sections show a short empty state.

The theme creates no content, adds no admin page and makes no external request. Fonts are bundled,
so no CDN or Google Fonts call is made on the front end.

== Installation ==

1. In the admin, go to Appearance → Themes → Add New → Upload Theme, choose the zip and activate.
2. Optional but recommended: activate WooCommerce and run its setup wizard so the shop pages exist.
3. Appearance → Editor → Patterns to edit any homepage section.
4. Appearance → Editor → Navigation to build the store menu.
5. Appearance → Editor → Styles → Browse styles to switch between Default, Noir and Sand.

== Frequently Asked Questions ==

= Does the theme need WooCommerce? =

No, but the storefront sections are built for it. With WooCommerce active the product rows, category
tiles and shop templates fill themselves in from the store. Without it those sections show a short
notice and the bundled example imagery instead.

= Where are the products in the featured grid coming from? =

From the store. The row is a WooCommerce Product Collection block, so it follows real products,
prices, sale badges, ratings and stock status. While the catalogue is empty the pattern shows six
bundled photographs so a fresh install still looks designed; they disappear as soon as a product
exists.

= How do I change a homepage section? =

Appearance → Editor → Patterns. Each section is registered under its own category, so the promo
wall, product grid, tiles, showcase band, brand wall and dealer promises can be swapped, reordered
or removed by drag and drop. The front page template itself only inserts one pattern.

= Does the header menu need setting up? =

The header Navigation block has no hardcoded menu: it picks up the most recent navigation menu in
the site. Build one in Appearance → Editor → Navigation and the header follows it. Store links are
best stored as site-relative paths, such as /shop/, so they survive a domain change.

= Can I use my own product photography? =

That is the intention. The bundled photographs are placeholders for the patterns; replace them in
the Site Editor, or drop your own files over the ones in assets/images/ in a child theme.

= Are product filters included? =

The shop sidebar is a template part, left deliberately empty of filters. Insert the WooCommerce
"Product Filters" block into it from the Site Editor and it configures its own inner blocks.

== Changelog ==

= 1.0.1 =
* Keyboard focus styles for links, controls, and primary-background bars.
* Responsive layout for the utility top bar and header tools.
* Remove unused empty assets/js directory.

= 1.0.0 =
* Initial release.

== Copyright ==

Vitrena WordPress theme, Copyright 2026 Rcube
Vitrena is distributed under the terms of the GNU GPL version 2 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.

Vitrena bundles no third-party code, framework or library.

= Fonts =

Archivo, Copyright 2020 The Archivo Project Authors
License: SIL Open Font License 1.1, https://scripts.sil.org/OFL
Source: https://github.com/Omnibus-Type/Archivo

Inter, Copyright 2016 The Inter Project Authors
License: SIL Open Font License 1.1, https://scripts.sil.org/OFL
Source: https://github.com/rsms/inter

The full licence text of both families ships in assets/fonts/LICENSE.txt.

= Images =

All 33 bundled photographs are CC0 1.0 Universal (public domain dedication),
https://creativecommons.org/publicdomain/zero/1.0/ - free for commercial use, modification and
redistribution, with no attribution requirement. Credits are listed anyway. Each file was cropped to
the theme's aspect ratio and given one shared grade; no other change was made. None of them shows a
brand name, a logo or readable packaging text.

Sources: WordPress Photo Directory (https://wordpress.org/photos/), the Rawpixel public domain
library (https://www.rawpixel.com/) and StockSnap (https://stocksnap.io/), all CC0 1.0. The same list
ships with the theme in CREDITS.md.

Section imagery, assets/images/ (17 files):

* promo-laptop.jpg - "Free laptop flat lay image", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5908447/image-background-public-domain-technology
* promo-lead.jpg - "Several black power adapters and tangled cables on a light surface.", Nilo Velez, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/6566796126/
* promo-phone.jpg - "Free mobile phone image", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5912581/image-phone-public-domain-technology
* promo-wide-a.jpg - "A black smartwatch is resting inside a black cardboard box, which is...", Mehraz Morshed, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/871688f77f/
* promo-wide-b.jpg - "A bright blue portable speaker sits on top of a grey rock. The speake...", Faisal Ahammad, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/11769cfad4/
* showcase-a.jpg - "A close-up of a wrist wearing a black smartwatch with a green and bla...", Faisal Ahammad, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/10069cfaf8/
* showcase-b.jpg - "Untitled", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5934685/free-public-domain-cc0-photo
* showcase-c.jpg - "Watch Fitness", Direct Media, StockSnap, CC0 1.0
  https://stocksnap.io/photo/watch-fitness-XGFP0BFYZD
* showcase-dark.jpg - "Close-up view of an audio mixing console with various cables and conn...", Nilo Velez, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/5586660b70/
* tile-accessories.jpg - "Computer Office Keyboard", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5966993/computer-office-keyboard
* tile-audio.jpg - "Headphones Audio", Daria Nepriakhina, StockSnap, CC0 1.0
  https://stocksnap.io/photo/headphones-audio-16FDCF0DFC
* tile-charging.jpg - "Phone charging on wooden table", Markus Spiske, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/432904/mobile-charger
* tile-desk.jpg - "Monitor Mouse", Taduuda, StockSnap, CC0 1.0
  https://stocksnap.io/photo/monitor-mouse-RALDM02X8S
* tile-laptops.jpg - "Laptop Electronic", Brooke Cagle, StockSnap, CC0 1.0
  https://stocksnap.io/photo/laptop-electronic-ZXOBOKAJEQ
* tile-phones.jpg - "Free hand holding smart phone", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5923126/photo-image-background-phone-public-domain
* tile-power.jpg - "Free phone charger image", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5910187/photo-image-phone-public-domain-technology
* tile-watches.jpg - "A smartwatch with a green-colored strap.", binitagothe, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/56865be248/

Product imagery, assets/images/products/ (16 files):

* belvedere-pro-16.jpg - "Free workspace flat lay laptop", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5914717/photo-image-background-phone-public-domain
* halyard-field-chronograph.jpg - "Watch Time", Wil Stewart, StockSnap, CC0 1.0
  https://stocksnap.io/photo/watch-time-L9R4MMVFVJ
* halyard-reference-headphones.jpg - "Headphones Audio", Corey Blaz, StockSnap, CC0 1.0
  https://stocksnap.io/photo/headphones-audio-1Y69ONYCCZ
* jisura-travel-adapter-kit.jpg - "Portable smart plug", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/6018638/photo-image-public-domain-free
* kelvin-field-speaker.jpg - "Free mini bluetooth speaker image", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5919265/photo-image-white-background-phone-public-domain
* keyforge-compact-keyboard.jpg - "Black computer keyboard", ChrisEdwardsCE, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/9262fb0a63/
* lumenleaf-100w-gan.jpg - "Free phone charger image", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5923136/photo-image-phone-public-domain-white
* meridian-aria-13.jpg - "Free hand holding smart phone", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5916125/image-background-phone-public-domain
* meridian-eco-drive-watch.jpg - "Wood and Leather Watches", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5967643/wood-and-leather-watches
* mikona-precision-mouse.jpg - "Untitled", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/6066473/free-public-domain-cc0-photo
* northstar-mechanical-diver.jpg - "Close up view of a black watch placed in a black surface", PRABIN M, WordPress Photo Directory, CC0 1.0
  https://wordpress.org/photos/photo/2636a294ea/
* northstar-studio-14.jpg - "Workspace laptop wireless mouse", Markus Spiske, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/537539/free-photo-image-notebook-desk-laptop
* orbit360-action-camera.jpg - "black action camera white laptop", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/3303210/free-photo-image-video-camera-macbook-gopro
* pitera-20k-power-bank.jpg - "Free phone charging power bank", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5910321/image-background-phone-public-domain
* projexa-air-buds.jpg - "Headphones Earbuds", Piotr Lohunko, StockSnap, CC0 1.0
  https://stocksnap.io/photo/headphones-earbuds-DTPML21WLD
* skylark-edge-5g.jpg - "Untitled", public domain upload, Rawpixel, CC0 1.0
  https://www.rawpixel.com/image/5953187/free-public-domain-cc0-photo

The screenshot is a capture of the theme's own homepage and uses only the photography listed above.
