# Troubleshooting

This guide helps you resolve common issues with Bizzwishlist.

## Wishlist Button Not Showing

**Possible causes:**

1. **Button position set to "None"**
   - Go to **Bizzwishlist > Settings** and check the button position. If set to "None", the button is hidden intentionally.
   - Change to a visible position or use the shortcode `[bizzwishlist_button]` to place it manually.

2. **WooCommerce not active**
   - Make sure WooCommerce is installed and activated. Bizzwishlist requires WooCommerce.

3. **Theme compatibility**
   - Some themes may not fire standard WooCommerce hooks (e.g., `woocommerce_after_add_to_cart_button`). Try changing the button position to a different hook or use the "Custom Hook" option.

4. **JavaScript error**
   - Open your browser's developer console (F12) and check for JavaScript errors. A JS error from another plugin or theme may prevent the wishlist button from rendering.

5. **Caching**
   - If you use a caching plugin, clear the cache after activating Bizzwishlist or changing settings.

---

## Wishlist Page Shows "Your Wishlist is Empty" Even Though Items Were Added

**Possible causes:**

1. **Wrong wishlist page selected**
   - Go to **Bizzwishlist > Settings** and verify the correct page is selected as the wishlist page.

2. **Cookie blocked (guests)**
   - Guest wishlists require cookies. If the browser blocks cookies, the session key cannot be stored and the wishlist will appear empty.

3. **Page does not contain the shortcode**
   - Edit the wishlist page and confirm it contains the `[bizzwishlist]` shortcode.

4. **Different browser or device (guests)**
   - Guest wishlists are stored in browser cookies. Opening a different browser or device will show an empty wishlist.

---

## AJAX Not Working / Button Does Nothing When Clicked

**Possible causes:**

1. **JavaScript conflict**
   - Another plugin or theme may have a JavaScript error that prevents Bizzwishlist's JS from running. Check the browser console for errors.

2. **jQuery not loaded**
   - Bizzwishlist requires jQuery. Make sure your theme or another plugin has not deregistered jQuery.

3. **Nonce expired**
   - If the page has been open for a very long time, the security nonce may have expired. Refresh the page and try again.

4. **Admin AJAX URL incorrect**
   - In rare cases, the `admin-ajax.php` URL may be incorrect. This can happen with non-standard WordPress installations.

---

## Guest Wishlist Not Merging After Login

**Possible causes:**

1. **Cookie not set**
   - If the guest did not have a session cookie (e.g., cookies were blocked), there is no guest wishlist to merge.

2. **Login method**
   - The merge happens on the `wp_login` action hook. If your site uses a custom login method that does not fire this hook, the merge will not occur.

---

## Mini Wishlist / Floating Bubble Not Showing

**Possible causes:**

1. **Mini wishlist disabled**
   - Go to **Bizzwishlist > Settings** and make sure "Enable Mini Wishlist" is set to "Yes".

2. **Auto-display not enabled**
   - If you want the floating bubble on all pages, set "Auto Display (Floating Bubble)" to "Yes".

3. **Theme conflict**
   - The floating bubble uses CSS `position: fixed`. If your theme has conflicting CSS (e.g., `overflow: hidden` on the body), the bubble may not be visible. Inspect the element with browser developer tools.

---

## Wishlist Popup Not Appearing

**Possible causes:**

1. **Popup disabled**
   - Go to **Bizzwishlist > Settings** and make sure "Enable Popup" is set to "Yes".

2. **JavaScript error**
   - Check the browser console for errors that may prevent the popup from opening.

3. **CSS conflict**
   - Another plugin or theme may have CSS that hides the popup overlay. Use browser developer tools to inspect the popup element.

---

## Shared Wishlist Link Not Working

**Possible causes:**

1. **Sharing disabled**
   - Go to **Bizzwishlist > Settings** and make sure "Enable Sharing" is set to "Yes".

2. **Wrong wishlist page**
   - The share link points to the wishlist page with a special query parameter. Make sure the correct wishlist page is selected in settings.

3. **Permalink issues**
   - Try flushing your permalinks: Go to **Settings > Permalinks** and click "Save Changes" without making any changes.

---

## Performance Issues

If you notice performance issues:

1. **Caching** — Use a caching plugin (e.g., WP Super Cache, W3 Total Cache) to cache your pages.
2. **Database optimization** — The plugin creates indexes on the wishlist table for efficient queries. If you have a very large number of wishlist entries, consider periodically cleaning up old guest session data.
3. **CDN** — Serve static assets via a CDN to reduce server load.

---

## Still Need Help?

If your issue is not listed above:

1. **Check the browser console** — Press F12 and look at the Console tab for JavaScript errors.
2. **Deactivate other plugins** — Temporarily deactivate other plugins to check for conflicts.
3. **Switch to a default theme** — Try switching to a default WordPress theme (e.g., Twenty Twenty-Four) to rule out theme conflicts.
4. **Contact support** — Visit the [plugin support page](https://wordpress.org/support/plugin/bizzwishlist/) on WordPress.org and describe your issue with details.