nextcloud/lib/public/iavatar.php

46 lines
963 B
PHP
Raw Normal View History

2013-11-22 03:43:23 +04:00
<?php
/**
* This file is licensed under the Affero General Public License version 3 or
* later.
* See the COPYING-README file.
*/
namespace OCP;
/**
* This class provides avatar functionality
*/
interface IAvatar {
/**
* get the users avatar
* @param int $size size in px of the avatar, avatars are square, defaults to 64
2013-11-22 03:43:23 +04:00
* @return boolean|\OC_Image containing the avatar or false if there's no image
*/
function get($size = 64);
/**
* Check if an avatar exists for the user
*
* @return bool
*/
public function exists();
2013-11-22 03:43:23 +04:00
/**
* sets the users avatar
* @param Image $data mixed imagedata or path to set a new avatar
* @throws \Exception if the provided file is not a jpg or png image
* @throws \Exception if the provided image is not valid
* @throws \OC\NotSquareException if the image is not square
2013-11-22 03:43:23 +04:00
* @return void
*/
function set($data);
/**
* remove the users avatar
2013-11-22 03:43:23 +04:00
* @return void
*/
function remove();
}