март 14 2025

Telegram Instant View для DLE

Мы рады представить новый плагин для DataLife Engine (DLE) под названием DLE-tg-iv, который позволяет интегрировать ваш сайт с функцией Telegram Instant View. Эта технология позволяет пользователям просматривать статьи и публикации прямо в Telegram, без необходимости открывать веб-страницы в браузере. Instant View обеспечивает быструю и удобную для чтения версию контента, оптимизированную для мобильных устройств.

Преимущества Telegram Instant View для сайтов

  • Удобство для пользователей: Публикации загружаются мгновенно, что делает их просмотр быстрым и комфортным на любом устройстве.
  • Оптимизация для мобильных устройств: Instant View работает отлично даже на сайтах, не оптимизированных для мобильных устройств.
  • Экономия трафика: Пользователи могут экономить трафик, так как страницы загружаются быстро и без лишнего контента.
  • Простота реализации: Владельцам сайтов не нужно изменять свой сайт, чтобы использовать Instant View

Что делает плагин DLE-tg-iv?

Плагин DLE-tg-iv позволяет создать отдельный шаблон {THEME}/tg_iv.tpl, который используется для формирования версии публикации в формате Telegram Instant View. Этот шаблон поддерживает ограниченный набор тегов, что аналогично форматам Яндекс Турбо-страниц или Google AMP, но дает определенные преимущества владельцам сайтов.

Ключевые функции плагина:

  • Создание отдельного шаблона: Плагин формирует шаблон tg_iv.tpl, который позволяет использовать теги для полной новости, чтобы создать нужное отображение внутри Telegram.
  • Доступ к Instant View версии: Публикации доступны по ссылке вида https://yousite.com/tg-iv,{news-id}-.html, которую можно отправлять в Telegram.
  • Автоматизация через RSS: Плагин генерирует специальную RSS ленту site.ru/rss_tgiv.xml, которая содержит ссылки на Instant View версии публикаций. Эту ленту можно использовать для автоматической публикации в Telegram с помощью ботов. 

Установка и настройка плагина:

  1. Установка плагина: Доступен на GitHub по ссылке: https://github.com/tcse/DLE-tg-iv/
  2. Настройка шаблонов: В шаблоне fullstory.tpl добавить ссылку на Telegram Instant View.
  3. Настройка RSS: В файле .htaccess добавить правила редиректа для RSS ленты в формате Telegram Instant View.
  4. Этот плагин упрощает интеграцию вашего сайта с Telegram Instant View, делая ваш контент более доступным и удобным для пользователей Telegram.

Подробнее о плагине DLE-tg-iv

В DLE текст публикации целиком формируется шаблоном fullstory.tpl но для формата Telegram IV количество поддержимаемых тегов строго ограничено, по сути сам формат TG IV это свой аналог Яндекс Турбо-страниц или Google AMP, но если это дает некоторые бонусы владельцам сайта - надо пользоваться.

Плагин создает отдельный шаблон {THEME}/tg_iv.tpl в рамках которого можно использовать теги полной новости для формирования необходимого отображения внутри мессенджера Телеграм.

Доступ к такой версии страницы осуществляется по ссылке вида:

https://yousite.com/tg-iv,{news-id}-.html

Ее можно отправлять в телеграм и если ошибок в верстке которую поддерживает TG IV то будет сформирована "та самая" версия. Для процесса автоматизации работы с такими ссылками (не все же время их руками добавлять) в плагине присутствует отдельный файл, который создает отдельную RSS ленту сайта, которая вместо основного адреса новости, в RSS параметре link передает ссылку на /tg-iv,{news-id}-.html версию публикации. А адрес site.ru/rss_tgiv.xml - RSS лента в формате telegram instant view. Именно этот RSS вы можете отправлять телеграм ботам для автоматической публикации.

Шаблоны плагина DLE-tg-iv

/templates/rss_tgiv.tpl - формирует RSS для каждой отдельной новости
/templates/{THEME}/tg_iv.tpl - шаблон аналог fullstory.tpl но для формата TG IV

