WB 2.08.x

License

=======

Website Baker is released under the GNU General Public License,

Copyright (C) 2004-2005 Ryan Djurovich.

Please refer to the COPYING file for a copy of the license.

General Information

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

Website Baker is a PHP-based content management system

which enables users to produce websites with ease.

Features include a template-based front-end, modulated

and multi-level page support, multi-user administration,

and much much more!

License

=======

Website Baker is released under the GNU General Public License,

Copyright (C) 2004-2006 Ryan Djurovich.

Please refer to the COPYING file for a copy of the license.

Installation

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

Please refer to the INSTALL file for instructions on installation.

Usage

=====

Before using Website Baker please note: you must not remove/change any

copyright notices in the any code contained in this package.

Also, it is appreciated if you leave a link somewhere on your website,

which links to the Website Baker website. (http://www.websitebaker.org/) 

Support

=======

For information about finding help:

http://www.websitebaker.org/2/help

Bugs

====

To submit a bug:

http://www.websitebaker.org/2/bugs

Contribute

==========

For information about how to contribute (donating, etc):

http://www.websitebaker.org/2/contribute

Change Log

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

Please note: This change log may not be accurate

$Id$

Legend:

+ = Added

- = Removed

# = Bugfix

! = Update/Change

------------------------------------- 2.6.3 -------------------------------------

19-Mar-2006 Stefan Braunewell

#	Fixed ticket #146: problems removing groups from viewers list of a page

16-Mar-2006 Stefan Braunewell

!	Changed link target selection. Now self, top and new. (Ticket #145)

#	Fixed ticket #143. Charset setting is now used in admin login and forgot

	password pages.

#	Some changes to the SQL code in the install script for improved 

	compatibility with new MySQL versions

#	Fixed ticket #134 - error on browsing media.

+	Improved backup module: new choice between full database or WB-related

	backup.

#	Fixed ticket #141 - admin now sees all folders in media

#	Fixed e-mail sending problems due to additional parameter in mail call.

#	Applied fix regarding ticket #138: new users now get deleted if

	sending e-mail fails.

#	Fixed ticket #137: Last Reset timer not reset in frontend forgotten 

	password process

#	Removed duplicate expression from modules/news/install.php which caused

	problems in installation

01-Mar-2006 Stefan Braunewell

#	Fixed ticket #68 - Safari problem with displaying all parents.

#	Fixed ticket #136 - mailing forgotten password in admin login screen leads 

	to fatal error.

!	Renamed tag [PROCESSTIME] to [PROCESS_TIME]

------------------------------------- 2.6.2 -------------------------------------

03-Feb-2006 Stefan Braunewell (very big special thanks to John and Alex)

#	Fixed ticket #104 - commas in form field descriptions not allowed.

#	Cookie REMEMBER_KEY wasn't cleared in account/logout 

	and expiration date is now set to time in the past.

#	Smart login not working.

!	Changed mail calls to new function $wb->mail.

#	Form: ticket 124 added captcha settings check 

#	Ticket 118 added formfield type to check for email/text 

#	Ticket 115 changed comparision /modules/form/view.php 

#	Added correct timecheck in form submissions

!	Changed captcha.php call to include timestamp

!	Changed the e-mail validation code and added a mail function to class wb.

!	Forgotten password: if sending of e-mail fails, restore old password.

	Ticket #110

!	Added more charset options. Ticket #102 - thanks to ruebenwurzel!

!	Character encoding setting also affects admin backend.

	Mentioned in ticket #102.

!	Reintroduced page languages setting. If switched to off, page

	languages are only used to determine the language file for the

	universal texts. If on, displayed page and menu are affected by

	the language session variable.

#	Fixed bugs in show_breadcrumbs code and added parameter "depth"

	to set the number of levels to be show.

#	Fixed a bug where access settings of registered and private pages

	were displayed incorrectly.

#	Fixed captcha being cached.

#	Added an exit call after every heading("Location:...")

	redirector to prevent unwanted execution of code.

#	Bug #122. Replaced empty field check by check that setting name is

	not "wb_version".

#	Replaced all remaining occurrences of '/media' by MEDIA_DIRECTORY - bug #108.

#	Fixed bug #99 and two additional instances of typo 

	catpcha instead of captcha.

#	Fixed some typos

#	Fixed some notices and warnings.

#	Fixed bug #105 - back buttons in addon detail pages not editable.

!	Replace 'admin' by 'wb' in all account pages. 

!/#	Moved print_success and print_error code to class.wb.php.

	Added correct parameters to these functions in account pages. 

------------------------------------- 2.6.1 -------------------------------------

12-Dec-2005 Ryan Djurovich

#	Fixed security vulnerability in class.login.php

#	Fixed typo in EN language file

#	Fixed captcha problems (when feature is disabled) in form module and sign-up

!	Added charset encoding to admin templates

!	Added extra code to check for selection of addon upon uninstalling

#	Fixed bugs in RSS news feeder

#	Fixed bug with PAGE_DESCRIPTION not being set on any page

------------------------------------- 2.6.0 -------------------------------------

28-Nov-2005 Ryan Djurovich

+	Added default charset option to (advanced) settings

#	Form module email fields now have email address validation

#	Fixed spacing in form submissions

27-Nov-2005 Ryan Djurovich

+	Added captcha verification to sign-up form

+	Added Captcha to News module

24-Nov-2005 Stefan Braunewell

!	Applied aportale's patch to use label instead of javascript toggle code

20-Nov-2005 Ryan Djurovich

!	News mod now hides read more link if no need for it (see ticket #56)

+	Added support for mailto: links in the menu link mod

#	Added direct-access redirection on some files (see ticket #37)

+	Added extra characters to convert.php (see ticket #64)

#	Fixed ticket #65 (last_reset check in account/forgot_form.php)

29-Sep-2005 Ryan Djurovich

!	Cleaned up form buttons in Settings

!	Moved some options into Advanced Settings

#	Semi-disabled "separate" page trash option

+	Created a backup module/tool for backing-up the database

	(thanks to John (pcwacht) for the original code)

+	Created new "blank template", which can be used in case where you don't

	want anything wrapping page-content.

19-Sep-2005 Ryan Djurovich

+	Added _license field for all add-ons to specify a license

!	Renamed _designed_for variables (for all addons) to _platform

+	Created addons table for faster internal referencing of installed addons

!	Fixed some links, including the "Help" button in Admin

#	Used nl2br to display body correctly when viewing form-submissions

15-Sep-2005 Stefan Braunewell

+	Added table module with columns 'name','type' and 'directory' as an

	index.

+	Added entry to settings table 'wb_version' which holds the version

	number and can be utilized in future upgrade scripts.

!	Added upgrade functionality also for templates and languages.

#/!	Template/modules installation now respects paths.

!	Moved updates from config.php to database.

	Created initialize.php (required by config.php) to read settings.

11-Sep-2005 Stefan Braunewell

!	HTMLArea is now a module instead of a core component. Files moved

	from "include" to "modules".

+	Implemented Installation of modules on top of an older version. This is 

	done via checking $module_version. Instead of install.php, upgrade.php

	is then called if it exists in the module package. 

	For module developers: $module_version and $new_module_version are 

	accessible in upgrade.php to find out what upgrade steps need to be taken.

!	Changed column names in mod_news_posts from short,long to content_short,

	content_long.

09-Sep-2005 Stefan Braunewell

+	Added new advanced setting "Rename Files On Upload". File extensions can be

	given so that respective files will have a ".txt" appended on media upload.

#	Fixed "None found" message bug when user has no top level page edit

	rights.

#	Fixed missing parent option 'none' - ticket #12 - and a minor scope bug.

+	Added breadcrumbs code. Call using $wb->breadcrumbs().

+	Added utf-8 character encoding meta tag into all stock templates.

#	Fixed bug when changing a page's parent

!	Changed the way blocks are treated. Added new frontend class attribute

	default_block_content that controls what is shown on pages such as

	search, login, etc. (Ticket #16)

+	Added support for WYSIWYG editor modules (wysiwygmod)

+	When trying to access a registered page, user is automatically redirected

	there on successful login.

#	Fixed various issues with system search (mainly related to stripslashes()

#	Removed stripslashes() in many places in the code. Added check for

	magic_quotes_gpc to new wb class method add_slashes(). Now database contest

	is independent of magic_quotes setting..

05-Sep-2005 Stefan Braunewell

#	Fixed bug concerning direct access of preferences page.

#	Reworked page visibility and menu item visibility code (frontend login

	problem).

#	Pages in link list in htmlarea popup are now correctly ordered.

#	Fixed bug where group with existing name can be added.

04-Sep-2005 Ryan Djurovich

+	Added and RSS newsfeed script to the News module

04-Sep-2005 Stefan Braunewell

!	Rewrote menu function. Parameters are now given as attributes to frontend class.

#	Fixed some occurrences of potential direct access path disclosure

#	Added directory check to browse.php to prevent xss exploit by trusted users.

!	Updated code to reflect move to Subversion repository system.

27-Aug-2005 Stefan Braunewell

#	Fixed bugs 4,5,6,8,9 in bug tracker

!	Removed 'USER_LANGUAGE' and 'GET_LANGUAGE' constants.

	A GET['lang'] now sets the session language variable.

26-Aug-2005 Stefan Braunewell

!	Moved redundant code into the new class functions. Created 

	'compatibility.php' for backward compatibility with

	modules and templates. Variables and functions can still be accessed

	in the old way.

!/+	Reorganized core frontend files, added new base class 'wb' from

	which 'admin' and the new 'frontend' class inherit. Moved all frontend

	function into new class. Completely rewrote core index.php.

	Now all variables and functions that are available to templates and

	modules are attributes and methods of the frontend and the wb classes

------------------------------------- 2.5.2 -------------------------------------

23-Jun-2005 Ryan Djurovich

!	create_access_file now creates all parent directories if needed

#	Fixed bug when moving page with subpages to another level

#	Fixed bug when saving "Settings" (in Admin) on Windows/IIS

#	Fixed bug where query was not setting error correctly in class.database.php

22-Jun-2005 Ryan Djurovich

#	Fixed bug where template permissions were not saved when a adding group

21-Jun-2005 Ryan Djurovich

#	Added htmlspecialchars for modifying WYSIWYG, news, etc. modules (Bug #78)

#	Fixed language problems in some area's of Admin. (Bug #70)

#	Added a space in website/page keywords (Bug #69)

#	Fixed bugs on settings2.php (Bug #52)

!	Links inserted with HTMLArea now use [wblink--PAGE_ID--] instead of raw URL

13-Jun-2005 Ryan Djurovich

#	Fixed bug (#88) with news module

!	Title of Administration login page now taken from language file (Bug #72)

#	Fixed redirection admin/home to admin/start on admin/index.php

#	Fixed bug with forgotten password page in admin (Bug #81)

25-Apr-2005 Ryan Djurovich

#	Fixed numerous bugs with module uninstallation

#	Fixed bug when uploading files in Administration -> Media

!	Installer no-longer requires you to accept the GNU GPL

------------------------------------- 2.5.1 -------------------------------------

16-Apr-2005 Ryan Djurovich

#	Fixed two bugs with account login/logout

------------------------------------- 2.5.1 -------------------------------------

15-Apr-2005 Ryan Djurovich

#	Fixed bug where non-english characters can get used in page filenames. Many

	measuers have been added (including a new file: wb/framework/convert.php),

	to prevent any possible errors that can occur in page filenames.

#	Fixed invalid meta tags in stock templates (meta tags were not closed)

#	Removed lines 401, 402, and 425 of wb/index.php - not needed

#	Fixed bug where search and account pages are shown in every block

	that is in a template

#	Fixed numerous bugs with media home directories feature

10-Apr-2005 Ryan Djurovich

#	Fixed bugs in account/login.php and logout.php where users

	gets redirected to /pages

------------------------------------- 2.5.0 -------------------------------------

08-Apr-2005 Ryan Djurovich

-	Removed section language feature

+	Added page language feature (replaces need for sections language feature)

#	Fixed bug where pages using menu_link module can have the URL changed

-	Page directory no longer stored in link field in pages table, it is now added

	when the page_link function is called - this makes changing the pages

	directory much easier and quicker

!	Pages with visibility of "none" are now no longer directly accessable

+	Added new visibility setting "hidden", acts exactly like none did previously

!	Template info file can now specify number of menu's available and relative names

!	Template info file can now specify number of blocks's available and relative names

------------------------------------- 2.4.3 -------------------------------------

07-Apr-2005 Ryan Djurovich

#	page_filename function has been rewritten using str_replace

	function, which should be faster and will allow characters

	from other languages into filenames

!	Created new media_filename function, which is now used

	by all media functions (create,upload,rename) to determine

	which characters should be removed from a desired filename

+	New button in Administration page list to view specific page

#	Updated the page_link function to now be compatible with menu link

	module when setting pages directory to root

#	Fixed bugs in search when using "Any Words" option

#	Fixed bug with news module when pages directory set to root

!	Changed URL of documentation website on Administration Start page

------------------------------------- 2.4.2 -------------------------------------

05-Apr-2005 Ryan Djurovich

#	Fixed bug where file could be renamed to nothing in Media

!	Optimised Media create folder, upload file, and rename functions

#	Fixed bug where stripslashes not run on news post titles in admin

05-Apr-2005 Stefan Braunewell

#	Fixed bug concerning usage of the private_sql variable

#	Fixed bug conerning sub-pages being displayed in menus incorrectly

------------------------------------- 2.4.1 -------------------------------------

04-Apr-2005 Ryan Djurovich

!	Pages with visibility of "none" are again directly accessable

#	Fixed bugs regarding renaming files and directories in Media section

!	When home folders disabled, all folders now visible in Media section

------------------------------------- 2.4.0 -------------------------------------

03-Apr-2005 Ryan Djurovich

-	Removed recently added visibility setting of "heading", and relative config vars

+	Added new "menu" field to pages table, and new setting "multiple menus"

	which replaces the need for the menu headings feature

+	Added links to top of groups and users sections, linking to each other

!	Change menu width in "Round" template to 170px (was 150px)

#	Change page "are you sure" deletion message to mention that it will delete

	all sub-pages as well

#	Fixed many bugs with news module when viewing posts by group

!	Pages with visibility of "none" are now no longer directly accessable

02-Apr-2005 Ryan Djurovich

-	Removed need to specify DB_URL when calling database class

#	Stopped fields without a type specified from being shown in form mod

#	Changed '/media' to MEDIA_DIRECTORY on HTMLArea popup windows

	for insert link and insert image

+	Added setting which allows you to specify the default WYSIWYG style

+	Added "Server Email" option, to specify what is used in "From" field when

	sending emails using the PHP mail function. Default is admins email address.

#	Search now excludes pages which have a visibility of none or heading

!	Pages are now given modified_when and modified_by when added

01-Apr-2005 Ryan Djurovich

+	Added option to News module to specify how many posts should be listed

	per page (by default it is set to unlimited, which functions like previous version)

#	Added stripslashes when display page titles in search

+	Page descriptions and last updated date now shown in search by default

30-Mar-2005 Ryan Djurovich

+	Added new feature for Media home folders, where a folder can be specified

	for a specific user or group of users only

!	Changed URL of Help button to http://www.websitebaker.org/docs/

+	Added new feature for "Page Trash" - two modes available: inline and separate

!	When pages are deleted, all sub-pages are now deleted (instead of being moved

	up a level)

29-Mar-2005 Ryan Djurovich

-	Removed Database Settings from Administration Settings (options will not be

	available in 3.x, so trying to match interface with WB 3.x plans

!	Changed the name of Path Settings to Filesystem Settings in Administration

	Settings, and removed ability to change path/url options - matching interface

	plans for WB 3.x

+	Added same options for OS and file permissions as installer to Settings

!	Sessions now named with APP_NAME.'_session_id' (e.g. default is wb_session_id)

28-Mar-2005 Ryan Djurovich

+	New functions available to templates to simplify creation of them. This aims

	to "future-proof" templates for WB 3.x plans.

!	Default templates updated to support some of the new functions

+	Added field to pages table "page_trail" which stores a list of the pages

	parents. This field was needed by the new page_menu function

+	Added option for page visibility "heading" to enabled support for multiple

	menu's. Also, this helps to "future-proof" templates for WB 3.x plans

+	Added option for page visibility "registered", which acts a little like

	private, but is still shown in the menu (although users need to log in to view

	the pages content)

+	Form module submissions now saved to database, and feature now added to

	limit number of submissions per hour to prevent spamming

+	New field for Form module: email. Allows you to specify their email in

	"from" field on module settings.

#	Fixed bug when displaying comments in News module (WB Bug #14)

+	New "under contruction" message if no pages exist

!	Cleaned-up wb/index.php

27-Mar-2005 Ryan Djurovich

+	Created advanced mkdir and chmod functions

#	Fixed bug in media where wrong file/folder is deleted

+	Complete overhall of installer - now only one step! It has been greatly

	simplified in many ways, has much better validation, reports error much more

	nicely, and automatically logs the user into the Administrations

+	Must now specify OS type - allows for customizable file permission settings

+	Sections can now have a language code assigned to them

+	Sections can now have a block name/id assigned to them

!	Home section of Administration renamed to Start, to save confusion with saying

	Homepage (because this term could either mean the main website or Home section

	in	Administration). Also, this aims to unify the interface with WB 3.x plans

!	Moved Users and Groups sections under Access section. This aims to unify the

	interface with WB 3.x plans, which help to unclutter the menu

!	Interface for Settings section has been imporved for usability purposes

#	Fixed HTMLArea where no scrollbar for "insert link" and "insert image" dialogs

	by placing media list inside an iframe

#	Fixed stripslashes problem for viewing news comments

!	Added code from Formesque module (an advanced version of the original Form

	module, modified by Rudolph Lartey from www.carbonect.com), and made further

	interface improvements for select box/checkbox group/radio group options.

#	Possibly fixed bugs where an S appears before file and dir modes

#	Fixed bug where users can be added with same emails (in Administration)

-	Removed support for PEAR, as it was deemed an unnecessary addition which only

	makes code more bulky, and removing it will decrease package size a lot

+	New "homepage redirect" option so first page is included and not redirected to

#	Fixed text not being shown when module uninstalled

!	Imporved interface for basic group permissions

26-Mar-2005 Stefan Braunewell

#	Fixed bug with front-end logins

#	Fixed bug when saving intro page 

+	Added check on sign-up if e-mail exists (thanks to P. Melief)

#	Fixed bugs concerning moving/deleting pages

#	Fixed list of parents in page settings

#	Fixed mkdir without mode parameter

#	Added a check on install to ensure PHP 4.1.x compatibility (thanks to Wanderer)

+	Added support for PAGES_DIRECTORY set to root

+	Search form now supports quotes (thanks to Manafta)

#	Fixed page section ordering

#	News items are displayed with name of poster instead of "Unknown"

#	Deletion confirmation popup window in media section now shows correct file name

------------------------------------- 2.3.1 -------------------------------------

03-Fed-2005 Ryan Djurovich

+	Now there is two types of "filesystem modes", one for directories and one

	for files. Having different settings is very common for most servers, so

	this addition should fix many problems people had with 2.3.0.

-	Removed filesystem mode options from installation

!	Removed duplicate text on installation step 3 for timezone

!	All "access files" for the news module now stored in pages/posts instead

	of a sub-dir relative to the page (this fixes many bugs)

#	Fixed major bugs when deleting pages with sub-pages

!	Removed the restrictions that prevent a user for changing a pages level

#	Fixed bug with "toggle" plus/minus in IE for pages list

#	Fixed some bugs where /pages was not replaced with PAGES_DIRECTORY constant

------------------------------------- 2.3.0 -------------------------------------

26-Jan-2005 Ryan Djurovich

#	Fixed bug in framework/functions.php that made root parent always equal 8

#	Added missing braces in lines 182 and 208 of admin/pages/settings2.php

#	Fixed SQL-query on line 172, placing a / after $old_link

#	Added eregi checks for PAGES_DIRECTORY on lines 140 and 150 of

	admin/pages/settings2.php

#	Added ordering cleaning to delete_post.php on line 53 for news module

!	GMT option is selected for "Default Timezone" in the installer, instead

	of the old "Please select" message (which had the same value as GMT)

28-Jan-2005 Ryan Djurovich

!	Ability to specify the chmod number when WB uploads files, etc.

!	Modified file headers (copyright/license notice) so they now look almost the

	same, independant of font. Also, it now covers copyright for 2005.

30-Jan-2005 Ryan Djurovich

#	Added code on wb/admin/pages/delete.php to remove sections from the sections

	table when a page is deleted.

+	New 'Smart Login' prevents users from using external password managers,

	and can be set to remember the users password using cookies.

!	SourceForge CVS module now called websitebaker2 (instead of just

	websitebaker). Also, all file versions have been reset.

01-Fed-2005 Ryan Djurovich

!	Added code to prevent from changing a pages level (it simply disables

	the select box), to prevent many possible bugs.

------------------------------------- 2.2.4 -------------------------------------

23-Dec-2004 Ryan Djurovich

!	Change 'EXACT_PHRASE' to 'EXACT_MATCH' on line 261 of wb/languages/EN.php

#	Fixed multi-language support in search

+	Added more detailed options to list of PHP error reporting level's

-	Removed ability to change language and PHP error reporting level

	on installation to make things easier for newbie's

+	Ability to select custom spacer for page filename's

!	Changed the way a language code is found on language installation

+	Added template permissions to groups

#	Fixed bug when trying to change email from Preferences (admin and frontend)

#	Fixed bug with auto-selection of "System Default" for Preferences

!	News module now use's WYSIWYG for modifying news posts

+	Ability to specify both the pages and media target directories

------------------------------------ 2.2.3-c ------------------------------------

22-Dec-2004 Ryan Djurovich

#	Fixed problem with DB password being reset if Settings saved in basic mode

------------------------------------ 2.2.3-b ------------------------------------

21-Dec-2004 Ryan Djurovich

#	Fixed minor bug on admin templates section

#	Fixed bug on rename.php and rename2.php in admin media section

------------------------------------- 2.2.3 -------------------------------------

20-Dec-2004 Ryan Djurovich

+	Added WB release version in Administration (top right corner)

!	New option to prevent users from adding level 0 pages

#	Fixed bug when deleting post's in News module

+	Added new field in pages table for "root" parent (level 0 parent), for

	extra flexability in creating templates

!	Round template now supports unlimited page levels

------------------------------------- 2.2.2 -------------------------------------

18-Dec-2004 Ryan Djurovich

+	New option under Search Settings for selecting custom template for search

+	New option when changing page settings to set the target

#	Fixed error when saving a user after editing

!	Users can now modify sub-page if they dont have permissions on the parent

------------------------------------- 2.2.1 -------------------------------------

15-Dec-2004 Ryan Djurovich

#	Fixed bug when changing password on preferences form (front-end)

#	Fixed bug when retrieving user details (administration)

#	Added check to see if module, template, or language is in use when deleting

#	Fixed up email that is sent to user from a submitted form

#	Fixed major problem with module permissions which stopped it from working

------------------------------------- 2.2.0 -------------------------------------

14-Dec-2004 (Correct date[s] unkown) Ryan Djurovich

+	Multiple-level page support

+	Multiple section's for pages (including interface)

!	Removed text created using two words on all areas

	(e.g. {Intro} {PAGE} is now {INTRO_PAGE})

	this is for better language support

+	Added Languages section

!	Moved Templates and Modules under Add-ons section

!	Changed name of "Default" template to "Round"

+	Added "All CSS" template

+	Added "Jump"

+	Added 

!	Modified "Box" template to support multiple page levels

+	Added "Menu Link" module

+	Added "News" module

+	Added "Code" module

+	Added "Form" module

+	Added "Wrapper" module

!	Changed name of "Normal Page" module to "WYSIWYG"

+	Created new admin wrapper script to ease module develpment

+	Media now automatically creates index.php file for every

	sub-folder made (for security purposes)

!	Change "Help" link in Administration menu so it now directs

	to the the new Website Baker documentation website found at:

	http://www.websitebaker.org/documentation

!	Password is now required to change email in preferences

+	User can now select custom Language and Date & Time Formats

+	Added search functionality, with three different "methods":

	1. Using all words  2. Using any words  3. Exact match

+	Added native MySQL database support

		    GNU GENERAL PUBLIC LICENSE

		       Version 2, June 1991

 Copyright (C) 1989, 1991 Free Software Foundation, Inc.

                       59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 Everyone is permitted to copy and distribute verbatim copies

 of this license document, but changing it is not allowed.

			    Preamble

  The licenses for most software are designed to take away your

freedom to share and change it.  By contrast, the GNU General Public

License is intended to guarantee your freedom to share and change free

software--to make sure the software is free for all its users.  This

General Public License applies to most of the Free Software

Foundation's software and to any other program whose authors commit to

using it.  (Some other Free Software Foundation software is covered by

the GNU Library General Public License instead.)  You can apply it to

your programs, too.

  When we speak of free software, we are referring to freedom, not

price.  Our General Public Licenses are designed to make sure that you

have the freedom to distribute copies of free software (and charge for

this service if you wish), that you receive source code or can get it

if you want it, that you can change the software or use pieces of it

in new free programs; and that you know you can do these things.

  To protect your rights, we need to make restrictions that forbid

anyone to deny you these rights or to ask you to surrender the rights.

These restrictions translate to certain responsibilities for you if you

distribute copies of the software, or if you modify it.

  For example, if you distribute copies of such a program, whether

gratis or for a fee, you must give the recipients all the rights that

you have.  You must make sure that they, too, receive or can get the

source code.  And you must show them these terms so they know their

rights.

  We protect your rights with two steps: (1) copyright the software, and

(2) offer you this license which gives you legal permission to copy,

distribute and/or modify the software.

  Also, for each author's protection and ours, we want to make certain

that everyone understands that there is no warranty for this free

software.  If the software is modified by someone else and passed on, we

want its recipients to know that what they have is not the original, so

that any problems introduced by others will not reflect on the original

authors' reputations.

  Finally, any free program is threatened constantly by software

patents.  We wish to avoid the danger that redistributors of a free

program will individually obtain patent licenses, in effect making the

program proprietary.  To prevent this, we have made it clear that any

patent must be licensed for everyone's free use or not licensed at all.

  The precise terms and conditions for copying, distribution and

modification follow.

		    GNU GENERAL PUBLIC LICENSE

   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. This License applies to any program or other work which contains

a notice placed by the copyright holder saying it may be distributed

under the terms of this General Public License.  The "Program", below,

refers to any such program or work, and a "work based on the Program"

means either the Program or any derivative work under copyright law:

that is to say, a work containing the Program or a portion of it,

either verbatim or with modifications and/or translated into another

language.  (Hereinafter, translation is included without limitation in

the term "modification".)  Each licensee is addressed as "you".

Activities other than copying, distribution and modification are not

covered by this License; they are outside its scope.  The act of

running the Program is not restricted, and the output from the Program

is covered only if its contents constitute a work based on the

Program (independent of having been made by running the Program).

Whether that is true depends on what the Program does.

  1. You may copy and distribute verbatim copies of the Program's

source code as you receive it, in any medium, provided that you

conspicuously and appropriately publish on each copy an appropriate

copyright notice and disclaimer of warranty; keep intact all the

notices that refer to this License and to the absence of any warranty;

and give any other recipients of the Program a copy of this License

along with the Program.

You may charge a fee for the physical act of transferring a copy, and

you may at your option offer warranty protection in exchange for a fee.

  2. You may modify your copy or copies of the Program or any portion

of it, thus forming a work based on the Program, and copy and

distribute such modifications or work under the terms of Section 1

above, provided that you also meet all of these conditions:

    a) You must cause the modified files to carry prominent notices

    stating that you changed the files and the date of any change.

    b) You must cause any work that you distribute or publish, that in

    whole or in part contains or is derived from the Program or any

    part thereof, to be licensed as a whole at no charge to all third

    parties under the terms of this License.

    c) If the modified program normally reads commands interactively

    when run, you must cause it, when started running for such

    interactive use in the most ordinary way, to print or display an

    announcement including an appropriate copyright notice and a

    notice that there is no warranty (or else, saying that you provide

    a warranty) and that users may redistribute the program under

    these conditions, and telling the user how to view a copy of this

    License.  (Exception: if the Program itself is interactive but

    does not normally print such an announcement, your work based on

    the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole.  If

identifiable sections of that work are not derived from the Program,

and can be reasonably considered independent and separate works in

themselves, then this License, and its terms, do not apply to those

sections when you distribute them as separate works.  But when you

distribute the same sections as part of a whole which is a work based

on the Program, the distribution of the whole must be on the terms of

this License, whose permissions for other licensees extend to the

entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest

your rights to work written entirely by you; rather, the intent is to

exercise the right to control the distribution of derivative or

collective works based on the Program.

In addition, mere aggregation of another work not based on the Program

with the Program (or with a work based on the Program) on a volume of

a storage or distribution medium does not bring the other work under

the scope of this License.

  3. You may copy and distribute the Program (or a work based on it,

under Section 2) in object code or executable form under the terms of

Sections 1 and 2 above provided that you also do one of the following:

    a) Accompany it with the complete corresponding machine-readable

    source code, which must be distributed under the terms of Sections

    1 and 2 above on a medium customarily used for software interchange; or,

    b) Accompany it with a written offer, valid for at least three

    years, to give any third party, for a charge no more than your

    cost of physically performing source distribution, a complete

    machine-readable copy of the corresponding source code, to be

    distributed under the terms of Sections 1 and 2 above on a medium

    customarily used for software interchange; or,

    c) Accompany it with the information you received as to the offer

    to distribute corresponding source code.  (This alternative is

    allowed only for noncommercial distribution and only if you

    received the program in object code or executable form with such

    an offer, in accord with Subsection b above.)

The source code for a work means the preferred form of the work for

making modifications to it.  For an executable work, complete source

code means all the source code for all modules it contains, plus any

associated interface definition files, plus the scripts used to

control compilation and installation of the executable.  However, as a

special exception, the source code distributed need not include

anything that is normally distributed (in either source or binary

form) with the major components (compiler, kernel, and so on) of the

operating system on which the executable runs, unless that component

itself accompanies the executable.

If distribution of executable or object code is made by offering

access to copy from a designated place, then offering equivalent

access to copy the source code from the same place counts as

distribution of the source code, even though third parties are not

compelled to copy the source along with the object code.

  4. You may not copy, modify, sublicense, or distribute the Program

except as expressly provided under this License.  Any attempt

otherwise to copy, modify, sublicense or distribute the Program is

void, and will automatically terminate your rights under this License.

However, parties who have received copies, or rights, from you under

this License will not have their licenses terminated so long as such

parties remain in full compliance.

  5. You are not required to accept this License, since you have not

signed it.  However, nothing else grants you permission to modify or

distribute the Program or its derivative works.  These actions are

prohibited by law if you do not accept this License.  Therefore, by

modifying or distributing the Program (or any work based on the

Program), you indicate your acceptance of this License to do so, and

all its terms and conditions for copying, distributing or modifying

the Program or works based on it.

  6. Each time you redistribute the Program (or any work based on the

Program), the recipient automatically receives a license from the

original licensor to copy, distribute or modify the Program subject to

these terms and conditions.  You may not impose any further

restrictions on the recipients' exercise of the rights granted herein.

You are not responsible for enforcing compliance by third parties to

this License.

  7. If, as a consequence of a court judgment or allegation of patent

infringement or for any other reason (not limited to patent issues),

conditions are imposed on you (whether by court order, agreement or

otherwise) that contradict the conditions of this License, they do not

excuse you from the conditions of this License.  If you cannot

distribute so as to satisfy simultaneously your obligations under this

License and any other pertinent obligations, then as a consequence you

may not distribute the Program at all.  For example, if a patent

license would not permit royalty-free redistribution of the Program by

all those who receive copies directly or indirectly through you, then

the only way you could satisfy both it and this License would be to

refrain entirely from distribution of the Program.

If any portion of this section is held invalid or unenforceable under

any particular circumstance, the balance of the section is intended to

apply and the section as a whole is intended to apply in other

circumstances.

It is not the purpose of this section to induce you to infringe any

patents or other property right claims or to contest validity of any

such claims; this section has the sole purpose of protecting the

integrity of the free software distribution system, which is

implemented by public license practices.  Many people have made

generous contributions to the wide range of software distributed

through that system in reliance on consistent application of that

system; it is up to the author/donor to decide if he or she is willing

to distribute software through any other system and a licensee cannot

impose that choice.

This section is intended to make thoroughly clear what is believed to

be a consequence of the rest of this License.

  8. If the distribution and/or use of the Program is restricted in

certain countries either by patents or by copyrighted interfaces, the

original copyright holder who places the Program under this License

may add an explicit geographical distribution limitation excluding

those countries, so that distribution is permitted only in or among

countries not thus excluded.  In such case, this License incorporates

the limitation as if written in the body of this License.

  9. The Free Software Foundation may publish revised and/or new versions

of the General Public License from time to time.  Such new versions will

be similar in spirit to the present version, but may differ in detail to

address new problems or concerns.

Each version is given a distinguishing version number.  If the Program

specifies a version number of this License which applies to it and "any

later version", you have the option of following the terms and conditions

either of that version or of any later version published by the Free

Software Foundation.  If the Program does not specify a version number of

this License, you may choose any version ever published by the Free Software

Foundation.

  10. If you wish to incorporate parts of the Program into other free

programs whose distribution conditions are different, write to the author

to ask for permission.  For software which is copyrighted by the Free

Software Foundation, write to the Free Software Foundation; we sometimes

make exceptions for this.  Our decision will be guided by the two goals

of preserving the free status of all derivatives of our free software and

of promoting the sharing and reuse of software generally.

			    NO WARRANTY

  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY

FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN

OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES

PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED

OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS

TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE

PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,

REPAIR OR CORRECTION.

  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING

WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR

REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,

INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING

OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED

TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY

YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER

PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE

POSSIBILITY OF SUCH DAMAGES.

		     END OF TERMS AND CONDITIONS

	    How to Apply These Terms to Your New Programs

  If you develop a new program, and you want it to be of the greatest

possible use to the public, the best way to achieve this is to make it

free software which everyone can redistribute and change under these terms.

  To do so, attach the following notices to the program.  It is safest

to attach them to the start of each source file to most effectively

convey the exclusion of warranty; and each file should have at least

the "copyright" line and a pointer to where the full notice is found.

    <one line to give the program's name and a brief idea of what it does.>

    Copyright (C) <year>  <name of author>

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Also add information on how to contact you by electronic and paper mail.

If the program is interactive, make it output a short notice like this

when it starts in an interactive mode:

    Gnomovision version 69, Copyright (C) year name of author

    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.

    This is free software, and you are welcome to redistribute it

    under certain conditions; type `show c' for details.

The hypothetical commands `show w' and `show c' should show the appropriate

parts of the General Public License.  Of course, the commands you use may

be called something other than `show w' and `show c'; they could even be

mouse-clicks or menu items--whatever suits your program.

You should also get your employer (if you work as a programmer) or your

school, if any, to sign a "copyright disclaimer" for the program, if

necessary.  Here is a sample; alter the names:

  Yoyodyne, Inc., hereby disclaims all copyright interest in the program

  `Gnomovision' (which makes passes at compilers) written by James Hacker.

  <signature of Ty Coon>, 1 April 1989

  Ty Coon, President of Vice

This General Public License does not permit incorporating your program into

proprietary programs.  If your program is a subroutine library, you may

consider it more useful to permit linking proprietary applications with the

library.  If this is what you want to do, use the GNU Library General

Public License instead of this License.

<?php

header('Location: ../');

?>

<?php ?>

<?php

// $Id$

/*

 Website Baker Project <http://www.websitebaker.org/>

 Copyright (C) 2004-2006, Ryan Djurovich

 Website Baker is free software; you can redistribute it and/or modify

 it under the terms of the GNU General Public License as published by

 the Free Software Foundation; either version 2 of the License, or

 (at your option) any later version.

 Website Baker is distributed in the hope that it will be useful,

 but WITHOUT ANY WARRANTY; without even the implied warranty of

 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License

 along with Website Baker; if not, write to the Free Software

 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

*/

// Must include code to stop this file being access directly

if(defined('WB_PATH') == false) { exit("Cannot access this file directly"); }

// Delete the editor directory

rm_full_dir(WB_PATH.'/modules/htmlarea/htmlarea');

?>

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">

<html>

  <head>

    <title>HTMLArea -- the free, customizable online editor</title>

    <style type="text/css">

      html, body { font-family: georgia,"times new roman",serif; background-color: #fff; color: #000; }

      .label { text-align: right; padding-right: 0.3em; }

      .bline { border-bottom: 1px solid #aaa; }

    </style>

  </head>

  <body>

    <div style="float: right; border: 1px solid #aaa; background-color: #eee; padding: 3px; margin-left: 10px; margin-bottom: 10px;">

      <table cellspacing="0" cellpadding="0" border="0">

        <tr>

          <td class="label">Version:</td><td>3.0</td>

        </tr>

        <tr>

          <td class="label">Release:</td><td>rc1 (<a href="release-notes.html">release notes</a>)</td>

        </tr>

        <tr>

          <td class="label bline">Compiled at:</td><td class="bline">Mar  1, 2004 [19:37] GMT</td>

        </tr>

        <tr>

          <td class="label">SourceForge page:</td><td><a href="http://sf.net/projects/itools-htmlarea/">http://sf.net/projects/itools-htmlarea/</a></td>

      </table>

    </div>

    <h1>HTMLArea -- the free<br/>customizable online editor</h1>

    <p>

      HTMLArea is a free, customizable online editor.  It works inside your

      browser.  It uses a non-standard feature implemented in Internet

      Explorer 5.5 or better for Windows and Mozilla 1.3 or better (any

      platform), therefore it will only work in one of these browsers.

    </p>

    <p>

      HTMLArea is copyright <a

      href="http://interactivetools.com">InteractiveTools.com</a> and <a

      href="http://dynarch.com">Dynarch.com</a> and it is

      released under a BSD-style license.  HTMLArea is created and developed

      upto version 2.03 by InteractiveTools.com.  Version 3.0 developed by

      <a href="http://dynarch.com/mishoo/">Mihai Bazon</a> for

      InteractiveTools.  It contains code sponsored by third-party companies as well.

      Please see our About Box for details about who sponsored what plugins.

    </p>

    <h2>Online demos</h2>

    <ul>

      <li><a href="examples/core.html">HTMLArea standard</a> -- contains the core

        editor.</li>

      <li><a href="examples/table-operations.html">HTMLArea + tables</a> --

        loads the <tt>TableOperations</tt> plugin which provides some extra

        editing features for tables.</li>

      <li><a href="examples/spell-checker.html">HTMLArea + spell checher</a>

        -- loads the <tt>SpellChecker</tt> plugin which provides what its

        name says: a spell checker.  This one requires additional support on

        the server-side.</li>

      <li><a href="examples/full-page.html">HTMLArea Full HTML Editor</a> --

        loads the <tt>FullPage</tt> plugin which allows you to edit a full

        HTML page, including <title>, <!DOCTYPE...> and some

        other options.</li>

      <li><a href="examples/context-menu.html">HTMLArea with Context

          Menu</a> -- this plugin provides a nice and useful context menu.</li>

      <li><a href="examples/fully-loaded.html">HTMLArea fully loaded</a> --

        all of the above. ;-)</li>

    </ul>

    <h2>Installation</h2>

    <p>

      Installation is (or should be) easy.  You need to unpack the ZIP file

      in a directory accessible through your webserver.  Supposing you

      unpack in your <tt>DocumentRoot</tt> and your <tt>DocumentRoot</tt> is

      <tt>/var/www/html</tt> as in a standard RedHat installation, you need

      to acomplish the following steps: (the example is for a Unix-like

      operating system)

    </p>

    <pre style="margin-left: 2em"

>

cd /var/www/html

unzip /path/to/archive/HTMLArea-3.0-rc1.zip

mv HTMLArea-3.0-rc1 htmlarea

find htmlarea/ -type f -exec chmod 644 {} \;

find htmlarea/ -type d -exec chmod 755 {} \;

find htmlarea/ -name "*.cgi" -exec chmod 755 {} \;</pre>

    <p>

      <strong>Notes.</strong> You may chose to symlink "htmlarea" to "HTMLArea-3.0-rc1", in which case your server needs to be configured to

      "<tt>FollowSymLinks</tt>".  You need to make sure that *.cgi files are

      interpreted as CGI scripts.  If you want to use the SpellChecker

      plugin you need to have a recent version of Perl installed (I

      recommend 5.8.0) on the server, and the module Text::Aspell, available

      from CPAN.  More info in "<a

      href="plugins/SpellChecker/readme-tech.html">plugins/SpellChecker/readme-tech.html</a>".

    </p>

    <p>About how to setup your pages to use the editor, please read the

      [outdated yet generally valid] <a

        href="reference.html">documentation</a>.</p>

    <h2>Status and links</h2>

    <p>HTMLArea has reached version 3.0.  As of this version, it

      supports:</p>

    <ul>

      <li>Customizable toolbar</li>

      <li>Easy internationalization</li>

      <li>Plugin-based infrastructure</li>

      <li>Delivers W3-compliant HTML (with few exceptions)</li>

      <li>Has a subset of Microsoft Word's keyboard shortcuts</li>

      <li>Full-screen editor</li>

      <li>Advanced table operations (by external plugin

        "TableOperations")</li>

      <li>Spell checker (by external plugin "SpellChecker")</li>

      <li>probably more... ;-)</li>

    </ul>

    <p>We have a <a

    href="http://sourceforge.net/projects/itools-htmlarea/">project page</a>

    at <a href="http://sourceforge.net">SourceForge.net</a>.  There you can

    also find out <a href="http://sourceforge.net/cvs/?group_id=69750">how

    to retrieve the code from CVS</a>, or you can <a

    href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/itools-htmlarea">browse

    the CVS online</a>.  We also have a <a

    href="http://sourceforge.net/tracker/?atid=525656&group_id=69750&func=browse">bug

    system</a>, a <a

    href="http://sourceforge.net/tracker/?atid=525658&group_id=69750&func=browse">patch

    tracking system</a> and a <a

    href="http://sourceforge.net/tracker/?atid=525659&group_id=69750&func=browse">feature

    request page</a>.</p>

    <p>We invite you to say everything you want about HTMLArea <a

    href="http://www.interactivetools.com/forum/gforum.cgi?forum=14;">on the

    forums</a> at InteractiveTools.com.  There you should also find the

    latest news.</p>

    <p>Sometimes I post news about the latest developments on <a

    href="http://dynarch.com/mishoo/">my personal homepage</a>.</p>

    <h2>"It doesn't work, what's wrong?"</h2>

    <p>If it doesn't work, you have several options:</p>

    <ul>

      <li>Post a message to the forum.  Describe your problem in as much

      detail as possible.  Include errors you might find in the JavaScript

      console (if you are a Mozilla user), or errors displayed by IE (though

      they're most of the times useless).</li>

      <li>If you're positive that you discovered a bug in HTMLArea then feel

      free to fill a bug report in our bug system.  If you have the time you

      should check to see if a similar bug was reported or not; it might be

      fixed already in the CVS ;-) If you're positive that a similar bug was

      not yet reported, do fill a bug report and please include as much

      detail as possible, such as your browser, OS, errors from JavaScript

      console, etc.</li>

      <li>If you want a new feature to be implemented, post it on the

      features request and someone will hopefully take care of it.</li>

    </ul>

    <p>You can <a href="mailto:mishoo@infoiasi.ro">contact me directly</a>

    <em>only</em> if you want to pay me for implementing custom features to

    HTMLArea.  If you want to sponsor these features (that is, allow them to

    get back into the public HTMLArea distribution) I'll be cheaper. ;-)</p>

    <hr />

    <address><a href="http://dynarch.com/mishoo/">Mihai Bazon</a></address>

<!-- Created: Sun Aug  3 14:11:26 EEST 2003 -->

<!-- hhmts start --> Last modified: Wed Jan 28 11:54:47 EET 2004 <!-- hhmts end -->

<!-- doc-lang: English -->

  </body>

</html>

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">

<html> <head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<title>HTMLArea-3.0 Reference</title>

<style type="text/css">

  @import url(htmlarea.css);

  body { font: 14px verdana,sans-serif; background: #fff; color: #000; }

  h1, h2 { font-family:tahoma,sans-serif; }

  h1 { border-bottom: 2px solid #000; }

  h2 { border-bottom: 1px solid #aaa; }

  h3, h4 { margin-bottom: 0px; font-family: Georgia,serif; font-style: italic; }

  h4 { font-size: 90%; margin-left: 1em; }

  acronym { border-bottom: 1px dotted #063; color: #063; }

  p { margin-left: 2em; margin-top: 0.3em; }

  li p { margin-left: 0px; }

  .abstract { padding: 5px; margin: 0px 10em; font-size: 90%; border: 1px dashed #aaa; background: #eee;}

  li { margin-left: 2em; }

  em { color: #042; }

  a { color: #00f; }

  a:hover { color: #f00; }

  a:active { color: #f80; }

  span.browser { font-weight: bold; color: #864; }

  .fixme { font-size: 20px; font-weight: bold; color: red; background: #fab;

padding: 5px; text-align: center; }

  .code {

   background: #e4efff; padding: 5px; border: 1px dashed #abc; margin-left: 2em; margin-right: 2em;

   font-family: fixed,"lucidux mono","andale mono","courier new",monospace;

  }

  .note, .warning { font-weight: bold; color: #0a0; font-variant: small-caps; }

  .warning { color: #a00; }

.string {

  color: #06c;

} /* font-lock-string-face */

.comment {

  color: #840;

} /* font-lock-comment-face */

.variable-name {

  color: #000;

} /* font-lock-variable-name-face */

.type {

  color: #008;

  font-weight: bold;

} /* font-lock-type-face */

.reference {

  color: #048;

} /* font-lock-reference-face */

.preprocessor {

  color: #808;

} /* font-lock-preprocessor-face */

.keyword {

  color: #00f;

  font-weight: bold;

} /* font-lock-keyword-face */

.function-name {

  color: #044;

} /* font-lock-function-name-face */

.html-tag {

  font-weight: bold;

} /* html-tag-face */

.html-helper-italic {

  font-style: italic;

} /* html-helper-italic-face */

.html-helper-bold {

  font-weight: bold;

} /* html-helper-bold-face */

</style>

<script type="text/javascript">

  _editor_url = './';

  _editor_lang = 'en';

</script>

<script type="text/javascript" src="htmlarea.js"></script>

<script type="text/javascript" src="dialog.js"></script>

<script tyle="text/javascript" src="lang/en.js"></script>

</head>

<body onload="HTMLArea.replace('TA')">

<h1>HTMLArea-3.0 Documentation</h1>

<div class="abstract" style="color: red; font-weight: bold">

      This documentation contains valid information, but is outdated in the

      terms that it does not covers all the features of HTMLArea.  A new

      documentation project will be started, based on LaTeX.

</div>

<h2>Introduction</h2>

<h3>What is HTMLArea?</h3>

<p>HTMLArea is a free <acronym title="What You See Is What You Get"

>WYSIWYG</acronym> editor replacement for <code>&lt;textarea&gt;</code>

fields.  By adding a few simple lines of JavaScript code to your web page

you can replace a regular textarea with a rich text editor that lets your

users do the following:</p>

<ul>

  <li>Format text to be bold, italicized, or underlined.</li>

  <li>Change the face, size, style and color.</li>

  <li>Left, center, or right-justify paragraphs.</li>

  <li>Make bulleted or numbered lists.</li>

  <li>Indent or un-indent paragraphs.</li>

  <li>Insert a horizontal line.</li>

  <li>Insert hyperlinks and images.</li>

  <li>View the raw HTML source of what they're editing.</li>

  <li>and much more...</li>

</ul>

<p>Some of the interesting features of HTMLArea that set's it apart from

other web based WYSIWYG editors are as follows:</p>

<ul>

  <li>It's lightweight, fast loading and can transform a regular textarea

  into a rich-text editor with a single line of JavaScript.</li>

  <li>Generates clean, valid HTML.</li>

  <li>It degrades gracefully to older or non-supported browsers

  (they get the original textarea field).</li>

  <li>It's free and can be incorporated into any free or commercial

  program.</li>

  <li>It works with any server-side languages (ASP, PHP, Perl, Java,

  etc).</li>

  <li>It's written in JavaScript and can be easily viewed, modified or

  extended.</li>

  <li>It remembers entered content when a user navigates away and then hits

  "back" in their browser.</li>

  <li>Since it replaces existing textareas it doesn't require a lot of code

  to add it to your pages (just one line).</li>

  <li>Did we mention it was free? ;-)</li>

</ul>

<h3>Is it really free?  What's the catch?</h3>

<p>Yes! It's really free. You can use it, modify it, distribute it with your

software, or do just about anything you like with it.</p>

<h3>What are the browser requirements?</h3>

<p>HTMLArea requires <span class="browser"><a

href="http://www.microsoft.com/ie">Internet Explorer</a> &gt;= 5.5</span>

(Windows only), or <span class="browser"><a

href="http://mozilla.org">Mozilla</a> &gt;= 1.3-Beta</span> on any platform.

Any browser based on <a href="http://mozilla.org/newlayout">Gecko</a> will

also work, provided that Gecko version is at least the one included in

Mozilla-1.3-Beta (for example, <a

href="http://galeon.sf.net">Galeon-1.2.8</a>).  However, it degrades

gracefully to other browsers. They will get a regular textarea field

instead of a WYSIWYG editor.</p>

<h3>Can I see an example of what it looks like?</h3>

<p>Just make sure you're using one of the browsers mentioned above and see

below.</p>

<form onsubmit="return false;">

<textarea id="TA" style="width: 100%; height: 15em;">

<p>Here is some sample text in textarea that's been transformed with <font

color="#0000CC"><b>HTMLArea</b></font>.<br />

You can make things <b>bold</b>, <i>italic</i>, <u>underline</u>.  You can change the

<font size="3">size</font> and <b><font color="#0000CC">c</font><font color="#00CC00">o</font><font color="#00CCCC">l</font><font color="#CC0000">o</font><font color="#CC00CC">r</font><font color="#CCCC00">s</font><font color="#CCCCCC">!</font></b>

And lots more...</p>

<p align="center"><font size="4" color="#ff0000"><b><u>Try HTMLArea

today!</u></b></font><br /></p>

</textarea>

</form>

<h3>Where can I find out more info, download the latest version and talk to

other HTMLArea users?</h3>

<p>You can find out more about HTMLArea and download the latest version on

the <a href="http://dynarch.com/htmlarea/">HTMLArea

homepage</a> and you can talk to other HTMLArea users and post any comments

or suggestions you have in the <a

href="http://www.interactivetools.com/iforum/Open_Source_C3/htmlArea_v3.0_-_Alpha_Release_F14/"

>HTMLArea forum</a>.</p>

<h2>Keyboard shortcuts</h2>

<p>The editor provides the following key combinations:</p>

<ul>

  <li>CTRL-A -- select all</li>

  <li>CTRL-B -- bold</li>

  <li>CTRL-I -- italic</li>

  <li>CTRL-U -- underline</li>

  <li>CTRL-S -- strikethrough</li>

  <li>CTRL-L -- justify left</li>

  <li>CTRL-E -- justify center</li>

  <li>CTRL-R -- justify right</li>

  <li>CTRL-J -- justify full</li>

  <li>CTRL-1 .. CTRL-6 -- headings (&lt;h1&gt; .. &lt;h6&gt;)</li>

  <li>CTRL-0 (zero) -- clean content pasted from Word</li>

</ul>

<h2>Installation</h2>

<h3>How do I add HTMLArea to my web page?</h3>

<p>It's easy.  First you need to upload HTMLArea files to your website.

Just follow these steps.</p>

<ol>

  <li>Download the latest version from the <a

  href="http://www.interactivetools.com/products/htmlarea/">htmlArea

  homepage</a>.</li>

  <li>Unzip the files onto your local computer (making sure to maintain the

  directory structure contained in the zip).</li>

  <li>Create a new folder on your website called /htmlarea/ (make sure it's

  NOT inside the cgi-bin).</li>

  <li>Transfer all the HTMLArea files from your local computer into the

  /htmlarea/ folder on your website.</li>

  <li>Open the example page /htmlarea/examples/core.html with your browser to make

  sure everything works.</li>

</ol>

<p>Once htmlArea is on your website all you need to do is add some

JavaScript to any pages that you want to add WYSIWYG editors to.  Here's how

to do that.</p>

<ol>

  <li>Define some global variables.  "_editor_url" has to be the absolute

  URL where HTMLArea resides within your

  website; as we discussed, this would be “/htmlarea/”.  "_editor_lang" must

  be the language code in which you want HTMLArea to appear.  This defaults

  to "en" (English); for a list of supported languages, please look into

  the "lang" subdirectory in the distribution.

  <pre class="code"

  ><span class="function-name">&lt;</span><span class="html-tag">script</span> <span class="variable-name">type=</span><span class="string">&quot;text/javascript&quot;</span><span class="function-name">&gt;</span>

   _editor_url = <span class="string">&quot;/htmlarea/&quot;</span>;

   _editor_lang = <span class="string">&quot;en&quot;</span>;

<span class="function-name">&lt;</span><span class="html-tag">/script</span><span class="function-name">&gt;</span></pre>

  <li>Include the "htmlarea.js" script:

  <pre class="code"

  ><span class="function-name">&lt;</span><span class="html-tag">script</span> <span class="variable-name">type=</span><span class="string">&quot;text/javascript&quot;</span> <span class="variable-name">src=</span><span class="string">&quot;/htmlarea/htmlarea.js&quot;</span><span class="function-name">&gt;</span><span class="paren-face-match">&lt;</span><span class="html-tag">/script</span><span class="paren-face-match">&gt;</span></pre>

  </li>

  <li><p>If you want to change all your &lt;textarea&gt;-s into

  HTMLArea-s then you can use the simplest way to create HTMLArea:</p>

  <pre class="code"

  ><span class="function-name">&lt;</span><span class="html-tag">script</span> <span class="variable-name">type=</span><span class="string">&quot;text/javascript&quot;</span> <span class="variable-name">defer=</span><span class="string">&quot;1&quot;</span><span class="function-name">&gt;</span>

    HTMLArea.replaceAll<span class="function-name">()</span>;

<span class="paren-face-match">&lt;</span><span class="html-tag">/script</span><span class="paren-face-match">&gt;</span></pre>

  <p><span class="note">Note:</span> you can also add the

  <code>HTMLArea.replaceAll()</code> code to the <code>onload</code>

  event handler for the <code>body</code> element, if you find it more appropriate.</p>

  <p>A different approach, if you have more than one textarea and only want

  to change one of them, is to use <code>HTMLArea.replace("id")</code> --

  pass the <code>id</code> of your textarea.  Do not use the

  <code>name</code> attribute anymore, it's not a standard solution!</p>

</ol>

<p>This section applies to HTMLArea-3.0 release candidate 1 or later; prior

to this version, one needed to include more files; however, now HTMLArea is

able to include other files too (such as stylesheet, language definition

file, etc.) so you only need to define the editor path and load

"htmlarea.js".  Nice, eh? ;-)</p>

<h3>I want to change the editor settings, how do I do that?</h3>

<p>While it's true that all you need is one line of JavaScript to create an

htmlArea WYSIWYG editor, you can also specify more config settings in the

code to control how the editor works and looks.  Here's an example of some of

the available settings:</p>

<pre class="code"

><span class="keyword">var</span> <span class="variable-name">config</span> = <span class="keyword">new</span> HTMLArea.Config(); <span class="comment">// create a new configuration object

</span>                                    <span class="comment">// having all the default values

</span>config.width = '<span class="string">90%</span>';

config.height = '<span class="string">200px</span>';