Разработка:moodleQuickForm - История изменений

Konovalov: /* Проверка на стороне сервера */

2014-08-21T07:35:48Z

‎Проверка на стороне сервера

Yumeneco: /* dof_autocomplete */

2013-04-17T11:47:56Z

‎dof_autocomplete

Yumeneco: /* Пример активизации расширенного autocomplete */

2013-04-17T11:47:28Z

‎Пример активизации расширенного autocomplete

Yumeneco: /* dof_autocomplete */

2013-04-09T17:37:41Z

‎dof_autocomplete

Yumeneco: описан метод setConstant для MoodleQuickForm

2012-09-27T11:47:27Z

описан метод setConstant для MoodleQuickForm

Ilya: /* dof_autocomplete */

2012-06-05T14:09:10Z

‎dof_autocomplete

Ilya: /* dof_autocomplete */

2012-05-29T03:53:10Z

‎dof_autocomplete

Dido86: /* dof_calendar */

2012-02-20T10:13:14Z

‎dof_calendar

Ilya: /* dof_calendar */ Исправлены ошибки

2012-02-10T17:51:05Z

‎dof_calendar: Исправлены ошибки

Dido86: /* dof_calendar */

2012-02-09T13:36:23Z

‎dof_calendar

@@ Строка 726: / Строка 726: @@
 По умолчанию все данные из формы подлежат проверке на стороне сервера. Существует возможность добавить проверку на стороне клиента. Не забывайте при этом, что эти данные нужно потом все равно еще раз проверить на стороне сервера, так как всегда существует возможность послать данные в обход формы.
 ==== Проверка на стороне сервера ====
