Actions

Настройки по избор

From LimeSurvey Manual

This page is a translated version of the page Optional settings and the translation is 97% complete.
Outdated translations are marked like this.
Other languages:

Следващият раздел е адресиран до онези от вас, които биха искали да редактират тези настройки на конфигурацията, които не могат да бъдат променени с помощта на GUI (графичен потребителски интерфейс) на инсталацията на LimeSurvey. Моля, имайте предвид, че всички промени от основната директория на LimeSurvey се извършват на ваш собствен риск. Независимо от това, в случай, че изпитвате проблеми/имате нужда от допълнителни насоки, присъединете се към дискусионните форуми или IRC канал за помощ от общността на LimeSurvey.

Въведение

За да промените конфигурационните настройки на инсталацията, трябва да редактирате незадължителните настройки. Те могат да бъдат намерени в /application/config/config-defaults.php, който се намира в основната директория на LimeSurvey. Настройките по подразбиране на стандартната инсталация могат да бъдат намерени в config-defaults.php. Някои от тях могат да бъдат отменени чрез диалога глобални настройки, докато другите ще трябва да бъдат редактирани ръчно.

  Ако искате да промените тези настройки, моля, не ги променяйте в config-defaults.php, а копирайте конкретната настройка/ред в /application/config/config.php'' в 'config'=>array( ) и го смени там. Всички новопроменени/въведени настройки от файла config.php ще заменят стойностите по подразбиране от config-defaults.php.


Когато се извърши надграждане, се променят само настройките на config-defaults.php. Следователно редактирането на файла config.php ще запази вашите персонализирани настройки.

За да актуализирате/добавите настройките на LimeSurvey в /application/config/config.php', трябва да актуализирате конфигурационния масив: 

 !Н! 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Нова стойност', // Актуализиране на конфигурацията на LimeSurvey по подразбиране тук
 )!Н!

Yii настройки

LimeSurvey използва рамката Yii, която има свои собствени конфигурационни параметри във файла application/config/internal.php' и application/config/'config.php'. Можете също да получите достъп до някои специфични конфигурационни настройки на LimeSurvey чрез конфигурацията на Yii.

Тъй като масивът config.php е обединен с цялата конфигурация, можете да замените всички Yii параметри във файла config.php.

Специфичните настройки на Yii са зададени в масива на компонентите: 

 !Н! 'components' => array(
 'db' => array(
 ....
 ),
 'Специфични настройки'=>array(
 ....
 ),
 ),

Template:Забележка

Настройки на базата данни

Настройките на базата данни се записват в config.php от инсталационния файл, когато инсталирате LimeSurvey за първи път. Ако е необходимо, можете да актуализирате тази част от файла config.php. Моля, не забравяйте, че правите това на свой собствен риск! 

Вижте също Yii документация и моля не забравяйте, че LimeSurvey поддържа само следните типове бази данни: mysql, pgsql, dblib, mssql и sqlsrv.

Настройки на сесията

Можете да зададете някои параметри на сесията в config.php (проверете двата примера отдолу). Можете да разкоментирате/добавите необходимата част в config.php. Вижте Yii документация за други настройки.

  Ако трябва да актуализирате настройките на сесията, за да имате множество екземпляри на LimeSurvey, работещи на един и същи сървър, проверете дали не трябва да актуализирате настройките на заявката за crsf бисквитка.


Използвайте сесии, базирани на таблици

LimeSurvey може да използва сесии, базирани на таблици, намирате коментирана част в генерирания файл по подразбиране config.php. За да използвате сесия, базирана на таблици, премахнете // преди всеки ред. 

'session' => масив (
 'class' => 'application.core.web.DbHttpSession',
 'connectionID' => 'db',
 'sessionTableName' => '{{sessions} }',
 ),

Template:Предупреждение

Актуализация на други сесии

Ако използвате SSL ('https') за вашата инсталация на LimeSurvey, добавянето на следните редове към вашия config.php ще увеличи сигурността на сесията: 

 // Задайте бисквитката чрез SSL
 'session' => array (
 'cookieParams' => array(
 'secure' => true, // използва SSL за бисквитки
 'httponly' => true // Бисквитките не могат да се използват от други протоколи - експериментални
 ),
 ),

Ако искате да коригирате домейна за бисквитка, използвайте следния синтаксис в config.php: 

 // Задайте домейна за cookie
 'session' => array (
 'cookieParams' => array(
 'domain' => '.example.org',
 ),
 ),

Ако имате множество инсталации на един и същ сървър, може да бъде по-бързо и лесно да зададете различно име на сесия за всеки екземпляр на LimeSurvey. Това може да е необходимо за IE11 при някои условия (вижте проблем 12083) 

 // Задайте името на сесията
 'session' => масив (
 'sessionName' => "LimeSurveyN1",
 ),

Настройки на заявката

Настройките на заявката са важни, но настройките по подразбиране вече са оптимизирани за използване на LimeSurvey. За да прочетете повече за тях, вижте Yii документация.

