Skip to content
AI Market Vault

Nocturne Documentation

Intelligent luxury WooCommerce theme for Elementor · Version 1.1.1

Nocturne user guide

Thank you for choosing Nocturne. This guide covers installation, customisation, AI tools and your licensed updates. Back up your site before installing or importing demo content.

Requirements

SoftwareMinimumTested up to
WordPress6.57.1
WooCommerce9.011.2
Elementor (free)3.244.3
PHP7.48.3

Recommended server settings: memory_limit 256M, upload_max_filesize 32M, max_execution_time 120. The Appearance → Nocturne Setup screen shows your current values.

Package contents

File / folderWhat it is
nocturne.zipThe theme – upload this in Appearance → Themes. Includes the Nocturne Core plugin inside it.
nocturne-child.zipChild theme for your customisations.
nocturne-core.zipCompanion plugin (widgets, AI, demo importer). Also installed automatically from the theme.
demo-content/Demo videos (MP4), a WooCommerce product CSV and the raw demo images.
screenshots/Full-page desktop, tablet and mobile screenshots of every template.
documentation/This guide.
licensing/Font licence and media credits.

Your package & licence

Single domain — $79 USD

One domain activation, one package download per purchase, 3 months of included support and lifetime updates.

Three domains — $149 USD

Up to three domain activations, three package downloads per purchase, 12 months of included support and lifetime updates.

Both plans are one-time purchases. Support starts from purchase. Support expiry does not end lifetime updates. Package download counts and domain activations are separate: downloading a ZIP does not activate a domain.

Activate each licensed website from Appearance → Nocturne License. Subdomains count as separate domains; the www and non-www versions of the same hostname share one slot. Each domain is permanently registered on first activation. Deactivation does not free a slot or allow transfer to a different domain. You may reactivate only the same registered domain. The $79 plan binds one domain; the $149 plan binds up to three distinct domains permanently.

If your package download allowance is exhausted or you cannot access your key, open the support portal. Do not buy another licence just to resolve an account-access problem.

Installation

  1. In WordPress go to Appearance → Themes → Add New → Upload Theme, choose nocturne.zip, then Install Now and Activate.
  2. You land on Appearance → Nocturne Setup. Click Install & activate all. Elementor and WooCommerce download from WordPress.org, then Nocturne Core installs from inside the theme – about a minute in total. (You can also use the individual Install / Activate buttons; Nocturne Core always sets up Elementor and WooCommerce first because it needs them.)
  3. Open Appearance → Nocturne License, enter your purchase key from My Account → License keys and activate this domain.
  4. Optional: upload and activate nocturne-child.zip the same way if you plan to change code.
Upload fails with “The link you followed has expired”? Your host’s upload limit is lower than the zip. Ask your host to raise upload_max_filesize, or upload the unzipped nocturne folder to /wp-content/themes/ by FTP.

Demo import

  1. Go to Appearance → Demo Import and click Import demo. Keep the tab open (1–3 minutes).
  2. The importer adds 25 products (simple + variable with sizes, sale prices, galleries, attributes and reviews – including The Gift Edit Set with its designed packshot), the Gift Edit and collection banners, 6 collections, 6 journal stories, the Home, Maison, Contact, Journal, Client Care and Terms pages, 7 menus, Customizer settings, WooCommerce settings (USD, free worldwide shipping, bank transfer and cash on delivery) and the Elementor global colours and fonts.
  3. Videos are copied from wp-content/plugins/nocturne-core/demo/videos/ or wp-content/uploads/nocturne-demo/videos/ when present; otherwise they are downloaded from Pexels. To import offline, copy the four MP4 files from demo-content/videos/ into either folder first.
  4. Re-running the import never duplicates content – it only adds what is missing. Remove demo content deletes everything the importer created and nothing else.

Prefer WooCommerce’s own importer? Use Products → Import with demo-content/nocturne-products.csv. Images are fetched from Pexels by URL.

Theme options

Appearance → Customize → Nocturne Theme Options

PanelOptions
Colour SchemeNoir (pure black), Graphite (soft charcoal), Ivory (light gallery). Inline link colour.
HeaderCentered wordmark (MENU · logo · STORE) or Inline (logo · menu · icons); transparent header over the homepage hero; search and account toggles; announcement bar text + link; note shown in the fullscreen menu.
FooterStatement, copyright with {year} and {site} placeholders, oversized wordmark (auto-scales to any brand length), payment/trust line.
Social ProfilesInstagram, Facebook, X, YouTube, Pinterest, TikTok, LinkedIn.
ShopProducts per row (2–4) and per page, filter sidebar (left/right/hidden), category navigation, hover image swap, open cart drawer on add, product page assurances.

Upload your logo in Site Identity. Without a logo the site title is shown as a letter-spaced wordmark.

Elementor widgets

Find them in the Elementor panel under the Nocturne category. All widgets are responsive and include style controls.

