Need help getting set up or fixing an error? This page covers the most common questions and quick fixes.

Quick Fix Checklist

  • ✅ WordPress 6.0+, PHP 7.4+, Woo active
  • ✅ Settings → Permalinks → Save (once)
  • ✅ Woo → Status has no critical errors
  • ✅ Server allows outbound HTTP (cURL) and admin-ajax.php isn’t blocked
  • ✅ PHP memory ≥ 256M, execution time ≥ 60s

Paste your exact error here (full message + stack trace if present)

[DATE TIME] Error:
[Describe what you clicked / which screen]
[Anything you already tried]

How to capture logs

  1. Open Shopify → Woo and watch the Live Log
  2. Server log file: wp-content/uploads/bc-shopify-woo/import.log
  3. Copy the last 50–100 lines and paste into the code block above

🧰 Common Issues & Fixes

1) “Plugin could not be activated / Fatal error”

Likely causes

  • Old PHP version / strict mode errors
  • Function redeclaration from a previous copy

Fix

  • Update PHP to 7.4+
  • Make sure only one copy of the plugin folder exists under /wp-content/plugins/
  • Re-upload the ZIP and activate again

2) “AJAX error” on Live Import

Likely causes

  • Server timeout / rate limit
  • Security plugin blocks admin-ajax

Fix

  • In plugin screen, lower Batch size (e.g., 10)
  • Enable Auto-pause (e.g., pause 60s every 15–20 min)
  • Whitelist wp-admin/admin-ajax.php in your firewall/security plugin

3) “Products imported but images missing”

Likely causes

  • Shopify product lacks images or hotlinking blocked
  • Remote download blocked by server

Fix

  • Check if product has images on Shopify
  • Ask host to allow outbound HTTP/HTTPS for image download
  • Re-run import for those products (they’ll update)

4) “Duplicate products”

What the plugin does

  • It saves _shopify_product_id and pre-checks SKU to avoid duplicates.

If duplicates appear

  • Ensure SKU uniqueness in Shopify
  • Use the plugin’s No duplicates setting (already enforced)
  • Bulk-delete duplicates and re-import

5) “Variable products not creating variations”

Likely causes

  • Shopify has only one variant
  • Option names/values malformed

Fix

  • Confirm product has multiple variants/options in Shopify
  • Re-run import for that item with Batch size small (to watch logs closely)

🧪 How to Capture Logs (for support)

  1. Go to Shopify → Woo in WP Admin.
  2. Watch the Live Log (updates automatically).
  3. For deeper checks, open:
    wp-content/uploads/bc-shopify-woo/import.log
  4. Copy the last 50–100 lines and paste in the error section above.

🔧 Server Settings (recommended)

  • PHP 7.4+
  • memory_limit ≥ 256M
  • max_execution_time ≥ 60
  • cURL enabled, outbound HTTP allowed
  • Disk space sufficient for media (images)

Ask your hosting provider to adjust if needed.

🔁 Reset & Re-run (safe steps)

  1. Deactivate the plugin.
  2. Clear caches (any caching plugin + server cache).
  3. Reactivate plugin.
  4. Start a small test import (Batch size: 5–10) to verify.
  5. Increase batch gradually.

🧭 When to Use the “Missing Fields Sync” Add-On

If you already imported but some products lack image / price / category / description, use the companion plugin “BC Woo Missing Fields Sync (Shopify)” to fill gaps every 10 minutes automatically.

📮 Need Help?

When you contact support, please include:

  • WordPress version, PHP version, hosting provider
  • A copy of your error message and the last 50 lines from the log
  • Screenshot of the plugin settings you used (base URL, collection, batch size)

Email: plugins@snarscorp.com (or your preferred support email)

✅ Quick Test Block (optional)

Shopify Base URL: https://www.brewingcricket.com
Collection: all
Batch size: 10
Auto-pause: pause 60s every 20 min

Run this small batch first to confirm your environment, then scale up.