Skip to content

Collection Spotlight#

Use a Catalog Widget to recommend a long list of titles in a blog post or on a web page.

block image 1

Note about lists in Aspen#

Lists in Aspen have three options:

  • Private: Can be seen only by the user that created it within their My Account page.
  • Public: Can be shared via URL but otherwise will be same as Private; e.g., https://catalog.library.nashville.org/MyAccount/MyList/63302
  • Show in Search Results: This option is only available if the list is marked 'Public' and the user has an elevated permissions.

'Show in search results' lists, aka searchable lists, will appear in the scoped collection 'Lists':

  • They are what you search when you choose 'in Lists.' Searchable lists will also appear in the Explore More widget.
  • Finally, searchable lists will appear in the 'Appears on list' field of a record:

Create Catalog Spotlight in Library Catalog (Using a List)#

  1. Go to https://catalog.library.nashville.org.

  2. Create a list. If you already have a list, skip this step.

  3. Go to the lists page:

  4. Click the user icon in the upper right. block image 1

  5. Select “lists” from the menu. block image 1

  6. On the list page, click the Edit button. block image 1

  7. On the edit screen, mark the list public. Your list must be public to create a catalog spotlight. block image 1

  8. Once your list is marked public, you have the option to include or exclude the list from search results. Select yes or no, then click Update to save your changes. block image 1

  9. After saving your changes, you’ll see “create spotlight” at the top of your list. Click “create spotlight.” block image 1

  10. You’ll be asked to give your spotlight a name. We recommend naming the spotlight the same as your list so the spotlight and list titles match. IMPORTANT! Your spotlight title must have less than 50 characters. block image 1

  11. On the next page, we need to customize the widget. Click Edit. block image 1

  12. Fill out the following fields:

  13. Name: If you need to edit the spotlight name, do it here. The name must be less than 50 characters. block image 1

  14. Description: Add a note about where the spotlight is used. If you’re adding to a blog post, type something like “spotlight for newbery winners blog post 2015.” block image 1

  15. Number of Titles: Default is 25, which is generally a good number. You can make this smaller if you like. block image 1

  16. Uncheck the next three boxes. We do not want to show the title, author, or ratings for titles. block image 1

  17. Style When Displaying List Featured Titles: Choose Horizontal Carousel. block image 1

  18. Cover Size to Use: Choose Medium. block image 1

  19. Custom CSS File: Copy this URL into field.

    https://assets.library.nashville.org/css/aspen-widgets-update-view-all.css

  20. Cover Size to Use: Medium block image 1

  21. For the next two boxes: Uncheck “show the display's title bar.” But DO check “show the view more link.” block image 1

  22. Display Mode for Search Results: Choose Covers. block image 1

  23. Click Save Changes and Return. block image 1

  24. Scroll down until you can see the “Collection Spotlight with Resizing” code. Copy ONLY the iFrame URL -- this is the URL in the blue box above the iFrame code. You do NOT need the entire iFrame code snippet. You only need the URL, like the example highlighted below. block image 1

  1. Go to https://catalog.library.nashville.org.

  2. Do a search.

  3. If you do a search AND you’re logged in to your account, Create Spotlight will be at the bottom of the screen, just above the footer.

  4. Click “create spotlight.”

  5. You’ll be asked to give your spotlight a name. We recommend naming the spotlight the same as your list so the spotlight and list titles match. block image 1

  6. On the next page, we need to customize the spotlight. Click Edit. block image 1

  7. Fill out the following fields:

    1. Name: Give your spotlight a name. block image 1

    2. Description: For description, specify who created the list it’s based on, and when it was created, and where this spotlight will be used (home page, Books Movies Music). For example: List created by Jane Librarian, for Blog post on library website: The Twelve Days of YA Reading, Dec 2020. block image 1

  8. Number of Titles: Default is 25, which is generally a good number. You can make this smaller if you like. block image 1

  9. Uncheck the next three boxes. We do not want to show the title, author, or ratings for titles. block image 1

  10. Style When Displaying the Featured Titles: Choose Horizontal Carousel. block image 1

  11. Cover Size to Use: Choose Medium. block image 1

  12. Custom CSS File: Copy this URL into field.

    https://assets.library.nashville.org/css/aspen-widgets-update-view-all.css

  13. Cover Size to Use: Medium block image 1

  14. For the next two boxes: Uncheck “show the display's title bar.” But DO check “show the view more link.” block image 1

  15. Display Mode for Search Results: Choose Covers. block image 1

  16. Click Save Changes and Return. block image 1

  17. Scroll down until you can see the “Collection Spotlight with Resizing” code. Copy ONLY the iFrame URL -- this is the URL in the blue box above the iFrame code. You do NOT need the entire iFrame code snippet. You only need the URL, like the example highlighted below. block image 1

