src/Model/PermissionSet.php

   1 <?php
   2 /**
   3  * @file src/Model/PermissionSet.php
   4  */
   5
   6 namespace Friendica\Model;
   7
   8 use Friendica\BaseModel;
   9 use Friendica\DI;
  10
  11 /**
  12  * functions for interacting with the permission set of an object (item, photo, event, ...)
  13  *
  14  * @property int uid
  15  * @property string allow_cid
  16  * @property string allow_gid
  17  * @property string deny_cid
  18  * @property string deny_gid
  19  */
  20 class PermissionSet extends BaseModel
  21 {
  22         /**
  23          * Fetch the id of a given permission set. Generate a new one when needed
  24          *
  25          * @param int         $uid
  26          * @param string|null $allow_cid Allowed contact IDs    - empty = everyone
  27          * @param string|null $allow_gid Allowed group IDs      - empty = everyone
  28          * @param string|null $deny_cid  Disallowed contact IDs - empty = no one
  29          * @param string|null $deny_gid  Disallowed group IDs   - empty = no one
  30          * @return int id
  31          * @throws \Exception
  32          * @deprecated since 2020.03, use Repository\PermissionSet instead
  33          * @see \Friendica\Repository\PermissionSet->getIdFromACL
  34          */
  35         public static function getIdFromACL(
  36                 int $uid,
  37                 string $allow_cid = null,
  38                 string $allow_gid = null,
  39                 string $deny_cid = null,
  40                 string $deny_gid = null
  41         ) {
  42                 return DI::permissionSet()->getIdFromACL($uid, $allow_cid, $allow_gid, $deny_cid, $deny_gid);
  43         }
  44
  45         /**
  46          * Returns a permission set for a given contact
  47          *
  48          * @param integer $uid        User id whom the items belong
  49          * @param integer $contact_id Contact id of the visitor
  50          *
  51          * @return array of permission set ids.
  52          * @throws \Exception
  53          * @deprecated since 2020.03, use Repository\PermissionSet instead
  54          * @see \Friendica\Repository\PermissionSet->selectByContactId
  55          */
  56         public static function get($uid, $contact_id)
  57         {
  58                 $permissionSets = DI::permissionSet()->selectByContactId($contact_id, $uid);
  59
  60                 return $permissionSets->column('id');
  61         }
  62 }