dd / evolutioncms-plugins-managermanager-mm_dddependentfields
The plugin allows to link 2 fields with a master-dependent relation. Dependent field will only be used (displayed) only when Master field has a specific value. Value of Dependent field will also be cleared when it is not used (hidden).
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Language:JavaScript
pkg:composer/dd/evolutioncms-plugins-managermanager-mm_dddependentfields
Requires
- php: >=7.4.0
- dd/evolutioncms-plugins-managermanager: >=0.7.0
This package is auto-updated.
Last update: 2025-10-06 08:19:32 UTC
README
The plugin allows to link 2 fields with a master-dependent relation:
- Dependent field will only be used (displayed) only when Master field has a specific value.
- Value of Dependent field will also be cleared when it is not used (hidden).
Requires
- PHP >= 7.4 (not tested with older versions)
- (MODX)EvolutionCMS.plugins.ManagerManager >= 0.7
Installation
To install you must unzip the archive to /assets/plungins/managermanager/widgets/dependentFields/.
You may also read this documentation:
Parameters description
-
$params- Desctription: The object of parameters.
- Valid values:
stdClassarrayAssociative
- Required
-
$params->masterFieldName- Desctription: The name of the document field (or TV) to be Master.
- Valid values:
string - Required
-
$params->masterFieldValue- Desctription: The value of the Master field when the Dependent field should be used.
- Valid values:
string - Default:
null
-
$params->dependentFieldName- Desctription: The name of the document field (or TV) to be Dependent.
- Valid values:
string - Required
-
$params->roles- Desctription: The CMS user roles that the widget is applied to.
- Valid values:
arraystringCommaSeparated''— 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:
arraystringCommaSeparated''— empty value means the widget is applying to all templates
- Default value:
''
-
$params->templates[$i]- Desctription: Template ID.
- Valid values:
integer - Required
CMS events
OnDocFormPrerenderOnDocFormRender
Examples
Make a page's publish date dependent on its publish status
mm_ddDependentFields([ 'masterFieldName' => 'published', 'masterFieldValue' => '1', 'dependentFieldName' => 'pub_date', ]);
pub_datewill be visible only whenpublishedis on (==1).- Value of
pub_datewill be cleared whenpublishedis off.