xref: /plugin/structnotification/action/notification.php (revision 4677fc3cbc4a73f810813a1efa8b2d7e4e090b7c)
1a1f4c7baSSzymon Olewniczak<?php
2a1f4c7baSSzymon Olewniczak/**
3a1f4c7baSSzymon Olewniczak * DokuWiki Plugin structnotification (Action Component)
4a1f4c7baSSzymon Olewniczak *
5a1f4c7baSSzymon Olewniczak * @license GPL 2 http://www.gnu.org/licenses/gpl-2.0.html
6a1f4c7baSSzymon Olewniczak * @author  Szymon Olewniczak <it@rid.pl>
7a1f4c7baSSzymon Olewniczak */
8a1f4c7baSSzymon Olewniczak
9a1f4c7baSSzymon Olewniczak// must be run within Dokuwiki
10922aade7SSzymon Olewniczakuse dokuwiki\plugin\struct\meta\Search;
11922aade7SSzymon Olewniczakuse dokuwiki\plugin\struct\meta\Value;
12922aade7SSzymon Olewniczak
13a1f4c7baSSzymon Olewniczakif (!defined('DOKU_INC')) {
14a1f4c7baSSzymon Olewniczak    die();
15a1f4c7baSSzymon Olewniczak}
16a1f4c7baSSzymon Olewniczak
17a1f4c7baSSzymon Olewniczakclass action_plugin_structnotification_notification extends DokuWiki_Action_Plugin
18a1f4c7baSSzymon Olewniczak{
19a1f4c7baSSzymon Olewniczak
20a1f4c7baSSzymon Olewniczak    /**
21a1f4c7baSSzymon Olewniczak     * Registers a callback function for a given event
22a1f4c7baSSzymon Olewniczak     *
23a1f4c7baSSzymon Olewniczak     * @param Doku_Event_Handler $controller DokuWiki's event controller object
24a1f4c7baSSzymon Olewniczak     *
25a1f4c7baSSzymon Olewniczak     * @return void
26a1f4c7baSSzymon Olewniczak     */
27a1f4c7baSSzymon Olewniczak    public function register(Doku_Event_Handler $controller)
28a1f4c7baSSzymon Olewniczak    {
29922aade7SSzymon Olewniczak        $controller->register_hook('PLUGIN_NOTIFICATION_REGISTER_SOURCE', 'AFTER', $this, 'add_notifications_source');
30922aade7SSzymon Olewniczak        $controller->register_hook('PLUGIN_NOTIFICATION_GATHER', 'AFTER', $this, 'add_notifications');
31922aade7SSzymon Olewniczak        $controller->register_hook('PLUGIN_NOTIFICATION_CACHE_DEPENDENCIES', 'AFTER', $this, 'add_notification_cache_dependencies');
32a1f4c7baSSzymon Olewniczak
33922aade7SSzymon Olewniczak
34922aade7SSzymon Olewniczak    }
35922aade7SSzymon Olewniczak
36922aade7SSzymon Olewniczak    public function add_notifications_source(Doku_Event $event)
37922aade7SSzymon Olewniczak    {
38922aade7SSzymon Olewniczak        $event->data[] = 'structnotification';
39922aade7SSzymon Olewniczak    }
40922aade7SSzymon Olewniczak
41922aade7SSzymon Olewniczak    public function add_notification_cache_dependencies(Doku_Event $event)
42922aade7SSzymon Olewniczak    {
43922aade7SSzymon Olewniczak        if (!in_array('structnotification', $event->data['plugins'])) return;
44922aade7SSzymon Olewniczak
45922aade7SSzymon Olewniczak        try {
46922aade7SSzymon Olewniczak            /** @var \helper_plugin_structnotification_db $db_helper */
47922aade7SSzymon Olewniczak            $db_helper = plugin_load('helper', 'structnotification_db');
48922aade7SSzymon Olewniczak            $sqlite = $db_helper->getDB();
49922aade7SSzymon Olewniczak            $event->data['dependencies'][] = $sqlite->getAdapter()->getDbFile();
50922aade7SSzymon Olewniczak        } catch (Exception $e) {
51922aade7SSzymon Olewniczak            msg($e->getMessage(), -1);
52922aade7SSzymon Olewniczak            return;
53922aade7SSzymon Olewniczak        }
54922aade7SSzymon Olewniczak    }
55922aade7SSzymon Olewniczak
56922aade7SSzymon Olewniczak    protected function getValueByLabel($values, $label)
57922aade7SSzymon Olewniczak    {
58922aade7SSzymon Olewniczak        /* @var Value $value */
59922aade7SSzymon Olewniczak        foreach ($values as $value) {
60922aade7SSzymon Olewniczak            $colLabel = $value->getColumn()->getLabel();
61922aade7SSzymon Olewniczak            if ($colLabel == $label) {
62922aade7SSzymon Olewniczak                return $value->getRawValue();
63922aade7SSzymon Olewniczak            }
64922aade7SSzymon Olewniczak        }
65922aade7SSzymon Olewniczak        //nothing found
66922aade7SSzymon Olewniczak        throw new Exception("column: $label not found in values");
67922aade7SSzymon Olewniczak    }
68922aade7SSzymon Olewniczak
69922aade7SSzymon Olewniczak
70922aade7SSzymon Olewniczak    public function add_notifications(Doku_Event $event)
71922aade7SSzymon Olewniczak    {
72922aade7SSzymon Olewniczak        if (!in_array('structnotification', $event->data['plugins'])) return;
73922aade7SSzymon Olewniczak
74922aade7SSzymon Olewniczak        try {
75922aade7SSzymon Olewniczak            /** @var \helper_plugin_structnotification_db$db_helper */
76922aade7SSzymon Olewniczak            $db_helper = plugin_load('helper', 'structnotification_db');
77922aade7SSzymon Olewniczak            $sqlite = $db_helper->getDB();
78922aade7SSzymon Olewniczak        } catch (Exception $e) {
79922aade7SSzymon Olewniczak            msg($e->getMessage(), -1);
80922aade7SSzymon Olewniczak            return;
81922aade7SSzymon Olewniczak        }
82922aade7SSzymon Olewniczak
83922aade7SSzymon Olewniczak        $user = $event->data['user'];
84922aade7SSzymon Olewniczak
85922aade7SSzymon Olewniczak        $q = 'SELECT * FROM predicate';
86922aade7SSzymon Olewniczak        $res = $sqlite->query($q);
87922aade7SSzymon Olewniczak
88922aade7SSzymon Olewniczak        $predicates = $sqlite->res2arr($res);
89922aade7SSzymon Olewniczak
90922aade7SSzymon Olewniczak        foreach ($predicates as $predicate) {
91922aade7SSzymon Olewniczak            $schema = $predicate['schema'];
92922aade7SSzymon Olewniczak            $field = $predicate['field'];
93922aade7SSzymon Olewniczak            $operator = $predicate['operator'];
94*4677fc3cSSzymon Olewniczak            $value = $predicate['value'];
95922aade7SSzymon Olewniczak            $users_and_groups = $predicate['users_and_groups'];
96922aade7SSzymon Olewniczak            $message = $predicate['message'];
97922aade7SSzymon Olewniczak
98922aade7SSzymon Olewniczak             try {
99922aade7SSzymon Olewniczak                $search = new Search();
100*4677fc3cSSzymon Olewniczak                foreach (explode(',', $schema) as $table) {
101*4677fc3cSSzymon Olewniczak                    $search->addSchema($table);
102*4677fc3cSSzymon Olewniczak                    $search->addColumn($table . '.*');
103*4677fc3cSSzymon Olewniczak                }
104115044e5SSzymon Olewniczak                // add special columns
105115044e5SSzymon Olewniczak                $special_columns = ['%pageid%', '%title%', '%lastupdate%', '%lasteditor%', '%lastsummary%', '%rowid%'];
106115044e5SSzymon Olewniczak                foreach ($special_columns as $special_column) {
107115044e5SSzymon Olewniczak                    $search->addColumn($special_column);
108115044e5SSzymon Olewniczak                }
109922aade7SSzymon Olewniczak                $result = $search->execute();
110922aade7SSzymon Olewniczak                $result_pids = $search->getPids();
111922aade7SSzymon Olewniczak
112922aade7SSzymon Olewniczak                /* @var Value[] $row */
113922aade7SSzymon Olewniczak                for ($i=0; $i<count($result); $i++) {
114922aade7SSzymon Olewniczak                    $values = $result[$i];
115922aade7SSzymon Olewniczak                    $pid = $result_pids[$i];
1162c65b673SSzymon Olewniczak
1172c65b673SSzymon Olewniczak                    $users_set = $this->users_set($users_and_groups, $values);
1182c65b673SSzymon Olewniczak                    if (!isset($users_set[$user])) continue;
1192c65b673SSzymon Olewniczak
120922aade7SSzymon Olewniczak                    $rawDate = $this->getValueByLabel($values, $field);
121*4677fc3cSSzymon Olewniczak                    if ($this->predicateTrue($rawDate, $operator, $value)) {
122c0d6a71fSSzymon Olewniczak                        $message_with_replacements = $this->replacePlaceholders($message, $values);
123c0d6a71fSSzymon Olewniczak                        $message_with_replacements_html = p_render('xhtml',
124c0d6a71fSSzymon Olewniczak                            p_get_instructions($message_with_replacements), $info);
125922aade7SSzymon Olewniczak                        $event->data['notifications'][] = [
126922aade7SSzymon Olewniczak                            'plugin' => 'structnotification',
127922aade7SSzymon Olewniczak                            'id' => $predicate['id'] . ':'. $schema . ':' . $pid . ':'  . $rawDate,
128c0d6a71fSSzymon Olewniczak                            'full' => $message_with_replacements_html,
129c0d6a71fSSzymon Olewniczak                            'brief' => $message_with_replacements_html,
130922aade7SSzymon Olewniczak                            'timestamp' => (int) strtotime($rawDate)
131922aade7SSzymon Olewniczak                        ];
132922aade7SSzymon Olewniczak                    }
133922aade7SSzymon Olewniczak                }
134922aade7SSzymon Olewniczak            } catch (Exception $e) {
135922aade7SSzymon Olewniczak                msg($e->getMessage(), -1);
136922aade7SSzymon Olewniczak                return;
137922aade7SSzymon Olewniczak            }
138922aade7SSzymon Olewniczak        }
139a1f4c7baSSzymon Olewniczak    }
140a1f4c7baSSzymon Olewniczak
141a1f4c7baSSzymon Olewniczak    /**
142922aade7SSzymon Olewniczak     * @return array
143a1f4c7baSSzymon Olewniczak     */
1442c65b673SSzymon Olewniczak    protected function users_set($user_and_groups, $values) {
145922aade7SSzymon Olewniczak        /** @var DokuWiki_Auth_Plugin $auth */
146922aade7SSzymon Olewniczak        global $auth;
147922aade7SSzymon Olewniczak
1482c65b673SSzymon Olewniczak        //make substitutions
1492c65b673SSzymon Olewniczak        $user_and_groups = preg_replace_callback(
1502c65b673SSzymon Olewniczak            '/@@(.*?)@@/',
1512c65b673SSzymon Olewniczak            function ($matches) use ($values) {
1522c65b673SSzymon Olewniczak                list($schema, $field) = explode('.', trim($matches[1]));
1532c65b673SSzymon Olewniczak                if (!$field) return '';
1542c65b673SSzymon Olewniczak                /* @var Value $value */
1552c65b673SSzymon Olewniczak                foreach ($values as $value) {
15686ba6958SSzymon Olewniczak                    $column = $value->getColumn();
15786ba6958SSzymon Olewniczak                    $colLabel = $column->getLabel();
15886ba6958SSzymon Olewniczak                    $type = $column->getType();
1592c65b673SSzymon Olewniczak                    if ($colLabel == $field) {
1602c65b673SSzymon Olewniczak                        if (class_exists('\dokuwiki\plugin\structgroup\types\Group') &&
1612c65b673SSzymon Olewniczak                            $type instanceof \dokuwiki\plugin\structgroup\types\Group) {
16286ba6958SSzymon Olewniczak                            if ($column->isMulti()) {
16386ba6958SSzymon Olewniczak                                return implode(',', array_map(function ($rawValue) {
16486ba6958SSzymon Olewniczak                                    return '@' . $rawValue;
16586ba6958SSzymon Olewniczak                                }, $value->getRawValue()));
16686ba6958SSzymon Olewniczak                            } else {
1672c65b673SSzymon Olewniczak                                return '@' . $value->getRawValue();
1682c65b673SSzymon Olewniczak                            }
16986ba6958SSzymon Olewniczak                        }
17086ba6958SSzymon Olewniczak                        if ($column->isMulti()) {
17186ba6958SSzymon Olewniczak                            return implode(',', $value->getRawValue());
17286ba6958SSzymon Olewniczak                        } else {
1732c65b673SSzymon Olewniczak                            return $value->getRawValue();
1742c65b673SSzymon Olewniczak                        }
1752c65b673SSzymon Olewniczak                    }
17686ba6958SSzymon Olewniczak                }
1772c65b673SSzymon Olewniczak                return '';
1782c65b673SSzymon Olewniczak            },
1792c65b673SSzymon Olewniczak            $user_and_groups
1802c65b673SSzymon Olewniczak        );
1812c65b673SSzymon Olewniczak
182922aade7SSzymon Olewniczak        $user_and_groups_set = array_map('trim', explode(',', $user_and_groups));
183922aade7SSzymon Olewniczak        $users = [];
184922aade7SSzymon Olewniczak        $groups = [];
185922aade7SSzymon Olewniczak        foreach ($user_and_groups_set as $user_or_group) {
186922aade7SSzymon Olewniczak            if ($user_or_group[0] == '@') {
187922aade7SSzymon Olewniczak                $groups[] = substr($user_or_group, 1);
188922aade7SSzymon Olewniczak            } else {
189922aade7SSzymon Olewniczak                $users[] = $user_or_group;
190a1f4c7baSSzymon Olewniczak            }
191a1f4c7baSSzymon Olewniczak        }
192922aade7SSzymon Olewniczak        $set = [];
193922aade7SSzymon Olewniczak
194922aade7SSzymon Olewniczak        $all_users = $auth->retrieveUsers();
195922aade7SSzymon Olewniczak        foreach ($all_users as $user => $info) {
196922aade7SSzymon Olewniczak            if (in_array($user, $users)) {
197922aade7SSzymon Olewniczak                $set[$user] = $info;
198922aade7SSzymon Olewniczak            } elseif (array_intersect($groups, $info['grps'])) {
199922aade7SSzymon Olewniczak                $set[$user] = $info;
200922aade7SSzymon Olewniczak            }
201922aade7SSzymon Olewniczak        }
202922aade7SSzymon Olewniczak
203922aade7SSzymon Olewniczak        return $set;
204922aade7SSzymon Olewniczak    }
205922aade7SSzymon Olewniczak
206*4677fc3cSSzymon Olewniczak    protected function predicateTrue($date, $operator, $value) {
207922aade7SSzymon Olewniczak        $date = date('Y-m-d', strtotime($date));
208922aade7SSzymon Olewniczak
209922aade7SSzymon Olewniczak        switch ($operator) {
210922aade7SSzymon Olewniczak            case 'before':
211*4677fc3cSSzymon Olewniczak                $days = date('Y-m-d', strtotime("+$value days"));
212922aade7SSzymon Olewniczak                return $days >= $date;
213922aade7SSzymon Olewniczak            case 'after':
214*4677fc3cSSzymon Olewniczak                $days = date('Y-m-d', strtotime("-$value days"));
215922aade7SSzymon Olewniczak                return $date <= $days;
216*4677fc3cSSzymon Olewniczak            case 'at':
217*4677fc3cSSzymon Olewniczak                $now = new DateTime();
218*4677fc3cSSzymon Olewniczak                $at = new DateTime(date($value, strtotime($date)));
219*4677fc3cSSzymon Olewniczak                return $now >= $at;
220922aade7SSzymon Olewniczak            default:
221922aade7SSzymon Olewniczak                return false;
222922aade7SSzymon Olewniczak        }
223a1f4c7baSSzymon Olewniczak    }
224a1f4c7baSSzymon Olewniczak
225ac63f65fSSzymon Olewniczak    protected function replacePlaceholders($message, $values) {
226ac63f65fSSzymon Olewniczak        $patterns = [];
227ac63f65fSSzymon Olewniczak        $replacements = [];
228ac63f65fSSzymon Olewniczak        /* @var Value $value */
229ac63f65fSSzymon Olewniczak        foreach ($values as $value) {
230ac63f65fSSzymon Olewniczak            $schema = $value->getColumn()->getTable();
231ac63f65fSSzymon Olewniczak            $label = $value->getColumn()->getLabel();
232ac63f65fSSzymon Olewniczak            $patterns[] = "/@@$schema.$label@@/";
233ac63f65fSSzymon Olewniczak            $replacements[] = $value->getDisplayValue();
234ac63f65fSSzymon Olewniczak        }
235ac63f65fSSzymon Olewniczak
236ac63f65fSSzymon Olewniczak        return preg_replace($patterns, $replacements, $message);
237ac63f65fSSzymon Olewniczak    }
238ac63f65fSSzymon Olewniczak
239a1f4c7baSSzymon Olewniczak}
240a1f4c7baSSzymon Olewniczak
241