Описание
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.
Related links:
* Free usage terms / license of the amCharts library
* amCharts privacy policy
What is it?
Вы когда-нибудь пытались получить содержимое JavaScript в своих сообщениях или страницах WordPress? Да, это невозможно. WP разбивает все на
JavaScript.
Это упрощает добавление графиков JavaScript и карт.
Этот плагин, разработанный и поддерживаемый персоналом amCharts, решает эту проблему, позволяя создавать фрагменты кода диаграммы, которые затем могут быть вставлены в сообщения
или страницы в виде шорткода. (полезная кнопка в TinyMCE также есть)
Вы также можете использовать встроенную функцию PHP для вызова диаграммы в любом месте вашего шаблона:
<?php amcharts_insert( $chart_id ); ?>
Плагин также имеет множество полезных функций:
- Простое переключение между хранилищем CDN или локальным хранилищем диаграмм / карт
- Установка значений по умолчанию для каждого типа диаграммы
- Автоматическое определение установленных библиотек и доступных ресурсов
Скриншоты
Установка
Используйте страницу WordPress Plugin для поиска и установки плагина amCharts.
Если вы решите установить вручную, убедитесь, что все файлы из загруженного архива помещены в каталог сайта / wp-content / plugins / amcharts /
Часто задаваемые вопросы
-
Работает ли этот плагин со свободными / коммерческими версиями библиотек amCharts?
-
Да. Вы можете установить плагин для использования общедоступных библиотек, загруженных с сайта www.amcharts.com или с вашего локального сервера.
-
Какая версия amCharts библиотек используется в плагине?
-
Плагин будет использовать amCharts 4 при обновлении. Вы можете переключаться между разными версиями в настройках плагина.
-
Смогу ли я визуально редактировать настройки и данные?
-
Нет. Этот плагин позволяет редактировать код непосредственно в администраторе WordPress, а также вставлять диаграммы в сообщения или страницы с использованием шорткодов.
Это не полноценный редактор диаграмм / карт. Это плагин, разработанный для того, чтобы легко получить код диаграммы / карты в WordPress.
-
Нужно ли включать какие-либо библиотеки JavaScript в свой код темы?
-
Нет. Плагин позаботится об этом для вас. Необходимые библиотеки JavaScript будут включены в нижний колонтитул страницы автоматически.
Плагин будет включать только те библиотеки, которые действительно необходимы для отображения диаграммы. Если на странице нет графиков, дополнительные библиотеки не будут включены.
Давайте оставим след небольшим;)
-
Могу ли я вставить диаграмму непосредственно из кода PHP, а не с помощью шорткода?
-
Да. Используйте следующий код PHP:
<?php amcharts_insert( $chart_id ); ?>Или вы можете получить объект диаграммы, используя следующую функцию:
<?php amcharts_get( $chart_id ); ?>Это вернет объект со следующими свойствами:
- title — название диаграммы
- post — ссылка на исходный объект WP
- resources — список URL-адресов
- html — HTML-код
- javascript — код JavaScript
-
Могу ли я вставить пользовательские параметры в код диаграммы с помощью шорткода?
-
Да, начиная с версии 1.0.7.
Любой параметр с префиксом «data-» будет передан в код диаграммы через глобальный объект AmCharts.wpChartData.
Т.е.:
[amcharts id="pie-1" data-file="data1.csv" data-sort="asc"]Вышеупомянутый shortcode вставляет следующий код before до фактического кода диаграммы:
AmCharts.wpChartData = { "file": "data1.csv", "sort": "asc" }Затем вы можете ссылаться на эти переданные переменные в вашем графическом коде. То есть.:
alert( AmCharts.wpChartData.file ); -
Существуют ли какие-либо фильтры?
-
Да:
- amcharts_shortcode_data ( $data — данные переданные через data-* parameters of the shortcode, $atts )
- amcharts_shortcode_resources ( $resources — текстовые данные из массива, $atts )
- amcharts_shortcode_libs ( $libs — массив resouces, $atts )
- amcharts_shortcode_javascript ( $javascript — JavaScript часть диаграммы, $atts )
- amcharts_shortcode_html ( $html — часть HTML диаграммы, $atts )
-
Является ли этот плагин совместимым c WPML?
-
Да. Он полностью поддерживает WPML. Вы можете создавать языковые версии диаграмм и карт. Плагин автоматически выберет правильный язык при его отображении.
Отзывы
Участники и разработчики
«amCharts: Charts and Maps» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
Перевести «amCharts: Charts and Maps» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
1.4.6
- Tested up to WP 7.0.0.
1.4.5
- Fixed a cross-site scripting vulnerability with chart previews. (CVE-2024-8622)
- Tested up to WP 6.6.2.
1.4.4
- Fixed a PHP warning.
- Tested up to WP 6.6.1.
1.4.3
- New setting: «User capabilities». Allows setting which capabilities must a user have in order to be able to edit charts.
- Ciontributor role users are now not allowed to create charts by default. Changeable in Settings.
- Tested up to WP 6.5.2.
1.4.2
- Tested up to WP 6.5.
1.4.1
- Minor XSS vulnerability fixed.
1.4
- Tested up tp WP 6.1.
- Added amCharts 5 support.
1.3
- Chart popup will now open faster since it uses built-in «thickbox» and in-line code rather than
<iframe>. - Some PHP warnings has been fixed in debug mode.
- Plugin now uses CodeMirror library bundled with WP if available.
1.2.3
- CodeMirror dependency is no longer included in all Admin pages, just the ones that are related to amCharts.
1.2.2
- Fixed error of passing in data via «data-» shortcode parameters when V4 is enabled.
1.2.1
- Prevent Chart code to be executed multiple times in case some plugin was causing shortcodes to be processed twice.
1.2
- Добавлена поддержка amCharts 4 с переключением между двумя версиями amCharts
1.1.6
- CodeMirror обновлен до последней версии
- Проверенна совместимость с WP 4.9.2
1.1.5
- Пример фиксированной диаграммы
1.1.4
- Made some changes so that plugin can be translated more easily
- Added Lithuanian translation
1.1.3
- Fixed warnings in WP debug mode
1.1.2
- Local reseource list refresh was omitting theme files
1.1.1
- Fixed minor PHP7 incompatibility
1.1
- Added WPML support
1.0.19
- Filters now are applied to various parts of the chart inserted via shortcode
1.0.18
- Fixed unnecessary loading of resource list from amcharts.com on every request
- Introduced option to use relative resource URLs (available in Settings)
- Remote resources now use «//» protocol prefix so that it inherits either http or https depending on what the website uses
1.0.17
- Decode values of «data-*»» attributes passed in from shorcode
1.0.16
- Fixed an error passing data that had «=» in it
1.0.15
- Fixed an error passing data to using «data-*» parameters on newer WPs
1.0.14
- Added oEmbed support for https-enabled Live Editor URLs
1.0.13
- Change «%CHART%» meta code to «$CHART$» so that code is valid JavaScript. (old syntax still works)
- Tweaks for better support of settings page markup according to WP 4.4 specs
- Cleaned up default chart templates (will affect only new installs)
1.0.12
- Added support for WP installs with non-standard directories
1.0.11
- Fixed a critical error after upgrade
1.0.10
- Resources tab can now include .css files
1.0.9
- Added GANTT chart type support
1.0.8
- Resource list now contains amCharts plugins
1.0.7
- Added an option to wrap all chart/map code into exception try/catch block
- Added ability to pass in custom parameters via shortcode
1.0.6
- Fixed a warning that was being displayed if WordPress debug mode was enabled
1.0.5
- Fixed a bug that was causing resource list to break on some PHP setups
1.0.4
- Added an option to use self-hosted (commercial) amCharts libraries with embedded Live Editor charts
1.0.3
- Chart insert window now shows recent chart first with ability to live-search all available charts
- Chart shortcodes will now be inserted using user-friendly slug instead of id
- Added ability to insert and embed charts created with Live Editor
1.0.2
- Added a way to preview the chart while editing it
- Added ability to enter a user-friendly slug/ID for the chart to be used in shortcodes
- Fixed potential conflicts of the same libraries included from different locations on the same page
1.0.1
- Shortcode column was showing for all post types
1.0
- Первый релиз