pdoField. Modx pdofield
pdoField / Сниппеты / pdoTools / docs.modx.pro
- Параметры
- Примеры
Этот сниппет одновременно обладает возможностями getResourceField и UltimateParent, то есть выводит любое поле указанного ресурса или его родителя, включая ТВ параметры.
Отличием от аналогов является работа с документами любых контекстов и возможность указать дополнительные параметры при выборке, что позволяет не выводить поля, например, скрытых ресурсов. Так же с помощью указания параметра &class можно получить поле любого объекта MODX. Может быть вызван как фильтр вывода.
Параметры
Принимает общие параметры выборки и результатов pdoTools и некоторые свои:
| &id | Текущий документ | Идентификатор ресурса. |
| &field | pagetitle | Поле ресурса. |
| &top | Выбирает родителя указанного &id на уровне &top. | |
| &topLevel | Выбирает родителя указанного &id на уровне &topLevel от корня контекста. | |
| &default | Указывает поле ресурса, которое вернётся, если &field окажется пуст. Более быстрый аналог фильтра :default= | |
| &output | Указывает строку, которая вернётся, если и &default, и &field оказались пусты. | |
| &toPlaceholder | Если не пусто, сниппет сохранит все данные в плейсхолдер с этим именем, вместо вывода не экран. |
Если указаны &top или &topLevel, а &context нет, то для его определения будет сделан дополнительный запрос в базу данных.
Работу с чанками сниппет не поддерживает, так как возвращает значение только одного поля.
Примеры
Сниппет может быть вызван как фильтр вывода:
[[*id:pdofield=`longtitle`]]При этом вы можете указывать параметры JSON массивом. Например, выбор второго родителя от ресурса и вывод его «longtitle»:
[[*id:pdofield=`{"top":2,"field":"longtitle"}`]]Но лучше использовать обычный вызов - он и быстрее, и удобнее:
[[pdoField? &id=`[[*id]]` &field=`longtitle` &top=`2` ]]pdoField / Сниппеты / pdoTools / docs.modx.pro
- Параметры
- Примеры
Этот сниппет одновременно обладает возможностями getResourceField и UltimateParent, то есть выводит любое поле указанного ресурса или его родителя, включая ТВ параметры.
Отличием от аналогов является работа с документами любых контекстов и возможность указать дополнительные параметры при выборке, что позволяет не выводить поля, например, скрытых ресурсов. Так же с помощью указания параметра &class можно получить поле любого объекта MODX. Может быть вызван как фильтр вывода.
Параметры
Принимает общие параметры выборки и результатов pdoTools и некоторые свои:
| &id | Текущий документ | Идентификатор ресурса. |
| &field | pagetitle | Поле ресурса. |
| &top | Выбирает родителя указанного &id на уровне &top. | |
| &topLevel | Выбирает родителя указанного &id на уровне &topLevel от корня контекста. | |
| &default | Указывает поле ресурса, которое вернётся, если &field окажется пуст. Более быстрый аналог фильтра :default= | |
| &output | Указывает строку, которая вернётся, если и &default, и &field оказались пусты. | |
| &toPlaceholder | Если не пусто, сниппет сохранит все данные в плейсхолдер с этим именем, вместо вывода не экран. |
Если указаны &top или &topLevel, а &context нет, то для его определения будет сделан дополнительный запрос в базу данных.
Работу с чанками сниппет не поддерживает, так как возвращает значение только одного поля.
Примеры
Сниппет может быть вызван как фильтр вывода:
[[*id:pdofield=`longtitle`]]При этом вы можете указывать параметры JSON массивом. Например, выбор второго родителя от ресурса и вывод его «longtitle»:
[[*id:pdofield=`{"top":2,"field":"longtitle"}`]]Но лучше использовать обычный вызов - он и быстрее, и удобнее:
[[pdoField? &id=`[[*id]]` &field=`longtitle` &top=`2` ]]Snippet / BannerY / Components / docs.modx.pro
Component to manage the banners on the site. Create a banner ad space, then bind to one another, and output on the site in the right places.
It is also able to consider clicks and keep their statistics.
Parameters
| &positions | Comma separated list of ads positions. |
| &showLog | If true, snippet will add detailed log of query for managers. |
| &fastMode | Fast chunks processing. If true, MODX parser will not be used and unprocessed tags will be cut. |
| &limit | If set to non-zero, will only show X number of items. |
| &offset | An offset of items returned by the criteria to skip. |
| &sortby | Return results in specified order. It can be any field of byAd, "RAND()" or "idx" - index of ad in position. |
| &sortdir | Order of the results |
| &outputSeparator | An optional string to separate each tpl instance. |
| &where Массив | A JSON-style expression of criteria to build any additional where clauses from. |
| &showInactive | Show an inactive items. |
| &tpl | Name of a chunk serving as a item template. If not provided, properties are dumped to output for each item. |
| &tplFirst | Name of a chunk serving as item template for the first item. |
| &tplLast | Name of a chunk serving as item template for the last item. |
| &tplOdd | Name of a chunk serving as item template for items with an odd idx value (see idx property). |
| &tplWrapper | Name of a chunk serving as a wrapper template for the output. This does not work with toSeparatePlaceholders. |
| &wrapIfEmpty | If true, will output the wrapper specified in &tplWrapper even if the output is empty. |
| &toPlaceholder | If set, will assign the result to this placeholder instead of outputting it directly. |
| &toSeparatePlaceholders | If set, will assign EACH result to a separate placeholder named by this param suffixed with a sequential number (starting from 0). |
Examples
Before use it is necessary to create a banner and a position previously. See in section Interface
[[!BannerY? &position=`2`]]docs.modx.pro
