@@ -36,10 +36,10 @@ |
||
36 | 36 | * @since 21.0.0 |
37 | 37 | */ |
38 | 38 | interface IRequestContext { |
39 | - /** |
|
40 | - * @return IRequest |
|
41 | - * |
|
42 | - * @since 21.0.0 |
|
43 | - */ |
|
44 | - public function getHttpRequest(): IRequest; |
|
39 | + /** |
|
40 | + * @return IRequest |
|
41 | + * |
|
42 | + * @since 21.0.0 |
|
43 | + */ |
|
44 | + public function getHttpRequest(): IRequest; |
|
45 | 45 | } |
@@ -34,14 +34,14 @@ |
||
34 | 34 | * @since 21.0.0 |
35 | 35 | */ |
36 | 36 | interface IHandler { |
37 | - /** |
|
38 | - * @param string $service the name of the well known service, e.g. 'webfinger' |
|
39 | - * @param IRequestContext $context |
|
40 | - * @param IResponse|null $previousResponse the response of the previous handler, if any |
|
41 | - * |
|
42 | - * @return IResponse|null a response object if the request could be handled, null otherwise |
|
43 | - * |
|
44 | - * @since 21.0.0 |
|
45 | - */ |
|
46 | - public function handle(string $service, IRequestContext $context, ?IResponse $previousResponse): ?IResponse; |
|
37 | + /** |
|
38 | + * @param string $service the name of the well known service, e.g. 'webfinger' |
|
39 | + * @param IRequestContext $context |
|
40 | + * @param IResponse|null $previousResponse the response of the previous handler, if any |
|
41 | + * |
|
42 | + * @return IResponse|null a response object if the request could be handled, null otherwise |
|
43 | + * |
|
44 | + * @since 21.0.0 |
|
45 | + */ |
|
46 | + public function handle(string $service, IRequestContext $context, ?IResponse $previousResponse): ?IResponse; |
|
47 | 47 | } |
@@ -31,8 +31,8 @@ |
||
31 | 31 | * @since 21.0.0 |
32 | 32 | */ |
33 | 33 | interface IResponse { |
34 | - /** |
|
35 | - * @since 21.0.0 |
|
36 | - */ |
|
37 | - public function toHttpResponse(): Response; |
|
34 | + /** |
|
35 | + * @since 21.0.0 |
|
36 | + */ |
|
37 | + public function toHttpResponse(): Response; |
|
38 | 38 | } |
@@ -31,10 +31,10 @@ |
||
31 | 31 | * @since 18.0.1 |
32 | 32 | */ |
33 | 33 | interface IDataLogger { |
34 | - /** |
|
35 | - * allows to log custom data, similar to how logException works |
|
36 | - * |
|
37 | - * @since 18.0.1 |
|
38 | - */ |
|
39 | - public function logData(string $message, array $data, array $context = []): void; |
|
34 | + /** |
|
35 | + * allows to log custom data, similar to how logException works |
|
36 | + * |
|
37 | + * @since 18.0.1 |
|
38 | + */ |
|
39 | + public function logData(string $message, array $data, array $context = []): void; |
|
40 | 40 | } |
@@ -26,10 +26,10 @@ |
||
26 | 26 | * @since 12.0 |
27 | 27 | */ |
28 | 28 | interface IProvider { |
29 | - /** |
|
30 | - * @since 12.0 |
|
31 | - * @param IEntry $entry |
|
32 | - * @return void |
|
33 | - */ |
|
34 | - public function process(IEntry $entry); |
|
29 | + /** |
|
30 | + * @since 12.0 |
|
31 | + * @param IEntry $entry |
|
32 | + * @return void |
|
33 | + */ |
|
34 | + public function process(IEntry $entry); |
|
35 | 35 | } |
@@ -26,15 +26,15 @@ |
||
26 | 26 | * @since 12.0 |
27 | 27 | */ |
28 | 28 | interface ILinkAction extends IAction { |
29 | - /** |
|
30 | - * @param string $href the target URL of the action |
|
31 | - * @since 12.0 |
|
32 | - */ |
|
33 | - public function setHref(string $href); |
|
29 | + /** |
|
30 | + * @param string $href the target URL of the action |
|
31 | + * @since 12.0 |
|
32 | + */ |
|
33 | + public function setHref(string $href); |
|
34 | 34 | |
35 | - /** |
|
36 | - * @since 12.0 |
|
37 | - * @return string |
|
38 | - */ |
|
39 | - public function getHref(): string; |
|
35 | + /** |
|
36 | + * @since 12.0 |
|
37 | + * @return string |
|
38 | + */ |
|
39 | + public function getHref(): string; |
|
40 | 40 | } |
@@ -26,29 +26,29 @@ |
||
26 | 26 | * @since 12.0 |
27 | 27 | */ |
28 | 28 | interface IActionFactory { |
29 | - /** |
|
30 | - * Construct and return a new link action for the contacts menu |
|
31 | - * |
|
32 | - * @since 12.0 |
|
33 | - * |
|
34 | - * @param string $icon full path to the action's icon |
|
35 | - * @param string $name localized name of the action |
|
36 | - * @param string $href target URL |
|
37 | - * @param string $appId the app ID registering the action |
|
38 | - * @return ILinkAction |
|
39 | - */ |
|
40 | - public function newLinkAction(string $icon, string $name, string $href, string $appId = ''): ILinkAction; |
|
29 | + /** |
|
30 | + * Construct and return a new link action for the contacts menu |
|
31 | + * |
|
32 | + * @since 12.0 |
|
33 | + * |
|
34 | + * @param string $icon full path to the action's icon |
|
35 | + * @param string $name localized name of the action |
|
36 | + * @param string $href target URL |
|
37 | + * @param string $appId the app ID registering the action |
|
38 | + * @return ILinkAction |
|
39 | + */ |
|
40 | + public function newLinkAction(string $icon, string $name, string $href, string $appId = ''): ILinkAction; |
|
41 | 41 | |
42 | - /** |
|
43 | - * Construct and return a new email action for the contacts menu |
|
44 | - * |
|
45 | - * @since 12.0 |
|
46 | - * |
|
47 | - * @param string $icon full path to the action's icon |
|
48 | - * @param string $name localized name of the action |
|
49 | - * @param string $email target e-mail address |
|
50 | - * @param string $appId the appName registering the action |
|
51 | - * @return ILinkAction |
|
52 | - */ |
|
53 | - public function newEMailAction(string $icon, string $name, string $email, string $appId = ''): ILinkAction; |
|
42 | + /** |
|
43 | + * Construct and return a new email action for the contacts menu |
|
44 | + * |
|
45 | + * @since 12.0 |
|
46 | + * |
|
47 | + * @param string $icon full path to the action's icon |
|
48 | + * @param string $name localized name of the action |
|
49 | + * @param string $email target e-mail address |
|
50 | + * @param string $appId the appName registering the action |
|
51 | + * @return ILinkAction |
|
52 | + */ |
|
53 | + public function newEMailAction(string $icon, string $name, string $email, string $appId = ''): ILinkAction; |
|
54 | 54 | } |
@@ -30,19 +30,19 @@ |
||
30 | 30 | * @since 13.0.0 |
31 | 31 | */ |
32 | 32 | interface IContactsStore { |
33 | - /** |
|
34 | - * @param IUser $user |
|
35 | - * @param string|null $filter |
|
36 | - * @param int|null $limit added 19.0.2 |
|
37 | - * @param int|null $offset added 19.0.2 |
|
38 | - * @return IEntry[] |
|
39 | - * @since 13.0.0 |
|
40 | - */ |
|
41 | - public function getContacts(IUser $user, ?string $filter, ?int $limit = null, ?int $offset = null): array; |
|
33 | + /** |
|
34 | + * @param IUser $user |
|
35 | + * @param string|null $filter |
|
36 | + * @param int|null $limit added 19.0.2 |
|
37 | + * @param int|null $offset added 19.0.2 |
|
38 | + * @return IEntry[] |
|
39 | + * @since 13.0.0 |
|
40 | + */ |
|
41 | + public function getContacts(IUser $user, ?string $filter, ?int $limit = null, ?int $offset = null): array; |
|
42 | 42 | |
43 | - /** |
|
44 | - * @brief finds a contact by specifying the property to search on ($shareType) and the value ($shareWith) |
|
45 | - * @since 13.0.0 |
|
46 | - */ |
|
47 | - public function findOne(IUser $user, int $shareType, string $shareWith): ?IEntry; |
|
43 | + /** |
|
44 | + * @brief finds a contact by specifying the property to search on ($shareType) and the value ($shareWith) |
|
45 | + * @since 13.0.0 |
|
46 | + */ |
|
47 | + public function findOne(IUser $user, int $shareType, string $shareWith): ?IEntry; |
|
48 | 48 | } |
@@ -39,96 +39,96 @@ |
||
39 | 39 | * @since 19.0.0 |
40 | 40 | */ |
41 | 41 | class ContactInteractedWithEvent extends Event { |
42 | - /** @var IUser */ |
|
43 | - private $actor; |
|
42 | + /** @var IUser */ |
|
43 | + private $actor; |
|
44 | 44 | |
45 | - /** @var string|null */ |
|
46 | - private $uid; |
|
45 | + /** @var string|null */ |
|
46 | + private $uid; |
|
47 | 47 | |
48 | - /** @var string|null */ |
|
49 | - private $email; |
|
48 | + /** @var string|null */ |
|
49 | + private $email; |
|
50 | 50 | |
51 | - /** @var string|null */ |
|
52 | - private $federatedCloudId; |
|
51 | + /** @var string|null */ |
|
52 | + private $federatedCloudId; |
|
53 | 53 | |
54 | - /** |
|
55 | - * @param IUser $actor the user who started the interaction |
|
56 | - * |
|
57 | - * @since 19.0.0 |
|
58 | - */ |
|
59 | - public function __construct(IUser $actor) { |
|
60 | - parent::__construct(); |
|
61 | - $this->actor = $actor; |
|
62 | - } |
|
54 | + /** |
|
55 | + * @param IUser $actor the user who started the interaction |
|
56 | + * |
|
57 | + * @since 19.0.0 |
|
58 | + */ |
|
59 | + public function __construct(IUser $actor) { |
|
60 | + parent::__construct(); |
|
61 | + $this->actor = $actor; |
|
62 | + } |
|
63 | 63 | |
64 | - /** |
|
65 | - * @return IUser |
|
66 | - * @since 19.0.0 |
|
67 | - */ |
|
68 | - public function getActor(): IUser { |
|
69 | - return $this->actor; |
|
70 | - } |
|
64 | + /** |
|
65 | + * @return IUser |
|
66 | + * @since 19.0.0 |
|
67 | + */ |
|
68 | + public function getActor(): IUser { |
|
69 | + return $this->actor; |
|
70 | + } |
|
71 | 71 | |
72 | - /** |
|
73 | - * @return string|null |
|
74 | - * @since 19.0.0 |
|
75 | - */ |
|
76 | - public function getUid(): ?string { |
|
77 | - return $this->uid; |
|
78 | - } |
|
72 | + /** |
|
73 | + * @return string|null |
|
74 | + * @since 19.0.0 |
|
75 | + */ |
|
76 | + public function getUid(): ?string { |
|
77 | + return $this->uid; |
|
78 | + } |
|
79 | 79 | |
80 | - /** |
|
81 | - * Set the uid of the person interacted with, if known |
|
82 | - * |
|
83 | - * @param string $uid |
|
84 | - * |
|
85 | - * @return self |
|
86 | - * @since 19.0.0 |
|
87 | - */ |
|
88 | - public function setUid(string $uid): self { |
|
89 | - $this->uid = $uid; |
|
90 | - return $this; |
|
91 | - } |
|
80 | + /** |
|
81 | + * Set the uid of the person interacted with, if known |
|
82 | + * |
|
83 | + * @param string $uid |
|
84 | + * |
|
85 | + * @return self |
|
86 | + * @since 19.0.0 |
|
87 | + */ |
|
88 | + public function setUid(string $uid): self { |
|
89 | + $this->uid = $uid; |
|
90 | + return $this; |
|
91 | + } |
|
92 | 92 | |
93 | - /** |
|
94 | - * @return string|null |
|
95 | - * @since 19.0.0 |
|
96 | - */ |
|
97 | - public function getEmail(): ?string { |
|
98 | - return $this->email; |
|
99 | - } |
|
93 | + /** |
|
94 | + * @return string|null |
|
95 | + * @since 19.0.0 |
|
96 | + */ |
|
97 | + public function getEmail(): ?string { |
|
98 | + return $this->email; |
|
99 | + } |
|
100 | 100 | |
101 | - /** |
|
102 | - * Set the email of the person interacted with, if known |
|
103 | - * |
|
104 | - * @param string $email |
|
105 | - * |
|
106 | - * @return self |
|
107 | - * @since 19.0.0 |
|
108 | - */ |
|
109 | - public function setEmail(string $email): self { |
|
110 | - $this->email = $email; |
|
111 | - return $this; |
|
112 | - } |
|
101 | + /** |
|
102 | + * Set the email of the person interacted with, if known |
|
103 | + * |
|
104 | + * @param string $email |
|
105 | + * |
|
106 | + * @return self |
|
107 | + * @since 19.0.0 |
|
108 | + */ |
|
109 | + public function setEmail(string $email): self { |
|
110 | + $this->email = $email; |
|
111 | + return $this; |
|
112 | + } |
|
113 | 113 | |
114 | - /** |
|
115 | - * @return string|null |
|
116 | - * @since 19.0.0 |
|
117 | - */ |
|
118 | - public function getFederatedCloudId(): ?string { |
|
119 | - return $this->federatedCloudId; |
|
120 | - } |
|
114 | + /** |
|
115 | + * @return string|null |
|
116 | + * @since 19.0.0 |
|
117 | + */ |
|
118 | + public function getFederatedCloudId(): ?string { |
|
119 | + return $this->federatedCloudId; |
|
120 | + } |
|
121 | 121 | |
122 | - /** |
|
123 | - * Set the federated cloud of the person interacted with, if known |
|
124 | - * |
|
125 | - * @param string $federatedCloudId |
|
126 | - * |
|
127 | - * @return self |
|
128 | - * @since 19.0.0 |
|
129 | - */ |
|
130 | - public function setFederatedCloudId(string $federatedCloudId): self { |
|
131 | - $this->federatedCloudId = $federatedCloudId; |
|
132 | - return $this; |
|
133 | - } |
|
122 | + /** |
|
123 | + * Set the federated cloud of the person interacted with, if known |
|
124 | + * |
|
125 | + * @param string $federatedCloudId |
|
126 | + * |
|
127 | + * @return self |
|
128 | + * @since 19.0.0 |
|
129 | + */ |
|
130 | + public function setFederatedCloudId(string $federatedCloudId): self { |
|
131 | + $this->federatedCloudId = $federatedCloudId; |
|
132 | + return $this; |
|
133 | + } |
|
134 | 134 | } |