Автоматический импорт данных из Яндекс.Таблиц в WordPress

Интеграция данных из внешних таблиц в WordPress позволяет автоматизировать обновление контента и упростить управление сайтом. В этой статье мы подробно рассмотрим, как настроить автоматический импорт данных из сервиса Яндекс.Таблиц в WordPress с помощью PHP и WP-Cron. Такой подход особенно полезен для сайтов с динамическим контентом, например, каталогов, списков мероприятий, прайс-листов и т.д.

Что такое Яндекс.Таблицы и зачем их использовать

Яндекс.Таблицы — это онлайн-сервис для создания и редактирования таблиц, аналог Google Sheets. Они позволяют хранить структурированные данные в облаке и легко делиться ими через публичные ссылки или API.

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

• Простота редактирования без доступа к админке WordPress;
• Автоматическое обновление данных на сайте без ручного ввода;
• Возможность интеграции с другими сервисами Яндекса;
• Открытый доступ через API или экспорт в CSV/JSON.

Настройка доступа к данным Яндекс.Таблиц

Для автоматического импорта нам нужен публичный или доступный по API URL с данными. В Яндекс.Таблицах можно экспортировать таблицу в формате CSV или получить ссылку на выгрузку данных.

Если таблица приватная, необходимо настроить API-доступ через OAuth с использованием Яндекс.Открытой платформы, но для простоты рассмотрим публичный CSV экспорт.

Пример ссылки на CSV экспорт:

https://docs.yandex.ru/spreadsheets/d/<ID_таблицы>/export?format=csv

Где <ID_таблицы> — уникальный идентификатор вашей таблицы.

Пример функции для импорта CSV из Яндекс.Таблиц

Создадим функцию wpteam_import_yandex_tables_csv(), которая загружает CSV, парсит его и обновляет записи в WordPress.

function wpteam_import_yandex_tables_csv() {
    $csv_url = 'https://docs.yandex.ru/spreadsheets/d/ВАШ_ID/export?format=csv';
    $response = wp_remote_get($csv_url);
    if (is_wp_error($response)) {
        error_log('Ошибка загрузки CSV: ' . $response->get_error_message());
        return;
    }
    $csv_data = wp_remote_retrieve_body($response);
    if (empty($csv_data)) {
        error_log('Пустой CSV');
        return;
    }
    $lines = explode("\n", $csv_data);
    $header = str_getcsv(array_shift($lines));
    foreach ($lines as $line) {
        $row = str_getcsv($line);
        if (count($row) !== count($header)) continue;
        $data = array_combine($header, $row);
        // Пример создания/обновления поста с типом 'product'
        $post_id = wpteam_find_post_by_sku($data['SKU']);
        $post_data = [
            'post_title'   => sanitize_text_field($data['Название']),
            'post_type'    => 'product',
            'post_status'  => 'publish',
            'meta_input'   => [
                'price' => floatval($data['Цена']),
                'sku'   => sanitize_text_field($data['SKU']),
            ],
        ];
        if ($post_id) {
            $post_data['ID'] = $post_id;
            wp_update_post($post_data);
        } else {
            wp_insert_post($post_data);
        }
    }
}

function wpteam_find_post_by_sku($sku) {
    $args = [
        'post_type' => 'product',
        'meta_key'  => 'sku',
        'meta_value'=> $sku,
        'fields'    => 'ids',
        'posts_per_page' => 1,
    ];
    $posts = get_posts($args);
    return $posts ? $posts[0] : false;
}

Автоматизация импорта с помощью WP-Cron

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

Добавим в файл функций темы или плагина следующий код:

add_action('wpteam_hourly_import_event', 'wpteam_import_yandex_tables_csv');

function wpteam_schedule_import() {
    if (!wp_next_scheduled('wpteam_hourly_import_event')) {
        wp_schedule_event(time(), 'hourly', 'wpteam_hourly_import_event');
    }
}
add_action('wp', 'wpteam_schedule_import');

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

Удаление задачи при деактивации

Чтобы не оставлять мусор, при деактивации темы или плагина удаляйте задачу:

function wpteam_clear_import_schedule() {
    $timestamp = wp_next_scheduled('wpteam_hourly_import_event');
    if ($timestamp) {
        wp_unschedule_event($timestamp, 'wpteam_hourly_import_event');
    }
}

Пример использования плагина для упрощения

Если хотите не писать код, можно использовать плагин WP Remark или WPCommunity, которые поддерживают импорт из CSV и автоматизацию через WP-Cron. Это позволит легко настроить автоматический импорт без глубоких знаний программирования.

Советы и рекомендации

• Обязательно проверяйте наличие ошибок при загрузке и парсинге CSV, чтобы не нарушить работу сайта.
• Оптимизируйте количество импортируемых записей за один запуск, чтобы избежать превышения лимитов PHP или таймаута.
• Храните резервные копии данных и базы перед автоматическими обновлениями.
• Если таблица содержит большое количество данных, рассмотрите использование пагинации или пакетной обработки.

Как расширить функциональность импорта

Можно добавить поддержку других форматов, например JSON, если Яндекс.Таблицы экспортируют данные в таком виде. Также можно добавить обработку изображений, категорий и таксономий, используя стандартные функции WordPress.

Для примера, можно расширить функцию, чтобы загружать изображения по URL из таблицы и прикреплять их к постам:

function wpteam_attach_image_to_post($image_url, $post_id) {
    $image_id = media_sideload_image($image_url, $post_id, null, 'id');
    if (!is_wp_error($image_id)) {
        set_post_thumbnail($post_id, $image_id);
    }
}

Это позволит создавать полноценные карточки товаров или записей с изображениями из данных таблицы.