Статьи

Почтовые форматы внутри и снаружи

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


Форматы сообщений были введены в WordPress 3.1 для стандартизации создания и отображения различных типов сообщений. Эти форматы позволяют разработчику решать, как отображать различные виды сообщений в соответствующих модах. Новые форматы не могут быть введены, и каждый формат не должен поддерживаться темой. Использование почтовых форматов обеспечивает совместимость постов в нескольких темах и имеет много других преимуществ.

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


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

Откройте файл functions.php в папке / wordpressdirectory / wp-content / themes / двадцать двадцать / . Обратите внимание, что в строке 81 мы видим следующее:

1
add_theme_support( ‘post-formats’, array( ‘aside’, ‘gallery’ ) );

По умолчанию тема двадцати десяти поддерживает форматы постов Aside и Gallery. Как уже упоминалось в обзоре, вы не можете определить любой формат поста, кроме того, что позволяет WordPress. Давайте посмотрим, что мы можем добавить. Они взяты прямо из Кодекса WordPress о форматах сообщений :

  • в сторону – как правило, без заголовка. Похоже на обновление заметки Facebook.
  • галерея – галерея изображений. Сообщение, скорее всего, будет содержать короткий код галереи и будет иметь прикрепленные изображения.
  • ссылка – ссылка на другой сайт. Темы могут использовать первый тег <a href=””> в содержимом сообщения в качестве внешней ссылки для этого сообщения. Альтернативный подход может быть, если сообщение состоит только из URL, тогда это будет URL, а заголовок (post_title) будет именем, прикрепленным к якору для него.
  • изображение – одно изображение. Первый тег <img /> в посте можно считать изображением. Кроме того, если сообщение состоит только из URL-адреса, это будет URL-адрес изображения, а заголовок сообщения (post_title) будет атрибутом заголовка изображения.
  • цитата – цитата. Вероятно, будет содержать блочную цитату, содержащую содержание цитаты. В качестве альтернативы цитата может быть просто содержанием, а заголовок – источник / автор.
  • status – короткое обновление статуса, аналогичное обновлению статуса Twitter.
  • видео – одиночное видео. Первый тег <video /> или объект / встроенный в содержимое публикации можно считать видео. В качестве альтернативы, если сообщение состоит только из URL, это будет URL видео. Может также содержать видео в качестве вложения в сообщение, если в блоге включена поддержка видео (например, через плагин).
  • аудио – аудиофайл. Может быть использован для подкастинга.
  • чат – стенограмма чата.

Ради учебника мы добавим поддержку видео и ссылку. Итак, давайте обновим строку 81 в этом коде, чтобы отразить эти форматы. Мы просто добавим их в массив.

1
add_theme_support( ‘post-formats’, array( ‘aside’, ‘gallery’, ‘link’, ‘video’ ) );

Как только мы добавим это, мы можем перейти к добавлению сообщения, и мы заметим переключатели в правом столбце, которые отражают «Ссылка» и «Видео».


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

Откройте файл loop.php в том же каталоге, в котором находился файл functions.php. Примерно до строки 126 код определяет формат для галереи и в стороне; после строки 126 определяется, как должны выглядеть все остальные сообщения. Таким образом, если вы откроете свой веб-сайт сейчас, ваша ссылка будет отформатирована, как и все другие сообщения, с заголовком сообщения, который переносит его на постоянную ссылку, и телом, содержащим нашу ссылку. Мы собираемся добавить следующий код в строку 126, чтобы изменить это:

1
2
3
4
5
<?php elseif ( ( function_exists( ‘get_post_format’ ) && ‘link’ == get_post_format( $post->ID ) ) ) : ?>
 
    <div id=”post-<?php the_ID(); ?>” <?php post_class();
        <h2 class=”entry-title”><a href=”<?php echo get_the_content(); ?>” title=”<?php printf( esc_attr__( ‘Permalink to %s’, ‘twentyten’ ), the_title_attribute( ‘echo=0’ ) ); ?>” rel=”bookmark”><?php the_title();
    </div>