Теги используемые в шаблоне tg_iv.tpl

{category-name} - Название категории
{autor} - автор публкикации и
{alt-name} - ЧПУ новости
{date} - 2023-12-26T16:45:22+03:00
{category-alt-name} - ЧПУ категории
{og-site-name} - Названиев OpenGraph из настроек DLE
{og-description} - Описание OpenGraph из настроек DLE
{home-url} - Адрес сайта
{tg-chanel} - Имя Telegram канала, задается в админке
{tg-cover-url} - URL обложки публикации для Telegram, задается в админке
[tg-chanel] выводит текст, если тег {tg-chanel} не пустой [/tg-chanel]
[not-tg-chanel] выводит текст, если тег {tg-chanel} пустой [/not-tg-chanel
[tg-cover-url] выводит текст, если тег {tg-cover-url} не пустой [/tg-cover-url]
[not-tg-cover-url] выводит текст, если тег {tg-cover-url} пустой [/not-tg-cover-url]

Картинки можно задавать стандартными тегами 
{image-x} [image-x] текст [/image-x] [not-image-x] текст [/not-image-x

Так же поддерживается работа с дополнительными полями [xfgiven_x] [xfvalue_x] [/xfgiven_x] 
и [xfnotgiven_X] [/xfnotgiven_X]


Установка:

В шаблон полной новости fullstory.tpl добавить в нужное место ссылку на Telegram Instant View, например:

<a href="/tg-iv,{news-id}-.html" target="_blank">Telegram Instant View</a>

В файле шаблона в папке {THEME}/tg_iv.tpl обязательно оставить метатег так как именно он позволяет без каких либо проверок на стороне Telegram делать вашим страницам IV версию. Установка количества новостей экспортируемых в Telegram Instant View задается в разделе Настройки скрипта -> Настройки системы вкладка RSS вписать необходимое количество. Для получения красивого адреса rss ленты для экспорта в Telegram необходимо добавить правила редиректов.

В файл /.htaccess после строки 

RewriteRule ^rss.xml$ index.php?mod=rss [L]

вставить

RewriteRule ^rss_tgiv.xml$ index.php?mod=tg_instant_view_rss [L]

Всё. Теперь у нас есть две ленты RSS на сайте: site.ru/rss.xml - Стандартная лента движка; site.ru/rss_tgiv.xml - RSS лента в формате telegram instant view полным текстом новостей. 

Скачать плагин: https://github.com/tcse/DLE-tg-iv/releases

Комментарии

  1. TCSE (Клиенты)

    6 часов назад 63 комментария

    Небольшое уточнение:

    теги доп.полей работают только в текстовом виде :(

    Если поле будет с типом "галерея" то конструкция 

    [xfgiven_x] [xfvalue_x] [/xfgiven_x]

    выведет:

    2025-01/avtomobil-bystrogo-reagirovanija-abr.png|0|0|677x368|284.16 Kb

    а вариант [xfvalue_x image-url="1"] пока вообще вырезается.

    Так же не маловажно, что сам формат tg iv очень чувствителен к html тегам внутри шаблона.

    <div class="article">
      <article class="article__content">
                <!-- если первый элемент в статье - это рисунок, он будет установлен/использован как обложка статьи -->
                <figure>
                    <img src="{tg-cover-url}" />
                    <figcaption>{category-name}</figcaption>
                </figure>
                {full-story}
      </article>
    </div>

    если первая картинка не будет первым элементом в статье, то instant view версия может и не сгенерироваться. 

    И внешние стили по ссылкам или даже в тегах style в head шаблона так же очень не нравятся телеграму. Только инлайн стили прямо в html тегах.

Информация

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

Календарь

«    Март 2025    »
ПнВтСрЧтПтСбВс
 12
3456789
10111213141516
17181920212223
24252627282930
31 

Опрос на сайте

Совершаете ли вы покупки в интернет?