Merge pull request #47 from keslo/master

Обновил описание if

Author: Dmi3yy

ru/03_Компоненты/FormLister/060_Авторизация пользователей.md

@@ -1,6 +1,18 @@
 ## Авторизация пользователей
 
-Контроллер Login позволяет авторизировать пользователей как по имени, так и по email. Кроме этого, можно дополнительно использовать плагин userHelper, который ведет учет количества логинов и времени последнего логина, а также реализует автологин и выход из учетной записи.
+Авторизация пользователей в `FormLister` осуществляется с использованием контроллера `Login`.
+
+Авторизация может проходить по имени, email или другому полю из учетной записи. Поле задается в параметре `loginField`. Поле для авторизации должно быть **уникальным** для каждого веб-пользователя. Обычно для авторизации используются поля `username` или `email`.
+
+Дополнительное использование плагина [userHelper](https://github.com/evolution-cms/evolution/blob/develop/assets/snippets/FormLister/snippet.FormLister.php) позволяет:
+
+* вести учет количества логинов
+* опрееделить время последней авторизации
+* реализовать автологин или выход из учетной записи
+
+Перед использованием плагина `userHelper` убедитесь что он не отключен:
+
+![Не забудьте включить userHelper](https://habrastorage.org/web/dbc/1e2/abd/dbc1e2abd8664a548f4eca254187fb60.png)
 
 ## Параметры контроллера
 

ru/03_Компоненты/if/index.md

@@ -1,25 +1,47 @@
-###Сниппет для вывода информации по условию.
+# if
 
-Логика работы: Если условие is выполняется, то выводим содержимое параметра then, если не выполняется, то выводим содержимое параметра else.
+### Сниппет выводит информации по условию
 
-*Для работы с внешними плейсхолдерами (например: [+pages+] в Ditto) — вызывайте сниппет некешируемым: [!if? &is… !]*
+#### Как работает?
 
+Если при вызове `if` условие в параметре `is` выполняется, то выведется содержимое параметра `then`, если нет - содержимое параметра `else`.
 
-####Параметры сниппета
+Если необходимо ничего не выводить через `then` или `else`, то можно вовсе не задавать этот параметр.
+
+#### Некэшируемый вызов
+
+При работы с внешними плейсхолдерами необходимо вызывать сниппет некешируемым.
+
+А внешний плейсхолдер это, например, `[+pages+]` из **Ditto**.
+
+#### Пример вызова
+
+```
+// пример вызова кэшируемого...
+[[if? &is=`[*parent*]:=:5` &then=`true` &else=`false`]]
+
+// и некэшируемого if
+[!if? &is=`[*parent*]:=:5` &then=`true` &else=`false`!]
+```
+
+
+### Параметры сниппета
 
 Параметр|Описание|Возможные значения|По-умолчанию
 --------|--------|------------------|------------
-is|Обрабатываемое условие|что сравниваем:как сравниваем:с чем сравниваем|Пусто
-then|Содержимое для вывода, если условие верно|@tpl:chunkname или любой html-код с тегами MODX|Пусто
-else|Содержимое для вывода, если условие не верно||@tpl:chunkname или любой html-код с тегами MODX|Пусто
-math|включает выполнение математических функций в параметре is|on|Пусто
-separator|Разделитель в условии|например ~| : 
+**is**|Обрабатываемое условие|что сравниваем:как сравниваем:с чем сравниваем|Пусто
+**then**|Содержимое для вывода, если условие верно|`@tpl:chunkname` или любой html-код с тегами MODX|Пусто
+**else**|Содержимое для вывода, если условие не верно|`@tpl:chunkname` или любой html-код с тегами MODX|Пусто
+**math**|Включает выполнение математических функций в параметре `is`|on|Пусто
+**separator**|Разделитель в условии|Например, `~`| `:` 
+
+Для того чтобы парсер не обрабатывал вариант и `then` и `else`, как это делает **PHx**, вызывайте: `&then='@TPL:chunkname'` — где `chunkname` - имя чанка.
 
-Для того чтобы парсер не обрабатывал вариант и then и else, как это в PHx, вызывайте: *&then=\`@TPL:chunkname\`* — где chunkname - имя чанка, тогда будет выполнен только результатирующий чанк.
+В этом случае будет выполнен только результирующий чанк.
 
 ***
 
-####Операторы используемые в условии
+### Операторы используемые в условии
 
 **is, =** - равно
 
@@ -45,12 +67,12 @@ separator|Разделитель в условии|например ~| :
 
 ***
 
-####Выполнение математических функций:
+### Выполнение математических функций:
 
 	is=`[+id+]*10:=:30`
 
 
-####Примеры использования
+### Примеры использования
 
 	1) Выводить акцию нужно только в каталоге с ID = 5
 	[[if? &is=`[*parent*]:=:5` &then=`@TPL:akcia`]]
@@ -75,4 +97,4 @@ separator|Разделитель в условии|например ~| :
 	[[if? &is=`[+ditto_iteration+]*2:%:3` &then=`true` &else=`false` &math=`on`]]
 
 	8) Выводить значение математического выражения
-	[[if? &is=`[+ditto_iteration+]*2` &math=`on`]]
+	[[if? &is=`[+ditto_iteration+]*2` &math=`on`]]