WidgetUse it for
Nocturne HeroFull-bleed image or MP4 video band, caption, display title, up to two buttons, scroll cue, floating callout card. Videos lazy-load and pause off-screen.
Section HeadingCaption + display title + text + link in centered, left or split layout.
ProductsLatest, featured, sale, best-selling, top-rated, by category or hand-picked products as a grid or a scrolling row.
CollectionsProduct categories as photo tiles with counts.
Product SpotlightOne hero product with price, specs (from attributes or custom) and AJAX add to bag.
Spec CellsNumbers with labels separated by hairlines.
Editorial StoryImage or video beside a story with a link.
JournalLatest posts as cards.
NewsletterStores subscribers in WordPress (Tools → Nocturne Subscribers, CSV export) or posts to Mailchimp / Klaviyo / Brevo form URLs.
MarqueeSlow scrolling statement strip.
Contact FormName, email, topic and message with consent, honeypot and rate limiting; sends via wp_mail().

Elementor Pro users can replace the header, footer, single and archive templates in Theme Builder. Every core location is registered.

Nocturne AI

Settings → Nocturne AI

What it does

  • Shopping concierge – a discreet chat (bottom right, full-screen on phones) that understands requests like “a gift for him under $500” and replies with product cards you can add to the bag directly. It only recommends products that exist in your catalogue.
  • Natural-language search – “Or describe it to the concierge” in the search panel hands the query to the concierge.
  • Product copywriter – in the product editor (Nocturne AI Studio box): write the long description, short description, SEO title and meta description in your brand voice.
  • Review summaries – a “What clients say” summary with highlight tags on product pages, refreshed automatically when a review is approved.

Connecting a provider

  1. Choose Anthropic Claude (recommended) and paste an API key from console.anthropic.com. Select a model available to your provider account. Provider usage charges are separate.
  2. Or choose OpenAI-compatible and enter the base URL, key and model id.
  3. Write your brand voice and store knowledge (shipping, returns, sizing, engraving…). The concierge quotes only what you write there.
  4. Set a daily request cap to control cost, then click Test connection.
No key? The concierge still works in catalogue-search mode: it matches words and budgets (“under 500”, “between 1k and 3k”) against your products. The key is stored server-side only and is never sent to visitors’ browsers.

Developer hooks

add_filter( 'nocturne_ai_concierge_enabled', '__return_false' );   // hide on some pages
add_filter( 'nocturne_ai_starters', fn() => [ 'Gifts for her', 'New arrivals' ] );

WooCommerce

  • The theme styles the block-based Cart and Checkout (WooCommerce default) as well as the classic shortcodes.
  • The cart drawer opens from the bag icon and after AJAX add to cart; counts update live.
  • Product image sizes: the importer sets a 4:5 crop for catalogue images. Change it in Customize → WooCommerce → Product Images.
  • The theme uses hooks only – no WooCommerce template overrides – so WooCommerce updates never show “outdated template” warnings.
  • Payments: install any gateway (Stripe, PayPal, WooPayments…). The demo enables bank transfer and cash on delivery so checkout works immediately.

Page settings

Every page and post has a Nocturne Layout box: header Default / Transparent over first section / Solid and Hide page title. For Elementor pages choose the Elementor Full Width template (the demo does this) or Nocturne – Full Width.

Translation & RTL

All strings use the nocturne and nocturne-core text domains. Translate with Loco Translate or Poedit using languages/nocturne.pot and nocturne-core/languages/nocturne-core.pot. Right-to-left languages load assets/css/rtl.css automatically. WPML and Polylang compatible.

Child theme

Install nocturne-child.zip and add CSS to its style.css or PHP to its functions.php. Design tokens are CSS variables, e.g.

:root { --nc-link: #d8c3a5; --nc-container: 1360px; }

Performance

  • Fonts are self-hosted WOFF2 with font-display: swap and preloading – no Google requests (GDPR friendly).
  • No jQuery dependency in theme scripts; all scripts are deferred.
  • Background videos load only when scrolled into view, pause off-screen, and are skipped for reduced-motion and data-saver users.
  • Widget styles load only on pages that use Nocturne widgets.

FAQ & troubleshooting

The homepage shows my latest posts

Settings → Reading → “A static page” → Homepage: Home, Posts page: Journal. The importer sets this for you.

Elementor pages look unstyled after a migration

Elementor → Tools → Regenerate CSS & Data, then clear any caching plugin.

Videos do not import

Your server may block outgoing downloads. Copy the MP4 files from demo-content/videos/ to wp-content/uploads/nocturne-demo/videos/ and run the import again.

The concierge does not appear

Check Settings → Nocturne AI → “Show the concierge on the storefront”. It is hidden on the checkout page on purpose.

Credits & licences

  • Theme and plugin code: GPL v2 or later.
  • Fonts: Saira Condensed, Cormorant Garamond, JetBrains Mono – SIL Open Font License 1.1.
  • Demo photography and video: Pexels, used under the Pexels License. Each image’s source page is stored on the attachment (_nocturne_source) and listed in licensing/media-credits.txt. Demo media is for preview purposes; replace it with your own product photography.
  • Demo text is lorem ipsum. Product, brand and place names are fictional.

Changelog

1.1.1 — Permanent domain bindings; deactivation does not permit domain transfer.

1.1.0 — Domain activation, licensed theme and Core updates, and support entitlements.

1.0.0 — Initial release.

Customer support · My Account