Например, конфигурацията на настройките на заявката на LimeSurvey може да бъде променена по следния начин (на ваш собствен риск) : 

 // Деактивирайте CSRF защитата
 'request' => array(
 'enableCsrfValidation'=>false, 
 ),

 // Налагане на определена URL база 
 'request' => array(
 'hostInfo' => 'http://www.example.org/' 
 ),

 // Задайте името на домейна на бисквитката и пътя за CSRF защита, пътят се използва, ако имате различен екземпляр на същия домейн
 'request' => array(
 'csrfCookie' => array( 
 'domain' => '.example.com',
 'path' => '/limesurvey/',
 ) 
 ),

Ако трябва да актуализирате само URL адреса за токен имейли, задайте publicurl във вашия файл config.php.


Разрешаване на използване на сесия и Csrf валидиране в iFrame (New in 3.24.3 )

След като разрешите вграждане на Iframe, трябва да актуализирате част от конфигурацията. Внимание, дори и с всички настройки: разрешаването на формуляр в iframe може да се повреди в някои браузъри. Тези настройки бяха тествани с Firefox 81.0.2 и Chromium 85.0.4183.121.

  Attention, even with all settings : allow form in iframe can broke on some browser or with user specific settings. This settings was tested with Firefox 81.0.2 to 115 and Chromium 85.0.4183.121 to 119, and119 Edge with default settings. No support on this feature, only community support.


Разрешаване на стартиране на сесия в iframe

Сесията трябва да е защитена (валиден https), само httponly и същия сайт към None. Всички настройки трябва да бъдат зададени на малки букви. 

'session' => array (
 'sessionName'=>'LS-VBXZZORFJZCAKGYI',
 // Разкоментирайте следните редове, ако имате нужда от базирани на таблици сесии.
 // Забележка: Базираните на таблици сесии са в момента не се поддържа на MSSQL сървър.
 // 'class' => 'application.core.web.DbHttpSession',
 // 'connectionID' => 'db',
 // 'sessionTableName' = > '{{sessions}}',
 'cookieParams' => array(
 'secure' => true,
 'httponly' => true,
 'samesite' => 'Няма' ,
 ),
 ),

Разрешаване на csrf бисквитка в iframe

Същото като сесията: трябва да е защитено и същият сайт да е зададен на Няма. Целият масив трябва да бъде добавен на същото ниво като сесията. 

'request' => array(
 'enableCsrfValidation'=>true,
 'csrfCookie' => array(
 'sameSite' => 'None',
 'secure' => true,
),
 ),

URL настройки

  Ако трябва да актуализирате само URL адреса за токена и други имейли, задайте publicurl във вашия файл config.php.


За да промените настройките на URL по подразбиране, актуализирайте urlManager: 

 // Използвайте кратък URL
 'urlManager' => array(
 'urlFormat' => 'path',
 'showScriptName' => false,
 ),


Можете също така да добавите .html след идентификатора на анкетата по следния начин: 

 // Използвайте кратък URL
 'urlManager' => array(
 'urlFormat' => 'path',
 'rules' => array (
 '<sid:\d+> ' => array('survey/index','urlSuffix'=>'.html','matchValue'=>true),
 ),
'showScriptName' => false,
 ),

За повече информация проверете Yii документация.

Настройки за регистриране

Yii предоставя различни решения за генериране на регистрационни файлове. За да научите повече за тях, проверете специална тема за регистриране. LimeSurvey използва '1' или '2' по подразбиране, което позволява на всеки уеб потребител да види регистрационните файлове. Можете да създадете свои собствени настройки, като използвате директно Yii.

Например, бързо решение за регистриране на грешки и предупреждения във файлове е: 

 
return array(
 'components' => array(
 /* Друг компонент тук 'db' например */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'предупреждение, грешка',
 'except' => 'exception.CHttpException .404',
 ),
 ),
 ),
 /* Друг компонент тук 'urlManager' например */
 ),
 /* Финална част (с ' runtimePath' 'config' например) */
);
 Hint: Файлът се записва по подразбиране в <code>limesurvey/tmp/runtime/application.log</code> , който се намира в основната папка на LimeSurvey.
  Yii използва път за изпълнение. По подразбиране регистрационните файлове са достъпни в мрежата. Те могат да съдържат много информация от вашия сървър. По-добре е да използвате директория, която не може да бъде достъпна през мрежата. Можете да го зададете в маршрути или като актуализирате Runtime path.

.

Път на изпълнение

Пътят по време на изпълнение трябва да бъде четлива и записвана директория за „уеб потребителя“. Пътят по време на изпълнение обаче съдържа файлове с потенциална информация за сигурност, които се намират в зоната за публичен уеб достъп. LimeSurvey събира тези файлове във временната директория на основната директория на LimeSurvey. За да елиминирате достъпа до такива важни данни, можете да зададете пътя на изпълнение извън публичния уеб достъп, като редактирате съответните редове във файла /application/config/config.php: 

return array(
 'components' => array(
 […]
 'runtimePath'=>'/var/limesurvey/runtime/',
 'config'=>array( 
 […]
 )
 )
)

