Как я сделал Telegram-шаблон для WP Telegram без ссылок в анонсе и почему это важно

Я публикую новые записи блога в Telegram-канал через плагин WP Telegram. В какой-то момент заметил проблему: если в анонсе записи попадались ссылки, пост в канале выглядел неаккуратно, превью подтягивалось не от той страницы, а виджет обсуждения на сайте писал «Discussion is not available at the moment». Разберу, как я почистил анонс от ссылок, и сразу поправлю ошибку из первой версии статьи: там были фильтры, которых в плагине нет.

Страница плагина WP Telegram в каталоге WordPress.org
Плагин WP Telegram (Auto Post and Notifications) от WP Socio в официальном каталоге WordPress

Исходный шаблон

Шаблон сообщения в настройках WP Telegram (раздел Post to Telegram) у меня был таким:

📅 <i>{post_date}</i> | ✍️ <i>{post_author}</i>
📌 <b>{post_title}</b> 📌

{post_excerpt}

{tags}

Подробнее 👉
{full_url}

Выглядит нормально, но в {post_excerpt} иногда попадали адреса: ссылки на источники, на другие статьи, партнёрские ссылки. Telegram строит превью по первой ссылке в сообщении, и вместо статьи в карточке оказывался сторонний сайт.

Сначала настройки, потом код

Прежде чем писать код, стоит проверить настройки плагина. В блоке шаблона есть:

  • Excerpt Source: откуда брать анонс. Варианты: поле «Отрывок» записи, начало текста записи или текст до тега «Далее».
  • Excerpt Length: длина анонса в словах.

Если заполнять у записей поле «Отрывок» коротким текстом без ссылок, проблема исчезает без кода. Но я хотел, чтобы анонс был чистым при любом источнике.

Свой макрос {clean_excerpt}

В первой версии статьи я приводил фильтр wptelegram_post_template_vars. Такого фильтра в WP Telegram нет, поэтому макрос и не подставлялся, а в канал уходил текст {clean_excerpt} как есть. Рабочий фильтр в актуальных версиях плагина называется wptelegram_p2tg_template_macro_values. Он получает массив значений макросов, где ключи записаны вместе с фигурными скобками:

add_filter( 'wptelegram_p2tg_template_macro_values', function ( $values, $template, $post ) {
    if ( false !== strpos( $template, '{clean_excerpt}' ) ) {
        $excerpt = get_the_excerpt( $post );
        $excerpt = wp_strip_all_tags( $excerpt );
        $excerpt = preg_replace( '~https?://\S+~u', '', $excerpt );
        $values['{clean_excerpt}'] = wp_trim_words( $excerpt, 40 );
    }
    return $values;
}, 10, 3 );

Код добавляется в functions.php дочерней темы или в небольшой собственный плагин. После этого в шаблоне можно писать {clean_excerpt}.

Вариант проще: заменить сам {post_excerpt}

Второй путь, на котором я в итоге остановился, это изменить значение стандартного макроса. Для каждого поля записи WP Telegram вызывает фильтр вида wptelegram_p2tg_post_data_ИМЯ-ПОЛЯ_value, значит для анонса это wptelegram_p2tg_post_data_post_excerpt_value:

add_filter( 'wptelegram_p2tg_post_data_post_excerpt_value', function ( $excerpt, $post ) {
    $excerpt = wp_strip_all_tags( $excerpt );
    $excerpt = preg_replace( '~https?://\S+~u', '', $excerpt );
    return trim( $excerpt );
}, 10, 2 );

Длину анонса при этом удобнее оставить на настройку Excerpt Length, чтобы не обрезать текст дважды. Теперь даже стандартный {post_excerpt} приходит в канал без ссылок.

Итоговый шаблон

📅 <i>{post_date}</i> | ✍️ <i>{post_author}</i>
📌 <b>{post_title}</b> 📌

{post_excerpt}

{tags}

🌐 Читай в блоге:
{full_url}

Ссылка на статью стоит последней и на отдельной строке, а других ссылок в тексте нет. Поэтому превью в Telegram строится именно по статье.

Про обсуждения и удалённые посты

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

Отдельной документации Telegram о том, как именно виджет сопоставляет страницу и сообщение, я не нашёл, поэтому выводы про «чистую» ссылку здесь основаны на моём опыте, а не на официальном описании.

Вывод

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

Похожие задачи для других площадок я решал в статьях про автопубликацию WordPress в X (Twitter) и автопостинг из WordPress в MAX.

Источники и ссылки


Комментарии загружаются…