=== ChartQuill – WordPress Chart Builder ===
Contributors: dgwyer, wpgoplugins
Tags: chart, chart block, chart builder, data visualization, graph
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build responsive WordPress charts with CSV import, 11 free styles, bold line weights, direct pie labels, linked tables, and local rendering.

== Description ==

ChartQuill is a flexible chart plugin and chart builder for the WordPress block
editor. Create responsive bar, line, pie, scatter, histogram, and heatmap
charts from data entered directly, pasted from a spreadsheet, or imported from
a local CSV/TSV file, without leaving Gutenberg.

Free line charts include thin, regular, and bold line weights so trends remain
clear in different layouts. Free pie charts can place direct percentage or
formatted-value labels on slices, helping readers understand the composition
without relying on a separate legend alone.

Each chart block provides purposeful controls for mapping, formatting, colour,
and presentation. Add a useful title, summary, source, and optional linked data
table so the finished visualization works naturally within an article, report,
dashboard, or page.

Chart data stays with the block and remains editable in WordPress. No iframe,
hosted chart service, or front-end CDN is required. Your data stays under your
control, and semantic fallback content keeps the underlying information
available beyond the visual.

The free edition includes:

* Vertical and horizontal single-series bar charts.
* Vertical and horizontal grouped bar charts.
* Dot plots and lollipop charts for precise, lightweight comparisons.
* Line charts, scatter plots, histograms, heatmaps, and pie charts.
* Common chart controls for number/date formats, ordering, legends, ticks,
  chart height, bar spacing/corners, line shape and weight, point size, and
  pie labels as percentages or formatted values.
* A guided sample start plus one spreadsheet-like editor with direct CSV/TSV
  paste and local file import, explicit Apply or Cancel actions, and
  chart-appropriate field mapping.
* Title, accessible summary, source, and unit fields.
* Theme-aware colours, legends, optional grid lines, and context-sensitive labels.
* Readable chart tags that are unique within a post.
* Responsive, self-hosted SVG enhancement without an iframe or chart service.
* On-mark pointer tooltips plus a compact keyboard- and touch-friendly value
  explorer, without a separate tab stop for every chart mark.
* One-click linked Chart Data Table blocks with clear connection status,
  captions, Minimal/Grid/Striped native Block Styles, two densities, standard
  block styling, and saved snapshots that can outlive their source chart.
* Two opt-in, demo-ready ChartQuill starter patterns; activation never creates
  demo pages.
* A permanent ChartQuill Home workspace with direct chart-family starters and
  reader-question guidance; every choice opens an unsaved editor and never
  publishes or overwrites content automatically.
* Polished family previews in the block inserter and a consistent Data,
  Content, Appearance, Analysis, and Connections settings structure.
* A ChartQuill settings page for the default colour of newly inserted charts.
* Wide and full-width alignment.

Each chart and its data are saved with the post. Titles, summaries, sources,
and any linked data table remain available if the visual cannot be rendered,
helping the underlying information stay accessible and useful.

= Go further with ChartQuill Pro =

