/**
* Bsbanner
* @package bsbanner
* @Copyright (C) 2008 - 2015 BS All rights reserved
* @license http://www.gnu.org/copyleft/gpl.html GNU/GPL
* @link http://softs.saulme.fr/
*
**/


Module Bsbanner pour Joomla
===========================

Nom    : mod_bsbanner
Auteur : Bernard Saulme

Objet:
======
This component (and module) allow you to create image (call 'vignette') using user data. The inputs are compared with limits to choose automatically the background colors. This image uses the 'png' format and can be use form any Website.
Plugins can be adding to save/print/graphs.

Compatibility:
==============
The actual component (base en a website code) is made to work with Joomla 1.5 (native) and Joomla 1.6 (native). Html code is compliant with W3C specifications.
Input images type for background can be: jpg, png, gif. The output image uses the 'png' format.

Install:
========
Download the pack file bsbanner_pack_x.y.z_UNZIPME.zip. Unzip this file.
Install the component and the module using Extensions / Extension Manager (in J!1.6)
For administration use the menu added for the component.

Languages:
==========
All the text in include in the language files. 
Language file for en-GB and fr-FR. are provided.

Database:
=========
If you are using only the image function, no datable tables are created. They can be added by plugins.
Limits for the colours are currently provided in a file (may be database in the future).

Others:
=======
Some hosting restricts the ability to upload using a link can't work. In that case the Bsbanner administrator needs to deactivate this option to avoid error for the users.
A module mod_bsbanner_who exists to print: number of users, pictures, samples ...

Administration :
================
To personalize colours limits for the inputs, edit the file: components\com_bsbanner\models\#ref-image.conf2.php
If no file = no limits colours
The provided file is given as example for a Reef tank. You can adapt as you want.

Calls to main functions:
========================
- Print  : index.php?option=com_bsbanner&view=bsbanner
- Input  : index.php?option=com_bsbanner&view=edit
- Delete : index.php?option=com_bsbanner&view=supp
- Doc    : index.php?option=com_bsbanner&view=doc
- Data   : index.php?option=com_bsbanner&view=data


* History :
===========
0.0.1a   01/07/2008
	Complete website version in php 5 (without Joomla), vignette, history, graph.
0.0.1b   01/09/2008
	Update to support php 4 (with free hosting restriction appliance) & 5. Host by free.fr
2008-2009-2010
	Several updates
	
* Joomla component com_bsbanner :
0.1.0e   23/05/2010
	First 'efficient' version re-packed as Joomla component (will progressively include functions from the original website)
0.1.0f   23/05/2010
	Added upload for background image (and extra admin choice)
0.1.0g   27/05/2010
	Convert utf-8 characters to ISO-8859-1 (for GD compatibility with accents)
	Text updated, Html code updated (class for id, tags updated...)
	Help link added
	Added possibility for the user to change background and text colour
0.1.0h   29/05/2010
	Added example text to ad image to forum, other Website
	Added style page
	Added test if image exist before deletion
	Added possibility to save user data in text mode
0.1.0i   12/06/2010
 	Updated language file
	Added menu icon
	Updated html (some <h4> instead <h3>, <div> ...). Added 'inputbox' for input. Class 'button' instead of 'boutton'
	Updated licence file
	Added some test for BSBNR_BAN_URL, BSBNR_BAN_URL_HTML ou BSBNR_BAN_URL_BB
	Updated print code in case of not connected
	Update title text
0.1.0j   27/06/2010
	Use cookies to memorize the last inputs, colours, background image url (optional)
	Added image upload from a url
	Several new parameters for administrator for the 'vignette'
	Added redirect to login page if not connected instead of a message
	Added component name and version print
0.1.0k   30/08/2010
	Added button on the input page (optional/admin) : print & delete
	Added light grey for background input for labels
0.1.0l   05/09/2010
	Updated all file with 'GPL3 licence' text
	Updated text 'Afficher patienter SVP ...' using language files
	Updated 'en' language file
0.1.0m   12/09/2010
	Added parameters default values in the code
0.1.0n   23/09/2010
	Updated language file to be J!1.5 & J!1.6 compliant
	Updated code to be J!1.5 & J!1.6 compliant (controller, get param, call css, call js, redirections, config.xml, ...)
	Added language files for admin (fr & en)
	Info/version do no print date & version if user is no admin
	Added error message if error during creation
	Changed windows size, for parameters, to ne NetPC compliant
	First version to extension.joomla.org
