=== bChart – Visualize Your Data in a Few Clicks ===
Contributors: bplugins, shehabulislam, abuhayat, tomorbplugins, himur98
Tags: chart, graph, chart js, data visualization, block
Tested up to: 7.0
Stable tag: 1.0.2
Requires PHP: 7.4
Requires at least: 6.5+
Donate link: https://www.buymeacoffee.com/abuhayat
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Create interactive charts in WordPress – bar, pie, line, gauge, heatmap, candlestick & more. Import CSV/JSON, customize, and embed with a block.

== Description ==

**Turn raw numbers into beautiful, interactive charts your visitors actually understand – right inside the Gutenberg editor, no code required.**

[**bChart Block**](https://bplugins.com/products/b-chart/) | [**Live Demo**](https://bblockswp.com/demo/bar-chat-all-demo/) | [**Support**](https://bplugins.com/support/)

https://youtube.com/watch?v=X78sr-RoN5M

### Why bChart?

Data buried in paragraphs gets skimmed. **bChart** transforms your data into clear, interactive visualizations that make reports, comparisons, and trends instantly readable. Build a chart in a few clicks, style it to match your site, and publish it with a Gutenberg block or shortcode.

Choose from 9+ chart types – Bar, Pie, Line, Scatter, Radar, Gauge, Heatmap, Candlestick, Funnel, Stacked, and Grouped Bar – then fine-tune pointers, grids, legends, and typography until everything looks exactly right. Need to work with larger datasets? Import them straight from CSV or JSON files, and export finished charts as high-resolution PNG images.

Every chart is fully responsive, so your visualizations stay sharp and readable on desktops, tablets, and phones alike.

### Free Features

- **9+ Chart Types:** Bar, Pie, Line, Scatter, Radar, Gauge, Heatmap, Candlestick, Funnel, Stacked, and Grouped Bar charts.
- **Custom Dimensions:** Set chart width and height for perfect layout integration.
- **Pointer Styles:** Choose from 10+ pointer styles (Circle, Cross, Star, Triangle, and more) with custom size and hover radius.
- **Grid Controls:** Set custom grid line colors and label colors to match your site's theme.
- **CSV & JSON Import:** Effortlessly import large datasets directly from CSV or JSON files.
- **Export Capability:** Export charts as high-resolution PNG images or download data in CSV/JSON formats.
- **Manual Data Editing:** Enter and edit data directly from the Gutenberg editor.
- **Advanced Typography:** Full control over Google Fonts, font weights, and responsive font sizes for titles, labels, and legends.
- **Custom Currency Support:** Add any currency symbol ($, €, £, etc.) and format data for global financial reporting.
- **Specialized Scales:** Custom color scales and diverging palettes for Heatmaps and multi-series charts.
- **Legend Options:** Control legend position (Top, Left, Bottom, Right) and customize label colors.
- **Shortcode Support:** Place charts anywhere on your site with the easy-to-use shortcode generator.
- **Responsive Design:** All charts adapt perfectly to every device and screen size.
- **Priority Support:** Direct access to our technical support team for fast troubleshooting and feature requests.

### Pro Version

Unlock even more control with **bChart Pro**:

- **Advanced Controls:** Segments Separate, Donut & Semi-circle mode.
- **Professional Styling:** Toggle Legend, Grid & Axis for all charts.
- **Enhanced Visuals:** Customize Point Styles, Fill Area, and Curve Types.
- **Download Button:** Show/hide the chart download button in the frontend UI.
- **Animation Controls:** Full control over chart animations and speed.
- **Advanced Typography:** Custom Google Fonts and multi-device sizing.
- **Customization:** Currency Symbols and Advanced Data Editor.

### How to Use bChart – Quick Start

**With the Gutenberg block:**

1. Install and activate the **bChart Block** plugin.
2. Open a post or page in the Gutenberg editor.
3. Click the **+** icon and search for **bChart**.
4. Add the block and configure your chart settings directly inside the editor.

**With the shortcode generator:**

1. Go to **bChart → Add New Chart** in your WordPress dashboard.
2. Configure the chart to your preference.
3. Copy the generated shortcode from the chart edit screen.
4. Paste it into a shortcode block on any post or page.

### Use Cases

- **Business Reports:** Present sales, growth, and KPI data with bar, line, and gauge charts.
- **Finance & Trading:** Visualize market data with candlestick and heatmap charts.
- **Marketing Funnels:** Show conversion stages with funnel charts.
- **Surveys & Research:** Compare results with pie, radar, and stacked bar charts.
- **Blogs & Publications:** Make data-driven articles easier to read and share.

### Check Out Our Other WordPress Plugins

🔥 **[Html5 Audio Player](https://audioplayerwp.com/)** – Best audio player plugin for WordPress.

🔥 **[Html5 Video Player](https://wpvideoplayer.com/)** – Best video player plugin for WordPress.

🔥 **[PDF Poster](http://pdfposter.com/)** – A fully-featured PDF Viewer Plugin for WordPress.

🔥 **[StreamCast](https://wordpress.org/plugins/streamcast)** – A fully-featured Radio Player Plugin for WordPress.

🔥 **[3D Viewer](https://3d-viewer.bplugins.com/)** – Display interactive 3D models on the webs.

== Installation ==

**From your WordPress dashboard (recommended):**

1. Go to **Plugins → Add New**.
2. Search for **"bChart"**.
3. Click **Install Now**, then **Activate**.
4. Add the **bChart** block to any post or page, or go to **bChart → Add New Chart** to generate a shortcode.

**Manual installation:**

1. Upload the plugin folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Use the shortcode in any page, post, or widget.
4. To embed in theme PHP, place `<?php echo do_shortcode('YOUR_SHORTCODE'); ?>` in your template.

== Frequently Asked Questions ==

= Is bChart free to use? =
Yes, bChart offers a powerful free version with essential chart types. A Pro version with advanced styles and features is also available.

= Does it work with the Gutenberg block editor? =
Absolutely! bChart is built specifically for the Gutenberg editor, allowing you to create and customize charts visually.

= Are the charts responsive? =
Yes, all charts generated by bChart are fully responsive and adapt to any screen size, including mobile and tablets.

= How do I add a chart to my page? =
Simply search for the "bChart" block in the Gutenberg editor, or use the generated shortcode in any post or page.

= Which chart types are included? =
bChart includes Bar, Pie, Line, Scatter, Radar, Gauge, Heatmap, Candlestick, Funnel, Stacked, and Grouped Bar charts.

= Can I import data from a CSV or JSON file? =
Yes. You can import large datasets directly from CSV or JSON files, and you can also export chart data in CSV/JSON formats or download charts as high-resolution PNG images.

= Can I use a chart outside the block editor? =
Yes. Create a chart under bChart → Add New Chart, copy its generated shortcode, and paste it anywhere shortcodes are supported – pages, posts, or widgets.

== Screenshots ==

1. Bar Chart Preview
2. Bar Chart Settings One
3. Bar Chart Settings Two
4. Bar Chart Settings Three
5. Bar Chart Settings Four
6. Pie Chart Preview
7. Pie Chart Settings One
8. Pie Chart Settings Two
9. Line Chart Types: MultLine/Single
10. Line Chart Settings One
11. Line Chart Settings Two
12. Line Chart Settings Three
13. Scatter Chart Preview
14. Scatter Chart Settings One
15. Scatter Chart Settings Two
16. Radar Chart Preview
17. Radar Chart Settings One
18. Radar Chart Settings Two
19. Gauge Chart Types
20. Gauge Chart Settings One
21. Gauge Chart Settings Two
22. Funnel Chart Types: Horizantal/ Vertical
23. Funnel Chart Settings One
24. Funnel Chart Settings Two
25. Heatmap Chart Preview
26. Heatmap Chart Settings One
27. Heatmap Chart Settings Two
28. Candlestick Chart Types: Candlestick/Hollow
29. Candlestick Chart Types: HLC/OHLC
30. Candlestick Chart Types: Heikin-Aswhi/Line
31. Candlestick Chart Types: Area
32. Candlestick Chart Settings One
33. Candlestick Chart Settings Two

== External Services ==

This plugin connects to the following external services from the admin dashboard:

= bPlugins API =

* **Service URL:** [https://api.bplugins.com](https://api.bplugins.com)
* **Purpose:** The plugin's admin dashboard fetches product comparison data and pricing information to display relevant upgrade options and feature details.
* **Data Sent:** Only the plugin slug is transmitted; no personal or site data is collected.
* **Terms of Service:** [https://bplugins.com/terms-of-service/](https://bplugins.com/terms-of-service/)
* **Privacy Policy:** [https://bplugins.com/privacy-policy/](https://bplugins.com/privacy-policy/)

= WordPress.org Plugins API =

* **Service URL:** [https://api.wordpress.org/plugins/info/1.2/](https://api.wordpress.org/plugins/info/1.2/)
* **Purpose:** The admin dashboard queries the official WordPress.org Plugins API to retrieve and display a curated list of other plugins by the same author ("Our Plugins" section).
* **Data Sent:** Plugin slugs and author name; no personal or site data is collected.
* **Terms of Service:** [https://wordpress.org/about/tos/](https://wordpress.org/about/tos/)
* **Privacy Policy:** [https://wordpress.org/about/privacy/](https://wordpress.org/about/privacy/)

== Third-Party Libraries /  bpl-tools ==
* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made

== Changelog ==

= 1.0.2 =
* Added 9 new Premium bChart Styles.
* Added ShortCode.
* Added Admin Dashboard.

= 1.0.1 =
* Added Pie Chart Option
* Improved Settings Panel
* More organized Options
* Added new Screenshots
* Fix mirror issues

= 1.0.0 =
* Initial Release

== Upgrade Notice ==

= 1.0.2 =
This version includes new premium styles, admin dashboard improvements, and shortcode support. Please update for the best experience.