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


==========================
TYPO3 tutorial for editors
==========================

:Author:
      Kasper Skårhøj

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

:Changed:
      2010-02-11T12:59:58

:Classification:
      typo3_tut

:Description:
      The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----

:Keywords:
      forEditors, forBeginners, tutorial

:Author:
      DocTeam (Susanne Moog)

:Email:
      typo3@susanne-moog.de

:Info 4:


:language (EN, DE, FR, NL, DK, ES, DK, ... ):
      EN

:Language:
      en


|img-1| |img-2| TYPO3 tutorial for editors - typo3\_tut


.. _TYPO3-tutorial-for-editors:

TYPO3 tutorial for editors
==========================

Extension Key: typo3\_tut

Language: en

Keywords: forEditors, forBeginners, tutorial

Copyright 2000-2008, DocTeam (Susanne Moog), <typo3@susanne-moog.de>

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

.. _Table-of-Contents:

Table of Contents
-----------------

`TYPO3 tutorial for editors 1
<#1.TYPO3%20tutorial%20for%20editors|outline>`_

**`Introduction 3 <#1.1.Introduction|outline>`_**

`What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_

**`Login 4 <#1.2.Login|outline>`_**

`Help within TYPO3 4 <#1.2.1.Help%20within%20TYPO3|outline>`_

**`Overview 5 <#1.3.Overview|outline>`_**

`Menu 5 <#1.3.1.Menu|outline>`_

`Page-Tree 6 <#1.3.2.Page-Tree|outline>`_

**`Working with content 7 <#1.4.Working%20with%20content|outline>`_**

`Creating Content 9 <#1.4.1.Creating%20Content|outline>`_

`Editing Content 9 <#1.4.2.Editing%20Content|outline>`_

`The Rich-Text-Editor 10 <#1.4.3.The%20Rich-Text-Editor|outline>`_

**`Working with images 12 <#1.5.Working%20with%20images|outline>`_**

**`Working with files 13 <#1.6.Working%20with%20files|outline>`_**

**`Working with pages 14 <#1.7.Working%20with%20pages|outline>`_**

**`Creating Pages 16 <#1.8.Creating%20Pages|outline>`_**

`1st way of adding a new page 16
<#1.8.1.1st%20way%20of%20adding%20a%20new%20page|outline>`_

`2nd way of adding a new page 16
<#1.8.2.2nd%20way%20of%20adding%20a%20new%20page|outline>`_

**`Working with languages 18
<#1.9.Working%20with%20languages|outline>`_**


.. _Introduction:

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


.. _What-does-it-do:

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

This basic tutorial for editors explains how to add or change content
on an existing website in TYPO3. It provides the most basic step-by-
step instructions to get the job done. This tutorial does not cover
all available functions, only the most common ones. To support the
translation to other languages see `http://wiki.typo3.org/typo3\_tut
<http://wiki.typo3.org/typo3_tut>`_

To report bugs go to `http://forge.typo3.org/projects/show/team-
docteam <http://forge.typo3.org/projects/show/team-docteam>`_

This extension is based on a tutorial extension written by Marlies
Cohen and a summary / excerpt in the wiki by Eikaa. Thanks to both!


.. _Login:

Login
-----

Let's start from the beginning. Make sure you have javascript and
cookies enabled or it will not work.

- Enter your domain name and "/typo3" into the address bar of your
  internet browser to get to the "log in" page of your site. For
  example: http://www.example.com/typo3.
  
  Now you will see a screen like this:
  
  |img-3| Figure 1

- In the Username box write your username

- In the Password box write your password

- and then press the [Login] button or [Enter].


.. _Help-within-TYPO3:

Help within TYPO3
^^^^^^^^^^^^^^^^^

Before we dive further into using TYPO3, I would like to make clear
again that even though this tutorial covers the basic features, there
are a lot more. Here's where you can learn more directly from within
your website:

- A very short description of buttons or functions appears if you hover
  with your mouse pointer over it.

- |img-4| A lot of times you will see a question mark next to an
  element. Hovering over it will pop up a little help window about the
  item or function it is next to.

- For a more extensive description use the  **manual** module in the
  help category in the menu.


.. _Overview:

Overview
--------

You are now in what is called the  **backend** of your site. Usually
all changes to the site's content are done here. Although there are
ways to perform frontend editing, this tutorial only covers backend
editing.

