前言介紹
- 這款 WordPress 外掛「Blazing Charts」是 2015-09-01 上架。
- 目前有 200 個安裝啟用數。
- 上一次更新是 2018-03-23,距離現在已有 2599 天。超過一年沒更新,安裝要確認版本是否可用。以及後續維護問題!
- 外掛最低要求 WordPress 3.0.1 以上版本才可以安裝。
- 有 4 人給過評分。
- 還沒有人在論壇上發問,可能目前使用數不多,還沒有什麼大問題。
外掛協作開發者
外掛標籤
maps | graph | charts | morris.js | highcharts |
內容簡介
8221;, “$my_class->my_method”, or “[my_function]”.
“width”:
The third parameter specifies the width of the chart. This parameter is optional and the default value is “100%”.
“height”:
The forth parameter specifies the height of the chart. This parameter is optional and the default value is “300px”.
Please note that this plugin does not support using more than one charting library in the same post or page.
原文外掛簡介
We are not going to re-invent the wheel, and this plugin is not going to give you another charting library. This purpose of this plugin is to let you get the most out of charting libraries that already exist and are awesome. There are many of them out there, and most of them are free. Many of the other commercial libraries are free for a personal or non-profit project, or have a free branded version, which may have a small link to their website.
Here is a list of libraries currently added to the collection. If you know another charting library, compatible with GPL license, please inform us to add it.
HighCharts.js: The library used (disabled by default) is a free version with a small link to their website, and can be used if the user’s site opts in to link. This plugin does NOT substitute HighCharts terms of use. HighCharts use is free for a personal or non-profit project under the Creative Commons Attribution-NonCommercial 3.0 License.Please refer to HighCharts license page http://shop.highsoft.com/highcharts.html to check the HighCharts precise license conditions.
Morris.js
ZingChart: The library used (disabled by default) is a free branded version, and can be used if the user’s site opts in to link. This plugin does NOT substitute ZingChart terms of use.Please refer to ZingChart license page https://www.zingchart.com/buy/details/branded-license/ to check the ZingChart precise license conditions.
Chart.js
Google Charts: by loading Google’s JSAPI library loader remotely (as a service), and then using it to load the visualization library and other packages
D3.js
Chartist.js
Smoothie Charts
Flot Charts
Please refer to the license page of a library you want to use to check the precise license conditions.
What does this plugin do?
This plugin allows you to create chart code snippets, which can be inserted into the posts or pages by using the shortcode of “BlazingChart”.
Another scenario is you have a function, defined in another plugin or in your theme, which extracts data from database and produces the scripts for the chart. Then you can give the name of that function as a parameter to the shortcode, so the function is called and the output of that function will be inserted in the page.
The “BlazingChart” shortcode can have up to 4 parameters:
“charttype”:
The first parameter of that shortcode tells which Charting library you want to use. At the moment the value of this parameter can be one of these:
highcharts: for HighCharts.js
morris: for Morris.js
zingchart: for ZingChart
chartjs: for Chart.js
google: for Google Charts
d3: for D3.js
chartist: for Chartist.js
smoothie: Smoothie Charts
flot: for Flot library
Other than Google Charts which does not have a local version of library, all the other libraries are included in this plugin. Some of them are hosted on a CDN as well. So by changing the settings, you can easily switch between remote or local chart/map libraries.
“source”:
The second parameter specifies the user-friendly slug of the chart snippet as the source of script and data for the chart.
“function”:
If a function, defined in another plugin or in the theme, is going to produce the data and script for the chart, the name of that function can be given as the value of this parameter. This value can be not only a function name, but also other types of callbacks, like “Foo::method”, “array(‘Foo’, ‘method’)”, or “array($obj, ‘method’)”.
“options”:
Some of the charting libraries are just a single file. But others, like Flot, are divided to a main library and several auxiliary libraries, to make it lighter and more efficient. By using this parameter, you can give a comma separated list of auxiliary libraries of the main library to load. Here is the list of options for each library:
HighCharts.js: more, 3d, exporting
D3.js : pie, nvd3
Chart.js : bundle
Flot Charts : colorhelpers, canvas, categories, crosshair, errorbars, fillbetween, image, navigate, pie, resize, selection, stack, symbol, threshold, time
How Charting libraries are used?
To include JavaScript files efficiently, none of these libraries are enqueued, until the shortcode of “BlazingChart” appears in a post or a widget. The plugin loads only one of these libraries, specified by “charttype” parameter. Moreover, to load the page faster, that library is loaded in the footer.
You can also use a built-in PHP function to invoke the chart anywhere in your template:
“name of one of the aforementioned charting libraries”,
“source” => “slug of the chart snippet”,
“options” => “auxiliary libraries to load”
);
// call the function to invoke the shortcode handler
blazing_charts_insert($patts);
?>
As always, there are exceptions:
To reduce the size of the libraries loaded for Google Charts, that library decides which portions of the library to be included, depending to the type of the chart. So the link to the CDN library must be included at the top of the script, saved in the chart snippet.
How To use this plugin:
Although theoretically you can have various charts in a single page, drawn by more than one charting library, it is advisable not to do that. These libraries may conflict with each other, and may not get any of the charts drawn properly. Just make sure in every page, only one of those libraries is included.
Every chart has two major parts: first a container, specified by a