Ознакомительный учебник¶

Об этом документе¶

Этот документ знакомит с основными понятиями TYPO3. Пример сайта, используемый в этом документе, поможет незамедлительно начать работать с Вашим первым сайтом на TYPO3. Изучив этот учебник Вы получите представление о возможностях TYPO3, общей структуре и возможностях ее расширений. Профессиональное создание шаблонов и разработка на TYPO3 по большей части не затрагивается в этом документе.

Нововведения¶

Предыдущая версия этого документа была известна как "Quickstart Tutorial".

Текущая версия взяла за основуTYPO3 IntroductionPackage дляTYPO3 версии 4.4. Это полностью новая версия. Затронутые темы слегка изменились для соответствия IntroductionPackage.

Составители¶

Изначально "Quickstart Tutorial" было написано Kasper Skårhøj. Текущая версия была написана Philipp Gampe, Martin Holtz, Susanne Moog и Francois Suter.

Обратная связь¶

По общим вопросам о документации, пишите на documentation@typo3.org .

Если найдена ошибка в этом руководстве, опишите проблему по данному руководству в системе отслеживания ошибок: http://forge.typo3.org/projects/typo3v4-doc_tut_quickstart

Поддержка качественной документации является тяжелой работой, и команде по документации всегда нужны добровольцы. Если Вы желаете помочь, присоединяйтесь к списку рассылок (typo3.projects.documentation на lists.typo3.org).

Примечания к переводу на русский язык¶

Все изображения внутреннего и внешнего интерфейсов взяты из версии 4.5.6 (актуальной на момент создания перевода версии). Для локализации внутреннего интерфейса (перевода его на русские или какой-либо еще язык) обратитесь к разделу "Изменение языка внутреннего интерфейса" главы "Краткие сведения о модуле управления расширениями" на стр. 143.

Начальные условия¶

Необходим полностью настроенный работающий веб сервере, отвечающий условиям, приведенным на :underline:`http://typo3.org/about/system- requirements/ <http://typo3.org/about/system-requirements/>`_

Если веб сервера нет, но Вы работаете под ОС Windows, можно установить :underline:`TYPO3Winstaller <http://typo3winstaller.sourceforge.net/>`_ , который установить и веб сервер, и Introduction Package на Ваш локальный компьютер.

Получение Introduction Package¶

Сначала необходимо загрузить и установить introduction package, который используется для описания TYPO3 в этом учебнике. Загрузите пакет с :underline:`http://typo3.org/download/ <http://typo3.org/download/packages/>`_ . Для установки своего первого веб сайта, следуйте указаниям, приведенным в разделе быстрой установки :underline:`Руководства по установке и обновлению <http://typo3.org/documentation/document- library/installation/doc_inst_upgr/current/>`_ . При профессиональном использовании TYPO3, необходимо будет периодически обращаться к нему. Пошаговое руководство приведено ниже, в "кратком руководстве по установке".

Внутренний (Backend) и внешний (Frontend) интерфейсы¶

TYPO3 разделен на две области — внутренний (backend) и внешний (frontend) интерфейсы. В то время как внешний интерфейс — это все, что доступно из сети, сам веб сайт, создаваемый TYPO3, а внутренний интерфейс пока доступен лишь Вам — это административная часть веб сайта. Для того, чтобы попасть во внутренний интерфейс всегда необходима авторизация с именем пользователя и паролем. Позже Вы научитесь давать доступ ко внутреннему интерфейсу другим людям — редакторам содержимого и помощникам администратора.

Для перехода ко внешнему интерфейсу, введите в адресной строке браузера " http://www.your-site.example.org/ ". А пока перейдем ко внутреннему интерфейсу.

Перейдите во внутренний интерфейс своего вновь созданного сайта: откройте браузер, и наберите "http://www.your- site.example.org/typo3/".

Появится страница авторизации, примерно следующего содержания:

Используйте имя пользователя "admin" и пароль, установленный при установке TYPO3.

По нажатии на кнопку login, Вы будете перенаправлены в раздел краткого обзора внутреннего интерфейса TYPO3.

Справа находится меню основных модулей TYPO3 — основное меню внутреннего интерфейса. Давайте щелкнем по элементу "Page" и перейдем в модуль страница.

