Дневник разработчика

t3blog - списки Архива и Категорий на jQuery

В t3blog для работы сворачивания/разворачивания списков Архив и Категория предлагается использовать JS на основе схемы mootools. Это зачастую не устраивает создателей сайта - они могут использовать и другие библиотеки, а решение на основе mootools попросту может не работать, либо может отказаться работать другой функционал.

В частности, на своем сайте я в основном использую библиотеку jQuery. Подключена она при помощи небезызвестного, отличного расширения  t3 jQuerry. Для того, чтобы не было конфликта с другими библиотеками JS, используется режим jQuery.noConflict().

И все бы ничего, но вот обнаружил, что реализация списков по умолчанию работает с ошибкой - свернуть список можно, а развернуть уже нет... То есть, если обновить страницу, то список выводится уже развернутый - работают устанавливаемые cookie. Об этой проблеме я писал на  странице разработки расширения, но ничего вразумительного за четыре месяца написано не было (до недавнего момента).

Здесь я опишу решение, для списка Архива реализованное в расширении  t3blogjquery, а для списков - через дополнительно подключаемый сценарий, написанный для jQuery.

дальше...

TypoScript за 45 минут... Интересно? Читаем!!!

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

дальше...

Продолжаем настраивать t3blog

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

В расширении уже имеются следующие функциональные внешние модули (widgets, виджеты):

• список журнала
• архив
• блогролл - список "любимых" и

дальше...

Наконец-то, облако тегов работает как нужно...

Угробил сегодня уйму времени, разбираясь с расширением t3m_cumulus_tagcloud. Конкретно – не устраивает ситуация с отображением тегов на русском языке (или любом, отличном от английского).

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

Решил залезть дальше, и выяснит, почему русские метки отображаются коряво... Вкратце: начал не с того конца – заподозрил неверное преобразование кодировок... Но проблема в самом swf файле, используемом в расширении – именно там неверно происходит перекодирование...

Вообщем, выкладываю архив с измененным расширением:  archive (641 КБ). Файлы из этого архива нужно разархивировать в папку typo3conf/ext/, при этом будут заменены оригинальные файлы расширения t3m_cumulus_tagcloud.

Можно просто заменить файл ext/t3m_cumulus_tagcloud/pi1/tagcloud.swf из папки расширения  на  этот, поменяв его название на, как Вы догадались, tagcloud.swf.

Как заставить работать t3m_cumulus_tagcloud после обновления t3blog

Если заметили, 24 сентября расширение  t3blog было обновлено. Но после обновления перестало работать красивое расширение для отображения облака меток  t3m_cumulus_tagcloud. Что же случилось? Дополнение облака тегов из класса class.tx_t3mcumulustagcloud_pi1.php обратилось к функции getTags_array () в классе class.tagCloud.php из расширения t3blog (файл класса находится в папке t3blog/pi1/widgets/tagCloud/).

После обновления и ревизии этот класс попросту удалили... Чтобы временно решить проблему (о ней я сообщил разработчику, но будет ли это исправлено - неизвестно...) я сделал следующее:

меняем в строке 126 файла class.tx_t3mcumulustagcloud_pi1.php (t3m_cumulus_tagcloud/pi1/class.tx_t3mcumulustagcloud_pi1.php)

$tags = tagCloud::getTags_array();

на

$tags = getTags_array();

А в конце файла, после функции main() вставляем копирую функции getTags_array() из старой версии расширения t3blog:

дальше...

Первоначальные сведения об Extbase

О чем это?

В марте 2010 появилась английская версия докуменатции для ознакомления с  Extbase. Наткнулся на нее я лишь недавно, начав плотнее разбираться с программированием расширений для TYPO3. Здесь хочу представить перевод этого документа.

Это ознакомительное руководство написано Franz Ripfel,  franz.ripfel@abezet.de.

Благодарим Jochen Rau, Sebastian Kurfürst и остальных, работающих над доступностью программирования в стиле FLOW3 в TYPO3 v4.

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

Введение

Это – часть большого документа о новом способе создания расширений. Весь документ включает следующие книги:

• Первоначальные сведения – руководства по написанию расширений на ExtBase и Fluid.
• Подробное руководство – разъяснения всего необходимого для использования системы.
• Справочник – все справочные материалы, соглашения и т.п.
• Справочник разработчика – рассказывает о внутреннем устройстве структуры для людей, программирующих на нем.

