Single setting template
The setting page where the ring is completed — the gallery, the buy panel, the individual atoms, and the variation bus that keeps them in sync.
The single setting page is where a Ring Builder journey ends: the shopper has a diamond, picks a metal and a size here, and buys or books.
It is a WooCommerce product page, so unlike the diamond page it has a real post behind it — but NivoSync still treats it as a surface, so an assigned template replaces the theme's rendering.
Two ways to build it
With the Single Setting Panel. One composer covering the whole buy column: title, price, description, specs, the option pickers, the ring total, the buy button and the consultation button. Nine sections, ordered by a repeater.
With the atoms. Setting Title, Setting Price, Setting Specs, Setting Option, Ring Total, Setting Add to Cart, Setting Consultation, placed by you.
The panel is the faster, more coherent route. The atoms are for when you need your own content interleaved.
The gallery
Setting Gallery renders the product's images with four layouts matching the skins. Thumbnails above, to the left, or as a console bar; a stage with configurable aspect ratio, radius and zoom.
Two options specific to settings:
- Image fit — Contain keeps the whole ring visible, which is what studio shots on white want. Cover fills the stage and crops, which suits lifestyle on-hand photography.
- Follow the configurator metal — the gallery swaps its image when the shopper picks a metal.
The variation bus
This is the mechanism that makes the page feel like one thing.
When the shopper picks a metal, several parts of the page must agree: the gallery image, the setting's price, the ring total, and the add-to-cart button's amount. Rather than each widget polling, the option widgets broadcast the change and every interested widget updates.
Practically: the metal picker changes the picture and every price on the page at once, whether those are in the panel or scattered as separate atoms across your layout.
Option pickers
Setting Option renders one product attribute — metal, band style, ring size — as buttons, dots, swatches, a dropdown or a read-only row.
Two behaviours worth knowing:
- Only the attributes a product actually uses are rendered. A plain band never shows a pavé selector, because that product has no such attribute. You can drop the widget on the template unconditionally and trust it to stay quiet where it does not apply.
- A single-option attribute renders read-only rather than as a one-button choice.
Ring sizes are usually a long list, so the picker caps how many buttons show and puts the rest behind a More dropdown.
The buy button
Setting Add to Cart — and the panel's primary button, which is the same engine — is deliberately context-aware:
| Situation | What renders |
|---|---|
| Cart on, diamond chosen | Add to cart with the ring total: setting variation plus diamond. |
| Cart on, no diamond | An invitation to choose a diamond, linking to the diamond step. |
| Cart off in NivoSync | Nothing. The consultation button becomes the only action. |
See Dashboard gates for the full table.
Ring Total and Similar Settings
Ring Total shows the arithmetic on its own: the setting, the diamond, and the sum. Useful when your layout wants the breakdown separated from the button.
Similar Settings renders a strip of comparable settings using the addon's card for your chosen skin — automatically preferring settings that fit the diamond already chosen, or the same style when there is no diamond yet. On phones it becomes a swipe carousel.
Setting Configurator
For parity with the core, Setting Configurator embeds the core's complete configurator — gallery, pickers, price and buy button — rendered by the active NivoSync theme. Use it when you want the theme's version of the buy experience inside a page you designed around. It has no Style controls, because its look comes from the core.