.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============ EXT: tinyRTE ============ :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Thomas Schulze :Changed: 2007-05-08T21:27:09 :Author: Thomas Schulze [outraxX] :Email: kontakt@outraxx.de :Info 3: :Info 4: .. _EXT-tinyRTE: EXT: tinyRTE ============ Extension Key: **tinyrte** Copyright 2000-2002, Thomas Schulze [outraxX], This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: tinyRTE 1** **Introduction 1** What does it do? 1 Screenshots 1 **Users manual 2** FAQ 2 **Adminstration 2** **Configuration 4** **Known problems 4** **Button list 5** **To-Do list 6** **Changelog 6** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension provides a brand new Rich-Text-Editor for Typo3. .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-1| .. _Users-manual: Users manual ------------ For handle this Extension by a user, there is nothing to say but use it like Microsoft Word or OpenOffice-Writer ;-) .. _FAQ: FAQ ^^^ No FAQ´s of users at this time. .. _Adminstration: Adminstration ------------- There are some options you can give via TSconfig. Some of them are used by other RTE, some are only for tinyRTE. You define it with RTE.default. and one of the following option: **RTE.default.** .. ### BEGIN~OF~TABLE ### .. _disabled: disabled ^^^^^^^^ .. container:: table-row Option disabled Type boolean Description This disabled the RTE if set to true. .. _showButtons: showButtons ^^^^^^^^^^^ .. container:: table-row Option showButtons Type string Description A comma-separated value of Buttons to show. This can easier configured in the BE-User or BE-Group. But if needed of course in TSconfig .. _hideButtons: hideButtons ^^^^^^^^^^^ .. container:: table-row Option hideButtons Type string Description Similar to showButtons. This override the value in showButton. .. _disableColorPicker: disableColorPicker ^^^^^^^^^^^^^^^^^^ .. container:: table-row Option disableColorPicker Type boolean Description If set to true, both, foreground and background colorpicker are disabled. .. _cssFile: cssFile ^^^^^^^ .. container:: table-row Option cssFile Type string Description Path and Filename to a new CSS-File, used in the RTE-Selectorbox .. _classes: classes ^^^^^^^ .. container:: table-row Option classes Type string Description Classes to use from the CSS-File. If this Option not given, all classes found in the CSS-File are available in the selectorbox.Example: Header 1=header1;Header 2=header2 .. _fontFace: fontFace ^^^^^^^^ .. container:: table-row Option fontFace Type string Description Here you can enable Fontfaces for the RTE.Example: Arial=arial,helvetica,sans-serif;Courier New=courier new,courier,monospace .. _buttonlist: buttonlist ^^^^^^^^^^ .. container:: table-row Option buttonlist Type string Description You can define here the 4 possible rows of the RTE. You can do this in the “old” way per handwork (see Button-List later) or by using the Configurator on `tinyrte.outraxx.de `_ . A semicolon separates the 4 rows, a pipe define a Separator and a comma separate the buttons. .. _templates: templates ^^^^^^^^^ .. container:: table-row Option templates Type string Description If you enable the Template-Button for the User you can define some Templates he ca use. To test this, insert the following code in you TSconfig: RTE.default.templates.path=typo3conf/ext/tinyrte/ RTE.default.templates.items { Template { src=template\_sample.php description=a simple Template } Snippet { src=snippet\_sample.php description=a simple snippet } } RTE.default.templates.replace { username=realName email=email } Now enable the Template-Button for the user and place it in one of the 4 possible rows. Call this function by click on the Button and select “Template” in the selectorbox.The path in *RTE.default.templates.path* should be the path to the Extension. "typo3conf/ext/tinyrte/" if the Extension is as local installed, "typo3/ext/tinyrte/" if the Extension is as global installed. .. _initial: initial ^^^^^^^ .. container:: table-row Option initial Type string Description Here you can define all values from the initialconfiguration. So you can configure the RTE completely via TSconfig to share the same configuration with other Typo3-Instances. For naming look at the table “Configuration”. RTE.default.initial { MCEconvert\_fonts\_to\_spans=0 } .. _addParams: addParams ^^^^^^^^^ .. container:: table-row Option addParams Type string Description Since version 1.6.4 there is no fixed preconfiguration. With “addParams” you can give any option which TinyMCE (the core) understand. Therefore you can look at `http://wiki.moxiecode.com/index.php/TinyMCE:Configuration `_ . Example: **verify\_html=false** Of course there is a preconfiguration to prevent tinyRTE works after install: RTE.default.addParams { cleanup=true remove\_script\_host=false relative\_urls=false theme\_advanced\_toolbar\_location="top" theme\_advanced\_toolbar\_align="left" theme\_advanced\_statusbar\_location="bottom" extended\_valid\_elements="form[method\|action],input[type\|name],sele ct[name],option[value\|selected],hr[class\|width\|size\|noshade],help" verify\_html=true cleanup\_on\_startup=true apply\_source\_formatting=true spellchecker\_languages="+Deutsch=de,Englisch=en" } These parameters can be override in TSconfig. .. ###### END~OF~TABLE ###### Note: The TSconfig override all other Values! To enable given Buttons per TSconfig or in the Extension-Manager- Section you can use the function in BE-User and/or BE-Group, where setups in Groups override the setup in User. Open a BE-User or a BE- Group, you will see following: |img-2| Just click the Button the User/Group should have. For more than one Button hold the CTRL-Button on your keyboard. To disable all selected Buttons click the first entry and save the setup. Note that you have to put a Button you enable here in one of the 4 possible Rows via TSconfig or in the Extension-Manager. Otherwise this will not have an effect. .. _Configuration: Configuration ------------- Just install the RTE over the Extension Manager or download the .t3x- package from typo3.org (Extension-Key: tinyrte). Please make sure, that no other RTE is running. Deinstall some other RTE before you install tinyRTE. While installing you can a little bit configure RTE: .. ### BEGIN~OF~TABLE ### .. _Styles: Styles ^^^^^^ .. container:: table-row Option Styles Description You can give here a CSS-File that contains Stylesheets. Later i will show you to select one out of this file to provide in the RTE. But make sure this styles are available in FE, too. .. _RTE-Width: RTE-Width ^^^^^^^^^ .. container:: table-row Option RTE-Width Description This is the initial width of the RTE in Backend. .. _RTE-Height: RTE-Height ^^^^^^^^^^ .. container:: table-row Option RTE-Height Description Similar to RTE-Width. .. _Visible-Buttons: Visible Buttons ^^^^^^^^^^^^^^^ .. container:: table-row Option Visible Buttons Description You can define here the 4 possible rows of the RTE. You can do this in the “old” way per handwork (see Button-List later) or by using the Configurator on `tinyrte.outraxx.de `_ . A semicolon separates the 4 rows, a pipe define a Separator and a comma separate the buttons. .. _Entities: Entities ^^^^^^^^ .. container:: table-row Option Entities Description You can give here some entities to use instead of characters .. _Fonts: Fonts ^^^^^ .. container:: table-row Option Fonts Description Available fonts in the fontlist of the RTE. Example: font\_family1=font1,font2,font3; font\_family2=font1,font2,font3 .. _Date-Format: Date-Format ^^^^^^^^^^^ .. container:: table-row Option Date-Format Description The Format used by insert the Date via plugin “datetime”, button date. For naming see some php-manual. .. _Time-Format: Time-Format ^^^^^^^^^^^ .. container:: table-row Option Time-Format Description Similar to Date-Format. .. _Invalid-elements: Invalid elements ^^^^^^^^^^^^^^^^ .. container:: table-row Option Invalid elements Description Tags you don´t wont have in the source of the RTE-Content. It will be filtered. .. _force-p-newlines: force\_p\_newlines ^^^^^^^^^^^^^^^^^^ .. container:: table-row Option force\_p\_newlines Description This option enables you to disable/enable the creation of paragraphs on return/enter in Mozilla/Firefox. The default value of this option is true. .. _force-br-newlines: force\_br\_newlines ^^^^^^^^^^^^^^^^^^^ .. container:: table-row Option force\_br\_newlines Description If you set this option to true, tinyRTE will force BR elements on newlines instead of inserting paragraphs. .. _convert-newlines-to-brs: convert\_newlines\_to\_brs ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Option convert\_newlines\_to\_brs Description If you set this option to true newline characters codes gets converted in to br elements. .. _convert-fonts-to-spans: convert\_fonts\_to\_spans ^^^^^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Option convert\_fonts\_to\_spans Description If you set this option to true the -Tag will be replaced as . .. _Resizing: Resizing ^^^^^^^^ .. container:: table-row Option Resizing Description This option gives you the ability to enable/disable the resizing button. .. _Resizing-horizontal: Resizing horizontal ^^^^^^^^^^^^^^^^^^^ .. container:: table-row Option Resizing horizontal Description This option gives you the ability to enable/disable the horizontal resizing. .. _Use-compressed-Script: Use compressed Script ^^^^^^^^^^^^^^^^^^^^^ .. container:: table-row Option Use compressed Script Description Serverside GZip compresses TinyMCE to reduce overall download size. Makes TinyMCE 75% smaller and a lot faster to load. .. ###### END~OF~TABLE ###### Notice: You can override all these options in TSconfig. This is the simple way to copy one configuration between other Typo3-Instances. See Table above (“Administration”). .. _Known-problems: Known problems -------------- Are there problems? ;-) .. _Button-list: Button list ----------- Here is the Button list. If you don´t use the Buttonconfigurator on `tinyrte.outraxx.de `_ you have to configure this by Handwork. Therefore you have to know the naming of the buttons: .. ### BEGIN~OF~TABLE ### .. _img-3: |img-3| ^^^^^^^ .. container:: table-row a |img-3| b newdocument c |img-4| d bold e |img-5| f italic .. _img-6: |img-6| ^^^^^^^ .. container:: table-row a |img-6| b underline c |img-7| d strikethrough e |img-8| f sub .. _img-9: |img-9| ^^^^^^^ .. container:: table-row a |img-9| b sup c |img-10| d justifyleft e |img-11| f justifycenter .. _img-12: |img-12| ^^^^^^^^ .. container:: table-row a |img-12| b justifyright c |img-13| d justifyfull e |img-14| f cut .. _img-15: |img-15| ^^^^^^^^ .. container:: table-row a |img-15| b copy c |img-16| d paste e |img-17| f pastetext .. _img-18: |img-18| ^^^^^^^^ .. container:: table-row a |img-18| b pasteword c |img-19| d search e |img-20| f replace .. _img-21: |img-21| ^^^^^^^^ .. container:: table-row a |img-21| b bullist c |img-22| d numlist e |img-23| f outdent .. _img-24: |img-24| ^^^^^^^^ .. container:: table-row a |img-24| b indent c |img-25| d undo e |img-26| f redo .. _img-27: |img-27| ^^^^^^^^ .. container:: table-row a |img-27| b typo3link c |img-28| d unlink e |img-29| f anchor .. _img-30: |img-30| ^^^^^^^^ .. container:: table-row a |img-30| b typo3image c |img-31| d table e |img-32| f visualaid .. _img-33: |img-33| ^^^^^^^^ .. container:: table-row a |img-33| b emotions c |img-34| d flash e |img-35| f advhr .. _img-36: |img-36| ^^^^^^^^ .. container:: table-row a |img-36| b hr c |img-37| d removeformat e |img-38| f charmap .. _img-39: |img-39| ^^^^^^^^ .. container:: table-row a |img-39| b ltr c |img-40| d rtl e |img-41| f print .. _img-42: |img-42| ^^^^^^^^ .. container:: table-row a |img-42| b insertdate c |img-43| d inserttime e |img-44| f preview .. _img-45: |img-45| ^^^^^^^^ .. container:: table-row a |img-45| b help c |img-46| d cleanup e |img-47| f code .. _img-48: |img-48| ^^^^^^^^ .. container:: table-row a |img-48| b forecolor c |img-49| d backcolor e |img-50| f spellchecker .. _img-51: |img-51| ^^^^^^^^ .. container:: table-row a |img-51| b zoom c |img-52| d insertlayer e |img-53| f absolute .. _img-54: |img-54| ^^^^^^^^ .. container:: table-row a |img-54| b moveforward c |img-55| d movebackward e |img-56| f visualchars .. _img-57: |img-57| ^^^^^^^^ .. container:: table-row a |img-57| b cite c |img-58| d abbr e |img-59| f acronym .. _img-60: |img-60| ^^^^^^^^ .. container:: table-row a |img-60| b del c |img-61| d ins e |img-62| f media .. _img-63: |img-63| ^^^^^^^^ .. container:: table-row a |img-63| b lorem c |img-64| d \| (pipe) e |img-65| f styleprops .. _img-66: |img-66| ^^^^^^^^ .. container:: table-row a |img-66| b template c For the Selectorboxes use: formatselect,fontselect,fontsizeselect,styleselect .. ###### END~OF~TABLE ###### .. _To-Do-list: To-Do list ---------- Yes... there is something to do. Through this point, the result of the tinyRTE (not TinyMCE), is only my job. My wish is to work together with other to provide the Typo3-Community a better, stable and more usefully RTE. .. _Changelog: Changelog --------- To see what changed in the different versions go to `http://tinyrte.outraxx.de/changelog0/ `_ |img-67| EXT: tinyRTE - 6 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 275 .. :id: Grafik1 .. :name: Grafik1 .. :width: 459 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 212 .. :id: Grafik2 .. :name: Grafik2 .. :width: 233 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik3 .. :name: Grafik3 .. :width: 20 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik4 .. :name: Grafik4 .. :width: 20 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik5 .. :name: Grafik5 .. :width: 20 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik6 .. :name: Grafik6 .. :width: 20 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik7 .. :name: Grafik7 .. :width: 16 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik8 .. :name: Grafik8 .. :width: 16 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik9 .. :name: Grafik9 .. :width: 20 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik10 .. :name: Grafik10 .. :width: 16 .. |img-11| image:: img-11.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik11 .. :name: Grafik11 .. :width: 16 .. |img-12| image:: img-12.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik12 .. :name: Grafik12 .. :width: 20 .. |img-13| image:: img-13.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik13 .. :name: Grafik13 .. :width: 16 .. |img-14| image:: img-14.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik14 .. :name: Grafik14 .. :width: 16 .. |img-15| image:: img-15.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik15 .. :name: Grafik15 .. :width: 20 .. |img-16| image:: img-16.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik16 .. :name: Grafik16 .. :width: 16 .. |img-17| image:: img-17.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik17 .. :name: Grafik17 .. :width: 16 .. |img-18| image:: img-18.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik18 .. :name: Grafik18 .. :width: 20 .. |img-19| image:: img-19.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik19 .. :name: Grafik19 .. :width: 16 .. |img-20| image:: img-20.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik20 .. :name: Grafik20 .. :width: 16 .. |img-21| image:: img-21.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik21 .. :name: Grafik21 .. :width: 20 .. |img-22| image:: img-22.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik22 .. :name: Grafik22 .. :width: 16 .. |img-23| image:: img-23.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik23 .. :name: Grafik23 .. :width: 16 .. |img-24| image:: img-24.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik24 .. :name: Grafik24 .. :width: 20 .. |img-25| image:: img-25.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik25 .. :name: Grafik25 .. :width: 16 .. |img-26| image:: img-26.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik26 .. :name: Grafik26 .. :width: 16 .. |img-27| image:: img-27.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik27 .. :name: Grafik27 .. :width: 20 .. |img-28| image:: img-28.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik28 .. :name: Grafik28 .. :width: 16 .. |img-29| image:: img-29.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik29 .. :name: Grafik29 .. :width: 16 .. |img-30| image:: img-30.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik30 .. :name: Grafik30 .. :width: 20 .. |img-31| image:: img-31.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik31 .. :name: Grafik31 .. :width: 16 .. |img-32| image:: img-32.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik32 .. :name: Grafik32 .. :width: 16 .. |img-33| image:: img-33.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik33 .. :name: Grafik33 .. :width: 20 .. |img-34| image:: img-34.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik34 .. :name: Grafik34 .. :width: 16 .. |img-35| image:: img-35.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik35 .. :name: Grafik35 .. :width: 16 .. |img-36| image:: img-36.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik36 .. :name: Grafik36 .. :width: 20 .. |img-37| image:: img-37.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik37 .. :name: Grafik37 .. :width: 16 .. |img-38| image:: img-38.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik38 .. :name: Grafik38 .. :width: 16 .. |img-39| image:: img-39.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik39 .. :name: Grafik39 .. :width: 20 .. |img-40| image:: img-40.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik40 .. :name: Grafik40 .. :width: 16 .. |img-41| image:: img-41.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik41 .. :name: Grafik41 .. :width: 16 .. |img-42| image:: img-42.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik42 .. :name: Grafik42 .. :width: 20 .. |img-43| image:: img-43.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik43 .. :name: Grafik43 .. :width: 16 .. |img-44| image:: img-44.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik44 .. :name: Grafik44 .. :width: 16 .. |img-45| image:: img-45.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik45 .. :name: Grafik45 .. :width: 20 .. |img-46| image:: img-46.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik46 .. :name: Grafik46 .. :width: 16 .. |img-47| image:: img-47.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik47 .. :name: Grafik47 .. :width: 16 .. |img-48| image:: img-48.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik48 .. :name: Grafik48 .. :width: 20 .. |img-49| image:: img-49.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik49 .. :name: Grafik49 .. :width: 16 .. |img-50| image:: img-50.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik50 .. :name: Grafik50 .. :width: 16 .. |img-51| image:: img-51.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik51 .. :name: Grafik51 .. :width: 20 .. |img-52| image:: img-52.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik52 .. :name: Grafik52 .. :width: 16 .. |img-53| image:: img-53.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik53 .. :name: Grafik53 .. :width: 16 .. |img-54| image:: img-54.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik54 .. :name: Grafik54 .. :width: 20 .. |img-55| image:: img-55.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik55 .. :name: Grafik55 .. :width: 16 .. |img-56| image:: img-56.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik56 .. :name: Grafik56 .. :width: 16 .. |img-57| image:: img-57.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik57 .. :name: Grafik57 .. :width: 20 .. |img-58| image:: img-58.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik58 .. :name: Grafik58 .. :width: 16 .. |img-59| image:: img-59.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik59 .. :name: Grafik59 .. :width: 16 .. |img-60| image:: img-60.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik60 .. :name: Grafik60 .. :width: 20 .. |img-61| image:: img-61.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik61 .. :name: Grafik61 .. :width: 16 .. |img-62| image:: img-62.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik62 .. :name: Grafik62 .. :width: 16 .. |img-63| image:: img-63.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik63 .. :name: Grafik63 .. :width: 20 .. |img-64| image:: img-64.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik64 .. :name: Grafik64 .. :width: 16 .. |img-65| image:: img-65.png .. :align: left .. :border: 0 .. :height: 16 .. :id: Grafik65 .. :name: Grafik65 .. :width: 16 .. |img-66| image:: img-66.png .. :align: left .. :border: 0 .. :height: 20 .. :id: Grafik66 .. :name: Grafik66 .. :width: 20 .. |img-67| image:: img-67.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102