aboutsummaryrefslogtreecommitdiff
path: root/lib/models/Courseware/UserDataField.php
blob: 914cab0361511405f3d53bd71d546e296af36da6 (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
63
64
65
66
67
68
69
70
<?php

namespace Courseware;

/**
 * Courseware's user data fields.
 *
 * @author  Marcus Eibrink-Lunzenauer <lunzenauer@elan-ev.de>
 * @author  Till Glöggler <gloeggler@elan-ev.de>
 * @author  Ron Lucke <lucke@elan-ev.de>
 * @license GPL2 or any later version
 *
 * @since   Stud.IP 5.0
 *
 * @property array             $id       computed column read/write
 * @property string            $user_id  database column
 * @property id                $block_id database column
 * @property \JSONArrayObject  $payload  database column
 * @property int               $mkdate   database column
 * @property int               $chdate   database column
 * @property \Courseware\Block $block    belongs_to Courseware\Block
 * @property \User             $user     belongs_to User
 */
class UserDataField extends \SimpleORMap
{
    protected static function configure($config = [])
    {
        $config['db_table'] = 'cw_user_data_fields';

        $config['serialized_fields']['payload'] = 'JSONArrayObject';

        $config['belongs_to']['block'] = [
            'class_name' => Block::class,
            'foreign_key' => 'block_id',
        ];

        $config['belongs_to']['user'] = [
            'class_name' => \User::class,
            'foreign_key' => 'user_id',
        ];

        parent::configure($config);
    }

    /**
     * Returns either an existing UserDataField of this user and block or creates a new one.
     *
     * @param \User $user  the user of the existing or new UserDataField
     * @param Block $block the block of the existing or new UserDataField
     *
     * @return UserDataField the either already existing or new UserDataField
     */
    public static function getUserDataField(\User $user, Block $block): UserDataField
    {
        /** @var ?UserDataField $userDataField */
        $userDataField = UserDataField::find([$user->id, $block->id]);
        if (!$userDataField) {
            // TODO: Jeder BlockType sollte hier sagen dürfen, welchen Defaultwert das UserDataField haben sollte
            $payload = [];
            /** @var UserDataField $userDataField */
            $userDataField = UserDataField::build([
                'user_id' => $user->id,
                'block_id' => $block->id,
                'payload' => $payload,
            ]);
        }

        return $userDataField;
    }
}