amCharts: Charts and Maps

Allows to easily add interactive charts and maps using amCharts libraries.

Author:	amCharts (profile at wordpress.org)
WordPress version required:	3.5
WordPress version tested:	6.5.2
Plugin version:	1.4.3
Added to WordPress repository:	28-02-2014
Last updated:	12-04-2024
Rating, %:	100
Rated by:	29
Plugin URI:
Total downloads:	84 859
Active installs:	3 000+
Click to start download

Important disclaimer

This plugin loads JavaScript libraries from external amCharts CDN which is a free service provided by amCharts.

amCharts provides their libraries completely free without any caps to functionality on a sole condition, that small contribution is automatically displayed on all chart produced by amCharts library. The contribution comes from amCharts libraries/service and is not added by this plugin.

What is it?

Ever tried getting JavaScript content into your WordPress posts or pages? Yeah, that’s impossible. WP strips down all
the JavaScript.

This makes adding JavaScript Charts and Maps a hassle.

Developed and maintained by amCharts staff, this plugin solves the problem by allowing you to create chart code snippets, that then subsequently can be inserted into the
posts or pages as a shortcode. (helpful button in TinyMCE is also there)

You can also use a built-in PHP function to invoke the chart anywhere in your template:

<?php amcharts_insert( $chart_id ); ?>

The plugin has also many helpful functions:

Easy switching between CDN-hosted or local chart/map libraries storage
Setting defaults per chart type
Automatically locating installed libraries and available resources

Screenshots
FAQ

Does this plugin work with the free/commercial versions of amCharts libraries?

Yes. You can either set the plugin to use publically available libraries loaded from www.amcharts.com or from your local server.

Which version of amCharts library does the plugin use?

Plugin will use amCharts 5 when installed anew. You are able to switch between versions in plugin’s settings.

Will I be able to visually edit settings and data?

No. This plugin allows editing a code directly in WordPress admin as well as inserting the charts into posts or pages using shortcodes.

It’s not a fully fledged chart/map editor. It’s a plugin designed to get your chart/map code into WordPress easily.

Do I need to include any JavaScript libraries in my theme code?

Nope. The plugin will take care of that for you. The required JavaScript libraries will be included in the footer of the page automatically.

Plugin will include only those libraries that are actually required to render the chart. If no charts are there on the page, no additional libraries will be included.

Let’s keep the footprint small 😉

Can I insert a chart directly from my PHP code rather than shortcode?

Yes. Use the following PHP code:

<?php amcharts_insert( $chart_id ); ?>

Or, you can retrieve the chart object using following function:

<?php amcharts_get( $chart_id ); ?>

This will return an object with the following properties:

title – a chart title
post – a reference to original WP post object
resources – a list of resource urls
html – HTML code
javascript – JavaScript code

Can I pass custom parameters to chart code via shortcode?

Yes, starting from version 1.0.7.

Any parameter prefixed with “data-” will be passed into chart code via global AmCharts.wpChartData object.

I.e.:

[amcharts id="pie-1" data-file="data1.csv" data-sort="asc"]

The above shortcode will insert the following code before actual chart code:

AmCharts.wpChartData = {
  "file": "data1.csv",
  "sort": "asc"
}

You can then reference those passed variables in your chart code. I.e.:

alert( AmCharts.wpChartData.file );

Are there any filters available?

Yes:

amcharts_shortcode_data ( $data – parsed data passed in via data-* parameters of the shortcode, $atts )
amcharts_shortcode_resources ( $resources – text data from resources box, $atts )
amcharts_shortcode_libs ( $libs – array of resouces, $atts )
amcharts_shortcode_javascript ( $javascript – JavaScript portion of the chart, $atts )
amcharts_shortcode_html ( $html – HTML portion of the chart, $atts )

Is this plugin WPML-compatible?

Yup. It fully supports WPML. You can create language-specific versions of the charts and maps. The plugin will automatically select proper language when displaying it.

Hide FAQ

ChangeLog

Choose right WordPress plugin from thousands others in a moment

Important disclaimer

What is it?

1.4.3

1.4.2

1.4.1

1.4

1.3

1.2.3

1.2.2

1.2.1

1.2

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

1.0