Общи настройки

  • 'sitename: Дава име на вашия сайт за проучване. Това име ще се появи в прегледа на списъка с анкети и в административния колонтитул. Стойността по подразбиране е „LimeSurvey“ и може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php.
  • 'siteadminemail:' Това е имейл адресът по подразбиране на администратора на сайта и се използва за системни съобщения и опции за контакт. Тази настройка се използва само като стойност по подразбиране и може да бъде заменена в диалоговия прозорец глобални настройки.
  • 'siteadminbounce:' Това е имейл адресът, на който ще се изпращат върнатите имейли. Тази настройка се използва само като стойност по подразбиране и може да бъде заменена от диалоговия прозорец глобални настройки.
  • siteadminname:'' Истинското име на администратора на сайта. Тази настройка се използва само като стойност по подразбиране и може да бъде заменена в диалоговия прозорец глобални настройки.
  • 'proxy_host_name:' Това е името на хоста на вашия прокси сървър (има да бъде споменат, ако сте зад прокси и искате да актуализирате LimeSurvey с помощта на ComfortUpdate).
  • 'proxy_host_port:' Това е портът на вашия прокси сървър (трябва да бъде споменати, ако сте зад прокси и искате да актуализирате LimeSurvey с помощта на ComfortUpdate).

Сигурност

  • maxLoginAttempt: Това е броят опити, които потребителят трябва да въведе правилната парола, преди той или тя да блокира/заключи своя IP адрес. Стойността по подразбиране е 3 и може да бъде променена от config.php.
  • timeOutTime: Ако потребителят въведе неправилна парола за<maxLoginAttempt> , тя или той се заключва за<timeOutTime> секунди. Стойността по подразбиране е 10 минути и може да бъде променена от config.php.
  • maxLoginAttemptParticipants: Това е броят опити, които участникът трябва да въведе валиден токен, преди той или тя да получи своя IP адресът е блокиран/заключен. Стойността по подразбиране е 3 и може да бъде променена от config.php.
  • timeOutParticipants: Ако участникът въведе токена неправилно за<maxLoginAttemptParticipants> , тя или той се заключва за<timeOutParticipants> секунди. Стойността по подразбиране е 10 минути и може да бъде променена от config.php.
  • surveyPreview_require_Auth: Задайте true по подразбиране. Ако зададете това на 'false', всяко лице може да тества вашата анкета, като използва URL адреса на анкетата, без да влиза в административния панел и без да е необходимо първо да активира анкетата. Тази настройка е стойност по подразбиране и може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php.
  • usercontrolSameGroupPolicy: Зададена на true по подразбиране. По подразбиране потребители, които не са администратори, дефинирани в интерфейса за управление на LimeSurvey, ще могат да виждат само създадени от тях потребители или потребители, които принадлежат към поне една и съща група. Стойността по подразбиране може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php.
  • filterxsshtml:'' Тази настройка позволява филтрирането на подозрителни html тагове, намиращи се в анкети, групи и текстове за въпроси и отговори в административния интерфейс. Оставете това на 'false' само ако имате абсолютно доверие на потребителите, които сте създали за администриране на LimeSurvey и ако искате да позволите на тези потребители да могат да използват Javascript, Flash филми и т.н. Супер администраторите никога не филтрират HTML . Стойността по подразбиране може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php.
  • 'demoMode:' Ако тази опция е зададена на 'true' в config.php , тогава LimeSurvey ще премине в демо режим. Демонстрационният режим променя следните неща:
    • Деактивира данните на администраторския потребител и промяната на паролата;
    • Деактивира качването на файлове в редактора на шаблони;
    • Деактивира изпращането на имейл покани и напомняния;!N !** Деактивира създаването на дъмп на база данни;
    • Деактивира възможността за промяна на следните глобални настройки: име на сайта, език по подразбиране, режим на HTML редактор по подразбиране, XSS филтър.
  • ''forcedsuperadmin:' Масив от потребителски идентификатор с всички права върху всички LimeSurvey. Тези настройки могат да се актуализират само във файла config.php. Правата на този потребител не могат да се редактират в глобални разрешения за потребител дори от друг принуден супер администратор. По подразбиране: потребител с тези права е потребител с id: 1. Първият потребител, създаден точно след инсталацията.
  • force_ssl:' принуждава LimeSurvey да работи през HTTPS или да блокира HTTPS. Вижте Force HTTPS в GUI за администриране на глобални настройки.
  • ssl_emergency_override:' Тази настройка принудително изключва SSL. Ако сте включили HTTPS/SSL в глобалните настройки, но вашият сървър не е активирал HTTPS, единственият начин да го изключите е като промените директно стойност в базата данни. Това ви позволява принудително да изключите HTTPS, докато променяте глобалните настройки за Force Secure. Това винаги трябва да е false, освен в спешни случаи, когато го промените на true, докато не отстраните проблема. Тази настройка може да бъде зададена само чрез файла config.php.
  • ssl_disable_alert:' Деактивирайте известието за супер-администратор за непринуден SSL, ако наистина не можете или не искате да принудите ssl. Тази настройка може да бъде зададена само чрез файла config.php.

Ресурси

  • 'sessionlifetime: Определя времето в секунди, след което изтича сесията на анкетата. Прилага се само ако използвате сесии на база данни. Ако все пак използвате сесии на база данни, променете параметъра в config.php или заменете стойността по подразбиране от глобални настройки диалоговия прозорец.
  • memorylimit:'' Това определя колко памет LimeSurvey може да има достъп. „128 MB“ е препоръчителният минимум (MB=мегабайт). Ако получавате грешки при изчакване или имате проблеми с генерирането на статистика или експортирането на файлове, увеличете това ограничение до „256 MB“ или по-високо. Ако вашият уеб сървър е задал по-висок лимит в config.php, тази настройка ще бъде игнорирана.
