Review inline docs/coding standards for wp-includes/class-wp-customize-widgets.php

[ocean90]

• Remove @action/@filter tags
• Add missing method descriptions
• Add missing tags like @since
• Remove UPDATE_WIDGET_AJAX_ACTION/UPDATE_WIDGET_NONCE_POST_KEY constants
• Think about lines L71-L95

For now, Options_Transaction can be ignored, see #27504.

[DrewAPicture]

Docs: first pass.

[ocean90]

In 27753:

Widget Customizer: First pass for inline docs.

props DrewAPicture.
see #27534.

[ocean90]

In 27818:

Widget Customizer: Remove UPDATE_WIDGET_AJAX_ACTION and UPDATE_WIDGET_NONCE_POST_KEY constants.

see #27534.

[ocean90]

In 27819:

Widget Customizer: Simplify nonces.

see #27534.

[DrewAPicture]

#27531 was marked as a duplicate.

[DrewAPicture]

In 27903:

Second-pass inline documentation improvements for WP_Customize_Widgets.

See #27534.

[DrewAPicture]

In 27904:

Coding standards and readability spacing for WP_Customize_Widgets.

Also explicitly re-mark _capture_filter_pre_update_option() and _capture_filter_pre_get_option() as public.

See #27534.

[DrewAPicture]

_capture_* tweaks

[DrewAPicture]

I propose since both _capture_filter_pre_update_option() and _capture_filter_pre_get_option() are actually public we should remove the leading underscores. This is done in 27534.2.diff​ along with fixing an incorrect hook name in stop_capturing_option_updates().

[ocean90]

In 27910:

Widget Customizer: Remove leading underscores from public methods.

Fix also an incorrect hook name in stop_capturing_option_updates().

props DrewAPicture.
see #27534.

[ocean90]

Minior things, should be included in a next commit.

[ocean90]

In 27968:

Widget Customizer: Minor code cleanup.

• Remove type hinting from WP_Customize_Widgets
• Rename inject_preview_css to print_preview_css
• Remove stray @todo

fixes #27534.