=== DimensionKit ===
Contributors: worbee
Tags: scorecard, assessment, quiz, survey, lead generation
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed your DimensionKit scorecards and assessments on any page, with a block or a shortcode.

== Description ==

DimensionKit builds scored assessments — readiness checks, maturity models, qualification quizzes — and publishes them with results, tiers, and contact capture. This plugin puts them on your WordPress site.

Connect your DimensionKit account once. The plugin then lists your scorecards, lets you allow this site to embed them in one click, and gives you a block and a shortcode to place them.

= What it does =

* **Connect once.** Sign in to DimensionKit from the settings screen. No API keys to copy, no credentials stored in a form.
* **Allow this site with one click.** DimensionKit only renders a scorecard inside sites you have allowed. The plugin adds this site's address to the list for you, keeping any other sites already on it.
* **Block or shortcode.** Pick a scorecard from a dropdown in the editor, or paste `[dimensionkit slug="your-scorecard"]` anywhere shortcodes run.
* **Resizes itself.** The embedded scorecard reports its height as the visitor moves through the questions, so there is no inner scrollbar and no fixed height to guess.

= Writing the scorecards =

Scorecards are written in DimensionKit; the settings screen links straight to it. You can also connect DimensionKit to Claude, ChatGPT or another AI assistant and have it write one for you — describe the assessment and the assistant produces the dimensions, questions and result tiers. The settings screen shows the connector address and the four steps.

= What you need =

A DimensionKit account, and a site served over HTTPS so the sign-in can be sent back to it. WordPress 6.3 or newer.

== External services ==

This plugin connects to DimensionKit's hosted service at `https://app.dimensionkit.com`. It is required: the plugin exists to display scorecards held in your DimensionKit account.

**When the plugin contacts DimensionKit, and what it sends:**

* **Connecting your account** (only when an administrator starts it): this site's address and name are sent to register it as an application, and the administrator is redirected to DimensionKit to sign in and approve access. Access and refresh tokens come back and are stored in this site's database.
* **Listing your scorecards** (in the admin, and when the block editor loads): sends the stored access token; receives your scorecards' titles, slugs, publication status and submission counts.
* **Allowing this site** (only when an administrator clicks the button): sends the scorecard's slug and this site's address, so DimensionKit will render that scorecard inside this domain.
* **Showing a scorecard to a visitor**: the page loads the `embed.js` script from `https://app.dimensionkit.com`, which places the scorecard in an iframe served from the same address. The plugin sends nothing about the visitor; whatever the scorecard itself collects is governed by that scorecard's own settings in DimensionKit.

No visitor data passes through this plugin, and it sends nothing to any other service.

Service: DimensionKit — [dimensionkit.com](https://dimensionkit.com) · [Terms](https://dimensionkit.com/terms) · [Privacy policy](https://dimensionkit.com/privacy)

== Installation ==

1. Install and activate the plugin.
2. Open **DimensionKit** in the admin menu.
3. Click **Connect to DimensionKit** and approve access.
4. Find your scorecard in the list and click **Allow on this site**.
5. Add the **DimensionKit Scorecard** block to a page, or paste the shortcode shown next to the scorecard.

== Frequently Asked Questions ==

= The scorecard area is blank on my page. =

The scorecard is only rendered inside sites it has been allowed on. Open the DimensionKit settings screen and click **Allow on this site** for that scorecard. If your site answers on both `example.com` and `www.example.com`, allow whichever one your Site Address setting uses — they count as different sites.

= How do I create a scorecard? =

In DimensionKit. The plugin's settings screen has a **Write a new scorecard** button that takes you there; click **Refresh list** afterwards and it appears in WordPress ready to place on a page.

= Can an AI assistant write one for me? =

Yes. Copy the connector address from the plugin's settings screen, paste it into Claude, ChatGPT or another AI assistant, and ask it to connect itself to DimensionKit — it will know what to do. Then describe the assessment you want and it writes the dimensions, questions and result tiers and publishes to your account. There is a fuller guide at https://dimensionkit.com/docs/mcp/connecting/

= Can I show a draft scorecard? =

No. Drafts do not render for visitors. Publish the scorecard in DimensionKit first.

= Does this work with page builders? =

Yes. Anywhere shortcodes are supported, `[dimensionkit slug="your-scorecard"]` works.

= Can I put more than one scorecard on a page? =

Yes. Each block or shortcode renders its own.

= What happens if I disconnect? =

The site forgets its tokens and stops listing your scorecards. Scorecards already placed on your pages keep working, because they are still allowed on this site in DimensionKit.

= Do I need to self-host anything? =

No. The plugin connects to DimensionKit's hosted service, and there is nothing to configure.

== Screenshots ==

1. A finished scorecard on a page: a scored result for every dimension, with a chart, a tier, and written feedback.
2. The scorecard on a page of your own site, where visitors find it.
3. Choosing which scorecard to show, in the block editor.
4. The settings screen — every scorecard on your account, which of them this site may embed, and the shortcode for each.
5. A question as a visitor sees it, with their progress through the assessment.
6. The same results in another theme. Scorecards are styled in DimensionKit and keep their look wherever you embed them.

== Changelog ==

= 1.0.1 =
* Allowing a scorecard sends this site's address only. DimensionKit adds it to the list and keeps every other site already there.
* A draft no longer offers Allow. Publish it in DimensionKit first; a draft cannot be embedded.

= 1.0.0 =
* First release: connect a DimensionKit account, allow this site to embed scorecards, and place them with a block or a shortcode.

== Upgrade Notice ==

= 1.0.1 =
Allowing a scorecard no longer downloads it, and drafts ask you to publish them before they can be embedded.

= 1.0.0 =
First release.