Моля, имайте предвид, че такива локални настройки винаги могат да бъдат отменени от промените, направени в диалога за глобални настройки'.

За да увеличите лимита на паметта до 128M, можете също да опитате да добавите:

  • memory_limit = 128M към главния php.ini файл на вашия сървър (препоръчва се, ако имате достъп)
  • memory_limit = 128M към php.ini файл в коренът на LimeSurvey
  • php_value memory_limit 128M във файл .htaccess в корена на LimeSurvey
  • 'max_execution_time:' Задайте броя секунди, в които е разрешено да се изпълнява скрипт. Ако това се достигне, скриптът връща фатална грешка. За да му бъде позволено да експортира данни и статистика от големи проучвания, LimeSurvey се опитва да го зададе по подразбиране на 1200 секунди. Можете да зададете по-голямо или по-ниско време, ако е необходимо. Достъпно само чрез php конфигурационен файл.

Appearance

  • 'dropdownthreshold (Obsolete since 2.50): Когато "R" е избрано за $dropdowns , администраторът има право да зададе максимален брой опции, които ще се показват като радио бутони , преди да конвертирате обратно в падащ списък. Ако има въпрос, който има голям брой опции, показването на всички наведнъж като радио бутони може да изглежда тромаво и може да стане контраинтуитивно за потребителите. Задаването на това на максимум, да речем, 25 (което е по подразбиране) означава, че големите списъци са по-лесни за използване от администраторите за участника в проучването.
  • 'repeatheadings:' С типа въпрос Array, често ще имате много подвъпроси, които - когато се показват на екрана - заемат повече от една страница. Тази настройка ви позволява да решите колко подвъпроси да бъдат показани, преди да повторите информацията в заглавието на въпроса. Добра настройка за това е около 15. Ако изобщо не искате заглавията да се повтарят, задайте това на 0. Тази настройка се отменя в диалоговия прозорец глобални настройки (New in 2.05 ) .
  • 'minrepeatheadings: Минималният брой оставащи подвъпроси, които са необходими, преди да се повторят заглавията във въпросите за масива. Стойността по подразбиране е 3 и може да се редактира в config.php.
  • defaulttemplate: Тази настройка определя темата по подразбиране, използвана за 'публичния списък' с анкети. Тази настройка може да бъде заменена в глобални настройки или редактирана в config.php.
  • 'defaulthtmleditormode:' Задава режима по подразбиране за интегрирания HTML редактор. Тази настройка може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php. Валидните настройки са:
    • 'inline' - Вградена замяна на полета от HTML редактор. Бавен, но удобен и лесен за използване;
    • „изскачащ прозорец“ – Добавя икона, която стартира HTML редактора в изскачащ прозорец, ако е необходимо. По-бързо, но HTML кодът се показва във формуляра;
    • 'няма'- Няма HTML редактор;
  • 'column_style:' Определя как се изобразяват колоните за отговорите на анкетата, когато се използва показване_колони. Може да се редактира във файла config.php. Валидните настройки са:
    • 'css' - използва един от различните CSS методи за създаване на колони (вижте таблицата със стилове на шаблона за подробности);
    • 'ul' - колоните се изобразяват като множество плаващи неподредени списъци (по подразбиране);
    • 'table' - използва оформление, базирано на конвенционални таблици;
    • NULL - забранява използването на колони.

Език и време

  • defaultlang: Това трябва да бъде зададено на езика по подразбиране, който да се използва във вашите административни скриптове, както и настройката по подразбиране за език в списъка с обществени проучвания. Тази настройка може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php.
  • timeadjust:'' Ако вашият уеб сървър е в различна часова зона от мястото, където вашите анкети ще се базират, поставете разликата между вашия сървър и вашата домашна часова зона тук. Например, живея в Австралия, но използвам американски уеб сървър. Уеб сървърът е 14 часа зад моята местна часова зона. Така че моята настройка тук е "14". С други думи, той добавя 14 часа към времето на уеб сървърите. Тази настройка е особено важна, когато анкетите отбелязват отговорите във времето. Тази настройка може да бъде заменена в диалоговия прозорец глобални настройки или редактирана в config.php.

