aboutsummaryrefslogtreecommitdiff
path: root/lib/models/ContactGroupItem.class.php
blob: 8f2583b377381a829decd656f941d1041328c4e5 (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
<?php
/**
 * The ContactGroupItem class represents an item in a contact group.
 *
 * This file is part of Stud.IP
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of
 * the License, or (at your option) any later version.
 *
 * @author      Moritz Strohm <strohm@data-quest.de>
 * @copyright   2023
 * @license     http://www.gnu.org/licenses/gpl-2.0.html GPL version 2
 * @category    Stud.IP
 * @package     resources
 * @since       5.5
 *
 * @property array $id alias for pk
 * @property int $group_id database column
 * @property string $user_id database column
 * @property int $mkdate database column
 * @property int $chdate database column
 * @property ContactGroup $contact_group belongs_to ContactGroup
 * @property User $user belongs_to User
 */
class ContactGroupItem extends SimpleORMap
{
    protected static function configure($config = [])
    {
        $config['db_table'] = 'contact_group_items';
        $config['belongs_to']['contact_group'] = [
            'class_name'  => ContactGroup::class,
            'foreign_key' => 'group_id'
        ];
        $config['belongs_to']['user'] = [
            'class_name'  => User::class,
            'foreign_key' => 'user_id'
        ];
        parent::configure($config);
    }

    /**
     * Finds and returns all group items for a contact.
     *
     * @param Contact $contact The contact for which to find all contact group items.
     * @return ContactGroupItem[] All memberships of the contact.
     */
    public static function findByContact(Contact $contact): array
    {
        return self::findBySQL(
            'JOIN `contact_groups`
              ON (`contact_group_items`.`group_id` = `contact_groups`.`id`)
             WHERE `contact_groups`.`owner_id` = :owner_id
               AND `contact_group_items`.`user_id` = :user_id',
            [
                'owner_id' => $contact->owner_id,
                'user_id' => $contact->user_id
            ]
        );
    }
}