0.1.2b66 26/02/2011
	Change url print code (Joomla final compatibility)
	Changed <name>mod_bsbanner</name> in bsbanner.xml (J!1.6)
	Specific manifest file for J!1.6
	Updated version.php
	Updated all index.html files
	Updated comment in language files
	Upgrade installation available
	Updated text for param file to modified
0.1.3b78 15/03/2011
	Updated: no more 'Refresh cache' in 'Extension/extension manager/manage' print error msg with J!1.6
	Re-added: check-box pour values to use for image (si save allowed)
	Re-added: availability to choose or not date. multi or single input using pre allocated date format
	Updated '+/-' text position
	Added a specific folder 'backup' to save input in file format
	Updated cookies to be multi user un a single computer
	Updated time validity for cookies (60 days)
	Print file name with basename for file configuration
	Updated a part of the code to have a mode simple 'MVC compliant' usage for templates
	Updated page look (input & delete pages)
	Updated language file text
	Updated code
	Updated: only print 'print' & 'del' button only is image already exists
	Add alt in the sample code propose to the user to include 'vignette' in another Website
	Changed temporary folder and name for background uploaded images
	Changed default max. size for background image from 100 000 to 307 200 octets
	Updated file format to save dates with number of image
	Added date format to #x (#1 = username, #2 = long date, #3 = short date, #4 = hostname)
	Deleted image creation parameter => only file
	Deleted css text default size. Decrease the input size
	Help page in now multilingual
1.2.0b109 29/04/2011
	Re-added the possibility to add new input lines using a button
	Updated limits system for multi colours and extra conditions: > >= < <= == === != & && | ||. Limits depends of the order. New file #ref-image.conf2.php provided
	Several images 'vignette' are now allow for one user (max. configured by the administrator). Care: image names are now including a number. You have to delete the old one
	Added #2 for then number of image (care to the change for the change number for others)
	#x can now be cumulative for the same place in the 'vignette'
	Updated some texts
	Updated css file
	Default date format changed to %Y-%m-%d %H:%M:%S
	Updated code (cookies, param file, extra input control ...)
	Added several configuration parameters
	New plugin interface (plugins are optional). This for data (print data, graphic, import, export ... as you can imagine)
	Install text translated in English
	Added a tab for the administrator to see the limits and colours
	Added <updateservers> for J!1.6
	Fixed bug where in some case the change of administrator parameters are not taken in account in J!1.5
	Administrator parameters views are now using several tabs (J!1.6)
1.2.1b111 19/07/2011
	Fixed a bug in the plugin list for administrator (regression from b106)
1.2.2b115 01/03/2012
	Back-end: added icon menu
	Back-end: change text for menu bar
	Back-end: added Help icon
	Added icon for the input page
	W3C improvement
	Updated language file text
	Updated JsColor to 1.3.13
1.2.3b116 03/04/2012
	Updated for W3C HTML5 compliance
1.3.0b118 31/07/2012
	Updated version display
	Added compatibility to PHP 2.4.x
	Added compatibility with Joomla Platform 12.1 (J!3.0)
	Fixed issue with J!1.5 under some menu item usages where parameter updated into back-end not taken into account into the front end
1.3.1b119 23/08/2012
	Completed compatibility (back) for versions between J!1.6.0 and J!2.5.5 included
1.3.2b120 30/12/2013
	Added optional 'data' button into edit view
	Added the ability to add directly the vignette to Kunena profile during saving, using plugin
	Added date format into language file instead of option to allow different format for different users languages
	Updated the button into the view 'edit'
	Updated jscolor to version from 1.3.13 to 1.4.2
	Changed date usage/look for editing to be more  J!3.x compliant	Deleted the install version message for J!1.6+
	Changed for the style into J!3.0+ Options for the 'Yes/No' selector
	Changed to allow colors selection using jcolor input only (no keyboard input)
	Changed to do not replace configuration file for limits if already exits
	Updated language files
	Updated code
	Fixed options texts
	Known error: date input for each value, multi selector is not working
1.3.3b121 11/01/2014
	Changed update server
1.3.4b121 17/07/2014
	Added to views (edit, delete, data, display) module positions 'bsbanner_top' & 'bsbanner_bottom', for example for menu for bsbanner
	Added options to add ID for positions
	Updated view 'edit' to display less borders
	Added options for plugin : width & height
1.3.4b122 04/05/2015
	Updated to be compatible with J!3.4+ sidebar menu
	Updated back-end view look
