Параметры

param -- Перечень и описание параметров службы опросов

В службе опросов есть три вида объектов, работу которых Вы можете настроить параметрами:

1. dir - каталоги вопросов

2. question - вопросы

3. variant - варианты ответов

Каталоги вопросов имеют иерархическую организацию. Дочерние каталоги наследуют параметры родительских каталогов.

Вопросы наследуют параметры каталогов, в которых они находятся.

Варианты ответов наследуют параметры вопросов, которым они принадлежат.

В квадратных скобках рядом с именем параметра указывается список объектов, которыми можно управлять при помощи этого параметра.

allow.allow [dir,question]

Всегда разрешать просмотр этого вопроса или каталога в разрешённом режиме.

В разрешённом режиме показываются вопросы и варианты ответов с возможностью добавить новый ответ пользователя.

Задание этого параметра определяет только возможность загрузки этой формы, но не разрешает добавление ответов в случае, если пользователь ограничен в добавлении новых ответов из-за использования параметров deny.browser, deny.ip, deny.proxy, deny.user или disable.

allow.deny [dir,question]

Всегда разрешать просмотр этого вопроса или каталога в запрещённом режиме.

В запрещённом режиме показываются просто вопросы и варианты ответов, без возможности добавить новый ответ пользователя.

По умолчанию вопросы и каталоги показываются в запрещённом режиме, если пользователь ограничен в голосовании и не задан параметр stat.

allow.empty [variant]

Сохранять вариант ответа открытого типа, даже если пользователь ничего не ввёл в текстовое поле.

Учитывается только для вариантов ответов одного из следующих типов: integer, float, text, textarea и задан параметр unique

Особенность вариантов ответов этого типа при заданном параметре unique состоит в том, что рядом с полями для тестового ввода показываются радиокнопки. Пользователи, отвечая на этот вопрос, могут выбрать радиокнопку, но не ввести никакой текст в текстовое поле.

Если параметр allow.empty задан и пользователь ничего не вводит в текстовое поле, но выбирает радиокнопку, то ответ будет сохранён так, как если бы он был типа radio. Если этот параметр не задан, то ответ не будет сохранён так, как будто по этому варианту ответа не было ничего выбрано.

allow.reply.detail [dir,question]

Всегда разрешать просмотр деталей ответов пользователей по этому вопросу или по этому каталогу.

Если этот параметр не задан, то для просмотра деталей ответов пользователей требуется привилегия vote.view.

allow.reply.list [dir,question]

Всегда разрешать просмотр списка ответов по этому вопросу или по этому каталогу.

Если этот параметр не задан, то для просмотра списка ответов требуется привилегия vote.view.

allow.skip [question]

Разрешить пропускать этот вопрос.

Если этот параметр задан, то пользователь может перейти к следующему вопросу, не ответив на текущий.

Если параметр не задан, то пользователь обязательно должен ответить на текущий вопрос прежде чем перейти к следующему вопросу.

Этот параметр учитывается только если значение параметра reply.next=question.

allow.stat [dir,question]

Всегда разрешать просмотр статистики по этому вопросу или каталогу.

Этот параметр отличается от stat, который показывает статистику только если пользователь ограничен в добавлении ответа по этому вопросу.

deny [dir,question]

Запретить всякую активность по ответам на эти вопросы. Запретить добавлять новые ответы и запретить просматривать статистику, если ответ уже добавлен.

При просмотре вопроса всегда показывать список ответов без статистики и без возможности добавления нового ответа.

deny.browser [dir,question]

Запретить пользователям добавлять новые ответы по этому вопросы, если с браузера этого пользователя уже был добавлен ответ на этот вопрос.

Пользователь может легко поменять браузер или настроить свой браузер так, чтобы при следующем обращении к сайту он был идентифицирован как другой браузер. Поэтому, полагаться на этот способ защиты как на основной нельзя.

deny.ip [dir,question]

Запретить пользователям добавлять новые ответы по этому вопросы, если с ip-адреса этого пользователя уже был добавлен ответ на этот вопрос.

deny.proxy [dir,question]

Запретить пользователям добавлять новые ответы по этому вопросы, если с их внутреннего ip-адреса уже был оставлен ответ по этому вопросу.

Внутренний ip-адрес учитывается только если прокси, за которым находится пользователь, шлёт заголовок HTTP_X_FORWARDED_FOR.

Задание этого параметра приводит также к учёту внешнего ip-адреса, не зависимо от того, передаётся ли заголовок HTTP_X_FORWARDED_FOR.

deny.user [dir,question]

Запретить зарегистрированным пользователям оставлять на этот вопрос больше одного ответа.

Учитывается только если ответ оставляет зарегистрированный пользователь.

Для того, чтобы незарегистрированные пользователи не могли оставлять ответы, используйте параметр require.user.

disable [dir,question]

Запретить пользователям добавлять новые ответы по этому вопросу или во всём этом каталоге.

forum [dir,question]

Разрешить обсуждения этого каталога или вопроса в форуме.

В качестве значения указывается путь к теме форума, в которой будут создаваться новые топики.

