Contact Us

Selecting & Formatting Widgets

widgets.png

A widget is a user-selected exhibit component that performs a particular function. Widgets can be added to Home pages, Feature pages, and About pages.

Exhibit creators can add both standard widgets and exhibit item widgets.

Adding widgets to your exhibit

To add a widget on a Home page, Feature page, or About page, navigate to your dashboard and select the page you wish to edit from the Curation sub-menu. Click on the Edit option.

If you are already on the page you wish to edit, you can simply click the red Edit button at the top right corner of the page.

Once you are editing the page, click on a grey "+" to reveal a new undefined widget. Next, click on the red "+" to the left of the widget to open up the widget menu, then select the widget you would like to add from the widgets listed.

The video below shows how to add a widget to your page.

Formatting widgets

Most widgets with a text component allow the user to modify the text format (bold/italic), or add or remove hyperlinks. Double-click the text to access a pop-up menu, then select one or more of those options. (Note: triple-click the text to apply a format modification or hyperlink to the entire block of text.)

Please note that not all text components are enabled in this way.

Example formatting.png

Aa : boldface

Aa : italic

Link icon : add hyperlink

Remove Link icon : remove hyperlink

H1 : Converts widget into Heading widget.

“ : Converts widget into Quote widget.

Entering paragraphs and line breaks

Some widgets come with a textarea input field (a text input with space for entering multiple lines of text). Although you can use the Enter and Shift+Enter keys to create line breaks and multiple paragraphs in the textarea input field, these breaks are not always retained when the page is saved and displayed.

To reliably create line breaks in text entered in any widget's textarea, do not use the Enter key. Instead, at the end of the line where you want to create a line break, select the Shift+Enter key combination twice in succession. After you save the page, each block of text is displayed as a separate paragraph.

Advanced: formatting widgets using Markdown

Markdown is a way to style text on the web. You control the display of the document; formatting words as bold or italic and creating lists are a few of the things we can do with Markdown. Mostly, Markdown is just regular text with a few non-alphabetic characters thrown in, like # or *.

Syntax guide

Here’s an overview of Markdown syntax that you can use with the text widget on Spotlight. NOTE: This has not been tested fully in Spotlight yet, so some of the syntax may not work as expected. Some Spotlight widgets let you use Markdown; other Spotlight widgets don’t. You’ll have to experiment to see what works.

Headers

You can optionally add up to six levels of headings with Markdown:

Headers.png
Emphasis (Bold/Italics)

Although you can generally format text in Spotlight using the context menu, as noted above, you can also add emphasis (bold or italics) using Markdown.

Emphasis.png
Ordered Lists

To create an ordered list, type a number followed by a period and a space at the start of the line, then type your text. When you get to the end of the line, use Shift + Enter to move to the next line, otherwise you will be taken to a new widget window. Enter subsequent items for your list in the same way. Markdown will assign the appropriate numbers to your list, starting with number "1," no matter what numbers you enter; you can enter "22" for all of them and it will still number it properly. In the example below, all items have been entered with number "1." To create a sub-item, type two spaces before the number. It works best to create ordered lists in their own text widget and not with any other text.

Ordered lists.png
Unordered Lists

To create an unordered list, type an asterisk, plus sign, or minus sign followed by a space at the start of the line, then type your text. When you get to the end of the line, use Shift + Enter to move to the next line, otherwise you will be taken to a new widget window. Enter subsequent items for your list in the same way. To create a sub-item, type two spaces before the asterisk, plus sign, or minus sign. It works best to create unordered lists in their own text widget and not with any other text.

Unordered list.png
Links

Although you can generally format hyperlinks in Spotlight using the context menu, as noted above, you can also format links using Markdown. First type the text you would like to be hyperlinked, enclosed in square brackets, and then after that text include the URL for the link, enclosed in parentheses or round brackets. It shouldn't matter whether there is a space between the text and the URL.

Links.png

Moving widgets

You can reposition a widget within a given page by dragging the widget by the drag-and-drop icon (the six grey dots in the top right corner). You can also reposition a widget by clicking on that icon -- a repositioning menu will appear.

Screen Shot 2018-09-07 at 2.40.57 PM.png
Drag the widget by the drag-and-drop icon to reposition it
Screen Shot 2018-09-07 at 2.43.17 PM.png
You can also click on the drag-and-drop icon to access a widget repositioning menu
Screen Shot 2018-09-07 at 2.43.03 PM.png
Select a position number to in order to reposition the widget

Deleting widgets

You can delete a widget by clicking on the "x" to right of the widget. You will be asked to confirm the deletion. Warning: Once you have confirmed deletion, this action cannot be undone.