Для установки русского языка во внутреннем интерфейсе, перейдите к к разделу "Изменение языка внутреннего интерфейса" главы "Краткие сведения о модуле управления расширениями" на стр. 143.

Дальнейшие изображения и комментарии приведены с уже установленным пакетом русского языка.

Общая структура внутреннего интерфейса¶

Слева по прежнему остаётся меню модулей, в середине теперь появилось дерево страниц, а справа — область содержимого.

¶

Дерево страниц¶

Дерево страниц представляет иерархическу структуру страниц сайта. В большинстве случаев оно точно передает структуру навигации по сайту. Дерево страниц можно развернуть, щелкая по небольшим стрелочкам слева от элемен­тов.

Рассмотрим дерево страниц поближе:

И посмотрим на структуру навигации во внешнем интерфейсе, перейдя на страницу "About TYPO3".

Заметно, что меню сайта соответствует первому уровню страниц в дереве страниц, а меню следующего уровня отражает дочерние страницы для "About TYPO3" в дереве страниц.

Для всех модулей из категории "Веб" (Web) отображается дерево страниц, то есть все эти модули действуют на постраничной основе (их настройки относятся к страницам и элементах на этих страницах).

Щелчок по названию страницы откроет содержимое этой страницы в области содер­жимого справа. Задержав мышку над значком страницы, можно узнать ее внутренний индивидуальный номер — id. Этот же id используется для вывода страницы во внешнем интерфейсе.

Щелчок по значку страницы откроет контекстное меню.

