ellipseellipseillustrationillustration

Документация

Что такое тумба-превью?

Тумба-превью или картинка-превью (от англ. thumbnail - миниатюра и preview - предпросмотр) - это изображение, которое характеризует конкретную страницу сайта. Наподобие главного заголовка, который как правило один на странице, тумба-превью также задается один раз, но она также не видна на сайте.

Как устанавливать код тумбы-превью на сайт?

Ссылка на тумбу-превью ставится специальным тегом, являющимся часть OpenGraph разметки документа.
В раздел <head> всех страниц вашего сайта необходимо вставить следующий код:
Первый тег meta отвечает за название страницы, которое будет отображаться в соцсетях / мессенджерах, когда кто-то отправляет ссылку на страницу сайта. Установка этого тега является обязательным условием, что отправляемая ссылка отобразилась в виде красивого блока-превью.
Второй тег meta со значением summary_large_image является часть стандарта, разработанного компанией Twitter и заставляет блок-превью отобразиться с большой тумбой. Если не устанавливать этот тег, то изображение тумбы будет сгенерировано в виде небольшого квадратика.
И последний, третий тег meta содержит в себе непосредственно ссылку на изображение тумбы. Для того, чтобы тумба генерировалась по выбранному вами шаблону в интерфейсе Thumber.ru, необходимо установить специальный URL, отображаемый в личном кабинете для каждого прототипа.


Установка тумб-превью для разных фреймворков и CMS

После создания прототипа в конструкторе и его автоматической проверки будет доступен код на языке PHP для разных фреймворков.

Для CMS Wordpress создан специальный плагин , позволяющий устанавливать тумбы-превью на страницы постов без знаний программирования.

shadow

Что такое «прототип»? Глоссарий.

Прототип - это динамический макет тумбы-превью для вашего сайта, созданный в конструкторе сайта Thumber.ru на основе одного из доступных шаблонов.
В зависимости от выбранного тарифа может варьироваться количество доступных вебсайтов для подключения и прототипов, разрешенных для каждого вебсайта.
Метка - часть полного адреса тумбы-превью в рамках Thumber.ru, отвечающая за сбор статистики.
В рамках одного прототипа можно подключить несколько меток, чтобы, например, разделять статистику использования тумб по разным категориям сайта (если тумба ставится на новостной сайт или блог с категориями).
illustration

Можно ли использовать тумбу-превью для вывода на сайте в виде простого изображения?

Да, можно. В таком случае формат вставки немного отличается от meta:content тега.
URI текущей страницы, где размещена тумба, убирается из ссылки, но к тегу <img> добавляется атрибут referrerpolicy , чтобы при запросе тумбы браузер сам передавал URI текущей страницы вашего сайта.
Также необязательно указывать протокол для запросы тумбы, потому что в случае ее использования как картинки, браузер сделает запрос с тем же протоколом, по которому открывается ваш сайт.
illustration

Как генерировать тумбы с помощью Thumber.ru?

Необходимо зарегистрироваться на сервисе, затем добавить вебсайт в личном кабинете и подтвердить его. После процедуры подтверждения появится возможность создать прототип для тумбы в рамках конкретного вебсайта.
В конструкторе прототипов можно выбрать общие параметры тумб - тип фона, эффекты черно-белого и прозрачности, скругление углов. Затем выбирается шаблон для тумбы - их несколько и различаются они расположением элементов, стилистикой отображения названия страницы, дополнительного текста.
В конце можно увидеть, как тумба будет выглядеть в жизни, нажав кнопку "предпросмотр". Она также поможет проверить, нет ли ошибок в форме-конструктора и подробно расскажет, если что-то не так.
После сохранения прототипа он попадает на проверку. Она проводится в автоматическом режиме. В этот момент код тумбы еще не выдается и его не нужно ставить на сайт.
В рамках этой проверки робот Thumber.ru убедится, что в комбинации "ваш сайт + прототип" достаточно данных для создания тумбы. Необходимыми являются логотип (если поддерживается шаблоном прототипа) и фоновое изображение, если выбран такой тип фона, а не градиент.
shadow
illustrationillustration

