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

    What kinds of things can a library put in Summon Custom Panels?

    • Product: Summon

    Here are examples of Custom Panels that have been created by both support staff and other clients. Please note these scripts are provided as a courtesy and are not supported by Ex Libris development. Usage, edits to, and maintenance of the code is the responsibility of the library. Ex Libris support is unable to provide troubleshooting assistance for any issues with this code.

    If you see a widget not listed here you think would be helpful for other libraries, please feel free to let us know by opening a case and putting "Summon Custom Panel Widget" in the subject.

    Publication Finder

    Created by: Ex Libris Staff

    Example: http://support.summon.serialssolutions.com/#!/search?ho=t&l=en&q=test

    Description: This panel re-runs the Summon query in the customer's E-Journal Portal, and then displays the results within the panel.

    <div id="mydiv"></div>
    <script src="https://local.4libs.org/apps/summon/ShowJournal.js?libhash={LIBHASH}"></script>
    

    Notes on installation: This panel requires the 360 Link API to be activated. For more information, please see this article.

    Please download the script and linked CSS (https://local.4libs.org/apps/summon/ShowJournal.js https://local.4libs.org/apps/summon/ShowJournal.css) to your own webspace. Remotely link it from there and put your libhash in the appropriate spot.

     

    External Search By Link

    Created by: Ex Libris Staff

    Example: http://support.summon.serialssolutions.com/#!/search?ho=t&l=en&q=test (under the name 'Search the Catalog')

    Description: This panel allows the user to click a link to send the Summon search query to an external search system such as the library catalog or a union catalog.

    <script>
    // this is a script to create a custom search link in a panel
    // the link sends the query from Summon to a new search in an external system
    // get URL string
    var urlString = window.location.href;
    // init object to hold key-value pairs for URL parameters
    var params = {};
    // parse parameters
    urlString.replace(/([^=&]+)=([^&]*)/g, function(m, key, value) {
        params[decodeURIComponent(key)] = decodeURIComponent(value);
    });
    // build the link
    var searchLink = "{SEARCH_SYSTEM_BASE_URL}" + params["q"];
    // build the HTML markup and then create the new object
    var markup = "<p>Looking for more resources? Try Searching the <a href='" + searchLink + "' target='_blank'>Library Catalog</a></p>";
    var panelElement = $(markup);
    // append the new object to the container
    $("#linkContainer").append(panelElement);
    </script>
    <div id="linkContainer"></div>
    

    Notes on installation: Make sure to replace placeholder {SEARCH_SYSTEM_BASE_URL} with the URL to which you want to the query applied. In the example on the WFS demo site, {SEARCH_SYSTEM_BASE_URL} is equal to "http://olc1.ohiolink.edu/search/X?SEARCH=" .  Additionally, the markup variable can be edited to customize the text as preferred by the client. 

    Create a Hidden Panel To Run Additional JavaScript without Referencing a Hosted File

    Created by: Ex Libris Staff

    Seen at:  http://supportqa.summon.serialssolutions.com/?q=test#!/search?ho=t&l=en&q=test

    Description: This self-hiding panel allows you to run additional JavaScript without hosting a file in the 'Reference External JavaScript' field. 

    <script>
    var sections = $(".customSections").children("ul").first();
    sections.children("li").first().css("display", "none");
    // YOUR ADDITIONAL CODE GOES HERE
    </script>
    

    Notes on installation: You MUST add this is as the very first Custom Panel in your list of Custom Panels for this to work. Make sure the "persistent" checkbox is ticked.

    Expand Facets By Default

    Created by: Ex Libris Staff

    Seen at:  http://ucblibraries.summon.serialssolutions.com/#!/search?ho=t&l=en&q=

    Description: This uses the self-hiding panel above and waits for the client's facets to appear. Any facets that are collapsed by default (e.g. Library Location, Language, etc.) will be expanded.

    <script>
    var sections = $(".customSections").children("ul").first();
    sections.children("li").first().css("display", "none");
    //Wait for facets to appear on page before running
    $('h3 a').ready(function() {
    //Expands any facets that are not expanded by default (e.g. Library Location and Language facets)
    $('h3 a[aria-pressed=false]').click();
    //If you only want to expand specific facets by name you can replace the line above with something like this (example for Library Location, note that this won't work if you change the label of this facet to something else): $('a:contains("Library Location")')[0].click();
    });
    //Add any additional Javascript customizations here
    </script>
    

    Notes on installation: You MUST add this is as the very first Custom Panel in your list of Custom Panels for this to work. Make sure the "persistent" checkbox is ticked.

    Add LibGuides In-Page Chat Widget

    Created by: North Carolina Central University staff

    Seen at: http://nccu.summon.serialssolutions.com/#!/search?ho=t&l=en&q=test

    Description: The native Summon Libguides integration does not support the in-page or 'embedded' widget, but this style of widget can be added easily via a Custom Panel. You will need to generate a code in inline widget format. For assistance with widget code generation, please contact SpringShare.

    Notes on installation: Paste the code generated from SpringShare into a Custom Panel.

    Add Other Libguides as Drop-Down list

    Created by: US Naval Academy staff

    Seen at: http://usna.summon.serialssolutions....&l=en&q=nimitz

    Description: You can embed lists of LibGuides for easy access in Summon. For assistance with code generation, please contact SpringShare.

    Notes on installation: Paste the code generated from SpringShare into a Custom Panel.

     


    • Article last edited: 9-Oct-2018