phpBB API Documentation
Class

phpbb\avatar\driver\upload

class upload extends driver

Handles avatars uploaded to the board

Methods

__construct(config $config, string $phpbb_root_path, string $php_ext, filesystem_interface $filesystem, path_helper $path_helper, dispatcher_interface $dispatcher, factory $files_factory, driver_interface $cache = null)

Construct a driver object
string get_custom_html(user $user, array $row, string $alt = '')

Returns custom html if it is needed for displaying this avatar

 from driver
array prepare_form_acp(user $user)

Prepare form for changing the acp settings of this avatar
bool delete(array $row)

Delete avatar
string get_name()

Returns the name of the driver.

 from driver
string get_config_name()

Returns the config name of the driver.

 from driver
string get_acp_template_name()

Get the avatar driver's template name (ACP)

 from driver
set_name(string $name)

Sets the name of the driver.

 from driver
array get_data(array $row)

Get the avatar url and dimensions
bool prepare_form(request $request, template $template, user $user, array $row, array $error)

Prepare form for changing the settings of this avatar
array process_form(request $request, template $template, user $user, array $row, array $error)

Process form data
string get_template_name()

Get the avatar driver's template name

Details

at line 48
public __construct(config $config, string $phpbb_root_path, string $php_ext, filesystem_interface $filesystem, path_helper $path_helper, dispatcher_interface $dispatcher, factory $files_factory, driver_interface $cache = null)

Construct a driver object

Parameters

config $config phpBB configuration
string $phpbb_root_path Path to the phpBB root
string $php_ext PHP file extension
filesystem_interface $filesystem phpBB filesystem helper
path_helper $path_helper phpBB path helper
dispatcher_interface $dispatcher phpBB Event dispatcher object
factory $files_factory File classes factory
driver_interface $cache Cache driver

in driver at line 98
public string get_custom_html(user $user, array $row, string $alt = '')

Returns custom html if it is needed for displaying this avatar

Parameters

user $user phpBB user object
array $row User data or group data that has been cleaned with \phpbb\avatar\manager::clean_row
string $alt Alternate text for avatar image

Return Value

string HTML

at line 259
public array prepare_form_acp(user $user)

Prepare form for changing the acp settings of this avatar

Parameters

user $user phpBB user object

Return Value

array Array of configuration options as consumed by acp_board. The setting for enabling/disabling the avatar will be handled by the avatar manager.

at line 271
public bool delete(array $row)

Delete avatar

Parameters

array $row User data or group data that has been cleaned with \phpbb\avatar\manager::clean_row

Return Value

bool True if avatar has been deleted or there is no need to delete, i.e. when the avatar is not hosted locally.

in driver at line 122
public string get_name()

Returns the name of the driver.

Return Value

string Name of driver.

in driver at line 130
public string get_config_name()

Returns the config name of the driver.

To be used in accessing the CONFIG variables.

Return Value

string Config name of driver.

in driver at line 138
public string get_acp_template_name()

Get the avatar driver's template name (ACP)

Return Value

string Avatar driver's template name

in driver at line 148
public set_name(string $name)

Sets the name of the driver.

Parameters

string $name Driver name

at line 63
public array get_data(array $row)

Get the avatar url and dimensions

Parameters

array $row User data or group data that has been cleaned with \phpbb\avatar\manager::clean_row

Return Value

array Avatar data, must have keys src, width and height, e.g. ['src' => '', 'width' => 0, 'height' => 0]

at line 77
public bool prepare_form(request $request, template $template, user $user, array $row, array $error)

Prepare form for changing the settings of this avatar

Parameters

request $request Request object
template $template Template object
user $user User object
array $row User data or group data that has been cleaned with \phpbb\avatar\manager::clean_row
array $error Reference to an error array that is filled by this function. Key values can either be a string with a language key or an array that will be passed to vsprintf() with the language key in the first array key.

Return Value

bool True if form has been successfully prepared

at line 95
public array process_form(request $request, template $template, user $user, array $row, array $error)

Process form data

Parameters

request $request Request object
template $template Template object
user $user User object
array $row User data or group data that has been cleaned with \phpbb\avatar\manager::clean_row
array $error Reference to an error array that is filled by this function. Key values can either be a string with a language key or an array that will be passed to vsprintf() with the language key in the first array key.

Return Value

array Array containing the avatar data as follows: ['avatar'], ['avatarwidth'], ['avatarheight']

at line 317
public string get_template_name()

Get the avatar driver's template name

Return Value

string Avatar driver's template name