From: Yves K. <yku...@us...> - 2004-10-25 00:43:09
|
Update of /cvsroot/phpwebsite-comm/modules/xwysiwyg/mod/xwysiwyg/docs In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv14287/modules/xwysiwyg/mod/xwysiwyg/docs Added Files: install_de.txt install_en.txt Log Message: Initial Revision --- NEW FILE: install_en.txt --- Preface: The xwysiwyg-module requires severe changes in the 'Core' files of phpWebSite. You should only install this module if you are experienced with PHP and phpWebSite. If you upgrade phpWebSite after installing the xwysiwyg-module it could be that the module does not function properly. In contrast to other htmlArea hacks that were published previously you don't need to change other installed modules. Preparation: Backup -your database -the file /js/wysiwyg.php -theme.tpl of all themes you are using -theme.php of all themes you are using Installation: 1. Copy the xwysiwyg directory to the /mod directory of your phpWebSite installation 2. Replace /js/wysiwyg.php with the file from the xwysiwyg-module 3a. If you don't use theme.php so far replace theme.php in all your themes with the version provided with the xwysiwyg-module 3b. If you are using theme.php insert the xwysiwyg-code in theme.php of all your used modules 4. Insert the {XWYSIWYG} tag in theme.tpl before the {JAVASCRIPT} tag (needs to be done for every theme you are using) 5. Insert the {XWYSIWYG_BODY} tag in theme.tpl inside the body-tag; Eg:"<body{XWYSIWYG_BODY}>" (needs to be done for every theme you are using) 6. Install the xwysiwyg-modul as usual with BOOST Note: the provided theme files are for the default theme. If you did a standard install of phpWebSite you can copy these files to your /themes/Default directory and replace the original files. Deinstallation: 1. Deinstall the module with BOOST The modified files should not interfere with the normal operation of phpWebSite but if you want to be on the safe side you should copy your backed up files to their directories (you did make a backup, eh?). Usage: Be sure that all HTML tags you want to use with htmlArea are allowed in /conf/textSettings.php. You can change some settings of the xwysiwyg-module using the controlpanel of phpWebSite. There You can select if you prefer working with HtmlArea or FCKeditor. You can specify if the tool is only available for registered users or if you want to allow anonymous users to use it, too. Additionally you can specify if the tableoperations or contextmenu plugin for HtmlArea should be activated. Other plugins don't work with this module so far but may be available in a future release. Or select a Skin for FCKeditor. After installing the module everything is shown as usual but there is a new XW button in the wysiwyg panel. To activate xwysiwyg for a specified region you have to click this button. ATTENTION: all unsaved data will be lost! Hope you have fun using this module ykuendig <ph...@NO...> Special thanks to: Wendall Cada and Shaun Murry for the basic idea of the wysiwyg hack Christan <web...@NO...> for help by testing the module Thomas <tl...@NO...> for the translation to English. Version of 2004-10-23 --- NEW FILE: install_de.txt --- Vorwort: Das xwysiwyg-Modul beinhaltet einen Eingriff in die 'Core'-Dateien des phpWebSite-Projekts. Installieren Sie dieses Modul nur, wenn Sie einige Erfahrung im Umgang mit PHP und phpWebSite haben. Sollte Sie nach der Installation dieses Moduls die phpWebSite upgraden, kann es sein, das das Modul nicht mehr ordnungsgemaess funktioniert. Entgegen den bisher veroeffentlichten htmlArea-Hacks, sind bei diesem Modul keine Eingriffe in die anderen installierten Module notwendig. Vorbereitung: Sichern Sie Ihre Datenbank. Sichern Sie die Datei /js/wysiwyg.php Sichern Sie die theme.tpl aller Ihrer benutzten Themen Sichern Sie die theme.php aller Ihrer benutzten Themen Installation: 1. Kopieren Sie das xwysiwyg-Verzeichnis ins /mod -Verzeichnis Ihrer phpWebSite 2. Ersetzten Sie die /js/wysiwyg.php Wenn Sie bisher keine theme.php benutzt haben: 3a. Ersetzten Sie die theme.php Datei in allen Ihren Themen (alle welche xwysiwyg nutzen sollen) Wenn Sie bereits theme.php benutzen: 3b. Fuegen Sie den xwysiwyg-Code in Ihre theme.php ein (ALLE welche xwysiwyg nutzen sollen) 4. Fuegen Sie das {XWYSIWYG}-Tag in Ihre theme.tpl vor dem {JAVASCRIPT}-Tag ein (alle welche htmlarea nutzen sollen) 5. Fuegen Sie das {XWYSIWYG_BODY}-Tag in Ihre theme.tpl in den <body>-Tag ein; Bsp:"<body{XWYSIWYG_BODY}>" (alle welche xwysiwyg nutzen sollen) 6. Installieren Sie das xwysiwyg-Modul wie gewohnt mit BOOST Hinweis: die beigepackten Theme-Dateien entsprechen dem Default-Thema. Sollten Sie eine Standard-Installation erstellt haben, koennen Sie die beiden Dateien im beiliegenden Default-Verzeichnis in Ihr /themes/Default/ Verzeichnis kopieren und die dortigen Dateien ueberschreiben. Deinstallation: 1. Deinstallieren Sie das Modul mit BOOST Die anderen (angepassten) Dateien sollten den Betrieb der phpWebSite nicht weiter stoeren, wenn Sie jedoch ganz sicher gehen moechten kopieren Sie die gesicherten Dateien zurueck. (Sie habe ja ein Backup gemacht. ODER?) Verwendung: Achten Sie darauf, dass alle HTML-Tags, die Sie mit xwysiwyg verwenden moechten, auch in der /conf/textSettings.php als erlaubte HTML-Tags eingetragen sind. So ist z.B. noetig, das <FONT>-Tag einzutragen, wenn Sie mit Farben arbeiten wollen. Im Administrations-Bereich Ihrer phpWebSite koenne Sie einige Einstellungen am xwysiwyg-Modul vornehmen. Waehlen Sie dort den gewuenschten Editor aus (HtmlArea oder FCKeditor). Legen Sie dort fest, ob das Tool nur fuer angemeldete Benutzer oder auch anonymen Besuchern zur Verfuegung steht. Dort koennen Sie auch einstellen, ob das Tabellen- oder das Kontext-Menue-Plugin fuer HtmlArea aktiviert werden soll. Die weiteren Pugins funktionieren z.Z. nicht mit diesem Modul und werden ev. in einem spaeteren Release freigeschaltet. Fuer den FCKeditor koennen Sie die Oberflaeche auswaehlen. Nachdem das Modul installiert ist, wird alles wie bisher angezeigt. Einzig ein neuer XW-Button in der wysiwyg-Symbolleiste ist zu sehen. Um nun xwysiwyg fuer einen bestimmten Bereich zu aktivieren, klicken Sie auf den Button. Achtung: Alle ungespeichert Daten gehen verloren! Nun viel Spass mit diesem Modul ykuendig <ph...@NO...> Spezieller Dank geht an: Wendall Cada und Shaun Murry fuer die Basis-Idee des Wysiwyg-Hacks. Christan <web...@NO...> fuer die Mithilfe bei den Tests. Thomas <tl...@NO...> for the translation to English. Version vom 23.10.2004 |