[Explore ChartQuill Pro](https://wpgoplugins.com/plugins/chartquill/) for richer analysis, presentation, and publishing workflows.

* Twelve professional chart styles, including stacked and 100% stacked bars, bullet charts, Likert, waterfall, area, trend, bubble, box plot, and donut charts.
* Deeper analysis with rolling averages, cumulative and indexed series, Top-N plus Other, uncertainty and confidence bands, mean and median overlays, log scales, explicit domains, and advanced histogram and heatmap controls.
* Reusable brand palettes plus per-series, per-slice, per-mark, and conditional colours.
* Editorial annotations with reference lines, shaded ranges, callouts, and direct labels.
* A richer bubble-chart workflow with a four-sector starter, exact hover
  values, an independent size legend, and configurable direct labels.
* Branded report patterns and professional Editorial and Report table styles.
* Non-destructive Pro charts that preserve their data and settings if a license is temporarily unavailable.

== Installation ==

1. In the WordPress dashboard, go to Plugins > Add New. Search for ChartQuill,
   or choose Upload Plugin if you received a ZIP, then install it.
2. Activate it. ChartQuill opens its Home workspace, where you can start from
   a chart family, a reader question, or an example layout.
3. Optionally choose the default colour for new charts under ChartQuill > Settings.
4. Add a chart family from ChartQuill Home or the ChartQuill inserter category,
   then choose its style in the block.
5. Replace the sample by typing or pasting in the grid, or import a local CSV/TSV
   file. Review the draft, then choose Apply data.
6. Confirm the mapped fields, then add a helpful title, summary, and source.

== Screenshots ==

1. Compare categories with a clear vertical bar chart.
2. Type, paste, or import CSV/TSV data in one focused editing grid.
3. Insert a synchronized accessible table, then place it wherever the story needs it.
4. Browse polished starter layouts for charts, tables, and reports.
5. Show change over time with a multi-series line chart.
6. Show part-to-whole proportions with direct percentage labels.
7. Show the distribution of numeric values with a histogram.
8. Reveal patterns across two dimensions with a color-scaled heatmap.
9. Explore relationships between two measures with a scatter chart.
10. Compare multiple series side by side with grouped vertical bars.
11. Rank categories with a readable horizontal bar chart.
12. Compare multiple series with grouped horizontal bars.
13. Configure Pro reporting charts with purpose-built field controls.
14. Compare precise values with a lightweight dot plot.
15. Emphasize category values with compact lollipop marks.
16. ChartQuill Pro compares actual performance with targets and qualitative ranges.

== Frequently Asked Questions ==

= Which chart styles are included? =

Free includes vertical and horizontal single/grouped bars, dot plots, lollipop charts, line, scatter,
histogram, heatmap, and pie. Pro adds stacked and 100% stacked bars in both
orientations, bullet, diverging Likert, waterfall, area, trend, bubble, box
plot, and donut styles.

= Does ChartQuill send chart data to another service? =

No. Chart data remains in WordPress. ChartQuill bundles its rendering libraries
locally and does not use a hosted chart-rendering service or CDN.

= Does ChartQuill use an external service? =

ChartQuill uses the Freemius SDK for optional usage opt-in, Pro license
activation, updates, upgrades, and commerce. Freemius does not render charts or
receive chart data.

Free users may skip the Freemius data-sharing opt-in. If a user opts in,
Freemius may receive the opted-in administrator's name and email address,
website URL, WordPress/PHP/product versions, site language, product state, and
an optional list of installed plugins and themes. Activating a paid license
sends the license and site/product version details needed to manage activations
and deliver updates. See Freemius's privacy policy and data-practices disclosure:

* https://freemius.com/privacy/
* https://freemius.com/privacy/data-practices/
* https://freemius.com/terms/

WPGO Plugins privacy information is published at:
https://wpgoplugins.com/terms-and-conditions/#privacy

= What happens when JavaScript is unavailable? =

The server-rendered title, summary, source, and any separately placed Chart Data Table remain available.

= What happens to a Pro chart if its license is unavailable? =

ChartQuill preserves the saved chart document and semantic data. You can
explicitly convert it to the nearest Free mode, but it is never silently changed.

= Can I set a default chart colour? =

Yes. Use the colour picker under ChartQuill > Settings, or choose Clear to
inherit the theme colour. The default applies only to newly inserted charts and
never rewrites existing charts.

= Can I place the data table somewhere else? =

Yes. Select a chart, open Chart reference, and choose Insert linked data table.
The new table stays synchronized and can be moved anywhere. You can also add a
Chart Data Table directly; it connects automatically when the post has one
tagged chart, or lets you choose when several are available. Its saved snapshot
keeps publishing if the source is removed, so a table-only layout is possible.

= Does ChartQuill create demo pages? =

No. Browse the ChartQuill category in the editor's Patterns tab and insert a
starter layout only when you want one.

= Can I switch a chart to another type? =

Yes. Use Chart type in the block settings. ChartQuill preserves compatible
data, mappings, and editorial content. If the selected family needs different
fields, the editor explains what to map or correct. Unapplied data drafts do
not replace the last valid chart.

= Where can I get support? =

Free support is available through ChartQuill's WordPress.org support forum at
https://wordpress.org/support/plugin/chartquill/. Licensed customers can use
ChartQuill > Contact Us or
https://wpgoplugins.com/premium-plugin-support/ for priority email support.

= Where can I read the terms and refund policy? =

WPGO Plugins terms are at
https://wpgoplugins.com/terms-and-conditions/. ChartQuill Pro purchases use the
product-specific Freemius EULA at
https://freemius.com/plugin/34550/chartquill/legal/eula/. Its current refund
terms are linked directly at
https://freemius.com/plugin/34550/chartquill/legal/eula/#refund_policy.

== Changelog ==

= 1.2.0 =
* Added a permanent ChartQuill Home workspace with safe direct chart starters
  and reader-question guidance.
* Added polished inserter previews and reorganized every chart inspector into
  the same Data, Content, Appearance, Analysis, and Connections groups.
* Expanded the Pro Bubble chart with a richer starter, exact hover values, an
  independent size legend, and configurable direct labels.
* Added a representative Chart Data Table inserter preview and simplified
  Free/Pro editor cues.
* Restored the descriptive WordPress.org title and expanded chart-focused
  discovery copy from the unpublished 1.1.5 source snapshot.

= 1.1.4 =
* Added thin, regular, and bold line-weight choices to Free line charts.
* Added percentage or formatted-value labels to Free pie charts.
* Improved WordPress.org chart-search metadata and descriptions.

= 1.1.2 =
* Added local CSV/TSV file import with review-before-Apply safeguards.
* Added an accessible keyboard- and touch-friendly chart value explorer.
* Added Free dot plot and lollipop chart styles.
* Added Pro bullet charts, rolling-average/cumulative/indexed transforms,
  Top-N plus Other, and author-supplied uncertainty bands.

= 1.0.6 =
* Included Composer metadata, reproducible JavaScript build metadata, and the
  human-readable JavaScript/SCSS source required for open-source review.
* Documented the exact build commands and primary bundled dependency sources.

= 1.0.4 =
* Initial public-release candidate with nine Free chart styles and eleven Pro styles.
* Added paste-friendly data editing, chart references, standalone semantic tables,
  starter patterns, accessible fallback content, and responsive local rendering.
* Added professional analysis, colour, annotation, branding, and non-destructive
  entitlement behavior in ChartQuill Pro.
* Hardened production packages to exclude source-only development files.
