aboutsummaryrefslogtreecommitdiff
blob: ef149693a048e6463220c910428842a0d90c5ac5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
<?php
/**
 *
 * This file is part of the phpBB Forum Software package.
 *
 * @copyright (c) phpBB Limited <https://www.phpbb.com>
 * @license GNU General Public License, version 2 (GPL-2.0)
 *
 * For full copyright and license information, please see
 * the docs/CREDITS.txt file.
 *
 */

namespace phpbb\template\twig\extension;

class username extends \Twig_Extension
{
	/**
	 * Get the name of this extension
	 *
	 * @return string
	 */
	public function getName()
	{
		return 'username';
	}

	/**
	 * Returns a list of global functions to add to the existing list.
	 *
	 * @return array An array of global functions
	 */
	public function getFunctions()
	{
		return array(
			new \Twig_SimpleFunction('username', array($this, 'get_username')),
		);
	}

	/**
	 * Get username details for placing into templates.
	 *
	 * How to use in a template:
	 * - {{ username('mode', user_id, username, user_colour, guest_username, custom_profile_url) }}
	 * - {{ username('mode', user_row, guest_username, custom_profile_url) }}
	 * It's possible to provide the user identifier, name and colour separately,
	 * or provide the entire user row at once as an array.
	 *
	 * The mode, user_id and username are required (separately or through a user row).
	 * The other fields (user_colour|guest_username|custom_profile_url) are optional.
	 *
	 * @uses \get_username_string()
	 *
	 * @return string		A string based on what is wanted depending on $mode
	 */
	public function get_username()
	{
		$args = func_get_args();

		$mode = $args[0];
		$user = $args[1];

		// If the entire user row is provided
		if (is_array($user))
		{
			$user_id = isset($user['user_id']) ? $user['user_id'] : '';
			$username = isset($user['username']) ? $user['username'] : '';
			$user_colour = isset($user['user_colour']) ? $user['user_colour'] : '';
			$guest_username = isset($args[2]) ? $args[2] : false;
			$custom_profile_url = isset($args[3]) ? $args[3] : false;
		}
		else
		{
			// Options are provided separately
			$user_id = $user;
			$username = $args[2];
			$user_colour = isset($args[3]) ? $args[3] : '';
			$guest_username = isset($args[4]) ? $args[4] : false;
			$custom_profile_url = isset($args[5]) ? $args[5] : false;
		}

		return get_username_string($mode, $user_id, $username, $user_colour, $guest_username, $custom_profile_url);
	}
}