]> git.mxchange.org Git - friendica.git/blobdiff - src/Core/ACL.php
API: Accept "redirect_uris" as both array and string
[friendica.git] / src / Core / ACL.php
index b604218774e3304cc0dc3ea0d4e8baba0e8b3ebf..4ed8d602a484f48a3481ed1dbb31021147d12f52 100644 (file)
@@ -1,7 +1,22 @@
 <?php
-
 /**
- * @file src/Core/Acl.php
+ * @copyright Copyright (C) 2010-2023, the Friendica project
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
  */
 
 namespace Friendica\Core;
@@ -11,84 +26,91 @@ use Friendica\Database\DBA;
 use Friendica\DI;
 use Friendica\Model\Contact;
 use Friendica\Model\Group;
+use Friendica\Model\User;
 
 /**
  * Handle ACL management and display
- *
- * @author Hypolite Petovan <hypolite@mrpetovan.com>
  */
 class ACL
 {
        /**
-        * Returns a select input tag with all the contact of the local user
+        * Returns the default lock state for the given user id
+        * @param int $uid
+        * @return bool "true" if the default settings are non public
+        */
+       public static function getLockstateForUserId(int $uid)
+       {
+               $user = User::getById($uid, ['allow_cid', 'allow_gid', 'deny_cid', 'deny_gid']);
+               return !empty($user['allow_cid']) || !empty($user['allow_gid']) || !empty($user['deny_cid']) || !empty($user['deny_gid']);
+       }
+
+       /**
+        * Returns a select input tag for private message recipient
         *
-        * @param string $selname     Name attribute of the select input tag
-        * @param string $selclass    Class attribute of the select input tag
-        * @param array  $preselected Contact IDs that should be already selected
-        * @param int    $size        Length of the select box
-        * @param int    $tabindex    Select input tag tabindex attribute
+        * @param int  $selected Existing recipien contact ID
         * @return string
         * @throws \Exception
         */
-       public static function getMessageContactSelectHTML($selname, $selclass, array $preselected = [], $size = 4, $tabindex = null)
+       public static function getMessageContactSelectHTML(int $selected = null): string
        {
-               $a = DI::app();
-
                $o = '';
 
-               // When used for private messages, we limit correspondence to mutual DFRN/Friendica friends and the selector
-               // to one recipient. By default our selector allows multiple selects amongst all contacts.
-               $sql_extra = sprintf(" AND `rel` = %d ", intval(Contact::FRIEND));
-               $sql_extra .= sprintf(" AND `network` IN ('%s' , '%s') ", Protocol::DFRN, Protocol::DIASPORA);
-
-               $tabindex_attr = !empty($tabindex) ? ' tabindex="' . intval($tabindex) . '"' : '';
-
-               $hidepreselected = '';
-               if ($preselected) {
-                       $sql_extra .= " AND `id` IN (" . implode(",", $preselected) . ")";
-                       $hidepreselected = ' style="display: none;"';
-               }
-
-               $o .= "<select name=\"$selname\" id=\"$selclass\" class=\"$selclass\" size=\"$size\"$tabindex_attr$hidepreselected>\r\n";
-
-               $stmt = DBA::p("SELECT `id`, `name`, `url`, `network` FROM `contact`
-                       WHERE `uid` = ? AND NOT `self` AND NOT `blocked` AND NOT `pending` AND NOT `archive` AND NOT `deleted` AND `notify` != ''
-                       $sql_extra
-                       ORDER BY `name` ASC ", intval(local_user())
-               );
-
-               $contacts = DBA::toArray($stmt);
-
-               $arr = ['contact' => $contacts, 'entry' => $o];
+               $page = DI::page();
 
-               // e.g. 'network_pre_contact_deny', 'profile_pre_contact_allow'
-               Hook::callAll(DI::module()->getName() . '_pre_' . $selname, $arr);
+               $page->registerFooterScript(Theme::getPathForFile('asset/typeahead.js/dist/typeahead.bundle.js'));
+               $page->registerFooterScript(Theme::getPathForFile('js/friendica-tagsinput/friendica-tagsinput.js'));
+               $page->registerStylesheet(Theme::getPathForFile('js/friendica-tagsinput/friendica-tagsinput.css'));
+               $page->registerStylesheet(Theme::getPathForFile('js/friendica-tagsinput/friendica-tagsinput-typeahead.css'));
 
-               $receiverlist = [];
+               $contacts = self::getValidMessageRecipientsForUser(DI::userSession()->getLocalUserId());
 
-               if (DBA::isResult($contacts)) {
-                       foreach ($contacts as $contact) {
-                               if (in_array($contact['id'], $preselected)) {
-                                       $selected = ' selected="selected"';
-                               } else {
-                                       $selected = '';
-                               }
+               $tpl = Renderer::getMarkupTemplate('acl/message_recipient.tpl');
+               $o = Renderer::replaceMacros($tpl, [
+                       '$contacts' => $contacts,
+                       '$selected' => $selected,
+               ]);
 
-                               $trimmed = Protocol::formatMention($contact['url'], $contact['name']);
+               Hook::callAll(DI::args()->getModuleName() . '_post_recipient', $o);
 
-                               $receiverlist[] = $trimmed;
+               return $o;
+       }
 
-                               $o .= "<option value=\"{$contact['id']}\"$selected title=\"{$contact['name']}|{$contact['url']}\" >$trimmed</option>\r\n";
-                       }
-               }
+       public static function getValidMessageRecipientsForUser(int $uid): array
+       {
+               $condition = [
+                       'uid'     => $uid,
+                       'self'    => false,
+                       'blocked' => false,
+                       'pending' => false,
+                       'archive' => false,
+                       'deleted' => false,
+                       'rel'     => [Contact::FOLLOWER, Contact::SHARING, Contact::FRIEND],
+                       'network' => Protocol::SUPPORT_PRIVATE,
+               ];
 
-               $o .= '</select>' . PHP_EOL;
+               return Contact::selectToArray(
+                       ['id', 'name', 'addr', 'micro', 'url', 'nick'],
+                       DBA::mergeConditions($condition, ["`notify` != ''"])
+               );
+       }
 
-               if ($preselected) {
-                       $o .= implode(', ', $receiverlist);
-               }
+       /**
+        * Returns a minimal ACL block for self-only permissions
+        *
+        * @param int    $localUserId
+        * @param string $explanation
+        * @return string
+        * @throws \Friendica\Network\HTTPException\InternalServerErrorException
+        */
+       public static function getSelfOnlyHTML(int $localUserId, string $explanation)
+       {
+               $selfPublicContactId = Contact::getPublicIdByUserId($localUserId);
 
-               Hook::callAll(DI::module()->getName() . '_post_' . $selname, $o);
+               $tpl = Renderer::getMarkupTemplate('acl/self_only.tpl');
+               $o = Renderer::replaceMacros($tpl, [
+                       '$selfPublicContactId' => $selfPublicContactId,
+                       '$explanation' => $explanation,
+               ]);
 
                return $o;
        }
@@ -133,6 +155,7 @@ class ACL
                                'archive' => false,
                                'deleted' => false,
                                'pending' => false,
+                               'network' => Protocol::FEDERATED,
                                'rel' => [Contact::FOLLOWER, Contact::FRIEND]
                        ], $condition),
                        $params
