Avatar Class Reference

Inheritance diagram for Avatar:

Collaboration diagram for Avatar:

Public Member Functions
	getAvatarDirectoryUrl ()
	getAvatarDirectoryPath ()
	getCustomAvatarUrl ($size, $ext= 'png')
	getCustomAvatarPath ($size, $ext= 'png')
	getFilename ($size, $ext= 'png')
	getURL ($size, $ext= 'png')
	is_customized ()
	getImageTag ($size=Avatar::MEDIUM, $opt=array())
	createFromUpload ($userfile)
	createFrom ($filename)
	reset ()
	getDimension ($size)
	getDefaultTitle ()

Static Public Member Functions
static	getAvatar ($user_id, $username=NULL)
static	getNobody ()
static	error_handler ($errno, $errstr, $errfile, $errline)

Data Fields
const	NORMAL = 'normal'
const	MEDIUM = 'medium'
const	SMALL = 'small'
const	MAX_FILE_SIZE = 716800
const	NOBODY = 'nobody'

Protected Member Functions
	__construct ($user_id, $username=NULL)
	getCssClass ($size)

Protected Attributes
	$user_id
	$username

Constructor & Destructor Documentation

__construct (   $user_id,   $username = NULL  )

protected

Constructs a new Avatar object belonging to a user with the given id.

Parameters

string	the user's id
string	the user's username (optional)

Returns

void

Member Function Documentation

createFrom

(

$filename

)

Creates thumbnails from an image.

Parameters

string

filename of the image to create thumbnails from

Returns

void

Here is the caller graph for this function:

createFromUpload

(

$userfile

)

Creates all the different sized thumbnails for an uploaded file.

Parameters

string

the key of the uploaded file, see documentation about $_FILES

Returns

void

Exceptions

several

Exceptions if the uploaded file does not satisfy the requirements

Here is the call graph for this function:

static error_handler (   $errno,   $errstr,   $errfile,   $errline  )

static

static getAvatar (   $user_id,   $username = NULL  )

static

Returns an avatar object of the appropriate class.

Parameters

string	the user's id
string	the user's username (optional)

Returns

mixed the user's avatar.

Here is the caller graph for this function:

getAvatarDirectoryPath

(

)

Reimplemented in InstituteAvatar, and CourseAvatar.

Here is the caller graph for this function:

getAvatarDirectoryUrl

(

)

Reimplemented in InstituteAvatar, and CourseAvatar.

Here is the caller graph for this function:

getCssClass (   $size )

protected

Returns the CSS class to use for this avatar image.

Parameters

string

one of the constants Avatar::(NORMAL|MEDIUM|SMALL)

Returns

string CSS class to use for the avatar

Reimplemented in CourseAvatar.

Here is the call graph for this function:

Here is the caller graph for this function:

getCustomAvatarPath	(		$size,
			$ext = 'png'
	)

Here is the call graph for this function:

Here is the caller graph for this function:

getCustomAvatarUrl	(		$size,
			$ext = 'png'
	)

Here is the call graph for this function:

Here is the caller graph for this function:

getDefaultTitle

(

)

Return the default title of the avatar.

Returns

string the default title

Reimplemented in CourseAvatar, and InstituteAvatar.

Here is the call graph for this function:

Here is the caller graph for this function:

getDimension

(

$size

)

Return the dimension of a size

Parameters

string

the dimension of a size

Returns

array a tupel of integers [width, height]

Reimplemented in CourseAvatar.

getFilename	(		$size,
			$ext = 'png'
	)

Returns the file name of a user's avatar.

Parameters

string	one of the constants Avatar::(NORMAL|MEDIUM|SMALL)
string	an optional extension of the avatar

Returns

string the absolute file path to the avatar

Here is the call graph for this function:

getImageTag	(		$size = Avatar::MEDIUM,
			$opt = array()
	)

Constructs a desired HTML image tag for an Avatar. Additional html attributes may also be specified using the $opt parameter.

Parameters

string	one of the constants Avatar::(NORMAL|MEDIUM|SMALL)
array	array of attributes to add to the HTML image tag

Returns

string returns the HTML image tag

Here is the call graph for this function:

static getNobody ( )

static

Returns an avatar object for "nobody".

Returns

mixed the user's avatar.

Reimplemented in InstituteAvatar, CourseAvatar, and StudygroupAvatar.

Here is the caller graph for this function:

getURL	(		$size,
			$ext = 'png'
	)

Returns the URL of a user's picture.

Parameters

string	one of the constants Avatar::(NORMAL|MEDIUM|SMALL)
string	an optional extension of the user's picture

Returns

string the URL to the user's picture

Here is the call graph for this function:

Here is the caller graph for this function:

is_customized

(

)

Returns whether a user has uploaded a custom picture.

Returns

boolean returns TRUE if the user customized her picture, FALSE otherwise.

Here is the call graph for this function:

Here is the caller graph for this function:

reset

(

)

Removes all uploaded pictures of a user.

Returns

void

Here is the call graph for this function:

Field Documentation

$user_id

protected

$username

protected

const MAX_FILE_SIZE = 716800

This constant represents the maximal size of a user picture in bytes.

const MEDIUM = 'medium'

This constant stands for a medium size of a user picture.

const NOBODY = 'nobody'

This constant holds the username and ID of the "nobody" avatar.

const NORMAL = 'normal'

This constant stands for the maximal size of a user picture.

const SMALL = 'small'

This constant stands for an icon size of a user picture.

---

The documentation for this class was generated from the following file:

• lib/classes/Avatar.class.php