=== CalcStack — Lead Generation Tools ===
Contributors: calcstack
Tags: lead generation, calculator, quiz, interactive content, lead capture
Requires at least: 5.0
Tested up to: 6.7
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn WordPress visitors into qualified leads with interactive calculators, scorecards, quizzes, and more — with built-in lead capture and CRM integration.

== Description ==

**CalcStack is a lead generation platform.** Businesses embed interactive tools on their WordPress site to turn visitors into qualified leads — with every input, result, and buying signal captured and sent to their CRM.

Unlike static contact forms that convert 2-3% of visitors, interactive content converts 30-50%. Every lead arrives with rich context: what they entered, what their results were, how they benchmark against their industry, and an automatic quality score.

= Why CalcStack? =

* **250+ ready-to-embed lead generation tools** across 14 industries
* **7 content types**: Calculators, Scorecards, Decision Engines, Benchmarks, Graders, Quizzes, AI Generators
* **Built-in lead capture**: Visitors engage with the tool, then enter their email to unlock full results and PDF reports
* **Industry benchmarks**: Every tool compares results against sourced industry data
* **CRM integration**: Leads flow to HubSpot, Salesforce, Mailchimp, Slack, Google Sheets, Zapier, or custom webhooks
* **Branded PDF reports**: Multi-page consulting-grade reports with your logo and colours
* **Lead scoring**: Every lead is automatically scored based on their inputs relative to industry benchmarks
* **A/B testing**: Test different tools against each other to optimise conversion
* **White-label**: Remove CalcStack branding entirely on paid plans
* **Analytics dashboard**: Track views, completions, leads, and conversion rates

= How Plan Enforcement Works =

All plan enforcement happens on CalcStack's servers — not in this plugin. The plugin simply embeds an iframe. When a visitor loads the tool on your WordPress site:

* **Views** are counted against your monthly plan limit
* **Lead capture** only activates if your plan includes it (Starter plan and above)
* **Branding removal** only applies if your plan includes it (Starter+)
* **White-label** (custom logo, colours, branded PDFs) only applies on Growth+ plans
* **CRM webhooks** only fire on Growth+ plans
* **PDF reports** are gated by plan tier (basic on Free/Starter, full reports on Growth+)

Without a Customer ID, the embed runs as a free demo with CalcStack branding, no lead capture, and a 500 view/month limit.

= Who Uses CalcStack? =

* **SaaS companies** — embed ROI calculators and SaaS benchmarks to qualify leads
* **Marketing agencies** — white-label lead generation tools for clients across any industry
* **Financial services** — profit margin, investment, and valuation calculators that capture prospect data
* **Home service businesses** — cleaning, solar, roofing, and plumbing quote calculators that capture job details
* **Real estate** — mortgage calculators, rental yield tools, and property scorecards that capture buyer data
* **Ecommerce** — product configurators and shipping calculators that capture purchase intent

= Shortcode Usage =

Basic embed (free demo mode):

`[calcstack tool="profit-margin-calculator"]`

Linked to your CalcStack account (enables lead capture, branding, CRM):

`[calcstack tool="profit-margin-calculator" customer="your-calcstack-user-id"]`

All parameters:

* `tool` — the tool slug from calcstack.net (required)
* `customer` — your CalcStack user ID from Dashboard > Settings (recommended)
* `height` — iframe height in pixels (default: 600)
* `theme` — "light" or "dark" (default: light)

More examples:

`[calcstack tool="marketing-health-score" customer="abc123" height="800"]`
`[calcstack tool="hire-vs-outsource" customer="abc123" theme="dark"]`
`[calcstack tool="benchmark-your-saas" customer="abc123" height="900"]`

= Gutenberg Block =

Search for "CalcStack" in the block inserter. Set the tool slug, height, theme, and Customer ID in the block settings panel. The tool renders as a live preview in the editor.

= Where to Find Your Customer ID =

