Installation

Install the plugin in under 60 seconds using the WordPress admin or manual upload.

Installing the Free Plugin

Installing Pro (Add-on)

Requirements

Minimum and recommended software versions.

General Settings

Core settings found under WooCommerce → Settings → Wishlist & Registry.

Enable/Disable

Button Positions

Counter Widget

Wishlist Page

Cart & Purchase Behavior

Sharing Settings

Control how wishlists and registries can be shared.

Appearance Settings

Customize the look and feel of wishlist elements.

Colors

Style

Notification Settings

Email notifications sent to wishlist owners and users.

WooCommerce Email Classes

The plugin registers three email classes with WooCommerce (found under WooCommerce → Settings → Emails):

Advanced Settings

Shortcode reference and custom CSS.

Shortcodes Quick Reference

These shortcode references are shown in the admin settings for convenience:

Custom CSS

Pro: Claim Expiry

Wishlists

Everything about creating, managing, and using wishlists.

Overview

Users can create multiple wishlists and add any WooCommerce product (including variable products with specific variations). A default wishlist is automatically created for each user on first interaction.

Creating Wishlists

Wishlists can be created from:

• The wishlist dashboard page (via the [lfwlr_wishlist_registry_page] shortcode)
• The My Account → Wishlists endpoint
• The REST API (POST /lf-wlr-wc/v1/wishlists)

Wishlist Properties

Managing Items

Items are added via the heart button on product cards and single product pages. Each item stores:

• Product & Variation ID
• Quantity — Editable, especially useful for registries
• Priority — Sort order within the list
• Note — Optional personal note
• Quantity Fulfilled — Tracked by Pro purchase tracker

Guest Wishlists

When lfwlr_guest_enabled is set to yes, visitors without an account receive a guest token stored in a cookie. Guest wishlists are fully functional and can later be merged when the guest logs in or creates an account.

The guest token is passed to the REST API via the X-LFWLR-Guest-Token HTTP header.

Gift Registry

Create gift registries for weddings, baby showers, birthdays, and more.

Overview

A registry is a wishlist with an event_date. When the Enable Registry setting is active, users can create registries from the wishlist dashboard by adding an event date. Registries have their own default list separate from regular wishlists.

Registry-Specific Features

• Event date — Displayed on the shared registry page
• Quantity & fulfillment — Each item shows needed vs. fulfilled quantities
• Fulfillment progress — Visual progress bar on shared page (Pro)
• Claims — "I'll buy this" reservation system (Pro)
• Ship to recipient — Items ship to the registry owner (Pro)

Sharing Registries

Registries have their own URL format: /registry/{slug}/ (vs /wishlist/{slug}/ for regular wishlists). The shared registry page shows fulfillment progress and allows visitors to add items to their cart or claim items (Pro).

Sharing & Privacy

Control who can see and interact with wishlists.

Visibility Levels

Sharing Methods

• Copy Link — Generates a shareable URL
• Email — Built-in email form via REST API (POST /lf-wlr-wc/v1/share)
• Social — One-click sharing to Facebook, Twitter/X, Pinterest

Invite-Based Sharing

For shared visibility lists, owners can create share invitations via the REST API (POST /lf-wlr-wc/v1/wishlists/{id}/shares). Each invite generates a unique token and can have an access level:

• view — Can view items only
• purchase — Can view and add to cart

URL Structure

Counter Widgets

Display a live wishlist counter (heart badge) in your site header.

Navigation Menu Counter

The easiest way to add a counter is via the Wishlist Counter Menu Location setting. Select a registered nav menu location and the plugin injects a heart icon with a badge count automatically.

Gutenberg Blocks

Two blocks are available in the WordPress block editor:

• Wishlist Counter — Displays a heart icon with the total item count
• Registry Counter — Displays a gift icon with the total registry item count

Elementor Widgets

Two Elementor widgets are available under the "Logicfire" category:

• Wishlist Counter — Same as the Gutenberg block, with Elementor styling controls
• Registry Counter — Same as above, for registry items

Shortcodes

Embed wishlist components anywhere using shortcodes.

Wishlist Dashboard Page

[lfwlr_wishlist_registry_page]

Renders the full wishlist and registry management dashboard. Place this on a dedicated page and select that page in the plugin settings.

Attributes: None

Wishlist Button

[lfwlr_wishlist_button product_id="123" style="auto" position="topright"]

Place a wishlist heart button for a specific product anywhere on your site.

Wishlist Counter

[lfwlr_wishlist_counter icon="heart" show_label="no" label="Wishlist"]

Displays a wishlist counter widget with a badge showing the user's total wishlisted item count. Includes a dropdown preview of items and a link to the wishlist page. Ideal for headers, sidebars, or any widget area.

Registry Counter

[lfwlr_registry_counter icon="gift" show_label="no" label="Registry"]

