Fabrik User Manual 0

• Width - The width in pixels of the chart
• Height - The height in pixels of the chart
• chds - overrides the default chart data size - enter the min and max values
required separated by a comma. If no data entered then the data passed to the
chart's min and max values are used. E.g. 0, 50
• chxl - Enter some custom axis labels, e.g. 0,10,20,30,40,50. If nothing entered
then only the min and max labels are shown
• chg - Add grid lines to the chart - e.g. 10,0,3,3 will add a dashed (3x3) grid
every ten units on the x-axis only
• chm - add specific data point labels to your form, see http://code.google.com/
apis/chart/labels.html#data_point_labels for the full explaination
• Connection - Connect up some of your existing Fabrik tables to the chart by
selecting the Fabrik connection in which they will be found
• Table - The fabrik table whose data you want to display in the chart
• Element - The element that contains the data to chart - if you have calculations
applied to any elements these will also be listed here. You can't mix calculations
and element data in the same chart.
• Legend label - A descriptive label of the data
• Colour - A hex colour (e.g. #00ff00) to use when rendering the graph
• Axis label - The element whose data will be shown on the data axis
• Axis measurement unit - E.g. 'cm', '%'
• Where - add an optional where statement to filter the data set to be plotted to
the graph - e.g. 'name="rob"' (don't include the outer quotes)
Below is an example of the output that can be generated by the chart
Map
The map plug-in lets you take data recorded by the google maps element plug-in
(available as an extra download from fabrikar.com's download section) and plot them on
a google map
106

---

107

---

• Connection - - Connect up some of your existing Fabrik tables to the map by
selecting the Fabrik connection in which they will be found
Repeatable controls
you can add and remove instances of the following controls by pressing the add and
remove buttons
• Table - The fabrik table whose data you want to display in the chart
• Bubble template - HTML template that defines the content of the bubble text
that appears when you hover over the map's markers
• Icon - select an image from /images/stories that can be used as the default
marker, if none selected then the standard google maps marker is used
• Data icon - select an image element from your table, the data from this
element will be used as the marker icon. This setting will overwrite any setting
you have selected in the Icon option
• Icon letter - Select
• Poly line element - If an element is selected then a poly line is drawn between
each of the markers ordered by this element
• Polyline width - the width (in pixels) of the polyline.
• Colour - the hex colour to use for the polyline e.g. #00ff00
• Google Map Key - Sign up for your google maps key here
http://code.google.com/apis/maps/signup.html
• Map Type - the map type to render you have
• Start Zoom Level - The start zoom level from 1 to 7
• Center map on - when the map first loads what should it center on?
◦ Middle - The middle of the markers
◦ Last marker - The last marker in the table (useful when time has an
importance on your geo data)
◦ Users location - This option will attempt to locate the user via their
browsers geolocation api. This is an opt-in choice by the user. If they
choose not to reveal their current location then the map is centered on
the middle of the markers.
Note: if a user returns to the map then it is centered and zoomed on the
last location the user was viewing.
• 3D buttons - toggle this on to use the new Google Map button styles, leave off
to use the original button styles
• Map width (px)
• Map height (px)
• Template - the template to render the map in, these can be found in
components/com_fabrik/plugins/visualization/googlemap/views/googlemap/
tmpl/
Controls
• Control - the size of control to show on the map
• Scale control - should the map contain a scale control - this shows the user at
what scale the map is being render
• Map type control - should the map contain a map type control - this allows
your users to switch between the different map types that google allows, e,g
street map or terrain.
108

---

• Overview control - this control shows a zoomed out version of the map in a
small in-line window.
Ajax Refresh
• Ajax Refresh - If yes selected then the map regularly polls the server to update
its data.
• Ajax re-centre - If yes then the map re-centres itself after each ajax refresh.
• Ajax refresh rate - the time in milliseconds between each Ajax refresh
Clustering
When you start getting large numbers of icons on a map you will see performance drop
in the map. At this point you should consider clustering. Clustering groups a series of
markers into one marker, as you zoom into the map the cluster is split until eventually
you see individual markers
• Clustering - set clustering on or off
• Cluster size split - The cluster icon size is increased at each split defined in this
comma separated list. E.g. if we have a split of 10,50 all cluster icons containing
10 or less icons will be of the same size and those between 11 and 50 will be of
a larger size.
• Cluster size increment - Specifies the number of pixels the cluster icon is
incremented each time the cluster split occurs
Below is an example of clustering in use, note the different icon sizes and the single
image above Nantes which shows an individual marker rendered with image data from
the table.
Advanced
• Maximum number of markers - Limit the number of markers that can be
shown on the map. If set to 0 or left blank then all markers are shown. If
clustering is turned on then this is the maximum number of markers BEFORE the
clustering is applied.
109

---