функция %PEOPLE()%

Универсальная функция для работы с анкетами. Рассмотрим только одно применение этой функции с аргументом 'LIST'.

Функция %PEOPLE('LIST')% предназначена для получения списка зарегистрированных пользователей по определенным критериям.

Полный список всех возможных аргументов:

• 0 = 'LIST'
• 1. номер выводимой страницы, отсчет от 1. Т.к. список может быть достаточно длинный, весь вывод разбивается на страницы.
• 2. количество записей на странице. Управляет разбитием списка на страницы.
• 3. количество колонок в таблице. Для вывода используется таблица (тэг <table>), здесь задается количество колонок этой таблицы.
• 4. шаблон ячейки таблицы. Как должен выглядеть вывод.
• 5. опции поиска — набор флагов, указывающих по каким критериям необходимо осуществлять поиск анкет (см. ниже).
• 6. (необязательный) подстрока поиска ника, может содержать начало ника.
• 7. (необязательный) критерий поиска: начальная дата регистрации, строка вида DDMMYY.
• 8. (необязательный) критерий поиска: конечная дата регистрации, строка вида DDMMYY.
• 9. (необязательный) критерий поиска: IP-адрес для поиска
• 10. (необязательный) критерий поиска: CompID — одно из значений CompID для поиска
• 11. (необязательный) критерий поиска: день рождения, строка, может иметь три варианта: DD-MM — для поиска по дню и месяцу, DD-MM-YYYY — для поиска по дню, месяцу и году, YYYY — для поиска только по году.

Список пользователей формируется с учетом опций поиска. Набор этих опций передается в функцию как строка, в которой записана комбинация параметров для выбора требуемых данных. Для более наглядной записи опций поиска, все опции имеют предопределенные имена. Для комбинации множества опция в строке необходимо использовать символ вертикальной черты '|'.

Список опций для поиска:

• CHECKED — проверенная анкета
• NO_CHECKED — непроверенная анкета
• LOCKED — заблокированная анкета
• NO_LOCKED — незаблокированная анкета
• DELETED — удаленная анкета
• NO_DELETED — неудаленная анкет
• UNIQUE — в спсике будет присутствовать только один ник от анкеты
• SORT_NICK — вывод списка осуществляется с сортировкой по никам
• SORT_DATE — вывод списка осуществляется с сортировкой по дате регистрации
• SORT_LOCK — вывод списка осуществляется с сортировкой по дате блокировки (если требуется найти заблокированные анкеты)
• SORT_REVERSE — сортировка осуществляется от большего к меньшему
• IP_REG — используется только если указан IP в поиске, искать по данным регистрации
• IP_EDIT — используется только если указан IP в поиске, искать по данным редактирования анкеты
• IP_ENTER — используется только если указан IP в поиске, искать по данным последнего захода в чат
• IP_NET — используется только если указан IP в поиске, искать в подсети, к которой принадлежит этот IP-адрес
• CID_REG — используется только если указан CompID в поиске, искать по данным регистрации
• CID_EDIT — используется только если указан CompID в поиске, искать по данным редактирования анкеты
• CID_ENTER — используется только если указан CompID в поиске, искать по данным последнего захода в чат
• BIRTHDAY — используется для поиска по дате рождения

Пример

Необходимо найти анкеты по следующим критериям: анкеты проверены, не заблокированы и не удалены, требуется только один ник от анкеты, сортировать по никам. Строка с комбинацией опций записыватеся так:

"CHECKED|NO_LOCKED|NO_DELETED|UNIQUE|SORT_NICK"

Результатом работы функции %PEOPLE("LIST")% будет HTML-код списка. Дополнительно эта функция создает 5 переменных, которые можно использовать на странице:

1. %FIRST% — номер первого элемента текущей страницы
2. %LAST% — номер последнего элемента текущей страницы
3. %PAGE% — номер текущей страницы
4. %PAGES% — количество страниц
5. %TOTAL% — количество всех элементов с данным критерием поиска