Log in to [calcstack.net](https://calcstack.net), go to Dashboard > Settings. Your Customer ID is displayed at the top of the page.

= Browse All Tools =

Visit [calcstack.net/resources](https://calcstack.net/resources) to browse all 250+ lead generation tools by industry and content type.

== Installation ==

1. Upload the `calcstack-embeddable-calculators` folder to `/wp-content/plugins/`
2. Activate the plugin through the "Plugins" menu in WordPress
3. Use the `[calcstack tool="your-tool-slug" customer="your-id"]` shortcode or the CalcStack Gutenberg block on any page or post
4. Find your Customer ID at [calcstack.net/dashboard/settings](https://calcstack.net/dashboard/settings)
5. Browse available tools at [calcstack.net/resources](https://calcstack.net/resources)

== Frequently Asked Questions ==

= What is CalcStack? =

CalcStack is a lead generation platform. Businesses embed interactive tools on their website — calculators, scorecards, decision engines, benchmarks, graders, and quizzes — to turn visitors into qualified leads. Every lead arrives with their inputs, results, benchmarks, and a quality score.

= Do I need a CalcStack account? =

The plugin works immediately for basic embedding without an account (free demo mode). To enable lead capture, CRM integration, branded PDF reports, and analytics, sign up at [calcstack.net](https://calcstack.net) and add your Customer ID to the shortcode or block settings.

= What data does CalcStack capture from leads? =

Every lead includes: their email, every input they entered, every result calculated, their benchmark position against industry averages, and an automatic quality score (high/medium/low). This gives your sales team complete context before the first conversation.

= Which CRMs does CalcStack integrate with? =

HubSpot, Salesforce, Mailchimp, Slack, Google Sheets, Zapier (connecting to 5,000+ apps), and custom webhooks.

= Can I remove CalcStack branding? =

Yes. The Starter plan (£29/mo) removes branding. The Growth plan (£59/mo) adds full white-label — your logo, your colours, your branding on PDF reports.

= How are views counted? =

Every time a visitor loads the embedded tool on your WordPress page, it counts as one view against your plan limit. This is tracked server-side by CalcStack, not by the plugin. The Free plan includes 500 views/mo, Starter 5,000, Growth 25,000, and Agency is unlimited.

= How many tools can I embed? =

Free: 1 tool. Starter (£29/mo): 5 tools. Growth (£59/mo): 20 tools. Agency (£149/mo): unlimited.

= Does it work with my theme? =

Yes. CalcStack tools are embedded via iframe and adapt to any WordPress theme. Light and dark themes are available via the theme parameter.

= Does it work with page builders? =

Yes. The shortcode works in Elementor, Beaver Builder, Divi, WPBakery, and any page builder that supports shortcodes. The Gutenberg block works in the native WordPress editor.

= Is it GDPR compliant? =

CalcStack is operated by CalcStack Ltd, registered in England and Wales. Data is processed under UK GDPR with documented legal bases, retention periods, and user rights. See [calcstack.net/privacy](https://calcstack.net/privacy).

= What happens if I exceed my view limit? =

Embeds are paused until the next billing cycle or until you upgrade your plan. Visitors see a message indicating the tool is temporarily unavailable.

== Screenshots ==

1. Profit margin calculator with industry benchmarks and lead capture
2. Marketing Health Score — 10-question assessment that qualifies leads
3. Hire vs Outsource decision engine capturing buying intent
4. Lead management dashboard with automatic quality scoring
5. CRM integration setup with one-click test
6. Gutenberg block with live preview in the WordPress editor

== Changelog ==

= 1.0.0 =
* Initial release
* Shortcode support: [calcstack tool="slug" customer="id"]
* Gutenberg block with live preview
* Customer ID parameter for plan-linked embeds
* Light and dark theme support
* 250+ lead generation tools available

== Upgrade Notice ==

= 1.0.0 =
Initial release. Embed CalcStack lead generation tools on your WordPress site with full plan enforcement and CRM integration.