A widget for ManagerManager that makes selection of documents IDs easier.
- PHP >= 5.4
- (MODX)EvolutionCMS.plugins.ManagerManager >= 0.7
To install you must unzip the archive to /assets/plungins/managermanager/widgets/ddselectdocuments/.
You may also read this documentation:
-
$params- Desctription: Parameters, the pass-by-name style is used.
- Valid values:
stdClassarrayAssociative
- Required
-
$params->fields- Desctription: The names of TVs for which the widget is applied to.
- Valid values:
stringCommaSeparated - Required
-
$params->parentIds- Desctription: Parent documents IDs.
- Valid values:
arraystringCommaSeparated
- Default value:
[0]
-
$params->parentIds[$i]- Desctription: Document ID.
- Valid values:
integer'current'— current document ID (for select children)
- Required
-
$params->depth- Desctription: Depth of search.
- Valid values:
integer - Default value:
1
-
$params->filter- Desctription: Filter clauses, separated by
'&'between pairs and by'='or'!='between keys and values.
For example,'template=15&published=1'means to choose the published documents with template ID == 15. - Valid values:
stringSeparated - Default value: —
- Desctription: Filter clauses, separated by
-
$params->listItemLabelMask- Desctription: Template to be used while rendering elements of the document selection list.
It is set as a string containing placeholders of document fields and TVs.
Also, there is the additional placeholder[+title+]that is substituted with eithermenutitle(if defined) orpagetitle. - Valid values:
string - Default value:
'[+title+] ([+id+])'
- Desctription: Template to be used while rendering elements of the document selection list.
-
$params->maxSelectedItems- Desctription: The largest number of elements that can be selected by user.
- Valid values:
integer0— means selection without a limit
- Default value:
0
-
$params->allowDuplicates- Desctription: Allows to select duplicates values.
- Valid values:
boolean - Default value:
false
-
$params->roles- Desctription: The CMS user roles that the widget is applied to.
- Valid values:
stringCommaSeparated''— when this parameter is empty then widget is applied to the all roles
- Default value:
''
-
$params->roles[$i]- Desctription: CMS user role ID.
- Valid values:
integer - Required
-
$params->templates- Desctription: Document templates IDs for which the widget is applied to.
- Valid values:
stringCommaSeparated''— empty value means the widget is applying to all templates
- Default value:
''
-
$params->templates[$i]- Desctription: Template ID.
- Valid values:
integer - Required
OnDocFormPrerenderOnDocFormRender
mm_ddSelectDocuments([
// TV for which the widget is applied to
'fields' => 'favoriteProducts',
// Let 314 is ID of catalog document, that contains children-products
'parentIds' => [314],
// Search in 3 levels
'depth' => 3,
// Display only published documents with template ID == 42
'filter' => 'template=42&published=1',
// Only 3 or less products can be selected
'maxSelectedItems' => 3,
]);