Вход для клиентов и партнеров
в начало сайта
Партнерская программаОнлайн демоСкачатьКарта сайта
 

Регламент
Документация
Часто задаваемые вопросы (FAQ)
Решения типовых вопросов
Форум поддержки
Библиотека разработчика

Посмотрите демо-ролики и убедитесь в том, что "Twilight CMS" очень удобна в управлении, понятна и проста.

Бесплатно скачайте "Twilight.Basic", установите на своем компьютере и изучите систему более детально.

Если вам нужно установить "Twilight CMS" на существующий сайт или разработать новый - обращайтесь в отдел интеграции.

 

Ваше имя
Ваш Email
Вопрос
Twilight.basic
  • Узнайте больше
  • Сравните версии
  • Twilight.selection
  • Узнайте больше
  • Сравните версии
  • Twilight.evolution
  • Узнайте больше
  • Сравните версии
  •  
    Главная // Библиотека разработчика // Справочники // Форматы служебных файлов //

    preferences.xml


    Файл preferences.xml в папке Preferences содержит различные настройки, которые разработчик определяет при создании сайта.

    Также, есть еще два файла аналогичного формата, которые можно разместить в корневой папке веб-сервера (на том же уровне что и Admin, Bin, Sites и пр.). Файл preferences_override.xml позволяет переопределить нужные ключи принудительно для всех сайтов в папке Sites. Файл preferences_default.xml позволяет задать значения ключей, которые будут использоваться только в том случае, если у какого-то сайта в папке Sites они не определены.

    Перечень доступных опций (названия case-sensitive) приведен ниже. Пара замечаний:

    1. Все установки-«переключатели» (если не указано обратного) для своего активного положения используют одно из значений true1,  on или yes. Любое другое строковое значение, пустое значение или отсутствие тэга-ключа в файле интерпретируется как неактивное положение «переключателя».

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

    • autobackups - переключатель режима автоматического создания критических бэкапов. По умолчанию данная опция включена. Система раз в сутки в ночное (по серверному времени с 3 ночи до 9 утра) создает критические бэкапы в папке Backups, восстановление которых возможно только вручную опытным администратором. Подробнее см. описание данной опции в статьях TSDN.
    • checkpr - переключатель режима проверки Google PageRank (PR) страниц в админзоне, значение отображается под редактором страницы.
    • correct_image_tags - переключатель режима дополнения тэгов IMG недостающими параметрами height и width. Если в теле полностью сформированной HTML страницы для какого-то тэга IMG не указаны оба параметра width и height, то Система определяет актуальные высоту и ширину картинки на диске и проставляет их в HTML принудительно.
    • cryptfilelinks - переключатель режима автоматического шифрования ссылок на файлы в библиотеке файлов. Требуется для сайтов с ограничением скачивания сайтов только для зарегистрированных пользователей или для других целей. Формируемые системой ссылки на скачиваемые из библиотеки файлов файлы будут зашифрованы, так что без знания этой ссылки скачать файл будет невозможно. Шифр можно периодически менять удаляя файл cryptkey.twl в папке Data, чтобы изменить ссылки, например при утечке информации. Также, данный режим позволяет считать количество скачиваний файлов с сайта в файле downloads.dat при включенном ключе download_logger.
    • debuglogpath - путь для сохранения упрощенного лога запросов к движку. Опция рассчитана на применение на хостинг площадке, где под управлением одного движка работает много серверов, либо размещены несколько отдельных движков. Путем сведения всех логов в одно место можно отлаживать вопросы связанные с нагрузкой на сервер. В логи пишется имя сайта, страница, IP обращающегося и UserAgent. По умолчанию ключ пустой, лог не ведется. Значение - путь к папке с файлами, например c:\Logs или /usr/logs. Наличие финального слэша непринципиально. На папку должны быть права на запись файлов пользователем от имени которого работает веб-сервер.
    • default404 - псевдоним страницы, которая будет показана при наборе пользователем несуществующего адреса. Для простоты работы с документацией рекомендуется принятое нами за стандарт значение 404.
    • defaultalias - псевдоним страницы, которая будет показана при наборе пользователем имени сайта (первая страница сайта). Для простоты работы с документацией рекомендуется принятое нами за стандарт значение index.
    • defaulttemplate - шаблон страницы, который будет использоваться при генерации страницы без определенного для конкретной страницы (в файле menu.xml) шаблона.
    • default_userset - имя таблицы, которое используется макросом UserProfile по умолчанию, если не задавать в нём ключ userset.
    • default_recepient - Email, на который отправляется почта с форм сайта и служебные оповещения. Адрес должен быть оформлен в теге CDATA, например, <![CDATA[[email protected]]]>
    • default_replyto - Email, который будет прописан в поле replyto почтового сообщения. Если не определен используется значение параметра default_recepient. Поскольку почту, приходящую с сайта, отправляет почтовый робот, при попытке ему ответить письмо попадет на его ящик. Чтобы этого не случилось, необходимо определить ящик, на который будет отправляться такая почта, если понимаете что на данные письма могут ответить не глядя на адрес получателя.  Адрес должен быть оформлен в теге CDATA, например, <![CDATA[[email protected]]]>
    • default_from - Email, который будет прописан в поле from почтового сообщения. По умолчанию тот же, что и имя аккаунта для отправки почты с сервера (параметр SMTPUsername). Почтовый сервер может отказаться принимать почту от аккаунта, который не имеет прав на отсылку почты. Поэтому этот адрес требуется настраивать в соответствии с настройками почтового сервера. Адрес должен быть оформлен в теге CDATA, например, <![CDATA[[email protected]]]>
    • download_logger - переключатель режима логирования скачиваний файлов из библиотеки с сайта. Имена файлов, время, ip адрес скачавшего логируются в файл Data/downloads.dat. Работать данная опция будет только при включенной опции cryptfilelinks.
    • email_encoding - кодировка писем, отправляемых с сервера. В определенных случаях настройки Unix почтовых серверов могут принудительно перекодировать почту и делать ее нечитаемой. В таких случаях настраивается кодировка (почти всегда спасает KOI8-R).
    • forum_newmessage_notification_label - метка шаблона email , посылаемого администратору сайта для отправки в момент появления нового сообщения в форуме. Если метка пустая или параметр не задан - письма-оповещения не отправляются.
    • forum_newmessage_notification_for_user_label - метка шаблона email, посылаемого пользователю форума, установившему признак "отправлять ответы на моё сообщение" в момент появления ответа. Если метка пустая или параметр не задан - письма-оповещения не отправляются.
    • graphic_library - приоритет использования графических библиотек для операций с изображениями. Данная функция введена в основном для двух целей: блокировки работы с ImageMagick если он установлен но работает некорректно и для принудительного использования библиотеки GD или отключения работы с обоими библиотеками. Ключ может быть одним из значений: ImageMagick, GD, none. Если не задать данный ключ совсем или он пустой, Система будет использовать библиотеку ImageMagick. Если задан ключ ImageMagick, но библиотека не найдена, будет автоматическая попытка использовать GD. Если задан приоритет GD , а библиотеки GD на сервере нет - Система с графикой работать вообще не будет. Если задать ключ none - также с графикой Система работать не будет.
    • HistoryDepth - количество последних версий страницы, сохраняющихся на сервере в процессе ее редактирования (папка Content/Versions). По умолчанию имеет значение 5. Увеличение этого числа приведет к более быстрому расходованию дискового пространства на сервере.
    • html_cache - переключатель режима кэширования страниц сайта. Отключать кэширование чаще всего нужно при разработке сайта, при публикации на хостинг площадке - практически обязательно нужно включать.
    • html_compress - переключатель режима компрессии страниц методом gzip при выдаче клиенту. Отключать сжатие нужно только на Unix хостингах, где не установлены библиотеки zlib, либо, если сжатие осуществляется внешними средствами.
    • html_encoding - кодировка, прописываемая в метатеге заголовка страниц сайта.
    • jsformprotect - защита форм и форума от спама скриптами-ботами, которые спамят в автоматическом режиме без участия человека. Защита требует включенного Javascript в браузере. Если у вас много клиентов с браузерами без Javascript, вы можете потерять много заявок. Соблюдайте разумную осторожность применяя этот режим.
    • maxuploadsize - задание максимального размера файла для загрузки на сайт через формы в байтах. Если ключ не определен используется значение 30000 байт. Ключ игнорируется, если не включена загрузка на сайт ключом uploadfilesenabled. Обязательно прочитайте описание макроса Form.
    • memcached - сервер:порт memcached сервера, если используется. Позволяет писать страничный кэш не только на диск, но в memcached для отдачи в nginx или другими способами и разгружать тем самым дисковую систему. Подробнее см. в статье.
    • memstashport - порт для внешнего веб-сервера, для отдачи содержимого папок Images, Cache, Uploads, Templates. Опция рассчитана на применение веб-сервера memstash, но могут применяться и другие специализированные сервера типа nginx, lighttpd, squid и т.п. при необходимости. Предназначена для ускорения работы и снижения нагрузки на веб-сервер.
    • parallelize - перечень доменов, или префиксов следующего уровня к "текущему доменному имени без www" для распараллеливания запросов к статическому контенту. Домены или префиксы перечисляются через запятую, пробелы игнорируются. Подробно о данной опции написано в статье.
    • search_logger - переключатель режима логирования поисковых запросов. Все что вводят пользователи в форму поиска по сайту (через макрос $SearchResult[]$) логируется в файл Data/searchterms.dat.
    • sendmail - lля Unix серверов строка запуска sendmail с параметрами, который требуется для отправки почты сайтом. По умолчанию имеет стандартное минимальное значение /usr/sbin/sendmail -t. Описание возможных ключей следует смотреть в документации к sendmail, postfix и т.п. в зависимости от существующих системных настроек. Значение следует обрамить в <![CDATA[]]> для валидного XML. Дополнительно см. примечание ниже.
    • SMTPServer - имя или IP адрес SMTP сервера, через который производится отправка Email с сайта. Дополнительно см. примечание ниже.
    • SMTPPort - порт SMTP сервера, через который производится отправка Email с сайта. По умолчанию имеет стандартное значение 25.
    • SMTPUsername, SMTPPassword - имя и пароль аккаунта, через который производится отправка email с использованием аутентификации. Строки должны быть оформлены в теге CDATA , например <![CDATA[[email protected]]]>, <![CDATA[parol]]>.
    • staticmap - переключатель режима статического кэширования. Требует настроенного для работы с RewriteMap сервера Apache или аналогичных модулей для других серверов. См. статью для подробного описания режима.
    • stratastat - переключатель режима работы модуля бизнес аналитики "Стратастат". Для отображения модуля в админзоне воспользуйтесь комментариями по установке Twilight.Evolution.
    • uploadfilesenabled - переключатель режима загрузки файлов на сервер через формы обратной связи пользователями. Обязательно прочитайте описание макроса Form перед включением данной возможности.

    Пример:
    чтобы включить кэширование на сайте нужно добавить секцию или изменить значение уже существующей секции в preferences.xml таким образом:

    <html_cache>on</html_cache>

    Также, можно для удобства чтения писать на нескольких строках, применять отступы и т.п.:

    <html_cache>
        on
    </html_cache>

    Примечание по ключам, необходимым для настройки отправки почты с сервера

    В "Twilight CMS" вплоть до версии 4.45 применялась схема, при которой CMS определяла на какой операционной системе она работает и если это был unix - использовала схему отправки через программу sendmail, а если windows - пыталась отправить почту через внешний SMTP сервер. Соответственно, ключ sendmail применялся исключительно под unix хостингом, а на windows площадке игнорировался, а ключи SMTPServer/SMTPPort/SMTPUsername/SMTPPassword - наоборот.

    Начиная с версии 5 система работает следующим образом:

    • Если задан ключ SMTPServer, то используется отсылка через внешний ("свой") SMTP сервер. Данная опция доступна на любых площадках и рекомендуется к использованию как наиболее надежный вариант в плане доставки почты, либо когда на unix хостинге нестандартно или некорректно настроен sendmail.
    • Иначе, если задан ключ sendmail, будет использоваться отправка через sendmail. При этом ключ начиная с версии 5 не имеет никакого значения "по умолчанию", то есть если он не задан - система будет использовать следующий вариант.
    • Если не задан ни один ни другой ключи, то система попробует отправить сообщение напрямую через сервера, указанные в MX записях домена, который фигурирует в почтовом адресе. Этот способ является достаточно ненадежным, поскольку если на сервере-получателе будет перегружен канал, или включен graylisting - письмо не будет доставлено. Поэтому данный вариант предлагается использовать только в крайнем случае.

    Если по какой-то причине системе не удается инициализировать объект, отвечающий за отправку почты с сервера, будет сообщение в файле Data/Logs/error.log.

    Проблемам настройки исходящей почты на сервере посвящена статья http://www.twl.ru/tsdn/installation_errors_and_sysadmin_questions/email_configure.

    « к списку

    версия для печати

     
    © 2003-18 Страта Технологии (создание сайтов, разработка cms), Twilight CMS in english.
    Наш адрес: Москва, пр. Маршала Жукова д.51
    Тел.: (495) 222-6436, E-mail: , карта сайта, условия использования информации о CMS
    Звоните через Skype:  

    Реклама: