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 * module init is only loaded on main page call, and includes checks for configuration settings.
137 * // callModules('init', $base)
141 function callModules($fn, $base)
143 foreach(explode(',',$this->appModules) as $m) {
145 $cls = 'Pman_'. $m . '_Pman';
147 if (!file_exists($this->rootDir . '/'.str_replace('_','/', $cls). '.php')) {
151 require_once str_replace('_','/', $cls). '.php';
155 if (method_exists($c, $fn)) {
157 $c->{$fn}($this,$base);
163 function get($base, $opts=array())
167 // $this->callModules('init', $base);
168 $this->initModules($base);
171 //$this->allowSignup= empty($opts['allowSignup']) ? 0 : 1;
172 $bits = explode('/', $base);
175 // should really be moved to Login...
177 if ($bits[0] == 'PasswordReset') {
178 $this->linkFail = $this->resetPassword(@$bits[1],@$bits[2],@$bits[3]);
179 header('Content-type: text/html; charset=utf-8');
183 $au = $this->getAuthUser();
185 $ff= HTML_FlexyFramework::get();
187 if (!empty($ff->Pman['auth_comptype']) && $au->id > 0 &&
188 ( !$au->company_id || ($ff->Pman['auth_comptype'] != $au->company()->comptype))) {
192 $this->jerr("Login not permited to outside companies - please reload");
194 $this->addEvent("RELOAD");
199 $this->jerror("BADURL","invalid url: $base");
202 if (isset($_GET['onloadTrack'])) {
203 $this->onloadTrack = (int)$_GET['onloadTrack'];
205 // getting this to work with xhtml is a nightmare
206 // = nbsp / <img> issues screw everyting up.
207 //var_dump($this->isDev);
208 // force regeneration on load for development enviroments..
210 HTML_FlexyFramework::get()->generateDataobjectsCache($this->isDev && !empty($_REQUEST['isDev']));
212 //header('Content-type: application/xhtml+xml; charset=utf-8');
216 if ($this->company && $this->company->logo_id) {
217 $im = DB_DataObject::Factory('Images');
218 $im->get($this->company->logo_id);
219 $this->appLogo = $this->baseURL . '/Images/Thumb/x100/'. $this->company->logo_id .'/' . $im->filename;
222 header('Content-type: text/html; charset=utf-8');
225 function post($base) {
226 return $this->get($base);
230 // --------------- AUTHENTICATION or system information
233 * finds the compay with comptype=='OWNER'
234 * ?? what about comptype_id-name ?????
236 * @return {Pman_Core_DataObjects_Companies} the owner company
238 function loadOwnerCompany()
240 // only applies if authtable is person..
241 $ff = HTML_FlexyFramework::get();
242 if (!empty($ff->Pman['authTable']) && !in_array($ff->Pman['authTable'] , [ 'core_person', 'Person' ])) {
246 $this->company = DB_DataObject::Factory('core_company');
247 if (!is_a($this->company, 'DB_DataObject')) { // non-core pman projects
250 $this->company->get('comptype', 'OWNER');
251 return $this->company;
257 * getAuthUser: - get the authenticated user..
259 * @return {DB_DataObject} of type Pman[authTable] if authenticated.
262 function getAuthUser()
264 if (!empty($this->authUser)) {
265 return $this->authUser;
267 $ff = HTML_FlexyFramework::get();
268 $tbl = empty($ff->Pman['authTable']) ? 'core_person' : $ff->Pman['authTable'];
270 $u = DB_DataObject::factory( $tbl );
272 if (is_a($u,'PEAR_Error') || !$u->isAuth()) {
275 $this->authUser =$u->getAuthUser();
276 return $this->authUser ;
280 * wrapper arround authuser->hasPerm
281 * @see Pman_Core_DataObject_Core_person::hasPerm
283 * @param {String} $name The permission name (eg. Projects.List)
284 * @param {String} $lvl eg. (C)reate (E)dit (D)elete ... etc.
287 function hasPerm($name, $lvl) // do we have a permission
289 static $pcache = array();
290 $au = $this->getAuthUser();
291 return $au && $au->hasPerm($name,$lvl);
296 * modulesList: List the modules in the application
298 * @return {Array} list of modules
300 function modulesList()
302 $boot = HTML_FlexyFramework::get();
303 // echo'<PRE>';print_R($boot);exit;
306 $mods = explode(',', $boot->enable);
307 if (in_array('Core',$mods)) { // core has to be the first modules loaded as it contains Pman.js
308 array_unshift($mods, 'Core');
311 if (in_array($boot->appNameShort,$mods)) { // Project has to be the last modules loaded as it contains Pman.js
312 unset($mods[array_search($boot->appNameShort, $mods)]);
313 $mods[] = $boot->appNameShort;
316 $mods = array_unique($mods);
318 $disabled = explode(',', $boot->disable ? $boot->disable : '');
320 foreach($mods as $mod) {
321 // add the css file..
322 if (in_array($mod, $disabled)) {
333 function hasModule($name)
336 if (!strpos( $name,'.') ) {
337 // use enable / disable..
338 return in_array($name, $this->modules());
341 $x = DB_DataObject::factory('core_group_right');
342 $ar = $x->defaultPermData();
343 if (empty($ar[$name]) || empty($ar[$name][0])) {
358 * ---------------- Global Tools ---------------
360 function checkFileUploadError() // check for file upload errors.
363 empty($_FILES['File'])
364 || empty($_FILES['File']['name'])
365 || empty($_FILES['File']['tmp_name'])
366 || empty($_FILES['File']['type'])
367 || !empty($_FILES['File']['error'])
368 || empty($_FILES['File']['size'])
370 $this->jerr("File upload error: <PRE>" . print_r($_FILES,true) . print_r($_POST,true) . "</PRE>");
376 * generate a tempory file with an extension (dont forget to delete it)
379 function tempName($ext)
381 $x = tempnam(ini_get('session.save_path'), HTML_FlexyFramework::get()->appNameShort.'TMP');
383 return $x .'.'. $ext;
388 * ------------- Authentication password reset ------ ??? MOVEME?
394 function resetPassword($id,$t, $key)
397 $au = $this->getAuthUser();
399 return "Already Logged in - no need to use Password Reset";
402 $u = DB_DataObject::factory('core_person');
403 //$u->company_id = $this->company->id;
405 if (!$u->get($id) || !strlen($u->passwd)) {
410 if ($key != $u->genPassKey($t)) {
411 return "invalid key";
414 $u->no_reset_sent = 0;
417 if ($t < strtotime("NOW - 1 DAY")) {
420 $this->showNewPass = implode("/", array($id,$t,$key));
425 * jerrAuth: standard auth failure - with data that let's the UI know..
429 $au = $this->authUser();
431 // is it an authfailure?
432 $this->jerr("Permission denied to view this resource", array('authFailure' => true));
434 $this->jerr("Not authenticated", array('authFailure' => true));
440 * ---------------- Standard JSON outputers. - used everywhere
443 * ---------------- Standard JSON outputers. - used everywhere
444 * JSON error - simple error with logging.
448 function jerr($str, $errors=array(), $content_type = false) // standard error reporting..
450 return $this->jerror('ERROR', $str,$errors,$content_type);
453 * Recomended JSON error indicator
456 * @param string $type - normally 'ERROR' - you can use this to track error types.
457 * @param string $message - error message displayed to user.
458 * @param array $errors - optioanl data to pass to front end.
459 * @param string $content_type - use text/plain to return plan text - ?? not sure why...
463 function jerror($type, $str, $errors=array(), $content_type = false) // standard error reporting..
465 if ($this->transObj) {
466 $this->transObj->query('ROLLBACK');
469 if ($type !== false) {
472 DB_DataObject::factory('Events')->writeEventLogExtra($errors);
475 $this->addEvent($type, false, $str);
479 $cli = HTML_FlexyFramework::get()->cli;
481 echo "ERROR: " .$str . "\n";
482 exit(1); // cli --- exit code to stop shell execution if necessary.
486 if ($content_type == 'text/plain') {
487 header('Content-Disposition: attachment; filename="error.txt"');
488 header('Content-type: '. $content_type);
489 echo "ERROR: " .$str . "\n";
495 require_once 'Services/JSON.php';
496 $json = new Services_JSON();
500 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
501 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
504 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
508 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
513 header('Content-type: text/html');
514 echo "<HTML><HEAD></HEAD><BODY>";
515 echo $json->encodeUnsafe(array(
518 'message' => $str, // compate with exeption / loadexception.
520 'errors' => $errors ? $errors : true, // used by forms to flag errors.
521 'authFailure' => !empty($errors['authFailure']),
523 echo "</BODY></HTML>";
527 if (isset($_REQUEST['_debug'])) {
528 echo '<PRE>'.htmlspecialchars(print_r(array(
532 'message' => $str, // compate with exeption / loadexception.
533 'errors' => $errors ? $errors : true, // used by forms to flag errors.
534 'authFailure' => !empty($errors['authFailure']),
540 echo $json->encode(array(
544 'message' => $str, // compate with exeption / loadexception.
545 'errors' => $errors ? $errors : true, // used by forms to flag errors.
546 'authFailure' => !empty($errors['authFailure']),
555 if ($this->transObj ) {
556 $this->transObj->query( connection_aborted() ? 'ROLLBACK' : 'COMMIT');
559 $cli = HTML_FlexyFramework::get()->cli;
561 echo "OK: " .$str . "\n";
564 require_once 'Services/JSON.php';
565 $json = new Services_JSON();
567 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
568 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
571 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
575 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
579 header('Content-type: text/html');
580 echo "<HTML><HEAD></HEAD><BODY>";
581 // encode html characters so they can be read..
582 echo str_replace(array('<','>'), array('\u003c','\u003e'),
583 $json->encodeUnsafe(array('success'=> true, 'data' => $str)));
584 echo "</BODY></HTML>";
589 echo $json->encode(array('success'=> true, 'data' => $str));
595 * output data for grids or tree
596 * @ar {Array} ar Array of data
597 * @total {Number|false} total number of records (or false to return count(ar)
598 * @extra {Array} extra key value list of data to pass as extra data.
601 function jdata($ar,$total=false, $extra=array(), $cachekey = false)
603 // should do mobile checking???
604 if ($total == false) {
607 $extra= $extra ? $extra : array();
608 require_once 'Services/JSON.php';
609 $json = new Services_JSON();
611 $retHTML = isset($_SERVER['CONTENT_TYPE']) &&
612 preg_match('#multipart/form-data#i', $_SERVER['CONTENT_TYPE']);
615 if (isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] == 'NO') {
619 $retHTML = isset($_REQUEST['returnHTML']) && $_REQUEST['returnHTML'] !='NO';
624 header('Content-type: text/html');
625 echo "<HTML><HEAD></HEAD><BODY>";
626 // encode html characters so they can be read..
627 echo str_replace(array('<','>'), array('\u003c','\u003e'),
628 $json->encodeUnsafe(array('success' => true, 'total'=> $total, 'data' => $ar) + $extra));
629 echo "</BODY></HTML>";
634 // see if trimming will help...
635 if (!empty($_REQUEST['_pman_short'])) {
638 foreach($ar as $as) {
640 foreach($as as $k=>$v) {
641 if (is_string($v) && !strlen(trim($v))) {
653 $ret = $json->encode(array('success' => true, 'total'=> $total, 'data' => $ar) + $extra);
655 if (!empty($cachekey)) {
657 $fn = ini_get('session.save_path') . '/json-cache'.date('/Y/m/d').'.'. $cachekey . '.cache.json';
658 if (!file_exists(dirname($fn))) {
659 mkdir(dirname($fn), 0777,true);
661 file_put_contents($fn, $ret);
669 /** a daily cache **/
670 function jdataCache($cachekey)
672 $fn = ini_get('session.save_path') . '/json-cache'.date('/Y/m/d').'.'. $cachekey . '.cache.json';
673 if (file_exists($fn)) {
674 header('Content-type: application/json');
675 echo file_get_contents($fn);
685 * ---------------- OUTPUT
687 function hasBg($fn) // used on front page to check if logos exist..
689 return file_exists($this->rootDir.'/Pman/'.$this->appNameShort.'/templates/images/'. $fn);
692 * outputJavascriptIncludes:
694 * output <script....> for all the modules in the applcaiton
697 function outputJavascriptIncludes()
699 // BC support - currently 1 project still relies on this.. (MO portal)
700 $o = HTML_FlexyFramework::get()->Pman_Core;
701 if (isset($o['packseed'])) {
702 return $this->outputJavascriptIncludesBC();
706 $mods = $this->modulesList();
708 $is_bootstrap = in_array('BAdmin', $mods);
710 foreach($mods as $mod) {
711 // add the css file..
714 if (!file_exists($this->rootDir."/Pman/$mod/is_bootstrap")) {
715 echo '<!-- missing '. $this->rootDir."/Pman/$mod/is_bootstrap - skipping -->";
721 $this->outputJavascriptDir("Pman/$mod/widgets", "*.js");
722 $this->outputJavascriptDir("Pman/$mod", "*.js");
726 if (empty($this->disable_jstemplate)) {
727 // and finally the JsTemplate...
728 echo '<script type="text/javascript" src="'. $this->baseURL. '/Core/JsTemplate"></script>'."\n";
736 * output <link rel=stylesheet......> for all the modules in the applcaiton
739 * This could css minify as well.
741 function outputCSSIncludes() // includes on CSS links.
744 $mods = $this->modulesList();
746 foreach($mods as $mod) {
747 // add the css file..
748 $this->outputCSSDir("Pman/$mod","*.css");
751 $this->callModules('outputCSSIncludes', false);
770 // --- OLD CODE - in for BC on MO project.... - needs removing...
772 // used on old versions.....
773 function outputJavascriptIncludesBC()
776 $mods = $this->modulesList();
778 foreach($mods as $mod) {
779 // add the css file..
782 $files = $this->moduleJavascriptList($mod.'/widgets');
783 foreach($files as $f) {
784 echo '<script type="text/javascript" src="'. $f. '"></script>'."\n";
787 $files = $this->moduleJavascriptList($mod);
788 foreach($files as $f) {
789 echo '<script type="text/javascript" src="'. $f. '"></script>'."\n";
793 if (empty($this->disable_jstemplate)) {
794 // and finally the JsTemplate...
795 echo '<script type="text/javascript" src="'. $this->baseURL. '/Core/JsTemplate"></script>'."\n";
800 * Gather infor for javascript files..
802 * @param {String} $mod the module to get info about.
803 * @return {StdClass} details about module.
805 function moduleJavascriptFilesInfo($mod)
808 static $cache = array();
810 if (isset($cache[$mod])) {
815 $ff = HTML_FlexyFramework::get();
817 $base = dirname($_SERVER['SCRIPT_FILENAME']);
818 $dir = $this->rootDir.'/Pman/'. $mod;
819 $path = $this->rootURL ."/Pman/$mod/";
821 $ar = glob($dir . '/*.js');
827 foreach($ar as $fn) {
829 // got the 'module file..'
830 $mtime = filemtime($dir . '/'. $f);
831 $maxtime = max($mtime, $maxtime);
832 $arfiles[$fn] = $mtime;
833 $files[] = $path . $f . '?ts='.$mtime;
836 ksort($arfiles); // just sort by name so it's consistant for serialize..
838 $compile = empty($ff->Pman['public_cache_dir']) ? 0 : 1;
839 $basedir = $compile ? $ff->Pman['public_cache_dir'] : false;
840 $baseurl = $compile ? $ff->Pman['public_cache_url'] : false;
845 $lsort = create_function('$a,$b','return strlen($a) > strlen($b) ? 1 : -1;');
846 usort($files, $lsort);
848 $smod = str_replace('/','.',$mod);
850 $output = date('Y-m-d-H-i-s-', $maxtime). $smod .'-'.md5(serialize($arfiles)) .'.js';
853 // why are translations done like this - we just build them on the fly frmo the database..
854 $tmtime = file_exists($this->rootDir.'/_translations_/'. $smod.'.js')
855 ? filemtime($this->rootDir.'/_translations_/'. $smod.'.js') : 0;
857 $cache[$mod] = (object) array(
858 'smod' => $smod, // module name without '/'
859 'files' => $files, // list of all files.
860 'filesmtime' => $arfiles, // map of mtime=>file
861 'maxtime' => $maxtime, // max mtime
862 'compile' => $this->isDev ? false : $compile,
863 'translation_file' => $base .'/_translations_/' . $smod . '.js',
864 'translation_mtime' => $tmtime,
866 'translation_data' => preg_replace('/\.js$/', '.__translation__.js', $output),
867 'translation_base' => $dir .'/', //prefix of filename (without moudle name))
868 'basedir' => $basedir,
869 'baseurl' => $baseurl,
870 'module_dir' => $dir,
877 * moduleJavascriptList: list the javascript files in a module
879 * The original version of this.. still needs more thought...
881 * Compiled is in Pman/_compiled_/{$mod}/{LATEST...}.js
882 * Translations are in Pman/_translations_/{$mod}.js
884 * if that stuff does not exist just list files in Pman/{$mod}/*.js
886 * Compiled could be done on the fly..
890 * @param {String} $mod the module to look at - eg. Pman/{$mod}/*.js
891 * @return {Array} list of include paths (either compiled or raw)
897 function moduleJavascriptList($mod)
901 $dir = $this->rootDir.'/Pman/'. $mod;
904 if (!file_exists($dir)) {
905 echo '<!-- missing directory '. htmlspecialchars($dir) .' -->';
909 $info = $this->moduleJavascriptFilesInfo($mod);
913 if (empty($info->files)) {
916 // finally sort the files, so they are in the right order..
918 // only compile this stuff if public_cache is set..
922 // public_cache_dir = /var/www/myproject_cache
923 // public_cache_url = /myproject_cache (with Alias apache /myproject_cache/ /var/www/myproject_cache/)
926 if (!$info->compile) {
927 echo "<!-- Javascript compile turned off (isDev on, or public_cache_dir not set) -->\n";
931 // where are we going to write all of this..
932 // This has to be done via a
933 if (!file_exists($info->basedir.'/'.$info->output) || !filesize($info->basedir.'/'.$info->output)) {
934 require_once 'Pman/Core/JsCompile.php';
935 $x = new Pman_Core_JsCompile();
937 $x->pack($info->filesmtime,$info->basedir.'/'.$info->output, $info->translation_base);
939 echo "<!-- file exists not exist: {$info->basedir}/{$info->output} -->\n";
942 if (file_exists($info->basedir.'/'.$info->output) &&
943 filesize($info->basedir.'/'.$info->output)) {
946 $info->baseurl.'/'. $info->output,
949 // output all the ava
950 // fixme - this needs the max datetime for the translation file..
951 $ret[] = $this->baseURL."/Admin/InterfaceTranslations/".$mod.".js"; //?ts=".$info->translation_mtime;
953 //if ($info->translation_mtime) {
954 // $ret[] = $this->rootURL."/_translations_/". $info->smod.".js?ts=".$info->translation_mtime;
961 // give up and output original files...
971 * PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
973 function initErrorHandling()
975 if (!class_exists('HTML_FlexyFramework2')) {
976 // what about older code that still users PEAR?
977 PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
979 set_exception_handler(array($this,'onException'));
984 static $permitError = false; // static why?
986 var $showErrorToUser = true;
988 function onPearError($err)
990 return $this->onException($err);
995 function onException($ex)
997 static $reported = false;
1002 if (Pman::$permitError) {
1009 $out = is_a($ex,'Exception') || is_a($ex, 'Error') ? $ex->getMessage() : $ex->toString();
1012 //print_R($bt); exit;
1015 $bt = is_a($ex,'Exception')|| is_a($ex, 'Error') ? $ex->getTrace() : $ex->backtrace;
1016 if (is_a($ex,'Exception')|| is_a($ex, 'Error') ) {
1017 $ret[] = $ex->getFile() . '('. $ex->getLine() . ')';
1019 foreach( $bt as $b) {
1020 $ret[] = @$b['file'] . '(' . @$b['line'] . ')@' . @$b['class'] . '::' . @$b['function'];
1026 //convert the huge backtrace into something that is readable..
1027 $out .= "\n" . implode("\n", $ret);
1029 $this->addEvent("EXCEPTION", false, $out);
1031 if ($this->showErrorToUser) {
1034 // not sure why this is here... - perhaps doing a jerr() was actually caught by the UI, and hidden from the user..?
1035 $this->jerror(false,"An error Occured, please contact the website owner");
1037 //$this->jerr($out);
1044 * ---------------- Logging ---------------
1049 * Log an action (only if it has not been logged already.
1051 * @param {String} action - group/name of event
1052 * @param {DataObject|false} obj - dataobject action occured on.
1053 * @param {String} any remarks
1054 * @return {false|DB_DataObject} Event object.,
1057 function addEventOnce($act, $obj = false, $remarks = '')
1059 if (!empty(HTML_FlexyFramework::get()->Pman['disable_events'])) {
1062 $e = DB_DataObject::factory('Events');
1063 $e->init($act,$obj,$remarks);
1064 if ($e->find(true)) {
1067 return $this->addEvent($act, $obj, $remarks);
1073 * @param {String} action - group/name of event
1074 * @param {DataObject|false} obj - dataobject action occured on.
1075 * @param {String} any remarks
1076 * @return {DB_DataObject} Event object.,
1079 function addEvent($act, $obj = false, $remarks = '')
1082 if (!empty(HTML_FlexyFramework::get()->Pman['disable_events'])) {
1085 $au = $this->getAuthUser();
1087 $e = DB_DataObject::factory('Events');
1088 $e->init($act,$obj,$remarks);
1090 $e->event_when = $e->sqlValue('NOW()');
1092 $eid = $e->insert();
1094 // fixme - this should be in onInsert..
1095 $wa = DB_DataObject::factory('core_watch');
1096 if (method_exists($wa,'notifyEvent')) {
1097 $wa->notifyEvent($e); // trigger any actions..
1101 $e->onInsert(isset($_REQUEST) ? $_REQUEST : array() , $this);
1108 function addEventNotifyOnly($act, $obj = false, $remarks = '')
1110 $au = $this->getAuthUser();
1112 $e = DB_DataObject::factory('Events');
1113 $e->init($act,$obj,$remarks);
1115 $e->event_when = $e->sqlValue('NOW()');
1116 $wa = DB_DataObject::factory('core_watch');
1117 if (method_exists($wa,'notifyEvent')) {
1118 $wa->notifyEvent($e); // trigger any actions..
1123 // ------------------ DEPERCIATED ----------------------------
1125 // DEPRECITAED - use moduleslist
1126 function modules() { return $this->modulesList(); }
1128 // DEPRECIATED.. - use getAuthUser...
1129 function staticGetAuthUser() { $x = new Pman(); return $x->getAuthUser(); }
1132 // DEPRICATED USE Pman_Core_Mailer
1134 function emailTemplate($templateFile, $args)
1137 require_once 'Pman/Core/Mailer.php';
1138 $r = new Pman_Core_Mailer(array(
1139 'template'=>$templateFile,
1140 'contents' => $args,
1143 return $r->toData();
1146 // DEPRICATED - USE Pman_Core_Mailer
1147 // WHAT Part about DEPRICATED Does no one understand??
1148 function sendTemplate($templateFile, $args)
1150 require_once 'Pman/Core/Mailer.php';
1151 $r = new Pman_Core_Mailer(array(
1152 'template'=>$templateFile,
1153 'contents' => array(),