Поведение на анкетата

  • 'deletenonvalues: Използвайте тази функция с повишено внимание. По подразбиране (стойност 1) неподходящите въпроси са NULL в базата данни. Това гарантира, че данните във вашата база данни са вътрешно съгласувани. Въпреки това, има редки случаи, в които може да искате да задържите неподходящи стойности, в който случай можете да зададете стойността на 0. Например, вие питате човек от мъжки пол за пола му и той случайно казва „жена“ и след това отговаря някаква жена - специфични въпроси (въпроси, които са обусловени от женски пол, така че са подходящи само за жени). След това той осъзнава грешката си, прави резервно копие, задава пола на „мъжки“ и продължава с анкетата. Сега специфичните за жените въпроси са без значение. Ако $deletenonvalues==1 , тези неподходящи стойности ще бъдат изчистени (NULLed) в базата данни. Ако $deletenonvalues==0 , неговите грешни отговори няма да бъдат изтрити, така че те все още ще присъстват в базата данни, когато я анализирате.
  • shownoanswer: Когато бутон за избор/изберете тип въпрос, който съдържа отговори с възможност за редактиране (т.е.: Списък, въпроси с масив) не е задължителен и 'shownoanswer' е зададено на 1, допълнителен 'Без отговор' се показва запис - така че участниците да могат да изберат да не отговарят на въпроса. Някои хора предпочитат това да не е налично. Тази настройка може да бъде заменена от диалоговия прозорец глобални настройки или редактирана в config.php. Валидни стойности са:
    • '0': No;
    • '1': Да;
    • '2': Администраторът на анкетата може да избира.
  • printanswershonorsconditions: Тази настройка определя дали функцията printanswers ще показва записи от въпроси, които са били скрити от разклоняване на условия (По подразбиране: 1 = скриване на отговорите от въпроси, скрити от условия).
  • ' hide_groupdescr_allinone:' Тази настройка е подходяща за проучвания "всичко в едно", използващи условия. Когато това е зададено на „вярно“, името и описанието на групата са скрити, ако всички въпроси в групата са скрити. Стойността по подразбиране е 'true' - скрива името и описанието на групата, когато всички въпроси в групата са скрити от условия. Може да се редактира в config.php.
  • showpopups: Показване на изскачащи съобщения, ако на задължителни или условни въпроси не е отговорено правилно:
    • '2' = определено от опцията за тема (по подразбиране )
    • '1'= показване на изскачащо съобщение;
    • '0'= вместо това показва съобщение на страницата;
    • '-1'= изобщо не показва съобщението (в този случай , потребителите ще продължат да виждат съветите за конкретни въпроси, показващи на кои въпроси трябва да се отговори).

Поведение тип числов въпрос

  • bFixNumAuto: Числовите полета могат да бъдат автоматично филтрирани, за да се премахнат всички нечислови стойности. По подразбиране това е активирано, можете да го деактивирате глобално. Тези настройки са свързани с „Автоматично коригиране на числова стойност“ в основните опции на темата. Беше разрешено за „Да“, деактивирано за „Само за израз“ и „Не“.
  • bNumRealValue:' Числовите полета, използвани в диспечера на изрази, могат да бъдат фиксирани или не. Това е фиксирано по подразбиране. Ако NUMERIC е числов въпрос: деактивирайте или 0: {NUMERIC} с лоши символи изпратете '' , активиране или 1 : {NUMERIC} изпраща всички въведени знаци. Тези настройки са свързани с „Автоматично коригиране на числова стойност“ в основните опции на темата. Беше активиран за „Да“ и „Само за изразяване“ и деактивиран за „Не“.

Разработване и отстраняване на грешки

  • debug: С тази настройка вие задавате отчитането на PHP грешки на E_ALL. Това означава, че се показва всяка малка бележка, предупреждение или грешка, свързана със скрипта. Тази настройка трябва да бъде превключена на '1' само ако се опитвате да отстраните грешки в приложението по някаква причина. Ако сте разработчик, превключете на „2“. Не го превключвайте на „1“ или „2“ в производството, тъй като това може да доведе до разкриване на пътя. Стойността по подразбиране е '0' и може да се редактира в config.php.
  • debugsql: Активирайте тази настройка, ако искате да показвате всички SQL заявки, изпълнени за скрипта в долната част на всяка страница. Много полезно за оптимизиране на броя на заявките. За да го активирате, променете стойността по подразбиране на '1' от файла config.php.
  • use_asset_manager: По подразбиране: режимът за отстраняване на грешки деактивира диспечера на активи, можете да ви позволите да използвате диспечера на активи с разрешен режим на отстраняване на грешки.

В случай, че срещнете грешка в приложението, силно препоръчваме да активирате настройката за отстраняване на грешки, за да получите по-подробна грешка, която можете да изпратите с доклада за грешка: 

!Н! 'config'=>array(
 'debug'=>2,
 'debugsql'=>0,
 )

Ако работите върху плъгин и се нуждаете от бърз начин за изхвърляне на променливи на екрана: можете да използвате функцията traceVar. Ако е зададено отстраняване на грешки: тази функция използва CWebLogRoute, за да бъде показана на HTML страница. Използване traceVar($MyVariable)

Настройки за имейл

