TYPO3 features not limited to HTML pages, you can provide user with any type of web content. It’s absolutely not required to install special extension for XML-based content, but there are lots of them in TYPO3-repository.

I not like use extensions, if there exists TYPO3-solution with typoscript. Here I will provide example how to generate XML with pagetree data for Flash menu. Using this technique you can crate any type of XML-data, Google Sitemaps, WML, etc.

XML for Flash menu application looks something like this:

1
2
3
4
5
6
7
8
9
10
11

<?xml version="1.0" encoding="UTF-8"?>
<menu>
  <item url="index.php?id=1" title="Page 1" />
  <item url="index.php?id=2" title="Page 2" />
  <item url="index.php?id=3" title="Page 3">
    <item url="index.php?id=4" title="Page 3-1" />
    <item url="index.php?id=5" title="Page 3-2" />
    <item url="index.php?id=6" title="Page 3-3">
  </item>
  <item url="index.php?id=7" title="Page 4"/>
</menu>

Typoscipt for generating this XML:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

########################################
# PAGETREE TO XML
########################################
xmlmenu = PAGE
xmlmenu.typeNum = 111
# Disable all standard header generation by TYPO3
xmlmenu.config.disableAllHeaderCode = 1
# Setup correct content type header for XML
xmlmenu.config.additionalHeaders = Content-Type: application/xml
 
# Output XML header
xmlmenu.10 = TEXT
xmlmenu.10.value = <?xml version="1.0" encoding="UTF-8"?>
xmlmenu.10.postCObject = TEXT
xmlmenu.10.postCObject.char = 10
 
# Output XML data of pagetree
xmlmenu.20 = HMENU
xmlmenu.20 {
 wrap = <menu>|</menu>
 entryLevel = 0
 1 = TMENU
 1 {
  expAll = 1
  NO {
   doNoShowLink = 1
   allStdWrap.cObject = COA
   allStdWrap.cObject.10 = TEXT
   allStdWrap.cObject.10.typolink.parameter.field = uid
   allStdWrap.cObject.10.typolink.returnLast = url
   allStdWrap.cObject.10.noTrimWrap = |<item url="|" |
   allStdWrap.cObject.20 = TEXT
   allStdWrap.cObject.20.field = nav_title // title
   allStdWrap.cObject.20.wrap = title="|"/>
  }
 
# We need too surround subitems with <item></item>
  IFSUB < .NO
  IFSUB = 1
  IFSUB {
# Added closing </item>
   wrapItemAndSub = |</item>
# Raplace <item ... /> with <item ...>
   allStdWrap.cObject.20.wrap = title="|">
  }
 }
 
 2 < .1
 3 < .1
 4 < .1
 5 < .1
}

Flash application can now access XML data with address “index.php?type=111″

You can add content output into TYPO3 if required, and use this for Full Flash sites and use TYPO3 as your backend.

So, no extensions, just TYPO3 and typoscript…

P.S.: Dear, Readers, if you interested in English versions of articles about TYPO3 and TYPO3 snippets please let me know. Leave comments in my blog.

Возможности TYPO3 совсем не ограничены одними только HTML страницами. Для того что бы сформировать XML файл по контенту в TYPO3 совершенно не нужны какие-либо расширения, коих, к моему удивление, такое большое количество в репозитории.
Поскольку я не приветствую использование расширений без особой причины, приведу пример формирования XML выгрузки страниц из TYPO3 для Flash меню. Стоит отметить, что тем же способом можно выдавать абсолютно любого вида и направленности данные, как например, Google Sitemaps или WML и т.д.

XML для Flash menu имеет следующий вид:

1
2
3
4
5
6
7
8
9
10
11

<?xml version="1.0" encoding="UTF-8"?>
<menu>
  <item url="index.php?id=1" title="Page 1" />
  <item url="index.php?id=2" title="Page 2" />
  <item url="index.php?id=3" title="Page 3">
    <item url="index.php?id=4" title="Page 3-1" />
    <item url="index.php?id=5" title="Page 3-2" />
    <item url="index.php?id=6" title="Page 3-3">
  </item>
  <item url="index.php?id=7" title="Page 4"/>
</menu>

Typoscipt генерации такого XML:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

########################################
# PAGETREE TO XML
########################################
xmlmenu = PAGE
xmlmenu.typeNum = 111
# отключаем генерацию стандартных заголовка страницы TYPO3
xmlmenu.config.disableAllHeaderCode = 1
# устанавливаем корректный тип контента
xmlmenu.config.additionalHeaders = Content-Type: application/xml
 
# Выдаем заголовок XML
xmlmenu.10 = TEXT
xmlmenu.10.value = <?xml version="1.0" encoding="UTF-8"?>
xmlmenu.10.postCObject = TEXT
xmlmenu.10.postCObject.char = 10
 
