[4.0] Added event onContentValidateData

[BrainforgeUK]

Pull Request for Issue #24901.

Summary of Changes

Added event onContentValidateData
Event onUserBeforeDataValidation now depracted
Testing Instructions

Create a field plugin which implements onContentValidateData function like this...
public function onContentValidateData($form, &$data) {
// Change the data in some way
}
Expected result

The data get's changed.
Actual result

The data get's changed.
Documentation Changes Required

Add documentation for onContentValidateData event.
Add documentation for the existing, but undocumented and now deprecated, onUserBeforeDataValidation event.

[BrainforgeUK]

Replaces pull request #24925

[sakiss]

I cannot understand the usefulness of that change.
Seems like a rename of an event for the shake of renaming it.

[BrainforgeUK]

The event name onUserBeforeDataValidation implies it is only for user validation.
Changing to a generic event means reading the code makes a lot more sense when using the event in other extensions.

[sakiss]

To be consistent with the other events (using before/after) something like onBeforeDataValidation possibly would be better

[BrainforgeUK]

My main point in raising / proposing this is to replace the event name with something more meaningful when using it outside of user validation - code easier to read / search.

It occurs during validation so an On... name places it within validation while OnBefore... would imply it is outside validation.

A quick code search shows other OnContent... events including onContentBeforeDelete and onContentAfterDelete so naming it onContentValidateData looks like it fits in with previously used naming conventions.

[sakiss]

My main point in raising / proposing this is to replace the event name with something more meaningful when using it outside of user validation - code easier to read / search.

It occurs during validation so an On... name places it within validation while OnBefore... would imply it is outside validation.

A quick code search shows other OnContent... events including onContentBeforeDelete and onContentAfterDelete so naming it onContentValidateData looks like it fits in with previously used naming conventions.

The event is triggered before the validation logic. It is important to clarify if it is called before or after, to be clear what actions could be carried out through that. Also onContentValidateData implies that the data are validated by that, which is not the case.

[wilsonge]

Thanks!