LanternWP Companion is the plugin of LanternWP, a block theme for WooCommerce (
https://wordpress.org/themes/lanternwp/). With it, your store gets:
- A complete store to start from: one of six LanternWP demo stores, with its products, photos, pages, menus and look, imported while your store keeps its own settings.
- 16 store features as blocks that extend WooCommerce's own: on product cards, on the product page, in the cart and around the store.
- One screen for all of them, Appearance → LanternWP → Features, with each feature's switch, whether it works and where it is set.
Every feature and every public demo is free. There is no paid version and no license key.
Companion is made for the LanternWP theme, or a child theme of it, and tested with it; the demo import needs it. The theme works without Companion as a complete store; Companion adds what belongs in a plugin rather than a theme. It needs WooCommerce 11.1 or later: install and activate WooCommerce first, since WordPress does not activate Companion without it.
Demo stores
Each demo is a complete WooCommerce store: products with photos, categories, pages, menus, a journal, a customer with orders, and the store's look.
- Common Goods: everyday goods in natural materials, made in short runs. Its look is the theme's own.
- Voltline: electronics for the desk and the road, on a dark storefront.
- Kilowatt: electronics and appliances, with departments, deals and store pickup.
- Halden: skincare, one good cream and a short routine around it.
- Tessel: basics for women and men, in the weights and fits you wear every day.
- Transom: furniture made to fit the room you have, with fabrics, finishes and sizes to choose.
Import one in Appearance → LanternWP → Demos:
- Your store keeps its own settings (name, currency, address, units, taxes, payments, shipping); when the import is done it lists what is still to set up, with links.
- The progress shows stage by stage, in short steps, so a host with tight limits can import too.
- Undo last import puts back the homepage, header, footer, menus, Styles and features the last import changed; the demo's products and pages stay. Update to version N brings a newer version of the demo.
- The demo's look goes into Styles, so it stays without the plugin; Use the look only takes the look without the content.
- The demos' photographs are released under CC0 1.0: keep them, change them or use them elsewhere.
- The same import from WP-CLI:
wp lanternwp demo import base.
On product cards
- Product badges: Bestseller and New badges, set on the product or by rules.
- Product swatches: a product's colors as swatches on its card.
- Second photo on hover: a product's second photo on its card while the pointer rests on it.
- Quick view: a product's photos, options and Add to cart over the catalog.
On the product page
- Size & option guides: a link beside a product option, such as Size, that opens its guide.
- How it fits: the cut and the model's height and size, under a product's sizes.
- Fit in reviews: the review form asks how it fits, and the product page shows what reviewers say.
- Back-in-stock emails: shoppers ask to hear when a sold-out product or option is back.
- Lowest price before a discount: the lowest price of the 30 days before a sale, as the EU's Omnibus Directive requires.
- Dimensions: a product's size in an in/cm table with its drawing.
- Samples: fabric or finish samples of an attribute's values, ordered from the product page.
- Shipping times: how long a product takes to ship, from its shipping class.
In the cart and around the store
- Product sets: products that go together, with a shoppable photo, added to the cart together.
- Free shipping progress: how far the cart is from free shipping.
- Contact form: messages kept under WooCommerce → Messages and emailed to the store.
- Bot protection: Cloudflare Turnstile on sign-in, registration and forms.
With the LanternWP theme, the plugin also keeps Store pages (Settings → Reading), Store phone (WooCommerce → Settings → General) and a post's Shop the story products. WooCommerce's sale badge reads the discount (−20%) instead of Sale.
Each feature has its page in the LanternWP handbook, with every setting and where it is:
https://lanternwp.com/docs/
1.0.1
A demo import keeps your store's settings, and a site connected to
lanternwp.com imports the demos made for its store.
- New: Your demos in Demos: Connect to lanternwp.com connects the site to your lanternwp.com account, once the demos are allowed, to list and import the demos made for your store; Disconnect ends the connection, and what you imported stays. The same from WP-CLI:
wp lanternwp account connect, status and disconnect.
- New: When an import is done, Still to set up lists what your store still needs for the demo to work as shown, such as a payment method, a shipping zone for your store's country or a feature's setup, each with a link to where it is set.
- Improved: A demo import keeps your store's settings: its name and tagline, currency and price format, country and address, store phone, units, time zone and date format, the sender of store emails, taxes, checkout account options, payment methods, local pickup and shipping. The import dialog no longer asks which store settings to change.
- Improved: The demo's logo and site icon are used only where your store has none of its own, each on its own, and the demo's product weights and dimensions are converted into your store's units.
- Improved: Undo of an import made with Companion 1.0.0 still puts back the store's name, settings and shipping zones that import changed, and the dialog says so.
- Improved: Activated on its own from Plugins in a store without a demo, Companion opens Appearance → LanternWP → Demos once.
- Improved: The Privacy policy and Terms of use links on Demos open in a new tab, so the screen where you allow the demos stays open.
- Fixed: A size filter's range shows exactly the products its count promises, also for sizes with three decimal places, such as in a store that measures in meters.
- Fixed: A back-in-stock form for a sold-out choice is in place as the product page loads, and Notify me can be pressed once the page is ready.
- Developers: The
--keep-settings option of wp lanternwp demo import is deprecated: the command still accepts it, prints a warning and ignores it, since the import keeps every store setting. A later version may remove it.
1.0.0
The first version in the
WordPress.org plugin directory: demos load from
lanternwp.com only once you allow it.
- New: Demos asks before anything is loaded from lanternwp.com: it says what the requests carry, Show the demos from lanternwp.com allows them, and Stop loading from lanternwp.com withdraws that.
- New: Plugins, Features and Demos say when WooCommerce is older than the 11.1 Companion needs, with a link to update it.
- Improved: Compatible with WooCommerce's High-Performance Order Storage, and declared so.
- Improved: Works on servers without PHP's mbstring extension.
- Improved: A demo import leaves WooCommerce's own product sync in place and syncs the demo's products once more when it finishes.
- Fixed: Without WooCommerce, the blocks that need it are not registered, so the editor shows no warnings about them and no failed block preview.
- Fixed: Page scrolling is locked only under Companion's own dialogs, not under another plugin's.
- Fixed: Features and a post's Shop the story panel no longer log warnings in the browser console.
- Improved: Product sets, size and option guides, samples and back-in-stock requests show and accept only the products the signed-in account may see: another author's private or draft product stays hidden, in the admin and in the editor.
- Improved: A product added to a post's Shop the story must be one that the account saving the post may see.
- Improved: Deleting the plugin also removes the features' settings, the state of a demo import with its working folder and, while WooCommerce is active, its waiting jobs. Caches kept per product expire within a day, and the store's content stays.
- Improved: An attribute's edit screen opened from an old address says that LanternWP's fields are not on it, with a link that opens it again.
- Improved: Bot protection loads Cloudflare's script again for a form after it failed to load, so one failed load does not stop the page's other forms.
- Improved: How reviewers say a product fits is counted from its latest 500 answers and kept with the product, instead of counted on every page.
- Improved: Lowest price before a discount loads its stylesheet only on pages that show the line.
- Fixed: A back-in-stock confirmation link shows nothing of a product taken out of the store since the request.
- Fixed: Saving an attribute keeps its samples product when the field's list no longer holds that product.
- Fixed: A demo import that cannot add a changed image leaves the store the image it had.
- Fixed: Appearance → LanternWP → Features opens while WooCommerce is inactive.
- Fixed: The set editor, the list of sets and a product's Sets tab have their own styles back, and show prices without the text meant for screen readers.
- Fixed: Quick view keeps its product summary's spacing in every look.
0.7.1
- Fixed: A demo import that lost its turn to a newer one stops, instead of overwriting the newer import.
- Fixed: Starting a demo you are not allowed to import no longer removes the files of that demo's unfinished import.
0.7.0
A Product Set Hero block, and clearer feature details in Features.
- New: Product Set Hero block: one product set with its photo in a page's hero; Product Sets shows several sets.
- Improved: An import gives the store its product photo shape, so a demo's packshots are not cropped twice.
- Improved: Translations come from translate.wordpress.org; the plugin ships no translation files of its own.
- Improved: After activation no screen opens by itself; a notice you can dismiss points to Demos until the store has a demo.
- Improved: The contact form's button turns on once its script is ready, so a message cannot be lost to a script that failed.
- Improved: The back-in-stock confirmation page is a template of its own, Back-in-Stock Confirmation in the Site Editor, between your header and footer with their blocks intact.
- Improved: A contact message about an order adds a note that says it came and links to it, and no longer copies the message into the order, so deleting the message deletes all of it.
- Improved: The Contact message received email starts with Hello, and does not repeat the name the sender typed.
- Improved: The import dialog says that a demo adds author and customer accounts.
- Improved: Bot protection checks the saved site key with Cloudflare when you open its details in Appearance → LanternWP → Features: a key Cloudflare refuses shows an error under its field, the feature says Needs setup, and forms are not checked until the key works, so a mistyped key does not lock shoppers out. The message names the missing key, and Forms it checks says which of them the store does not show.
- Improved: Product swatches says for each attribute what is missing (no color, a single color, terms without a color), names WooCommerce's Color swatches for attributes setting only while no attribute has the Color / image type, with a link straight to it, and Products → Attributes says why an attribute has no Type field.
- Improved: Free shipping progress shows its amount in Features (Free shipping over $50, or the lowest and highest across shipping zones) with a link to Shipping zones, says when every order ships free, and says Needs setup when zones have different amounts and the customer's default location is empty; the shipping zone screens link back to Features.
- Improved: Contact form has details in Features: the contact page, the block's heading and topics, Messages with the number of new ones, both emails, how long messages are kept and bot protection. The Contact Form block's Heading is beside its Topics, Send a message by default, and the emails' preview and test email show a sample message.
- Improved: WooCommerce → Messages lists the date received and an Order column with the number the shopper typed, and a message is New until someone opens it, with a count beside Messages in the menu.
- Improved: Products → Back-in-stock requests filters by product, with the number of requests for each product or option, says Not confirmed yet instead of Pending, and links to the feature's details and to both emails, which link back to the list.
- Fixed: A contact form sent empty right after the page loads says which fields it needs, instead of being refused as too fast.