User Tools

Site Tools


reviews:createwidget

This is an old revision of the document!


Creating covers widget

cwidget_example.jpg

Here are steps to take for creating covers widget like the one in example:

  1. Since you can create several widgets for different locations of your library, to switch between the libraries navigate to General tab → Switch between libraries and choose the library you want to create the widget for
  2. Navigate to Reviews tab → Widgets section → Covers-based widget section
  3. Input widget name such as “New widget” (for your own reference) in Create new widget field and click Create widget button which will take you to detailed settings of the widget
  4. You must enter following information:
  • Cover art URL in your OPAC - if you want to display cover art from your provider, you can add its URL here such as http://www.coverart.com/?isbn={ISBN} - where the {ISBN} token displays where the ISBN from the widget will go. If you leave the field empty, the widget will display cover art provided by ChiliFresh
  • ISBN-lookup URL in your OPAC - this is the URL to link directly to a particular item in your OPAC. Such as http://www.youropac.com/?isbn={ISBN} where the {ISBN} token is where the ISBN in the URL should go to link back to particular OPAC. If you cannot figure it out, please contact us at support@chilifresh.com and we will help you to figure it out
  • Widget placement - the widget can be placed in a horizontal and vertical positions
  • Show information from - you can display the pre-defined lists such as “Recently reviewed items”, “Most reviewed items” and “Top rated items” from your particular location you are creating the widget at or the whole library network of yours
  • Show item author/title - whether to show item author and title information by the cover
  • Visible items - number of covers to show on widget's visible part - other covers will be displayed when the widget is scrolled
  • Total items - how many items should be displayed totally on the widget - both visible and invisible in any of the lists
  • Button skip by - how many covers should be skipped by when clicked on the button
  • Item lists to show - which pre-defined and user created custom item lists to show. The checked ones will be displayed and the one marked as “Default” will be displayed on front page of the widget when it loads. You can create and display custom item lists, instructions for it below

Click Update widget button and you will notice changes to the widget right in the “Output example” display

There you go - the widget is ready for using. Just copy&paste the code from the “Code to implement” to the place in your web page source code where you want the widget to be displayed in.

Steps to take for creating custom item lists:

Firstly, the purpose of custom item lists is for you to be able to display specific item lists to your patrons. Examples for lists are “Latest collection additions”, “Librarian picks”, etc.

  1. Navigate to the Covers-based widget section
  2. In Create new list field type the list name - this list name will appear on the widget header, so please write something related to the list. You can edit it later though - and click Create list button. This will take you to the list editing page where you can add/remove/edit list's items
  3. There you can edit the list name by changing the List name field and clicking Update button
  4. You can add items to the list by adding item ISBN or UPC number(s) in the Add item ISBN or UPC field and clicking Add items. You can add several item ISBNs or UPCs at once separating them by a line-break. Once you add the item, it will display item title and the cover which will appear in the widget for that particular item
  5. You can delete item from the list by checking the Delete check-box by the item and clicking Update button
  6. You can edit the item ISBN/UPC number by changing it in the “ISBN” field and clicking the Update button

Please note following things:

  • Widgets and custom item lists are location-based, so this means that if you create a widget while logged on to ChiliFresh location, you will not see the same widget and custom item lists you created after switching to a different location
  • You can display multiple different widgets on the same web page
  • Once you add the widget to your web site, you can still edit it on the Admin panel - the code does not change. Which means - whenever you make a change to the widget on Admin panel, the changes will be instantly applied to the widget where it is implemented
reviews/createwidget.1335089776.txt.gz · Last modified: 2013/03/29 08:42 (external edit)