If you are not investing in your business, how do you expect it to grow?
   

Module: Graphing

 MODIFIED Date: 6/3/2021 |  User Level: Regular User |  Views: 265

Graphs are one of the best ways of showing analytical data to the users of your website. Below we will show you how to add/edit graph groups, graph items, and the add graphs to your website pages that you want them.

Graph Groups

A Graph Group consists of the following information:

  • Graph Name: which is used within the web pages you want to show a graph.
    • There should be no spaces in a graph name.
    • If a space exists the system will automatically remove it.
    • The graph name will automatically be converted to UPPERCASE. Even though being UPPERCASE isn't necessary it is automatically put in that format to provide consistency with using a graph on one or more of your web pages.
  • Active: This states whether the graph group is active or not. If a page calls this specific graph name and the active is not set the graph will not show. To display a graph the active checkbox must be checked.
  • Description (Short): The short description is used to display within your graph and give you a visual indicator when using the administration side for what graph you are working on. This description also shows in the Graph Items.
  • Description (Long): A longer description that can contain additional information for you or to be used within the graph.
  • Language: The language is the language for your graph page. If your site is only using one language no language will show or the language of your site will be shown.
  • Display Order: The display order is used when you use the graph calling and have multiple graphs being called. The default value for all graphs is 100 unless it has been changed from the default.
  • Header 1 through Header 12: These are the headings for the Graph Items.
    • These are typically
      • Years (2018, 2019, 2020, 2021, etc.)
      • Months (January, February, March, etc.).
      • Numbers (1, 2, 3, etc.)
    • You can have up to 12 columns in a chart. The reason for this is if you go over that the graph can be overwhelming and provide a poor user experience.
    • If a heading isn't used leave it blank and it won't show on the Graph Items page or within the graph itself on the web page.

Graph Items

Graph Items are the details to a graph. If you are using years and have you will want to fill in data for every year. You can have an unlimited number of items on a graph. We don't recommend having too many as that can provide a bad user experience just like having too many columns across would.

  • Graph Group Name: This is the graph the item is related to. The name will be what is the "Description (Short)" on the Graph Group page. This is chosen via a dropdown so you don't have to type and guess the name. If the name changes this dropdown will automatically change for you as well.
  • Active: This states whether the graph item is active or not. If a page calls a specific graph group and the item is not active the graph item will not be shown on the graph. To display a graph item the active checkbox must be checked.
  • Description (Short): The short description is used to display within your graph and give you a visual indicator when using the administration side for what graph you are working on. This description also shows in the Graph Items.
  • Description (Long): A longer description that can contain additional information for you or to be used within the graph.
  • Language: The language is the language for your graph page. If your site is only using one language no language will show or the language of your site will be shown.
  • Display Order: The display order is used when you use the graph calling and have multiple graphs being called. The default value for all graphs is 100 unless it has been changed from the default.
  • Field Values: The number that are show will vary based on the headers you have filled in on the Graph Groups page. If you only fill out three headings the Graph Item will only show three field values
    • The structure will be "Field Value (___)" where ___ is the heading for that specific heading.
    • Each field value should have a value in it. If a field doesn't have a value it is recommended to add a "0" (without quotes) to that field.

Adding Graphs to Your Webpages

You can add an unlimited number of graphs to a page.

Structure

  • The code for calling a graph starts and ends with an @ symbol.
  • The characters between should be
    • All UPPERCASE
    • Have NO SPACES
    • Have NO Non-English characters (A-Z and 0-9)
    • Example:
      • @GRAPHCHART|GRAPHNAME:COMMUNITYPATTERNS@

Available Values

The available values will vary depending on if it is part of the graph heading or part of the detail of the graph. All of the values will

    • All UPPERCASE
    • Have NO SPACES
    • Have NO Non-English characters (A-Z and 0-9)

Header & Detail Fields

  • #CHARTID#: This is a unique id the system generates for the chart. This ID will change for every graph.
  • #GRAPHNAME#: This is the "Graph Name" you defined for the graph.
  • #HEADERDESCRIPTIONSHORT#: This is the short description for the graph that is Graph Group.
  • #HEADERDESCRIPTIONLONG#: This is the long description for the graph that is Graph Group.
  • #GRAPHHEADERS#: This is the headers in a format compatible with the graphing software.
  • #GRAPHDETAILS#: These are the JSON values for the graph in a format compatible with the graphing software.

 

 

Company Partnerships

Google
Microsoft
Bing
Amazon