=== MaxiCharts Gravity Forms Source add-on === Contributors: munger41 Tags: gravity, forms, chart, chartsjs, graph, graphs, visualisation, survey, MaxiCharts, maxicharts, entry, stats, visualization, HTML5, canvas, pie chart, line chart, charts, chart js, plugin, widget, shortcode Requires at least: 4.0 Tested up to: 4.8 Stable tag: 1.0 Extends MaxiCharts to chart Gravity Forms data. == Description == Extends MaxiCharts to chart Gravity Forms data with a simple shortcode. Requires free [MaxiCharts](https://wordpress.org/plugins/maxicharts/ "MaxiCharts") plugin. And of course Gravity Forms. [>> Demonstration site <<](https://maxicharts.com/ "Demonstration") ### Usage ### Use the post visual editor brand new button to add the as many shortcodes as you want in a few clics ! the shortcode is `[gfchartsreports gf_form_id="form_id" include="fieldNb1,fieldNb2,fieldNb3,.." exclude="fieldNb4,fieldNb5,..." color_set="set" type="graphType" width="width(px|%)" float="true|false" chart_js_options="options"]` where all parameters are optional: * *gf_form_id* : expects the **form ID** in Gravity Forms (defaults to first form : id=1) * *type* : is the type of graph, at the moment only **line,pie,doughnut,bar,horizontalBar** available (defaults to pie) * *include* : expects the **field ids** to include (example : `include="1,3,4"`) * *exclude* : expects the **field ids** to exlude (example : `exclude="2,4,6"`) * *colors* : to use your custom colors : a list of [coma separated hex colors](https://maxicharts.com/custom-colors/) * *color_set* : expects the name of the color set : **blue,green,red,orange,purple** (defaults to a standard color set including different colors) * *color_rand* : expects **true or false** and randomizes colors in color set if true (defaults to false) * *width* : set width of graph(s) in pixels or percent (**width="100%"** or **width="250px"**), height will be adjusted automatically * *position* : (defaults to none) can be **float** (sets `float:left` property to graph div container, and allow multiple column display) or **center** (to center graphs inside container) * *maxentries* : by default, maximum 200 entries are retrieved from the gravity forms database, increase at your own risk (performances) * *chart_js_options* : JSON like string like : **title: {display: true, text: 'My Funky Chart Title'}**. Use **'** to surround string parameters. [See here](http://www.chartjs.org/docs/#chart-configuration-creating-a-chart-with-options) for more informations * *tooltip_style* : Control tooltip content, SUM displays total count of answers, PERCENT the % ratio among all answers, and BOTH displays both :) * *data_conversion* : Set to "%" in order to convert in % all values. Previous parameter *tooltip_style* is disabled in this case. * *case_insensitive* : set it to "true" in order to count form answers values in a case insensitive way. For ex. : *mYAnswer* and *myansWER* will be count as same user answers. * *custom_search_criteria* : provide [custom search criteria](https://www.gravityhelp.com/documentation/article/api-functions/#get_entries) for gf submission query, for example **custom_search_criteria='{"status":"active","field_filters":{"0":{"key":"created_by","value":"current"}}}** ### Examples ### Display all fields of form #1 as pie charts with custom [chartjs options](http://www.chartjs.org/docs/#chart-configuration-creating-a-chart-with-options) for titles: `[gfchartsreports chart_js_options="title: {display: true, text: 'My Funky Chart Title', fontSize:28,fontFamily:'Arial',fontColor:'#00B88A',fontStyle:'bold',padding:20}"]` Displays fields 4, 7 and 18 of gravity form #3 with bar charts. Default colors used. `[gfchartsreports gf_form_id="3" include="4,7,18" type="bar"]` Displays field 2 of gravity form #2 with default pie chart. Use red color set, with not randomization. `[gfchartsreports gf_form_id="2" include="2" color_set="red"]` Displays all but fields 4,7,18 of gravity form #8 with horizontalBar type charts. Use blue color set, randomized. `[gfchartsreports gf_form_id="8" exclude="4,7,18" color_set="blue" color_rand="true" type="horizontalBar"]` Test it live here : [>> Demonstration site <<](https://maxicharts.com/ "Demonstration") == Installation == ### Easy ### 1. Search via plugins > add new. 2. Find the plugin listed and click activate. 3. Use the Shortcode == Screenshots == == Changelog == * 1.2.3 - can sum list fields as well * 1.2.2 - skipping HTML fields * 1.2.1 - other logger categories * 1.2 - log fix * 1.1 - monolog replaced log4php * 1.0 - module extraction