Added support for UI libraries

Author: shannah

Dataface/Application.php

@@ -178,6 +178,114 @@ class Dataface_Application {
 
 	private $pageTitle = null;
 
+	/**
+	 * Array of UI libraries that have been loaded.
+	 */
+	private $uiLibraries = array();
+	public $UI_LIBRARY_PATH = XFAPPROOT.'uilibs' . PATH_SEPARATOR .XFROOT.'uilibs';
+	
+	/**
+	 * Gets the UI library search path - the paths where it will
+	 * search for UI libraries.
+	 * @return string Paths separated by path separator char.
+	 */
+	public function getUILibraryPath() {
+		return $this->UI_LIBRARY_PATH;
+	}
+
+	/**
+	 * Sets the search paths to look for UI libraries.
+	 * @param string $path  A path in format like PATH or LD_LIBRARY_PATH.  Paths separated by PATH_SEPARATOR.  (e.g. semicolon on windows, and colon on unix).
+	 */
+	public function setUILibraryPath($path) {
+		$this->UI_LIBRARY_PATH = $path;
+	}
+
+	/**
+	 * Appends path to the UI library search paths.
+	 * @param string $path The path to add.
+	 * @return void.
+	 */
+	public  function appendUILibraryPath($path) {
+		$this->UI_LIBRARY_PATH .= PATH_SEPARATOR . $path;
+	}
+
+	/**
+	 * Prepends path to the UI library search paths.
+	 * @param string $path The path to add.
+	 * @return void
+	 */
+	public  function prependUILibraryPath($path) {
+		$this->UI_LIBRARY_PATH = $path . PATH_SEPARATOR . $this->UI_LIBRARY_PATH;
+	}
+
+	/**
+	 * Gets the search paths that will be searched to load
+	 * UI libraries, as an array.
+	 * 
+	 * @return array Array of paths to directories to search for uilibs.
+	 */
+	public  function getUILibraryPaths() {
+		return explode(PATH_SEPARATOR, $this->UI_LIBRARY_PATH);
+	}
+
+	/**
+	 * Loads a UI library.  A UI library consists of a file
+	 * located at uilibs/$name/$name.uilib.html.  This file will 
+	 * be included in the head of the document, so it should
+	 * contain an HTML snippet that loads the necessary CSS and javascript
+	 * files for the UI library to work.
+	 * 
+	 * The $name.uilib.html file should use the {{LIBROOT}} placeholder
+	 * as the URL to the uilib's directory so that it knows how to reference
+	 * its CSS and Javascript files.
+	 * 
+	 * @param string $name The name of the UI library to load.
+	 * @return boolean True if the library was loaded.  False otherwise.
+	 */
+	public function loadUILibrary($name) {
+		if (!isset($this->uiLibraries[$name])) {
+			$this->uiLibraries[$name] = $name;
+			
+			
+			foreach ($this->getUILibraryPaths() as $p) {
+				
+				if (strpos($p, XFAPPROOT) === 0) {
+					$baseUrl = DATAFACE_SITE_URL;
+					$basePath = XFAPPROOT;
+				} else if (strpos($p, XFROOT) === 0) {
+					$baseUrl = DATAFACE_URL;
+					$basePath = XFROOT;
+				} else {
+					continue;
+				}
+				if (strlen($baseUrl) == 0) {
+					$baseUrl = '/';
+				}
+				if (substr($baseUrl, -1) != "/") {
+					$baseUrl .= '/';
+				}
+
+				$filePath = $p.DIRECTORY_SEPARATOR.$name.DIRECTORY_SEPARATOR.$name.'.uilib.html';
+				//echo "Filepath: $filePath;";
+				//echo "BaseUrl: $baseUrl;";
+				if (file_exists($filePath)) {
+
+					$fileUrl = $baseUrl .
+						substr($filePath, strlen($basePath));
+					$fileUrl = str_replace(DIRECTORY_SEPARATOR, '/', $fileUrl);
+					$libRoot = substr($fileUrl, 0, strrpos($fileUrl, '/'));
+					$content = file_get_contents($filePath);
+					$content = str_replace('{{LIBROOT}}', $libRoot, $content);
+					$this->addHeadContent($content);
+					return true;
+				}
+
+			}
+		}
+		return false;
+	}
+
 	/**
 	 * @private
 	 */
@@ -1125,6 +1233,10 @@ public static function &getInstance($conf=null){
 	}
 
 
+	/**
+	 * Adds javascript strings for use in javascript internationalization.
+	 * @param array(string=>string) $strings
+	 */
 	public function addJSStrings($strings){
 	    $jsStrings = json_encode($strings);
 	    $this->addHeadContent(<<<END
@@ -1874,7 +1986,6 @@ function addHeadContent($content){
 		$this->headContent[] = $content;
 	}
 
-
 	/**
 	 * @brief Returns the nav item info for a key.  This is a wrapper around the nav items defined
 	 * in the [_tables] section of the conf.ini file.

Dataface/Table.php

@@ -550,12 +550,12 @@ function __construct($tablename, $db=null, $quiet=false){
 
         if (strpos($this->tablename, '_tmp_') === 0) {
             // This is just a temporary table.
-            $iniPath = realpath(DATAFACE_SITE_PATH.'/tables/'.basename($this->tablename).'/fields.ini');
+            $iniPath = realpath($this->basePath().'/tables/'.basename($this->tablename).'/fields.ini');
 			if (!$iniPath) {
-				$iniPath = realpath(DATAFACE_SITE_PATH.'/tables/'.basename($this->tablename).'/fields.ini.php');
+				$iniPath = realpath($this->basePath().'/tables/'.basename($this->tablename).'/fields.ini.php');
 			}
-			$delegateClass = realpath(DATAFACE_SITE_PATH.'/tables/'.basename($this->tablename).'/'.basename($this->tablename).'.php');
-
+			$delegateClass = $this->_delegateFilePath();
+			
 			$sqlQuery = null;
 			//echo "ini path $iniPath ".$this->tablename;
             if (file_exists($iniPath)) {
@@ -567,13 +567,15 @@ function __construct($tablename, $db=null, $quiet=false){
             if (file_exists($delegateClass)) {
                 import($delegateClass);
                 $delClassName = 'tables_'.basename($this->tablename);
-
+				
                 if (!class_exists($delClassName)) {
                     throw new Exception("Delegate class ".$delegateClass." file exists but no class is defined in it");
                 }
 
-                $delObj = new $delClassName;
+				$delObj = new $delClassName;
+				$this->_delegate = $delObj;
                 if (method_exists($delObj, '__sql__')) {
+					
                     $sqlQuery = $delObj->__sql__();
                 }
             }

uilibs/semantic-ui/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Semantic Org
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

uilibs/semantic-ui/README.md

@@ -0,0 +1,7 @@
+# CSS  Distribution
+
+This repository is automatically synced with the main [Semantic UI](https://github.com/Semantic-Org/Semantic-UI) repository to provide lightweight CSS only version of Semantic UI.
+
+This package **does not support theming** and includes generated CSS files of the default theme only.
+
+You can view more on Semantic UI at [LearnSemantic.com](http://www.learnsemantic.com) and [Semantic-UI.com](http://www.semantic-ui.com)