Всички настройки отдолу могат да бъдат заменени в диалоговия прозорец глобални настройки.

  • ''emailmethod: Това определя как се изпращат имейл съобщенията. Налични са следните опции:
    • 'mail:' използва вътрешен PHP имейл;
    • 'sendmail:' използва sendmail имейл;
    • 'smtp:' използва SMTP препредаване. Използвайте тази настройка, когато изпълнявате LimeSurvey на хост, който не е вашият мейл сървър.
  • 'emailsmtphost: Ако използвате 'smtp' като $emailmethod , тогава трябва да поставите вашия SMTP сървър тук. Ако използвате Google Mail, може да се наложи да добавите номера на порта като $emailsmtphost = 'smtp.gmail.com:465'.
  • emailsmtpuser: Ако вашият SMTP сървър се нуждае от удостоверяване, задайте това на вашия потребителско име, в противен случай трябва да е празно.
  • emailsmtppassword: Ако вашият SMTP-сървър се нуждае от удостоверяване, задайте това на вашата парола, в противен случай трябва да е празно.
  • emailsmtpssl: Задайте това на 'ssl' или 'tls' за използване на SSL/TLS за SMTP връзка.
  • maxemails: Когато изпращате покани или напомняния на участниците в проучването, тази настройка се използва, за да определи колко имейла могат да бъдат изпратени в един куп. Различните уеб сървъри имат различен капацитет за имейли и ако вашият скрипт отнема твърде много време, за да изпрати куп имейли, скриптът може да изтече и да причини грешки. Повечето уеб сървъри могат да изпратят 100 имейла наведнъж в рамките на ограничението от 30 секунди по подразбиране за PHP скрипт. Ако получавате грешки при изчакване на скрипта, когато изпращате голям брой имейли, намалете броя в тази настройка. Щракването върху бутона „изпращане на имейл покана“ от лентата с инструменти за управление на токени (а не върху бутона, разположен вдясно на всеки токен) изпраща<maxemails> брой покани, след което показва списък с адресите на получателите и предупреждение, че „има повече чакащи имейли, отколкото могат да бъдат изпратени в една група. Продължете да изпращате имейли, като щракнете по-долу. Все още има ### имейла за изпращане. и предоставя „бутон за продължаване“, за да продължите със следващата група. Т.е. потребителят определя кога да изпрати следващата партида, след като всяка партида бъде изпратена по имейл. Не е необходимо да чакате с активен екран. Администраторът може да излезе и да се върне по-късно, за да изпрати следващата група покани.

Преглед на статистики и отговори

  • filterout_incomplete_answers: Контролирайте поведението по подразбиране за филтриране на непълни отговори при разглеждане или анализиране на отговорите. За дискусия относно непълните отговори вижте нашата уики за резултати от проучване за сърфиране. Тъй като тези записи могат да повредят статистиката, е дадена опция за включване или изключване на този филтър в няколко GUI форми. Параметърът може да се редактира в config.php. Налични са следните опции:
    • 'show': Позволява ви да визуализирате както пълни, така и непълни отговори;
    • 'filter': Показва само пълни отговори;
    • 'incomplete': Показване само непълни отговори.
  • strip_query_from_referer_url': Тази настройка определя дали URL адресът за препращане запазва параметъра или не. Стойността по подразбиране е „false“ (в този случай URL адресът на референта запазва всички параметри). Като алтернатива, тази стойност може да бъде зададена на „истина“ и частта от параметъра на препоръчания URL адрес ще бъде премахната.
  • 'showaggregateddata:', когато е активирана, се показват допълнителни статистически стойности, като средно аритметично и стандартно отклонение показано. Освен това данните се обобщават, за да се получи по-бърз преглед. Например, резултатите от скала 1+2 и 4+5 се добавят, за да имат общо класиране като "добър" (1/2), "среден" (3) и "лош" (4/5). Това засяга само типовете въпроси "A" (масив от 5 точки) и "5" (избор от 5 точки).
  • Настройки за експортиране на PDF: Тази функция активира експортиране на PDF за анкети за печат и за печат на отговори. Функцията за експортиране на PDF е напълно експериментална и резултатът далеч не е перфектен. За съжаление, в момента не може да бъде предоставена поддръжка - ако искате да помогнете за отстраняването му, моля, свържете се с нас.
    • 'usepdfexport': Задайте '0', за да деактивирате, и '1', за да активирате;
    • 'pdfdefaultfont': Той представлява шрифта по подразбиране, който ще се използва от функцията за експортиране на pdf. Стойността по подразбиране е „автоматично“. За да го промените, трябва да го зададете на един от PDF основните шрифтове.
    • 'alternatepdffontfile': Това е масив с езикови ключове и съответния им шрифт. Шрифтът по подразбиране за всеки език може да бъде заменен във файла config.php;
    • 'pdffontsize': показва размера на шрифта за нормални текстове; За заглавието на анкетата е<pdffontsize> +4, докато за заглавието на групата е<pdffontsize> +2. Може да се редактира във файла config.php или от диалоговия прозорец [Глобални настройки|глобални настройки]];
    • 'notsupportlanguages': включва списък с езиците, за които не е намерен PDF шрифт. Списъкът включва амхарски ('am'), сингалски ('si') и тайландски ('th') и може да бъде намерен във файла config-defaults.php;
    • 'pdforientation': Set ' L' за пейзаж или 'P' за портретен формат. Може да се редактира от файла config.php.
  • Graph setting
    • 'chartfontfile': Задава името на файла с шрифт, който се използва за създаване на статистически диаграми. Файлът трябва да се намира в директорията с шрифтове, разположена в основната папка на LimeSurvey. Може да се редактира във файла config.php;
    • 'alternatechartfontfile': Това е масив с езикови ключове и съответния им шрифт. Може да се редактира във файла config.php.
  • showsgqacode: Тази настройка се използва при функцията за проучване за печат и по подразбиране е 'false'. Ако зададете showgqacode = 'true';, идентификаторите на всеки въпрос - и отговор, ако е приложим - ще бъдат показани. Тези идентификатори съответстват на заглавието на колоната в таблицата Lime_survey_12345, която съдържа данните за отговорите за определено проучване. Тези идентификатори могат да се използват за кодова книга за ръчни заявки към база данни.

LDAP настройки

Тъй като това е обширна тема, ние преместихме LDAP настройките на друга страница.

Удостоверяване

