Настройка содержимого WordPress

WordPress позволяет очень легко встраивать контент. Например, вы можете получить URL-адрес YouTube, вставить его в редактор сообщений и автоматически увидеть видео, встроенное в ваше сообщение. Все это работает на oEmbed , открытом стандарте того, как страница должна предоставлять данные для встраивания кода.

WordPress использует этот стандарт для получения и отображения предоставленного URL. Хотя WordPress уже давно может использовать oEmbed-провайдеров, таких как YouTube, с включением WP-API в WordPress 4.4 , WordPress теперь может функционировать как oEmbed-провайдер. Это означает, что другие сайты могут встраивать ваш контент WordPress на свои сайты так же легко, как вы можете вставлять видео в настоящее время, как указано в примере выше.

Новая функция провайдера oEmbed использует WP-API для возврата структурированных данных встраивания JSON или XML потребителям oEmbed, предоставляя им информацию, необходимую им для встраивания страницы самостоятельно. Как и все в WordPress, функциональность провайдера oEmbed легко модифицируется с помощью действий и фильтров . Давайте посмотрим, как мы можем использовать эти хуки для встраивания пользовательских типов записей.

Что мы будем строить

Мы собираемся создать простой плагин «Обновление статуса», который регистрирует пользовательский тип записи (СРТ), status-update Этот CPT просто удаляет ввод заголовка в редакторе сообщений, превращая его в функцию обновления статуса Facebook или Twitter. Мы настроим вывод oEmbed этого поста, чтобы показать имя пользователя и аватар. Вы можете увидеть конечный продукт в этом репозитории GitHub .

Настройка плагина

Перейдите в папку с pluginswp-contentsp-status-update В этом каталоге создайте файл с именем sp-status-update.php Здесь мы будем создавать основной класс плагина. Добавьте заголовок плагина в начало файла:

 /**
 * Plugin Name: Status Update
 * Plugin URI:  https://github.com/mAAdhaTTah/sitepoint-status-update
 * Description: Post your own Facebook-like status updates
 * Version:     1.0.0
 * Author:      James DiGioia for SitePoint
 * Author URI:  http://jamesdigioia.com
 * Text Domain: wp-status-update
 * Languages:   /languages
 */

Затем мы настроим основной плагин синглтон, на котором мы будем строить наш плагин:

 class SP_Status_Update {

    /**
     * Plugin instance.
     *
     * @var static
     */
    protected static $instance;

    /**
     * Retrieve the plugin instance.
     *
     * @return static
     */
    public static instance() {
        if (null === static::$instance) {
            static::$instance = new static;
        }

        return static::$instance;
    }

    /**
     * Plugin constructor.
     */
    protected function __construct() {
        // Add actions/filters here
    }
}

Наконец, нам нужно запустить плагин внизу файла:

 SP_Status_Update::instance();

Мы добавим наши хуки и фильтры в конструктор, как отмечено в комментарии.

Зарегистрировать пользовательский тип сообщения

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

     add_action( 'init', array( $this, 'register_post_type' ), 0 );

и добавьте метод регистрации в ваш класс:

     /**
     * Register the Status Update custom post type.
     */
public function register_post_type() {
    $labels = array(
        'name'                  => _x( 'Status Updates', 'Post Type General Name', 'sp-status-update' ),
        'singular_name'         => _x( 'Status Update', 'Post Type Singular Name', 'sp-status-update' ),
        'menu_name'             => __( 'Status Update', 'sp-status-update' ),
        'name_admin_bar'        => __( 'Status Update', 'sp-status-update' ),
        'archives'              => __( 'Satus Update Archives', 'sp-status-update' ),
        'parent_item_colon'     => __( 'Parent Update:', 'sp-status-update' ),
        'all_items'             => __( 'All Updates', 'sp-status-update' ),
        'add_new_item'          => __( 'Add New Status Update', 'sp-status-update' ),
        'add_new'               => __( 'Add New', 'sp-status-update' ),
        'new_item'              => __( 'New Status Update', 'sp-status-update' ),
        'edit_item'             => __( 'Edit Status Update', 'sp-status-update' ),
        'update_item'           => __( 'Update Status Update', 'sp-status-update' ),
        'view_item'             => __( 'View Status Update', 'sp-status-update' ),
        'search_items'          => __( 'Search Status Updates', 'sp-status-update' ),
        'not_found'             => __( 'Not found', 'sp-status-update' ),
        'not_found_in_trash'    => __( 'Not found in Trash', 'sp-status-update' ),
        'featured_image'        => __( 'Featured Image', 'sp-status-update' ),
        'set_featured_image'    => __( 'Set featured image', 'sp-status-update' ),
        'remove_featured_image' => __( 'Remove featured image', 'sp-status-update' ),
        'use_featured_image'    => __( 'Use as featured image', 'sp-status-update' ),
        'insert_into_item'      => __( 'Insert into Status Update', 'sp-status-update' ),
        'uploaded_to_this_item' => __( 'Uploaded to this Status Update', 'sp-status-update' ),
        'items_list'            => __( 'Status Updates list', 'sp-status-update' ),
        'items_list_navigation' => __( 'Status Updates list navigation', 'sp-status-update' ),
        'filter_items_list'     => __( 'Filter Status Updates list', 'sp-status-update' ),
    );
    $args = array(
        'label'                 => __( 'Status Update', 'sp-status-update' ),
        'description'           => __( 'Simple Status Update', 'sp-status-update' ),
        'labels'                => $labels,
        'supports'              => array( 'editor', 'author', ),
        'hierarchical'          => false,
        'public'                => true,
        'show_ui'               => true,
        'show_in_menu'          => true,
        'menu_position'         => 5,
        'show_in_admin_bar'     => true,
        'show_in_nav_menus'     => true,
        'can_export'            => true,
        'has_archive'           => true,
        'exclude_from_search'   => false,
        'publicly_queryable'    => true,
        'capability_type'       => 'page',
    );
    register_post_type( 'sp_status_update', $args );
}

Теперь мы готовы начать настраивать наш вывод oEmbed!

Прежде чем мы начнем: как работает oEmbed

Когда вы добавляете ссылку в редактор TinyMCE, откуда он знает, как встроить этот URL в ваш редактор?

Первый шаг — это открытие. oEmbed просит провайдеров «сделать обнаружение их поддержки oEmbed добавлением элементов в заголовок их существующих (X) HTML-документов». Эти элементы направляют потребителей oEmbed к конечным точкам API, которые затем обеспечивают структурированное представление встроенной публикации. oEmbed поддерживает форматы JSON и XML.

 html

 the_title

 remove_embed_title

 is_oembed

 /**
 * Returns the custom excerpt for the custom post type.
 *
 * @param  string $output Default embed output.
 * @return string         Customize embed output.
 */
public function get_excerpt_embed( $output ) {
    if ( 'sp_status_update' === get_post_type() ) {
      return get_the_content();
    }

    return $output;
}

 div

 embed_head

 head

 wp_enqueue_style

 embed_footer