README

感谢您尝试使用 CakePHP 2.* 的高图表插件！

请注意，此插件仍在开发中，目前仅提供通过 Highcharts 库复现图表的基本功能。随着您发现更好的做法并向我发送 pull requests，将添加更多功能并改进现有功能。

请将您的评论和建议发送至 d3stinydriv3n[at]gmail.com

如果您只想快速查看此插件的特性，演示可在以下地址查看

http://destinydrivenlive.com/highcharts/high_charts/high_charts_demo

使用方法

将插件部署到您的 app/Plugin/HighCharts 目录。如果您使用 Git，在应用目录中运行以下命令

git init
git submodule add git://github.com/destinydriven/cakephp-high-charts-plugin.git Plugin/HighCharts
git submodule init
git submodule update

或者访问 http://github.com/destinydriven/cakephp-high-charts-plugin，并手动将其下载到您的 app/Plugin/HighCharts/ 文件夹。

从 CakePHP 2.0 开始，需要在您的应用程序中激活插件。为此，编辑 app/Config/bootstrap.php 并在底部添加行 CakePlugin::load('HighCharts');。如果您已经添加了 CakePlugin::loadAll();，则可以跳过此步骤。

完成。检查插件中包含的演示图表，以了解如何生成各种图表。在浏览器中打开演示

[your app root]/high_charts/high_charts_demo

请首先查看“极简演示”，了解如何在您的项目中快速设置 Highcharts 插件。极简演示还演示了主题使用，您可以通过在您的 $params 数组中指定键来向图表添加预定义的自定义设置

    'chartTheme' => 'dark-blue'  // other options are 'skies', 'grid', 'gray', 'dark-green'

在您的 setChartParams() 调用中。

其他示例提供了大量自定义选项，您可能不需要一开始就处理。

将 Highcharts 实现到您的应用程序中，只需将 Highcharts 组件添加到您的控制器中。（请参阅示例以获取更多详细信息）

public $components = array('HighCharts.HighCharts');

通过包含组件，HighCharts 辅助函数将自动对视图可用。

特殊依赖说明

此插件依赖于 jQuery (https://jqueryjs.cn)，因此您需要确保它在您想要显示图表的布局或视图中已加载。如何在布局中加载 jQuery 的示例在以下位置可用

HighCharts/View/Layouts/chart.demo.ctp

<?php
	...

	echo $this->Html->script(array('https://ajax.googleapis.ac.cn/ajax/libs/jquery/1.8.2/jquery.min.js'));

	...

	echo $this->fetch('script');
?>

当然，您也可以从您的 app/webroot/js 文件夹中获取 jQuery 库的副本，如下所示

<?php
	...

	echo $this->Html->script(array('jquery.min'));

	...

	echo $this->fetch('script');
?>

重要

此插件与 CakePHP 1.3.* 版本不兼容。

此插件已在 CakePHP 2.3.2 上进行测试，至今没有问题。

贡献

如果您想做出贡献，请克隆 GitHub 上的源代码，进行更改，并向我发送 pull request。如果您无法修复问题，请创建一个工单，我们将看看接下来会发生什么。

致谢

显然，此插件使用了 Highcharts Free，它可以从 http://www.highcharts.com/ 免费获取，用于非商业用途。

此插件还使用了HighRoller（一个针对Highcharts的对象化PHP包装器）http://www.highroller.io/ HighRoller还可在GitHub上找到，并采用Apache 2.0许可证。 https://github.com/jmaclabs/HighRoller

特别感谢

• Lecterror（《https://github.com/lecterror》）为创建此插件提供了灵感
• Jigzstar（《https://github.com/jigzstar》）让我了解了Highcharts。
• Tigrang（《https://github.com/tigrang》）在改进Highcharts助手方面提供了帮助

其他资源

查看HighRoller的README文件（插件供应商文件夹）可能会有所帮助，以更好地了解其工作原理。此外，如果您想扩展此插件，一个好的开始是查看Highcharts API参考 http://www.api.highcharts.com/highcharts/

许可证

多许可证下

• MPL 《http://www.mozilla.org/MPL/MPL-1.1.html》
• LGPL 《https://gnu.ac.cn/licenses/lgpl.html》
• GPL 《https://gnu.ac.cn/licenses/gpl.html》
• Apache许可证，版本2.0 《https://apache.ac.cn/licenses/LICENSE-2.0.html》