Art Fake Content Creator WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Плагин генерации демо контента через терминал WP CLI. Подходит для разработки, демонстраций, тестирования тем и плагинов.

Требуется PHP 8.0+, WordPress 6.0+, WP CLI.

Возможности

• Создание и удаление фейковых записей, страниц, товаров WooCommerce, изображений и таксономий.
• Поддержка профилей: настрой свои наборы данных (названия, описания, изображения).
• Гибкие команды: создавай только нужное, с нужными параметрами.
• Прогресс-бар, статистика и время выполнения.
• Расширяемая архитектура — легко добавлять новые сущности.

Установка

1. Штатным способом через админку.
   • Скачиваем релиз
   • В админке Плагины → Добавить плагин → Кнопка "Загрузить плагин"
2. Клон с GitHub

    git clone https://github.com/your-repo/art-fake-content-creator.git wp-content/plugins/art-fake-content-creator

3. Установка с релиза

   wp plugin install https://github.com/artikus11/art-fake-content-creator/releases/latest/download/art-fake-content-creator.zip --activate

4. Обновление с релиза через WP CLI

   wp plugin install https://github.com/artikus11/art-fake-content-creator/releases/latest/download/art-fake-content-creator.zip --force

Профили

Профили хранятся в папке wp-content/plugins/art-fake-content-creator/config/. В подпапках находяться тематические профили (промышленность, мода, одежда, косметика и тд)

config/
├── default/
│   ├── titles.json
│   ├── descriptions.json
│   ├── short-descriptions.json
│   ├── images.json
│   └── taxonomies.json
├── cosmetics/
│   └── ... (переопределённые данные)
└── industrial/
    └── ...

Создать свой профиль

Скопируй папку /config/default/ переименуй. Или cp -r config/default config/my-theme-demo Отредактируй файлы (titles.json, images.json и др.).

Потом использовать wp fcc post create --profile=my-theme-demo --count=5

Поддерживаемые сущности

• product - Требует Woocommerce. Поддержка simple, variable, атрибутов
• image - Загрузка с внешних URL
• taxonomy - Поддержка любых такс указанных в профиле
• attributes - Требует Woocommerce

Команды

Флаги

Общий формат:

wp fcc <entity> <action> [options]

Создать изображения

wp fcc image create --profile=cosmetics

Создать атрибуты

wp fcc attribute create --profile=industrial

Создать таксономии

# Все таксы из профиля
wp fcc taxonomy create

# Только определённые
wp fcc taxonomy create --tax=product_cat,product_brand

Создать товары WooCommerce

# Простые товары
wp fcc product create --count=5 --type=simple

# Вариативные товары
wp fcc product create --count=3 --type=variable --seed

# Вариативные и простые товары 
wp fcc product create --count=3 --type=variable,simple --seed

# Вариативные и простые товары, с разным количеством атрибутов
wp fcc product create --count=10 --type=simple --profile=industrial --seed --attr-to-use=0,-1

При указании флага --seed при создании товаров будут созданы сопутсвующие сущбности: изображения, атрибуты, таксономии если их еще нет на сайте

Удаление

# Удалить товары
wp fcc product delete --force

# Удалить таксы
wp fcc taxonomy delete --tax=product_cat,product_brand

# Удалить картинки
wp fcc image delete

# Удалить атрибуты
wp fcc attribute delete

Пример: запуск

# 1. Создать атрибуты и термины
wp fcc attribute create --profile=cosmetics

# 2. Создать категории и теги
wp fcc taxonomy create --tax=product_cat,product_tag --profile=cosmetics

# 3. Добавить изображения
wp fcc image create --profile=cosmetics

# 4. Создать 10 вариативных и 10 простых товаров
wp fcc product create --count=10 --type=variable,simple --seed --profile=cosmetics

Все фейковые объекты помечаются метой _created_for_fake_content.

Разработка

Плагин построен на модульной архитектуре:

• Команды: src/CLI/Commands/
• Менеджеры: src/Managers/
• Конфиги: config/
• Реестр сущностей: Services/EntityTypeRegistry.php

Через реестр регистрция команды для новой сущности происходит автоматически

Добавить новую сущность

Реестр сущностей: Services/EntityTypeRegistry.php метод register добавляем новую сущьность в формате

'mytype'  => [
    'label'     => 'Моя сущность', // название сущности
    'config'    => 'mytypes', // навзание профиля, из которого будут браться данные, если требуется
    'available' => true, // проверка на зависимсоть, если требуется, например нужен какой-нибудь активный плагин
    'service'   => MyTypeManager::class, // обработчика команд
    'command'   => MyTypeCommand::class, // класс команд
],

Создаем обработчик команд в папке src/CLI/Commands

namespace Art\FakeContent\CLI\Commands;

class MyTypeCommand extends BaseCommand {

    protected function get_entity_type_key(): string {

        return 'mytype';
    }


    protected function get_label_output_create(): string {

        return 'создание новой сущности';
    }


    protected function get_label_output_delete(): string {

        return 'удаление новой сущности';
    }
}

Создаем менеджер в папке src/Services/Managers

<?php

namespace Art\FakeContent\Services\Managers;

use Art\FakeContent\Utils\QueryUtils;
use Art\FakeContent\Utils\StringUtils;

class MyTypeManager extends BaseManager {

    public function create() {

        // Обработка создания сущности. 
        // С родителя приходит $this->config - данные профиля
    }

        /**
     * Подсчет количества сущностей для создания.
     *  Требуется для отображения прогреcc-бара и статистики.
     * @return void
     */
    public function prepare_create_operations(): void {
        // обработка количества
        $this->add_create_step( 'mytype', count( $this->config ) );
    }


    public function delete() {
        // Обработка удаления сущности. Удаляются только то, что создано
        // Получаем через мету _created_for_fake_content созданные сущьности
    }

        /**
     * Подсчет количества сущностей для удаления.
     *  Требуется для отображения прогреcc-бара и статистики.
     * @return void
     */
    public function prepare_delete_operations(): void {
        // обработка количества
        $this->add_delete_step( 'mytype', count( mytype_exists ) );
    }
}

В рамках одной команды методы подсчета количества запускаются раньше, чем обрабка самой команды. См. src/CLI/Commands/BaseCommand.php

Лицензия

GPLv2 или выше. Свободно используй, модифицируй, распространяй.

Благодарности

Этот плагин вдохновлён и построен на идеях замечательных инструментов и людей:

• WP CLI — за мощную командную строку, которая делает WordPress ещё свободнее.
• WooCommerce — за открытость и гибкость, позволившую легко интегрироваться.
• Unsplash, Pexels, Pixabay — за бесплатные изображения, которые можно использовать в профилях.

А также тебе, кто использует этот плагин. Пусть этот плагин сэкономит тебе часы ручной работы. 💙

Специальная благодарность

• Дмитрий @campusboy - за идеи, советы и поддержку