Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

See Active Forms List section for more information.

 

stars Data Suitcases

...

Stars Data Suitcases

They use a combination of a stored XML file and Blink-starrable style sheet 

 

To create a "Starred" list, article or form, you must add the Blink-starrable style sheet to your interaction. 

 

This can be achieved by adding it to your code either as part of of some HTML or in the second parameter of your fetch rows command.

 

The Blink-starrable style sheet allows you to add a link reference of your interaction result to a stored XML document held locally.

 

When an item is "Starred" a record is entered into the XML document. Besides the primary reference you can also add additional variables for storage and use in your favourites page. This page usually will display all the "Starred" items within the answerspace for easy retrieval and if required "de-Starring".

Code Block
themeRDark
languagephp
titleSample 1
linenumberstrue
collapsetrue
$t->rows("|<h2><a href=\"/{URL}\" title=\"{TITLE}\">~*<div class=\"field-item odd\">{TEASER}</div>~*<img src=\"{THUMB}\" |U",
"My output and containers built from the body in the code builder....
<span class=\"blink-starrable\"
data-type=\"OBJECTITEM\"
data-DATYPE=\"PLACES\"
data-id=\"{URL}\"
data-NAME=\"{TITLE}\"
data-URL=\"../visitor_details/?\"
data-ARGS0=\"{URL}\"
data-ARGS1=\"{TITLE}\"
data-ARGS2=\"{IMAGE}\"
</span>");

Blink-starrable style sheet

The Blink-starrable style sheet consists of several parameters.

 

Parameter

Description   

span-type: 

must stay as "blink-starrable".

 data-type: must stay as "OBJECTITEM".
 data-DATYPE:

can be a unique string to identify the type of interaction results. You may have for example "PLACES" for search results scrapped from a travel site and maybe "SITES" from

a scrap of a websites search. This reference is needed when searching stored results in the XML document and acts as the XML entity.

data-id: 

is the reference to interaction or results. This usually is a "Container" {mycontainer} from the rows retrieval. Its a link back to the result normally a url or a title and is the suede primary key.

Important. While urls are great to use, if they contain special characters it may break the starring and cause fault results. I recommend using the results title or name instead.

data-____: can be strings for storing types of field data. You may want to store all the containers scrapped from your rows fetch for later usage even as shown a link to the details interaction in the listing example.

For more information on "Starring" download the Data Suitcases - Step by Step.pdf

Info
titleNOTE

STARS Data Suitcases were designed for BIC2 only are are not longer supported.

 

 

Data Suitcases and mADL

...