/**
 * -----------------------------------------------------------------------------
 * @package     smartVisu
 * @author      Martin Gleiß
 * @copyright   2012 - 2015
 * @license     GPL [http://www.gnu.de]
 * ----------------------------------------------------------------------------- 
 */

DESCRIPTION
--------------------------------------------------------------------------------
smartVISU is a framework to create a visualisation for a knx-installation with
simple html-pages. To read and write group-telegrams special tags are used.
You don't need to know javascript.


SYSTEM REQUIREMENTS
--------------------------------------------------------------------------------
    -   KNX-Bus
    -   eibd
    -   linknx or smarthome.py
    -   Webserver with PHP 5.2.4 
    -   Firefox, Chrome, IE, Safari, iPhone, iPad, Android Phone or Android 
        Tablet
 
 
10 STEP GUIDE:
--------------------------------------------------------------------------------

    For your own Project do the following:
    
    1.  Create a new directory in "pages", for example "pages/visu" or 
        "pages/YOURPROJECT". This is your individual project-directory where you
		may work. Copy all files from "pages/_template" to your project-directory
    
    2.  Check the config.php and set the "config_pages" to "YOURPROJECT"
      
    3.  Set the "config_driver" to your backend-environment
        - linknx: for linxknx and eibd environment
		- smarthome.py for SmartHome.py environment
		- eibd for direct access
        - offline: only for testing, all GADs will be stored in a textfile 
          ("temp/offline_YOURPROJECT.var")
        
    4.  Create a new page in your project-directory, for example "mypage.html"
        Note: Do not use "base.html, basic.html, device.html", these are system
        pages
    
    5.  Fill the page with your preferred content and widgets
    
    6.  If you need to change the design, use a "visu.css" - stylesheet file in 
        your project-directory. 
		If you want to develop your own widgets, also place them in your directory.
		Name the javascript-file (if you need one) to "visu.js" and it will be
		included automatically. Name the file with the widgets e.g. "custom.html"
    
    7.  Test your page with:
        http://localhost/smartVISU/index.php?page=mypage
        Note: replace "localhost" with the hostname from your server      
   
    8.  Create all pages you need
     
    9.  At the end of your project set "config_cache" to "true" to speed up your
        smartVISU
        
   10.  Enjoy smartVISU!
        


HISTORY
--------------------------------------------------------------------------------
v 2.8
	- new widget: basic.multistate
	- new widget: plot.multiaxes
	- new widget: device.codepad
	- new widget: status.collapse
	- new widget: status.popup
	
v 2.7 03.11.13
	- new: SmartHome.py Montior page
	- new: animations on/off for better performance on slow devices
	- new model house: alber, as eibd-driver example by Raik Alber
	- new SmartHome.py Monitor
    - new widget: clock.iconclock
	- new widget: status.log
	- improved widget: plot.period now zoomable
	- moved widget: basic.image -> mulimedia.image
	- moved widget: basic.notify -> status.notify
	- new static-svg-icons colored white (ws), black (sw)
    - new svg-icons: icon.blade, icon.blade_arc, icon.blade_z by Mario Zanier
	- new svg-icon: icon.meter, icon.clock
	- improvments on svg-icons
	- deprecated: icons/bl, icons/or, icons/gn -> use .svg instead 
	  see index.php?page=design/design_icons for examples
	- update plot.highcharts 3.0.5
	
v 2.6 06.08.13
	- dynamic icons: svg-icons for continuous values
	- new: config splitted in lib/defaults.php and config.php (individual)
	- improved devive.rtr now with more modes depending on the driver
	- update vendor/plot.highcharts 3.0.2   	
	- update vendor/jquery 2.0.3 (IE 6, 7, 8 are no longer supported)
	- update vendor/jquery.mobile 1.3.2
	
v 2.5 01.06.13
    - new apps: tv-movie, tv-spielfilm
	- new: rss-feed-reader (lib/feeds)
    - new widget: multimedia.station for tv- and radio-stations 
    - new widget: multimedia.slideshow for image-based slideshows 
    - new widget: plot.temprose for all temperatures in a building
    - improved: phone drivers
	- improved: drivers now with datatypes: int, float, string, array
	- improved: basic.tank now with variable width
	- new .js files are now minified. Based on google closure
	- new model-house: fleischer by Marco Fleischer
    - new: animations :-) [beta]
	
v 2.4 26.04.13 Happy Birthday smartVISU!       
	- improved widget: basic.shutter, now with dynamic symbols
	- improved design: cube v2, best viewed with solar_winds.png background                                      	
	- project: visu.css and visu.js are included if they are in own project
	- new widget: plot.period for plotting graphs
	- new widget: plot.rtr for an rtr graph visualisation
	- new widget: plot.comfortchart for a graph showing humans well-feel-zone
	- new widget: basic.notify for notifications (info, warnings, errors)
	- new widget: basic.colordisc by Marcus Popp
	- improved design: shutter pics now .png with transparency
	- imporved widget: basic.rgb now with configurable colors
	- improved widgets for speed
	- improved drivers: only refresh if necessary
	- update vendor/jquery.mobile 1.3.1

