The Publications List block is used to display a list of Publications on a page.
The Publications module must be enabled before you can add publications. During this preview rollout of Publications, please contact [email protected] to enable Publications for your site.
Overview
The Publications List Block has many configuration options to customize its output.
The default display type for this block shows your publications as a paginated list of bibliographic citations. You can also choose to list your publications as a custom list of manually selected fields.
With both display types, you can configure the Sort order. The default sort order is by Year, descending from the most recent year. The Author sort option sorts alphabetically by the last name of the first listed author for a publication. The Title sort option sorts by numbers, then special characters, then A through Z, and it groups non-alphabetic characters under the # symbol for filtering. Finally, the Type sort option sorts by the reference type (e.g. Book, Journal, etc) alphabetically, with a configurable secondary sort.
The Publications list will display all published publications by default; however, in the Filters section of the block configuration, you can filter by Publications Category, Keywords, Publication Type, and Publication Status. You can select multiple items for each filter, and some have toggles that control additional behavior.
By default, a Search field and a collapsible Advanced Filters (Author, Type, Year, Keyword) control is added to the top of the publications list on the live site. You can configure the block to omit these two items, which might not be appropriate for shorter lists of publications. You can also toggle the ability for visitors to select multiple items from each filter type and toggle the display of individual advanced filters. Filters for taxonomy categories can also be exposed to the visitor in the block settings.
There is an option to insert a View All link at the bottom; however, we recommend using this option with a limited number of items and pagination turned off, such as a teaser list on the front page or a sidebar.
You can also uncheck "Group items by sort headings" to remove the H3 headings. This can be useful, for example, if you are displaying a list of books in a grid, and you want a continuous grid instead of one separated by years.
Citation List Display Type
When configuring the Publications List block, choose "Show references as a list of citations" as the Display type. You will not have full control over the display of the fields; however, you will be able to choose a standard Citation Style Language (CSL) format. We currently support the following CSL formats:
- American Chemical Society
- American Medical Association
- American Political Science Association
- American Psychological Association, 7th edition
- American Sociological Association, 6th edition
- Chicago Manual of Style, 17th edition (author-date)
- Council of Science Editors, Name-Year (author-date)
- IEEE
- Modern Humanities Research Association, 3rd edition
- Modern Language Association, 7th edition
- Modern Language Association, 8th edition
- National Library of Medicine (grant proposals with PMCID/PMID)
- Nature
- Vancouver
The configured default CSL format is "Chicago Manual of Style, 17th edition." There are over 10,000 CSL formats available. If you prefer a particular CSL format, contact [email protected], and we will include that format in a future monthly release of Princeton Site Builder v2.
You can also display a small thumbnail image for each publication using this display type.
Manually Selected Fields Display Type
When configuring the Publications List block, choose "Show references as a list of manually selected fields" as the Display type. With this display type, you have the option of displaying the rows of items as a single-column standard list or a multicolumn grid, and you can specify up to 6 columns in each row.