Public Member Functions
	__construct ($uname=null, $pass=null)
	Constructs a new del.icio.us Web Services Client.

	setAuth ($uname, $pass)
	Set client username and password.

	getLastUpdate ()
	Get time of the last update.

	getTags ()
	Get all tags, returning an array with tags as keys and number of corresponding posts as values.

	renameTag ($old, $new)
	Rename a tag.

	getBundles ()
	Get all bundles, returning an array with bundles as keys and array of tags as values.

	addBundle ($bundle, array $tags)
	Adds a new bundle.

	deleteBundle ($bundle)
	Delete a bundle.

	deletePost ($url)
	Delete a post.

	getDates ($tag=null)
	Get number of posts by date.

	getPosts ($tag=null, Zend_Date $dt=null, $url=null)
	Get posts matching the arguments.

	getAllPosts ($tag=null)
	Get all posts.

	getRecentPosts ($tag=null, $count=15)
	Get recent posts.

	createNewPost ($title, $url)
	Create new post.

	getUserPosts ($user, $count=null, $tag=null)
	Get posts of a user.

	getUserTags ($user, $atleast=null, $count=null, $sort= 'alpha')
	Get tags of a user.

	getUserNetwork ($user)
	Get network of a user.

	getUserFans ($user)
	Get fans of a user.

	getUrlDetails ($url)
	Get details on a particular bookmarked URL.

	makeRequest ($path, array $parms=array(), $type= 'xml')
	Handles all GET requests to a web service.

Public Attributes
const	API_URI = 'https://api.del.icio.us'

const	PATH_UPDATE = '/v1/posts/update'

const	PATH_TAGS = '/v1/tags/get'

const	PATH_TAG_RENAME = '/v1/tags/rename'

const	PATH_BUNDLES = '/v1/tags/bundles/all'

const	PATH_BUNDLE_DELETE = '/v1/tags/bundles/delete'

const	PATH_BUNDLE_ADD = '/v1/tags/bundles/set'

const	PATH_DATES = '/v1/posts/dates'

const	PATH_POST_DELETE = '/v1/posts/delete'

const	PATH_POSTS_GET = '/v1/posts/get'

const	PATH_POSTS_ALL = '/v1/posts/all'

const	PATH_POSTS_ADD = '/v1/posts/add'

const	PATH_POSTS_RECENT = '/v1/posts/recent'

const	JSON_URI = 'http://del.icio.us'

const	JSON_POSTS = '/feeds/json/%s/%s'

const	JSON_TAGS = '/feeds/json/tags/%s'

const	JSON_NETWORK = '/feeds/json/network/%s'

const	JSON_FANS = '/feeds/json/fans/%s'

const	JSON_URL = '/feeds/json/url/data'

Protected Attributes
	$_rest

	$_authUname

	$_authPass

Static Protected Attributes
static	$_lastRequestTime = 0

Constructor & Destructor Documentation

__construct	(	$uname = `null`,
		$pass = `null`
	)

Constructs a new del.icio.us Web Services Client.

Parameters

string	$uname	Client username
string	$pass	Client password

Returns: void

Member Function Documentation

addBundle	(		$bundle,
		array	$tags
	)

Adds a new bundle.

Parameters

string	$bundle	Name of new bundle
array	$tags	Array of tags

Returns: Zend_Service_Delicious Provides a fluent interface

createNewPost	(	$title,
		$url
	)

Create new post.

Returns: Zend_Service_Delicious_Post

deleteBundle ( $bundle )

Delete a bundle.

Parameters

string $bundle Name of bundle to be deleted

Returns: Zend_Service_Delicious Provides a fluent interface

deletePost ( $url )

Delete a post.

Parameters

string $url URL of post to be deleted

Returns: Zend_Service_Delicious Provides a fluent interface

getAllPosts ( $tag = null )

Get all posts.

Parameters

string $tag Optional filtering by tag

Returns: Zend_Service_Delicious_PostList

getBundles ( )

Get all bundles, returning an array with bundles as keys and array of tags as values.

Returns: array list of bundles

getDates ( $tag = null )

Get number of posts by date.

Returns array where keys are dates and values are numbers of posts

Parameters

string $tag Optional filtering by tag

Returns: array list of dates

getLastUpdate ( )

Get time of the last update.

Exceptions

Zend_Service_Delicious_Exception

Returns: Zend_Date

Todo:: replace strtotime() with Zend_Date equivalent

