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();
146 foreach(explode(',',$this->appModules) as $m) {
147 $cls = 'Pman_'. $m . '_Pman';
148 if (!file_exists($this->rootDir . '/'.str_replace('_','/', $cls). '.php')) {
151 require_once str_replace('_','/', $cls). '.php';
153 if (method_exists($c, $fn)) {
154 call_user_func_array(array($c,$fn),$args);
159 function get($base, $opts=array())
163 $this->callModules('init', $base);
166 //$this->allowSignup= empty($opts['allowSignup']) ? 0 : 1;
167 $bits = explode('/', $base);
170 // should really be moved to Login...
172 if ($bits[0] == 'PasswordReset') {
173 $this->linkFail = $this->resetPassword(@$bits[1],@$bits[2],@$bits[3]);
174 header('Content-type: text/html; charset=utf-8');
178 $au = $this->getAuthUser();
180 $ff= HTML_FlexyFramework::get();
182 if (!empty($ff->Pman['auth_comptype']) && $au->id > 0 &&
183 ( !$au->company_id || ($ff->Pman['auth_comptype'] != $au->company()->comptype))) {
187 $this->jerr("Login not permited to outside companies - please reload");
189 $this->addEvent("RELOAD");
194 $this->jerror("BADURL","invalid url: $base");
197 if (isset($_GET['onloadTrack'])) {
198 $this->onloadTrack = (int)$_GET['onloadTrack'];
200 // getting this to work with xhtml is a nightmare
201 // = nbsp / <img> issues screw everyting up.
202 //var_dump($this->isDev);
203 // force regeneration on load for development enviroments..
205 HTML_FlexyFramework::get()->generateDataobjectsCache($this->isDev && !empty($_REQUEST['isDev']));
207 //header('Content-type: application/xhtml+xml; charset=utf-8');
211 if ($this->company && $this->company->logo_id) {
212 $im = DB_DataObject::Factory('Images');
213 $im->get($this->company->logo_id);
214 $this->appLogo = $this->baseURL . '/Images/Thumb/x100/'. $this->company->logo_id .'/' . $im->filename;
217 header('Content-type: text/html; charset=utf-8');
220 function post($base) {
221 return $this->get($base);
225 // --------------- AUTHENTICATION or system information
228 * finds the compay with comptype=='OWNER'
229 * ?? what about comptype_id-name ?????
231 * @return {Pman_Core_DataObjects_Companies} the owner company
233 function loadOwnerCompany()
235 // only applies if authtable is person..
236 $ff = HTML_FlexyFramework::get();
237 if (!empty($ff->Pman['authTable']) && !in_array($ff->Pman['authTable'] , [ 'core_person', 'Person' ])) {
241 $this->company = DB_DataObject::Factory('core_company');
242 if (!is_a($this->company, 'DB_DataObject')) { // non-core pman projects
245 $this->company->get('comptype', 'OWNER');
246 return $this->company;
252 * getAuthUser: - get the authenticated user..
254 * @return {DB_DataObject} of type Pman[authTable] if authenticated.
257 function getAuthUser()
259 if (!empty($this->authUser)) {
260 return $this->authUser;
262 $ff = HTML_FlexyFramework::get();
263 $tbl = empty($ff->Pman['authTable']) ? 'core_person' : $ff->Pman['authTable'];
265 $u = DB_DataObject::factory( $tbl );
267 if (is_a($u,'PEAR_Error') || !$u->isAuth()) {
270 $this->authUser =$u->getAuthUser();
271 return $this->authUser ;
275 * wrapper arround authuser->hasPerm
276 * @see Pman_Core_DataObject_Core_person::hasPerm
278 * @param {String} $name The permission name (eg. Projects.List)
279 * @param {String} $lvl eg. (C)reate (E)dit (D)elete ... etc.
282 function hasPerm($name, $lvl) // do we have a permission
284 static $pcache = array();
285 $au = $this->getAuthUser();
286 return $au && $au->hasPerm($name,$lvl);
291 * modulesList: List the modules in the application
293 * @return {Array} list of modules
295 function modulesList()
297 $boot = HTML_FlexyFramework::get();
298 // echo'<PRE>';print_R($boot);exit;
301 $mods = explode(',', $boot->enable);
302 if (in_array('Core',$mods)) { // core has to be the first modules loaded as it contains Pman.js
303 array_unshift($mods, 'Core');
306 if (in_array($boot->appNameShort,$mods)) { // Project has to be the last modules loaded as it contains Pman.js
307 unset($mods[array_search($boot->appNameShort, $mods)]);
308 $mods[] = $boot->appNameShort;
311 $mods = array_unique($mods);
313 $disabled = explode(',', $boot->disable ? $boot->disable : '');
315 foreach($mods as $mod) {
316 // add the css file..
317 if (in_array($mod, $disabled)) {
328 function hasModule($name)
331 if (!strpos( $name,'.') ) {
332 // use enable / disable..
333 return in_array($name, $this->modules());
336 $x = DB_DataObject::factory('core_group_right');
337 $ar = $x->defaultPermData();
338 if (empty($ar[$name]) || empty($ar[$name][0])) {
353 * ---------------- Global Tools ---------------
355 function checkFileUploadError() // check for file upload errors.
358 empty($_FILES['File'])
359 || empty($_FILES['File']['name'])
360 || empty($_FILES['File']['tmp_name'])
361 || empty($_FILES['File']['type'])
362 || !empty($_FILES['File']['error'])
363 || empty($_FILES['File']['size'])
365 $this->jerr("File upload error: <PRE>" . print_r($_FILES,true) . print_r($_POST,true) . "</PRE>");
371 * generate a tempory file with an extension (dont forget to delete it)
374 function tempName($ext)
376 $x = tempnam(ini_get('session.save_path'), HTML_FlexyFramework::get()->appNameShort.'TMP');
378 return $x .'.'. $ext;
383 * ------------- Authentication password reset ------ ??? MOVEME?
389 function resetPassword($id,$t, $key)
392 $au = $this->getAuthUser();
394 return "Already Logged in - no need to use Password Reset";
397 $u = DB_DataObject::factory('core_person');
398 //$u->company_id = $this->company->id;
400 if (!$u->get($id) || !strlen($u->passwd)) {
405 if ($key != $u->genPassKey($t)) {
406 return "invalid key";
409 $u->no_reset_sent = 0;
412 if ($t < strtotime("NOW - 1 DAY")) {
415 $this->showNewPass = implode("/", array($id,$t,$key));
420 * jerrAuth: standard auth failure - with data that let's the UI know..
424 $au = $this->authUser();
426 // is it an authfailure?
427 $this->jerr("Permission denied to view this resource", array('authFailure' => true));
429 $this->jerr("Not authenticated", array('authFailure' => true));
435 * ---------------- Standard JSON outputers. - used everywhere
438 * ---------------- Standard JSON outputers. - used everywhere
439 * JSON error - simple error with logging.
443 function jerr($str, $errors=array(), $content_type = false) // standard error reporting..
445 return $this->jerror('ERROR', $str,$errors,$content_type);
448 * Recomended JSON error indicator
451 * @param string $type - normally 'ERROR' - you can use this to track error types.
452 * @param string $message - error message displayed to user.
453 * @param array $errors - optioanl data to pass to front end.
454 * @param string $content_type - use text/plain to return plan text - ?? not sure why...
458 function jerror($type, $str, $errors=array(), $content_type = false) // standard error reporting..
460 if ($this->transObj) {
461 $this->transObj->query('ROLLBACK');
464 if ($type !== false) {
467 DB_DataObject::factory('Events')->writeEventLogExtra($errors);
470 $this->addEvent($type, false, $str);
474 $cli = HTML_FlexyFramework::get()->cli;
476 echo "ERROR: " .$str . "\n";
477 exit(1); // cli --- exit code to stop shell execution if necessary.
481 if ($content_type == 'text/plain') {
482 header('Content-Disposition: attachment; filename="error.txt"');
483 header('Content-type: '. $content_type);
484 echo "ERROR: " .$str . "\n";
490 require_once 'Services/JSON.php';
491 $json = new Services_JSON();
495 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
496 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
499 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
503 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
508 header('Content-type: text/html');
509 echo "<HTML><HEAD></HEAD><BODY>";
510 echo $json->encodeUnsafe(array(
513 'message' => $str, // compate with exeption / loadexception.
515 'errors' => $errors ? $errors : true, // used by forms to flag errors.
516 'authFailure' => !empty($errors['authFailure']),
518 echo "</BODY></HTML>";
522 if (isset($_REQUEST['_debug'])) {
523 echo '<PRE>'.htmlspecialchars(print_r(array(
527 'message' => $str, // compate with exeption / loadexception.
528 'errors' => $errors ? $errors : true, // used by forms to flag errors.
529 'authFailure' => !empty($errors['authFailure']),
535 echo $json->encode(array(
539 'message' => $str, // compate with exeption / loadexception.
540 'errors' => $errors ? $errors : true, // used by forms to flag errors.
541 'authFailure' => !empty($errors['authFailure']),
550 if ($this->transObj ) {
551 $this->transObj->query( connection_aborted() ? 'ROLLBACK' : 'COMMIT');
554 $cli = HTML_FlexyFramework::get()->cli;
556 echo "OK: " .$str . "\n";
559 require_once 'Services/JSON.php';
560 $json = new Services_JSON();
562 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
563 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
566 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
570 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
574 header('Content-type: text/html');
575 echo "<HTML><HEAD></HEAD><BODY>";
576 // encode html characters so they can be read..
577 echo str_replace(array('<','>'), array('\u003c','\u003e'),
578 $json->encodeUnsafe(array('success'=> true, 'data' => $str)));
579 echo "</BODY></HTML>";
584 echo $json->encode(array('success'=> true, 'data' => $str));
590 * output data for grids or tree
591 * @ar {Array} ar Array of data
592 * @total {Number|false} total number of records (or false to return count(ar)
593 * @extra {Array} extra key value list of data to pass as extra data.
596 function jdata($ar,$total=false, $extra=array(), $cachekey = false)
598 // should do mobile checking???
599 if ($total == false) {
602 $extra= $extra ? $extra : array();
603 require_once 'Services/JSON.php';
604 $json = new Services_JSON();
606 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
607 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
610 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
614 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
619 header('Content-type: text/html');
620 echo "<HTML><HEAD></HEAD><BODY>";
621 // encode html characters so they can be read..
622 echo str_replace(array('<','>'), array('\u003c','\u003e'),
623 $json->encodeUnsafe(array('success' => true, 'total'=> $total, 'data' => $ar) + $extra));
624 echo "</BODY></HTML>";
629 // see if trimming will help...
630 if (!empty($_REQUEST['_pman_short'])) {
633 foreach($ar as $as) {
635 foreach($as as $k=>$v) {
636 if (is_string($v) && !strlen(trim($v))) {
648 $ret = $json->encode(array('success' => true, 'total'=> $total, 'data' => $ar) + $extra);
650 if (!empty($cachekey)) {
652 $fn = ini_get('session.save_path') . '/json-cache'.date('/Y/m/d').'.'. $cachekey . '.cache.json';
653 if (!file_exists(dirname($fn))) {
654 mkdir(dirname($fn), 0777,true);
656 file_put_contents($fn, $ret);
664 /** a daily cache **/
665 function jdataCache($cachekey)
667 $fn = ini_get('session.save_path') . '/json-cache'.date('/Y/m/d').'.'. $cachekey . '.cache.json';
668 if (file_exists($fn)) {
669 header('Content-type: application/json');
670 echo file_get_contents($fn);
680 * ---------------- OUTPUT
682 function hasBg($fn) // used on front page to check if logos exist..
684 return file_exists($this->rootDir.'/Pman/'.$this->appNameShort.'/templates/images/'. $fn);
687 * outputJavascriptIncludes:
689 * output <script....> for all the modules in the applcaiton
692 function outputJavascriptIncludes()
694 // BC support - currently 1 project still relies on this.. (MO portal)
695 $o = HTML_FlexyFramework::get()->Pman_Core;
696 if (isset($o['packseed'])) {
697 return $this->outputJavascriptIncludesBC();
701 $mods = $this->modulesList();
703 $is_bootstrap = in_array('BAdmin', $mods);
705 foreach($mods as $mod) {
706 // add the css file..
709 if (!file_exists($this->rootDir."/Pman/$mod/is_bootstrap")) {
710 echo '<!-- missing '. $this->rootDir."/Pman/$mod/is_bootstrap - skipping -->";
716 $this->outputJavascriptDir("Pman/$mod/widgets", "*.js");
717 $this->outputJavascriptDir("Pman/$mod", "*.js");
721 if (empty($this->disable_jstemplate)) {
722 // and finally the JsTemplate...
723 echo '<script type="text/javascript" src="'. $this->baseURL. '/Core/JsTemplate"></script>'."\n";
731 * output <link rel=stylesheet......> for all the modules in the applcaiton
734 * This could css minify as well.
736 function outputCSSIncludes() // includes on CSS links.
739 $mods = $this->modulesList();
741 foreach($mods as $mod) {
742 // add the css file..
743 $this->outputCSSDir("Pman/$mod","*.css");
746 $this->callModules('outputCSSIncludes', false);
765 // --- OLD CODE - in for BC on MO project.... - needs removing...
767 // used on old versions.....
768 function outputJavascriptIncludesBC()
771 $mods = $this->modulesList();
773 foreach($mods as $mod) {
774 // add the css file..
777 $files = $this->moduleJavascriptList($mod.'/widgets');
778 foreach($files as $f) {
779 echo '<script type="text/javascript" src="'. $f. '"></script>'."\n";
782 $files = $this->moduleJavascriptList($mod);
783 foreach($files as $f) {
784 echo '<script type="text/javascript" src="'. $f. '"></script>'."\n";
788 if (empty($this->disable_jstemplate)) {
789 // and finally the JsTemplate...
790 echo '<script type="text/javascript" src="'. $this->baseURL. '/Core/JsTemplate"></script>'."\n";
795 * Gather infor for javascript files..
797 * @param {String} $mod the module to get info about.
798 * @return {StdClass} details about module.
800 function moduleJavascriptFilesInfo($mod)
803 static $cache = array();
805 if (isset($cache[$mod])) {
810 $ff = HTML_FlexyFramework::get();
812 $base = dirname($_SERVER['SCRIPT_FILENAME']);
813 $dir = $this->rootDir.'/Pman/'. $mod;
814 $path = $this->rootURL ."/Pman/$mod/";
816 $ar = glob($dir . '/*.js');
822 foreach($ar as $fn) {
824 // got the 'module file..'
825 $mtime = filemtime($dir . '/'. $f);
826 $maxtime = max($mtime, $maxtime);
827 $arfiles[$fn] = $mtime;
828 $files[] = $path . $f . '?ts='.$mtime;
831 ksort($arfiles); // just sort by name so it's consistant for serialize..
833 $compile = empty($ff->Pman['public_cache_dir']) ? 0 : 1;
834 $basedir = $compile ? $ff->Pman['public_cache_dir'] : false;
835 $baseurl = $compile ? $ff->Pman['public_cache_url'] : false;
840 $lsort = create_function('$a,$b','return strlen($a) > strlen($b) ? 1 : -1;');
841 usort($files, $lsort);
843 $smod = str_replace('/','.',$mod);
845 $output = date('Y-m-d-H-i-s-', $maxtime). $smod .'-'.md5(serialize($arfiles)) .'.js';
848 // why are translations done like this - we just build them on the fly frmo the database..
849 $tmtime = file_exists($this->rootDir.'/_translations_/'. $smod.'.js')
850 ? filemtime($this->rootDir.'/_translations_/'. $smod.'.js') : 0;
852 $cache[$mod] = (object) array(
853 'smod' => $smod, // module name without '/'
854 'files' => $files, // list of all files.
855 'filesmtime' => $arfiles, // map of mtime=>file
856 'maxtime' => $maxtime, // max mtime
857 'compile' => $this->isDev ? false : $compile,
858 'translation_file' => $base .'/_translations_/' . $smod . '.js',
859 'translation_mtime' => $tmtime,
861 'translation_data' => preg_replace('/\.js$/', '.__translation__.js', $output),
862 'translation_base' => $dir .'/', //prefix of filename (without moudle name))
863 'basedir' => $basedir,
864 'baseurl' => $baseurl,
865 'module_dir' => $dir,
872 * moduleJavascriptList: list the javascript files in a module
874 * The original version of this.. still needs more thought...
876 * Compiled is in Pman/_compiled_/{$mod}/{LATEST...}.js
877 * Translations are in Pman/_translations_/{$mod}.js
879 * if that stuff does not exist just list files in Pman/{$mod}/*.js
881 * Compiled could be done on the fly..
885 * @param {String} $mod the module to look at - eg. Pman/{$mod}/*.js
886 * @return {Array} list of include paths (either compiled or raw)
892 function moduleJavascriptList($mod)
896 $dir = $this->rootDir.'/Pman/'. $mod;
899 if (!file_exists($dir)) {
900 echo '<!-- missing directory '. htmlspecialchars($dir) .' -->';
904 $info = $this->moduleJavascriptFilesInfo($mod);
908 if (empty($info->files)) {
911 // finally sort the files, so they are in the right order..
913 // only compile this stuff if public_cache is set..
917 // public_cache_dir = /var/www/myproject_cache
918 // public_cache_url = /myproject_cache (with Alias apache /myproject_cache/ /var/www/myproject_cache/)
921 if (!$info->compile) {
922 echo "<!-- Javascript compile turned off (isDev on, or public_cache_dir not set) -->\n";
926 // where are we going to write all of this..
927 // This has to be done via a
928 if (!file_exists($info->basedir.'/'.$info->output) || !filesize($info->basedir.'/'.$info->output)) {
929 require_once 'Pman/Core/JsCompile.php';
930 $x = new Pman_Core_JsCompile();
932 $x->pack($info->filesmtime,$info->basedir.'/'.$info->output, $info->translation_base);
934 echo "<!-- file exists not exist: {$info->basedir}/{$info->output} -->\n";
937 if (file_exists($info->basedir.'/'.$info->output) &&
938 filesize($info->basedir.'/'.$info->output)) {
941 $info->baseurl.'/'. $info->output,
944 // output all the ava
945 // fixme - this needs the max datetime for the translation file..
946 $ret[] = $this->baseURL."/Admin/InterfaceTranslations/".$mod.".js"; //?ts=".$info->translation_mtime;
948 //if ($info->translation_mtime) {
949 // $ret[] = $this->rootURL."/_translations_/". $info->smod.".js?ts=".$info->translation_mtime;
956 // give up and output original files...
966 * PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
968 function initErrorHandling()
970 if (!class_exists('HTML_FlexyFramework2')) {
971 // what about older code that still users PEAR?
972 PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
974 set_exception_handler(array($this,'onException'));
979 static $permitError = false; // static why?
981 var $showErrorToUser = true;
983 function onPearError($err)
985 return $this->onException($err);
990 function onException($ex)
992 static $reported = false;
997 if (Pman::$permitError) {
1004 $out = is_a($ex,'Exception') || is_a($ex, 'Error') ? $ex->getMessage() : $ex->toString();
1007 //print_R($bt); exit;
1010 $bt = is_a($ex,'Exception')|| is_a($ex, 'Error') ? $ex->getTrace() : $ex->backtrace;
1011 if (is_a($ex,'Exception')|| is_a($ex, 'Error') ) {
1012 $ret[] = $ex->getFile() . '('. $ex->getLine() . ')';
1014 foreach( $bt as $b) {
1015 $ret[] = @$b['file'] . '(' . @$b['line'] . ')@' . @$b['class'] . '::' . @$b['function'];
1021 //convert the huge backtrace into something that is readable..
1022 $out .= "\n" . implode("\n", $ret);
1024 $this->addEvent("EXCEPTION", false, $out);
1026 if ($this->showErrorToUser) {
1029 // not sure why this is here... - perhaps doing a jerr() was actually caught by the UI, and hidden from the user..?
1030 $this->jerror(false,"An error Occured, please contact the website owner");
1032 //$this->jerr($out);
1039 * ---------------- Logging ---------------
1044 * Log an action (only if it has not been logged already.
1046 * @param {String} action - group/name of event
1047 * @param {DataObject|false} obj - dataobject action occured on.
1048 * @param {String} any remarks
1049 * @return {false|DB_DataObject} Event object.,
1052 function addEventOnce($act, $obj = false, $remarks = '')
1054 if (!empty(HTML_FlexyFramework::get()->Pman['disable_events'])) {
1057 $e = DB_DataObject::factory('Events');
1058 $e->init($act,$obj,$remarks);
1059 if ($e->find(true)) {
1062 return $this->addEvent($act, $obj, $remarks);
1068 * @param {String} action - group/name of event
1069 * @param {DataObject|false} obj - dataobject action occured on.
1070 * @param {String} any remarks
1071 * @return {DB_DataObject} Event object.,
1074 function addEvent($act, $obj = false, $remarks = '')
1077 if (!empty(HTML_FlexyFramework::get()->Pman['disable_events'])) {
1080 $au = $this->getAuthUser();
1082 $e = DB_DataObject::factory('Events');
1083 $e->init($act,$obj,$remarks);
1085 $e->event_when = $e->sqlValue('NOW()');
1087 $eid = $e->insert();
1089 // fixme - this should be in onInsert..
1090 $wa = DB_DataObject::factory('core_watch');
1091 if (method_exists($wa,'notifyEvent')) {
1092 $wa->notifyEvent($e); // trigger any actions..
1096 $e->onInsert(isset($_REQUEST) ? $_REQUEST : array() , $this);
1103 function addEventNotifyOnly($act, $obj = false, $remarks = '')
1105 $au = $this->getAuthUser();
1107 $e = DB_DataObject::factory('Events');
1108 $e->init($act,$obj,$remarks);
1110 $e->event_when = $e->sqlValue('NOW()');
1111 $wa = DB_DataObject::factory('core_watch');
1112 if (method_exists($wa,'notifyEvent')) {
1113 $wa->notifyEvent($e); // trigger any actions..
1118 // ------------------ DEPERCIATED ----------------------------
1120 // DEPRECITAED - use moduleslist
1121 function modules() { return $this->modulesList(); }
1123 // DEPRECIATED.. - use getAuthUser...
1124 function staticGetAuthUser() { $x = new Pman(); return $x->getAuthUser(); }
1127 // DEPRICATED USE Pman_Core_Mailer
1129 function emailTemplate($templateFile, $args)
1132 require_once 'Pman/Core/Mailer.php';
1133 $r = new Pman_Core_Mailer(array(
1134 'template'=>$templateFile,
1135 'contents' => $args,
1138 return $r->toData();
1141 // DEPRICATED - USE Pman_Core_Mailer
1142 // WHAT Part about DEPRICATED Does no one understand??
1143 function sendTemplate($templateFile, $args)
1145 require_once 'Pman/Core/Mailer.php';
1146 $r = new Pman_Core_Mailer(array(
1147 'template'=>$templateFile,
1148 'contents' => array(),