Listbox

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
Sample 'announcements' 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. From the top menu, choose Add Content >> Right Column Items >> Listbox Folder (if this asset is not available to you, please contact your Web Manager)
  3. Replace the default Folder Name (lowercase, no spaces) then 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.
  4. Select the file named Listbox and click Edit.
  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 the Custom header text field.
    Note that Headers are auto-capitalized.
  6. For the Listbox type field, select the type of pages that are to be listed in this listbox. Your choices are Announcements, Stories, Features, Feed and custom. 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.
    • 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:  use the following Feed URL and replace "calendarname" with your event calendar's short name:  https://events.wm.edu/calendar/upcoming_rss/calendarname
  8. Please be aware that Feed listboxes offer realtime content updates and should only be connected to a trusted source.
  9. Select the maximum number of items you want to appear in your listbox.
  10. You can opt to show a brief summary of Announcements/Stories/Features/Feed items (when provided) by choosing "Yes" for the 'Show item summary' field.
  11. Enter Custom more link text if desired.
    The default text is "More."
  12. All listbox types can have a 'view more link.' For Announcements/Stories/Features listbox types, use the page chooser under Internal 'more' page and select the index file (listing page) of the applicable listing folder. For Feed listbox types enter a page address in the provided External 'more' page field.
  13. Click Save & Preview >> Submit >> Check Content & Submit.
  14. For Announcements/Stories/Features listbox types only, select and edit the file named 'blockofcontent.'
  15. 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.
  16. Publish your listbox folder.
An Events listbox on a page
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, click "Choose Page" to browse to the Listbox file and select it then click Choose.
  4. Save & Preview >> Submit >> Check Content & Submit then 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.