Capitalith Insights for WooCommerce

Description

Capitalith Insights turns your WooCommerce stock into actionable business intelligence. Instead of just counting units, it shows you how much capital is locked in your inventory, which categories hold the most money, which products are selling fast and which are sitting dead, and how much revenue you can expect in the next 30, 60, and 90 days.

What you can do

  • See the money in your stock — retail value, cost basis, profit potential, and margin, all in one place.
  • Break down capital by category — a bar chart showing which categories hold the most investment.
  • Track daily history — automatic snapshots of total value with a trend chart (7D / 30D / 90D / 1Y).
  • Measure sales velocity — average daily sales per product, computed from WooCommerce’s own analytics tables.
  • Detect dead stock — products with stock but no sales in a configurable window, plus the total capital locked in them.
  • Get reorder alerts — products whose stock has fallen below sales velocity × lead time.
  • Compare periods — current 30 days vs. previous 30 days, with percentage change.
  • Forecast cash flow — projected revenue for the next 30, 60, and 90 days based on recent velocity.
  • Run ABC analysis — see which products drive 80% of your inventory value, the classic Pareto breakdown.
  • Get value-drop alerts — a warning when total inventory value falls more than a configurable percentage vs. the 7-day average.
  • Receive Telegram notifications — optional daily summaries, dead-stock reports, reorder warnings, and value-drop alerts delivered to your chat or group.
  • Export anywhere — UTF-8 CSV (with edit links per product), styled Excel (.xls with colors and totals), and a print-friendly HTML report.

Built for real stores

  • Paginated calculation — even stores with thousands of products compute without running out of memory.
  • Versioned cache — every stock or product change automatically invalidates the cached valuation.
  • HPOS-compatible — declared with WooCommerce’s High-Performance Order Storage from day one.
  • RTL and translation-ready — full right-to-left support; every string uses the plugin’s text domain.
  • Multisite-aware — deactivation and uninstall clean up data across every site in the network.
  • No telemetry — nothing leaves your server unless you explicitly enable Telegram.

Perfect for

  • Store owners who want to know exactly how much money is sitting in their warehouse.
  • Inventory managers who need to spot dead stock before it becomes a write-off.
  • Small businesses tracking cash flow and reorder timing without a full ERP.
  • Anyone who prefers a clean, fast dashboard over a spreadsheet.

For developers

  • Filter capitalith_product_cost to override the cost-price calculation.
  • Filter capitalith_admin_parent_menu to relocate the admin menu under your own brand.
  • Filter capitalith_sales_counted_statuses to change which order statuses count as sales.
  • Action capitalith_alert_created fires whenever a value-drop alert is generated.
  • REST endpoints under capitalith/v1 power the React dashboard.

External services

This plugin optionally connects to the Telegram Bot API to deliver inventory notifications requested by the site administrator.

What data is sent:

  • Inventory summary statistics: total retail value, unit count, product count, out-of-stock and low-stock counts.
  • Product names and SKUs of items included in dead-stock or reorder alerts.
  • Your site URL and current server time inside test messages.
  • Order statistics are read locally from the WooCommerce analytics tables; only aggregated totals are sent. Individual customers, addresses, phone numbers, and payment data are never transmitted.

Where it is sent:

  • https://api.telegram.org — Telegram’s official Bot API. Requests go over HTTPS with the bot token embedded in the URL, per the Telegram Bot API specification.

When it is sent:

  • Only when the administrator has explicitly enabled “Telegram notifications” in the plugin settings.
  • On the chosen schedule (daily, or weekly on Fridays) via WP-Cron.
  • Immediately, if the administrator clicks any of the “Send now” buttons.
  • Never, if Telegram notifications are disabled (the default).

Terms and privacy:

  • Telegram Terms of Service: https://telegram.org/tos
  • Telegram Privacy Policy: https://telegram.org/privacy

Opting out:

  • Untick “Enable Telegram notifications” in Settings Inventory Analytics Telegram. No further requests will be made. The bot token and chat ID remain stored locally so you can re-enable easily, and are removed on plugin uninstall.

Installation

  1. Make sure WooCommerce is installed and active.
  2. Upload the plugin folder to /wp-content/plugins/ or install it from the WordPress plugin screen.
  3. Activate it through the Plugins menu.
  4. Go to WooMaster Inventory Analytics to open the dashboard.
  5. Optionally open the Settings tab to configure tax basis, cache lifetime, cost meta keys, and Telegram notifications.

FAQ

Does this plugin work without WooCommerce?

No. It requires WooCommerce to be installed and active. The “Requires Plugins” header will prevent activation if WooCommerce is missing, and an admin notice explains the problem.

How is the retail value calculated?

For each product with stock management enabled, we multiply the active price (including any current sale price) by the current stock quantity. Variable products are calculated per variation.

What about products without stock management?

Products with “stock management” disabled are excluded, since they have unlimited stock and would inflate the totals artificially.

Where does the cost value come from?

If a recognized cost meta key exists on the product (for example _wc_cog_cost from a Cost of Goods plugin), it is used. Otherwise you can configure a custom meta key in Settings. If no cost data is found, the cost total falls back to the retail total.

How does the history and alerts work?

Once a day, a snapshot of your total inventory value is stored in a dedicated database table. If the current value drops more than a configurable percentage versus the 7-day average, a warning appears at the top of the dashboard until you dismiss it, and an optional Telegram notification is sent.

Can I get notifications outside the dashboard?

Yes. Optional Telegram notifications can send a daily summary, dead-stock report, reorder warnings, and value-drop alerts to your chat or group. You need to create a free bot with @BotFather and provide its token plus your chat ID.

Is the plugin multisite compatible?

Yes. Deactivation and uninstallation clean up data across every site in the network.

Does it send data to any external service?

Only if you explicitly enable Telegram notifications. Everything else runs on your own server. See the External services section for details.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Capitalith Insights for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.2

  • Fixed: network activation now creates the history table and cron events for every site in the network.
  • Fixed: new sites created on a network where the plugin is already network-active receive their own table automatically.
  • Fixed: text domain aligned with the WordPress.org plugin slug (capitalith-insights-for-woocommerce).
  • Fixed: capitalith_admin_parent_menu filter now documented and applied in Menu.php.
  • Fixed: all inline CSS moved to external files.

1.2.1

  • Fixed: fatal error when opening the dashboard without WooCommerce active (Assets::enqueue now guards WooCommerce functions).
  • Added: Requires Plugins header so WordPress prevents activation when WooCommerce is missing.
  • Fixed: plugin name, slug, text domain, and author metadata updated for WordPress.org compliance.

1.2.0

  • Added: optional Telegram notifications — daily summary, dead-stock, reorder, and value-drop alerts.
  • Added: Settings section for bot token, chat ID, schedule, send hour, and per-channel toggles.
  • Added: “Test connection” and “Send now” buttons for manual dispatch.
  • Added: capitalith_alert_created action for third-party integrations.
  • Added: HTML and styled Excel export alongside CSV.
  • Added: toast notification on save.
  • Fixed: checkbox and select fields not reflecting the stored value in the settings UI.
  • Fixed: settings not persisting when saving from the Settings tab.

1.1.0

  • Added: daily snapshot history of total inventory value.
  • Added: interactive value trend chart (7D / 30D / 90D / 1Y).
  • Added: low-inventory value drop alerts with configurable threshold.
  • Added: configurable history retention (30–730 days).
  • Added: manual snapshot button and REST endpoint for on-demand calculation.
  • Added: sales velocity, dead stock, and reorder analysis.
  • Added: period comparison, cash flow forecast, and ABC analysis.

1.0.0

  • Initial release.