Контекстное меню """"""""""""""""

Контекстное меню страницы можно использовать для быстрого доступа к функциям для страницы. Вот за что отвечают эти параметры:

• Просмотр: открывает выбранную страницу во внешнем интерфейсе.
• Отключить/Включить: скрывает/показывает страницу (во внешнем интерфейсе).
• Правка: редактирование свойств страницы.
• История/Отмена: отображение истории изменения страницы (кто, когда и какие изменения вносил).
• Действия со страницей:

- - Создать: позволяет создать новую страницу или ее содержимое.

• Вырезать: вырезка страницы.
• Копировать: копирование страницы.
• Удалить: удаление страницы.

• Действие для ветви:
  • Монтировать как корень дерева: временно делает текущую страницу корневой для дерева страниц — полезно для фокусировке на конкретной ветви дерева страниц при большом их количестве.
  • Раскрыть ветвь: раскрывает текущую ветвь в дереве страниц.
  • Свернуть ветвь: сворачивает текущую ветвь в дереве страниц.
  • Экспорт в .t3d:переход к экспорту текущей страницы и ее содержимого во внешний файл.
  • Импорт из .t3d:переход к импорту на текущую страницу содержимого из внешнего файла.

В зависимости от настроек и контекста может быть доступно больше или меньше функций.

Теперь при помощи контекстного меню выведете во внешнем интерфейсе страницу "Welcome to TYPO3".

Как видим (1 на голубом фоне), последняя часть названия страницы в строке браузера соответствует названию страницы в дереве страниц.Видно (2), что это страница с ID 6. Вернемся к дереву страниц и задержим указатель мыши над значком этой страницы ID 6 будет выведено и здесь.

(3) может Вас озадачить — ведь в дереве страниц и в строке браузера страница значится как "Welcome to TYPO3", а в меню она называется "Get Started". Почему так? Для этого в контекстном меню данной страницы выберем пункт "Правка" и взглянем на правую часть в область для содержимого:

Здесь видно, что заголовок страницы (1) "Welcome to TYPO3", а "Get Started" находим в другом месте (2). Это называется "Альтернативное название для меню" (Navigation title) и предназначено для вывода в любых элементах навигации (меню, местоположение на сайте (breadcrumbs), картах сайта...). Если оно не указано, то для этого используется заголовок страницы.

Специальные страницы¶

Снова вернемся к дереву страниц, как видно, для страниц используются различные значки. Одни появляются в меню сайта и являются обычными страницами. Сейчас разговор не о них. Имеются значки страниц, обведенные пунктиром — это страницы, скрытые в меню.

Содержимое страниц¶

Мы уже посмотрели, как через дерево страниц создается структура сайта и какие существуют типы страниц. Пришло время поговорить о содержимом страниц.

Сначала посмотрим, как располагается содержимое на странице.

• Откройте в браузере страницу "Exemples"> "Text and Images".
• В другом окне браузера откройте внутренний интерфейсTYPO3.
• Выберете модуль Страница и в дереве страниц перейдите на страницу "Exemples"> "Text and Images".
• Сравните оба представления.

Внешний интерфейс:

Внутренний интерфейс:

Как видите, порядок элемен­тов содержимого на странице сайта соответствует порядку элементов во внутреннем интерфейсе. Кроме того, элементы содержимого упорядочены по столбцам — элемент из правого столбца внутреннего интерфейса находится в правом же столбце страницы вашего сайта. Элементы содержимого могут быть самого разного типа (вроде текста, текста с изображениями), поэтому можно создавать страницы практически любого содежимого.

Давайте посмотрим, что произойдет, если переместить элемент содержимого.

Подведите указатель мыши на серую панель сверху элемента содержимого:

Как видите, появились значки редактирования для этого элемента. Стрелки справа служат для перемещения элемента вверх-вниз. После перемещения, взгляните на обновленную страницу во внешнем интерфейсе. Изменения в порядке элементов на ней отражены.

Другие значки предназначены совершения для различных действий с текущим элементом:

Редактирование и создание страниц и их содержимого --------------------------------------------------

Теперь мы знаем, что содержимое на страницах располагается в элементах содержимого. Значит, для редактирования содержимого страницы нужно редактировать элементы содержимого этой страницы!

Редактирование страниц и содержимого¶

В TYPO3 очень просто редактировать содержимое. Просто перейдите в модуль Страница (1), щелкните по заголовку страницы, которую нужно отредактировать (2), и в режиме "Колонки" (Columns) (3) щелкните по значку редактирования (4) элемента содержимого, который нужно исправить:

Будет выведена форма редактирования:

Прежде всего, поле "Тип:" (1) говорит о типе элемента содержимого на странице! Здесь это "Текст с изображениями". Это может быть и "Текст" (как мы видели ранее), и "Изображение", и "Таблица" и много чего еще. Выбирайте сами, что Вам нужно! Каждый тип содержимого имеет свой набор полей формы для параметров настройки, так что на своем сайте можно вывести практически все, что нужно.

Поле заголовка (2) содержит название для обозначения элемента содержимого. Сам основной текст вводится в поле "Текст".

У разных элементов содержимого разные параметры. Поиграйтесь немного с разными элементами и посмотрите, за что отвечают те или иные их параметры. После каждого изменения, не забудьте сохранить элемент.

Быстрое редактирование — делайте меньше кликов мышкой...

Для ускорения доступа к свойствам элементов содержимого на страницах сайта, можно переключить режим отображения модуля Страница на "Быстрое редактирование" вместо "Колонок", при этом сразу будут выведены свойства первого элемента содержимого на странице:

Новые страницы¶

Один способ создания новых страниц нам уже известен — так мы создавали страницу с "Внешней ссылкой". Но TYPO3 позволяет достигать тех же результатов разными способами. Вот еще несколько способов создания страниц:

После щелчка по кнопке создания страницы в дереве страниц (1) на основной панели будет выведена подсказка со значками для выбора типа создаваемой страницы (1). Нажав на значок с нужным типом страницы можно сразу переместить его в нужное место дерева страниц (2).

После чего заголовок страницы можно отредактировать прямо в дереве страниц:

При создании же страницы по щелчку на значке в основной панели над областью содержимого (2), в области содер­жимого будет выведен мастер выбора положения страницы:

Ну а теперь давайте вставим новую страницу "My Content Test" после (а НЕ внутри ) страницы "Text And images" и взглянем на сайт. Страница в меню будет находится сразу за страницей "Text and images".

На странице пока еще ничего нет — содержимое еще только предстоит создать, добавив на страницу несколько элемен­тов содер­жимого!

Настройки доступа — скрытие страниц, время появления и т.п.¶

Возможности, присутствующие во многих элементах — страницах, элементах содержимого, это поля для настройки доступа или настройки видимости . Для страниц это выглядит так:

Те же самые настройки для элемен­тов содержимого:

Скрытие страницы """"""""""""""""

Отметьте флаг "Видимость: Страница: Отключить":

Сохраните страницу и взгляните теперь на дерево страниц (если дерево страниц не обновилось, нажмите на зеленый значок с циклическими стрелочками в панели дерева страниц для его обновления):

