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


===========
Lorem Ipsum
===========

:Author:
      Kasper Skårhøj

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

:Changed by:
      Kasper Skårhøj

:Changed:
      2004-07-02T22:19:20

:Author:
      Kasper Skårhøj

:Email:
      kasper@typo3.com

:Info 3:


:Info 4:


.. _Lorem-Ipsum:

Lorem Ipsum
===========

Extension Key:  **lorem\_ipsum**

Copyright 2004, Kasper Skårhøj, <kasper@typo3.com>

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
-----------------

**Lorem Ipsum 1**

**Introduction 1**

What does it do? 1

Screenshots 1

**Wizard Configuration 2**

**Manual 3**

Inserting "Lorem Ipsum..." 3

Dummy content for localized websites 3


.. _Introduction:

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


.. _What-does-it-do:

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

It provides a TCEform wizard for adding industry standard dummy text
to selected form fields in TYPO3. The dummy content is the classic
"Lorem ipsum dolor sit amet..." taken from the website "
`www.lipsum.org <http://www.lipsum.org/>`_ ". It also provides a
selection of 40 dummy pictures.


.. _Screenshots:

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

The extension will add wizard icons to all header, bodytext, caption,
description, keyword, title etc. fields of Content Elements and Pages:

|img-1|

By clicking the icons dummy text is put into the associated form
field.

Clicking images in the image matrix will add the image to the image
list and attached to the record when saved. Images are found in 7
different aspect ratios.


.. _Wizard-Configuration:

Wizard Configuration
--------------------

The basic configuration of the wizard in the "wizards" array of a TCA
field configuration is like this:

::

              // Create wizard configuration:
           $wizConfig = array(
                   'type' => 'userFunc',
                   'userFunc' => 'EXT:lorem_ipsum/class.tx_loremipsum_wiz.php:tx_loremipsum_wiz->main',
                   'params' => array()
           );

The "params" key has these key/value options:

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


.. _type:

type
^^^^

.. container:: table-row

   Key
         type
   
   Data Type
         string (keyword)
   
   Description
         Type of Lorem Ipsum text to add. Keywords are:
         
         - **title** : Adds a small amount (<25) characters of dummy text -
           fitting page titles.
         
         - **header** : Adds a medium amount of dummy text fitting headers for
           such as content elements (<60 chars)
         
         - **description** : Adds a large amount of dummy text, fitting
           descriptions, image captions etc.
         
         - **word** : Adds a single word of dummy text
         
         - **paragraph** : Adds a paragraph of dummy text. The paragraph is a
           handful of "description" length sentences.
         
         - **loremipsum** : Adds specifically "Lorem ipsum dolor sit amet"
         
         - **images** : (Only for "group" fields with "file" internal type)
           Creates a matrix with 42 dummy images to select.



.. _endSequence:

endSequence
^^^^^^^^^^^

.. container:: table-row

   Key
         endSequence
   
   Data Type
         comma list of integers
   
   Description
         What sequence of characters to end each dummy string with. That could
         be "46,32" for period and space. Or "10" for line break.



.. _add:

add
^^^

.. container:: table-row

   Key
         add
   
   Data Type
         boolean
   
   Description
         If true, the a click on the wizard button will  *append* the dummy
         text to the field. (Default behavior is to substitute all field
         content with dummy text.



.. _count:

count
^^^^^

.. container:: table-row

   Key
         count
   
   Data Type
         integer
   
   Description
         Number of dummy content samples to cycle through.
         
         Continously clicking the wizard icon will select other dummy text
         composites and this number points to the amount of options there are.
         Default is 10.


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


.. _Manual:

Manual
------


.. _Inserting-Lorem-Ipsum:

Inserting "Lorem Ipsum..."
^^^^^^^^^^^^^^^^^^^^^^^^^^

In records for pages, content elements and page overlay records you
simply click the "Lipsum" button to the right of input fields where
Lorem Ipsum applies. See screenshot above.


.. _Dummy-content-for-localized-websites:

Dummy content for localized websites
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you are developing localized websites it can be practical to insert
dummy content that is visually different from the default language. It
makes it easy for you to see if your application works correctly if
you use russian or asian characters as dummy data. It will even help
to expose places where you do not handle characters sets correctly.

You configure other types of dummy content than the default "Lorem
Ipsum" kind (which is totally ASCII based) in the System Language
records. All records that refer to this system language as their
language definition will now use that type of dummy content instead.

|img-2| Lorem Ipsum - 3


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

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 659
.. :id: Graphic2
.. :name: Graphic2
.. :width: 559

.. |img-2| image:: img-2.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102