hide [dir,question]

Не показывать этот каталог или вопрос в списке каталогов и на карте сайта.

hide.map [dir,question]

Не показывать этот каталог или вопрос на карте сайта.

hide.place [dir,question]

Не показывать этот каталог или вопрос в строке текущего положения пользователя.

nobot [dir,question]

Запретить доступ зарегистрированным в системе поисковым роботам.

protect

Этот каталог является защищённым.

Если этот параметр определён, то для доступа к этому каталогу требуется привилегия vote.view.

public

Этот каталог может редактировать любой зарегистрированный пользователь.

Установка этого параметра аналогична выдачи всем зарегистрированным пользователям привилегий vote.dir.edit и vote.dir.log для этого каталога.

Этот параметр не учитывается, если задан параметр protect, если пользователь не авторизовался в системе или если пользователь обращается к системе с заблокированного ip-адреса.

public.* [question]

Разрешить изменение этого параметра любым пользователям, которые имеют доступ на редактирование этого вопроса.

reply.detail.empty [variant]

Показывать ли этот вариант ответа на странице деталей ответа пользователя, если этот вариант ответа не выбран.

reply.dir [dir]

Разрешить в этом каталоге голосование сразу по всем вопросам. При просмотре каталога будут выведены все вопросы сразу с вариантами ответов.

Если задан этот параметр, но не задан параметр reply.question, то можно будет голосовать только по всему каталогу, но не по отдельным вопросам.

reply.list [variant]

Показывать ли этот вариант ответа в таблице списка ответов пользователей.

Смотрите также allow.reply.list о том, как разрешить просмотр списка ответов пользователей.

reply.list.borwser [dir,question]

Показывать ли уникальный идентификатор браузера при просмотре списка ответов пользователей.

Этот параметр учитывается только если пользователь, который просматривает список ответов, обладает также привилегией vote.view.

Смотрите также allow.reply.list о том, как разрешить просмотр списка ответов пользователей.

reply.list.date [dir,question]

Показывать ли дату добавления ответа пользователя при просмотре списка ответов пользователей.

Смотрите также allow.reply.list о том, как разрешить просмотр списка ответов пользователей.

reply.list.ip [dir,question]

Показывать ли ip-адрес при просмотре списка ответов пользователей.

Этот параметр учитывается только если пользователь, который просматривает список ответов, обладает также привилегией vote.view.

Смотрите также allow.reply.list о том, как разрешить просмотр списка ответов пользователей.

reply.list.mark [dir,question]

Показывать ли оценки при просмотре списка ответов пользователей.

Смотрите также allow.reply.list о том, как разрешить просмотр списка ответов пользователей.

reply.list.name [dir,question]

Показывать ли имя пользователя при просмотре списка ответов пользователей.

Имя пользователя показывается только если голосовал зарегистрированный в системе пользователь.

Смотрите также allow.reply.list о том, как разрешить просмотр списка ответов пользователей.

Для того, чтобы незарегистрированные пользователи не могли оставлять ответы, используйте параметр require.user.

reply.next [dir,question]

Этот параметр определяет действие после добавления ответа пользователя:

mark - после добавления ответа пользователя, пользователю показывается суммарный балл по всем выбранным вариантам ответов.

question - ответы на вопросы каталога добавляются один за одним, по очереди. Ответы на все вопросы считаются одним ответом пользователя, если ответы добавляются внутри одной сессии, не меняется ip-адрес, пользователь и браузер. При ответе на открытый вариант ответа пользователю не будет разрешено отвечать на следующий вопрос, если он неправильно ответил на текущий вопрос.

reply.notify [dir,question]

Уведомлять администраторов о добавлении нового ответа по данному вопросу или каталогу.

Уведомление будут получать администраторы, обладающие привилегией vote.reply.notify

reply.question [question]

Разрешить голосование отдельно по этому вопросу.

require [variant]

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

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

Если ни для одного варианта ответа не задан этот параметр, то ответ на этот вопрос может быть сохранён даже если пользователь не выбрал ни одного варианта ответа.

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

Если этот вариант задан для одного из вариантов ответов типа combobox, то пользователь должен будет обязательно выбрать значение в соответствующем выпадающем списке.

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

require.correct [variant]

Не разрешать пользователю отвечать на следующий вопрос, если он неправильно ответил на этот вариант ответа.

В отличие от параметра allow.skip, неуказание параметра require.correct приведёт к тому, что пользователь должен будет на все вопросы оставить хотя бы какой-нибудь ответ. Если задан параметр allow.skip, то на некоторые вопросы пользователь может вообще оставлять ответы.

Этот параметр учитывается только если вариант ответа является открытым вариантом ответа, для этого варианта ответа указан правильный ответ и и значение параметра reply.next=question.

Правильный вариант ответа можно указать, установив значение тега <open> для соответствующего варианта ответа.

require.user [dir,question]

По этому каталогу или вопросу могут голосовать только зарегистрированные пользователи.

show.reply.list [question]

На странице вопроса показывать списки ответов пользователей.

