{% load i18n %}

{% trans "Cards Tab" %}

{% trans "Overview" %}

 

{% blocktrans %}In this tab you will configure the user-facing aspects of your graph. There are multiple levels to doing so, which are reflected in the levels of the graph tree. Report Configuration where you choose the template for the resource report, Card Configuration where you'll specify card-related settings, and the Widget Manager where you will choose and configure the data entry widget for each node in the graph.{% endblocktrans %}

{% trans "Report Configuration" %}

 

{% blocktrans %}Each Resource Model must be configured with a report template. Reports show data for all nodes in a resource instance for which the user has Read permissions.{% endblocktrans %}

{% trans "No Header Template" %}

{% blocktrans %}Lists all node data, no special header at the top of the page.{% endblocktrans %}

{% trans "Image Header Template" %}

{% blocktrans %}Use this template for Resource Models that will be be primarily used to record images.{% endblocktrans %}

{% trans "Included Image Nodes" %} {% blocktrans %}Choose one or more nodes that hold images in this Resource Model. These images will be presented as a slideshow in the report header.{% endblocktrans %}
{% trans "Map Header Template" %}

{% blocktrans %}Use this template for Resource Models that will be be primarily used to record resources that have a geo-location. There are number of settings you should fill out to control the appearance of the map in the header.{% endblocktrans %}

{% trans "Map Controls" %} {% trans "Choose whether or not the user has access to the Map Tools." %}
{% trans "Position" %} {% blocktrans %}You can set the position by panning the map. On report load, the map will automatically pan and zoom to the resource geo-location if there is one (also see Default Value below). Pitch values are 0-60 (higher = more oblique), Bearing values can be positive or negative (270 faces west; -180 faces south). Use ctrl + click then pan the map to change Pitch and Bearing.{% endblocktrans %}
{% trans "Zoom" %} {% blocktrans %}Zoom levels go from 0 (zoomed out) to 20 (zoomed in). On report load, the map will automatically pan and zoom to the resource geo-location if there is one.{% endblocktrans %}
{% trans "Geocoder" %} {% blocktrans %}Configure which geocoding service the address search bar will use, and whether or not to show the bar at all.{% endblocktrans %}
{% trans "Resource Properties" %} {% blocktrans %}Configure some styling options for how the resource appears on the map.{% endblocktrans %}
{% trans "Default Value" %} {% blocktrans %}Choose whether the map should zoom to the resource geo-location if available or the geo-location of the user.{% endblocktrans %}

{% trans "Card Configuration" %}

 

{% blocktrans %}The settings for Cards are mostly related yo how you want a user to see the card, but some have a more direct bearing on data structure as well. The preview shows what the card will look like to users.{% endblocktrans %}

{% trans "Card Type" %} {% trans "Choose the Card Component to use. Only the Default Card is available initially, but custom Card Components are a way for developers to enhance the user experience." %}
{% trans "Card Title" %} {% blocktrans %}Users will see this title when performing data entry.{% endblocktrans %}
{% trans "Subtitle" %} {% blocktrans %}Users will see this subtitle when performing data entry.{% endblocktrans %}
{% trans "CSS Classes" %} {% blocktrans %}You can add your own CSS classes to this Card to customize its look and feel. Define these classes in your project's "package.css" file.{% endblocktrans %}
{% trans "Make Card Visible" %} {% blocktrans %}Show this Card by default. Developers could hide a card initially, and show it based other variables.{% endblocktrans %}
{% trans "Allow Multiple Values" %} {% blocktrans %}While certain node data types allow the storage of multiple values in a single node, "concept-list" for example, this setting is how you control cardinality at a higher level. When determining whether or not to use this setting, we recommend testing out the resource editor interface directly.{% endblocktrans %}
{% trans "Enable Card-level Help" %} {% blocktrans %}To aid data entry users when using this Card, you may want to add some extra guidance. Enable setting to do so, and design the content of this guidance with the Card-Level Help menu.{% endblocktrans %}

{% trans "Widget Management" %}

 

Widgets are data entry helpers for each node that collects information; it's often easier to pick a date from a calendar than to type it in, for example. Generally, the data type of the node will determine which Widget template is used. However, in some cases you will have a choice: For example, in the case of a concept node, you can choose a dropdown menu or a set of radio buttons. Similarly, for a string node you can choose a basic text box or a rich text editor.

Depending on the Widget, there are more settings you can configure, most of which are optional and all come with acceptable defaults.

Common Settings
{% trans "Widget Label" %} {% trans "This will be used in the user interface. The default label comes from the node name." %}
{% trans "Template" %} {% blocktrans%}The list of available Widgets is determined by the node's data type, though developers can create new Widgets.{% endblocktrans %}
{% trans "Placeholder" %} {% blocktrans %}Shown in the input area before the user has entered anything.{% endblocktrans %}
{% trans "Default Value" %} {% blocktrans %}If desired, you can define a default value.{% endblocktrans %}
Other Settings by Widget
{% trans "map-widget" %} {% trans "The map widget allows for a good deal of customization, from the default center and zoom level to default layers." %}
{% trans "datepicker-widget" %} {% blocktrans%}This widget is used for the normal date data type, not the extended date/time format data type. You can set minumum or maximum dates, change how specific the calendar is when user first opens it, or set the display of the date. However, note that real YYYY-MM-DD dates are stored in the database whether no matter what display format you have chosed for this widget. So if you have set YYYY for the Date Format and a user enters "2005", then "2005-01-01" will be saved in the database.{% endblocktrans %}