DDark Obsidian › Plugins › WooCommerce Connector
⬇ Download
WooCommerce
WooCommerce Free GPL v2+

Dark Obsidian Connector

Connect your WooCommerce store to Dark Obsidian Business OS in one click. Products, orders, customers, and inventory sync automatically - no API keys to copy, no technical setup required.

1.0.7Version
★★★★★
GPL Licensed
WP 6.0+Requires
PHP 8.1+Minimum PHP

What syncs automatically

📦
Products
Catalog, prices, stock levels, and images
🛒
Orders
Imported as full sales records with line items
👤
Customers
Synced to the Dark Obsidian CRM module
📊
Inventory
Real-time stock updates via webhooks
🔔
Webhooks
7 event topics for instant push updates
📈
Analytics
Revenue trends in Dark Obsidian BI

How it works

1
Install the plugin
Upload the zip in WordPress Admin → Plugins → Add New, or install from WordPress.org. Activate - no configuration needed.
2
Click Connect to Dark Obsidian
Go to WordPress Admin → Dark Obsidian. Click the connect button. A secure popup opens - sign in to your Dark Obsidian account.
3
Choose your business
Select which Dark Obsidian business to link this store to. Review permissions and click Allow.
✓
Connected - sync begins immediately
API keys are generated and delivered automatically. The popup closes. Your WP admin shows the connected dashboard with live stats.

Plugin screenshots

Disconnected - one-click connect
Not connected
🔗
Connect to Dark Obsidian
✓ Plugin installed
✓ WooCommerce detected
○ Not connected
Connect to Dark Obsidian →
Connected - live stats dashboard
Connected
🏢
Sample Store
Syncing with Dark Obsidian Business OS
✓
247
Products
1,089
Orders
836
Customers
0
Queue
⟳ Sync now
Reconnect
Disconnect

Webhook topics registered

product.created
product.updated
product.deleted
order.created
order.updated
customer.created
customer.updated

Webhooks deliver to https://darkobsedian.sameergul.com/api/v1/webhooks/wc/{store_id} signed with HMAC-SHA256.

One-click installation

1
Download & upload the plugin zip
Click Download on this page. Then go to WordPress Admin → Plugins → Add New → Upload Plugin, choose the zip, click Install Now, then Activate.
2
Confirm WooCommerce is active
The plugin shows an admin notice and disables itself if WooCommerce is not found. Make sure WooCommerce 7.0+ is installed and active.
3
Open the Dark Obsidian admin page
WordPress Admin → Dark Obsidian (in the left menu). You will see the pre-flight checklist: Plugin installed ✓ · WooCommerce detected ✓ · Not yet connected ○.
4
Click "Connect to Dark Obsidian →"
A 520×700 px popup opens pointing to the Dark Obsidian connect portal. The URL contains a one-time nonce with a 15-minute expiry.
5
Sign in & choose a business
Enter your Dark Obsidian credentials. Select which business to link this WooCommerce store to. Review the permissions list and click Allow.
✓
Done - connection is live
The portal generates your WC API key and registers 7 webhooks automatically. The popup closes and your WordPress admin reloads showing the connected dashboard.

Manual credential setup

Manual setup does not register webhooks. Real-time sync will not work - the app pulls data on a schedule only. Use the one-click method for production stores.
1
Create a WooCommerce API key
WooCommerce Admin → Settings → Advanced → REST API → Add key
Description: Dark Obsidian · User: admin · Permissions: Read/Write
Click Generate API key. Copy the Consumer Key (ck_…) and Consumer Secret (cs_…) - shown only once.
2
Add the store in Dark Obsidian
In the Dark Obsidian app: Commerce → Manage Stores → + Add Store → choose WooCommerce
✓
Enter credentials & save
Store URL: https://yourshop.com
Consumer Key: ck_…
Consumer Secret: cs_…
Test connection → Save.
1.0.3 2026-08-10 Update
  • Fixed: WooCommerce REST calls rejected as "not allowed" on hosts that terminate TLS at a proxy/CDN - the API key was ignored entirely
  • Fixed: generated API key could be attached to a non-administrator user, leaving it without read/write permission
1.0.2 2026-08-07 Update
  • Fixed: "Plugin URI" pointed at a dead link - now points to the plugin's info page
  • Fixed: activation redirect now lands on the plugin's own getting-started page instead of an external redirect some hosts' security plugins can block
1.0.1 2026-08-07 Update
  • Fixed: connect flow now goes through a proper consent page instead of a dead link
  • Fixed: activation now redirects straight into the Dark Obsidian sign-in flow
  • Fixed: admin dashboard text/data was invisible against WordPress's light admin background
  • Fixed: "Last sync" now reflects a real sync time; removed a stat that could never show real data
1.0.0 2026-07-11 Initial Release
  • One-click connection via Dark Obsidian secure connect portal - no API keys to copy
  • Automatic WooCommerce REST API key provisioning (read/write, generated server-side)
  • Webhook registration for 7 event topics: product.created/updated/deleted, order.created/updated, customer.created/updated
  • Connected admin dashboard with live sync statistics (products, orders, customers, queue)
  • Clean disconnect: removes API key, all webhooks, and all plugin options (keeps installation UUID for re-connection)
  • WooCommerce High-Performance Order Storage (HPOS) compatibility declared
  • Zero front-end footprint - no queries on public page loads
  • GPL v2 or later
Do I need a Dark Obsidian account?
Yes. Dark Obsidian Connector is the bridge between your WooCommerce store and Dark Obsidian Business OS. You will need an active account to connect. A free trial is available at darkobsedian.sameergul.com.
Is the connection secure?
Yes. The initial handshake uses a one-time HMAC-signed nonce (15-minute TTL, single-use). All subsequent server-to-server calls from Dark Obsidian to your WordPress site are verified with HMAC-SHA256 signatures. Credentials are delivered over TLS and are never stored in your WordPress database.
What data is synced?
Products (name, SKU, price, stock quantity, images), orders (status, totals, line items, customer), and customers (name, email, phone). Only published products are synced. Orders are synced regardless of status.
Will this slow down my website?
No. The plugin has zero front-end footprint - it only loads in the WordPress admin and responds to webhook calls. There are no queries on public page loads.
Can I disconnect at any time?
Yes. Click Disconnect on the Dark Obsidian admin page. This immediately removes the WooCommerce API key and all registered webhooks. Your existing data in Dark Obsidian is not deleted - only the live sync stops.
Can I reconnect after disconnecting?
Yes. Click Connect to Dark Obsidian again. New API keys and webhooks are provisioned automatically. Your previous sync history in Dark Obsidian is preserved.
Does it support WooCommerce HPOS?
Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage (custom_order_tables) via FeaturesUtil::declare_compatibility(). Tested with WooCommerce 7.0 through 9.x.
← All Plugins Dark Obsidian Business OS Connect a store →