Започвайки с LimeSurvey 2.05, удостоверяването ще се извършва от добавки. В резултат на това информацията по-долу може да е остаряла. Вижте уикито на добавките за най-актуална информация.

Делегиране на удостоверяване към уеб сървъра

Системните администратори може да поискат техните администратори на анкети да бъдат удостоверени срещу централна система за удостоверяване (Active Directory, openLdap, Radius, ...), вместо да използват вътрешната база данни на LimeSurvey. Лесен начин да направите това е да настроите софтуера на вашия уеб сървър да използва тази външна система за удостоверяване и след това да поискате от LimeSurvey да се довери на самоличността на потребителя, отчетена от уеб сървъра. За да активирате тази функция, трябва:

  • да зададете auth_webserver на 'true' в config.php;
  • да разрешите удостоверяване от страната на уеб сървъра.

Моля, имайте предвид, че:

  • LimeSurvey след това ще заобиколи собствения си процес на удостоверяване (като използва името за влизане, докладвано от уеб сървъра, без да иска парола);
  • това може да замени само системата за удостоверяване на LimeSurvey GUI, „не системата за покани за анкета“ (интерфейс за участници).

Делегиране на удостоверяване без автоматично импортиране на потребител

Моля, имайте предвид, че делегирането на удостоверяване не заобикаля системата за оторизация на LimeSurvey по подразбиране – което означава, че дори и да не се налага да управлявате пароли в LimeSurvey, пак трябва да дефинирате потребителите в базата данни на LimeSurvey и да им присвоите правилния набор от права, за да им позволите достъп до административния панел.

След това на потребител се предоставя достъп до LimeSurvey, ако и само ако:

  • той е бил удостоверен на уеб сървъра;
  • неговото име за вход е дефинирано като потребител в потребителската база данни на LimeSurvey (след това на потребителя се предоставя привилегии на потребителя, дефиниран в потребителската база данни на LimeSurvey).

Делегиране на удостоверяване с автоматично импортиране на потребител

Когато управлявате огромна потребителска база данни, понякога е по-лесно автоматично да импортирате потребители в базата данни на LimeSurvey:

  • 'auth_webserver_autocreate_user: Ако е зададено на 'true', LimeSurvey ще се опита автоматично да импортира потребители, удостоверени от уеб сървъра, но все още не е в неговата потребителска база данни.
  • auth_webserver_autocreate_profile: Масив, описващ профила по подразбиране, който ще бъде присвоен на потребителя, включително пълното (фалшиво) име, имейл и привилегии.

Ако искате да персонализирате потребителския профил, така че да съответства на влезлия потребител, ще трябва да разработите проста функция, наречена hook_get_autouserprofile - с тази функция можете да извличате от централна база данни с потребителски акаунти (за например от LDAP директория) истинското пълно име, имена и имейл на конкретен потребител. Можете дори да персонализирате неговите привилегии в системата въз основа на групите, които са му разпределени във външната база данни.

Функцията hook_get_auth_webserver_profile приема потребителското име за вход като единствен аргумент и може да върне:

  • False или празен масив - в този случай на потребителя е отказан достъп до LimeSurvey;
  • масив, съдържащ всички общи записи в потребителския профил, както е описано в $WebserverAuth_autouserprofile
function hook_get_auth_webserver_profile($user_name)
{
     // Retrieve user's data from your database backend (for instance LDAP) here
     ... get $user_name_from_backend
     ... get $user_email_from_backend
     ... get $user_lang_from_backend
     ... from groups defined in your backend set $user_admin_status_frombackend_0_or_1
     return Array(
                     'full_name' => "$user_name_from_backend",
                     'email' => "$user_email_from_backend",
                     'lang' => '$user_lang_from_backend',
                     'htmleditormode' => 'inline',
                     'templatelist' => 'default,basic,MyOrgTemplate',
                     'create_survey' => 1,
                     'create_user' => 0,
                     'delete_user' => 0,
                     'superadmin' => $user_admin_status_frombackend_0_or_1,
                     'configurator' =>0,
                     'manage_template' => 0,
                     'manage_label' => 0);
}

     // If user should be denied access, return an empty array

     // return Array();
  Опционалната функция 'hook_get_auth_webserver_profile' е само за напреднали потребители! За повече подробности, моля, прочетете коментарите от файла config-defaults.php.


Съпоставяне на потребителско име

В случай, че някои потребители имат външно потребителско име, което е различно от тяхното потребителско име в LimeSurvey, може да ви е полезно да използвате съпоставяне на потребителско име. Това се прави в LimeSurvey с помощта на параметъра auth_webserver_user_map. Например, представете си, че нямате дефинирано потребителско име „admin“ във вашата външна база данни за удостоверяване. След това, за да влезете в LimeSurvey като администратор, ще трябва да съпоставите вашето външно потребителско име (нека го наречем „моето име“) към администраторското име за вход в LimeSurvey. Съответната настройка е: 

'config'=>array(
...
'auth_webserver_user_map' => array ('myname' => 'admin');
)

След успешно удостоверяване с потребителско име 'myname' и парола за уеб сървър, вие ще бъдете директно упълномощени да използвате LimeSurvey като потребител 'admin'.

Това има сериозни последици за сигурността, така че го използвайте внимателно. Освен това защитете своя config.php от достъп за запис от уеб сървъра.

Използвайте еднократни пароли

