WiscWeb - Using the Publications Plugin

The Publications plugin allows you to create a list of published books and articles and display it on pages and Faculty/Staff member posts in a formatted list.

 Activation

This plugin is not activated in WiscWeb projects by default. However, Administrators can activate it in the project by following the instructions in WiscWeb - Self service plugin activation / deactivation.

 Setting the Citation Style Language:

  • Hover your mouse over the Publications option on the left, and choose CSL Options.

    Citation Style Language options menu item

  • In this screen, choose the CSL option that you'd like to apply to your site's publications listings. Make a choice by clicking into a radio button for your selection.

    Citation Style Language selection screen

  • Once you have made your choice, click Save.

  Creating A Publication

  1. Click Publications in the left menu to access the full list of your publications.

    Publications link in dashboard

  2. At the top of the screen, click Add New to begin adding a new publication. This is also where you can edit any existing publications if needed.

    Add New Publication

  3. Add a Post Title, a Publication Title (these can be the same), and choose what Type of publication that you are adding from the drop down list.

    Publications title entry

  4. In the Author tab, choose which order you want the authors to appear (Alphabetical or Natural Order). Using the Natural Order option, you can drag and drop the order in which the authors appear.

    Author options

    To add an author to this publication, click Add Author and choose whether to manually add an author or assign this publication to a Staff Member that you have created.

    Add Staff Member or Add Author

    Adding an author options
    Staff member author selection

  5. In the Publishing Information tab, you can add further information about the publication including Publisher, Year Published, Page(s), additional Notes, and more. Note that not all fields below are be used by all citation styles.

    Additional publishing information about publication

    Please note that the Date field can be used to add simply a year (ie. 2021), or a specific date (2021/01/01) to assist with sorting.

  6.  In the Attachments tab, you can add external links for this publication, additional files to download in relation to this publication, and add an image for it (like a cover image for a book).

    Attachments tab details

  7. You can also begin to "categorize" publications by using the Publications Types section in the right.

    Publications Types dialogue area

    To add a new Publications Type, click the Add New Publications Type link. Add in your publication type value, and hit the Enter key.

    Adding publications types

  8. Put a check in the types that you want to use for this publication. These Publication Types can be used later in the shortcode by adding the parameter "publication-type=type".

Once you have entered all of the relevant information for this publication, click Publish in the upper right corner of the page to make it live.

Continue to add publications as necessary.


  Displaying Publications

  1. On a page, you should now see a Publications Listing section (you may have to scroll down on your editing page to find this section, though it can be dragged and dropped into a different location). To activate the publications list, click the checkbox for Yes.

    Publications Listing dialogue area

  2. Once that is clicked, you are presented with options for your publications list regarding a title for the list, what publications to show, and the sorting order for the list.

    Additional details for Publications List

  3. You can also limit what fields are shown in the Publications List by clicking on the Fields to Show tab.

    Fields to Show tab options

  4. Once you have set all of the values, notice the shortcode necessary to place the list in a Text Block :: [uw_publications]. Copy and paste this code into a text area to display the list. You can also add parameters to this shortcode, for example to specify multiple lists with different Publication Types, you could use the shortcode like this:

    [uw_publications publication-type= "2015"] or [uw_publications publication-type= "faculty"]

    To include multiple publication types, simply separate with commas: 

    [uw_publications publication-type="1999,2000,2001,2002"]

  5. shortcode being used in a text block

  6. Be sure to Update or Publish your page to place the list. Once that is done, you can then view the page to see your list.

    Publications List on a page

Troubleshooting

  • If a Publication post does not appear, and you instead get a Page Not Found error, you may need to "flush your permalinks." To do this, go to Settings --> Permalinks --> scroll to the bottom and click Save Changes.

  • It is recommended that you only include one publications shortcode per page.

  • The publications shortcode is best suited for a Text Block.


Keywordsdocuments, published, article, articles, book, books, pubmed, journal, post, upload, display, share, bookshelf   Doc ID78246
OwnerMatt G.GroupWiscWeb
Created2017-11-14 14:55:05Updated2024-03-07 09:00:38
SitesDoIT Help Desk, WiscWeb
Feedback  1   1