Merge branch 'Issue_#16,_Module_name_integration' into 'master'

Issue #16, module name integration

Fixes FuzeWorks/Core/#16

See merge request !5

Application/Config/config.main.php

@@ -2,6 +2,7 @@
   'SITE_URL' => '',
   'SITE_DOMAIN' => '',
   'SERVER_NAME' => '',
+  'registers_update_interval' => 3600,
   'administrator_mail' => '',
   'default_controller' => 'standard',
   'default_function' => 'index',

Core/Mods/sections/class.sections.php

@@ -111,6 +111,8 @@ class Sections extends Module {
 
 			// And finally set the controller, if no parameters are set, load the default function
 			$controller = (!empty($event->function) ? $event->function : $this->config->main->default_controller );
+		} else {
+			$this->logger->log("No section was found with name: '".$name."'", 'Sections');
 		}
 
         if($controller !== null)$event->controller  = $controller;

Core/System/class.abstract.module.php

@@ -17,6 +17,11 @@ class Module extends Bus {
 	 */
 	protected $moduleName = 'placeholder';
 
+	/**
+	 * @var String name used in the mod array 
+	 */
+	protected $linkName = 'placeholder';
+
 	/**
 	 * Constructor
 	 *
@@ -59,4 +64,22 @@ class Module extends Bus {
         if($this->modulePath === null)
             $this->modulePath = $modulePath;
     }
+
+    /**
+     * Set the link name of the module. The link name is the address in the module array so that the module can self reference.
+     * @access public
+     * @param String link name
+     */
+    public function setModuleLinkName($linkName) {
+    	$this->linkName = $linkName;
+    }
+
+    /** 
+     * The name that is required to load itself, eg 'exampleauthor/examplemodulename' or 'techfuze/cms'
+     * @access public
+     * @param String module name
+     */
+    public function setModuleName($modName) {
+    	$this->moduleName = $modName;
+    }
 }

Core/System/class.core.php

