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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
<?php
/*
* SCROTT IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
* IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* For more information, please refer to UNLICENSE
*/
require_once "class/agent.class.php";
require_once "class/user.class.php";
/*
* This class models Scrott user groups, a construct which exists to
* simplify the sharing of multiple Scrott pads.
*/
class group extends agent
{
/*
* Constructor
*/
public function __construct(?string $guid = NULL)
{
$this->fields['groups'] = array(
"guid",
);
parent::__construct($guid);
$this->expectType("group");
}
/*
* Get an array of all groups, sorted by name
*/
public static function getAll_ordByName() : array
{
$query = "SELECT guid FROM objects WHERE objtype = 'group' ORDER BY name";
$res = database::query($query);
$groups = array();
foreach ($res as $g)
$groups[] = new group($g['guid']);
return $groups;
}
/*
* Initialize a new group object with the given name and owner
*/
public static function initNew(string $name, user $owner) : group
{
$group = new group();
$group->setOwner($owner);
$group->name = $name;
$group->objtype = "group";
$group->saveObj();
return $group;
}
/*
* Get all contained users. This is an array of all members and
* the group owner.
*/
public function getContainedUsers() : array
{
$cus = $this->getMembers();
$cus[] = $this->getOwner();
return $cus;
}
/*
* Send an email message to this group using stored configuration
* parameters. If config is not established, delivery is not
* attempted. Return status. If any delivery attempts fail, the
* rest are aborted and false is returned.
*/
public function sendEmail(string $subj, string $mesg,
?string $attachPath = NULL, ?string $attachName = NULL,
bool $ignoreEmailConf = false) : bool
{
$owner = $this->getOwner();
if (!$owner->sendEmail($subj, $mesg, $attachPath, $attachName,
$ignoreEmailConf))
return false;
foreach ($this->getMembers() as $memb)
{
if (!$memb->sendEmail($subj, $mesg, $attachPath, $attachName,
$ignoreEmailConf))
return false;
}
return true;
}
}
?>
|