Books & Papers

Description

Using Books & Papers plugin one can manage lists of authors and their publications
(books, journal publications like scientific papers/arXiv preprints and conference proceedings).
Additional features are available like import via DOI and BibTeX database.

User fills database records, provides author identifiers and then can display lists of publications by their type for each
author in the given page of website.

Author management

Each author is characterized by the following fields:
* First name
* Last name
* E-mail: john@doe.com
* Personal URL: https://doe.com/john, author name becomes a link if URL is provided
* Identifier: internal identifier used for referencing the concrete person (johndoe, jonny1 etc).

First of all, authors can be added manually. Authors are added during import of external publication.
If they are not recognized automaticallly among already existing ones, new records are created. You can
merge duplicate records later as well as modify existing ones.

Publications

Three types of publications are supported:
* Article is a journal publication like this one.
It is characterized by list of authors (may be selected from existing records as well as just mentioned as external ones),
title, journal, link to supplementary materials, date for sorting etc.
* Conference work is characterized mainly with the same fields as Artcile with additional Book Title field.
* Book is a publication, also characterized by editors, publisher, chaprter (for the referencing separate chapters in a textbook).

One can provide custom characteristics (max. three characteristics are supported) displaying by special stylesheet for the selected
record.

Settings

You can configure some of the plugin functionallity:
* Set database prefix for tables that store author and publication data.
* Name the custom characteristic and set the style which it uses.
* Set the timeout of success/failure notification.

Usage

Let suppose, you’ve added an author named John Doe with johndoe identifier.
There are 10 Article records, 3 Book records and 8 Conference records are related with John Doe. One Article is marked as preprint.
Then, the following command are accessible:
* [publications auth=johndoe subj=articles prep=all] will show all 10 Articles incluing preprint.
* [publications auth=johndoe subj=articles prep=only] will show only 1 record (preprint)
* [publications auth=johndoe subj=articles prep=ex] will show 9 Articles without preprint.
* [publications auth=johndoe subj=books] will show 3 books
* [publications auth=johndoe subj=conferences] will show 8 conference records.
* [publications auth=all subj=all year=2018] will show all publication records of year 2018.

Settings menu provides fields for customization:
* Headers for articles, conferences and books sections.
* Substitution list for flexible records output format. For example, command
[authors] [title], [journal] {{Vol. [volume]}} [pages] ([year]) will result in a list of
authors, italic title of the article, journal title, bold volume number, pages number and article year in parentheses.
Note, that {{…}} syntax means that this part of record will not be displayed if [volume] is not provided.

Screenshots

  • Publication list as auto-fill result on site page.

  • Plugin's author management admin menu.

  • Plugin's works management admin menu.

  • Plugin's settings page.

Installation

  1. Install the plugin usind WordPress plugins screen or upload the plugin and paste its content to the /wp-content/plugins/books-and-papers directory.
  2. Activate the plugin on the ‘Plugins’ screen in WordPress.
  3. Go to Settings->Books and Papers screen and configure the plugin.

FAQ

How can I access the plugin?

Plugin menus are located on the left admin panel.

Plugin menu doesn’t show up.

Plugin must be enabled first. Go to ‘Plugins’->’Installed Plugins’ and enable the plugin.

How can the list of publications be shown on the site?

Use the following tag: [publications auth=author subj=publication], where ‘author’ should be replaced with author slug or ‘all’ for everyone, and ‘publication’ replaced with paper type (articles, conferences or books) or ‘all’ for any type. For example: [publications auth=all subj=articles] will shown articles of every author.

No publications are shown, while tag is correct.

Possible reasons:
* Plugin is not enabled.
* No publications were entered. Go to ‘Manage Papers’ submenu to check. It should have a list of all publications.
* Publications are not public. Go to ‘Manage Papers’ submenu, find needed publication, click ‘Modify’, ‘Paper is public’ should be checked.

I want to emphasise some publications on list.

You can set up custom characteristic on the plugin settings page: name it and enter its style. Then modify the publication by checking the charactertic.

What I should enter as custom characteristic’s style?

The style field should contain style description similar to HTML style attribute. For example, to make white text on black background, enter “color:white,background-color:black” (without quotes). Find more options online, searching for “style attribute properties”.

Reviews

June 18, 2019
The author of this plugin was very efficient! Already, many of my questions have been answered and now the plugin has been improved for me. Today I saw the update of the plugin! For users, please find {{ }} grammar for the conditional display. ---- I have been trying to find a plugin like this for many years and finally this is the best fit for the website of my research group. And yet it can be improved in its presentation of papers. One issue is its formatting: In the setup menu, one can set up the format; here is the default format. [authors] [title] ([year]) [doi] [arxiv] [filelink] [supplementary]. However this is not at all flexible -- there is no "conditional" formatting. For instance, if the year is empty, then it should not produce (0). Typically papers are shown on the journal website as soon as they are accepted and those early-view papers have DOI numbers but no year, issue, volume. It would be nice to say something like [if year "([year])"] to display ([year]) only if it is nonzero and nonempty. Also, doi and arXiv link do not put hyperlinks automatically. And it would be nice if the title of the paper is linked to doi if available, and arxiv if doi is unavailable and arxiv is available.
May 19, 2019
however, its simplicity is causing some options to be missing. options like sort by year, by alphabet e.t.c
Read all 2 reviews

Contributors & Developers

“Books & Papers” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Books & Papers” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change log

0.20190622

  • Fixed issue preventing from inability to apply new journal title on manage work page.
  • Fixed issue when conditional formatting with [journal] tag didn’t work properly.

0.20190616

  • Integer values like year, volume or issue, if equal to zero, are now considered as null in conditional formatting.
  • Reduced required fields of publications to title only (Journal and Year are no longer required).

0.20190526

  • Added list sorting by title. Added Citation styles examples.

0.20190522

  • Fixed issue displaying all publications if there are none for specified year.

0.20190521

  • Added optional field to tag that allows displaying publications of specific year.

0.20190418

  • Fixed class and options name.

0.20190413

  • Initial release.