6 * - base application setup (variables etc to javascript)
8 * - authentication and permission info about user / application
9 * - json output methods.
10 * - file upload error checking - checkFileUploadError
11 * - logging to event table
12 * - sendTemplate code (normally use the Person version for sending to specific people..)
14 * - doc managment code?? - remarks and tracking??? - MOVEME
15 * - authentication link checking?? MOVEME?
16 * - authentication reset password ?? MOVEME?
17 * ?? arrayClean.. what's it doing here?!? ;)
21 * Pman['local_autoauth'] // who to login as when using localhost
22 * Pman['isDev'] // can the site show develpment info.?
23 * Pman['uiConfig'] // extra variable to export to front end..
24 * Pman['auth_comptype'] // -- if set to 'OWNER' then only users with company=OWNER can log in
25 * Pman['authTable'] // the authentication table (default 'person')
29 * DB_DataObject*:*toEventString (for logging - this is generically prefixed to all database operations.)
30 * - any data object where this method exists, the result will get prefixed to the log remarks
37 require_once 'Pman/Core/AssetTrait.php';
39 class Pman extends HTML_FlexyFramework_Page
41 use Pman_Core_AssetTrait;
42 //outputJavascriptDir()
47 var $appShortName= "";
48 var $appVersion = "1.8";
55 var $appDisabled = array(); // array of disabled modules..
56 // (based on config option disable)
58 var $authUser; // always contains the authenticated user..
60 var $disable_jstemplate = false; /// disable inclusion of jstemplate code..
63 var $css_path = ''; // can inject a specific path into the base HTML page.
66 var $transObj = false; // used to rollback or commit in JOK/JERR
68 * ------------- Standard getAuth/get/post methods of framework.
73 function getAuth() // everyone allowed in!!!!!
75 $this->loadOwnerCompany();
80 function init($base = false)
83 if (isset($this->_hasInit)) {
86 $this->_hasInit = true;
87 // move away from doing this ... you can access bootLoader.XXXXXX in the master template..
88 $boot = HTML_FlexyFramework::get();
89 // echo'<PRE>';print_R($boot);exit;
90 $this->appName = $boot->appName;
92 $this->appNameShort = $boot->appNameShort;
94 $this->appModules = $boot->enable;
96 // echo $this->arrayToJsInclude($files);
97 $this->isDev = empty($boot->Pman['isDev']) ? false : $boot->Pman['isDev'];
99 $this->css_path = empty($boot->Pman['css_path']) ? '' : $boot->Pman['css_path'];
101 $this->appDisable = $boot->disable;
102 $this->appDisabled = explode(',', $boot->disable);
103 $this->version = $boot->version;
104 $this->uiConfig = empty($boot->Pman['uiConfig']) ? false : $boot->Pman['uiConfig'];
106 if (!empty($boot->Pman['local_autoauth']) &&
107 ($_SERVER['SERVER_ADDR'] == '127.0.0.1') &&
108 ($_SERVER['REMOTE_ADDR'] == '127.0.0.1')
114 !empty($_REQUEST['isDev'])
117 (($_SERVER['SERVER_ADDR'] == '127.0.0.1') && ($_SERVER['REMOTE_ADDR'] == '127.0.0.1'))
119 (($_SERVER['SERVER_ADDR'] == '::1') && ($_SERVER['REMOTE_ADDR'] == '::1'))
123 $boot->Pman['isDev'] = true;
127 // if a file Pman_{module}_Pman exists.. and it has an init function... - call that..
129 //var_dump($this->appModules);
135 * call a method on {module}/Pman.php
136 * * initially used on the main page load to call init();
137 * * also used for ccsIncludes??
139 * // usage: $this->callModules('init', $base)
143 function callModules($fn)
145 $args = func_get_args();
147 foreach(explode(',',$this->appModules) as $m) {
148 $cls = 'Pman_'. $m . '_Pman';
149 if (!file_exists($this->rootDir . '/'.str_replace('_','/', $cls). '.php')) {
152 require_once str_replace('_','/', $cls). '.php';
154 if (method_exists($c, $fn)) {
155 call_user_funct_array(array($c,$fn),$args);
160 function get($base, $opts=array())
164 $this->callModules('init', $base);
167 //$this->allowSignup= empty($opts['allowSignup']) ? 0 : 1;
168 $bits = explode('/', $base);
171 // should really be moved to Login...
173 if ($bits[0] == 'PasswordReset') {
174 $this->linkFail = $this->resetPassword(@$bits[1],@$bits[2],@$bits[3]);
175 header('Content-type: text/html; charset=utf-8');
179 $au = $this->getAuthUser();
181 $ff= HTML_FlexyFramework::get();
183 if (!empty($ff->Pman['auth_comptype']) && $au->id > 0 &&
184 ( !$au->company_id || ($ff->Pman['auth_comptype'] != $au->company()->comptype))) {
188 $this->jerr("Login not permited to outside companies - please reload");
190 $this->addEvent("RELOAD");
195 $this->jerror("BADURL","invalid url: $base");
198 if (isset($_GET['onloadTrack'])) {
199 $this->onloadTrack = (int)$_GET['onloadTrack'];
201 // getting this to work with xhtml is a nightmare
202 // = nbsp / <img> issues screw everyting up.
203 //var_dump($this->isDev);
204 // force regeneration on load for development enviroments..
206 HTML_FlexyFramework::get()->generateDataobjectsCache($this->isDev && !empty($_REQUEST['isDev']));
208 //header('Content-type: application/xhtml+xml; charset=utf-8');
212 if ($this->company && $this->company->logo_id) {
213 $im = DB_DataObject::Factory('Images');
214 $im->get($this->company->logo_id);
215 $this->appLogo = $this->baseURL . '/Images/Thumb/x100/'. $this->company->logo_id .'/' . $im->filename;
218 header('Content-type: text/html; charset=utf-8');
221 function post($base) {
222 return $this->get($base);
226 // --------------- AUTHENTICATION or system information
229 * finds the compay with comptype=='OWNER'
230 * ?? what about comptype_id-name ?????
232 * @return {Pman_Core_DataObjects_Companies} the owner company
234 function loadOwnerCompany()
236 // only applies if authtable is person..
237 $ff = HTML_FlexyFramework::get();
238 if (!empty($ff->Pman['authTable']) && !in_array($ff->Pman['authTable'] , [ 'core_person', 'Person' ])) {
242 $this->company = DB_DataObject::Factory('core_company');
243 if (!is_a($this->company, 'DB_DataObject')) { // non-core pman projects
246 $this->company->get('comptype', 'OWNER');
247 return $this->company;
253 * getAuthUser: - get the authenticated user..
255 * @return {DB_DataObject} of type Pman[authTable] if authenticated.
258 function getAuthUser()
260 if (!empty($this->authUser)) {
261 return $this->authUser;
263 $ff = HTML_FlexyFramework::get();
264 $tbl = empty($ff->Pman['authTable']) ? 'core_person' : $ff->Pman['authTable'];
266 $u = DB_DataObject::factory( $tbl );
268 if (is_a($u,'PEAR_Error') || !$u->isAuth()) {
271 $this->authUser =$u->getAuthUser();
272 return $this->authUser ;
276 * wrapper arround authuser->hasPerm
277 * @see Pman_Core_DataObject_Core_person::hasPerm
279 * @param {String} $name The permission name (eg. Projects.List)
280 * @param {String} $lvl eg. (C)reate (E)dit (D)elete ... etc.
283 function hasPerm($name, $lvl) // do we have a permission
285 static $pcache = array();
286 $au = $this->getAuthUser();
287 return $au && $au->hasPerm($name,$lvl);
292 * modulesList: List the modules in the application
294 * @return {Array} list of modules
296 function modulesList()
298 $boot = HTML_FlexyFramework::get();
299 // echo'<PRE>';print_R($boot);exit;
302 $mods = explode(',', $boot->enable);
303 if (in_array('Core',$mods)) { // core has to be the first modules loaded as it contains Pman.js
304 array_unshift($mods, 'Core');
307 if (in_array($boot->appNameShort,$mods)) { // Project has to be the last modules loaded as it contains Pman.js
308 unset($mods[array_search($boot->appNameShort, $mods)]);
309 $mods[] = $boot->appNameShort;
312 $mods = array_unique($mods);
314 $disabled = explode(',', $boot->disable ? $boot->disable : '');
316 foreach($mods as $mod) {
317 // add the css file..
318 if (in_array($mod, $disabled)) {
329 function hasModule($name)
332 if (!strpos( $name,'.') ) {
333 // use enable / disable..
334 return in_array($name, $this->modules());
337 $x = DB_DataObject::factory('core_group_right');
338 $ar = $x->defaultPermData();
339 if (empty($ar[$name]) || empty($ar[$name][0])) {
354 * ---------------- Global Tools ---------------
356 function checkFileUploadError() // check for file upload errors.
359 empty($_FILES['File'])
360 || empty($_FILES['File']['name'])
361 || empty($_FILES['File']['tmp_name'])
362 || empty($_FILES['File']['type'])
363 || !empty($_FILES['File']['error'])
364 || empty($_FILES['File']['size'])
366 $this->jerr("File upload error: <PRE>" . print_r($_FILES,true) . print_r($_POST,true) . "</PRE>");
372 * generate a tempory file with an extension (dont forget to delete it)
375 function tempName($ext)
377 $x = tempnam(ini_get('session.save_path'), HTML_FlexyFramework::get()->appNameShort.'TMP');
379 return $x .'.'. $ext;
384 * ------------- Authentication password reset ------ ??? MOVEME?
390 function resetPassword($id,$t, $key)
393 $au = $this->getAuthUser();
395 return "Already Logged in - no need to use Password Reset";
398 $u = DB_DataObject::factory('core_person');
399 //$u->company_id = $this->company->id;
401 if (!$u->get($id) || !strlen($u->passwd)) {
406 if ($key != $u->genPassKey($t)) {
407 return "invalid key";
410 $u->no_reset_sent = 0;
413 if ($t < strtotime("NOW - 1 DAY")) {
416 $this->showNewPass = implode("/", array($id,$t,$key));
421 * jerrAuth: standard auth failure - with data that let's the UI know..
425 $au = $this->authUser();
427 // is it an authfailure?
428 $this->jerr("Permission denied to view this resource", array('authFailure' => true));
430 $this->jerr("Not authenticated", array('authFailure' => true));
436 * ---------------- Standard JSON outputers. - used everywhere
439 * ---------------- Standard JSON outputers. - used everywhere
440 * JSON error - simple error with logging.
444 function jerr($str, $errors=array(), $content_type = false) // standard error reporting..
446 return $this->jerror('ERROR', $str,$errors,$content_type);
449 * Recomended JSON error indicator
452 * @param string $type - normally 'ERROR' - you can use this to track error types.
453 * @param string $message - error message displayed to user.
454 * @param array $errors - optioanl data to pass to front end.
455 * @param string $content_type - use text/plain to return plan text - ?? not sure why...
459 function jerror($type, $str, $errors=array(), $content_type = false) // standard error reporting..
461 if ($this->transObj) {
462 $this->transObj->query('ROLLBACK');
465 if ($type !== false) {
468 DB_DataObject::factory('Events')->writeEventLogExtra($errors);
471 $this->addEvent($type, false, $str);
475 $cli = HTML_FlexyFramework::get()->cli;
477 echo "ERROR: " .$str . "\n";
478 exit(1); // cli --- exit code to stop shell execution if necessary.
482 if ($content_type == 'text/plain') {
483 header('Content-Disposition: attachment; filename="error.txt"');
484 header('Content-type: '. $content_type);
485 echo "ERROR: " .$str . "\n";
491 require_once 'Services/JSON.php';
492 $json = new Services_JSON();
496 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
497 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
500 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
504 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
509 header('Content-type: text/html');
510 echo "<HTML><HEAD></HEAD><BODY>";
511 echo $json->encodeUnsafe(array(
514 'message' => $str, // compate with exeption / loadexception.
516 'errors' => $errors ? $errors : true, // used by forms to flag errors.
517 'authFailure' => !empty($errors['authFailure']),
519 echo "</BODY></HTML>";
523 if (isset($_REQUEST['_debug'])) {
524 echo '<PRE>'.htmlspecialchars(print_r(array(
528 'message' => $str, // compate with exeption / loadexception.
529 'errors' => $errors ? $errors : true, // used by forms to flag errors.
530 'authFailure' => !empty($errors['authFailure']),
536 echo $json->encode(array(
540 'message' => $str, // compate with exeption / loadexception.
541 'errors' => $errors ? $errors : true, // used by forms to flag errors.
542 'authFailure' => !empty($errors['authFailure']),
551 if ($this->transObj ) {
552 $this->transObj->query( connection_aborted() ? 'ROLLBACK' : 'COMMIT');
555 $cli = HTML_FlexyFramework::get()->cli;
557 echo "OK: " .$str . "\n";
560 require_once 'Services/JSON.php';
561 $json = new Services_JSON();
563 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
564 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
567 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
571 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
575 header('Content-type: text/html');
576 echo "<HTML><HEAD></HEAD><BODY>";
577 // encode html characters so they can be read..
578 echo str_replace(array('<','>'), array('\u003c','\u003e'),
579 $json->encodeUnsafe(array('success'=> true, 'data' => $str)));
580 echo "</BODY></HTML>";
585 echo $json->encode(array('success'=> true, 'data' => $str));
591 * output data for grids or tree
592 * @ar {Array} ar Array of data
593 * @total {Number|false} total number of records (or false to return count(ar)
594 * @extra {Array} extra key value list of data to pass as extra data.
597 function jdata($ar,$total=false, $extra=array(), $cachekey = false)
599 // should do mobile checking???
600 if ($total == false) {
603 $extra= $extra ? $extra : array();
604 require_once 'Services/JSON.php';
605 $json = new Services_JSON();
607 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
608 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
611 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
615 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
620 header('Content-type: text/html');
621 echo "<HTML><HEAD></HEAD><BODY>";
622 // encode html characters so they can be read..
623 echo str_replace(array('<','>'), array('\u003c','\u003e'),
624 $json->encodeUnsafe(array('success' => true, 'total'=> $total, 'data' => $ar) + $extra));
625 echo "</BODY></HTML>";
630 // see if trimming will help...
631 if (!empty($_REQUEST['_pman_short'])) {
634 foreach($ar as $as) {
636 foreach($as as $k=>$v) {
637 if (is_string($v) && !strlen(trim($v))) {
649 $ret = $json->encode(array('success' => true, 'total'=> $total, 'data' => $ar) + $extra);
651 if (!empty($cachekey)) {
653 $fn = ini_get('session.save_path') . '/json-cache'.date('/Y/m/d').'.'. $cachekey . '.cache.json';
654 if (!file_exists(dirname($fn))) {
655 mkdir(dirname($fn), 0777,true);
657 file_put_contents($fn, $ret);
665 /** a daily cache **/
666 function jdataCache($cachekey)
668 $fn = ini_get('session.save_path') . '/json-cache'.date('/Y/m/d').'.'. $cachekey . '.cache.json';
669 if (file_exists($fn)) {
670 header('Content-type: application/json');
671 echo file_get_contents($fn);
681 * ---------------- OUTPUT
683 function hasBg($fn) // used on front page to check if logos exist..
685 return file_exists($this->rootDir.'/Pman/'.$this->appNameShort.'/templates/images/'. $fn);
688 * outputJavascriptIncludes:
690 * output <script....> for all the modules in the applcaiton
693 function outputJavascriptIncludes()
695 // BC support - currently 1 project still relies on this.. (MO portal)
696 $o = HTML_FlexyFramework::get()->Pman_Core;
697 if (isset($o['packseed'])) {
698 return $this->outputJavascriptIncludesBC();
702 $mods = $this->modulesList();
704 $is_bootstrap = in_array('BAdmin', $mods);
706 foreach($mods as $mod) {
707 // add the css file..
710 if (!file_exists($this->rootDir."/Pman/$mod/is_bootstrap")) {
711 echo '<!-- missing '. $this->rootDir."/Pman/$mod/is_bootstrap - skipping -->";
717 $this->outputJavascriptDir("Pman/$mod/widgets", "*.js");
718 $this->outputJavascriptDir("Pman/$mod", "*.js");
722 if (empty($this->disable_jstemplate)) {
723 // and finally the JsTemplate...
724 echo '<script type="text/javascript" src="'. $this->baseURL. '/Core/JsTemplate"></script>'."\n";
732 * output <link rel=stylesheet......> for all the modules in the applcaiton
735 * This could css minify as well.
737 function outputCSSIncludes() // includes on CSS links.
740 $mods = $this->modulesList();
742 foreach($mods as $mod) {
743 // add the css file..
744 $this->outputCSSDir("Pman/$mod","*.css");
747 $this->callModules('outputCSSIncludes', false);
766 // --- OLD CODE - in for BC on MO project.... - needs removing...
768 // used on old versions.....
769 function outputJavascriptIncludesBC()
772 $mods = $this->modulesList();
774 foreach($mods as $mod) {
775 // add the css file..
778 $files = $this->moduleJavascriptList($mod.'/widgets');
779 foreach($files as $f) {
780 echo '<script type="text/javascript" src="'. $f. '"></script>'."\n";
783 $files = $this->moduleJavascriptList($mod);
784 foreach($files as $f) {
785 echo '<script type="text/javascript" src="'. $f. '"></script>'."\n";
789 if (empty($this->disable_jstemplate)) {
790 // and finally the JsTemplate...
791 echo '<script type="text/javascript" src="'. $this->baseURL. '/Core/JsTemplate"></script>'."\n";
796 * Gather infor for javascript files..
798 * @param {String} $mod the module to get info about.
799 * @return {StdClass} details about module.
801 function moduleJavascriptFilesInfo($mod)
804 static $cache = array();
806 if (isset($cache[$mod])) {
811 $ff = HTML_FlexyFramework::get();
813 $base = dirname($_SERVER['SCRIPT_FILENAME']);
814 $dir = $this->rootDir.'/Pman/'. $mod;
815 $path = $this->rootURL ."/Pman/$mod/";
817 $ar = glob($dir . '/*.js');
823 foreach($ar as $fn) {
825 // got the 'module file..'
826 $mtime = filemtime($dir . '/'. $f);
827 $maxtime = max($mtime, $maxtime);
828 $arfiles[$fn] = $mtime;
829 $files[] = $path . $f . '?ts='.$mtime;
832 ksort($arfiles); // just sort by name so it's consistant for serialize..
834 $compile = empty($ff->Pman['public_cache_dir']) ? 0 : 1;
835 $basedir = $compile ? $ff->Pman['public_cache_dir'] : false;
836 $baseurl = $compile ? $ff->Pman['public_cache_url'] : false;
841 $lsort = create_function('$a,$b','return strlen($a) > strlen($b) ? 1 : -1;');
842 usort($files, $lsort);
844 $smod = str_replace('/','.',$mod);
846 $output = date('Y-m-d-H-i-s-', $maxtime). $smod .'-'.md5(serialize($arfiles)) .'.js';
849 // why are translations done like this - we just build them on the fly frmo the database..
850 $tmtime = file_exists($this->rootDir.'/_translations_/'. $smod.'.js')
851 ? filemtime($this->rootDir.'/_translations_/'. $smod.'.js') : 0;
853 $cache[$mod] = (object) array(
854 'smod' => $smod, // module name without '/'
855 'files' => $files, // list of all files.
856 'filesmtime' => $arfiles, // map of mtime=>file
857 'maxtime' => $maxtime, // max mtime
858 'compile' => $this->isDev ? false : $compile,
859 'translation_file' => $base .'/_translations_/' . $smod . '.js',
860 'translation_mtime' => $tmtime,
862 'translation_data' => preg_replace('/\.js$/', '.__translation__.js', $output),
863 'translation_base' => $dir .'/', //prefix of filename (without moudle name))
864 'basedir' => $basedir,
865 'baseurl' => $baseurl,
866 'module_dir' => $dir,
873 * moduleJavascriptList: list the javascript files in a module
875 * The original version of this.. still needs more thought...
877 * Compiled is in Pman/_compiled_/{$mod}/{LATEST...}.js
878 * Translations are in Pman/_translations_/{$mod}.js
880 * if that stuff does not exist just list files in Pman/{$mod}/*.js
882 * Compiled could be done on the fly..
886 * @param {String} $mod the module to look at - eg. Pman/{$mod}/*.js
887 * @return {Array} list of include paths (either compiled or raw)
893 function moduleJavascriptList($mod)
897 $dir = $this->rootDir.'/Pman/'. $mod;
900 if (!file_exists($dir)) {
901 echo '<!-- missing directory '. htmlspecialchars($dir) .' -->';
905 $info = $this->moduleJavascriptFilesInfo($mod);
909 if (empty($info->files)) {
912 // finally sort the files, so they are in the right order..
914 // only compile this stuff if public_cache is set..
918 // public_cache_dir = /var/www/myproject_cache
919 // public_cache_url = /myproject_cache (with Alias apache /myproject_cache/ /var/www/myproject_cache/)
922 if (!$info->compile) {
923 echo "<!-- Javascript compile turned off (isDev on, or public_cache_dir not set) -->\n";
927 // where are we going to write all of this..
928 // This has to be done via a
929 if (!file_exists($info->basedir.'/'.$info->output) || !filesize($info->basedir.'/'.$info->output)) {
930 require_once 'Pman/Core/JsCompile.php';
931 $x = new Pman_Core_JsCompile();
933 $x->pack($info->filesmtime,$info->basedir.'/'.$info->output, $info->translation_base);
935 echo "<!-- file exists not exist: {$info->basedir}/{$info->output} -->\n";
938 if (file_exists($info->basedir.'/'.$info->output) &&
939 filesize($info->basedir.'/'.$info->output)) {
942 $info->baseurl.'/'. $info->output,
945 // output all the ava
946 // fixme - this needs the max datetime for the translation file..
947 $ret[] = $this->baseURL."/Admin/InterfaceTranslations/".$mod.".js"; //?ts=".$info->translation_mtime;
949 //if ($info->translation_mtime) {
950 // $ret[] = $this->rootURL."/_translations_/". $info->smod.".js?ts=".$info->translation_mtime;
957 // give up and output original files...
967 * PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
969 function initErrorHandling()
971 if (!class_exists('HTML_FlexyFramework2')) {
972 // what about older code that still users PEAR?
973 PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
975 set_exception_handler(array($this,'onException'));
980 static $permitError = false; // static why?
982 var $showErrorToUser = true;
984 function onPearError($err)
986 return $this->onException($err);
991 function onException($ex)
993 static $reported = false;
998 if (Pman::$permitError) {
1005 $out = is_a($ex,'Exception') || is_a($ex, 'Error') ? $ex->getMessage() : $ex->toString();
1008 //print_R($bt); exit;
1011 $bt = is_a($ex,'Exception')|| is_a($ex, 'Error') ? $ex->getTrace() : $ex->backtrace;
1012 if (is_a($ex,'Exception')|| is_a($ex, 'Error') ) {
1013 $ret[] = $ex->getFile() . '('. $ex->getLine() . ')';
1015 foreach( $bt as $b) {
1016 $ret[] = @$b['file'] . '(' . @$b['line'] . ')@' . @$b['class'] . '::' . @$b['function'];
1022 //convert the huge backtrace into something that is readable..
1023 $out .= "\n" . implode("\n", $ret);
1025 $this->addEvent("EXCEPTION", false, $out);
1027 if ($this->showErrorToUser) {
1030 // not sure why this is here... - perhaps doing a jerr() was actually caught by the UI, and hidden from the user..?
1031 $this->jerror(false,"An error Occured, please contact the website owner");
1033 //$this->jerr($out);
1040 * ---------------- Logging ---------------
1045 * Log an action (only if it has not been logged already.
1047 * @param {String} action - group/name of event
1048 * @param {DataObject|false} obj - dataobject action occured on.
1049 * @param {String} any remarks
1050 * @return {false|DB_DataObject} Event object.,
1053 function addEventOnce($act, $obj = false, $remarks = '')
1055 if (!empty(HTML_FlexyFramework::get()->Pman['disable_events'])) {
1058 $e = DB_DataObject::factory('Events');
1059 $e->init($act,$obj,$remarks);
1060 if ($e->find(true)) {
1063 return $this->addEvent($act, $obj, $remarks);
1069 * @param {String} action - group/name of event
1070 * @param {DataObject|false} obj - dataobject action occured on.
1071 * @param {String} any remarks
1072 * @return {DB_DataObject} Event object.,
1075 function addEvent($act, $obj = false, $remarks = '')
1078 if (!empty(HTML_FlexyFramework::get()->Pman['disable_events'])) {
1081 $au = $this->getAuthUser();
1083 $e = DB_DataObject::factory('Events');
1084 $e->init($act,$obj,$remarks);
1086 $e->event_when = $e->sqlValue('NOW()');
1088 $eid = $e->insert();
1090 // fixme - this should be in onInsert..
1091 $wa = DB_DataObject::factory('core_watch');
1092 if (method_exists($wa,'notifyEvent')) {
1093 $wa->notifyEvent($e); // trigger any actions..
1097 $e->onInsert(isset($_REQUEST) ? $_REQUEST : array() , $this);
1104 function addEventNotifyOnly($act, $obj = false, $remarks = '')
1106 $au = $this->getAuthUser();
1108 $e = DB_DataObject::factory('Events');
1109 $e->init($act,$obj,$remarks);
1111 $e->event_when = $e->sqlValue('NOW()');
1112 $wa = DB_DataObject::factory('core_watch');
1113 if (method_exists($wa,'notifyEvent')) {
1114 $wa->notifyEvent($e); // trigger any actions..
1119 // ------------------ DEPERCIATED ----------------------------
1121 // DEPRECITAED - use moduleslist
1122 function modules() { return $this->modulesList(); }
1124 // DEPRECIATED.. - use getAuthUser...
1125 function staticGetAuthUser() { $x = new Pman(); return $x->getAuthUser(); }
1128 // DEPRICATED USE Pman_Core_Mailer
1130 function emailTemplate($templateFile, $args)
1133 require_once 'Pman/Core/Mailer.php';
1134 $r = new Pman_Core_Mailer(array(
1135 'template'=>$templateFile,
1136 'contents' => $args,
1139 return $r->toData();
1142 // DEPRICATED - USE Pman_Core_Mailer
1143 // WHAT Part about DEPRICATED Does no one understand??
1144 function sendTemplate($templateFile, $args)
1146 require_once 'Pman/Core/Mailer.php';
1147 $r = new Pman_Core_Mailer(array(
1148 'template'=>$templateFile,
1149 'contents' => array(),