# Сами данные дерева страниц
xmlmenu.20 = HMENU
xmlmenu.20 {
 wrap = <menu>|</menu>
 entryLevel = 0
 1 = TMENU
 1 {
  expAll = 1
  NO {
   doNoShowLink = 1
   allStdWrap.cObject = COA
   allStdWrap.cObject.10 = TEXT
   allStdWrap.cObject.10.typolink.parameter.field = uid
   allStdWrap.cObject.10.typolink.returnLast = url
   allStdWrap.cObject.10.noTrimWrap = |<item url="|" |
   allStdWrap.cObject.20 = TEXT
   allStdWrap.cObject.20.field = nav_title // title
   allStdWrap.cObject.20.wrap = title="|"/>
  }
 
# отличается от NO тем, что нам надо обернуть под элементы в <item></item>
  IFSUB < .NO
  IFSUB = 1
  IFSUB {
# Добавляем завершающий </item>
   wrapItemAndSub = |</item>
# Заменяем <item ... /> на <item ...>
   allStdWrap.cObject.20.wrap = title="|">
  }
 }
 
 2 < .1
 3 < .1
 4 < .1
 5 < .1
}

Flash приложение теперь может получать данные для меню по адресу “index.php?type=111″

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

		NO.allStdWrap.override {
			if.value.field = doktype
			if.equals = 3
			field = title
			typolink {
				target = _blank
				extTarget = _blank
				ATagParams = class="noicon"
				parameter.field = url
				parameter.split {
					token = /
					cObjNum = 1
 
					1.current = 1
					1.rawUrlEncode = 1
					1.wrap = /|
				}
			}
		}

Использование split связано с тем, что в некоторых ссылках присутствовали пробелы и пришлось кодировать URL (при этом не трогая обратный слэш “/”)

Кстати, использование split в меню несколько проблематично. Дело в том, что все optionSplit обрабатываются генератором меню и следоватоельно split с более чем одним вариантом объекта обрабатываешьего split будет работать некорректно.

src = 1
src.cObject = CASE
src.cObject {
key.field = image_frames
1 = IMG_RESOURCE
1 {
file = GIFBUILDER
file {
XY = [10.w], [10.h]
format = jpg
10 = IMAGE
10 {
file.import.current = 1
file.width.field = imagewidth
}

20 = IMAGE
20 {
offset = 2, [10.h]-12
file = fileadmin/templates/img/lupe.gif
}
}
}
default < .1
}
}
[/code]

Подмена всегда деалется во втором по очереди тэге (_offset = 2). Если картина создана без возможности увеличения, то никаких изменений не произойдет (img будет первым и единственным тэгом).

CASE используется для выбора различных способов (картинок, накладываемых на оригинал) создания превью.

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

Создание блока копирайта
Создается блок типа TEXT содержащий следующий текст:

© 2005-2006, Компания Ко

Пусть блок имеет uid=100. В шаблоне с помощью разметки TemplaVoila создаем элемент, содержимое которого будет браться из объекта TypoScript с именем lib.copyright. Теперь мы можем вставить копирайт на каждую страницу сайта используя следующий код:

1
2
3
4
5

lib.copyright = RECORDS
lib.copyright {
	source = 100
	tables = tt_content
}

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

Подстановка данных в контент пользователя
Первое что приходит в голову реализовать собственный рендеринг блока. Такой подход имеет право на жизнь, но придется написать очень много кода, что делает такое решение мало привлекательным. Значительно проще подставить необходимые данные в уже созданный/от-рендеренный блок.

Typo3 предоставляет целых два механизма для замены данных в контенте: использование TEMPLATE и использование параметра insertData у stdWrap.

Вариант 1: TEMPLATE
В данном варианте мы используем блок контента пользователя как шаблон для вставки наших данных. Пользователь при редактировании блока с копирайтом, использует определенный нами маркер ###CURRENT_YEAR### в качестве текущего года:

© 2005-###CURRENT_YEAR###, Компания Ко

Код выполняющий подстановку маркера выглядит следующим образом:

1
2
3
4
5
6
7
8
9
10
11
12

lib.copyright = TEMPLATE
lib.copyright {
	template = RECORDS
	template {
		source = 100
		tables = tt_content
	}
	marks {
		CURRENT_YEAR = TEXT
		CURRENT_YEAR.data = date: Y
	}
}

Вариант 2: insertData
Второй вариант использует подобный механизм замены директив заключенных в фигурные скобки в случае указанного параметра insertData (.stdWrap). В данном случае пользователь долен указать одну из директив источника (getText).

Для подстановки текущего года мы будем использовать регистры Typo3, в этом случае блок с копирайтом должен выглядеть следующим образом:
[code]© 2005-{register:currentYear}, Компания Ко[/code]
Код выполняющий подстановку выглядит следующим образом:

1
2
3
4
5
6
7
8
9
10

lib.copyright = RECORDS
lib.copyright {
	source = 100
	tables = tt_content
	stdWrap {
		preCObject = LOAD_REGISTER
		preCObject.currentYear.data = date: Y
		insertData = 1
	}
}

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

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

Описанные подходы имеют большую ценность не только для подстановки информации в блоки контента, но и в тех случаях, когда функционала TypoScript не достаточно в каком либо из объектов TypoScript (например, HMENU). В таких случаях как раз удобно применять 2-й вариант выполнив подстановку данных уже после генерация HTML-кода.