WordPress.org

Mendeley Plugin for WordPress is a plugin for displaying information from the Mendeley "shared bibliography system" (www.mendeley.com) in WordPress blogs.

Using the public API from Mendeley, meta-information on documents in personal, public or shared collections is loaded and formatted as bibliographic entries.

The lists can be included in posts or pages using WordPress shortcodes:

[mendeley type="folders" id="xxx" groupby="xxx"]
[mendeley type="groups" id="xxx" groupby="xxx"]
[mendeley type="groups" id="xxx" sortby="xxx" sortbyorder="xxx"]
[mendeley type="groups" id="xxx" groupby="xxx"]
[mendeley type="groups" id="xxx" groupby="xxx" filter="author=Michael Koch"]
[mendeley type="documents" id="authored" groupby="year"]
[mendeley type="documents" id="authored" filter="tag=perceptualorganization"]
[mendeley type="documents" id="authored" sortby="authors" sortbyorder="asc" groupby="year" grouporder="desc"%#93;
[mendeley type="own"%#93;

- the attribute "type" can be set to "own", "folders", "groups", "documents"
- the attribute "groupby" is optional; possible values currently are: "authors", "year"
- the attribute "sortby" is optional; possible values currently are: "authors", "year"
- the attributes "sortbyorder" and "groupbyorder" can have the values "asc" and "desc"
- sorting on the sort key is done before grouping on the group key if both are provided
- possible attributes to filter for are: author, editor, title, year, tag, keyword, url, publication_outlet, pages, issue, volume, city, publisher, abstract

Additionally, there are widgets to display the content of collections or shared collections in widget areas of a theme.

The entries are formatted the following way - so, the style can be tailored using CSS.

    <h2 class="wpmgrouptitle">grouptitle</h2>
    <p class="wpmref">
       <span class="wpmauthors">$authors&lt/span>
       <span class="wpmyear">($year)</span>: 
       <span class="wpmtitle">$title</span>
       , <span class="wpmoutlet">$publication_outlet</span>
       <span class="wpmvolume">$volume</span><span class="wpmissue">($issue)</span>
       , <span class="wpmeditors">$editors</span>
       , <span class="wpmpages">$pages</span>
       , <span class="wpmpublisher">$city: $publisher</span>
       , <span class="wpmurl"><a target="_blank" href="$url"><span class="wpmurl$urltxt">$urltxt<>/span</a&gt</span>
    </p>

• urltxt is per default "url" or "pdf", "ps", "zip" if this is the extension of the file referenced by the url

By adding some lines in your style sheets, you can format the output according to your needs. One example:

.wpmref {
}

.wpmauthors {
color: #666666;
}
.wpmyear:after{
content: ": ";
}
.wpmyear {
color: #666666;
}
.wpmtitle:before{
content: "\"";
}
.wpmtitle:after{
content: "\"";
}

.wpmurlpdf:before {
content: url("/image/pdf.gif");
}

.wpmoutlet,
.wpmvolume,
.wpmissue,
.wpmpages {
font-style: italic;
color: #336633;
}

The output in the widgets is formatted the following way:

    <ul class="wpmlist">
    <li class="wpmlistref">
    title (if url is defined, then this title is linked to url)
    </li>
    ...
    </ul>

One of the next versions of the plugin will support a CSL (citation style language) based formatting.

You can use the plugin in non widgetized themes, just try

echo $mendeleyPlugin->formatWidget("groups", 763, 10, array ('author' => 'Michael Koch'));

For using the plugin you have to obtain an API key from Mendeley, enter this Customer Key in the configuration section of the plugin, and authorize the API. To do so the following steps have to be taken:

1. install plugin
2. activate plugin
3. get Customer Key and Customer Secret from http://dev.mendeley.com/
4. enter the information in the wp-mendeley tab in the backend
5. press "Get Access Key" on the wp-mendeley configuration page
6. then you are redirected to the Mendeley web site to authorize the request, and redirected back to the blog
7. now you can use shortcodes in your pages and blogs

JSON data source

In version 0.7 we added the functionality to create a JSON data source - e.g. to be used as data source in Exhibit/Simile application.

For example the page http://www.kooperationssysteme.de/pub/cscm/ uses such a data source in an interactive JavaScript application to search the references.

The following line is used in the Exhibit/Simile application:

In the directory examples you find a file bibexhibit.tpl.php that can be placed in your WordPress theme directory. Then you can create a new page with the Template BibExhibit that will show the application with the data source.

Thanks ...

Thanks for contributions to Rhodri Cusack and Matthias Budde.