Как создать автоматический импорт из внешнего источника в WordPress с фильтрацией и обработкой данных

Автоматический импорт контента из внешних источников — одна из востребованных задач для сайтов на WordPress. Особенно когда нужно регулярно подгружать свежие данные, например, новости, товары или статьи, без постоянного ручного вмешательства. В этой статье рассмотрим, как реализовать такой импорт с помощью PHP и WP Cron, научимся фильтровать и обрабатывать полученные данные, а также познакомимся с полезными плагинами, облегчающими задачу.

Почему автоматический импорт важен и какие бывают источники

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

• REST API сторонних сервисов;
• RSS-ленты;
• CSV/JSON файлы, доступные по URL;
• SOAP сервисы или FTP-серверы с выгрузками.

Выбор источника определяет метод получения данных и формат их обработки.

Настройка WP Cron для периодического запуска импорта

Для автоматизации необходим запуск задачи по расписанию. WordPress имеет встроенный механизм WP Cron, который позволяет запускать функции через определённые интервалы.

Вот как создать собственное событие:

add_action('wpcodes_import_event', 'wpcodes_run_import');

if (!wp_next_scheduled('wpcodes_import_event')) {
    wp_schedule_event(time(), 'hourly', 'wpcodes_import_event');
}

Здесь мы создаём событие, которое будет срабатывать каждый час и запускать функцию wpcodes_run_import.

Функция импорта — получение, фильтрация и добавление контента

Пример функции, которая получает данные из внешнего API, фильтрует их по дате и добавляет в публикации:

function wpcodes_run_import() {
    $response = wp_remote_get('https://example.com/api/posts');
    if (is_wp_error($response)) {
        error_log('Ошибка получения данных импорта');
        return;
    }
    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);
    if (empty($data)) {
        return;
    }

    foreach ($data as $item) {
        // Фильтрация: импортируем только записи за последние 7 дней
        $post_date = strtotime($item['date']);
        if ($post_date < strtotime('-7 days')) {
            continue;
        }

        // Проверка, существует ли уже запись с таким внешним ID
        $existing = get_posts([
            'meta_key' => 'wpcodes_external_id',
            'meta_value' => $item['id'],
            'post_type' => 'post',
            'post_status' => 'any',
        ]);
        if ($existing) {
            continue;
        }

        // Добавление записи
        $post_id = wp_insert_post([
            'post_title' => sanitize_text_field($item['title']),
            'post_content' => wp_kses_post($item['content']),
            'post_status' => 'publish',
            'post_date' => date('Y-m-d H:i:s', $post_date),
        ]);

        if (!is_wp_error($post_id)) {
            add_post_meta($post_id, 'wpcodes_external_id', sanitize_text_field($item['id']));
        }
    }
}

В примере мы получаем JSON с постами, фильтруем по дате, проверяем уникальность по внешнему ID, чтобы не создавать дубликаты, и создаём записи в WordPress.

Обработка и фильтрация данных: советы и лучшие практики

Помимо простого фильтра по дате, полезно:

• Проверять дубликаты по уникальным полям;
• Очищать и валидировать данные (sanitize_text_field, wp_kses_post и т.д.);
• Обрабатывать изображения (скачивать и устанавливать как миниатюры);
• Использовать кастомные поля для хранения дополнительной информации;
• Логировать ошибки и успешные операции для отладки.

Вот пример скачивания и установки миниатюры:

function wpcodes_set_featured_image($post_id, $image_url) {
    require_once(ABSPATH . 'wp-admin/includes/file.php');
    require_once(ABSPATH . 'wp-admin/includes/media.php');
    require_once(ABSPATH . 'wp-admin/includes/image.php');

    $tmp = download_url($image_url);
    if (is_wp_error($tmp)) {
        return;
    }

    $file = [
        'name' => basename($image_url),
        'tmp_name' => $tmp,
    ];

    $attachment_id = media_handle_sideload($file, $post_id);

    if (!is_wp_error($attachment_id)) {
        set_post_thumbnail($post_id, $attachment_id);
    }
}

Плагины для автоматизации импорта в WordPress

Если хочется готовое решение с удобным интерфейсом, советуем обратить внимание на плагины:

• WP All Import — мощный инструмент для импорта из CSV/XML с поддержкой кастомных типов записей и полей.
• WPGPT — плагин с расширенными возможностями автоматизации и интеграции с AI, может помочь в предварительной обработке контента.

Используйте WP All Import для сложных сценариев, а для кастомных решений — собственный код с WP Cron, как описано выше.

Обработка ошибок и логирование для стабильной работы импорта

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

• Использовать error_log для записи сбоев;
• Отправлять уведомления администратору при критичных ошибках;
• Добавлять метаинформацию с датой последнего успешного запуска;
• Очищать временные данные и кеш.

Например, можно добавить в функцию импорта:

if (is_wp_error($response)) {
    error_log('WPCodes Import Error: ' . $response->get_error_message());
    wp_mail(get_option('admin_email'), 'Ошибка импорта контента', $response->get_error_message());
    return;
}

Резюме и рекомендации

Автоматический импорт из внешних источников в WordPress — практическое решение, позволяющее поддерживать сайт в актуальном состоянии и расширять его функционал. Используйте WP Cron для регулярного запуска, фильтруйте и валидируйте данные, внимательно обрабатывайте ошибки. Для сложных задач рассмотрите плагины WP All Import и WPGPT. Такой подход поможет автоматизировать рутинные задачи и сэкономить время на развитии сайта.