Во всех книгах одно и то же введение, поэтому, если вы уже знакомы с ним, – смело пропускайте!

Новый способ создания расширений

Расширения были представлены в TYPO3, начиная с версии 3.5 и стали одной из основных причин гибкости, популярности и широты распространения TYPO3. Но основной класс для дополнений внешнего интерфейса (называемый tslib_pibase, поэтому мы называем расшир

дальше...

Настройка расширения t3m_cumulus_tagcloud

Конечно, t3blog имеет собственное дополнение для облака меток, но несомненно красивее выглядит расширение  t3m_cumulus_tagcloud. В расширении заявлена интеграция с tt_news и t3blog, поэтому ожидалось, что заработать оно должно было бы с пол-оборота: установил расширение, вставил дополнение на страницу, сделал настройки – и теги показаны... Но возникли трудности – теги не показывались... сначала... пришлось поиграть с настройками. О них я сейчас и расскажу. Тем более руководство довольно скудно, все пришлось додумывать самостоятельно.

Итак, с самого начала. Устанавливаем расширение из репозитория как обычно:

Внутренний модуль "Расширения", в нем выбираем в выпадающем меню режим "Экспорт расширений", а затем ищем по ключу расширение "t3m_cumulus_tagcloud". Затем экспортируем и устанавливаем.... Все, других настроек не требуется.

Далее идем на страницу, на которой нужно отобразить облако тегов и вставляем элемент содержимого:

 

Я предпочитаю давать осознанные названия элементам содержимого, а чтобы названия не появлялись на сайте, просто дают им тип "Скрытый".

Теперь сохраняем все это пока еще безобразие и переходим на вкладку "Расширение", где и делаем нужные нам настройки:

Итак, по порядку:

Activate the checkbox if you want to display news

дальше...

О настройках TS и удобстве работы с шаблонами

Здесь хочу остановиться на том, как я сам редактирую шаблоны TypoSript (TS) и использую их на сайтах. 

Как известно, TYPO3 – система модульная, чем и хороша. Шаблоны также целесообразно строить модулями, собирая по кирпичикам целый сайт. Поясню.

Шаблон TS состоит из Констант, Настроек

и включений шаблонов либо из расширений, либо ранее созданных:

Возможность подключения базовых шаблонов и используется при модульном пост

дальше...

Основные настройки t3blog

Основные настройки делаем, как написано в руководстве пользователя, в разделе "установка":

• Создайте новую страницу, где-нибудь в своем дереве страниц через модуль Веб>Страница. На вкладке "Настройки" в разделе "Содержит плагин", укажите расширение T3BLOG. Сохраните и закройте страницу. Не обязательно создавать дополнительную системную страницу-директорию для данных — все они будут храниться на этой странице для сетевого журнала.
• На этой новой странице создайте TS шаблон.
• Настало время подключения статических шаблонов для расширения T3BLOG. TypoScript этого расширения по большей части хранится в папке static. В ней имеются несколько файлов TS, все они объединяются в одном статическом включаемом объекте. Каждое из украшений (widget) имеет собственный TypoScript, включаемый из основного шаблона.

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

Подключать все статические шаблоны совсем необязательно и даже не нужно. На этом я и попался сначала, сделал все как на картинке из руководства, подключил все статические шаблоны для странички журнала (общий шаблон css_styled_content подключен для шаблона всего сайта) в следующем порядке:

• T3BLOG template – snowflake theme 1
• T3BLOG – main configuration
• T3BLOG CSS – snowflake theme 1
• T3BLOG blog2page – output to the page

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

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

дальше...

Выбор сетевого журнала - знакомимся t3blog!

Недавно захотелось дополнить свой сайт сетевым журналом – блогом. Как принято в TYPO3, залез в репозиторий расширений TYPO3  с запросом blog. Так как изначально сайт строился на шаблоне от  WEC, там, конечно же, уже имелось решение на основе расширений TIMTAB (Typo3 is More Than a Blog), Новостей (tt_news), и Современной гостевой книги (ve_guestbook).

Глядя на количество вовлеченных в одно решение расширений (извините за каламбур), я решил, что должно быть какое-то решение, объединяющее все это вместе в одном расширении. Но, как ни странно, такое решение появилось не так давно и имя ему – T3BLOG.

Несмотря на обещание простой установки:

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

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

Итак, приступим.

дальше...