DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
del.icio.us Bookmarks¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed by: | Simon Tuck |
Changed: | 2007-10-21T23:28:45 |
Author: | Simon Tuck |
Email: | stu@rtpartner.ch |
Info 3: | |
Info 4: |
del.icio.us Bookmarks¶
Extension Key: rtp_delicious
Copyright 2007, Simon Tuck, <stu@rtpartner.ch>, Rüegg Tuck Partner GmbH
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.com
Table of Contents¶
del.icio.us Bookmarks 1
Introduction 1
What does it do? 1
Screenshots 1
Users manual 2
Installation 2
Adminstration 2
User Accounts 2
List of Bookmarks 3
Tag Cloud 4
Configuration 5
Extension Settings 5
Templates 6
Known problems 6
To-Do list 6
Changelog 6
Introduction¶
What does it do?¶
Frontend extension to import and display links from del.icio.us accounts.
Screenshots¶
List of bookmarks from del.icio.us account(s) grouped by
tag
List of bookmarks from del.icio.us account(s)
Tag cloud from bookmarks from del.icio.us account(s)
Users manual¶
Installation¶
Download and install the extension from the extension repository. The extension uses the lib/div extension framework and the templating is done with Smarty, so in addition the following extensions are required:
- Library for Extensions (lib)
- Static Methods for Extensions (div)
- TYPO3 is Smarter (rtp_smarty)
Include the TypoScript configurations for 'rtp_delicious' and 'rtp_smarty' in your template:
Adminstration¶
List of Bookmarks¶
Insert the plugin on your page and choose 'ByTag(s)' or 'As List' as the display mode:
Storage Page/Folder for user accounts¶
Property
Storage Page/Folder for user accounts
Description
Page where the user accounts are stored
Default
Current page
Display Mode¶
Property
Display Mode
Description
Choose either 'As list' or 'By Tag(s)' as the display mode
Default
Highlight new links¶
Property
Highlight new links
Description
Enable this option to highlight recent bookmarks:
Default
Max. age in weeks for new links¶
Property
Max. age in weeks for new links
Description
Number of weeks that define 'recent' for highlighting new links
Default
12
Sort by¶
Property
Sort by
Description
Sort the list by:
- description
- URL
- Date (date the bookmark was submitted or last changed)
- Popularity (No. of other del.icio.us users who have tagged this link)
Default
description
Sort order¶
Property
Sort order
Description
Order of sorting (Ascending or Descending)
Default
Ascending
del.icio.us user accounts¶
Property
del.icio.us user accounts
Description
Select the del.icio.us accounts to import bookmarks from
Default
Tag selection¶
Property
Tag selection
Description
Choose either to display bookmarks from all the tags or from selected tags of the del.icio.us accounts.
Default
All tags
Tags¶
Property
Tags
Description
If 'All tags' a list of all the tags retrieved from the accounts will be displayed, if 'Selected tags' a list of tags from the selected del.icio.us accounts is displayed. Choose the tags to get bookmarks for:
Default
Tag Cloud¶
Insert the plugin on your page and choose 'Tag Cloud' as the display mode:
Storage Page/Folder for user accounts¶
Property
Storage Page/Folder for user accounts
Description
Page where the user accounts are stored
Default
Current page
Display Mode¶
Property
Display Mode
Description
Choose 'Tag Cloud' as the display mode
Default
Target page for list¶
Property
Target page for list
Description
Select the page that contains the bookmarks list
Default
Current page
Sort order¶
Property
Sort order
Description
Order of sorting (Ascending or Descending)
Default
Ascending
del.icio.us user accounts¶
Property
del.icio.us user accounts
Description
Select the del.icio.us accounts to import bookmarks from
Default
Tag selection¶
Property
Tag selection
Description
Choose either to display bookmarks from all the tags or from selected tags of the del.icio.us accounts.
Default
All tags
Tags¶
Property
Tags
Description
If 'All tags' a list of all the tags retrieved from the accounts will be displayed, if 'Selected tags' a list of tags from the selected del.icio.us accounts is displayed. Choose the tags to get bookmarks for:
Default
Configuration¶
Extension Settings¶
Modify the following constants to customize the configuration of the extension.
delicious.¶
template_dir¶
Property
template_dir
Description
Directory where the templates for the list views and the tag cloud are stored.
Default
EXT:rtp_delicious/templates
template.listByTags¶
Property
template.listByTags
Description
Name of the template used for the list by tags display mode.
Default
bookmarksByTag.tpl.html
template.list¶
Property
template.list
Description
Name of the template used for the list display mode.
Default
bookmarksAsList.tpl.html
template.tagCloud¶
Property
template.tagCloud
Description
Name of the template used for the tag cloud display mode.
Default
tagCloud.tpl.html
newFlag.file¶
Property
newFlag.file
Description
Name and location of the image used to flag new posts
Default
EXT:rtp_delicious/templates/res/img/new.gif
tagCloud.maxFontSize¶
Property
tagCloud.maxFontSize
Description
Maximum size in % for tags in the tag cloud
Default
150
tagCloud.minFontSize¶
Property
tagCloud.minFontSize
Description
Minimum size in % for tags in the tag cloud
Default
100
smarty.debugging¶
Property
smarty.debugging
Description
Enable/disable the Smarty debugging console for all templates (to enable the debugging console for a single template add the line {debug} to the template)
Default
false
pathToLanguageFile¶
Property
pathToLanguageFile
Description
Name and location of the localization file used in the templates
Default
EXT:rtp_delicious/configurations/locallang.xml
caching¶
Property
caching
Description
Enable/disable caching of responses from del.icio.us
Default
true
cacheTimeout¶
Property
cacheTimeout
Description
Caching time (period in seconds after which the cache expires). If set, the cache is only cleared if del.icio.us has newer results and the cache has expired. If not set (0), extension will always check for newer results and clear the cache as soon as newer results are available from del.icio.us
Default
0
cacheDir¶
Property
cacheDir
Description
Location of the del.icio.us cache files
Default
typo3temp/rtp_delicious/
logging¶
Property
logging
Description
Enable/disable logging of responses from del.icio.us
Default
false
logErrorsOnly¶
Property
logErrorsOnly
Description
Set this to false to enable logging for all responses from del.icio.us (as opposed to logging only errors)
Default
true
logDir¶
Property
logDir
Description
Location of the rtp_delicious log file
Default
EXT:rtp_delicious/lib/simply_delicious/log/
logFilename¶
Property
logFilename
Description
Name of the rtp_delicious log file
Default
delicious_log
Example¶
The following TypoScript constants will enable the debugging console for the Smarty templates and also log all responses from del.icio.us:
delicious.smarty.debugging = true
delicious.logging = true
delicious.logErrorsOnly = false
Templates¶
The frontend templates are implemented using Smarty. For instructions on how to modify or create your own templates refer to the documentation for the extension rtp_smarty.
Known problems¶
- Frequently querying a large amount of tags will result in being throttled by del.icio.us. Consequently the maximum number of bookmarks retrieved per tag is 100. This is because the extension uses the post/recent method instead of the posts/all method.