.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


=====================
EXT: RTE Dummy Plugin
=====================

:Author:
      Fabien Udriot

:Created:
      2002-11-01T00:32:00

:Changed:
      2008-05-15T08:00:43

:Keywords:
      RTE dummy plugin

:Email:
      fabien.udriot@ecodev.ch

:Info 2:


:Info 3:


:Info 4:


:Author:
      Fabien Udriot

:Email:
      fabien.udriot@ecodev.ch


.. _EXT-RTE-Dummy-Plugin:

EXT: RTE Dummy Plugin
=====================

Extension Key:  **rtehtmlarea\_dummyplugin**

Copyright 2006-2008, Fabien Udriot, <fabien.udriot@ecodev.ch>

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: RTE Dummy Plugin 1**

**Introduction 1**

What does it do? 1

Screenshots 1

Installation 2

Further documentation 2

**Known problems 2**

**Changelog 2**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

This extension add a new icon onto the RTE rtehtmlarea. In TYPO3 4.2
rtehtmlarea has been improved and can be easily extended with new
plugins. This dummy plugin can spare you some learning time by having
something runnable quickly that you can adapt to your need. This
extension needs some TypoScript configuration before the new button is
displayed in the RTE. See the installation section.

Use the manal of extension "rtehatmlare\_api\_manual", to know more
about the rtehtmlarea API.


.. _Screenshots:

Screenshots
^^^^^^^^^^^

The extension add a new icon. The look & fill of the editor comes from
extension modern\_skin.

|img-1|


.. _Installation:

Installation
^^^^^^^^^^^^

Read carefully this section!

Firstly, download and install the extension as usually by the mean of
the Extensions Manager.

Secondly, you need to  **add some TypoScript** in a page. Most likely
it will be the root page. Do as follow: right click on the root page
in the tree > edit page property then add something like this in the
field TSConfig:

::

   RTE.default.showButtons = *
   RTE.default.toolbarOrder = dummyplugin, ..., ...., ....

At this point you should have a new button in your RTE. You can start
editing the PHP and the javascript.

Beware that TYPO3 creates temporary javascript files for rtehtmlarea.
Typically the files are stored in
/typo3temp/rtehtmlarea/Dummyplugin\_333421213.js and are not
automatically updated when you edit the javascript source.

In the developing process, you can edit the temporary files and do a
copy / paste to source file when the javascript is OK.


.. _Further-documentation:

Further documentation
^^^^^^^^^^^^^^^^^^^^^

\- extension key "rtehtmlarea\_api\_manual": very useful, contains
necessary informations

\- extension key "rtehtmlarea\_manual": same as the manual of the
system extension

\- typo3\_src-4.\*/typo3/sysext/rtehtmlareauseful : RTE plugin
examples


.. _Known-problems:

Known problems
--------------

Please report the problem you might meet to `fabien.udriot@ecodev.ch
<mailto:fabien.udriot@ecodev.ch>`_


.. _Changelog:

**Changelog**
-------------

.. ### BEGIN~OF~TABLE ###


.. _0-1:

0.1
^^^

.. container:: table-row

   Version
         0.1
   
   Date
         May 08
   
   Comments and Changes
         Initial release, by Fabien Udriot


.. ###### END~OF~TABLE ######

EXT: RTE Dummy Plugin - 2


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 132
.. :id: graphics1
.. :name: graphics1
.. :width: 564