Как создать автоматический импорт данных из Excel в WordPress

Часто возникает задача автоматизировать импорт данных из файлов Excel (.xlsx или .xls) в WordPress — будь то для создания записей, пользовательских типов записей, категорий или других элементов. В этой статье подробно рассмотрим, как реализовать автоматический импорт из Excel с помощью PHP, а также какие плагины могут облегчить эту задачу.

Зачем нужен автоматический импорт из Excel в WordPress

Excel — удобный инструмент для хранения структурированных данных: списков товаров, событий, контактов и т.д. Ручное добавление данных в админке WordPress занимает много времени и подвержено ошибкам. Автоматизация импорта позволяет:

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

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

Выбор инструментов для импорта Excel в WordPress

Для работы с Excel-файлами в PHP обычно используются библиотеки:

• PhpSpreadsheet — мощная и современная библиотека для чтения и записи Excel;
• PHPExcel — устаревшая, но всё ещё встречающаяся;
• SimpleXLSX — более лёгкая и простая библиотека для чтения XLSX.

Для интеграции с WordPress можно написать собственный скрипт, либо использовать плагины, например, WP Import Ultimate с сайта WPSHOP, который умеет импортировать Excel/CSV и связывать данные с CPT, таксономиями и метаполями.

Пример: простой импорт Excel в WordPress с помощью PhpSpreadsheet

Рассмотрим пример, как создать функцию для импорта данных из Excel-файла и создания записей в пользовательском типе записи 'product'.

function wpqa_import_excel_create_posts($filePath) {
    if (!file_exists($filePath)) {
        return new WP_Error('file_not_found', 'Файл Excel не найден');
    }

    require_once ABSPATH . 'wp-content/plugins/wpqa/vendor/autoload.php'; // путь к PhpSpreadsheet

    $spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load($filePath);
    $worksheet = $spreadsheet->getActiveSheet();
    $rows = $worksheet->toArray();

    // Предполагаем: 1-я строка - заголовки: Название, Цена, Описание
    for ($i = 1; $i < count($rows); $i++) {
        $name = sanitize_text_field($rows[$i][0]);
        $price = floatval($rows[$i][1]);
        $description = sanitize_textarea_field($rows[$i][2]);

        if (empty($name)) continue;

        // Создаем запись
        $post_id = wp_insert_post([
            'post_title' => $name,
            'post_content' => $description,
            'post_type' => 'product',
            'post_status' => 'publish'
        ]);

        if (!is_wp_error($post_id)) {
            // Сохраняем цену в метаполе
            update_post_meta($post_id, '_price', $price);
        }
    }
    return true;
}

Для запуска этой функции достаточно передать путь к файлу Excel. Можно добавить обработчик загрузки файла в админке, или запускать импорт по крону.

Подключение библиотеки PhpSpreadsheet в WordPress

Для работы с PhpSpreadsheet рекомендуется использовать Composer. Если нет возможности использовать Composer, можно скачать библиотеку и разместить в папке плагина или темы, подключив автозагрузчик.

Автоматизация импорта по расписанию (Cron)

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

add_action('wpqa_daily_excel_import', 'wpqa_import_excel_cron_function');

function wpqa_import_excel_cron_function() {
    $file = WP_CONTENT_DIR . '/uploads/products.xlsx';
    wpqa_import_excel_create_posts($file);
}

// Регистрируем событие при активации темы или плагина
if (!wp_next_scheduled('wpqa_daily_excel_import')) {
    wp_schedule_event(time(), 'daily', 'wpqa_daily_excel_import');
}

Так импорт будет выполняться автоматически без вашего участия.

Использование плагина WP Import Ultimate для упрощения задачи

Если не хочется писать код, можно использовать WP Import Ultimate. Он поддерживает Excel и CSV, умеет создавать записи, назначать категории, импортировать метаданные, а также запускать импорт по расписанию.

Основные преимущества плагина:

• Простой интерфейс и настройка импортируемых полей;
• Поддержка кастомных типов записей и таксономий;
• Возможность обновления существующих записей по ID или другому уникальному полю;
• Поддержка Cron и WP CLI для автоматического запуска.

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

Обработка ошибок и логирование

При импорте важно обработать возможные ошибки — поврежденный файл, пустые строки, дублирование записей. В PHP-коде рекомендуется использовать функции WordPress для валидации и логирования ошибок. Можно сохранить логи импорта в отдельный файл или таблицу базы данных для последующего анализа.

Пример простой проверки и логирования:

function wpqa_log_import_error($message) {
    $log_file = WP_CONTENT_DIR . '/import_logs.txt';
    file_put_contents($log_file, date('Y-m-d H:i:s') . ' - ' . $message . "\n", FILE_APPEND);
}

// В обработке импорта
if (empty($name)) {
    wpqa_log_import_error('Пропущена строка с пустым названием в Excel. Строка ' . $i);
    continue;
}

Советы по безопасности при импорте Excel

Импорт данных из внешних файлов всегда несет риск. Чтобы минимизировать угрозы:

• Проверяйте и валидируйте все данные перед вставкой в базу;
• Ограничьте доступ к загрузке и запуску импорта только администраторам;
• Обрабатывайте только проверенные форматы файлов;
• Избегайте выполнения произвольного кода из Excel;
• Регулярно обновляйте используемые библиотеки.

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

Автоматический импорт из Excel в WordPress — реальная и полезная задача, решаемая с помощью кода и готовых плагинов. Если у вас небольшой проект с регулярным обновлением данных, можно написать собственный скрипт с использованием PhpSpreadsheet. Для более сложных задач и удобства использования рекомендуем плагин WP Import Ultimate.

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