@@ -145,7 +168,7 @@ class ACL
 
                $acl_forums = Contact::selectToArray($fields,
                        ['uid' => $user_id, 'self' => false, 'blocked' => false, 'archive' => false, 'deleted' => false,
-                       'pending' => false, 'contact-type' => Contact::TYPE_COMMUNITY], $params
+                       'network' => Protocol::FEDERATED, 'pending' => false, 'contact-type' => Contact::TYPE_COMMUNITY], $params
                );
 
                $acl_contacts = array_merge($acl_forums, $acl_contacts);
@@ -198,15 +221,14 @@ class ACL
         * Return the full jot ACL selector HTML
         *
         * @param Page   $page
-        * @param array  $user                  User array
+        * @param int    $uid                   User ID
         * @param bool   $for_federation
         * @param array  $default_permissions   Static defaults permission array:
         *                                      [
         *                                      'allow_cid' => [],
         *                                      'allow_gid' => [],
         *                                      'deny_cid' => [],
-        *                                      'deny_gid' => [],
-        *                                      'hidewall' => true/false
+        *                                      'deny_gid' => []
         *                                      ]
         * @param array  $condition
         * @param string $form_prefix
@@ -215,18 +237,20 @@ class ACL
         */
        public static function getFullSelectorHTML(
                Page $page,
-               array $user = null,
+               int $uid = null,
                bool $for_federation = false,
                array $default_permissions = [],
                array $condition = [],
                $form_prefix = ''
        ) {
-               if (empty($user['uid'])) {
+               if (empty($uid)) {
                        return '';
                }
 
                static $input_group_id = 0;
 
+               $user = User::getById($uid);
+
                $input_group_id++;
 
                $page->registerFooterScript(Theme::getPathForFile('asset/typeahead.js/dist/typeahead.bundle.js'));
@@ -244,7 +268,6 @@ class ACL
                        'allow_gid' => $default_permissions['allow_gid'] ?? [],
                        'deny_cid'  => $default_permissions['deny_cid']  ?? [],
                        'deny_gid'  => $default_permissions['deny_gid']  ?? [],
-                       'hidewall'  => $default_permissions['hidewall']  ?? false,
                ];
 
                if (count($default_permissions['allow_cid'])
@@ -260,31 +283,21 @@ class ACL
 
                $jotnets_fields = [];
                if ($for_federation) {
-                       $mail_enabled = false;
-                       $pubmail_enabled = false;
-
                        if (function_exists('imap_open') && !DI::config()->get('system', 'imap_disabled')) {
                                $mailacct = DBA::selectFirst('mailacct', ['pubmail'], ['`uid` = ? AND `server` != ""', $user['uid']]);
                                if (DBA::isResult($mailacct)) {
-                                       $mail_enabled = true;
-                                       $pubmail_enabled = !empty($mailacct['pubmail']);
-                               }
-                       }
-
-                       if (!$default_permissions['hidewall']) {
-                               if ($mail_enabled) {
                                        $jotnets_fields[] = [
                                                'type' => 'checkbox',
                                                'field' => [
                                                        'pubmail_enable',
                                                        DI::l10n()->t('Post to Email'),
-                                                       $pubmail_enabled
+                                                       !empty($mailacct['pubmail'])
                                                ]
                                        ];
-                               }
 
-                               Hook::callAll('jot_networks', $jotnets_fields);
+                               }
                        }
+                       Hook::callAll('jot_networks', $jotnets_fields);
                }
 
                $acl_contacts = self::getContactListByUserId($user['uid'], $condition);
@@ -302,18 +315,17 @@ class ACL
                        'emailcc'       => $form_prefix ? $form_prefix . '[emailcc]'       : 'emailcc',
                ];
 
