Documentation · v1.0.0 Introduction Requirements Installation Front page setup Hero slider Menus Widgets Testimonials Customizer options Dark & light mode Child theme Shop & cart Filters & attributes Product page Translation Credits & support

01Introduction

Aurum is built so that everything visitors see is editable from the WordPress dashboard — the header, footer, hero slider, marquee, editorial block, stat counters, testimonials and newsletter are all dynamic, with elegant demo fallbacks so the site looks complete from the moment it is activated.

02Requirements

• WordPress 6.2+
• PHP 7.4+ (8.0+ recommended)
• WooCommerce (latest) — required for the shop, cart and product pages. Aurum also runs beautifully as a blog/marketing theme without it.

03Installation

1. In your dashboard go to Appearance → Themes → Add New → Upload Theme.
2. Upload aurum.zip, click Install Now, then Activate.
3. Install & activate WooCommerce from Plugins → Add New to unlock shop features.
4. Open Appearance → Customize to set your logo, colours and options.

04Front page setup

To display the long Aurum home page (hero, categories, featured, editorial, bestsellers, stats, testimonials, newsletter):

1. Create a new empty Page (e.g. “Home”) and, optionally, a Page named “Journal” for your blog.
2. Go to Settings → Reading.
3. Set Your homepage displays to A static page.
4. Choose “Home” as the Homepage and “Journal” as the Posts page.

Each home section can be switched on or off and edited under Customize → Aurum Options → Front Page Sections.

05Hero slider

The hero is powered by a dedicated Slides post type that appears in your dashboard sidebar after activation.

1. Go to Slides → Add New.
2. Set the Featured Image — this becomes the slide background.
3. Fill in the Slide Content box: eyebrow, title (before / highlighted / after), text and two buttons.
4. Control the order with the Order field under Page Attributes (lower = earlier).

06Menus

Create menus under Appearance → Menus and assign them to these locations:

Location	Used for
Primary	The main header navigation (desktop).
Mobile	The slide-out mobile drawer menu.
Footer	Optional links in the footer area (try to use the Footer Widget instead of the Footer Menu.).

If no menu is assigned, Aurum shows a sensible fallback that links to your shop and pages.

07Widgets

Manage widgets under Appearance → Widgets. Available areas:

• Blog Sidebar — shown alongside blog/archive pages where applicable.
• Footer Column 1–3 — three footer widget columns.

08Testimonials

Add customer quotes via the Testimonials post type:

1. Go to Testimonials → Add New.
2. Use the title for the customer’s name and the content for the quote.
3. Set the Role (e.g. “Verified buyer”) in the meta box.

The home testimonials section shows up to three; a demo set appears until you add your own.

09Customizer options

All options live under Appearance → Customize → Aurum Options:

Panel	What you can change
Colors	Accent and bright-accent colours used site-wide.
General & Performance	Default mode, sticky header, PJAX, open-cart-on-add.
Topbar	Announcement bar text and visibility.
Hero	Slider auto-play interval.
Front Page Sections	Toggle each home section on/off.
Marquee	Repeater of scrolling strip items.
Editorial	Eyebrow, title, text, button and three spec stats.
Stats Counters	Repeater of animated number / suffix / label rows.
Newsletter	Copy and an optional form action URL (e.g. Mailchimp).
Footer	About text, copyright and payment labels.

10Dark & light mode

Aurum ships with both a deep “obsidian” dark theme and a refined light theme.

• Visitors toggle modes with the sun/moon button in the header; their choice is remembered.
• Set the default mode under Customize → Aurum Options → General & Performance.

11Child theme

For safe code customizations that survive updates, use the bundled aurum-child theme.

1. Upload aurum-child.zip via Appearance → Themes → Add New → Upload Theme.
2. Activate Aurum Child.
3. Add CSS to the child’s style.css and PHP to its functions.php.

Example — change the product page “Shipping” tab text from the child theme:

add_filter( 'aurum_shipping_tab_content', function ( $text ) {
    return 'Free next-day delivery on all orders.';
} );

12Shop & cart

With WooCommerce active, the shop, cart, checkout and account pages work out of the box.

• The shop archive filters, sorts, searches and paginates entirely over AJAX — no page reloads.
• Add to cart is AJAX-powered with a slide-out cart drawer and a live header count.
• Site-wide PJAX navigation is enabled, but Cart, Checkout and My Account are intentionally excluded for payment reliability.

13Filters & attributes

The shop sidebar builds its filters from your real store data:

Filter	Source
Category	WooCommerce product categories (product_cat).
Brand	A product_brand taxonomy if present, otherwise a pa_brand attribute.
Colour	A pa_color product attribute (swatch colour auto-detected from the term name).
Price	Auto-ranged from your lowest and highest product prices.
Availability	In-stock and on-sale toggles.
Rating	Average review rating.

To enable brand/colour filters, create those attributes under Products → Attributes, add terms, and assign them to products.

14Product page

The single-product page features a custom gallery, fully functional native add-to-cart (including variable products and quantity steppers), an assurance row, product meta, and tabs for Description, Specifications, Reviews and Shipping, followed by related products.

• Gallery: uses the product image plus gallery images; click a thumbnail to swap the main image.
• Specifications: pulls from your product attributes / additional information.
• Reviews: standard WooCommerce reviews with rating and form.

15Translation

Aurum is fully translation-ready with the text domain aurum. A template file is included at languages/aurum.pot.

1. Open aurum.pot in a tool like Poedit.
2. Translate the strings and save a .po / .mo pair (e.g. fr_FR.mo).
3. Place the files in the theme’s languages folder.

16Credits & support

Built on WordPress & WooCommerce. Iconography is a custom inline SVG sprite included with the theme.

Aurum WordPress Theme — © 2026. Distributed under the GNU GPL v2 or later. Thank you for your purchase.