The backend is divided into  **three columns** (see Figure 2). The
first one [1] is the  **menu** , which is used to select the task you
want to perform. The second [2] column contains the  **page-tree** ,
which represents the hierarchy of the pages of the website. The third
column [3] is the  **work area** . The fourth area [4] will only be
there if you are using version 4.2 or higher, it is called
“docheader”. There you find for example the name of the user that is
logged in (you!) and the logout button. Use the logout button to close
TYPO3. TYPO3 will remember your last work area and come back to it on
the next log on.

What the visitors of the site see is referred to as the  **frontend**
= your website.

|img-5| Figure 2

By selecting "Page" in the first column, you will see a screen similar
to Figure 2.


.. _Menu:

Menu
^^^^

The menu has categories with several modules, in Figure 2 you can see
the categories  **Web** ,  **File. User tools, Admin tools** and
**Help** and for example the modules  **Page** ,  **View** ,
**Versioning** ,  **Filelist** plus some other and some help modules.
The categories and modules available to you depend on how the
administrator has setup your account.

The most used category is  **Web** and the therein contained module
**Page** . It allows you to create and edit webpages, manage different
languages and columns of content per page.

The  **View** module shows the frontend look of the current page
selected in the Page Tree.

The  **List** module provides low level access to database-records
appearing on a page.

The  **Versioning** module shows versioning and workspace.

Sometimes you will have a  **User** category here with a  **Task
Center** and / or a  **Setup** option.

This tutorial does not cover versioning, workspace, user, task center,
or setup.

Also quite important is the  **Filelist** module, it is used to store
all kinds of files like pictures, PDFs, etc. on the server.

All modules are explained in the **About modules** module in the help
category. Please note that the categories can be folded using the
little + / - buttons next to the name.


.. _Page-Tree:

Page-Tree
^^^^^^^^^

|img-6| Figure 3

In the page-tree you will see different icons:This is a **standard** page

This page is a **shortcut** , that means, if you visit this page in
the frontend you will be redirected to a different page.

This page is **not visible** in the frontend. It has **Hide Page**
enabled in the page properties.

This one is of the type **not in menu** . It has **Hide in Menu**
enabled in the page properties.

This is not so much a page but rather a **folder** , they are used to
store all kinds of items, for example news, newsletters, guest book
entries, etc.

Clicking on the plus sign expands the directory tree. Clicking on the
minus sign contracts the directory tree.

If you created a page and it doesn't appear in the page tree, try
reloading it.

Note that it makes a difference if you click on the icon or on the
name of the page. Clicking on the icon will produce a menu with page
specific options, while clicking on the name of the page will load the
page in the work area.

|img-7| Figure 4


.. _Working-with-content:

Working with content
--------------------

We will now discuss the work area of the page module, where most of
the work is usually done. Don't be scared by the many icons and
buttons, as they are somewhat redundant. Use the mouse to point and
not click (just hover) on any icon to see a little help text appear.
At first we'll discuss working with content, later we'll discuss how
to work with pages.

Figure 5 shows the work area of the page module after clicking on the
name of a page in the page tree. You can see three  **content
elements** in the  *normal* column.

|img-8| Figure 5

|img-9| Figure 6

The first and the third one are of the type  **text** [1 and 3], the second one is of the type  **text with image** [2]. We'll learn more about different content types later on, let's first see what the buttons are about:This icon represents the content element as a whole. Each content type
has a different icon. Clicking on it pops up a menu with content
element specific options.

Clicking on the pen lets us edit this element.

To create a new content element (also called a record) after an
existing content element or at the beginning of a column use one of
these icons, or

This icon that lets you create a new content element and choose where
you want to put it.

If you have more than one element in a column, you can move them
around using these arrows.

To hide or unhide an element use the light bulb. Notice how the third
element's main icon also shows that it is hidden, just like the page
icons do.

To see hidden elements at all, you must check this option

Finally, to remove an element as a whole you use the garbage can

In version 4.2 the general options are a bit shuffled around as you
can see in figure 7, but still have the same meaning as above:

|img-10| Figure 7


.. _Creating-Content:

Creating Content
^^^^^^^^^^^^^^^^

Once you have clicked to create a new content element, you will see a
page with various content types available for selection (Figure 8).
Note that the content type selections available to you are dependent
on the features you have installed in your TYPO3 system.

|img-11| Figure 8

In this image you can then select [1] which type of content you want
to have and then [2] where on the page it should appear (use the small
grey arrow). The second option is only visible if you haven't already
specified where you want to have it. In other words, to see position
selections, you must use the  **new content** icon at the top of the
page (Item 4, Figure 6).


.. _Editing-Content:

Editing Content
^^^^^^^^^^^^^^^

