3 * @copyright Copyright (C) 2010-2023, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Module\Settings;
24 use Friendica\BaseModule;
25 use Friendica\Core\Renderer;
26 use Friendica\Database\DBA;
28 use Friendica\Model\User;
29 use Friendica\Module\BaseSettings;
30 use Friendica\Network\HTTPException;
31 use Friendica\Util\Strings;
34 * Account delegation settings module
36 class Delegation extends BaseSettings
38 protected function post(array $request = [])
40 if (!DI::app()->isLoggedIn()) {
41 throw new HTTPException\ForbiddenException(DI::l10n()->t('Permission denied.'));
44 BaseModule::checkFormSecurityTokenRedirectOnError('settings/delegation', 'delegate');
46 $parent_uid = $request['parent_user'] ?? null;
47 $parent_password = $request['parent_password'] ?? '';
51 // An integer value will trigger the direct user query on uid in User::getAuthenticationInfo
52 $parent_uid = (int)$parent_uid;
53 User::getIdFromPasswordAuthentication($parent_uid, $parent_password);
54 DI::sysmsg()->addInfo(DI::l10n()->t('Delegation successfully granted.'));
55 } catch (\Exception $ex) {
56 DI::sysmsg()->addNotice(DI::l10n()->t('Parent user not found, unavailable or password doesn\'t match.'));
60 DI::sysmsg()->addInfo(DI::l10n()->t('Delegation successfully revoked.'));
63 DBA::update('user', ['parent-uid' => $parent_uid], ['uid' => DI::userSession()->getLocalUserId()]);
66 protected function content(array $request = []): string
70 if (!DI::userSession()->getLocalUserId()) {
71 throw new HTTPException\ForbiddenException(DI::l10n()->t('Permission denied.'));
76 // @TODO Replace with router-provided arguments
77 $action = $args->get(2);
78 $user_id = $args->get(3);
80 if ($action === 'add' && $user_id) {
81 if (DI::userSession()->getSubManagedUserId()) {
82 DI::sysmsg()->addNotice(DI::l10n()->t('Delegated administrators can view but not change delegation permissions.'));
83 DI::baseUrl()->redirect('settings/delegation');
86 $user = User::getById($user_id, ['nickname']);
87 if (DBA::isResult($user)) {
89 'uid' => DI::userSession()->getLocalUserId(),
90 'nurl' => Strings::normaliseLink(DI::baseUrl() . '/profile/' . $user['nickname'])
92 if (DBA::exists('contact', $condition)) {
93 DBA::insert('manage', ['uid' => $user_id, 'mid' => DI::userSession()->getLocalUserId()]);
96 DI::sysmsg()->addNotice(DI::l10n()->t('Delegate user not found.'));
99 DI::baseUrl()->redirect('settings/delegation');
102 if ($action === 'remove' && $user_id) {
103 if (DI::userSession()->getSubManagedUserId()) {
104 DI::sysmsg()->addNotice(DI::l10n()->t('Delegated administrators can view but not change delegation permissions.'));
105 DI::baseUrl()->redirect('settings/delegation');
108 DBA::delete('manage', ['uid' => $user_id, 'mid' => DI::userSession()->getLocalUserId()]);
109 DI::baseUrl()->redirect('settings/delegation');
112 // find everybody that currently has delegated management to this account/page
113 $delegates = DBA::selectToArray('user', [], ['`uid` IN (SELECT `uid` FROM `manage` WHERE `mid` = ?)', DI::userSession()->getLocalUserId()]);
116 foreach ($delegates as $user) {
117 $uids[] = $user['uid'];
120 // find every contact who might be a candidate for delegation
124 $condition = ['baseurl' => DI::baseUrl(), 'self' => false, 'uid' => DI::userSession()->getLocalUserId(), 'blocked' => false];
125 $contacts = DBA::select('contact', ['nick'], $condition);
126 while ($contact = DBA::fetch($contacts)) {
127 $nicknames[] = $contact['nick'];
129 DBA::close($contacts);
131 // get user records for all potential page delegates who are not already delegates or managers
132 $potentialDelegateUsers = DBA::selectToArray('user', ['uid', 'username', 'nickname'], ['nickname' => $nicknames]);
133 foreach ($potentialDelegateUsers as $user) {
134 if (!in_array($user['uid'], $uids)) {
135 $potentials[] = $user;
140 $parent_password = null;
141 $user = User::getById(DI::userSession()->getLocalUserId(), ['parent-uid', 'email']);
142 if (DBA::isResult($user) && !DBA::exists('user', ['parent-uid' => DI::userSession()->getLocalUserId()])) {
143 $parent_uid = $user['parent-uid'];
144 $parents = [0 => DI::l10n()->t('No parent user')];
146 $fields = ['uid', 'username', 'nickname'];
147 $condition = ['email' => $user['email'], 'verified' => true, 'blocked' => false, 'parent-uid' => null];
148 $parent_users = DBA::selectToArray('user', $fields, $condition);
149 foreach($parent_users as $parent) {
150 if ($parent['uid'] != DI::userSession()->getLocalUserId()) {
151 $parents[$parent['uid']] = sprintf('%s (%s)', $parent['username'], $parent['nickname']);
155 $parent_user = ['parent_user', DI::l10n()->t('Parent User'), $parent_uid, '', $parents];
156 $parent_password = ['parent_password', DI::l10n()->t('Parent Password:'), '', DI::l10n()->t('Please enter the password of the parent account to legitimize your request.')];
159 $is_child_user = !empty($user['parent-uid']);
161 $o = Renderer::replaceMacros(Renderer::getMarkupTemplate('settings/delegation.tpl'), [
162 '$form_security_token' => BaseModule::getFormSecurityToken('delegate'),
163 '$account_header' => DI::l10n()->t('Additional Accounts'),
164 '$account_desc' => DI::l10n()->t('Register additional accounts that are automatically connected to your existing account so you can manage them from this account.'),
165 '$add_account' => DI::l10n()->t('Register an additional account'),
166 '$parent_header' => DI::l10n()->t('Parent User'),
167 '$parent_user' => $parent_user,
168 '$parent_password' => $parent_password,
169 '$parent_desc' => DI::l10n()->t('Parent users have total control about this account, including the account settings. Please double check whom you give this access.'),
170 '$is_child_user' => $is_child_user,
171 '$submit' => DI::l10n()->t('Save Settings'),
172 '$header' => DI::l10n()->t('Manage Accounts'),
173 '$delegates_header' => DI::l10n()->t('Delegates'),
174 '$base' => DI::baseUrl(),
175 '$desc' => DI::l10n()->t('Delegates are able to manage all aspects of this account/page except for basic account settings. Please do not delegate your personal account to anybody that you do not trust completely.'),
176 '$head_delegates' => DI::l10n()->t('Existing Page Delegates'),
177 '$delegates' => $delegates,
178 '$head_potentials' => DI::l10n()->t('Potential Delegates'),
179 '$potentials' => $potentials,
180 '$remove' => DI::l10n()->t('Remove'),
181 '$add' => DI::l10n()->t('Add'),
182 '$none' => DI::l10n()->t('No entries.')