stat [dir,question,variant]

Разрешить просмотр статистики в случае, если пользователь ограничен в голосовании по этому вопросу из-за использования параметров deny.browser, deny.ip, deny.proxy, deny.user или disable.

Этот параметр следует указывать для вариантов ответов, если Вы хотите, чтобы статистика по этому варианту ответа была показана на странице статистики.

stat.avg [question]

На странице статистики для каждого варианта ответа с типом float или integer показывать среднее всех чисел, которые были введены пользователями по этому варианту ответа.

Учитывается только если для этого вопроса есть хотя бы один вариант ответа с типом float или integer и хотя бы один пользователь выбрал этот вариант ответа.

Смотрите также stat.min, stat.max, stat.sum.

stat.bar [question]

На странице статистики показывать диаграмму.

В качестве значения этого параметра может быть:

avg - в качестве ширины столбца диаграммы показывать среднее среди всех введённых всеми пользователями по всем ответам чисел. Имеет смысл, если все варианты ответов - числовые.

count (по умолчанию) - в качестве ширины столбца диаграммы показывать общее количество ответов

stat.count [question]

На странице статистики для каждого варианта ответа показывать общее количество ответов пользователей, в которых был выбран этот вариант ответа.

stat.list [variant]

Показывать ли на странице статистике текст, введённый пользователем в качестве ответа на этот вариант. Учитывается только для вариантов ответов открытого типа.

stat.mark [question]

На странице статистики для каждого варианта ответа показывать оценку, которая выставляется пользователям, выбравшим этот вариант ответа.

Если задан параметр stat.total, то в строке итогов будет показан суммарный балл по всем вариантам ответов этого вопроса.

Это число отличается от того, которое показывается, если задан параметр stat.mark.sum. В данном случае будет показан суммарный балл не по всем вариантам ответов, а по всем ответам пользователей.

stat.mark.avg [question]

На странице статистики показывать среднюю оценку, которую набрали все пользователи по этому вопросу. Это значение показывается в строке итогов в столбце оценок.

Этот параметр учитывается только если заданы также все следующие параметры: stat.total, stat.mark.

stat.mark.sum [question]

На странице статистики для каждого варианта ответа показывать суммарную оценку, которую набрали все пользователи по этому варианту ответа.

Если задан параметр stat.total, то в строке итогов будет показан суммарный балл по всем ответам пользователей.

stat.max [question]

На странице статистики для каждого варианта ответа с типом float или integer показывать максимальное число, которое было введено пользователем по этому варианту ответа.

Учитывается только если для этого вопроса есть хотя бы один вариант ответа с типом float или integer и хотя бы один пользователь выбрал этот вариант ответа.

Смотрите также stat.avg, stat.min, stat.sum.

stat.min [question]

На странице статистики для каждого варианта ответа с типом float или integer показывать минимальное число, которое было введено пользователем по этому варианту ответа.

Учитывается только если для этого вопроса есть хотя бы один вариант ответа с типом float или integer и хотя бы один пользователь выбрал этот вариант ответа.

Смотрите также stat.avg, stat.max, stat.sum.

stat.percent [question]

На странице статистики для каждого варианта ответа показывать процент ответов пользователей, в которых выбран этот вариант ответа.

Если задан также параметр stat.total, то в строке итогов будет показана сумма процентов по всем вариантам ответов.

Если для вопроса внутри одного ответа пользователя может быть выбрано более одного варианта ответа, то суммарное количество процентов может оказаться больше 100. Например, сумма 200% означает, что в среднем все пользователи выбирали по 2 варианта ответа.

Если у вопроса нет вариантов ответа, для которых задан параметр require и для каталога, в котором находится этот вопрос, задан параметр reply.dir, то сумма процентов может оказаться меньше 100%. Например, 50% означает, что в каждом втором ответе по этому вопросу не выбрано ни одного варианта.

stat.sum [question]

На странице статистики для каждого варианта ответа с типом float или integer показывать сумму всех чисел, которые были введены пользователями по этому варианту ответа.

Учитывается только если для этого вопроса есть хотя бы один вариант ответа с типом float или integer и хотя бы один пользователь выбрал этот вариант ответа.

Смотрите также stat.avg, stat.min, stat.max.

stat.total [question]

На странице статистики показывать итоговую строку, в которой содержатся итоги по столбцам, которые задаются другими параметрами stat.*.

unique [variant]

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

Этот параметр имеет смысл использовать, если Вы добавляете варианты ответов с типом, отличным от radio но хотите при этом, чтобы пользователь не мог выбрать более одного варианта.

Если ни для одного варианта ответа не задан этот параметр, то пользователь может выбрать любую комбинацию вариантов ответов.

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

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

Смотрите также

Управление параметрами
http://popoff.donetsk.ua/text/work/libs/a/param/

Параметры XML-фильтра
http://popoff.donetsk.ua/text/work/libs/xmlfilter/parse/param.html

Последняя модификация: 16.06.08 01:35

Не проходите мимо! Оставьте Ваш комментарий в форуме! >>>