Какие данные требуются для корректной работы прототипа?

Фон тумбы - если выбрать в конструкторе тип фона "изображение" (также есть опция "градиент"), то прототип будет пытаться брать фоновое изображение со страницы сайта, где установлена тумба, из атрибута data-tmb-image любого тега.
Например, такой код будет корректно найден роботом Thumber.ru
<div data-tmb-image="http://mysite.com/background.jpg"></div>
и УРЛ изображения http://mysite.com/background.jpg попадет в прототип.
А вот отсюда
<img src="http://mysite.com/background.jpg" />
или отсюда
<div>http://mysite.com/background.jpg</div>
адрес фонового изображения получен не будет.
Если фоновое изображение для всех страниц одинаковое, то УРЛ на него можно указать прямо в конструкторе прототипа. Оно используется как страховочное, потому что сначала в любом случае проверяется наличие специальной метки фона на странице сайта.
Логотип сайта - если шаблон, используемый для прототипа, поддерживает размещение логотипа вебсайта на тумбе, то логика его работы полностью аналогична фоновому изображению.
Для логотипа используется метка data-tmb-logo.
shadow
illustration

Как работает прототип после установки кода тумбы на сайт?

После создания прототипа в конструкторе и его автоматической проверки вам будет доступен код для установки на страницы сайта. Далее - дело за сервисом Thumber.ru!
Когда кто-то делится страницей вашего сайта в соцсетях или в мессенджерах, то робот этой соцсети или мессенджера идет на указанную страницу в фоновом режиме и специальным образом парсит данные оттуда. А именно - забирает название страницы, описательный текст и... правильно! тумбу-превью. А в качестве УРЛ этой тумбы установлен специальный уникальный адрес именно на ваш прототип.
Робот, в том числе, запрашивает само изображение тумбы. Thumber.ru, получая запрос на тумбу-превью, по внутренним алгоритмам определяет, была ли тумба запрошена ранее для каждой конкретной страницы, и либо генерирует ее по прототипу либо отдает ранее созданную. В случае генерации новой тумбы она загружается в сеть быстрой доставки контента (CDN), чтобы в дальнейшем отдаваться практически мгновенно (опция зависит от тарифа).
При первой генерации тумбы происходит проверка всех составляющих, аналогичная проверке при создании прототипа. Если проверка не прошла, то вы незамедлительно получите email сообщение на вашу почту с указанием обнаруженной ошибки.
После 3-х ошибок подряд прототип будет отключен, а его владельцу нужно будет устранить проблемы генерации и снова отправить его на автоматическую проверку. Вместо новых тумб будет показывать изображение-тумба по-умолчанию от сервиса Thumber.ru. При этом тумбы, ранее успешно сгенерированные по этому прототипу, будут продолжать исправно работать.
shadow
illustration

Генерация текстов на тумбе

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

Главный текст - название страницы, где установлена тумба. Метка data-tmb-big_text.

Такую метку можно установить главному заголовку страницы <h1> и тогда этот текст будет браться из него.

Если метка на странице не найдена, то текст будет взят из первого заголовка <h1> при его наличии.

Текст-описание - вторичный (более мелкий) текст с кратким описанием страницы. Метка data-tmb-small_text.

Можно, например, установить эту метку тегу первому параграфу с текстом на странице, если он у вас есть.

Если метка на странице не найдена, то текст будет взят из первого параграфа <p> или первого заголовка 2го уровня <h2> при их наличии.

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

Метка для слогана на страницах сайта - data-tmb-motto.

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

Цепочка жизни прототипа

Все прототипы работают в течение всего времени, оплаченного по тарифу. Если тариф истек, а следующий период оплачен не был, то прототипы, не входящие в квоту бесплатного тарифа, деактивируются.
Неактивные (деактивированные) прототипы находятся в таком статусе 7 дней. После этого срока прототип окончательно удаляется вместе со всеми ранее сгенерированными тумбами.
Если в течение этого периода оплатить тариф, в квоту (лимиты) которого войдет прототип, то он будет автоматически активирован обратно и начнет работать снова. Все ранее сгенерированные тумбы станут доступны мгновенно.