From wiki.ginstr.com
Jump to: navigation, search
Line 165: Line 165:
 
| title="widget style"    |
 
| title="widget style"    |
 
| title="Comment"  |  
 
| title="Comment"  |  
|-
 
| title="widget id"  | textDefault
 
| title="functional group"  | Text
 
| title="widget name"    |  [[Text default]]
 
| title="widget style"    | @style/textDefaultTextView<br>@style/textDefaultGnEditText
 
| title="Comment"  | fully customizable widget text input widget
 
 
|-
 
|-
 
| title="widget id"  | textEditable
 
| title="widget id"  | textEditable
| title="functional group"  | Text
+
| title="functional group"  | [[Text]]
| title="widget name"    |  [[Text editable]]
+
| title="widget name"    |  [[Text#textEditable|Text editable]]
 
| title="widget style"    | @style/textEditableTextView<br>@style/textEditableGnEditText
 
| title="widget style"    | @style/textEditableTextView<br>@style/textEditableGnEditText
 
| title="Comment"  | text widget
 
| title="Comment"  | text widget
 
|-
 
|-
 
| title="widget id"  | textMultiline
 
| title="widget id"  | textMultiline
| title="functional group"  | Text
+
| title="functional group"  | [[Text]]
| title="widget name"    |  [[Text multiline]]
+
| title="widget name"    |  [[Text multiline]]  
 
| title="widget style"    | @style/textMultilineTextView<br>@style/textMultilineGnEditText
 
| title="widget style"    | @style/textMultilineTextView<br>@style/textMultilineGnEditText
| title="Comment"  | read only text widget
+
| title="Comment"  | multiline text widget
 
|-
 
|-
 
| title="widget id"  | textReadOnly
 
| title="widget id"  | textReadOnly
| title="functional group"  | Text
+
| title="functional group"  | [[Text]]
| title="widget name"    |  [[Text read only]]
+
| title="widget name"    |  [[Text#textReadOnly|Text read only]]
 
| title="widget style"    | @style/textReadOnlyTextView<br>@style/textReadOnlyGnEditText
 
| title="widget style"    | @style/textReadOnlyTextView<br>@style/textReadOnlyGnEditText
 
| title="Comment"  | read only text widget
 
| title="Comment"  | read only text widget
 
|-
 
|-
 
| title="widget id"  | textNfc
 
| title="widget id"  | textNfc
| title="functional group"  | Text
+
| title="functional group"  | [[Text]]
| title="widget name"    |  [[Nfc]]
+
| title="widget name"    |  [[Text#textNfc|Nfc]]
| title="widget style"    |  
+
| title="widget style"    | @style/textNfcTextView<br>@style/textNfcGnEditText
| title="Comment"  |  
+
| title="Comment"  | read nfc tag data widget
 
|-
 
|-
 
| title="widget id"  | textBarcode
 
| title="widget id"  | textBarcode
| title="functional group"  | Text
+
| title="functional group"  | [[Text]]
| title="widget name"    |  [[Barcode]]
+
| title="widget name"    |  [[Text#textBarcode|Barcode]]
| title="widget style"    |  
+
| title="widget style"    | @style/textBarcodeTextView<br>@style/textBarcodeGnEditText 
| title="Comment"  |  
+
| title="Comment"  | read barcode data widget
 
|-
 
|-
 
| title="widget id"  | numberInteger
 
| title="widget id"  | numberInteger
 
| title="functional group"  | [[Number]]
 
| title="functional group"  | [[Number]]
 
| title="widget name"    |  [[Number#integer|Integer]]
 
| title="widget name"    |  [[Number#integer|Integer]]
| title="widget style"    |  
+
| title="widget style"    | @style/numberIntegerTextView<br>@style/numberIntegerGnEditText
| title="Comment"  |  
+
| title="Comment"  | number integer widget
 
|-
 
|-
 
| title="widget id"  | numberDecimal
 
| title="widget id"  | numberDecimal
 
| title="functional group"  | [[Number]]
 
| title="functional group"  | [[Number]]
 
| title="widget name"    |  [[Number#decimal|Decimal]]
 
| title="widget name"    |  [[Number#decimal|Decimal]]
| title="widget style"    |  
+
| title="widget style"    | @style/numberDecimalTextView<br>@style/numberDecimalGnEditText
| title="Comment"  |  
+
| title="Comment"  | number decimal widget
 
|-
 
|-
 
| title="widget id"  | numberPercentage
 
| title="widget id"  | numberPercentage
Line 229: Line 223:
 
| title="functional group"  | [[Number]]
 
| title="functional group"  | [[Number]]
 
| title="widget name"    |  [[Number#currency|Currency]]
 
| title="widget name"    |  [[Number#currency|Currency]]
| title="widget style"    |  
+
| title="widget style"    | @style/numberDecimalTextView<br>@style/numberDecimalGnEditText
| title="Comment"  |
+
| title="Comment"  | number currency widget
 
|-
 
|-
 
| title="widget id"  | locationGps
 
| title="widget id"  | locationGps

Revision as of 22:55, 23 July 2015

General app settings

Themes

Theme represents a group of resources which form visual appearance of certain ginstr app, and is declared by theme name which is unique for the app.

Theme consists of:

  • styles.xml - which provides various styles definitions for certain widgets
  • drawable folders - contain graphic which will be applied when ginstr launcher is started


When theme and shape is selected in ginstr app composer. Styles.xml will be downloaded from ginstr server for this theme into app composer folder where app is being constructed and also all drawable folders related will get copied to the same folder.


Colour

bla


Shapes

bla


Font Colours

bla

ginstr app icon

ginstr app name

Widget groups

Widget grouping is organization of widgets into categories by function they perform Groups:

group name description
Screens Contains all screen widgets. Ready to go predefined screens which can be filled with other widgets or used as is.
Menu bar top navigation menu variants which can be added to screen.
Time/Date widgets that have to do with date and time
Text textual input widgets from different sources
Number numeric input widgets
Location widgets which obtain location from various sources
Media audio, video, photo and other media widgets
Contact widgets that relate to communication
Social interaction with other apps
Audit widgets that are hidden and used for log relevant data about who made records when etc...
Relations widgets that are used to establish relation between different tables
Dropdown dropdown variation widgets that contain some predefined data
Signature signature widgets
CheckBox checkbox widgets
Reports widgets used to display data

Widgets

Widgets represent a visual control which can be added to ginstr app screens from ginstr app composer widget toolbox.
Widgets are organised in functional groups.

The following widgets are currently implemented into the ginstr app composer and fully supported by the ginstr launcher:

widget id functional group widget name style Comment
screenSave Screens Screen save entire screen layout which is ready to receive various widgets and has save button
screenNext Screens Screen next entire screen layout which is ready to receive various widgets and has next button
screenOption Screens Screen menu navigational menu which leads to more screens, ready to receive various widgets
screenLogin Screens Login screen entire screen which preforms login function with ginstr cloud
menuBarLogout Menu bars Menu bar logout menu bar that can be dropped into screen which aligns at the top and contains logout button
dateReadOnly Time/Date Date read only read only widget which displays label and date below
dateEditable Time/Date Date editable
timeEditable Time/Date Time editable
timeReadOnly Time/Date Time read only
dateTimeEditable Time/Date Date time editable
dateTimeReadOnly Time/Date Date time read only
textEditable Text Text editable @style/textEditableTextView
@style/textEditableGnEditText
text widget
textMultiline Text Text multiline @style/textMultilineTextView
@style/textMultilineGnEditText
multiline text widget
textReadOnly Text Text read only @style/textReadOnlyTextView
@style/textReadOnlyGnEditText
read only text widget
textNfc Text Nfc @style/textNfcTextView
@style/textNfcGnEditText
read nfc tag data widget
textBarcode Text Barcode @style/textBarcodeTextView
@style/textBarcodeGnEditText
read barcode data widget
numberInteger Number Integer @style/numberIntegerTextView
@style/numberIntegerGnEditText
number integer widget
numberDecimal Number Decimal @style/numberDecimalTextView
@style/numberDecimalGnEditText
number decimal widget
numberPercentage Number Percentage
numberNotNegative Number Not negative
numberCurrency Number Currency @style/numberDecimalTextView
@style/numberDecimalGnEditText
number currency widget
locationGps Location Gps coordinates
locationAddress Location Gps address
locationWifi Location Wifi position
locationBluetooth Location Bluetooth position
locationMap Location Map
locationRoute Location Route
mediaAudio Media Audio
mediaPhoto Media Photo
mediaVideo Media Video
mediaDocument Media Document
contactEmail Contact Email
contactFax Contact Fax
contactGroundLine Contact Ground line
contactSms Contact Sms
contactMobile Contact Mobile
socialSomething social Social something
auditTimestamp Audit Timestamp
auditSerial Audit Phone serial
auditUser Audit Ginstr username
auditAddress Audit Gps address hidden
auditCoordinates Audit Gps coordinates hidden @style/auditCoordinatesGnEditText widget acquires location from device and once obtained it sets the location coordinates latitude and longitude into the input box of the widget.
Location coordinates are loaded in format "latitude,longitude" , this widget is invisible
relationsDropdown Relations Dropdown relation
relationsAssignment Relations Assignment relation
relationsAutocomplete Relations Autocomplete relation
dropdownYesNo Dropdown Dropdown Yes/No
dropdownDefault Dropdown Dropdown default
dropdownGender Dropdown Dropdown Gender
dropdownRating Dropdown Dropdown rating
signature Signature Signature
checkBox Checkbox CheckBox
reportsListview Reports Listview
reportsInvoice Reports Invoice


Widget internal id's forming:

  • pageName + user input + counter (if more than one instance)
  • i.e. pageOneFirstNameLabel
  • i.e. pageOneFirstNameLabel2

Custom control id's forming:

  • "styleControl" + widgetType of control + widgettype of internal element
  • i.e. "styleControlgnEditTextButton


NOTE:

Screens - (SingleScreenSave, SingleScreenNext, Options(menu), LoginScreen,...) 
Menu bar - (combinations of menu settings)
Time/Date - (time , date , time and date, duration, today, yesterday, weekdays...)
Text - (single line , multiline, ...)
Number - (integer, decimal, precentage, not negative, currency - with sign)
Location (gps , gps address, position-wifi,bluetooth, map, route)
Media (audio , photo jpeg , photo png, video , document)
Contact (email , fix line, fax , sms, mobile phone...)
Social (intent things) 
Audit  - (timestamp hidden, serial number hidden, username hidden, gps hidden...)
Relations (assignment - not yet , dropdown, autocomplete)
Dropdown - (yes/no , etc... generic dropdown, list of allowed values, male-female, rating )
Signature
CheckBox
Reports (invoices, ListView)