3 * StatusNet - the distributed open-source microblogging tool
4 * Copyright (C) 2010, StatusNet, Inc.
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU Affero General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU Affero General Public License for more details.
16 * You should have received a copy of the GNU Affero General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
21 * @package ForceGroupPlugin
22 * @maintainer Brion Vibber <brion@status.net>
25 if (!defined('STATUSNET')) { exit(1); }
27 class ForceGroupPlugin extends Plugin
30 * Members of these groups will have all their posts mirrored into
31 * the group even if they don't explicitly mention it.
33 * List by local nickname.
35 public $post = array();
38 * New user registrations will automatically join these groups on
39 * registration. They're not prevented from leaving, however.
41 * List by local nickname.
43 public $join = array();
46 * If poster is in one of the forced groups, make sure their notice
47 * gets saved into that group even if not explicitly mentioned.
49 * @param Notice $notice
50 * @return boolean event hook return
52 function onStartNoticeDistribute($notice)
54 $profile = $notice->getProfile();
55 foreach ($this->post as $nickname) {
56 $group = User_group::getForNickname($nickname);
57 if ($group && $profile->isMember($group)) {
58 $notice->addToGroupInbox($group);
64 public function onEndUserRegister(Profile $profile)
66 foreach ($this->join as $nickname) {
67 $group = User_group::getForNickname($nickname);
68 if ($group && !$profile->isMember($group)) {
70 $profile->joinGroup($group);
71 } catch (Exception $e) {
72 // TRANS: Server exception.
73 // TRANS: %1$s is a user nickname, %2$s is a group nickname.
74 throw new ServerException(sprintf(_m('Could not join user %1$s to group %2$s.'),
75 $profile->nickname, $group->nickname));
82 * Provide plugin version information.
84 * This data is used when showing the version page.
86 * @param array &$versions array of version data arrays; see EVENTS.txt
88 * @return boolean hook value
90 function onPluginVersion(&$versions)
92 $url = 'http://status.net/wiki/Plugin:ForceGroup';
94 $versions[] = array('name' => 'ForceGroup',
95 'version' => STATUSNET_VERSION,
96 'author' => 'Brion Vibber',
99 // TRANS: Plugin description.
100 _m('Allows forced group memberships and forces all notices to appear in groups that users were forced in.'));