-Если вам требуется дополнительная проверка данных на стороне клиента, то используйте стандартный метод [[Разработка:moodleQuickForm#validation($data, $files) | validation()]]. Любые другие способы проверки данных после формы должны использоваться только в исключительных случаях.
+Если вам требуется дополнительная проверка данных на стороне сервера, то используйте стандартный метод [[Разработка:moodleQuickForm#validation($data, $files) | validation()]]. Любые другие способы проверки данных после формы должны использоваться только в исключительных случаях.
 ==== Проверка на стороне клиента ====

← Предыдущая		Версия 11:47, 17 апреля 2013
Строка 683:		Строка 683:

	==== Работа dof_autocomplete с id ====		==== Работа dof_autocomplete с id ====
−
−	~~==== Факты ====~~

	=== dof_duration ===		=== dof_duration ===

@@ Строка 674: / Строка 674: @@
+}
 </pre>
 Для обработки значений autocomplete используется метод из modlib/widgets '''get_extvalues_autocomplete($name,$autocomplite)''', где
 *name - имя поля dof_autocomplete,
 *autocomplite - данные полученыые из [[Разработка:moodleQuickForm#get_data.28.24slashed.29|get_data()]] формы поля dof_autocomplete.
 ==== Факты ====

@@ Строка 600: / Строка 600: @@
 **default    - массив значений по умолчания( например $a[19]= "primer"), где ключ - это id элемента из бд
 **departmentid - id подразделения, из которого пришел запрос
 ==== Простой пример ====
 <pre>
@@ Строка 653: / Строка 654: @@
 * поля name и id обязательны в возвращаемых объектах
 * рекомендуется возвращать не более 15 записей для быстрой работы AJAX-запроса, пользуйтесь ограничением SQL-выборки
 === dof_duration ===

@@ Строка 106: / Строка 106: @@
 Для элемента ''hierselect'' в качестве второго аргумента нужно указывать массив со значениями по умолчанию для каждого уровня:
      $mform->setDefault('имяэлемента', array(14, 2, 8));
 ===== get_submitted_data($slashed) =====

@@ Строка 592: / Строка 592: @@
 **type       - тип действия ( например autocomplete ). Есть ещё тип savefield
 *Необязательные поля:
-**option    - массив значений по умолчания( например $a[19]= "primer"), где ключ - это id элемента из бд
+**default    - массив значений по умолчания( например $a[19]= "primer"), где ключ - это id элемента из бд
 ==== Простой пример ====
 <pre>
@@ Строка 606: / Строка 607: @@
      $options['sesskey']    =   sesskey();
      $options['type']       =   'autocomplete';
      // установим значение по умолчанию
-     $mas = array( 19 => 'primer' );
+     $default = array( 19 => 'Test text' );
-     $options['option'] = $mas;
+     $options['default'] = $default;
      // добавляем новый элемент в форму
@@ Строка 618: / Строка 620: @@
 <pre>
   [testname] = Array
-        [testname] = полученное значение
+        [text] = выбранное в меню значение (текст, который отображается в поле формы)
-        [id_autocomplete] = id значения
+        [id] = id выбранного объекта (как правило число)
 </pre>
 Необходимые методы:
@@ Строка 625: / Строка 627: @@
 <pre>
 $a = array();
-a[1] = object[
+a[1] = object(
            name -> ЗНАЧЕНИЕ_1 ДЛЯ ВЫПАДАЮЩЕГО СПИСКА
              id -> id элемента_1
-              ];
+              );
-a[2] = object[
+a[2] = object(
            name -> ЗНАЧЕНИЕ_2 ВЫПАДАЮЩЕГО СПИСКА
              id -> id элемента_2
-              ];
+              );
     ...
+]
@@ Строка 643: / Строка 645: @@
 '''Замечания:'''
-* поля name и id обязательны в переданном массиве
+* поля name и id обязательны в возвращаемых объектах
-* рекомендуется возвращать не более 15 записей для быстрой работы AJAX-запроса
+* рекомендуется возвращать не более 15 записей для быстрой работы AJAX-запроса, пользуйтесь ограничением SQL-выборки
 === dof_duration ===

@@ Строка 584: / Строка 584: @@
 === dof_autocomplete ===
-Элемент с выпадающим списком подсказок по мере набора текста. Выглядит как обычный элемент text, но имеет встроенный javascript. В помощь с ним создается автоматически hidden поле, значение которого будет равно индексу выбранного элемента(name="id_autocomplete" id="id_hidden_auto"). В dof_autocomplete есть обязательные параметры, работа без которых не возможна. Записываются они в переменную массив <b>$options</b>. В неё же и помещается массив option(ключ=>значени), это так называемые значения по умолчанию(не обязательные).
+Элемент с выпадающим списком подсказок по мере набора текста. Выглядит как обычный элемент text, но имеет встроенный javascript. В помощь с ним создается автоматически hidden поле, значение которого будет равно индексу выбранного элемента (name="id_autocomplete" id="id_hidden_auto"). В dof_autocomplete есть обязательные параметры, работа без которых невозможна. Записываются они в переменную массив <b>$options</b>. В неё же и помещается массив $options(ключ=>значение), это так называемые значения по умолчанию (необязательные).
 *Список обязательных полей для переменной $options:
-**plugintype - тип плагина ( например storage)
+**plugintype - тип плагина (например storage)
-**plugincode - код плагина ( например plans)
+**plugincode - код плагина (например plans)
-**queryty    - тип запроса, именно по нему и определяется, что надо делать( например plans_name ). Этот тип должен совпадать с типом, который будет находиться в этом в плагине в методе widgets_field_variants_list
+**querytype  - тип запроса, именно по нему и определяется, что надо делать( например plans_name ). Этот тип должен совпадать с типом, который будет находиться в этом в плагине в методе widgets_field_variants_list
 **sesskey    - ключ сессии(чтоб идентифицировать запрос) задается методом sesskey()
 **type       - тип действия ( например autocomplete ). Есть ещё тип savefield
 *Необязательные поля:
 **option    - массив значений по умолчания( например $a[19]= "primer"), где ключ - это id элемента из бд
-<pre> $mform->addElement('dof_autocomplete', $elementName = null, $elementLabel = null, $attributes = null, $options = null)
+    // добавляем новый элемент в форму
-//Создаем массив входных данных
+    $mform->addElement('dof_autocomplete', 'testname', 'Надпись перед полем:', array('width' => '100%'), $options);
 </pre>
 *Замечение:
-**следует помнить, что элемент autocomplete сам в себе подключает js-библиотеки, и потому, объявление класса на странице должно быть ''раньше'', чем печать шапки страницы
+**следует помнить, что элемент autocomplete сам в себе подключает js-библиотеки, и потому, объявление класса формы на странице должно быть ''раньше'', чем печать шапки страницы
 **выходные данные имеют вид
 <pre>
@@ Строка 620: / Строка 622: @@
 </pre>
 Необходимые методы:
-Плагин, данные которого будут составлять автозаполнение должен иметь метод <b>widgets_field_variants_list($querytype, $data="")</b>, который возвращает массив объектов в формате <pre>
+Плагин, данные которого будут составлять автозаполнение должен иметь метод <b>widgets_field_variants_list($querytype, $data="")</b>, который возвращает массив объектов в формате
-$a = arrya();
+<pre>
 a[1] = object[
-           name = ЗНАЧЕНИЕ_1 ДЛЯ ВЫПАДАЮЩЕГО СПИСКА
+           name -> ЗНАЧЕНИЕ_1 ДЛЯ ВЫПАДАЮЩЕГО СПИСКА
-             id = id элемента_1
+             id -> id элемента_1
               ];
 a[2] = object[
-           name = ЗНАЧЕНИЕ_2 ВЫПАДАЮЩЕГО СПИСКА
+           name -> ЗНАЧЕНИЕ_2 ВЫПАДАЮЩЕГО СПИСКА
-             id = id элемента_2
+             id -> id элемента_2
               ];
     ...
+]
-</pre>где $querytype-тип запроса(обрабатывается путем case), $data-вх данные, как правило строка(набранные данные в поле autocomplete)
+</pre>
-* Замечание:
-** поля name и id обязательны в переданном массиве
+Здесь:
-** метод должен возвращать с LIMIT 15(не больше), для быстроты работы
+* $querytype - тип запроса (только маленькие латинские буквы, цифры и знак подчеркивания)
 === dof_duration ===

@@ Строка 560: / Строка 560: @@
 === dof_calendar ===
 Элемент, который автоматически отображает 2 календаря для выбора диапазона дат. Календари находятся на одной линии. Под каждым календарем поле-указывает в формате д.м.гг дату, которая выбрана на календаре. В скрытое поле каждого календаря помещается время в unixtime, причем первый календарь (слева) отсчитывает время от 00.00.01, а второй (справа) с 23.59.59. Если на правом и на левом календарях отмечена одна дата, то диапазон, соответственно, равен 00.00.01-23.59.59, что полностью охватывает выбранный день.
 '''Пример:'''
@@ Строка 569: / Строка 570: @@
 * $options['date_from'] - с какой даты брать отсчет(левый календарь)(unix time)
 * $options['date_to']  - по какую дату брать отсчет(правый календарь)(unix time)
 </pre>
 Если параметр options опущен, то берется текущая дата.

@@ Строка 559: / Строка 559: @@
 === dof_calendar ===
-Элемент, который автоматически отображает 2 календаря для выбора диапозона дат. Календари находятся на одной линии. Под каждым календарем поле-указывает в формате д.м.гг дату, которая выбрана на календаре. В скрытое поле каждого календаря помещается время в unix time, причем в "с" береть отчет от 00.00.01, в "до" с 23.59.59. Если на правом и на левом календарях отмечена одна дата, то диапозон ,соотвественно, равен 00.00.01-23.59.59, что полностью охватывает выбранный день
+Элемент, который автоматически отображает 2 календаря для выбора диапазона дат. Календари находятся на одной линии. Под каждым календарем поле-указывает в формате д.м.гг дату, которая выбрана на календаре. В скрытое поле каждого календаря помещается время в unixtime, причем первый календарь (слева) отсчитывает время от 00.00.01, а второй (справа) с 23.59.59. Если на правом и на левом календарях отмечена одна дата, то диапазон, соответственно, равен 00.00.01-23.59.59, что полностью охватывает выбранный день.
 <pre>
 // добавляем новый элемент в форму
 $element = $mform->addElement('dof_calendar', 'calendarname', 'Текст с пояснением:', $options),где
 'Текст с пояснением:' - Текст, который будет выведен выше календарей
-$options - массив, с указанием дат(левый и праавй календарь)
+$options - массив, с указанием дат(левый и правый календарь)
 * $options['date_from'] - с какой даты брать отсчет(левый календарь)(unix time)
 * $options['date_to']  - по какую дату брать отсчет(правый календарь)(unix time)
 </pre>
-Если параметр options опущен, то береться текущая дата.
+Если параметр options опущен, то берется текущая дата.
-Важно !! При объявлении времени, нужно брать массив именно с ЭТИМИ параметры(date_from, date_to).
+Важно !! При объявлении времени, нужно брать массив именно с этими параметры(date_from, date_to).
 Выходные данные имеют вид
 <pre>