JSystem.class.php

Go to the documentation of this file.

<?php
include_once("core/system/JBaseObject.class.php");
include_once("core/system/JContext.class.php");
include_once("core/system/JUgrSystem.class.php");
include_once("core/system/JErrorHandler.class.php");
include_once("core/config/JConfig.class.php");

define("CURRENT_USER", "jsystem-current-user");
define("CURRENT_GROUP", "jsystem-current-group");
define("CURRENT_MODULE", "jsystem-current-module");
define(JUGRSYSTEM, "james-jugrsystem");


class JSystem extends JBaseObject
{
        function JSystem()
        {
                JSession::CleanAll();
                
                $context =& JContext::GetInstance();            
                $context->SetLogged(false);
        }
        function Login($login, $pass)
        {
                include_once("core/auth/JAuth.class.php");
                
                $auth =& JAuth::GetAuthSystem();

                // If the authentication is ok
                if ($auth->Authenticate($login, $pass))
                {
                        $ugrsystem =& JUgrSystem::GetInstance();
                        $context =& JContext::GetInstance();
                        
                        // We get the user and cache it in session.
                        $user = $ugrsystem->GetUser($login, true, true);
                        
                        // Now we set the initial context.
                        $context->SetLogged(true);
                        $context->SetActiveUserId($user->GetId());
                        $context->SetAnonymous(false);
                        
                        // We set the current group and role as the global 
                        // ones by default
                        $gr =& $user->GetGlobalRole();
                        $context->SetActiveGroupId(GLOBAL_GROUP);
                        $context->SetActiveRoleId($gr->GetId());
                        
                        // And return true, because all was ok
                        return true;
                }
                else
                        return false;           
        }
        
        function AnonLogin()
        {
                // If the system is not configured to allow anonymous access,
                // we'll return false and do nothing.
                if (!JSystem::GetConfig("AnonAccess"))
                        return false;
                else
                {
                        $ugrsystem =& JUgrSystem::GetInstance();
                        $context =& JContext::GetInstance();
                        
                        // We get the anonymous user's id.
                        $anonid = JSystem::GetConfig("IdAnonUser"); 
                        
                        // We get the user and cache it in session.
                        $user = $ugrsystem->GetUser($anonid, true, true);
                        
                        // Now we set the initial context.
                        $context->SetLogged(true);
                        $context->SetActiveUserId($anonid);
                        $context->SetAnonymous(true);
                        
                        // We set the current group and role as the global 
                        // ones by default
                        $gr =& $user->GetGlobalRole();
                        $context->SetActiveGroupId(GLOBAL_GROUP);
                        $context->SetActiveRoleId($gr->GetId());
                                
                        // And return true, because everything was ok
                        return true;
                }
        }
        
        function IsLogged()
        {               
                $context =& JContext::GetInstance();
                return $context->IsLogged();
        }               
        
        function IsAnonymous()
        {               
                $context =& JContext::GetInstance();
                return $context->IsAnonymous();
        }               
        
        function Logout()
        {
                // We just set the context as non-logged.
                $context =& JContext::GetInstance();
                
                // Unload all modules
                while ($context->GetActiveModuleId() != NULL)
                        JSystem::UnloadModule();
                        
                $context->SetLogged(false);
                
                // Finally, we clear the session
                JSession::CleanAll();
        }
        
        function LoadModuleGroup($group, $module, $idRMG)
        {
                $result = false;
                
                // Get the context...
                $context =& JContext::GetInstance();
                $ugrsystem =& JUgrSystem::GetInstance();
                
                // The current user, group and role...
                $user =& $ugrsystem->GetUser($context->GetActiveUserId());
                $grobj =& $ugrsystem->GetGroup($group);
                // The group does not exist
                if (JSystem::IsError($grobj))
                        return false;
                $role =& $user->GetRole($group);
                // The role does not exist
                if (JSystem::IsError($role))
                        return false;
                
                // Then, we check if the user can load this module
                $modules =& $grobj->GetModules();               
                if ($modules[$idRMG]->GetId() == $module)
                        if (! $role->HasPermission("hidden", $module))
                        {
                                $result = true;
                                
                                // Set the context properly
                                $context->SetActiveGroupId($group);
                                $context->SetActiveRoleId($role->GetId());
                                
                                // And load the module
                                JSystem::LoadModule($module, $idRMG);                           
                        }
                        
                return $result;
        }
        