Скрытая страница обозначена специальной меткой. Из внешнего интерфейса такие страницы не видны. Но если авторизоваться во внутреннем интерфейсе, такие страницы все же будут доступны — для этого выберете "Просмотр" из контекстного меню скрытой страницы:

Во внешнем интерфейсе скрытая страница отображается с меткой"preview", что говорит о ее недоступности для обычного посетителя сайта:

Скрытие страниц и элементов содержимого — это самые типичные примеры для настроек доступа. Эти настройки применяются настолько часто, что даже имеют собственный пункт в контекстном меню:

Назначение сроков для показа страниц и элементов содержимого """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""

Хотя скрытие и наиболее часто используемая вещь, но для установки доступности страницы можно использовать и определенные сроки! Например, попробуйте ввести код "d+10" в поле "Дата публикации":

=

Дата автоматически была установлена на текущую, плюс 10 дней! Если сохранить сделанные настройки и в дереве страниц задержать указатель мыши над значком страницы, то здесь также будут отображены сделанные настройки:

Конечно, можно сразу ввести нужную дату или использовать календарь для ее выбора.

Только представьте — недоступная на данный момент страница станет автоматически видимой 10 октября 2011, десять дней спустя! Как просто контролировать время публикации при помощи Даты публикации. Те же принципы справедливы и для поля "Срок истечения", разумеется. Все сказанное распространяется и на элементы содержимого страницы, статьи новостей, записи книги отзывов — можете продолжить сами. Один принцип, легко понятен, используется всюду!

Сложное формирование текста: жирный, курсив, списки, вставка изображений¶

При работе с текстовыми материалами на страницах своего сайта можно использовать те же самые опции для форматирования, что используются в обычных редакторах текста, типаMSWord. Rich Text Editor (RTE, редактор сложного текста) доступен в полях основного текста. "Rich Text" — сложный текст, означает всего лишь то, что его можно не поместить поместить как кусок текста, но и определенным образом отформатировать.

Как видите, можно создавать списки, применять форматирование — делать текст жирным или выделять курсивом, и даже вставлять таблицы. Этот редактор имеет гибкие настройки, лучше всего подходящие под Ваши нужды. Но его настройка выходит за рамки данного учебника. Описание его можно найти в :underline:`руководстве по rtehtmlarea <http://typo3.org/documentation/document-library/extension- manuals/rtehtmlarea_manual/current/>`_ .

Создание ссылок¶

Как говорится, гиперссылки — это связующее всего интернета. В TYPO3 ссылки создаются автоматически, так меню отражает иерархию страниц в дереве страниц.

Но может понадобится сделать ссылку из какого-либо текста на другую страницу, файл, другой сайт или адрес электронной почты. В Rich Text Editor сделать это просто — выделите текст и щелкните по значку "Вставить ссылку":

После чего будет открыто всплывающее окно, в котором нужно будет выбрать тип создаваемой ссылки. В данном случае выберем вкладку "Страница" и щелкнем по странице "About TYPO3" в дереве страниц для создания ссылки на эту страницу.

После чего всплывающее окно закроется, а в тексте появится только что созданная ссылка:

Для редактирования ссылки, просто щелкните на ней правой кнопкой мышки и выберете в контекстном меню "Изменить ссылку" (либо поместите курсор где-либо внутри текста ссылки и снова щелкните по значку "Изменить ссылку").

Во внешнем интерфейсе, как и ожидалось, появится созданная ссылка. Щелкнув по ней мы переместимся на страницу "About TYPO3":

Если набранный в редакторе текст выглядит не так, как нужно, всегда можно переключиться на представление в виде исходного кода, и взглянуть, какой же код на самом деле будет сформирован:

Это обычный HTML. Но помните, RTE анализирует этот код и удаляет все, что ему незнакомо в соответствии с текущими его настройками. Поэтому не пытайтесь здесь писать свой HTML код.

Защищенные паролем страницы¶

Теперь понятно, как создавать и редактировать страницы. Совсем не трудно, не так ли? Так запросто можно стать веб мастером с TYPO3. Но одно дело — общедоступные страницы, а что если нужно ограничить доступ к ним? Можно ли закрыть к ним доступ паролем? Запросто!

На самом деле в этом уже установленном сайте такие страницы имеются. Найдите во внешнем интерфейсе "Customer login" (ссылка в правом верхнем углу).

Прочитайте текст на этой странице (на английском) и воспользуйтесь блоком авторизации на сайте справа для входа на сайт под именем customer1.

После успешной авторизации, в меню слева должны появиться дополнительные страницы.

Теперь перейдем во внутренний интерфейс и посмотрим на эти страницы в дереве страниц:

Значок в виде человечка в голубой одежде указывает на то, что страницы имеют определенные ограничения. Перейдем к редактированию свойств страницы "Protected customer page" (Контекстное меню > Правка), откроем вкладку "Доступ":

Здесь видно, что просмотр страницы доступен лишь для группы пользователей "Customers". Можно установить права доступа к страницы на "Виден при любом входе", что откроет страницу для просмотра любому авторизованному внешнему пользователю (не зависимо от группы, к которой он принадлежит).

Далее мы научимся создавать внешних пользователей и группы внешних пользователей.

Создание внешних пользователей/групп¶

Перед тем, как создавать закрытые для доступа страницы, необходимо создать хотя бы одного пользователя сайта и группу пользователей. Это можно сделать и до, и во время и после создания самого сайта — последовательность здесь не важна.

Создание формы авторизации¶

Introduction Package поставляется с уже полностью настроенной формой авторизации. Но что, если нужно создать еще одну, например, на начальной странице? Нет проблем. Это такой же элемент содер­жимого, вроде текста или текста с изображением. Перейдем (все в том же внутреннем интерфейсе) на страницу "Welcome to TYPO3", убедитесь, что делаете это в модуле Страница, и щелкните по значку элемента содержимого с маленьким зелененьким плюсом в заголовке элемента содер­жимого "How Do I Log in?". Так можно создать элемент содержимого под выбранным.

Перейдите на вкладку "Формы" и выберете "Форма входа в систему":

Будет выведена форма для настройки авторизации. Дайте ей название и перейдите на вкладку "Дополнение". Самое главное здесь — указать "Страницу хранилище пользователей". Для этого щелкните по значку папки, рядом с полем "Страница хранилище пользователей":

В появившемся окне выберете страницу "Frontend users and groups":

Сохранитесь. Вот и все. Теперь поглядите на сам сайт — вот и новая форма авторизации:

Создание ветви с ограниченным доступом ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Выше мы посмотрели, как ограничить доступ к странице (Вы же помните вкладку "Доступ" в свойствах страницы?). Но иногда нужно ограничить доступ не просто к странице, а к целой ветви со страницами. Например, нам нужно, чтобы вся ветвь"Examples" была доступна лишь для определенных пользователей. Неужели для каждой вновь создаваемой странице в этой ветви нужно будет не забыть установить те же самые права? Звучит нелепо. Конечно существует и более простой способ.

Перейдем к редактированию свойств страницы "Examples" и откроем вкладку "Доступ":

Если установить флажок "Включая подстраницы: включено", то все подстраницы унаследуют права доступа от родительской страницы. Это распространяется не только на доступ при авторизации, но и на "Даты публикации" для всей ветви!

Email form¶

We already have an email form on the website. If you go the the page "Feedback" you will see a basic contact form:

Navigate to the "Feedback" page in t he backend and edit the form:

In the field “Form Structure” the form is defined:

At the "Target Page" field on tab “Behavior” you can define where the user gets redirected after he sends the form:

If you leave this blank he won't be redirected. Normally you'd enter some kind of "Thank you" page.

Let's take a closer look at the form structure. You already know the pipe (|) as separator from the tables content element. It is used here in this mail form to define the form fields. Every line represents one field of the form. Click on the wizard icon on the right side of the field:

As you can see the codes are transformed into this nice form.

Here each field in the form is created by visual controls. For a field you need to enter a label of course (1) and a field type (2). These are the visible parts. You also have to give the field an internal name (3) which is the one that will be shown in the email the recipient gets. In the case of "Input field" types you can also enter a default value (4).

For all email forms there are three common values to be set: The name of the send button (5), the subject line of the email being sent (6) and finally the email address of the person that should receive the email (7). This person is normally you! Or whoever on your team who is supposed to respond to feedback.

Tracking backend users¶

Sometimes you want to know which editor did what, some sort of tracking the backend users actions. You can do that by using the integrated log functionality of TYPO3. Just select "Admin Tools" > "Log" from the menu and you will see an overview of the last actions your users did:

Do you notice the little icons with the clock in the log? This is the record history. Each record has a history in TYPO3, so if you change a record by accident you can use this history to undo your changes.

The easiest way to access the record history is through the list module.

You will see colored differences between your changes (If you don't see colored differences, see "Troubleshooting"):

((generated))¶

Making changes to the template¶

Let’s try to change a few things in the template record, "ROOT". Edit the template "Introduction Package" and select the tab "Includes". In section "Include basis template" click on the Icon before "ROOT" and select edit.

Now you can edit the "ROOT" template in place:

For standard templates the "Constants" field is often the place to change values. Constants define things that are used in many places in templates, like the name of the default template or the page where your news are coming from. Constants can then be used in the "Setup" field. For example if you have a constant definition like menu.top.pages = 28 you can later use it in the setup as {$menu.top.pages} and it will be substituted automatically with the value (28 in this case). So one change to a constant may mean many changes in different places in the final TypoScript configuration code of the template.

In our case, let’s add the feedback page to the top right menu.

Just add the page "Feedback" (id 2) to the list of pages in the top right menu.

After saving the template record, click "Clear all cache" in the "Admin Functions" menu:

Always do that if you edit template records directly .

The result is:

You can play with other values as well!

The Setup field¶

The constant field allows you to edit the defined constants fast and change general things on your website. The next level is to change the details or something more general like if there is a top right menu or not. The easiest way to do that is to use the "Info/Modify" view which allows you direct access to the important parts of the template.

As you can see the template has a description that explains shortly what it does. All templates in the Introduction Package have this kind of short explanation, so you can click through them all and get an overview.

Click on the subfolder menu_configuration now. You will see that not one but multiple templates are stored in it.

Choose the template "menu.top" now to see the definition of the top right menu and click the pencil next to "Setup" (Notice how there is a link below the menu block which directly points you to editing of the full template record if you need it):

Don't worry if you don't understand what you see yet, this tutorial just shows you the general principles and where you find what, the next tutorials will show you in-depth what TypoScript is and how you can use it to create your own websites.

One thing you can see in this template is the usage of the constant we changed earlier {$menu.top.pages} in the template.

The Object Browser¶

There is one other tool you should know when working with TypoScript. It is called the "Object Browser". Change the select box on top of the template module to "TypoScript Object Browser":

The object browser shows you the TypoScript configuration of your website as an object tree, for example on the image above you can see how the command "page.10.includeCSS.10 = fileadmin..." is transformed into a tree structure. You can click the properties in the template to change them directly. Any changes are written to the current template (Which template is the current template? Look at the header of the Object Browser!)

Content in multiple columns¶

As you have probably noticed your Introduction Package shows three columns in the page module, left, normal and right. If you look further you might additionally notice, that the left column is empty. So if you want to configure your TYPO3 more comfortable and easier to understand you'd want to hide that useless empty column. That is what we will do now.

To configure how the TYPO3 backend looks so called TSconfig is used. TSconfig (TypoScript Configuration) is stored on pages and will have an effect on the page it is stored on and on all underlying pages. So if we want to hide the left column everywhere in our website we should change the TSconfig of our root page.

Click the page icon of our root page and choose "Edit page properties", then choose the tab "Resources" and have a look at the “TypoScript configuration” field:

As you could guess from the comment, you just have to delete the "1" in the third line to disable the left column in the page view. Easy, isn't it? This is what you should get after saving the page:

Template & backend configuration disclaimer!¶

Since the "template" is the crucial point of your implementation possibilities it is very important to stress that this tutorial does not to any degree display the depth of possibilities with templates in TYPO3.

Managing files in TYPO3¶

Let’s look at another interesting module - the File module:

This works by the same principle as the List module for database elements - it has a folder tree and a list view of files in the folders.

The folder displayed by default (for "admin" users) is the "fileadmin/" folder located under the root folder of your web serverdirectory. Here a little image archive already exists. These files are not used on the website directly. If we want to do so we can either a) link to the files from content elements or b) pick the files in the process of selecting files for content elements.

Uploading images to the archive¶

One way to get images to the archive would be through FTP. But of course you can upload directly in the File module. Just click the folder icons:

This will bring up a Flash-Popup form where you can upload multiple files at once:

If your browser does not support flash, you can disable this feature in your user settings and you will get an Simple Upload-Form.

Likewise files can be renamed, copied, deleted etc - all by the functions available in the context menus you are familiar with already:

Using the List module effectively¶

You might already have used the clipboard to move a content element from one page to another. But let's see what happens behind the scenes:

On the "About TYPO3" page we have two content elements. View the page content with the List module, enable the "Clipboard" checkbox and select "Copy" for an element.

Notice how this element gets registered in the clipboard that is shown now! (You will have to refresh the List module before it is shown).

If you select another element the first one is removed. "Cutting" element is the same - it is just being registered as "Cut" instead.

If you enable "Extended view" checkbox you can see a whole panel of nifty little buttons which are all great shortcuts instead of activating the context menu all the time:

Try to play around with the buttons here!

The numeric clipboard pads - managing many elements¶

Back to the clipboard - select one of the "numeric pads" now:

Now you can tick off the elements to select for the clipboard - thus you can have not just one but multiple elements selected at once!

Select the first two elements and press the "Transfer..." button:

The elements are now registered for "move" on the clipboard:

Pasting them onto another page is not just a question about going to that page and click the "Paste into" icon:

After confirming the warning...

... you will see the two elements moved to the top of the page and the clipboard pane #1 emptied:

Selective editing¶

The list module also uses the check boxes for elements for another purpose - selective multi-editing. To enable this you must first of all click the title of the table in the List module (#1):

This will enable the extended mode. Here you can select additional fields from the table you want to view as well (#2). Select the "Type" field for now. This will make the "Type" field appear in addition to the "Header" field already there.

Distributed maintenance¶

The final step in our efforts to get this introduction website running is to look at distributed maintenance - a core requirement to a CMS. We already discussed the difference between frontend and backend users and how backend users were located in the root of the page tree:

Backend users¶

The introduction package is shipped with four users. Let's see what they can do. The best way to do this is to logout as admin and log in as one of these users, one at a time.

Setting up user permissions¶

Now we want to know how the users "simple_editor", "news_editor" and "advanced_editor" have been set up! Log in as "admin" again and let's explore it. Select "Edit" for the three users. You will see, that they are almost identical. But they all have a different Group selected.

On the tab "Mounts and Workspaces" there are both " Mount from groups: " are set. Which page and which folder the user can access, depends on the rights which are set at the group level.

It is a good practice to manage the permissions on group basis.

Groups¶

Let's look at the Simple editors group which the simple_editor is a member of.

Creating a new user for the Introduction site¶

Now, we can create a user who should be in charge for the "Resources" page including sub-pages.

Changing backend language¶

Usually an editor would like to use TYPO3 in his own language. So you need to change the language of TYPO3 for him. As an first step, you have to just download the language packages you need. To do so, just start the Extension Manager and select "Translation handling".

Now select which language packages you want to download. Select all language packages you want to provide to your users.

Save your selection by hitting "Save selection". You can alter your selection at any time, so just select the languages you need now.

After saving your selection, you can either compare the actual status against the repository or just update and download the language packages from the repository. Just hit update. You will see an progress-bar where you can see for which Extension the language packages has been downloaded. Usually you should get a green bar and an green "UPD" marker for you language for each extension key. It can happen, that some extensions are not yet translated in your language, then you will get an "N/A".

It may happen that not all packages get downloaded. Just hit the update button again - it should then retrieve the missing parts.

Up to now, you just downloaded the language packages. Now you need to alter your "User settings" and select your language. Switch to the "User settings" Module and select the language you want to use for your account.

Save your new configuration. You will then get an message that your settings were updates. If you have a look at the main modules, you see that the modules are now shown in the language, you selected. If you hit again "User settings" even that page will be translated.

So, you just changed your own backend language. All editors needs to do it for themselves.

If you create new editors you can give them a helping hand by selection an "default language" while creating new Backend user records. This language will be used when the log into TYPO3 the first time.

Keep in mind, that the "Default Language" really is nothing else, than an default setting. If they have logged in already, they have to switch their language for themselves in the "User settings" Module.

Human readable URLs¶

By default, TYPO3 identifies the page which should be delivered via the ?id parameter. So you can just enter http://www.your- site.example.org/ index.php?id=4 to get the examples page. As every page in TYPO3 has an id, you only need to know that id to get the page. But for your visitors the url http://www.your- site.example.org /examples/ would be nicer. In TYPO3 this features comes as an extension (and there are actually several). The Introduction Package comes with one called "RealURL". If you have special needs regarding the scheme of your URLs, have a look at its manual.

RealURL should work just out of the box for you in the Introduction Package. If it does not, and you get redirected to the Welcome page with each click in the frontend, you may just deactivate realurl. For doing so, just go to the list module, select the template "Introduction Package" on the page "home" and put into the setup- field:

config.tx_realurl_enable = 0

Save the template record and just clear all caches. All links should be rendered with ?id= instead of human readable URLs now, and you should be able to just navigate trough your page.

[we need to show the clear cache with screenshot – users do not know how to do this]

Note on image processing in TYPO3¶

If you are not so lucky you didn't see some of the images in these screenshots on your own server. This might be because ImageMagick was not properly detected on your server. You probably didn't see all the great things happen.

You will have to consult the :underline:`installation documentation <http://typo3.org/documentation/document-library/installation/>`_ available to get those problems solved. Also remember there is a :underline:`mailing list for installation <http://typo3.org/community/mailing-lists/>`_ questions.

Colored differences in history module¶

To get the colored differences in the history module, you need to have installed the unix-tool diff on your server. Otherwise you will not get the colored differences. But you will be able to see the differences, just without colors.

Tutorial for editors¶

:underline:`**TYPO3 Tutorial for Editors** <http://typo3.org/documentation/document-library/extension- manuals/typo3_tut/current/>`_ : 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.

Internal Manual (Module) : The system extension cshmanual provides an additional backend module, which appears in the help menu. The TYPO3 Inline User Manual is composed from the available help in this TYPO3 Installation (Context Sensitive Help). Here you will find a general description of the TYPO3 Core modules, installation specific Backend Modules and Database Tables that are available based on your login credentials.

Tutorials for future administrators¶

:underline:`**Modern Template Building** <http://typo3.org/documentation/document- library/tutorials/doc_tut_templselect/current/>`_ : The modern Template Building explains how to use an HTML-Template as skeleton for your webpage, and helps you with the first steps building your own website in TYPO3.

:underline:`**Futuristic Template Building** <http://typo3.org/documentation/document- library/tutorials/doc_tut_ftb1/current/>`_ : TYPO3 uses the concept of columns to define where the content is rendered. If your website design does not fit into columns or you need to be very flexible with the content elements, the extension TemplaVoila may help you build very flexible designs with TYPO3. This concept is explained in this tutorial.

:underline:`**TS in 45 minutes** <http://typo3.org/documentation /document-library/extension-manuals/ts45min_de/current/>`_ : TypoScript is the powerful configuration language, but it is not an scripting language. This tutorial explains the basic concepts of TypoScript and gives a first overview about the most important functions and objects.

References¶

:underline:`**Tsconfig** <http://typo3.org/documentation/document- library/core-documentation/doc_core_tsconfig/current/>`_ : With Page- and User-TSconfig you can change in parts the behavior of the backend . You can change labels, hide or show fields, set permissions and default values. This is usually done on the Page-TSconfig or User-TSconfig field. This reference shows which options are available for TYPO3.

:underline:`**TSRef** <http://typo3.org/documentation/document- library/core-documentation/doc_core_tsref/current/>`_ : The TypoScript reference defines the different functions and objects, which can be used to configure the frontend output. Usually you will use the extension css_styled_content which ships with the whole configuration for all build in content elements. If you want to change something, you can look up the possible options in the TSref.

Keep security in mind¶

Security is taken very seriously by the developers of TYPO3. The :underline:`TYPO3 Security Team <http://typo3.org/teams/security/>`_ manages possible security incidents. They review it and considers its impact. If TYPO3 or an extension turns out to be actually vulnerable, the Security Team work on a fix for the problem. They contact the extension authors and if the fix is tested and released, an advisory is published. To get the bulletin notification delivered to your inbox, we strongly recommend to :underline:`subscribe <http://lists.typo3.org/cgi- bin/mailman/listinfo/typo3-announce>`_ to the typo3-announce mailing list. The TYPO3 Security Team also provides some :underline:`additional resources <http://typo3.org/teams/security/resources/>`_ about securing your TYPO3 installation.