v 2.3 04.03.13
	- device.rtr now with 3x bit-mode or 1x byte-mode
	- undeprecated: basic.glue: used to glue widgets together
    - new language: fr, special tanks to Pierre-Yves Kerviel
    - basic.symbol now with mode 'or', 'and'
	- new: smartVISU checks configuration of the server
	- new widget: basic.tank for (partly) filled tanks
	- new widget: basic.shifter for switch an value on one symbol
	- improved widget: basic.shutter now supports sending of the angle
    - re-engineered widget: basic.slider with super soft sliding
	- new driver: eibd (with ajax long-polling)
    - phone service: fritz!box v5.20 (international version)
	- new icons from mfd
	- docu improved
	- update vendor/jquery 1.9
	- update vendor/jquery.mobile 1.3
	- improved speed: gzip compressed output
	- improved speed: javascript separated
    
v 2.2 01.02.13
    - new driver: SmartHome.py (with websocket)
    - new driver: domotiga (with websocket)
    - improved error handling and notification
    - phone service: fritz!box v5.50. Special thanks to Stefan Vonbrunn
    - new design: greenhornet
    - new icons: gn (green)
    - new pages: meister (as model-home)
    - weather: yr.no now in en and de. Special thanks to Raik Alber
    - update: Twig, with continuous integration
    - new icons: They are named in english. thanks to mfd
    - improved driver: offline, linknx, json
    - new smart.alert js-function for alerts and logging
    - driver linknx: with error-handling
    
v 2.1 09.01.12
    - new pages: otterstaetter (as model-home)
    - widget: multimedia.music for a player
    - widget: appliance.iprouter for the enertex knxnet/ip-router
    - re-engineered widget: basic.slider 
    - re-engineered widget: basic.button 
    - widget: basic.rgb with color-selector
    - widget: basic.symbol allows more gads/items now
    - widget: basic.shutter may now be clicked to change the position
    - improved design: device.rtr
    - improved design: weather and clock for small devices  
    - changed design: header now fixed on mobile devices
    
v 2.0 14.12.12
    - realtime polling
    - updated driver: 'linknx' for polling
    - updated driver: 'offline' for polling
    - new widget: shutter (widgets/device.html)
    - widget: basic.button now supports different icons
    - docu for buttongroups
    - docu for popups
    - new <?php tags in all files
    
v 1.9 28.11.12
    - new widget-file: widgets/calendar.html for google calendar
      use the google-calendar private xml-adress in the config dialog
      with http: (not https:). In your event you may use:
        @icon        icons/ws/meld_muell.png
        @color       #222266
      as description to set the icon and color.
    - function.php: smartdate for dates relating on language
    - improved design of configuration
    - fixes in phonelist
    
v 1.8 02.11.12
    - new widget-file: widgets/phone.html for phonelists
      A phone system is required. Supported are:
      Auerwald VoiP 5010, VoiP 5020, Commander Basic.2
      fritz!box 7050, 7170 and similar types
    - add: apps now support more docu
    - updated: jQuery plugins
    
v 1.7 06.10.12
    - new feature: Apps (an app is a complete html-page, which can be easily
      used in your project. Use lib.app('NAME OF APP') to show one on your page.
      all apps are located in pages/apps
    - app: Impressions Frankfurt, Impressions Würzburg
    - app: Weather Tagesschau
    - basic.symbol now with text
    - new widget-file: widgets/weather.html with weather.map, weather.mapslides
    - new widget-file: widgets/clock.html
    - cacheing for remote-calls
    - pages/project folders now support subdirectories
    - improved forms
    - favicon
    - update lib/jQueryMobile 1.2.0
    - smartVISU moved to code.google.com 
    
v 1.6 25.09.12
    - weather-widget now configurable
    - weather-widget with new service: wunderground.com
      generate your key for free at: http://www.wunderground.com/weather/api/
      special thanks to Florian Meister for implementation
    - weather-widget with new service: yr.no
      get your location at: http://www.yr.no
    - iPad improvements
    - fixed basic.glue
    - update lib/jQuery 1.8.2
    - update lib/Twig 1.9.2

v 1.5 01.08.12
    - new basic-widget: "basic.smybol" to display a gad
    - new device-widget: "device.blind" to control blinds, with 2 new slider 
      types (vertical, semicircle)
    - offline-driver enhancement (values now for each project)
    - more docu     
    - update lib/jQueryMobile 1.1.1
    
v 1.4 02.07.12
    - new and official "smartVISU" - Logo 
      special thanks to Björn Bertschy
    - position fixed on MainMenu
    - smother scrolling, better responsive design
    
v 1.3 19.06.12  
    - background picture support (17 backgrounds in 'pics/bg' included)
    - widget-documentation, with phpdoc based documentation
    - update display mechanism
    - basic language support
    
v 1.2 18.05.12
    - clock and weather
    
v 1.1 03.05.12
    - add config
    - more designs
    
v 1.0 26.04.12
    - first offical release