]> www.wagner.pp.ru Git - oss/stilllife.git/blob - doc/profile.txt
Added form to dynamically add new file input while entering message
[oss/stilllife.git] / doc / profile.txt
1 Профиль пользователя.
2
3 Профиль пользователя в StillLife может содержать произвольное количество
4 параметров, определяемое только фантазией хозяина форума.
5
6 Часть параметров может быть установлена самим пользователем при
7 регистрации или редактировании профиля, часть могут быть разрешены для
8 изменения только администратору форума.
9
10 Специальным образом интерпретируются следующие параметры:
11
12 1. avatar - представляет собой URL на картинку пользователя вместе с
13         информацией о её размерах.
14         Если в форме присутствует поле avatarfile, типа file, то
15         зааплоаженный через него файл складывается в директорию, заданную
16         параметром конфигурации userdir и в свойство пользователя avatar
17         прописывается URL на него.
18 2. passwd - используется для авторизации локальных пользователей.
19    Никогда не показывается. При регистрации специальным образом формируется
20    из полей pass1 и pass2 (значения которых должны совападать.
21
22 3. email - при вводе проверяется на корректный формат. В дальнейшем, при
23   некоторых обстоятельствах форум может на этот адрес писать письма.
24
25 4. status - если в конфиге указано поле
26         denied_status = значение, то локального пользователя у которого
27         поле status в
28         профайле имеет это значение, на форум не пустят. До тех пор пока это
29         значение не будет изменено посредством либо администратором форума,
30         либо посредством некоей автоматизированной процедуры.
31         Не рекомендуется использовать в качестве значений поля статус
32         значений moderator, admin и banned. Эти значения используются для 
33         характеристики прав доступа пользователя к определенному разделу
34         форума и определяются на основе файлов perms.txt
35
36 5. registered - указывает время регистрации. Для OpenID пользователей
37         не определено
38 6. signature - поле, которое может содержать в себе HTML или BBcode
39    разметку (если в форме рядом присутствует поле signature_format,
40    задающее тип разметки. См стандартные шаблоны). Если это поле не
41    пусто, то содержимое этого поля дописывается в конец каждого
42    сообщения, созданного данным пользователем.
43
44 7  messsages, forums, topics - количество сообщений, форумов и тем,
45    которые были созданы этим пользователем. 
46
47 8. last_message, last_forum last_topic - дата создания последнего
48         сообщения,  форума, темы данным пользователем.  
49
50 Использовать статистические поля имеет смысл только  в шаблонах,
51 обработка которых происходит непосредственно в момент отдачи
52 пользователю. Если использовать поле messages в шаблоне сообщения, то 
53 оно покажет сколько сообщений создал данный пользователь ДО ЭТОГО
54 сообщения. 
55
56 OpenID пользователи
57
58 При первом заходе в систему OpenID-пользователя, с его сайта считывается
59 файл foaf, из которого извлекается информация для заполнения полей
60 avatar, icq, jabber. Поле status проставляется в соответствии со
61 значением параметра файла конфигурации openid_status. В дальнейшем такой
62 пользователь может зайти на страницу редактирования профиля и заполнить
63 поля, которые не удалось извлечь из foaf (например signature)
64
65 Поля, доступные для редактирования только модератору
66
67 Поля, имена которых перечислены в параметре файла конфигурации 
68 restricted_user_info, недоступны для редактирования пользователем.
69 В форме profile эти поля доступны для редактирования только
70 администратору, в форме регистрации, даже если в результате ошибки
71 дизайнера шаблонов это поле будет присутствовать как поле ввода,
72 введенное пользователем значение будет проигнорировано. 
73
74 Если в файле конфигурации имеется параметр default_имя-поля, будет
75 использовано его значение.
76
77
78 Поля с ограниченным набором значений
79
80 Если поле может принимать только ограниченный набор значений (например,
81 поле "Пол" "Мужской" и "Женский", то в форме оно обычно представляется в
82 виде элемента select, а значения описываются элементами option.
83 Рекомендуется обеспечить, чтобы значение, передаваемое на сервер и
84 сохраняемое в базе пользователей, было тем самым значением, которе
85 показано в меню. 
86
87 Для этого следует не использовать в элементах option атрибут value. При
88 отсутствии этого атрибута будет использовано значение текста пункта меню.
89
90
91 Обязательные поля
92
93 Если в форме регистрации присутсвует скрытое поле с названием required,
94 и его значение представляет собой перечисленный через запятуз список
95 полей, то незаполнение этих полей будут проинтерпретированы как ошибка.
96
97 Поля форм регистрации и редактирования профиля, которые не являются
98 атрибутами пользователя.
99
100 Если в форме присутствует скрытое поле ignore, значение которого
101 представляет собой список полей формы через запятую, значения этих полей
102 будут проигнорированы при создании профайла пользователя.