1.3.5b123 14/06/2015
	Code update
	Updated some php files Encodage => 'utf-8 without BOM'
	Updated the back-end menu & view title's icons
	Updated the back-end 'Options' button for J!1.6+
	Updated 'help' button (position and url)
	Fixed a minor bug into the label when showing the back-end menu & extra carriage return for J!3.4+
1.3.5b124 29/11/2015
	Renamed text 'Joomla' to 'Joomla!'
	Added ACL for front-end and back-end
	Tested OK with J!3.4.5 & J!3.5beta

* Plugins for com_bsbanner (plugin are not included in the component to have a light component and for licence reasons)

V 1.2b109 29/04/2011
	Generic functions for extra plugins
	Save data in text mode, save in db mode
	Print as list or group by date and labels
	Graphics
	Data import and export
1.2.3b116 03/04/2012
	Updated for W3C HTML5 compliance
1.3.0b118 01/08/2012
	Added compatibility to PHP 2.4.x
	Added compatibility with J!3.0
1.3.2b120 30/12/2013
	Updated graphic JavaScript library to dygraph version 1.0.1 (http://dygraphs.com/)
	Updated date selector (J!3.x)
	Added Kunena integration plugin, for signature
1.3.4b121 16/07/2014
	Added width & height parameter (from component) usage for graph
1.3.4b122 04/04/2015
	Updated input display for data
	Updated php code, JavaScript & look for graph
	
* CB Tab plugin
cb_bsbanner_tab-1.2.b5-CB12 09/02/2013
	Fixed a code issue

* Pack, extention.joomla.org
============================
28/06/2015 bsbanner_pack_1.3.5_PACK : com_bsbanner.1.3.5.b123.zip & mod_bsbanner_who.1.3.0b30.zip & cb_bsbanner_tab-1.2.b6-CB12.zip
04/05/2015 bsbanner_pack_1.3.4_PACK : com_bsbanner.1.3.4.b122.zip & mod_bsbanner_who.1.3.0b30.zip & cb_bsbanner_tab-1.2.b6-CB12.zip
11/01/2014 bsbanner_pack_1.3.3_PACK : com_bsbanner.1.3.3.b120.zip & mod_bsbanner_who.1.3.0b30.zip & cb_bsbanner_tab-1.2.b6-CB12.zip
09/02/2013 bsbanner_pack_1.3.2_UNZIPME.zip : com_bsbanner.1.3.1.b119.zip & mod_bsbanner_who.1.3.0b30.zip & cb_bsbanner_tab-1.2.b6-CB12.zip
31/07/2012 bsbanner_pack_1.3.0_UNZIPME.zip : com_bsbanner.1.3.1.b119.zip & mod_bsbanner_who.1.3.0b30.zip & cb_bsbanner_tab-1.2.b5-CB12.zip
31/07/2012 bsbanner_pack_1.3.0_UNZIPME.zip : com_bsbanner.1.3.0.b118.zip & mod_bsbanner_who.1.3.0b30.zip & cb_bsbanner_tab-1.2.b5-CB12.zip
01/05/2011 bsbanner_pack_1.2.0_UNZIPME.zip : com_bsbanner.0.1.2.b109.zip & mod_bsbanner_who.0.2.0b29.zip & cb_bsbanner_tab-1.2.b4-CB12.zip
15/03/2011 bsbanner_pack_0.1.4_UNZIPME.zip : com_bsbanner.0.1.2.b78.zip  & mod_bsbanner_who.0.1.1b28.zip & cb_bsbanner_tab-1.2.b3-CB12.zip
28/02/2011 bsbanner_pack_0.1.3_UNZIPME.zip : com_bsbanner.0.1.2.b66.zip  & mod_bsbanner_who.0.1.1b27.zip & cb_bsbanner_tab-1.2.b3-CB12.zip
13/01/2011 bsbanner_pack_0.1.2_UNZIPME.zip : com_bsbanner.0.1.1.b3.zip   & mod_bsbanner_who.0.1.0l6.zip  & cb_bsbanner_tab-1.2.CB12.zip
23/12/2010 bsbanner_pack_0.1.1_UNZIPME.zip : com_bsbanner.0.1.0.n15.zip  & mod_bsbanner_who.0.1.0l6.zip  & cb_bsbanner_tab-1.2.CB12.zip
24/09/2010 bsbanner_pack_0.1.0_UNZIPME.zip : com_bsbanner.0.1.0.n15.zip  & mod_bsbanner_who.0.1.0l6.zip



Soon a lot of new features :-)

===============================================================================================================================

