ddGetMultipleField Полная история изменений

3.3

  • Добавлена возможность использовать встроенные шаблоны, используя префикс «@CODE:». Работает с «$rowTpl», «$colTpl», «$outerTpl».
  • Дополнительные данные из параметра «placeholders» теперь также будут переданы в шаблоны строк и колонок (параметры «rowTpl» и «colTpl»).
  • Дополнительные данные, передаваемые в параметр «placeholders» должны быть в виде query string (старый формат поддерживается, но не рекомендуется к использвоанию).
  • Следующие параметры переименованы (старые имена пока поддерживаются, но не рекомендуются к использованию):
    • «string» → «inputString».
    • «docField» → «inputString_docField».
    • «docId» → «inputString_docId».
  • Рефакторинг: Результат сниппета будет возвращён в любом случае (пустая строка для пустого результата).

3.2

  • Плэйсхолдер «[+rowNumber+]» также доступен в шаблонах колонок (параметр «colTpl»).
  • В шаблонах строк и колонок доступен довый плэйсхолдер «[+rowNumber.zeroBased+]» — номер строки, начинающийся с 0, это бывает удобно.
  • Рефакторинг:
    • Шаблоны колонок обрабатываются только если они используются.
    • Параметры «sortBy» и «sortDir» обрабатываются только если они используются.
    • Параметры «startRow» и «totalRows» обрабатываются только если они используются.
    • Следующие внутренние переменные были переименованы:
      • «$res» → «$data».
      • «$val» → «$row».
      • «$key» → «$rowNumber».
      • «$v» → «$column».
      • «$k» → «$columnNumber».
      • «$v» → «$value».
      • «$val» → «$value».

3.1

  • Добавлен формат вывода «htmlarray» — одномерный массив, элементы которого — готовые полностью обработанные строки (см. параметр «outputFormat»). Как и «array», имеет смысл использовать вместе с параметром «resultToPlaceholder».

3.0b

  • Вместо локальной функции для сортировки используется метод «ddTools:sort2dArray».
  • Внимание! Сниппет теперь использует библиотеку «modx.ddTools» 0.11!
  • Значение поля получается при помощи метода «ddTools:getTemplateVarOutput», сниппет «ddGetDocumentField» больше не используется.
  • Параметры переименованы, изменены их описания и порядок:
    • «field» в «string».
    • «getField» в «docField».
    • «getId» в «docId».
    • «splY» в «rowDelimiter».
    • «splX» в «colDelimiter».
    • «num» в «startRow».
    • «count» в «totalRows».
    • «colNum» в «columns».
    • «vals» в «filter».
    • «typographing» в «typography».
    • «format» в «outputFormat».
    • «glueY» в «rowGlue».
    • «glueX» в «colGlue».
    • «tplY» в «rowTpl».
    • «tplX» в «colTpl».
    • «tplWrap» в «outerTpl».
    • «totalPlaceholder» в «totalRowsToPlaceholder».
  • Типографируется теперь не весь результат работы сниппета, а каждое значение по отдельности.
  • Параметр «typography» принимает не булевое значение, а список колонок через запятую, значения которых нужно типографировать.
  • Параметр «resultToPlaceholder» принимает не булевое значение, а имя плэйсхолдера.
  • Плэйсхолдер «[+row_number+]» при выводе в чанк «rowTpl» переименован в «[+rowNumber+]».
  • Плэйсхолдеры вида «[+rowY.valX+]» при выводе в чанк «outerTpl» переименованы в «[+rowY.colX+]».
  • Плэйсхолдеры вида «[+valX+]» при выводе в чанк «rowTpl» переименованы в «[+colX+]».
  • Плэйсхолдер «[+wrapper+]» при выводе в чанк «outerTpl» переименован в «[+result+]».
  • Небольшие исправления, изменения стиля кода и прочие изменения.

2.18

  • Внимание! Сниппет теперь использует библиотеку modx.ddTools 0.10!
  • Исправлена ошибка: плэйсхолдер «» в чанке «tplWrap» появлялся только если задан параметр «placeholders».
  • При выводе в чанки «tplY» и «tplWrap» добавлен плэйсхолдер ««, содержащий количество возвращаемых элементов.
  • Внимание! В плэйсхолдер «» теперь возвращается общее количество элементов.
  • При выводе в чанк «tplWrap» доступны плэйсхолдеры вида ««, содержащие все значения, где «Y» — номер строки, «X» — номер колонки.
  • Незначительные изменения кода.

2.17

  • Добавлена фильтрация по всем колонкам (см. параметр «vals»).

2.16.2

  • При сортировке добавлена обработка числовых значений, теперь они сравниваются как числа, а не как строки.

2.16.1

  • Исправлена ошибка с обращением к не объявленным переменным (php 5.3).

2.16

  • Плэйсхолдер теперь выводится и в «tplWrap».
  • Для получения значения документа используется сниппет ddGetDocumentField версии 2.4.
  • За ненадобностью удалён параметр «getPublished». Теперь наконец без разницы, опубликован ли документ.
  • Параметры «splY» и «splX» теперь могут принимать регулярные выражения.
  • Добавлена возможность сохранять результаты сниппета в плэйсхолдер, см. параметр «resultToPlaceholder».
  • Добавлена возможность вывода в формате массива (полезно при запуске через runSnippet или при сохранении результата в плэйсхолдер), см. параметр «format».

2.15

  • Добавлена возможность выводить общее количество строк во внешний плэйсхолдер (параметр «totalPlaceholder»).

2.14

  • При выводе в чанк «tplY» добавлен плэйсхолдер [+total+], содержащий общее количество строк.

2.13

  • В параметре «sortDir» добавлено возможное значение ‘REVERSE', при котором значения выводятся просто в обратном порядке.