menu
William and Mary
search

Listboxes

How to build one and where to put it.

An example 'features' listboxListboxes are right-column boxes that share characteristics of both listing pages and widgets. Similar to listing pages, listboxes produce a formatted, clickable list of the items in a listing folder. However, rather than listing ALL of the items in the folder, listboxes show 1 to 10 items (your choice). Similar to widgets, listboxes can be placed in the right-hand column of any page(s).

Need to put an existing listbox on your page? Skip to Step 2.

Step 1: Build the Listbox
  1. Select the folder where your listboxes are stored. Often sites will have a root folder named "_listboxes." If not, you may need to create an empty folder for storage and name it appropriately.
  2. Select New >> Listbox Folder (if this asset is not available to you, please contact your Web Manager)
  3. Replace the default System Name (lowercase, no spaces), un-check the Display in Menu box, and Submit. A "listbox folder" with two files will be created for you. The files will be called 'Listbox' and 'blockofcontent'  - be sure you do NOT delete these.Sample 'announcements' listbox.
  4. Select the file named Listbox and click the Edit tab.
  5. Create a header (title) for your listbox one of two ways:
    • Prebuilt: Select a "pre-built" Header Text Option
    • Custom: Select "(custom)" for Header Text Option, enter text in Custom Header Text field and select a Custom Header Text size.
    Note that Headers are auto-capitalized.
  6. For the Type field, select the type of pages that are to be listed in this listbox. Your choices are Announcements, Stories, Features, and Feed. Feed supports RSS and Atom feed types as well as Twitter (event listboxes use this feed type). Feeds display in date order. The rest use folder order.
  7. For Feed type listboxes only, enter an address in Feed URL. The address can usually be obtained by clicking on the orange RSS icon on the blog or the calendar site.
    • For Twitter:  put in just your Twitter username, with no "@" or other URL information, for example "wm_creative" (without the quotes).
    • For W&M Events:  get the Feed URL by right clicking on your calendar's RSS link and selecting 'copy link location'
    Please be aware that Feed listboxes offer realtime content updates and should only be connected to a trusted source.
  8. Again for Feed type listboxes only, you can opt to show a brief summary of the article below the title and date by choosing "Yes" for the 'Show item summary' field.
  9. All listbox types can have a 'view more link.' For Announcements/Stories/Features listbox types, use the page chooser labled Internal 'View More' Link Destination and select the index file (listing page) of the applicable listing folder. For Feed listbox types enter a page address in the provided External View More Link Destination field.
  10. Enter custom View More Link Text if desired. The default text varies per school but is typically "View More>>" or "More..."
  11. Submit your edits to the Listbox file.
  12. For Announcements/Stories/Features listbox types only, select and edit the file named 'blockofcontent.'
  13. Locate the field labeled 'Index Folder', click on the default link provided to activate the file browser to select the Folder of files to be listed in your listbox. Click Confirm. An Events listbox on a page.
  14. Publish your listbox folder.

 

Step 2: Put the listbox on a page
  1. Select and edit the page where you want to place the listbox
  2. Check the box next to 'Show Right Column?'
  3. Under the Listboxes section, use the [ ] to browse to the Listbox file and select it. Confirm.
  4. Submit and Publish.

Troubleshooting
Why doesn't my Listbox show up on a published page?

Listboxes need to be published separate from the page(s) that contain them. Make sure that your Listbox folder is published.

I entered a custom text header but it is not showing up?

Edit the Listbox and make sure that "(custom)" is selected for Header Text Options. Republish.

Why does the listbox only show "Loading..." for my feed?

Make sure that the feed URL you have provided is valid by checking it using the W3C Feed Validation Service.