ePN CMS

---

Оглавление документа

• Требования к хостингу
• Установка сайта
• Расширенные настройки: Кэширование
• Дополнительная информация для разработчиков
• Частые вопросы

Требования к хостингу

Для нормальной работы сайта требуется хостинг с обязательной поддержкой:

• обработки файла .htaccess и включенным mod_rewrite;
• PHP версии 5.2 и выше;

Опциально могут присутствовать:

• MySQL версии 5.0 и выше (для использования в качестве кэша данных);
• memcached и соответствующие php модули (для использования в качестве кэша данных);
• PHP-расширение xcache (для использования в качестве кэша данных и ускорения работы скриптов);
• PHP-расширение apc (для использования в качестве кэша данных и ускорения работы скриптов);
• PHP-расширение wincache (для использования в качестве кэша данных и ускорения работы скриптов);

Абсолютное большинство популярных хостингов подходит под эти требования, но всё-таки желательно убедиться. Если хостинг не соответствует заявленным требованиям, сайт может работать неправильно или не работать вовсе.

Установка сайта

1. Распаковать все файлы из архива в корневую директорию вашего сайта.
2. Переименовать файл config.php_dist в config.php.
3. В файле "config.php" указать ключ для доступа к API, который нужно взять в личном кабинете в своём профиле. Пример указания:
   'user_api_key' => '7e6669f3369xyz0f1d1b9e1f3e26919d',
4. Указать в файле "config.php" хэш для построения диплинков, который нужно взять в личном кабинете партнёрской программы в разделе «Мои креативы». Пример указания:
   'user_deep_link_hash' => '18a775d88a5xyz06b6c3cd8fd10e3d82',
5. Дополнительно можно в том же файле указать желаемые диапазоны цен и число результатов на странице. Это позволит сделать ваш сайт отличным от других сайтов на движке ePN CMS.
6. Кроме того, можно указать язык (поддерживаются русский и английский) и валюту (поддерживаются RUR, USD, EUR, BYR, UAH, KZT).
7. Рекомендуется также настроить кэширование обращений к API любым доступным способом (см. следующий раздел).

На этом установка сайта заканчивается и можно начинать привлекать посетителей ;)

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

Расширенные настройки: Кэширование

В ePN CMS присутствует поддержка кэширования результатов обращения к API для ускорения работы сайта и снижения нагрузки на сервера ePN. По умолчанию кэширование отключено, так как на дешёвых хостингах оно не поддерживается.

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

За кэширование отвечает параметр 'cache_library' в файле настроек, и он может принимать одно из следующих значений:

• none - кэширование отключено;
• apc - кэширование в APC User Cache (требуется PHP-расширение APC);
• xcache - кэширование в XCache (требуется PHP-расширение XCache);
• wincache - кэширование в WinCache. Экспериментальная возможнось! (требуется PHP-расширение WinCache);
• memcache - кэширование в memcached, используя библиотеку pecl-memcache;
• memcached - кэширование в memcached, используя библиотеку pecl-memcached;
• mysql - кэширование в MySQL, используя библиотеку mysqli;

При кэшировании данных в memcached (независимо от используемой библиотеки) необходимо настроить дополнительные параметры:

• memcached_host - IP-адрес или домен, на котором работает memcached;
• memcached_port - номер tcp-порта, на котором работает memcached;
• memcached_pconnect - использовать "устойчивые" соединения с memcached (TRUE) или нет (FALSE). Рекомендуется оставить включенным и выключать, только если во включенном состоянии возникают какие-либо проблемы;

При кэшировании данных в MySQL необходимо настроить дополнительные параметры:

• mysql_host - IP-адрес или домен, на котором работает MySQL;
• mysql_user - имя пользователя MySQL;
• mysql_pass - пароль пользователя MySQL;
• mysql_base - имя используемой базы данные;
• mysql_persist - использовать "устойчивые" соединения с MySQL (TRUE) или нет (FALSE). Рекомендуется включить и выключать только если во включенном состоянии возникают какие-либо проблемы;

Дополнительная информация для разработчиков

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

Базовые библиотеки расположены в поддиректории "libs", а шаблоны - в "templates". Шаблонизатор не используется и шаблоны представляют собой по сути обычные PHP-скрипты со всем, что из этого следует.

Сайт свёрстан с использованием bootstrap.css. Соответственно при внесении правок рекомендуется придерживаться гайдлайнов bootstrap.css.

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

Частые вопросы

Вопрос: Можно ли вносить модификации в код CMS?
Ответ: Конечно. Если вы можете сделать лучше то мы будем только рады.

Вопрос: Я хочу установить CMS не в корневой каталог сайта, а в поддиректорию. Как это сделать?
Ответ: Мы не поддерживаем подобные инсталляции. Вы можете самостоятельно внести модификации в код CMS, но мы не даём никаких рекоммендаций.

Вопрос: я бы хотел видеть в CMS функцию XXX. Вы можете её добавить?
Ответ: Вы можете написать об этом в техподдержку. Но мы не можем обещать что добавим желаемый вами функционал. Кроме того вы можете самостоятельно модифицировать код CMS для добавления нужного вам функционала.

С уважением, Команда e-Commerce Partners Network.