Skip to main content
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Summon: Administration Console: Custom Panel Sections

    • Product: Summon

    How do we configure custom panel sections to display in Summon?

    This is part of a larger set of documentation about using the Administration Console to configure your Summon service.


    The Custom Panel Sections page in the Administration Console allows you to create custom blocks of text that display on the right side of the Summon results page. You can use these panels to display library-specific information, Twitter feeds, and so forth. For additional information and examples, see What kinds of things can a library put in Summon Custom Panels?.
    In the following example, a custom panel displays the upcoming library closures in all Summon search results.
    CP_CustomPanel_In_Summon.png

    Custom panels are not supported on mobile devices. For a workaround, see Display Custom Panels on Mobile Summon Site.

    Custom panels can be tagged to appear when a user's query matches tag words that are defined by the library for each item, or they can be configured to display by default.

    Custom panels appear below Topic Explorer Content when Topic Explorer items are returned in the results.

    To access the Custom Panel Sections Page:
    1. Log on to the Client Center.

    2. Select Summon Administration Console.

    3. Select the Pages tab.

    4. Select the Custom Panel Sections tab.

    Create a Custom Panel Section

    To create a new custom panel section:
    1. Click the Custom Panel Sections tab under the Pages tab to open the Custom Panel Sections page.

      CustomPanelSectionsPage.png

    2. In the Add New Section area, specify the following information in the new panel section:

      1. In the Section Heading box, enter a display title for the custom panel. The title can contain up to 80 characters, which must be text only.

        It is not recommended to use the same title for panels.

      2. In the main text box, enter the text (maximum of 1000 characters) that you want to display in the panel. This field does not support HTML, but you can use the tool bar above the main text box to apply character formats (such as bold and italics), paragraph formats (such as headings, paragraphs, and alignment settings). In addition, the tool bar allows you to perform editing functions such as cut, copy, and paste.

      3. If you want to add HTML, CSS, or JavaScript to your panel, select Tools > Source code. The Source Code dialog box opens with the text that has already been entered in the main text box. There is a 2048 maximum character limit for content in the body of a custom panel section. The following example includes HTML and CSS to format the three paragraphs:

        CP_AddSourceCode.png

        Consider the following when adding JavaScript:

        • jQuery is readily available for use within the Summon UI and does NOT need to be pulled in.

        • DOM elements within a custom section may not be rendered before JavaScript is run. Clients should use the setTimeout function when referencing DOM elements within a custom section.

        • Because the Summon UI heavily utilizes the $ alias for jQuery throughout the application, do not call jquery.noConflict() since it will render the $ alias for jQuery useless.

        • External scripts will delay user interactions with the UI.

      4. Click OK to save your changes and to display the output of the source in the main text box.

        CP_SaveNewSource.png

    3. Select the Persistent check box to display the panel by default in Summon.

    4. Select the Disable check box if you want to disable the display of the panel in Summon.

      After a panel has been enabled and saved, it will appear in the Summon UI in 5 to 10 minutes.

    5. Click Save to save your new panel. The new panel will immediately appear in the Existing Sections view at the bottom of the page.

      CP_ExistingSections.png

    6. If you want to add tags, see Edit a Custom Panel Section.

    Import Multiple Panels at Once

    The Bulk Section Importer allows you to import a CSV file (UTF-8 encoding) that contains one or more custom panel definitions. The importer will not delete or modify any existing panels.

    CP_BulkSectionImporter.png

    Each panel definition must use the following structure, and each field must be entered in order:

    <title>,<content>,<isDisabled>,<isPersistent>,<tag_1>,<tag_2>,<tag_n>, ...

    Field Description

    title

    The panel's title, which cannot exceed 80 characters.

    It is not recommended to use the same title for panels.

    content

    The entire contents of the main text box, which may include HTML, CSS, and JavaScript elements.

    If the content includes a comma, enclose the entire content in double quotes to prevent import errors. For example: "<p>This basket contains apples, oranges, bananas and pears.</p>"

    If the content includes a quote ("), place another quote next to it. For example: <span id=""bulk-demo"">

    isDisabled

    Indicates whether the panel is disabled in Summon. The valid values are true (disabled) or false (enabled).

    isPersistent

    Indicates whether the panel displays in all Summon search results, regardless of the defined tags. The valid values are true (persistent) or false (not persistent).

    tag_1 - tag_n (optional)

    Tags are search terms that you want to associate with a panel to ensure that the panel displays for particular searches. The following rules apply to tags:

    • Each field must contain a single tag, which may be one or more words and cannot exceed 50 characters.

    • Each tag must start with either a letter (not case-senstive) or a number (0-9), and the other characters must be one of the following: letter, number, dash (-), underscore (_), ampersand (&), forward slash (/), single quote ('), at symbol (@), hash sign (#).

    • Quotes are not required when specifying a multiple-word tag.

    • Because the system automatically creates a tag for the panel's title, there is no need to include it in the panel's definition. You may delete the tag after it has been imported into the system.

    To import multiple panels at once:
    1. Add your panel definitions to a CSV file.

      In the following example, the file contains two panel definitions, which contain HTML and JavaScript:

      CP_ImportFile.png

    2. Click Browse to select the CSV file on your computer.

    3. Click Import to add the new panels.

      At the top of the screen, a message will indicate whether the import was successful. After a successful import, the page will automatically refresh and display the newly added panels.

    Edit a Custom Panel Section

    To edit a panel:
    1. In the Existing Sections area, click the panel that you want to edit. The panel will open in the Section Preview area.

      CP_SectionPreview.png

    2. Click Edit to open the editor.

      CP_EditSection.png

    3. If you want to edit the description's source code, select Tools > Source code.

    4. Update the Disabled and Persistent check boxes as needed.

    5. Click Update.

    6. Add tags as needed. It is not necessary to edit the panel to add or remove tags. The tags are limited to 80 characters.

      A tag is added automatically for the panel's title.

    Reorder Custom Panel Sections

    To reorder custom panel sections, you can use either of the following methods:

    • In the Existing Sections area drag and drop panels in the list to arrange the panels in the correct order.

    • Select a panel and then click Move > Top or Bottom in the Section Preview area to move the panel to the top or the bottom of the list, respectively.

    • Once you are done, click on the Update Order button to save your changes. 

    Delete Custom Panel Sections

    To delete custom panel sections, you can use either of the following methods:

    • In the Existing Sections area, mark a panel or panels for deletion and then click Bulk Delete to remove all selected panels.

    • Select a panel and then click Remove in the Section Preview area to remove the panel.

    • Was this article helpful?