PHPackages                             dd/evolutioncms-plugins-managermanager-mm\_ddselectdocuments - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. dd/evolutioncms-plugins-managermanager-mm\_ddselectdocuments

ActiveLibrary[Utility & Helpers](/categories/utility)

dd/evolutioncms-plugins-managermanager-mm\_ddselectdocuments
============================================================

A widget for ManagerManager that makes selection of documents IDs easier.

1.6.1(1y ago)003[1 issues](https://github.com/DivanDesign/EvolutionCMS.plugins.ManagerManager.mm_ddSelectDocuments/issues)PHPPHP >=5.4.0

Since Apr 14Pushed 1y ago2 watchersCompare

[ Source](https://github.com/DivanDesign/EvolutionCMS.plugins.ManagerManager.mm_ddSelectDocuments)[ Packagist](https://packagist.org/packages/dd/evolutioncms-plugins-managermanager-mm_ddselectdocuments)[ Docs](https://code.divandesign.ru/modx/mm_ddselectdocuments)[ RSS](/packages/dd-evolutioncms-plugins-managermanager-mm-ddselectdocuments/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (4)Used By (0)

(MODX)EvolutionCMS.plugins.ManagerManager.mm\_ddSelectDocuments
===============================================================

[](#modxevolutioncmspluginsmanagermanagermm_ddselectdocuments)

A widget for ManagerManager that makes selection of documents IDs easier.

Requires
--------

[](#requires)

- PHP >= 5.4
- [(MODX)EvolutionCMS.plugins.ManagerManager](https://code.divandesign.ru/modx/managermanager) >= 0.7

Installation
------------

[](#installation)

To install you must unzip the archive to `/assets/plungins/managermanager/widgets/ddselectdocuments/`.

You may also read this documentation:

- [(MODX)EvolutionCMS.plugins.ManagerManager](https://code.divandesign.ru/modx/managermanager).
- [(MODX)EvolutionCMS.modules.ddMMEditor](https://code.divandesign.ru/modx/ddmmeditor).

Parameters description
----------------------

[](#parameters-description)

- `$params`

    - Desctription: Parameters, the pass-by-name style is used.
    - Valid values:
        - `stdClass`
        - `arrayAssociative`
    - **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:
        - `array`
        - `stringCommaSeparated`
    - 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: —
- `$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 either `menutitle` (if defined) or `pagetitle`.
    - Valid values: `string`
    - Default value: `'[+title+] ([+id+])'`
- `$params->maxSelectedItems`

    - Desctription: The largest number of elements that can be selected by user.
    - Valid values:
        - `integer`
        - `0` — 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**

CMS events
----------

[](#cms-events)

- `OnDocFormPrerender`
- `OnDocFormRender`

Examples
--------

[](#examples)

### Select 3 favorite published products

[](#select-3-favorite-published-products)

```
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,
]);
```

Links
-----

[](#links)

- [Home page](https://code.divandesign.ru/modx/mm_ddselectdocuments)
- [Telegram chat](https://t.me/dd_code)
- [Packagist](https://packagist.org/packages/dd/evolutioncms-plugins-managermanager-mm_ddselectdocuments)
- [GitHub](https://github.com/DivanDesign/EvolutionCMS.plugins.ManagerManager.mm_ddSelectDocuments)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance44

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1055 days

Total

2

Last Release

439d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/09b81986267e62b5fde1473b40aa6f11f7bc26c1c29d5f80f2768c8788e08110?d=identicon)[dd](/maintainers/dd)

---

Top Contributors

[![Ronef](https://avatars.githubusercontent.com/u/1333424?v=4)](https://github.com/Ronef "Ronef (18 commits)")[![2frags](https://avatars.githubusercontent.com/u/3579847?v=4)](https://github.com/2frags "2frags (2 commits)")

---

Tags

modxMODX Evoevoevolution-cmsmodx evolutionevo cmsevolutioncmsdivandesigndd studiodd groupmmmanagermanagermm widgetmm\_ddselectdocumentsselect documentsdocuments selectionselect documents idsselect children ids

### Embed Badge

![Health badge](/badges/dd-evolutioncms-plugins-managermanager-mm-ddselectdocuments/health.svg)

```
[![Health](https://phpackages.com/badges/dd-evolutioncms-plugins-managermanager-mm-ddselectdocuments/health.svg)](https://phpackages.com/packages/dd-evolutioncms-plugins-managermanager-mm-ddselectdocuments)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)