=== ChartQuill ===
Contributors: dgwyer
Tags: charts, data visualization, gutenberg, graph, accessibility
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Write with data using publication-ready, accessible charts built directly in WordPress.

== Description ==

ChartQuill is a professional charting toolkit for creating clear, compelling
visual stories in WordPress. From a simple comparison to a detailed report, it
makes sophisticated chart creation feel at home in the block editor.

Choose a chart, add or paste your data, and shape the result with purposeful
controls for mapping, formatting, colour, and presentation. ChartQuill keeps
the data with the block and renders responsive, accessible charts that feel
native to the article, report, or page around them.

No iframe, hosted chart service, or front-end CDN is required. Your charts
remain editable in WordPress, 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.
* 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 point size.
* A guided sample start plus one spreadsheet-like editor with direct CSV/TSV
  paste, 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.
* 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 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.

* Eleven professional chart styles, including stacked and 100% stacked bars, Likert, waterfall, area, trend, bubble, box plot, and donut charts.
* Deeper analysis with 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.
* 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.
3. Optionally choose the default colour for new charts under ChartQuill > Settings.
4. Add a chart family from the ChartQuill category and choose its style in the block.
5. Replace the sample by typing or pasting in the grid, 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. Rank categories with a readable horizontal bar chart.
3. Compare multiple series side by side with grouped vertical bars.
4. Compare multiple series with grouped horizontal bars.
5. Show change over time with a multi-series line chart.
6. Explore relationships between two measures with a scatter chart.
7. Show the distribution of numeric values with a histogram.
8. Reveal patterns across two dimensions with a color-scaled heatmap.
9. Show part-to-whole proportions with a labeled pie chart.
10. Type or paste data in one grid, then map fields.
11. Insert a synchronized accessible table, then place it wherever the story needs it.
12. Start with a polished opt-in editorial layout.
13. ChartQuill Pro adds advanced chart forms and presentation tools.

== Frequently Asked Questions ==

= Which chart styles are included? =

Free includes vertical and horizontal single/grouped bars, line, scatter,
histogram, heatmap, and pie. Pro adds stacked and 100% stacked bars in both
orientations, 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? =

Before the WordPress.org listing is approved, use
https://wpgoplugins.com/contact-us/ for ChartQuill questions. After approval,
Free support will also be available through ChartQuill's WordPress.org support
forum. 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.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.