See Also: Zend_Service_Delicious_Exception

getPosts	(		$tag = `null`,
		Zend_Date	$dt = `null`,
			$url = `null`
	)

Get posts matching the arguments.

If no date or url is given, most recent date will be used

Parameters

string	$tag	Optional filtering by tag
Zend_Date	$dt	Optional filtering by date
string	$url	Optional filtering by url

Exceptions

Zend_Service_Delicious_Exception

Returns: Zend_Service_Delicious_PostList

getRecentPosts	(	$tag = `null`,
		$count = `15`
	)

Get recent posts.

Parameters

string	$tag	Optional filtering by tag
string	$count	Maximum number of posts to be returned (default 15)

Returns: Zend_Service_Delicious_PostList

getTags ( )

Get all tags, returning an array with tags as keys and number of corresponding posts as values.

Returns: array list of tags

getUrlDetails ( $url )

Get details on a particular bookmarked URL.

Returned array contains four elements:

hash - md5 hash of URL
top_tags - array of tags and their respective usage counts
url - URL for which details were returned
total_posts - number of users that have bookmarked URL

If URL hasen't been bookmarked null is returned.

Parameters

string $url URL for which to get details

Returns: array

getUserFans ( $user )

Get fans of a user.

Parameters

string $user Owner of the fans

Returns: array

getUserNetwork ( $user )

Get network of a user.

Parameters

string $user Owner of the network

Returns: array

getUserPosts	(	$user,
		$count = `null`,
		$tag = `null`
	)

Get posts of a user.

Parameters

string	$user	Owner of the posts
int	$count	Number of posts (default 15, max. 100)
string	$tag	Optional filtering by tag

Returns: Zend_Service_Delicious_PostList

getUserTags	(	$user,
		$atleast = `null`,
		$count = `null`,
		$sort = `'alpha'`
	)

Get tags of a user.

Returned array has tags as keys and number of posts as values

Parameters

string	$user	Owner of the posts
int	$atleast	Include only tags for which there are at least ### number of posts
int	$count	Number of tags to get (default all)
string	$sort	Order of returned tags ('alpha' \|\| 'count')

Returns: array

makeRequest	(		$path,
		array	$parms = `array()`,
			$type = `'xml'`
	)

Handles all GET requests to a web service.

Parameters

string	$path	Path
array	$parms	Array of GET parameters
string	$type	Type of a request ("xml"\|"json")

Returns: mixed decoded response from web service

Exceptions

Zend_Service_Delicious_Exception

See Also: Zend_Service_Delicious_Exception; Zend_Service_Delicious_Exception; Zend_Service_Delicious_Exception

renameTag	(	$old,
		$new
	)

Rename a tag.

Parameters

string	$old	Old tag name
string	$new	New tag name

Returns: Zend_Service_Delicious Provides a fluent interface

setAuth	(	$uname,
		$pass
	)

Set client username and password.

Parameters

string	$uname	Client user name
string	$pass	Client password

Returns: Zend_Service_Delicious Provides a fluent interface

Member Data Documentation

$_authPass

protected

$_authUname

protected

$_lastRequestTime = 0

staticprotected

$_rest

protected

const API_URI = 'https://api.del.icio.us'

const JSON_FANS = '/feeds/json/fans/%s'

const JSON_NETWORK = '/feeds/json/network/%s'

const JSON_POSTS = '/feeds/json/%s/%s'

const JSON_TAGS = '/feeds/json/tags/%s'

const JSON_URI = 'http://del.icio.us'

const JSON_URL = '/feeds/json/url/data'

const PATH_BUNDLE_ADD = '/v1/tags/bundles/set'

const PATH_BUNDLE_DELETE = '/v1/tags/bundles/delete'

const PATH_BUNDLES = '/v1/tags/bundles/all'

const PATH_DATES = '/v1/posts/dates'

const PATH_POST_DELETE = '/v1/posts/delete'

const PATH_POSTS_ADD = '/v1/posts/add'

const PATH_POSTS_ALL = '/v1/posts/all'

const PATH_POSTS_GET = '/v1/posts/get'

const PATH_POSTS_RECENT = '/v1/posts/recent'

const PATH_TAG_RENAME = '/v1/tags/rename'

const PATH_TAGS = '/v1/tags/get'

const PATH_UPDATE = '/v1/posts/update'

Public Member Functions

Public Attributes

Protected Attributes

Static Protected Attributes

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation