Inserting widgets


This tutorial assumes you already read the tutorial about how to set up a basic Silk site and the tutorial about tagging and linking

Step 1: create some content

Widgets are interactive overviews that display data that it retrieves from your pages. So make sure you have created some pages, gave them a page type and created a number of tags. If you are not sure how to do this, read the two tutorials mentioned above. 

Step 2: choose a widget type

Think about the kind of widget you want to insert. Silk currently supports the following widgets to display your data:

It is easiest to start with a table. After you inserted your widget, you can switch between most widget types, so your choice is not definitive. Some Silk widgets cannot be customized and fall outside the scope of this tutorial: recent documentstable of contentstag board and the tag counter

Step 3: choose a page category

In the dialog that appears on the right, select the page category that you would like to use for this widget. If you created a number of pages with page category Person, you may choose this page category to have all Person pages displayed in this widget. If you chose the table widget, you will see a table with all the persons appear. 

Step 4: add tags

Every tag you add, can be used as a data source for your widget. You can start adding tags by clicking "Display a tag" in the dialog on the right. Remove tags by clicking the X next to the tag name in the overview. 

For example, if you insert the table widget and want to create an overview of Person pages, select Person as the page category. You may have used some tags, such as Birthdate and Height. Adding these tags to the overview will make them appear as columns when you are working with a table. 

Step 5: configure

You can now configure your widget in the three following ways. 


You can sort the overview by clicking "Sort By" next to a tag name. You will see an arrow appear. Click this arrow to change the order in which the overview is ordered. 


You can filter your data by clicking "Refine" below the tag name. Based on the type of the tag, you will see different options appear. Labels such as BetweenEquals and Contains can be clicked to select a different matching type. By clicking Refine, the visualization will only include pages that contain this tag. To remove the filter, close the filter box using the small X. 


The options menu in the dialog on the right provides specific options for the widget type you selected. Adjusting these options is often required to make the widget display the data you want. To learn more about the options for the widget of your choice, click on the widget name in step 2.