Add the Collection Spotlight to the Website#

  1. Add the Catalog Widget component to your post. block image 1

  2. Fill out the form: block image 1

    1. Title and iFrame Title: The type title for your widget that will display to the user.
    2. iFrame URL: Paste the iFrame URL from the spotlight code in catalog. Add &myLang=es at the end of the URL. It should look something like this:
      https://catalog.library.nashville.org/API/SearchAPI?method=getListWidget&id=99&resizeIframe=on&myLang=en
    3. iFrame Title: Use the same title in both the Title and iFrame Title fields.
  3. Review and verify that the everything looks correct. If anything looks weird, check your spotlight settings in catalog (where you set up the spotlight).

Find the List or Saved Search that Populates a Widget#

  1. Go to https://catalog.library.nashville.org.
  2. Log in using the List Admin account.
  3. Select Pika Configuration.
  4. Select List Widgets.
  5. Search for the list that appears on the BMM page.
  6. Click in the empty text box under Description.
  7. Paste in one of these searches (see above) and search:
    1. children's books movies music page
    2. teen books movies music page
    3. adult books movies music page
  8. Note the List Title and List ID or Saved Search ID.
  9. You’ll need the List Title if you want to add titles to the list.
  10. You'll need the List ID or the Saved Search ID to easily find the list and remove items.

Remove Titles from a Widget List#

  1. Go to https://catalog.library.nashville.org.
  2. Log in using the List Admin account. If you do not know the List Admin account number, contact Shared Systems.
  3. Copy this URL into your browser and replace insert-list-id with the List ID number you pulled from the widget description: https://catalog.library.nashville.org/MyAccount/MyList/ insert-list-id. You can also go to My Lists and look for the list by name.
  4. Select Edit.
  5. Remove titles by clicking Delete on the far right of each item block.

Add Titles to a Widget List#

  1. Go to https://catalog.library.nashville.org.
  2. Log in using the List Admin account. If you do not know the List Admin account number, contact Shared Systems.
  3. Search for a title.
  4. When you locate the title, click the Add to List button.
  5. Select the list from the drop down menu.
  6. Save.
  1. Go to https://catalog.library.nashville.org.
  2. Log in using the List Admin account. If you do not know the List Admin account number, contact Shared Systems.
  3. Search for a topic and apply filters.
  4. Enter.
  5. If the search looks good and is returning the type of titles you expect, click Save Search at the bottom of the screen.
  6. In the left menu, select My Account > Search History.
  7. Copy the search ID for the search you just saved (it will be at the top).
  8. Select Pika Configuration.
  9. Select Catalog Spotlights.
  10. Find the widget you need to update and select Edit.
  11. In the Source field at the bottom of the widget, replace the search ID with the new number. It should say source:xxxxxx where x is the new number.
  12. Save changes.
  13. Go to the BMM page where the widget lives and make sure the changes took effect as expected.

Update 5-Tab Widget on the Homepage#

  1. Create your new list in Pika with lists account.
  2. Locate the existing 5-tab widget:
  3. Go to https://catalog.library.nashville.org.
  4. Log in with lists account
  5. Click on Pika Configuration
  6. Select Catalog Spotlights
  7. Find “Drupal Home Page - 5 Format Catalog Widget”
  8. Edit the existing Drupal Home Page - 5 Format Catalog Widget.
  9. Swap out one of the old lists for the new lists by updating the list number.
  10. There is no need to edit anything on Drupal. Your list should automatically update on Drupal.
  11. Double check the homepage to verify the widget updated correctly.

Widget Settings#

home page components