The work area for editing content is actually the same as for creating
it. I will now describe the different parts of it when working with a
**text w/ image** content element, because it covers both the
**text** and the  **images** content elements.

|img-12| Figure 9

The top area contains the header [1 in Figure 8] of the element, as
well as the type [2], which you can change. Be aware that changing a
*text w/ image* element to a  *text* element will cause it to lose all
pictures.

To save changes you made to the element use the floppy disk icon [3].
If you want to see the changes in the frontend use the floppy disk
with the magnifying glass, it will save the changes and pop up a
window displaying the page you're working on. Disable pop-up-blockers
for this site!

The [5] fifth icon will save the changes and go back to the regular
work area of the page module.

The [6] sixth icon will go back to the regular work area of the page
module without saving the changes.

The trash can [7] will delete the current content element.

The last icon with a small arrow [8] will undo the last change made to
this content element.


.. _The-Rich-Text-Editor:

The Rich-Text-Editor
^^^^^^^^^^^^^^^^^^^^

The editor is pretty much self explanatory, you have probably worked
with similar word processing software before. Depending on how the
site was set up, the buttons available to you will vary. Here's an
example:

|img-13| Figure 10

Common  **Rich Text Editor** (RTE) formatting options include:

**bold** and  *italic* writing

:sup:`super` and :sub:`sub` script

numbered and unordered lists

indent the paragraph

insert special character

if text is selected, this option lets you create a hyperlink, see
below

insert a table

search and replace

show HTML source, only helpful if you know html

remove unwanted formating, for example if you copy and paste from MS
Word or from another website

undo / redo

toggle borders (for tables, as is the whole row)


.. _Creating-a-link:

Creating a link
"""""""""""""""

|img-14| Figure 11

Once you have selected a word or more in the rich text editor and
clicked on the  **Link** icon, you have the following options:

Link to a page within the site, just click on the name

Link to a file from the filelist, more about files later on

Link to another website, just enter the websites address (URL) into
the appropriate field and  **set link**

Link to an email-address, just enter in the right field and  **set
link**

If you have selected an existing link, you can remove it with the
leftmost option,  **Remove Link** .


.. _Working-with-images:

Working with images
-------------------

|img-15| Figure 12

Most times you work with images either in the “text with image” or the “images only” content element, these cases are covered here. For working with images it can be helpful to activate the option  **Show secondary options** at the bottom of the page with the editform.A list of images currently visible on the page

select an image on the left and change the order with these arrows

select an image on the left and remove from the list

to add an image from the  **filelist'** on the server, use this folder
button

to directly upload an image for use in this content element only use
this field

place the images relative to the text

set a specific width and / or height for all images in this element

to turn the images into a link

to make the fullscreen size of an image available

set image quality

if you want to have a caption for an image put it in here, for
multiple images put each caption in one line

You will also see a text area for  **Alternative Text:** , it is
generally a good idea to write a couple of words describing each
picture in one line each. This is especially important for
accessibility requirements (for example, Section 508 compliance in the
US).


.. _Working-with-files:

Working with files
------------------

TYPO3 provides the  **filelist** module which can be used to store
files on the server. The files which are stored this way are available
in the  **link** section of the rich text editor and the image section
of various content elements. It is good practice not to upload the
files directly in the elements, but to use the filelist as you can
reuse the files you upload here instead of uploading them again and
again each time they are needed.

|img-16| Figure 13

select the filelist module

what usually is the page tree is now the file-tree, here you might see
one or more folders, clicking on the folder icon pops up a menu,
clicking on the name shows the folder's content in the work area

the list of files, clicking on the file icon pops up a menu, clicking
on the name opens the file

to add files to this folder use this button

to show thumbnails of images in this folder check this option

If this looks completely different on your site, your site is probably
using the extension `Media (DAM) (dam)
<http://typo3.org/extensions/repository/view/dam/current/>`_ to
organize files.


.. _Working-with-pages:

Working with pages
------------------

You have already learned about the page-tree, now we'll see how pages
are created, moved around, hidden and deleted. Here's the context menu
you get when clicking on the icon of a page:

|img-17| Figure 14

The first three options are commonly used functions:

**Show** opens the page in the View module (like your frontend view),
**Edit** in the Page module,  **New** will let you create new content
on that page or let you create a new page.

**Info** is not useful for editors.

**Copy** will, surprise, copy the entire page to the TYPO3 clipboard,
which is quite similar to the copy and paste you know from your
computer's operating system.

|img-18|  **Cut** will make it possible to move the page to an
entirely different place, by pasting it there. Once the page has been
cut, the pop up menu of a different page will have the following two
entries:

**Paste into** will put the page inside the page you clicked on, so
that it will appear as a child of that page in the page-tree.

**Paste after** will put it on the same level of the page-tree
hierarchy.

We will neither discuss  **Versioning** here, nor  **Send to
review/pub** .

The  **More options...** field will pop up yet another menu, with an
interesting option called  **Move page** .

|img-19|

Figure 15

Let me repeat that. Clicking on the icon of a page [1] will pop up a
menu, selecting More Options [2] will pop up another menu. Move page
[3] lets you select in the work area where the page should be moved,
by clicking on one of the grey arrows [4].

You can also move files and folders around easily via drag and drop.
You can move a page by dragging it with the mouse. If you drop it at
another page, you will get a popup window where you can decide if you
want to copy or move the page after or inside the page where you have
dropped the other one. Easy, isn't it?

The  **Hide** option makes the page unreachable in the frontend and
the  **Delete** option deletes the page altogether.


.. _Creating-Pages:

Creating Pages
--------------

Adding a new page can be done in 2 ways.


.. _1st-way-of-adding-a-new-page:

1st way of adding a new page
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

C |img-20| lick on any file icon in the page tree

Then from the drop down menu select new

|img-21| and press enter.

Now you will see this screen below in the 'work area' to the column
right.

|img-22| Figure 16

Clicking on any subitem of  **Create a new page** will bring up immediately the  **New page** information. Depending upon your selection you will create a page inside the current one (a subpage), after the current one (sibling) or you get a wizard where you can select the position of the page.
2nd way of adding a new page
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Click on any name of a page in the page tree

and the screen below will open in the work area to the right:

|img-23| Figure 17

Next click on the [New Page] button

|img-24| and you will see the ‘New record’ screen.

Now all you have to do is to select where you want to add the page in
the directory tree of your website. If you place it someplace by
mistake you can always move it later with the move page option or by
simply dragging it in the page tree.

Once you have decided where to place your new page, click on the
little grey file folder with the arrow |img-25| pointing to it and
your page will be inserted at this point.

|img-26| Figure 18

Once you have created a page, the top part of the page view provides
options as shown in Figure 19.

|img-27| Figure 19

Edit page properties gets you a work area with some page specific
options, such as Hide/Unhide, and you can enter a Navigation title so
that the page has a different title in the menu than on the page.

These Options are easier to reach if you want to Move pages around. As
you can see, a lot of times you can achieve the same things by
different means.

To create a New page, use this button, or the one from the context
menu. By default, the new page is hidden, so that you can create the
content of the page before making it publicly available. Don't forget
to Save the new page by using the floppy disk icons!


.. _Adding-Multiple-Pages-at-Once:

Adding Multiple Pages at Once
-----------------------------

If you want to add more than one page at a time you can use the
multiple page wizard.

|img-28|

- First select the folder where your new pages will be placed.

- Then from the  **Web Column** select  **Functions** and you will get
  the screen above

- Now fill in the names of your new pages. Only filled in fields will
  create a page.

- If you place a checkmark in the box  **Place new pages after the
  existing subpages** they will be added below the current pages. If you
  leave it blank the new pages will be placed before the current pages.

- Once you are done click the  **Create Pages** button.


.. _Working-with-languages:

Working with languages
----------------------

If your site is available in multiple languages, you want to have
different translations available of the same page. Here's what you
need to do:

In the top part of the Page module, you have a drop-down box, where
you select the  **Languages** option, as seen in Figure 16.

|img-29| Figure 20

If you want to make a new translation of an existing page you will
find a button  **Make new translation of this page:** [1] with a drop-
down menu of the available languages (see Figure 17). Choose the one
you want, then enterthe new translation of the pages name in the
Pagetitle and save.

|img-30| Figure 21

You can now copy the content of the page in the old language to the
new language [2]. This is quite useful if you have images you would
like to see in the new language version of the page.

You can also create an entirely new version of the page.

If this two column mode is a little confusing, you can go back to the
old view of the work area by selecting  **Columns** in the dropdown
menu, where you previously selected Languages.

Note that you can now switch between the different translations of the
page with another drop-down menu below the one you just used, as you
can see in Figure 22.

19


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

.. |img-1| image:: img-1.png
.. :align: left

.. |img-2| image:: img-2.png
.. :border: 0
.. :height: 21
.. :hspace: 9
.. :id: Grafik2
.. :name: Grafik2
.. :width: 87

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 261
.. :id: Grafik1
.. :name: Grafik1
.. :width: 453

.. |img-4| image:: img-4.png
.. :align: left
.. :border: 0
.. :height: 17
.. :id: Grafik10
.. :name: Grafik10
.. :width: 17

.. |img-5| image:: img-5.png
.. :align: left
.. :border: 0
.. :id: Grafik3
.. :name: Grafik3
.. :width: 100%

.. |img-6| image:: img-6.png
.. :align: left
.. :border: 0
.. :height: 269
.. :id: Grafik6
.. :name: Grafik6
.. :width: 221

.. |img-7| image:: img-7.png
.. :align: left
.. :border: 0
.. :id: Grafik4
.. :name: Grafik4
.. :width: 100%

.. |img-8| image:: img-8.png
.. :align: left
.. :border: 0
.. :height: 651
.. :id: Grafik8
.. :name: Grafik8
.. :width: 408

.. |img-9| image:: img-9.png
.. :align: left
.. :border: 0
.. :height: 650
.. :id: Grafik9
.. :name: Grafik9
.. :width: 441

.. |img-10| image:: img-10.png
.. :align: left
.. :border: 0
.. :id: Grafik5
.. :name: Grafik5
.. :width: 100%

.. |img-11| image:: img-11.png
.. :align: left
.. :border: 0
.. :id: Grafik7
.. :name: Grafik7
.. :width: 100%

.. |img-12| image:: img-12.png
.. :align: left
.. :border: 0
.. :height: 176
.. :id: Grafik11
.. :name: Grafik11
.. :width: 600

.. |img-13| image:: img-13.png
.. :align: left
.. :border: 0
.. :height: 341
.. :id: Grafik12
.. :name: Grafik12
.. :width: 415

.. |img-14| image:: img-14.png
.. :align: left
.. :border: 0
.. :height: 312
.. :id: Grafik13
.. :name: Grafik13
.. :width: 448

.. |img-15| image:: img-15.png
.. :align: left
.. :border: 0
.. :id: Grafik15
.. :name: Grafik15
.. :width: 100%

.. |img-16| image:: img-16.png
.. :align: left
.. :border: 0
.. :id: Grafik14
.. :name: Grafik14
.. :width: 100%

.. |img-17| image:: img-17.png
.. :align: left
.. :border: 0
.. :id: Grafik16
.. :name: Grafik16
.. :width: 100%

.. |img-18| image:: img-18.png
.. :align: left
.. :border: 0
.. :height: 56
.. :id: Grafik17
.. :name: Grafik17
.. :width: 155

.. |img-19| image:: img-19.png
.. :align: left
.. :border: 0
.. :id: Grafik18
.. :name: Grafik18
.. :width: 100%

.. |img-20| image:: img-20.png
.. :align: left
.. :border: 0
.. :height: 14
.. :hspace: 5
.. :id: Graphic41
.. :name: Graphic41
.. :width: 12

.. |img-21| image:: img-21.png
.. :align: left
.. :border: 0
.. :height: 14
.. :id: Grafik24
.. :name: Grafik24
.. :width: 130

.. |img-22| image:: img-22.png
.. :align: left
.. :border: 0
.. :height: 159
.. :id: Grafik21
.. :name: Grafik21
.. :width: 241

.. |img-23| image:: img-23.png
.. :align: left
.. :border: 0
.. :height: 335
.. :id: Grafik22
.. :name: Grafik22
.. :width: 491

.. |img-24| image:: img-24.png
.. :align: left
.. :border: 0
.. :height: 38
.. :id: Grafik23
.. :name: Grafik23
.. :width: 79

.. |img-25| image:: img-25.png
.. :align: left
.. :border: 0
.. :height: 9
.. :hspace: 5
.. :id: Graphic53
.. :name: Graphic53
.. :vspace: 5
.. :width: 37

.. |img-26| image:: img-26.png
.. :align: left
.. :border: 0
.. :height: 222
.. :id: Grafik25
.. :name: Grafik25
.. :width: 191

.. |img-27| image:: img-27.png
.. :align: left
.. :border: 0
.. :height: 184
.. :id: Grafik20
.. :name: Grafik20
.. :width: 406

.. |img-28| image:: img-28.png
.. :align: left
.. :border: 0
.. :height: 369
.. :id: Grafik26
.. :name: Grafik26
.. :width: 669

.. |img-29| image:: img-29.png
.. :align: left
.. :border: 0
.. :id: Grafik19
.. :name: Grafik19
.. :width: 100%

.. |img-30| image:: img-30.png
.. :align: left