@@ -11,6 +11,7 @@ class Core {
 
 	public $mods;
 	private $loaded = false;
+	private $register;
 
 	## START/STOP
 	public function init() {
@@ -23,6 +24,12 @@ class Core {
 		$this->loadStartupFiles();
 
 		$this->mods->events->fireEvent('coreStartEvent');
+		// Mod register exists, check if expired
+		if ( ( date('U') - $this->mods->config->main->registers_last_update) > $this->mods->config->main->registers_update_interval) {
+			$this->mods->logger->log("Registers have expired. Updating...", 'Core');
+			$this->buildModRegister();
+			$this->mods->events->buildEventRegister();
+		}
 	}
 
 	public function loadStartupFiles() {
@@ -57,65 +64,141 @@ class Core {
 	}
 
 	## MODLOADING
-	public function loadMod($name) {
+	public function loadMod($name, $version = null) {
-		// Class name
-		$class_name = ucfirst($name);
-		// Check if mod is already loaded
 		if (!isset($this->mods->$name)) {
-			// Check if class is already included
+			$CLASS = $this->loadModule($name);
+			$this->mods->{strtolower($CLASS[1])}  = &$CLASS[0];
+		}
+	}
 
-			// If the class is not loaded, load it
+	public function getMod($name, $version = null) {
-			if (!class_exists($class_name)) {
+		$CLASS = $this->loadModule($name);
+		return $CLASS[0];
+	}
 
-				// If the mod is in the top mod directory, load it directly
+	private function loadModule($name, $version = null) {
-				$file = FUZEPATH . "/Core/Mods/class.".$class_name.".php";
+		// Load the register if not loaded yet
-				if (file_exists($file)) {
+		if (!isset($this->mods->config->modregister->register)) {
-					$this->mods->logger->log("Loading module '".$class_name."'");
+			$this->buildModRegister();
-					$path = FUZEPATH . "/Core/Mods/class.".$class_name.".php";
+		} else {
-					require_once($file);
 
-				// If not, and a mod config file is found, follow that
+			$this->register = $this->mods->config->modregister->register;
-				} elseif ( file_exists(FUZEPATH . "/Core/Mods/".strtolower($name)."/moduleInfo.php" )) {
+		}
-					// Load the config file
-					$cfg = (object) require(FUZEPATH . "/Core/Mods/".strtolower($name)."/moduleInfo.php");
 
-					// Load the class name and file
+		// The basic module path
-					$class_file = FUZEPATH . "/Core/Mods/".strtolower($name)."/" . $cfg->module_file;
+		$path = FUZEPATH . "/Core/Mods/";
-					$class_name = $cfg->module_class;
 
-					// Load the dependencies first
+		// Chech if the requested module is set
-					$deps = (isset($cfg->dependencies) ? $cfg->dependencies : array());
+		if (isset($this->register[$name])) {
-					for ($i=0; $i < count($deps); $i++) { 
+			// Check if the config file is loaded
-						$this->loadMod($deps[$i]);
+			if (!empty($this->register[$name])) {
+				// Load the config file
+				$cfg = (object) $this->register[$name];
+
+				// Check if the module is enabled, otherwise abort
+				if (isset($cfg->enabled)) {
+					if (!$cfg->enabled) {
+						return false;
 					}
+				}
 
-					$path = FUZEPATH . "/Core/Mods/".strtolower($name)."/";
+				// Check if a specific version is requested
-					$this->mods->logger->log("Loading Module '".$cfg->name."' v".$cfg->version." made by '".$cfg->author."' : '".$cfg->website."'");
+				if (isset($version)) {
+					if (isset($cfg->versions)) {
+						if (isset($cfg->versions[$version])) {
+							$ncfg = (object) $cfg->versions[$version];
+							foreach ($ncfg as $key => $value) {
+								$cfg->$key = $value;
+							}
+						}
+					}
+				} 
 
-					require_once($class_file);
+				// Or load the main version
+				$file = $cfg->directory . $cfg->module_file;
 
-				// If no config file found, but a main class is, load that
+				// Load the dependencies before the module loads
-				} elseif ( file_exists(FUZEPATH . "/Core/Mods/".strtolower($name)."/class.".$class_name.".php") ){
+				$deps = (isset($cfg->dependencies) ? $cfg->dependencies : array());
-					$this->mods->logger->log("Loading module '".$class_name."'");
+				for ($i=0; $i < count($deps); $i++) { 
-					$path = FUZEPATH . "/Core/Mods/".strtolower($name)."/";
+					$this->loadMod($deps[$i]);
-					require_once(FUZEPATH . "/Core/Mods/".strtolower($name)."/class.".$class_name.".php");
+				}
 
-				// Otherwise Abort
+				// Check if the file exists
+				if (file_exists($file)) {
+					// And load it
+					require_once($file);
+					$class_name = $cfg->module_class;
+					$msg = "Loading Module '".ucfirst((isset($cfg->name) ? $cfg->name : $cfg->module_name)) . "'";
+					$msg .= (isset($cfg->version) ? " version:".$cfg->version : "");
+					$msg .= (isset($cfg->author) ? " made by ".$cfg->author : "");
+					$msg .= (isset($cfg->website) ? " from ".$cfg->website: "");
+					$this->mods->logger->log($msg);
 				} else {
-					// MOD NOT FOUND
+					// Throw Exception if the file does not exist
-					throw new Exception("Requested mod '".$name."' was not found", 1);
+					throw new Exception("Requested mod '".$name."' could not be loaded. Class file not found", 1);
 					return false;							
 				}
+			} else {
+				// Throw Exception if the module has an invalid config file
+				throw new Exception("Requested mod '".$name."' could not be loaded. Invalid config", 1);
+				return false;			
 			}
-
+		} else {
-			// Create class object
+			// Throw Exception if the module is not defined
-			$CLASS = new $class_name($this);
+			throw new Exception("Requested mod '".$name."' was not found", 1);
-			if (method_exists($CLASS, 'setModulePath')) {
+			return false;			
-				$CLASS->setModulePath($path);
-			}
-			$this->mods->{strtolower($name)}  = &$CLASS;
-			$CLASS->onLoad();
 		}
+
+		// Create class object
+		$CLASS = new $class_name($this);
+		if (method_exists($CLASS, 'setModulePath')) {
+			$CLASS->setModulePath($cfg->directory);
+		}
+		if (method_exists($CLASS, 'setModuleLinkName')) {
+			$CLASS->setModuleLinkName($cfg->module_name);
+		}
+		if (method_exists($CLASS, 'setModuleName')) {
+			$CLASS->setModuleName($name);
+		}
+		$CLASS->onLoad();
+		return array($CLASS, $cfg->module_name);
+	}
+
+	public function buildModRegister() {
+        $this->mods->logger->newLevel("Building Mod Register", 'Core');
+        $dir = FUZEPATH . "Core/Mods/";
+        $mods = array_values(array_diff(scandir($dir), array('..', '.')));
+        $register = array();
+        for ($i=0; $i < count($mods); $i++) { 
+        	$mod_dir = $dir . $mods[$i] . "/";
+        	if (file_exists($mod_dir . "/moduleInfo.php")) {
+        		$cfg = (object) require($mod_dir . "/moduleInfo.php");
+        		$name = "";
+        		$name .= (!empty($cfg->author) ? strtolower($cfg->author)."/" : "");
+        		$name .= strtolower($cfg->module_name);
+
+        		// Append directory
+        		$cfg->directory = $mod_dir;
+        		$register[$name] = (array) $cfg;
+        	} else {
+        		// Get the name
+        		$name = $mods[$i];
+
+        		// Build a dynamic module config
+        		$cfg = new stdClass();
+        		$cfg->module_class = ucfirst($name);
+        		$cfg->module_file = 'class.'.strtolower($name).".php";
+        		$cfg->module_name = $name;
+        		$cfg->dependencies = array();
+        		$cfg->versions = array();
+        		$cfg->directory = $mod_dir;
+        		$register[$name] = (array)$cfg;
+        	}
+        }
+
+        $this->mods->logger->stopLevel();
+        $this->mods->config->set('modregister', 'register', $register);
+        $this->mods->config->set('main', 'registers_last_update', date('U'));
 	}
 }
 

Core/System/class.events.php

@@ -156,9 +156,9 @@ class Events extends Bus{
     public function buildEventRegister() {
         $this->logger->newLevel("Building Event Register", 'Events');
         $dir = FUZEPATH . "/Core/Mods/";
-        $mods = array_values(array_diff(scandir($dir), array('..', '.')));
+        $mods = $this->config->modregister->register;
-        for ($i=0; $i < count($mods); $i++) { 
+        foreach ($mods as $key => $value) {
-            $this->core->loadMod($mods[$i]);
+            $this->core->loadMod($key);
         }
 
         $event = $this->fireEvent('eventRegisterBuildEvent', '');