По сути, мы добавляем еще один оператор if, прежде чем он достигнет выражения «Все остальное». Мы говорим, что если это ссылка, отобразите ее следующим образом. И мы хотим, чтобы это отображалось, делая контент частью ссылки, сохраняя заголовок и удаляя контент под ним. Обратите внимание, что я использовал get_the content вместо просто the_content здесь. the_content автоматически добавляет теги абзаца, get_the_content дает мне неформатированный текст. Так что это легко обойти.

Теперь, если мы посмотрим на наш сайт – ссылка ведет себя как положено! Очень круто!


Давайте создадим новый пост, содержащий видео на YouTube. Мы можем заполнить заголовок, если захотим – для этого поста это не понадобится. Я буду в этом случае. Мое видео на YouTube о моем друге, играющем «Почти любовник» от Fine Frenzy. Так что мой пост будет выглядеть так:

Мы добавим к концу код, который мы создали на шаге 2. Поэтому мы вернемся к loop.php и добавим следующий код:

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
<?php elseif ( ( function_exists( ‘get_post_format’ ) && ‘video’ == get_post_format( $post->ID ) ) ) : ?>
    <div id=”post-<?php the_ID(); ?>” <?php post_class();
        <?php if(strlen( get_the_title() ) >0 ): ?><h2 class=”entry-title”><?php the_title();
         
        <div class=”entry-content”>
                <?php
                $parsedUrl = parse_url(get_the_content());
                $embed = $parsedUrl[‘query’];
                parse_str($embed, $out);
                $embedUrl = $out[‘v’];
                ?>
            <iframe width=”560″ height=”349″ src=”http://www.youtube.com/embed/<?php echo $embedUrl; ?>” frameborder=”0″ allowfullscreen></iframe>
        </div>
    </div>
     
    <?php /* How to display all other posts.

Мы создаем еще один оператор if для видео, а затем говорим, что если у него есть заголовок, отобразим его. Тогда есть некоторые полезные фрагменты кода, которые вы, возможно, захотите сохранить в своей собственной библиотеке. Я проанализировал содержимое, чтобы найти идентификатор YouTube и создать код для встраивания. Обратите внимание, как вы смогли поместить ссылку на YouTube http://www.youtube.com/watch?v=Wu9lWnNsFu4 вместо кода для встраивания. Это добавит удобства конечным пользователям, так что все видеоплееры будут выглядеть одинаково. и им не придется расшифровывать коды для встраивания. По сути, я могу найти идентификатор видео с кодом, а затем создать из него код для встраивания с помощью переменной $ embedURL.

Теперь, если вы зайдете на свой сайт, вы увидите встроенное видео YouTube. Такой легкий трюк!


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

Откройте sidebar.php и в строке 11 добавьте:

1
2
3
4
5
6
<li id=”archives” class=”widget-container”>
    <h3 class=”widget-title”>Post Formats</h3>
    <ul>
        <li><a href=”<?php echo get_post_format_link(‘video’); ?>”>Videos</a></li>
    </ul>
</li>

Посмотрите на боковой панели, теперь вы увидите ссылку, которая идет на видео. Функция get_post_format_link () создаст ссылку на архив форматов записей, которые поддерживаются темой и указываются в функции. Замените видео ссылкой, сайтом или галереей, и оно создаст ссылку на соответствующий архив.


Мы использовали функцию get_post_format ($ post_id) в наших примерах, чтобы определить, как должен отображаться пост. Что-то еще похожее на это было бы, если бы вы хотели иметь общий способ отображения всех сообщений, но добавить определенные элементы, если это был определенный формат сообщений. Поэтому, если я хочу добавить отказ от ответственности ко всем моим ссылкам, я мог бы создать общий цикл это будет показывать все мои сообщения, независимо от того, в каком они формате, а затем использовать функцию has_post_format (), чтобы определить это в моем цикле:

1
2
3
4
5
<?php if(has_post_format(‘link’,$post_id)): ?>
<blockquote>
I have no idea what will be on the site by the time you get there.
</blockquote>
<?php endif;

Почтовые форматы действительно просты в использовании и понимании. Из нашей тяжелой работы выше вы можете увидеть, как быстро можно настроить ее в своей собственной теме и запустить. Это такая замечательная кросс-тематическая стандартизация, которая освобождает пользователей от злого понимания запатентованной темы.