Birthday widgets
From SpinetiX Support Wiki
Description
The birthday widgets are all based on data feed widgets present within Elementi Library which were adapted for this particular case of displaying dates of birth, using different data (e.g., local CSV file, remote CVS file, inline data) and different layouts (ticker or slideshow).
To use any of these widgets, download the widget and drag & drop the 7-zip file into your Elementi project. Further details about how to configure them can be found below.
- Category: Data feeds
- Author: SpinetiX S.A.
- License: GPL Version 3
- Target: Elementi
Birthday Ticker
This widget displays a text ticker with the name and birth date of one or more persons extracted from a local CSV file (the sample birthdays.csv included with the widget refers to US presidents).
To change the data, open the "birthdays.csv" file within a text editor and edit the names and birth dates. Note that these must be enclosed between quotes and separated by commas, and the date format (i.e. yyyy-mm-dd) must be respected.
The CSV file can be moved / saved on a web server or be generated on the fly by a third-party system. In both cases, make sure to enter the new file location under Data source > URI property.
Configuration
The widget options / properties are the same as for the CSV Text Ticker widget.
The CSV parser is set to extract the "Name" and "Birthday" items from the first two columns of the CSV source file and these are used within the "Text template" property (i.e. [[Name]]: [[Birthday>LONG_DATE]]) as data layout placeholders. Note that the birth date is formated according to the specified locale - for instance, to display just the month and day, use a format like [[Birthday>d MMM]].
Inline Birthday Ticker
This widget is a variation of the Birthday Ticker widget, having the data to be displayed included directly inside the widget.
To change the data, simply go to the "Data" tab (within the Edit panel) and insert / delete / change the names and birthdays accordingly. The date format (yyyy-mm-dd) used for the birthday should be respected.
Configuration
The widget options / properties are the same as for the CSV Text Ticker widget, except for the "Data source" option.
The "Name" and "Birthday" items are used within the "Text template" property (i.e. [[Name]]: [[Birthday>LONG_DATE]]) as data layout placeholders. Note that the birth date is formated according to the specified locale.
Birthday Slideshow
This widget displays a slideshow containing the picture, name, birth date and a description of one or more persons extracted from a remote CSV file (the sample http://download.spinetix.com/.../physicists.csv used by the widget refers to some well-known physicists).
To change the data, either save & edit the "physicists.csv" file within a text editor, or create a CSV file having the same structure. Note that the fields must be enclosed between quotes and separated by commas, the order of fields must be respected (otherwise, some changes are required within the widget) and the date format (i.e. yyyy-mm-dd) must be respected. The new CSV file can be saved within the project or on a web server, or be generated on the fly by a third-party system. In all cases, make sure to enter the new file location under Data source > URI property.
Configuration
The widget options / properties are the same as for the CSV Slideshow widget.
The CSV parser is set to extract the "Name", "Birthday", "Picture" and "Description" items from the first four columns of the CSV source file; these are used as data layout placeholders within the widget layers. Note that the birth date is formated according to the specified locale.
Custom Birthday Ticker
This widget displays a text ticker with the name and birth date of one or more persons extracted from a remote CSV file. The sample http://download.spinetix.com/.../physicists.csv used by the widget refers to some well-known physicists - it can be replaced with your own CSV file having the name and the birthday (written as yyyy-MM-dd) of the person on the first two fields.
This widget is a variation of the Birthday Ticker widget, having a custom script parser applied on the birthday field in order to generated two extra fields:
- DayOfYear
- The index of the birth date within the current year. The data set can be ordered by this field, thus disregarding the year of birth.
- DaysLeft
- The number of days left until that birthday. This field is used by default within the "Text template" property. It can also be used to order the data set according to the next birthdays to come, thus disregarding the year of birth.
Configuration
The widget options / properties are the same as for the CSV Text Ticker widget.
The CSV parser is set to extract the "Name" and "Birthday" items from the first two columns of the CSV source file and these are used within the "Text template" property (i.e. [[Name]]: [[Birthday>LONG_DATE]] ([[DaysLeft]] days left)) as data placeholders. Note that the birth date is formatted according to the specified locale - for instance, to display just the month and day, use a format like [[Birthday>d MMM]].