amCharts: Charts and Maps

Описание

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 или локальным хранилищем диаграмм / карт
  • Установка значений по умолчанию для каждого типа диаграммы
  • Автоматическое определение установленных библиотек и доступных ресурсов

Скриншоты

  • Plugin configuration. Either use amCharts-hosted free libraries or your own. Set default code per chart/map type.
  • Easily create new charts or maps using presets right from the Admin menu.
  • Modify resources, HTML or JavaScript portion of the chart. Or apply defaults right from the edit screen.
  • Insert chart easily into body of the post or page using button from the rich editor tool belt. The charts are inserted as Wordpress shortcodes.
  • Select from the available charts or maps. No coding required.
  • Embed a chart created in Live Editor directly into your posts or pages.
  • Диаграммы шорткодов заменяются фактическими диаграммами при отображении страницы.

Установка

Используйте страницу 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. Вы можете создавать языковые версии диаграмм и карт. Плагин автоматически выберет правильный язык при его отображении.

Отзывы

04.04.2022 3 ответа
Yes, you need to work a little harder to get things going than with other plugins, but the output is so much better! I can't imagine a diagram that can't be done with Amworks. Keep up the great work 🙂
09.02.2022 1 ответ
I have used this plugin almost 7 years ago and that time I was stacked for somewhere and I asked for help, plugin author @martynasma helped me. I was very glad to him but I forgot to review. This 5 star for you. Thanks man.
25.11.2021 1 ответ
Perfect Chart Plugin
07.01.2018 1 ответ
Very powerful plugin, complete charts ever, clear documentation, nice UI, easy customisation. Keep up the good work..
23.08.2017 1 ответ
I used the free version of this at first, was able to create the chart and most importantly, use the dataloader to load some REST API web services I had created. They look and feel good, and the users really dig the charts!
Посмотреть все 29 отзывов

Участники и разработчики

«amCharts: Charts and Maps» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

Перевести «amCharts: Charts and Maps» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

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

  • Первый релиз