WP Academic Publications

Cwestiynau Cyffredin

How do I use the shortcode?

Add [academicpubs] in a post. This can have options:

category: comma separated list of publication category slugs to display.
numbered: if true, publications will be displayed with an ordered list.
limit: total number of publications to display.
reverse: display in chronological order (default is reverse chronological).
show_links: if true, show links to the paper pdf and bibtex file.
page_num: useful for paging, tell wordpress to return the publications that would be on this page.
num_per_page: number of pubs to show on a 'page', needed for the paging functionality.

For example:

[academicpubs category=selected,science numbered=true limit=5 reverse=true show_links=false]

What if I want the publications somewhere else?

You can use one of the two php functions anywhere in a template.

/* Returns a list of publications. Each publication contains key,val pairs.
 *
 * $options: array('option' => 'value')
 *
 * Returns: [['id':1, 'title':'Paper Name', 'pdf_url':'http://a.com'],
 *           [another pub...]]
 *          fields are: id, title, authors, conference, pdf_url, bibtex_url,
 *                      slides_ppt, website_url
 */
wpap_display_publications($options);

/* Returns html around each publication.
 */
wpap_display_publications_formatted($options);

For example:

<?php
$opts = array('category'   => 'selected,science',
              'reverse'    => 'true',
              'show_links' => 'false');
$pubs = wpap_display_publications($opts);
foreach ($pubs as $pub) {
    echo '<p>' . $pub['title'] . '</p>';
}
?>

or

<?php
$opts = array('numbered'   => 'true',
              'limit'      => 10);
echo wpap_display_publications_formatted($opts);
?>

What does the output look like?

• Pub1 Title

  Tom Smith and Eva Newn

  Conference 1

  paper | BibTex | slides (ppt) | website

• Pub2 Title

  Tom Cruise

  COOKIE ’13

  paper | BibTex

What is a starter for some CSS styling?

.wpap .publication-title {
font-size: 110%;
font-weight: bold;
}
.wpap p {
margin: 0;
padding: 0;
}
.wpap ul {
list-style: none;
margin: 0;
}
.wpap li {
margin-bottom: 15px;
}

Support

Please go to https://github.com/bradjc/wordpress-academic-pubs if you have
any issues.