DataObjects/Core_watch.php
[Pman.Core] / DataObjects / Core_watch.php
1 <?php
2 /**
3  * Table Definition for core_watch
4  *
5  * works with 'core_notify'
6  *
7  * any object can call
8  *   $watch->notify($ontable, $onid)
9  *
10  *   in which case it should create a core_notify event.
11  *
12  *
13  * Should 'event' trigger this..
14  *   -> eg. somebody makes a 'EDIT' on 'person'
15  *   -> a watch exists for
16  *        ontable=person,
17  *        onid = -1 <<-- every entry..
18  *        person_id -> who is goes to.
19  *        event = CRUD (eg. shortcut for edit/create/delete)
20  *        medium = "REVIEW" << eg. review needed..
21  *        
22  *
23  * 
24  * 
25  */
26 require_once 'DB/DataObject.php';
27
28 class Pman_Core_DataObjects_Core_watch extends DB_DataObject 
29 {
30     ###START_AUTOCODE
31     /* the code below is auto generated do not remove the above tag */
32
33     public $__table = 'core_watch';                      // table name
34     public $id;                              // int(11)  not_null primary_key auto_increment
35     public $ontable;                         // string(128)  not_null
36     public $onid;                            // int(11)  not_null
37     public $person_id;                       // int(11)  not_null
38     public $event;                           // string(128)  not_null
39     public $medium;                          // string(128)  not_null
40     public $active;                          // int(11)  not_null
41
42     
43     /* the code above is auto generated do not remove the tag below */
44     ###END_AUTOCODE
45     /** make sure there is a watch for this user.. */
46     
47     /**
48      *
49      * Create a watch...
50      *
51      */
52     
53     function ensureNotify(  $ontable, $onid, $person_id, $whereAdd)
54     {
55         //DB_DAtaObject::debugLevel(1);
56         $w = DB_DataObject::factory('core_watch');
57         $w->person_id = $person_id;
58         if (empty($w->person_id)) {
59             return;
60         }
61         
62         $nw = clone($w);
63         $w->whereAdd($whereAdd);
64         
65         
66         if ($w->count()) {
67             return;
68         }
69         $nw->ontable = $ontable;
70         $nw->onid = $onid;
71         
72         $nw->medium = 'email';
73         $nw->active = 1;
74         $nw->insert();
75          
76     }
77     /**
78      * Generate a notify event based on watches (matching whereAdd)
79      *
80      * Usage: $core_watch->notify('mtrack_repos', 1, false, date()
81      */
82     function notify($ontable , $onid, $whereAdd = false, $when=false)
83     {
84         $w = DB_DataObject::factory('core_watch');
85         if ($whereAdd !== false) { 
86             $w->whereAdd($whereAdd  );
87         }
88         //$w->selectAdd();
89         //$w->selectAdd('distinct(person_id) as person_id');
90         
91         foreach($w->fetchAll() as $w) { 
92             if (!$w->person_id) { // no people??? bugs in watch table
93                 continue;
94             }
95          
96          
97          
98             $nn = DB_DataObject::Factory('core_notify');
99             $nn->ontable = $ontable;
100             $nn->onid = $onid;
101             $nn->evtype = $w->medium;
102             $nn->person_id = $w->person_id;
103             
104             $nf = clone($nn);
105             $nf->whereAdd('sent < act_when');
106             if ($nf->count()) {
107                 // we have a item in the queue for that waiting to be sent..
108                 continue;
109             }
110             $nn->act_start( date("Y-m-d H:i:s", $when !== false ? strtotime($when) : time()) );
111             $nn->insert();
112             
113         }     
114     }
115     // static really...
116     function notifyEvent($event)
117     {
118         //DB_DataObject::DebugLevel(1);
119         // see if there are any watches on events..
120         // notify everyone flagged except the person doing it...
121         // this is very basic logic... -
122         //    if more intelligence is needed...
123         //    then it 'rules' will have to be added by the watched object....
124         //    anyway leave that for another day..
125         if (empty($event->action)) {
126             return;
127         }
128         $w = DB_DataObject::factory('core_watch');
129         $w->ontable = $event->on_table;
130         $w->whereAdd('onid = 0 OR onid='. ((int) $event->on_id));
131        
132         $w->event  = $event->action;
133         $w->active = 1;
134         
135         
136         $w->whereAdd('person_id != '. (int) $event->person_id);
137
138         
139         $watches = $w->fetchAll();
140         
141         $nn = DB_DataObject::Factory('core_notify');
142         $nn->ontable    = $event->on_table;
143         $nn->onid       = $event->on_id;
144         
145         foreach($watches as $watch) {
146             if (!$watch->person_id) { // no people??? bugs in watch table
147                 continue;
148             }
149             
150             $n = clone($nn);
151             $n->trigger_person_id = $event->person_id;
152             $n->trigger_event_id = $event->id;
153             $n->person_id = $watch->person_id;
154             $n->watch_id =  $watch->id;
155             
156             // does this watch already have a flag...
157             $nf = clone($n);
158             $nf->whereAdd('sent < act_when');
159             if ($nf->count()) {
160                 // we have a item in the queue for that waiting to be sent..
161                 continue;
162             }
163             
164             $n->act_start( date("Y-m-d H:i:s") );
165             $n->insert();
166             
167             
168         }
169         
170         
171         
172     }
173     
174      
175 }