Создание функциональных модулей WordPress с помощью PHP

Дополнительные примеры и нестандартные решения

Сложный WP_Query с сортировкой и пагинацией

Пример запроса книг, авторами которых являются "Толстой" или "Достоевский", отсортированных по дате в обратном порядке, с постраничной навигацией:

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    'post_type'      => 'book',
    'posts_per_page' => 5,
    'paged'          => $paged,
    'meta_query'     => array(
        'relation' => 'OR',
        array(
            'key'   => '_book_author',
            'value' => 'Толстой'
        ),
        array(
            'key'   => '_book_author',
            'value' => 'Достоевский'
        )
    ),
    'orderby'        => 'date',
    'order'          => 'DESC'
);
$query = new WP_Query($args);
if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        echo '<h2>' . get_the_title() . '</h2>';
        echo '<p>Автор: ' . get_post_meta(get_the_ID(), '_book_author', true) . '</p>';
    }
    // Пагинация
    echo paginate_links(array(
        'total'     => $query->max_num_pages,
        'current'   => max(1, get_query_var('paged')),
        'prev_text' => 'Назад',
        'next_text' => 'Вперёд'
    ));
    wp_reset_postdata();
} else {
    echo '<p>Книги не найдены.</p>';
}

Результат: список из 5 книг (например, "Война и мир", "Преступление и наказание") со ссылками на следующие страницы.

Шорткод с атрибутами и кэшированием через Transients

Шорткод выводит список книг по заданному автору, кэшируя результат на час:

function my_cached_books_shortcode($atts) {
    $atts = shortcode_atts(array('author' => ''), $atts);
    $author = sanitize_text_field($atts['author']);
    if (empty($author)) return 'Укажите автора.';

    $cache_key = 'books_author_' . md5($author);
    $output = get_transient($cache_key);
    if ($output === false) {
        $query = new WP_Query(array(
            'post_type'  => 'book',
            'meta_key'   => '_book_author',
            'meta_value' => $author
        ));
        $output = '<ul>';
        if ($query->have_posts()) {
            while ($query->have_posts()) {
                $query->the_post();
                $output .= '<li>' . get_the_title() . '</li>';
            }
            wp_reset_postdata();
        } else {
            $output .= '<li>Нет книг этого автора.</li>';
        }
        $output .= '</ul>';
        set_transient($cache_key, $output, HOUR_IN_SECONDS);
    }
    return $output;
}
add_shortcode('cached_books', 'my_cached_books_shortcode');

Использование: [cached_books author="Толстой"] - выводит кэшированный список, который обновляется раз в час.

Добавление собственной колонки в админ-список записей

Для удобства можно показывать мета-поле "автор" в таблице всех книг в админке:

function my_add_book_columns($columns) {
    $columns['book_author'] = 'Автор';
    return $columns;
}
add_filter('manage_book_posts_columns', 'my_add_book_columns');

function my_show_book_author_column($column, $post_id) {
    if ($column === 'book_author') {
        $value = get_post_meta($post_id, '_book_author', true);
        echo esc_html($value ?: '-');
    }
}
add_action('manage_book_posts_custom_column', 'my_show_book_author_column', 10, 2);

В админ-таблице книг появится столбец "Автор" с соответствующими значениями.

REST API с кастомными маршрутами

Создание собственного эндпоинта для получения книг по автору:

function my_books_by_author_route() {
    register_rest_route('my/v1', '/books-by-author/(?P<author>[a-zA-Zа-я\s]+)', array(
        'methods'  => 'GET',
        'callback' => 'my_get_books_by_author',
        'args'     => array(
            'author' => array(
                'required' => true,
                'sanitize_callback' => 'sanitize_text_field'
            )
        )
    ));
}
add_action('rest_api_init', 'my_books_by_author_route');

function my_get_books_by_author($request) {
    $author = $request->get_param('author');
    $posts = get_posts(array(
        'post_type'  => 'book',
        'meta_key'   => '_book_author',
        'meta_value' => $author,
        'numberposts' => -1
    ));
    $data = array();
    foreach ($posts as $post) {
        $data[] = array(
            'id'    => $post->ID,
            'title' => get_the_title($post),
            'link'  => get_permalink($post)
        );
    }
    return new WP_REST_Response($data, 200);
}

GET /wp-json/my/v1/books-by-author/Толстой - вернёт JSON со списком книг.

Виджет с настройками и кэшированием

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

class Advanced_Book_Widget extends WP_Widget {
    function __construct() {
        parent::__construct('advanced_book', 'Продвинутые книги');
    }
    function widget($args, $instance) {
        $count  = !empty($instance['count']) ? intval($instance['count']) : 3;
        $order  = !empty($instance['order']) ? $instance['order'] : 'rand';
        $cache_key = 'widget_books_' . $this->id . '_' . $count . '_' . $order;
        $output = get_transient($cache_key);
        if ($output === false) {
            $query = new WP_Query(array(
                'post_type'      => 'book',
                'posts_per_page' => $count,
                'orderby'        => $order,
                'no_found_rows'  => true,
                'update_post_meta_cache' => false,
                'update_post_term_cache' => false
            ));
            $output = $args['before_widget'];
            $output .= $args['before_title'] . 'Книги' . $args['after_title'];
            $output .= '<ul>';
            while ($query->have_posts()) {
                $query->the_post();
                $output .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
            }
            wp_reset_postdata();
            $output .= '</ul>';
            $output .= $args['after_widget'];
            set_transient($cache_key, $output, HOUR_IN_SECONDS);
        }
        echo $output;
    }
    function form($instance) {
        $count = isset($instance['count']) ? intval($instance['count']) : 3;
        $order = isset($instance['order']) ? $instance['order'] : 'rand';
        ?>
        <p>
            <label for="<?php echo $this->get_field_id('count'); ?>">Количество:</label>
            <input id="<?php echo $this->get_field_id('count'); ?>" name="<?php echo $this->get_field_name('count'); ?>" type="number" value="<?php echo $count; ?>" min="1" max="10" />
        </p>
        <p>
            <label for="<?php echo $this->get_field_id('order'); ?>">Сортировка:</label>
            <select id="<?php echo $this->get_field_id('order'); ?>" name="<?php echo $this->get_field_name('order'); ?>">
                <option value="rand" <?php selected($order, 'rand'); ?>>Случайно</option>
                <option value="date" <?php selected($order, 'date'); ?>>По дате</option>
                <option value="title" <?php selected($order, 'title'); ?>>По названию</option>
            </select>
        </p>
        <?php
    }
    function update($new_instance, $old_instance) {
        $instance = array();
        $instance['count'] = intval($new_instance['count']);
        $instance['order'] = sanitize_text_field($new_instance['order']);
        return $instance;
    }
}

Виджет отображает заданное число книг (кэшируется) и позволяет настраивать сортировку через админку.