Elgg  Version 2.2
 All Classes Namespaces Files Functions Variables Pages
Public Member Functions | List of all members
Elgg\EntityIconService Class Reference

WARNING: API IN FLUX. More...

Public Member Functions

 __construct (Config $config, PluginHooksService $hooks, Request $request, Logger $logger, EntityTable $entities)
 Constructor. More...
 
 saveIconFromUploadedFile (ElggEntity $entity, $input_name, $type= 'icon', array $coords=array())
 Saves icons using an uploaded file as the source. More...
 
 saveIconFromLocalFile (ElggEntity $entity, $filename, $type= 'icon', array $coords=array())
 Saves icons using a local file as the source. More...
 
 saveIconFromElggFile (ElggEntity $entity, ElggFile $file, $type= 'icon', array $coords=array())
 Saves icons using a file located in the data store as the source. More...
 
 saveIcon (ElggEntity $entity, ElggFile $file, $type= 'icon', array $coords=array())
 Saves icons using a created temporary file. More...
 
 getIcon (ElggEntity $entity, $size, $type= 'icon')
 Returns entity icon as an ElggIcon object The icon file may or may not exist on filestore. More...
 
 deleteIcon (ElggEntity $entity, $type= 'icon')
 Removes all icon files and metadata for the passed type of icon. More...
 
 getIconURL (ElggEntity $entity, $params=array())
 Get the URL for this entity's icon. More...
 
 getIconLastChange (ElggEntity $entity, $size, $type= 'icon')
 Returns the timestamp of when the icon was changed. More...
 
 hasIcon (\ElggEntity $entity, $size, $type= 'icon')
 Returns if the entity has an icon of the passed type. More...
 
 getSizes ($entity_type=null, $entity_subtype=null, $type= 'icon')
 Returns a configuration array of icon sizes. More...
 
 handleServeIconRequest ($allow_removing_headers=true)
 Handle request to /serve-icon handler. More...
 

Detailed Description

WARNING: API IN FLUX.

DO NOT USE DIRECTLY.

Use the elgg_* versions instead.

private

Since
2.2

Definition at line 25 of file EntityIconService.php.

Constructor & Destructor Documentation

Elgg\EntityIconService::__construct ( Config  $config,
PluginHooksService  $hooks,
Request  $request,
Logger  $logger,
EntityTable  $entities 
)

Constructor.

Parameters
Config$configConfig
PluginHooksService$hooksHook registration service
Request$requestHttp request
Logger$loggerLogger
EntityTable$entitiesEntity table

Definition at line 62 of file EntityIconService.php.

Member Function Documentation

Elgg\EntityIconService::deleteIcon ( ElggEntity  $entity,
  $type = 'icon' 
)

Removes all icon files and metadata for the passed type of icon.

Parameters
ElggEntity$entityEntity that owns icons
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
Returns
bool

Definition at line 331 of file EntityIconService.php.

Elgg\EntityIconService::getIcon ( ElggEntity  $entity,
  $size,
  $type = 'icon' 
)

Returns entity icon as an ElggIcon object The icon file may or may not exist on filestore.

Note
Returned ElggIcon object may be a placeholder. Use ElggIcon::exists() to validate if file has been written to filestore
Parameters
ElggEntity$entityEntity that owns the icon
string$sizeSize of the icon
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
Returns
ElggIcon
Exceptions
InvalidParameterException

Definition at line 300 of file EntityIconService.php.

Elgg\EntityIconService::getIconLastChange ( ElggEntity  $entity,
  $size,
  $type = 'icon' 
)

Returns the timestamp of when the icon was changed.

Parameters
ElggEntity$entityEntity that owns the icon
string$sizeThe size of the icon
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
Returns
int|null A unix timestamp of when the icon was last changed, or null if not set.

Definition at line 402 of file EntityIconService.php.

Elgg\EntityIconService::getIconURL ( ElggEntity  $entity,
  $params = array() 
)

Get the URL for this entity's icon.

Plugins can register for the 'entity:icon:url', <type> plugin hook to customize the icon for an entity.

Parameters
ElggEntity$entityEntity that owns the icon
mixed$paramsA string defining the size of the icon (e.g. tiny, small, medium, large) or an array of parameters including 'size'
Returns
string

Definition at line 365 of file EntityIconService.php.

Elgg\EntityIconService::getSizes (   $entity_type = null,
  $entity_subtype = null,
  $type = 'icon' 
)

Returns a configuration array of icon sizes.

Parameters
string$entity_typeEntity type
string$entity_subtypeEntity subtype
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
Returns
array

Definition at line 429 of file EntityIconService.php.

Elgg\EntityIconService::handleServeIconRequest (   $allow_removing_headers = true)

Handle request to /serve-icon handler.

Parameters
bool$allow_removing_headersAlter PHP's global headers to allow caching
Returns
BinaryFileResponse

Definition at line 466 of file EntityIconService.php.

Elgg\EntityIconService::hasIcon ( \ElggEntity  $entity,
  $size,
  $type = 'icon' 
)

Returns if the entity has an icon of the passed type.

Parameters
ElggEntity$entityEntity that owns the icon
string$sizeThe size of the icon
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
Returns
bool

Definition at line 417 of file EntityIconService.php.

Elgg\EntityIconService::saveIcon ( ElggEntity  $entity,
ElggFile  $file,
  $type = 'icon',
array  $coords = array() 
)

Saves icons using a created temporary file.

Parameters
ElggEntity$entityTemporary ElggFile instance
ElggFile$fileTemporary ElggFile instance
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
array$coordsAn array of cropping coordinates x1, y1, x2, y2
Returns
bool

Definition at line 185 of file EntityIconService.php.

Elgg\EntityIconService::saveIconFromElggFile ( ElggEntity  $entity,
ElggFile  $file,
  $type = 'icon',
array  $coords = array() 
)

Saves icons using a file located in the data store as the source.

Parameters
ElggEntity$entityEntity to own the icons
ElggFile$fileAn ElggFile instance
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
array$coordsAn array of cropping coordinates x1, y1, x2, y2
Returns
bool
Exceptions
InvalidParameterException

Definition at line 153 of file EntityIconService.php.

Elgg\EntityIconService::saveIconFromLocalFile ( ElggEntity  $entity,
  $filename,
  $type = 'icon',
array  $coords = array() 
)

Saves icons using a local file as the source.

Parameters
ElggEntity$entityEntity to own the icons
string$filenameThe full path to the local file
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
array$coordsAn array of cropping coordinates x1, y1, x2, y2
Returns
bool
Exceptions
InvalidParameterException

Definition at line 120 of file EntityIconService.php.

Elgg\EntityIconService::saveIconFromUploadedFile ( ElggEntity  $entity,
  $input_name,
  $type = 'icon',
array  $coords = array() 
)

Saves icons using an uploaded file as the source.

Parameters
ElggEntity$entityEntity to own the icons
string$input_nameForm input name
string$typeThe name of the icon. e.g., 'icon', 'cover_photo'
array$coordsAn array of cropping coordinates x1, y1, x2, y2
Returns
bool

Definition at line 79 of file EntityIconService.php.


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