Плагин позволяет приложить к каждому товару любое количество файлов и дать им описание.
Список приложенных файлов с описаниями и ссылками на файлы будет доступен посетителям магазина на карточке товара в месте, предусмотренном темой дизайна для хука frontend_product.
Плагин удобно использовать для разачи файлов, имеющих отношение к предлагаемому товару — драйверов, обновлений прошивок, инструкций и т.д.
Плагин также предоставляет методы хелпера для отображения списка файлов в любом другом месте шаблона или просто получения массива с информацией о файлах.
Максимальный размер загружаемых файлов зависит от настроек сервера, на котором установлен Магазин и плагин. Проверьте значения следующих конфигурационных переменных в файле php.ini, которые могут ограничивать размер загружаемого файла: upload_max_filesize, post_max_size, memory_limit
Показ списка файлов с помощью хука
Список файлов можно показать в месте, предусмотренном для хука frontend_product.block или frontend_product.block_aux на выбор. Выбрать можно в настройках плагина. Там же можно отредактировать шаблон, который будет показан. В шаблоне доступна переменная $attachments, предсталяющая из себя массив данных о прикрепленных файлах. Об использовании разных шаблонов для разных тем дизайна можно почитать в документации на нашем сайте.
$attachments = array(
array(
'id' => $id, /* ID записи */
'name' => $name, /* имя файла */
'ext' => $ext, /* расширение файла */
'description' => $desc /* описание файла */
'size' => $size, /* размер файла в байтах */
'url' => $url /* ссылка на файл */
),
);
Встроенный хелпер
В плагин встроен хелпер, позволяющий получить массив файлов прикреплённых к товару или готовый html-код для вставки в произвольное место шаблона страницы товара. Хелпер поддерживает как современный (Shop-Script 8.17+), так и устаревший синтаксис вызовов хелперов. Подробнее о хелпере в документации на нашем сайте
Загрузка из CSV
При импорте данных о товарах из CSV можно сразу прикреплять файлы.
- Создайте на сервере, в файл-менеджере приложения Сайт (или еще как нибудь), папку wa-data/public/site/syrattach
- Загрузите в эту папку файлы, которые должны быть прикреплены к товарам
- В файле CSV, предназначенном для импорта, добавьте одну (или нессколько) колонок "Прикрепленный файл".
- В строке с товаром укажите в этом столбце имя файла из папки wa-data/public/site/syrattach, который нужно прикрепить к этому товару
Внимание! Прикрепляемый файл должен быть строго в указанной папке. URL не поддерживаются. Указание вложенных папок тоже.
После завершения импорта файлы из папки wa-data/public/site/syrattach можно удалять.
При импорте никакие файлы не удаляются. При повторном импорте, так же как при загрузке файла с дублирующимся имененем,
файлы с одинаковыми именами не перезаписываются, новый файл добавляется с измененным именем.
