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
| Software | Minimum | Tested up to |
|---|---|---|
| WordPress | 6.5 | 7.1 |
| WooCommerce | 9.0 | 11.2 |
| Elementor (free) | 3.24 | 4.3 |
| PHP | 7.4 | 8.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 / folder | What it is |
|---|---|
nocturne.zip | The theme – upload this in Appearance → Themes. Includes the Nocturne Core plugin inside it. |
nocturne-child.zip | Child theme for your customisations. |
nocturne-core.zip | Companion 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
- In WordPress go to Appearance → Themes → Add New → Upload Theme, choose
nocturne.zip, then Install Now and Activate. - 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.)
- Open Appearance → Nocturne License, enter your purchase key from My Account → License keys and activate this domain.
- Optional: upload and activate
nocturne-child.zipthe same way if you plan to change code.
upload_max_filesize, or upload the unzipped nocturne folder to /wp-content/themes/ by FTP.Demo import
- Go to Appearance → Demo Import and click Import demo. Keep the tab open (1–3 minutes).
- 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.
- Videos are copied from
wp-content/plugins/nocturne-core/demo/videos/orwp-content/uploads/nocturne-demo/videos/when present; otherwise they are downloaded from Pexels. To import offline, copy the four MP4 files fromdemo-content/videos/into either folder first. - 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
| Panel | Options |
|---|---|
| Colour Scheme | Noir (pure black), Graphite (soft charcoal), Ivory (light gallery). Inline link colour. |
| Header | Centered 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. |
| Footer | Statement, copyright with {year} and {site} placeholders, oversized wordmark (auto-scales to any brand length), payment/trust line. |
| Social Profiles | Instagram, Facebook, X, YouTube, Pinterest, TikTok, LinkedIn. |
| Shop | Products 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.
| Widget | Use it for |
|---|---|
| Nocturne Hero | Full-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 Heading | Caption + display title + text + link in centered, left or split layout. |
| Products | Latest, featured, sale, best-selling, top-rated, by category or hand-picked products as a grid or a scrolling row. |
| Collections | Product categories as photo tiles with counts. |
| Product Spotlight | One hero product with price, specs (from attributes or custom) and AJAX add to bag. |
| Spec Cells | Numbers with labels separated by hairlines. |
| Editorial Story | Image or video beside a story with a link. |
| Journal | Latest posts as cards. |
| Newsletter | Stores subscribers in WordPress (Tools → Nocturne Subscribers, CSV export) or posts to Mailchimp / Klaviyo / Brevo form URLs. |
| Marquee | Slow scrolling statement strip. |
| Contact Form | Name, 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
- 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.
- Or choose OpenAI-compatible and enter the base URL, key and model id.
- Write your brand voice and store knowledge (shipping, returns, sizing, engraving…). The concierge quotes only what you write there.
- Set a daily request cap to control cost, then click Test connection.
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: swapand 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 inlicensing/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.