Displays a registry counter widget with a badge showing the user's total registry item count. Only renders when the Registry feature is enabled. Includes a dropdown preview and a link to the registry page.

Gutenberg Blocks

Native WordPress block editor integration.

Three blocks are available in the block editor under the "Logicfire" category:

Wishlist Button Block

Renders a wishlist heart button for a product. Configure the product ID in the block's sidebar settings.

Wishlist Counter Block

Displays a heart icon with a badge showing the user's total wishlisted item count. Ideal for header templates.

Registry Counter Block

Same as the Wishlist Counter, but counts items from registries (wishlists with event dates).

Elementor Widgets

Drag-and-drop wishlist widgets for Elementor.

Three widgets are available in Elementor under the "Logicfire" category:

• Wishlist Button — Heart toggle for a specific product
• Wishlist Counter — Heart badge with total item count
• Registry Counter — Gift badge with registry item count

Each widget supports Elementor's style controls for colors, typography, and spacing.

Claims — "I'll Buy This"

Prevent duplicate gifts by letting visitors reserve registry items before purchasing.

How It Works

1. A visitor opens a shared registry page
2. They click "I'll buy this" on an available item
3. They enter their email, name, and desired quantity
4. The item is reserved — other visitors see the remaining claimable quantity
5. When the visitor purchases the item, the claim transitions to purchased
6. If the visitor doesn't complete the purchase within the expiry period, the claim expires automatically

Claim Statuses

Claim Expiry

Uncompleted claims expire after the configured number of hours (default: 48 hours). The cleanup runs hourly via Action Scheduler (preferred) or WP-Cron as fallback.

Configure via: WooCommerce → Settings → Wishlist & Registry → Claim Expiry (hours)

REST API

Developer Hooks

Ship to Registry Recipient

Registry items automatically ship to the registry owner's address instead of the purchaser's.

How It Works

1. A visitor adds a registry item to their cart from a shared registry page
2. At checkout, the cart is split into packages: one for registry items (shipping to the registry owner) and one for the customer's own items
3. A notice appears at checkout: "Registry items in your cart will ship to the registry recipient."
4. The purchaser sees "Registry recipient" as the package name — the owner's actual address is masked
5. In the admin order view, a prominent notice shows the registry recipient's address for fulfillment

Address Resolution

The registry owner's shipping address is resolved from WooCommerce customer meta (shipping address fields, falling back to billing address). The address is stored as order item meta (_wlrp_ships_to_registry) for admin reference.

Address Masking

Purchasers never see the registry owner's full address. The shipping package is labeled "Registry recipient" at checkout.

Analytics Dashboard

Insights into wishlist and registry activity.

Accessing Analytics

Navigate to WooCommerce → Logicfire Analytics in the WordPress admin. Requires the manage_woocommerce capability.

Available Statistics

Developer: Extend Analytics

add_filter( 'lfwlr_analytics_stats', function( $stats ) {
    // Add custom metrics
    $stats['my_custom_metric'] = calculate_something();
    return $stats;
});

Purchase Tracking

Track fulfillment of wishlist and registry items through the order lifecycle.

How It Works

The purchase tracker monitors WooCommerce order status changes and updates wishlist item fulfillment:

• Order completed/processing — Increments quantity_fulfilled for matching items, transitions claims from claimed → purchased
• Order cancelled/refunded — Reverts fulfilled quantities and transitions claims back to claimed
• Payment complete — Also triggers fulfillment if order status qualifies

Order Meta

The tracker stores data on order items and orders:

Developer Hooks

REST API

All endpoints use the namespace /wp-json/lf-wlr-wc/v1/. Authentication uses WordPress nonces or the X-LFWLR-Guest-Token header for guests.

Wishlists

Items

Utility

Sharing

Pro Endpoints

Authentication

Authenticated endpoints require either:

• A valid WordPress cookie + nonce (X-WP-Nonce header)
• A guest token via X-LFWLR-Guest-Token header
• When guest wishlists are enabled, anonymous requests are allowed (guest tokens created on demand)

Hooks & Filters

Extend and customize plugin behavior via WordPress actions and filters.

Lifecycle Actions

Wishlist Actions

Item Actions

Claim Actions (Pro)

Filters

Template Overrides

Override plugin templates from your theme.

How It Works

The plugin uses the lfwlr_locate_template() function to resolve template paths. It checks:

1. your-theme/logicfire-wishlist-registry-for-woocommerce/{template_name}
2. plugin/templates/{template_name} (default)

Example: Override Email Template

To customize the "item purchased" email template:

your-theme/logicfire-wishlist-registry-for-woocommerce/emails/item-purchased.php

Copy the original from the plugin's templates/emails/item-purchased.php and modify as needed. Template variables are passed via extract() and can be filtered with lfwlr_template_args_{template_name}.

Frequently Asked Questions

Changelog

Free Plugin

Pro Plugin