As announced a few month ago, there is a new REST client for PHP developers (restclient-php). Now we can proclaim the first stable release of version 1.0.0. This PHP library is really easy to use and supports all functions of the BibSonomy REST API. It also provides an integrated CSL-processor (citeproc-php) that helps you to render bibliographies.

In addition, there is a tutorial for the use of restclient-php which contains some useful examples scripts.

We hope that helps you to develop your own App for BibSonomy.

Happy tagging,
Sebastian

We spent some time developing a new full-featured REST Client in PHP in order to make it much easier for you to develop new Apps for the BibSonomy universe.

The new REST client library comes with a lot of new features:

• It's full-featured that means the client supports the whole functionality of the API.
• It contains a model such that it is convenient for you to work with the data.
• It supports Basic Auth as well as OAuth authentication methods.
• It's easy to integrate in your PHP App, since we have used composer, a powerful tool in order to integrate and autoload requirements of 3rd party software.
• You can output a fetched set of publications as a CSL-rendered publication list in your favorite citation style.

In order to use the restclient-php library you need to do three steps:

1. Install the library via composer and include the autoloader file.
   
   Installing Composer locally is a matter of just running the installer in your project directory:
   
   curl -sS https://getcomposer.org/installer | php
   
   Then, add the restclient to the requirements of your project. Run the following command on a terminal within your project folder:
   
   php composer.phar require academicpuma/restclient-php:1.0.0-alpha
    
2. Create an Accessor. This object is required to authenticate your App on the REST API of BibSonomy. You can choose between two authentication methods, Basic Auth or OAuth. For Basic Auth this would be:
   
   <?php

require 'path/to/vendor/autoload.php';
use AcademicPuma\RestClient\Accessor\BasicAuthAccessor;

$accessor = new BasicAuthAccessor('http://www.bibsonomy.org', [your-username], '[your-apikey]');
?>
 
3. Create a RESTClient object and perform a request. This object is your interface to BibSonomy. This class provides all supported functions to get, create, update, and delete posts, tags, documents, user and groups. For example:
   
   <?php

use AcademicPuma\RestClient\RESTClient;
use AcademicPuma\RestClient\Config;

$restClient = new RESTClient($accessor);
//choose Resource type and tags
$restClient->getPosts(Config\Resourcetype::BIBTEX, Config\Grouping::USER, [username], ['tag1', 'tag2']);
?>
   
   Now, you can choose the format. There are four options: XML, CSL (JSON), Model (PHP Objects), Bibliography (CSL-rendered publication list):
   
   

   <?php
   
   
   //output xml
   echo $restClient->xml();
   
   //output CSL
   echo json_encode($restClient->csl());
   
   //use the model
   $posts = $restClient->model();
   foreach($posts as $post) {
       echo $post->getResource()->getTitle()."<br />\n";
   }
   
   //print a bibliography in your preferred style and language
   echo $restClient->bibliography('apa', 'en-US');
   
   ?>
   

Currently restclient-php is considered as unstable alpha version. If you encounter  any errors or problems, feel free to report an issue on our code repository.

Happy tagging,
Sebastian.

PUMA/BibSonomy CSL is an extension for the TYPO3 content management system. It renders publication lists and tag clouds, e.g., for personal home pages or project websites. Since it uses publication data directly from PUMA/BibSonomy. They can be selected using tags or user/group names. Thus users are spared the effort of adding publications manually to TYPO3.

The last long term support (LTS) release of TYPO3 was version 4.5, which by now is not longer supported. Therefore, we have updated PUMA/BibSonomy CSL, to work with TYPO3 6.2 (LTS). More information about the release road map of TYPO3 can be found on https://typo3.org/typo3-cms/roadmap/.

PUMA/BibSonomy CSL uses the Citation Style Language (CSL). Thus, users can choose to render their publication lists in any bibliographic style. A huge set of CSL styles is available at http://zotero.org/styles.

Get an overview of the extension's features:

• Insert publications from individual users or groups.
• Use tags to filter publications of a certain topic.
• Choose your favourite style from a set of citation stylesheets to render a bibliography in your favourite bibliographic style, such as APA, Harvard, Chicago, and many more.
• Install and manage your own citation stylesheets.
• Choose a language for your citation style.
• Insert a tag cloud on your webpage and present your top topics of interest.
• Offer associated documents as download.
• Render preview images of these documents.
• Group your entries by year or publication type.
• Sort your publication list by title, author, and year.
• Configure the extension once in TYPO3, and manage your own publications in BibSonomy/PUMA.