# Admin Settings

This is a complete reference for all Bizzwishlist admin settings. Access the settings page by navigating to **Bizzwishlist > Settings** in your WordPress admin dashboard.

> **Screenshot placeholder:** *Bizzwishlist settings page in the WordPress admin.*

## General Settings

### Wishlist Page

**Setting:** Select the page that contains the `[bizzwishlist]` shortcode.

| Option | Description |
|--------|-------------|
| Dropdown of pages | Select the page to use as the wishlist page |

A wishlist page is created automatically on activation. If you want to use a different page, create a new page with the `[bizzwishlist]` shortcode and select it here.

> **Screenshot placeholder:** *Wishlist Page dropdown showing available pages.*

---

### Wishlist Button Position

**Setting:** Choose where the "Add to Wishlist" button appears on product pages.

| Option | Description |
|--------|-------------|
| **After Add to Cart** | Below the WooCommerce "Add to Cart" button (default) |
| **Before Add to Cart** | Above the "Add to Cart" button |
| **After Product Title** | Below the product title |
| **Before Product Title** | Above the product title |
| **Custom Hook** | Attach to a custom WordPress action hook |
| **None** | Do not display the button automatically |

When **"Custom Hook"** is selected, an additional field appears:

### Custom Hook Name

**Setting:** Enter the name of the WordPress action hook where the button should appear.

Example: `my_theme_after_price`

> **Screenshot placeholder:** *Button position dropdown with "Custom Hook" selected and the custom hook name field visible.*

---

## Popup Settings

### Enable Popup

**Setting:** Show a popup modal after a product is added to the wishlist.

| Option | Description |
|--------|-------------|
| **Yes** | Popup appears after adding a product (default) |
| **No** | No popup; button state changes silently |

> **Screenshot placeholder:** *Popup settings section showing the enable/disable toggle.*

---

## Mini Wishlist Settings

### Enable Mini Wishlist

**Setting:** Enable the mini wishlist widget functionality.

| Option | Description |
|--------|-------------|
| **Yes** | Mini wishlist is enabled (default) |
| **No** | Mini wishlist is disabled |

### Auto Display (Floating Bubble)

**Setting:** Automatically show the mini wishlist as a floating bubble on all pages.

| Option | Description |
|--------|-------------|
| **Yes** | Floating bubble is shown on every page |
| **No** | No auto-display; use shortcode to place manually (default) |

### Mini Wishlist Position

**Setting:** Choose where the floating bubble appears on the screen.

| Option | Description |
|--------|-------------|
| **Bottom Right** | Lower-right corner (default) |
| **Bottom Left** | Lower-left corner |
| **Bottom Center** | Bottom-center of the screen |
| **Right Center** | Middle of the right edge |
| **Left Center** | Middle of the left edge |

> **Screenshot placeholder:** *Mini Wishlist settings section showing enable, auto-display, and position options.*

---

## Sharing Settings

### Enable Sharing

**Setting:** Allow customers to share their wishlist via a unique URL.

| Option | Description |
|--------|-------------|
| **Yes** | Share button appears on the wishlist page (default) |
| **No** | Sharing is disabled; no share button shown |

> **Screenshot placeholder:** *Sharing settings section showing the enable toggle.*

---

## Variable Product Settings

### Allow Variation Wishlist

**Setting:** Allow customers to save individual product variations in their wishlist.

| Option | Description |
|--------|-------------|
| **Yes** | Individual variations are tracked (default) |
| **No** | Only the parent product is saved |

See [Variable Products](variable-products.md) for detailed behavior explanation.

> **Screenshot placeholder:** *Variable Product settings section showing the variation wishlist toggle.*

---

## Settings Summary Table

| Setting | Key | Default | Options |
|---------|-----|---------|---------|
| Wishlist Page | `wishlist_page_id` | Auto-created page | Page dropdown |
| Button Position | `wishlist_button_position` | `after_add_to_cart` | 6 positions |
| Custom Hook Name | `wishlist_button_custom_hook` | (empty) | Text field |
| Enable Popup | `popup_enabled` | `yes` | Yes / No |
| Enable Mini Wishlist | `mini_wishlist_enabled` | `yes` | Yes / No |
| Auto Display Bubble | `mini_wishlist_display` | `no` | Yes / No |
| Bubble Position | `mini_wishlist_position` | `bottom-right` | 5 positions |
| Enable Sharing | `share_enabled` | `yes` | Yes / No |
| Allow Variation Wishlist | `allow_variation_wishlist` | `yes` | Yes / No |

All settings are stored in a single WordPress option: `bizzwishlist_settings`.