-               $tpl = Renderer::getMarkupTemplate('acl_selector.tpl');
+               $tpl = Renderer::getMarkupTemplate('acl/full_selector.tpl');
                $o = Renderer::replaceMacros($tpl, [
                        '$public_title'   => DI::l10n()->t('Public'),
                        '$public_desc'    => DI::l10n()->t('This content will be shown to all your followers and can be seen in the community pages and by anyone with its link.'),
                        '$custom_title'   => DI::l10n()->t('Limited/Private'),
-                       '$custom_desc'    => DI::l10n()->t('This content will be shown only to the people in the first box, to the exception of the people mentioned in the second box. It won\'t appear anywhere public.'),
+                       '$custom_desc'    => DI::l10n()->t('This content will be shown only to the people in the first box, to the exception of the people mentioned in the second box. It won\'t appear anywhere public.') . DI::l10n()->t('Start typing the name of a contact or a group to show a filtered list. You can also mention the special groups "Followers" and "Mutuals".'),
                        '$allow_label'    => DI::l10n()->t('Show to:'),
                        '$deny_label'     => DI::l10n()->t('Except to:'),
                        '$emailcc'        => DI::l10n()->t('CC: email addresses'),
                        '$emtitle'        => DI::l10n()->t('Example: bob@example.com, mary@example.com'),
                        '$jotnets_summary' => DI::l10n()->t('Connectors'),
-                       '$jotnets_disabled_label' => DI::l10n()->t('Connectors disabled, since "%s" is enabled.', DI::l10n()->t('Hide your profile details from unknown viewers?')),
                        '$visibility'     => $visibility,
                        '$acl_contacts'   => $acl_contacts,
                        '$acl_groups'     => $acl_groups,
@@ -324,11 +336,68 @@ class ACL
                        '$group_deny'     => implode(',', $default_permissions['deny_gid']),
                        '$for_federation' => $for_federation,
                        '$jotnets_fields' => $jotnets_fields,
-                       '$user_hidewall'  => $default_permissions['hidewall'],
                        '$input_names'    => $input_names,
                        '$input_group_id' => $input_group_id,
                ]);
 
                return $o;
        }
+
+       /**
+        * Checks the validity of the given ACL string
+        *
+        * @param string $acl_string
+        * @param int    $uid
+        * @return bool
+        * @throws Exception
+        */
+       public static function isValidContact($acl_string, $uid)
+       {
+               if (empty($acl_string)) {
+                       return true;
+               }
+
+               // split <x><y><z> into array of cids
+               preg_match_all('/<[A-Za-z0-9]+>/', $acl_string, $array);
+
+               // check for each cid if the contact is valid for the given user
+               $cid_array = $array[0];
+               foreach ($cid_array as $cid) {
+                       $cid = str_replace(['<', '>'], ['', ''], $cid);
+                       if (!DBA::exists('contact', ['id' => $cid, 'uid' => $uid])) {
+                               return false;
+                       }
+               }
+
+               return true;
+       }
+
+       /**
+        * Checks the validity of the given ACL string
+        *
+        * @param string $acl_string
+        * @param int    $uid
+        * @return bool
+        * @throws Exception
+        */
+       public static function isValidGroup($acl_string, $uid)
+       {
+               if (empty($acl_string)) {
+                       return true;
+               }
+
+               // split <x><y><z> into array of cids
+               preg_match_all('/<[A-Za-z0-9]+>/', $acl_string, $array);
+
+               // check for each cid if the contact is valid for the given user
+               $gid_array = $array[0];
+               foreach ($gid_array as $gid) {
+                       $gid = str_replace(['<', '>'], ['', ''], $gid);
+                       if (!DBA::exists('group', ['id' => $gid, 'uid' => $uid, 'deleted' => false])) {
+                               return false;
+                       }
+               }
+
+               return true;
+       }
 }