Configuring Bento Searches & Creating Bento Pages

Configuring bento searches is a multi-step approach that requires the setting up of your search and the page display of the search results, as well as the enabling of the Bento search option for your primary search bar. 

Configuring Bento Searches

If your bento search will include the ability to search from an external source or provider via an integration, ensure the integration is configured as required in the Integrations tile of the Dashboard.

1. From the Dashboard, click Search Configuration
2. Click Bento, then click Custom Bentos
3. Click the Custom EDS Bentos tile
4. Click + Add Custom EDS Bento
   1. Label, enter a name for the search
   2. Facet Filters, allows you to identify how your search results can be "pre-filtered", either by source, content provider, or by subject.
      1. Source Type
         1. Search Facets, enter a name for the search, example: magazines or books
         2. Click Search
            1. From the returned results, select the value(s) to search
      2. Content Provider
         1. Search Facets, enter a name for the search, example: magazines or books
         2. Click Search
            1. From the returned results, select the value(s) to search
      3. Subjects
         1. Search Facets, enter a name for the search, example: magazines or books
         2. Click Search
            1. From the returned results, select the value(s) to search
   3. Click Save

Enabling a Bento Search

Once the bento search has been configured, you can enable the bento search option in your primary search bar at the top of your Stacks page. 

1. From the Dashboard, click Search Configuration, then Settings
2. Scroll to the Bento Search option, click Edit on the right
3. In the window that opens
   1. Display Label, if needed, change the name of the search as it will be displayed
   2. Bento drop-down, if more than one bento has been created, select the page to use
   3. Show Search Page drop-down, if multiple bentos are available a drop-down will be displayed allowing the user to select the bento search to use
   4. Enable Bento, this must be selected prior to beginning creating bento pages
   5. Tooltip Text, add optional helper text to display as a tooltip to your users
   6. Click Save

Create Bento Pages

The final step in configuring bento searches is to create the page(s) that users will see their search results on. Bento pages are typically configured to display multiple boxes of these "pre-filtered" results in way that is easy for users to narrow into specific content they may be looking for. 

1. From the Dashboard, click Search Configuration, then Bento
2. Click Bento Pages
3. Click Add New
4. Complete the fields in the window that opens
   1. Title - enter a title for the bento page
   2. Language - select the language
   3. Body - enter a small narrative explaining the bento page
   4. Update the Publishing workflow if needed
5. Click Save
   1. You will be returned to the list of Bento pages
6. Under the Operations column, click Edit beside the Bento page you just created
7. Click the Layout tab near the top of the screen
   1. You will be taken to a page similar to the Layout Builder for your Stacks site, here you can configure the sections and blocks that will display the bento search results
8. Click +Add section
   1. A window will appear on the right
      1. Select from the One column, Two column, or Three column layout options
         
         1. Administrative label - add an optional label that will only appear in the top left corner of the section when viewing the page in this layout viewer
      2. Click Add section
9. Click + Add Block within any of the section(s) you may have added to begin adding the block content
   1. In the window that opens, under the Bento Block section, click Add a Bento Block
   2. Heading, add a heading or title for the block
      1. Example: Magazines or Books
   3. Subheading, optional
   4. Bento Subtitle URL, optional
   5. Bento Type, select the search type from the drop-down
   6. Additional options
      1. Depending on the search type, additional configuration options may be displayed below, these could include: 
         1. Limit results
         2. Enable pagination (recommended when searches could return a large number of results)
         3. Results per page
         4. Filters