Потребителят може да отвори страницата за вход в LimeSurvey на default.com/limesurvey/admin и да въведе потребителското име и еднократната парола, които преди това са били записани в таблицата с потребители (колона one_time_pw) от външно приложение.

Тази настройка трябва да бъде включена във файла config.php, за да се даде възможност за използване на еднократни пароли (по подразбиране = false). 

 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'use_one_time_passwords'=>true,
 )

Повече информация можете да намерите в секция „Управление на потребители“.


Настройки за криптиране (New in 4.0.0 )

  Внимание : Веднъж зададени, ключовете за криптиране никога не трябва да се променят, в противен случай всички криптирани данни могат да бъдат загубени!


Template:Забележка

Вижте шифроване на данни за подробности относно тази функция.

  • 'encryptionkeypair'
  • encryptionpublickey
  • 'encryptionsecretkey'

Разширени настройки на url

  • 'publicurl:' Това трябва да бъде настроено на URL местоположението на вашите 'публични скриптове'. Публичните скриптове са тези, които се намират в папката "limesurvey" (или каквото име сте дали на директорията, в която се съхраняват всички останали скриптове и директории). Тази настройка е налична в config.php и се използва, когато LimeSurvey се нуждае от абсолютен url (например когато се изпращат имейли с токени).
  • 'homeurl:' Това трябва да бъде зададено към URL местоположението на вашите административни скриптове. Те се намират в папката /limesurvey/admin. Това трябва да бъде зададено на местоположението на WEB URL адреса - например, http://www.example.com/limesurvey/html/admin. Не добавяйте наклонена черта в края към този запис. Настройката по подразбиране в config.php се опитва да открие името на вашия сървър автоматично, като използва настройка на променлива на php - {$_SERVER [ 'SERVER_NAME']} <code>{$_SERVER [ 'SERVER_NAME']}</code> {$_SERVER [ 'SERVER_NAME']} . В повечето случаи можете да оставите това и просто да промените остатъка от този низ, за да съответства на името на директорията, в която сте поставили скриптовете на LimeSurvey.
  • tempurl: Това трябва да бъде задайте на URL местоположението на вашата директория "/limesurvey/tmp" - или на директория, в която бихте искали LimeSurvey да използва за обслужване на временни файлове.
  • uploadurl: Това трябва да бъде зададено на URL местоположението на вашата директория "/limesurvey/upload" - или на директория, в която бихте искали LimeSurvey да използва за обслужване на качени файлове. Това ви позволява да зададете качени файлове на друг домейн с URL адреси.

Разширени настройки на пътя

  • 'homedir: Това трябва да бъде зададено на местоположението на физическия диск на вашите административни скриптове - например "/home/usr/htdocs/limesurvey/admin". Не добавяйте наклонена черта в края към този запис. Настройката по подразбиране в config.php се опитва да открие основния път по подразбиране на всичките ви документи, използвайки настройката на променливата на php {$_SERVER [ 'DOCUMENT_ROOT']} <code>{$_SERVER [ 'DOCUMENT_ROOT']}</code> {$_SERVER [ 'DOCUMENT_ROOT']} . В повечето случаи можете да оставите това и просто да промените остатъка от този низ, за да съответства на името на директорията, в която сте поставили скриптовете на LimeSurvey.
  • 'publicdir:' Това трябва да бъде зададено на местоположението на физическия диск на вашите 'публични скриптове'.
  • 'tempdir: Това трябва да бъде зададено на местоположението на физическия диск на вашата директория /limesurvey/tmp, така че скриптът да може да чете и записва файлове.
  • 'uploaddir:' Това трябва да бъде зададено на местоположението на физическия диск на вашата директория /limesurvey/upload, така че скриптът да може да чете и записва файлове.
  • sCKEditorURL:'' url на скрипта fckeditor.
  • fckediteexpandtoolbar: определя дали лентата с инструменти на fckeditor трябва да се отваря по подразбиране.
  • 'pdfexportdir:' Това е директорията с tcpdf.php разширението tcpdf.php.
  • pdffonts: Това е директорията за TCPDF шрифтовете.

Други разширени настройки

Качване на файлове

  • 'allowedthemeuploads:' Типове файлове, разрешени за качване в редактора на теми
  • 'allowedresourceuploads:' Типове файлове, разрешени за качване в секциите с ресурси и с HTML редактора
  • allowedfileuploads (New in 4.0.0 ) Глобално ограничение за типа файл за качване
  • magic_database: (New in 3.17.17 ) Позволява да се използва различен MIME база данни за finfo_open. Може да се актуализира само във файла config.php. Пример: /usr/share/misc/magic.mgc за базиран на redhat linux.
  • magic_file: (New in 3.17.17 ) Позволява да се използва различен файл за получаване на масива от разширение по mime тип от включен. Трябва да е PHP файл, който връща масив. Може да се актуализира само във файла config.php.

Актуализация

  • 'актуализиран:' Тази настройка е във version.php. Може да бъде вярно или невярно. Ако зададете true : когато супер администратор влезе в системата : LimeSurvey проверява дали има налична актуализация и ви показва предупреждение. Ако е зададено на false: не се извършва проверка и не можете да използвате ComfortUpdate.
Retrieved from "http://manual.limesurvey.org/index.php?title=Optional_settings/bg&oldid=376532"