        function LoadModuleGlobalGroup($module, $idRMG)
        {
                $result = false;
                
                // Get the context...
                $context =& JContext::GetInstance();
                $ugrsystem =& JUgrSystem::GetInstance();
                
                // The current user, group and role...
                $user =& $ugrsystem->GetUser($context->GetActiveUserId());
                $grobj =& $user->GetGlobalGroup();
                // If the group does not exist
                if (JSystem::IsError($grobj))
                        return false;
                $role =& $user->GetGlobalRole();
                // If the role does not exist 
                if (JSystem::IsError($role))
                        return false;
                
                // Then, we check if the user can load this module
                $modules =& $grobj->GetModules();               
                if ($modules[$idRMG]->GetId() == $module)
                        if (! $role->HasPermission("hidden", $module))
                        {
                                $result = true;
                                
                                // Set the context properly
                                $context->SetActiveGroupId(GLOBAL_GROUP);
                                $context->SetActiveRoleId($role->GetId());
                                
                                // And load the module
                                JSystem::LoadModule($module, $idRMG);                           
                        }
                        
                return $result;
        }
        
        function LoadModule($module, $idRMG=0)
        {
                include_once("core/comms/ThrowEvent.inc.php");
                
                $context =& JContext::GetInstance();
                
                $context->PushActiveModule($module, $idRMG);
                
                // Throws the load event to the module that is being loaded.
                ThrowEvent("load", $module, $context->GetActiveGroupId());
        }                               
                
        
        function UnloadModule()
        {
                include_once("core/comms/ThrowEvent.inc.php");
                
                $context =& JContext::GetInstance();
                
                if ($context->GetActiveModuleId() != NULL)
                {
                        $idM = $context->PopActiveModule();
                        ThrowEvent("unload", $idM, $context->GetActiveGroupId());
                }
        }
        
        function &InitModule($name)
        {
                if (!JSystem::IsLogged())
                        return JSystem::RaiseError(new JSystemError(ERROR_SESSION_EXPIRED));
                        
                $current =& JSystem::GetCurrentModule();
                $modules =& Modules::GetInstance();
                $init =& $modules->GetModule($name);
                
                if (JSystem::IsError($init))
                        return JSystem::RaiseError(JSystem::GetLastError());

                if ($init->GetId() != $current->GetId())
                        JSystem::LoadModule($init->GetId());
                        
                // Set the global variables:
                $context =& JContext::GetInstance();
                $ugrsystem =& JUgrSystem::GetInstance();
                
                $GLOBALS[CURRENT_USER] =& $ugrsystem->GetUser($context->GetActiveUserId());
                if (!$context->IsGlobalGroup())
                        $GLOBALS[CURRENT_GROUP] =& $ugrsystem->GetGroup($context->GetActiveGroupId());
                else
                        $GLOBALS[CURRENT_GROUP] = GLOBAL_GROUP;
                $GLOBALS[CURRENT_MODULE] =& $init;
                $GLOBALS[JUGRSYSTEM] =& $ugrsystem;             
                        
                return $init;
        }
        
        function &GetCurrentUser()
        {
                $context =& JContext::GetInstance();
                $ugrsystem =& JUgrSystem::GetInstance();
                
                return $ugrsystem->GetUser($context->GetActiveUserId());
        }
        
        function &GetCurrentGroup()
        {
                $context =& JContext::GetInstance();
                $ugrsystem =& JUgrSystem::GetInstance();
                
                if (!$context->IsGlobalGroup())
                {
                        return $ugrsystem->GetGroup($context->GetActiveGroupId());
                }
                else
                        return GLOBAL_GROUP;
        }
        
        function IsGlobalGroup()
        {
                $context =& JContext::GetInstance();            
                return $context->IsGlobalGroup();
        }
        
        function &GetCurrentModule()
        {
                include_once("core/modules/Modules.class.php");
                
                $context =& JContext::GetInstance();
                $modules =& Modules::GetInstance();
                
                return $modules->GetModule($context->GetActiveModuleId());
        }
        
        
        function GetConfig($key)
        {
                include(CONFIG_PATH . CORE_CONFIG_FILE);
                if (!isset($config[$key]))
                {
                        $jconfig = JConfig::GetInstance(CONFIG_SYSTEM_SCOPE);
                        $val = $jconfig->GetValue($key);
                }
                else
                        $val = $config[$key];
        
                return $val;
        }
        
        function SetConfig($keys, $user=true, $group=false)
        {
                $config =& JConfig::GetInstance(CONFIG_SYSTEM_SCOPE);
                $config->SetValue($keys, $user, $group);                
        }

        
        function IsError($error)
        {
                return JErrorHandler::IsError($error);
        }
        
        function GetLastError()
        {
                $ehandler =& JErrorHandler::GetInstance();
                return $ehandler->PopError();
        }               
}
?>

---