Shopkeeper 1.3 для MODx Evolution
Есть 3 способа установки. Выберите наиболее подходящий вам.
Рекомендуемая кодировка — UTF-8.
Автоматическая установка Shopkeeper на уже установленный MODx (рекомендуется)
- Загрузите папку shopkeeper/ в каталог assets/snippets/ на сервере.
- Переместите из архива Shopkeeper папку install/ в корень вашего сайта.
- Дополните содержимое папки assets/ файлами из папки _upload/assets/. Там находится PHx-модификатор "shk_widget", файлы сниппета "catalogView" и файлы демо-сайта (шаблон и картинки).
- Запустите установку Shopkeeper, набрав в адресной строке браузера: http://[домен сайта]/install/.
- Вы можете выбрать компоненты Shopkeeper, а также установить демо-сайт. Завершите установку.
- Войдите в панель управления сайта (http://[домен сайта]/manager/). Если сразу откроется конфигурация сайта, нажмите "Сохранить".
- Создайте в разделе каталога страницы товаров. Это могут быть домументы MODx или товары каталога Shopkeeper. Для того чтобы появилась кнопка каталога, войтите в "Конфигурацию" и заполните поле "Категория каталога по умолчанию" (ID домумента).
- Удалите папку install/. Готово.
Рекомендуется установить плагин PHx.
Также рекомендуется настроить сервер чтобы сайт работал только по одному домену (с других редирект).
Установка MODx вместе с Shopkeeper
- Скачайте и загрузите на сервер файлы свежей версии CMS MODx Evolution (1.x.x).
- Скачайте свежую версию Shopkeeper и загрузите папку shopkeeper/ в каталог assets/snippets/ на сервере.
- Дополните содержимое папки assets/ файлами из папки _upload/assets/. Там находится PHx-модификатор "shk_widget", файлы сниппета "catalogView" и файлы демо-сайта (шаблон и картинки).
- Переместите из архива Shopkeeper папку install/assets/ в папку install/ в корне вашего сайта (там уже есть такая папка, в неё будут добавлены необходимые файлы).
-
Запустите установку MODx (http://[домен сайта]/install/). На втором шаге в списке компонентов вы увидите:
Параметры (TV) - Price
Модули - Shopkeeper
Cниппеты - Shopkeeper, catalogView, include.
Завершите установку. - Рекомендуется установить плагин PHx.
- Войдите в панель управления сайта (http://[домен сайта]/manager/). Если сразу откроется конфигурация сайта, нажмите "Сохранить".
-
Создайте в разделе каталога страницы товаров. Это могут быть домументы MODx или товары каталога Shopkeeper. Для того чтобы появилась кнопка каталога, войтите в "Конфигурацию" и заполните поле "Категория каталога по умолчанию" (ID домумента).
Готово.
Рекомендуется настроить сервер чтобы сайт работал только по одному домену (с других редирект).
Ручная установка Shopkeeper на уже установленный MODx
- Загрузите папку shopkeeper/ в каталог assets/snippets/ на сервере.
- Дополните содержимое папки assets/ файлами из папки _upload/assets/. Там находится PHx-модификатор "shk_widget", файлы сниппета "catalogView" и файлы демо-сайта (шаблон и картинки).
-
- В системе управления перейдите "Элементы" -> "Управление элементами" -> "Сниппеты".
- Нажмите ссылку "Новый сниппет".
- Название сниппета: Shopkeeper,
Описание: Корзина заказов,
Открыть файл install/assets/snippets/Shopkeeper_snippet.tpl, скопировать содержимое и вставить в поле "Код сниппета".
При этом в начале и в конце кода должно быть <?php и ?>. Нажать кнопку "Сохранить".
- Таким же образом установите сниппеты catalogView и include.
-
- В системе управления перейти "Модули" -> "Управление модулями"
- Нажмите ссылку "Новый модуль".
-
Название модуля: Управление заказами,
Описание: Shopkeeper,
Открыть файл install/assets/modules/Shopkeeper_module.tpl, скопировать содержимое и вставить в поле "Код модуля". Нажать кнопку "Сохранить". - Обновить окно браузера. Перейти "Модули" -> "Shopkeeper", нажать кнопку "Установить модуль".
- Обновите содержимое папки assets/ вашего сайта, скопировав в неё файлы из папки install/_upload/assets/ из архива Shopkeeper. Там находится PHx-модификатор "shk_widget", файлы сниппета "catalogView" и файлы демо-сайта (шаблон и картинки).
- Установите плагин PHx
- Если планируется создавать товары в каталоге Shopkeeper (не документы MODx), установите плагин SaveToSHK (install/assets/plugins/savetoshk.tpl).
- Создайте чанки (или в вызове сниппета Shopkeeper укажите путь до файла шаблона) для корзины, вывода информации о товаре (при вызове Ditto), формы заказа (eForm) и т.п. Все примеры есть в папке assets/snippets/shopkeeper/chunks/ru/.
- Создайте TV для цены (например "price", тип ввода - Text).
- Создайте в разделе каталога страницы товаров. Это могут быть домументы MODx или товары каталога Shopkeeper. Для того чтобы появилась кнопка каталога, войтите в "Конфигурацию" и заполните поле "Категория каталога по умолчанию" (ID домумента).
- В шаблоне каталога вставьте вызовы сниппетов Shopkeeper и Ditto. Пример для шаблона Ditto (&tpl) - assets/snippets/shopkeeper/chunks/ru/chunk_shopStuff.tpl
Обновление
Для обновления с более ранних версий нужно удалить все файлы (кроме ваших чанков, если используются из файлов) и закачать новые. Далее просто войти в модуль (в админке), при этом произойдет обновление.
Настройка сервера
Рекомендуется настроить сервер (виртуальный) чтобы сайт работал только по одному домену (с других перенаправленные на основной).
Например сайт доступен по двум адресам - example.com (домен второго уровня) и www.example.com (домен третьего уровня). Когда посетитель заходит по какому-то из этих адресов, некоторые страницы могут быть не закэшированы. Происходит кэширование меню сайта и в нем ссылки с www и без перемешиваются. Т.е. получается как будто человек переходит с одного сайта на другой. Или этот переход происходит при отправке заказа. При этом товары, выбранные на одном сайте, не доступны на "другом".
Для сервера Apache:
Для этого в .htaccess достаточно убрать решетки (#) со строк
#RewriteCond %{HTTP_HOST} . #RewriteCond %{HTTP_HOST} !^www\.example\.com [NC] #RewriteRule (.*) http://www.example.com/$1 [R=301,L]
и указать ваш домен вместо example.com. Тогда, если человек зашел по адресу example.com, его перекинет на адрес www.example.com.
Если вам не нравится домен 3-го уровня (с www), можно сделать редирект на второй уровень:
RewriteCond %{HTTP_HOST} . RewriteCond %{HTTP_HOST} !^example\.com [NC] RewriteRule (.*) http://example.com/$1 [R=301,L]На демо-сайте используются такие правила:
RewriteCond %{HTTP_HOST} . RewriteCond %{HTTP_HOST} !^demo-evo\.modx-shopkeeper\.ru [NC] RewriteRule (.*) http://demo-evo.modx-shopkeeper.ru/$1 [R=301,L]