CMFVisualEditor

Installationsanleitung gesucht - FloK, 05-30

Dies ist die Datei #instructions.txt# des Produkts: (fehlerhaft im orginal??)

It has functions to build the most common HTML structures: tables, links, formatted text, images, numbered lists and non-numbered lists, etc. However there are no functions for frames and forms.

It has been tested with Netscape 4.76 and Explorer 5.0

It can be used in three different languages: cathalan (the language from Catalonia in Spain), spanish and english. Language can be easily changed by just modifying the value of a parameter in the page where the editor is embedded.

If you have any doubt or suggestion you can contact .

INDEX ===== 0.- Introduction

- Installation
- Embedded use of wysiwyg_web_edit.
- Multiple wysiwyg_web_edit's in one page.
- wysiwyg_web_edit without PHP.
- Save function.
- Server reception of the HTML code.
- Known Bugs.

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

- Introduction

wysiwyg_web_edit consists in an ActiveX? control (Dhtmled.ocx) supplied in the standard installation of Explorer 5.0 and higher, which is run on Netscape using a plug-in specifically dessigned to run ActiveX? controls on Netscape. (This plug-in has been developed by Esker Software (www.esker.com) and it is a free distribution software. Read chapter 1.- Installation of this document for further information).

Moreover, it has a toolbar which act on the edition area using JavaScript? code. This code acts on the ActiveX? control through the plug-in, controlling what is displayed in the edition area. Thus, edition is completely WYSIWYG and really comparable to the most common text editors.(Even the cut, copy and paste functions are OLE compatible so you can paste typical office objects as datasheets or formatted text.)

Once you have created the page, the THML code can be easily accessed by a JavaScript? function specified in one of the PHP parameter which are passed to the wysiwyg_web_edit PHP script.

The wysiwyg_web_edit's page is dinamically generated in the server according to the configuration specified in the page where the wysiwyg_web_edit is embedded. This configuration is detailed in chapter 2.- Embedded use of wysiwyg_web_edit of this document. To implement this we have used PHP as a server-side language.

Once the editor has been loaded (with the plug-in), the client can use all the functionalities. What will be done when the client clicks on Save button depends on the save function specified in the $funcio_save parameter or the page specified in the $action_submit parameter.

For instance, the HTML code can be send (by submit or in the url) to a page in the server and there can be stored in a database. Thus, wysiwyg_web_edit is a powerful tool to manage a website using a database.

wysiwyg_web_edr = "/absolute_path/wysiwyg_web_edit/"; // Abolute path (for the web pages server), of wysiwyg_web_edit in the server. This is essential fo the PHP script to be able to include the necessary files.

The application needs at least PHP 3.0 in the server. If you don't have PHP there is a no configurable version written exclusively in HTML and JavaScript?. See chapter 4.- wysiwyg_web_edit without PHP of this document for further information.

REMARK: all the PHP files of the application have *.h3p extension because this is the extension our apache server uses to recognize which files should be parsed by PHP.

If you are using another extension (for example php3 ) you should:

a) Change the extensions of all the files *.h3p to your PHP extension.

b) Replace the string .h3p by your extension in all the files of the application.

Or, perhaps more simple, you can configure your web server to recognize .h3p as a PHP extension.

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

- Embedded use of wysiwyg_web_edit

In order to use the wysiwyg_web_edit embedded in your page you should the following:

A) In the PHP document where you are embedding the wysiwyg_web_edit you should put the parameters lists. The list and signification of the parameters is the following :

$nom_editor = "Editor_1"; // Name o

wysiwyg_web_edit 1.0 - Readme_english.txt for wysiwyg_web_edit editor developed at Universitat Internacional de Catalunya (www.unica.edu) (16/07/2001), starting from the contributions of Fernando ?lvarez ().

The wysiwyg_web_edit editor is a web-based WYSIWYG HTML editor dessigned to generate HTML code from a WYSIWYG view so you don't need to know HTML to use it. You can embed it in your web pages so it can improve significantly your web-applications, specially if you want common users to contribute in the content management task. It runs on both Netscape and Explorer browsers.

You can transfer the generated HTML code directly to the server by submiting it. Then you can easily store it in your database.

It can be used as an independent application or embedded in any web page, and it is configurable by the programmer who is embedding it in one of his pages.

The wysiwyg_web_edit is written in HTML and Javascript, and it uses PHP as a server-side language.( Though there is a version written exclusively in Javascript and HTML. See chapter 4.- wysiwyg_web_edit without PHP of this document for further information).

You can embed multiple instances of the editor in the same page.( See chapter '3.- Multiple ns-editor's in one page' of this document for further information).

It has functions to build the most common HTML structures: tables, links, formatted text, images, numbered lists and non-numbered lists, etc. However there are no functions for frames and forms. It has been tested with Netscape 4.76 and Explorer 5.0

If you have any doubt or suggestion you can contact .

- Introduction

Once you have created the page, the THML code can be easily accessed by a JavaScript? function specified in one of the PHP parameter which are passed to the wysiwyg_web_edit PHP script.

wysiwyg_web_edr = "/absolute_path/wysiwyg_web_edit/"; // Abolute path (for the web pages server), of wysiwyg_web_edit in the server. This is essentialthe var iable code code = escape(code) document.location = "save.h3p?htmlcode=" + code return true }

b) If in the parametrization you give a value for $action_submit, when the user click on Save button the code wil