Typo3 | Help | BibSonomy
BibSonomy now supports HTTPS. Switch to HTTPS.
Home

Integrate into TYPO3

For TYPO3 v1.0-v5.9 you can use BibSonomy TYPO3-Extension to integrate lists of publications from BibSonomy into your pages. In TYPO3 v6.0 there are some major changes, so we implemented a new extension based on TYPO3 Flow. If you are using TYPO3 v6.0 or above, please use the following extension: BibSonomy CSL (ext_bibsonomy_csl).

With our new extension, you can add lists of publications from BibSonomy to your pages and you can style your bibliography with CSL Stylesheets (Citation Style Language). To get started quickly, you can choose from a set of pre-installed stylesheets. But you can also change these pre-installed styles or create your own stylesheets. Additionally, you have the option to add your BibSonomy tag cloud to your website.


Installation

To install BibSonomy CSL, log into your TYPO3 installation as an administrator and in Extension Manager => Import Extensions, search for the extension ext_bibsonomy_csl and import it.

 <File:1.png>

After the import is finished, the extension will be displayed in the section "Available Extensions". Press the + symbol for activation.

 <File:2.png>


Add publication lists with the Frontend Plugin

After you installed and activated the extension, you can create publication lists. On the page where the publication list shall be displayed, add a new plugin. Choose "BibSonomy Publication List" from the list.

 <File:3.png>

In the tab "General" insert a headline for your publication list.

 <File:4.png>

In the tab "Plugin" you can choose settings for your publication list. You can choose between the options user, group or viewable to select the content from BibSonomy.

Example: You want to include your own publications on one of your pages. In "Content Source", choose "user" as content source type and enter your BibSonomy user name as content type value (in this example, we've chosen the user dbenz). Now you can to filter your selection by using the tags. To select just your own publications, choose the tag "myown". If you want to select more than one tag, you have to separate them by a space character. Optionally, you can limit the number of publications or filter with free text.

 <File:5.png>

There is also the possibility to filter the content by using freetext search field.

Warning: Be aware that you are using your own account to retrieve the posts from BibSonomy. That means that all posts that are visible to you in BibSonomy (your private ones too as well as attached documents) will be made visible on your page if they fit to the description in the plugin record. As a result, you can get copyright issues. We recommend to create an additional BibSonomy account just for TYPO3 publication management.

In the tab "Layout" you can style your publication lists by using Citation Style Language (CSL), an open source XML-based markup language. A large list of freely available stylesheets can be found on <http://www.zotero.org/styles/>.

 <File:6.png>

In the third tab "Login" you have to enter your BibSonomy API credentials. You can find your API data here.


Add your Tag Cloud with the Frontend Plugin

You can also add your BibSonomy tag cloud to your pages. To do so, add a new plugin on the page where the tag cloud shall be displayed. Choose "BibSonomy Tag Cloud" from the list. Typically, a tag cloud will be placed in the sidebar, so you can choose the right or left content area for inserting.

 <File:7.png>

Like in "add publication lists", you can choose between different options here.

 <File:8.png>


Manage your CSL styles with the Backend Module

Typo3 extensions are classified into frontend plugins and backend modules. You have already learnt about the frontend plugins "add publication lists" and "add tag cloud". To manage your CSL stylesheets you can use the backend module "CSL Styles".

By default there are a lot of styleheets pre-installed. To add your own custom styles, create a new folder "CSL Styles" in the page tree. Select this new file, click on "new" and then select "Add a custom style".

There are three ways to add a new stylesheets:

  1. Direct input: Enter the XML source code of your stylesheet in the text area and click on "Save".
  2. Import from URL: Enter the URL of the CSL stylesheet file and click on "Import".
  3. Upload CSL file: Select a CSL XML file from your filesystem and click on "Upload".

 <File:9.png>

Click on "Show Styles" to get a preview.

 <File:10.png>

To delete styles, click on the paper trash icon left of the style.