Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Добавил описание нового раздела в miniShop2 - Утилиты #728

Closed
wants to merge 5 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/components/minishop2/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,14 @@ items: [
{ text: 'Настройки', link: 'interface/settings' },
{ text: 'Галерея', link: 'interface/gallery' },
{ text: 'Менеджер задач', link: 'interface/task-manager' },
{
text: 'Утилиты',
link: 'interface/utilities/',
items: [
{ text: 'Галерея', link: 'interface/utilities/gallery' },
{ text: 'Импорт', link: 'interface/utilities/import' },
],
},
],
},
{
Expand Down
23 changes: 23 additions & 0 deletions docs/components/minishop2/interface/utilities/gallery.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Галерея

**miniShop2 >= 4.2.2**

Обновление всех изображений товаров согласно указанным параметрам.

Параметры указаываются в настройках источника файлов.
В интерфейсе предусмотренна ссылка для быстрого перехода к необходимому источнику для внесения изменений.

Пошаговая инструкция:
- проверить параметры ресайза изображений
- установить сколько товаров обрабатывать за 1 итерацию
- запустить обработку, нажав на кнопку **Обновить**

::: warning
Количество обрабатываемых товаров необходимо устанавливать в зависимости от параметров вашего сервера.
Чем больше изображений в галерее каждого товары, тем меньшее число лучше прописывать.
Если указать слишком большое значение, обработка галереи будет прервана по таймауту.
:::

### Интерфейс

[![Обновление превью miniShop2](https://file.modx.pro/files/e/a/6/ea60b490b01a83f1f67f7be0217c9a15.png)](https://file.modx.pro/files/e/a/6/ea60b490b01a83f1f67f7be0217c9a15.png)
46 changes: 46 additions & 0 deletions docs/components/minishop2/interface/utilities/import.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Импорт

**miniShop2 > 4.2.2**

Интерфейс для *переработанного встроенного* скрипта импорта (встроен с версии 2.1.4)
Позволяет импортировать новые товары в каталог или обновить уже имеющиеся из файла **CSV**.

- Использует процессоры для импорта ресурсов и изображений.
- Умеет обновлять ресурсы по указанному ключевому полю.
- Поддерживает ТВ параметры и поля товаров, включая JSON типа size и color.
- Есть режим отладки, с обработкой только первой строки файла.

[![Интерфейс импорта товаров miniShop2](https://file.modx.pro/files/7/e/2/7e2921a4ffdf3e8d3ba6f0114f502dd6.png)](https://file.modx.pro/files/7/e/2/7e2921a4ffdf3e8d3ba6f0114f502dd6.png)

## Настройки
1. **Файл для импорта** (на данный момент поддерживается только CSV)
2. **Поля импорта**, через запятую

::: info
Поле **parent** является обязательным
:::

Поля можно сохранить в системные настройки, если нажать на иконку рядом с полем

::: warning
Системные настройки кешируются, чтобы использовать ранее сохраненные настройки необходимо очистить кеш
:::

Если нет необходимости сохранять, то кеш можно не трогать.

**Можно использовать не только поля ресурса, но и:**

- Массивы свойств товара: «size,size,size,color,color»
- Изображения для галереи: «gallery,gallery,gallery»
- ТВ параметры (слово «tv» + id параметра): «tv1,tv2,tv3»


4. **Разделитель колонок в файле**. Также можно сохранить для последующего использования
5. **Обновить товары**, если выбрать данный пункт, то появится поле по которому будет происходить обновление товаров (его значение должно быть уникальным)
6. **Режим отладки**, останавливает выполнение скрипта после обработки первой строки
7. **Использовать планировщик**, необходимо установить компонент <a href="https://modstore.pro/packages/utilities/scheduler" target="_blank">Scheduler</a>
8. **Пропускать первую строку-шапку**

::: tip
Большие файлы лучше импортировать с помощью планировщика, так как через браузер выполнение скрипта ограничено настройками сервера (обычно 30 секунд)
:::
6 changes: 6 additions & 0 deletions docs/components/minishop2/interface/utilities/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Утилиты miniShop2

Удобные утилиты для разработчиков, облегчающие рутинные задачи.

- [Галерея (обновление превью)](/components/minishop2/interface/utilities/gallery)
- [Импорт](/components/minishop2/interface/utilities/import)