list( $label, $control, $help ) ) {
printf(
'%1$s%2$s%3$s
',
// The title of a group of boxes is text on its own line, as a label is on this form.
self::GROUP === $id ? '' . esc_html( $label ) . ' ' : self::label( $id, $label ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Escaped in label().
$control, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Built from escaped values in fields().
'' !== $help ? '' . esc_html( $help ) . '
' : ''
);
}
}
/**
* Prints the fields on the form that edits a board.
*
* @param WP_Term $board Board being edited.
*/
public static function render_on_edit( WP_Term $board ): void {
foreach ( self::fields( BoardSettings::get( $board->term_id ) ) as $id => list( $label, $control, $help ) ) {
printf(
'%1$s %2$s%3$s ' . esc_html( $help ) . '
' : ''
);
}
// Inside a table cell, the only place this form allows more fields.
echo '';
wp_nonce_field( self::NONCE_ACTION, self::NONCE_FIELD );
echo ' $settings Settings to show.
* @return array
*/
private static function fields( array $settings ): array {
$who = [
BoardSettings::ANYONE => __( 'Everyone, including visitors without an account', 'feature-request-system' ),
BoardSettings::LOGGED_IN => __( 'Logged-in users', 'feature-request-system' ),
BoardSettings::NOBODY => __( 'Nobody', 'feature-request-system' ),
];
$page = (string) wp_dropdown_pages(
[
'echo' => 0,
'name' => esc_attr( self::name( BoardSettings::PAGE ) ),
'id' => 'mwtfrs-board-page',
'selected' => (int) $settings[ BoardSettings::PAGE ],
'show_option_none' => esc_html__( '— Not set —', 'feature-request-system' ),
'option_none_value' => '0',
]
);
return [
'mwtfrs-board-voting' => [
__( 'Who can vote', 'feature-request-system' ),
self::select( 'mwtfrs-board-voting', BoardSettings::VOTING, $who, (string) $settings[ BoardSettings::VOTING ] ),
'',
],
'mwtfrs-board-submitting' => [
__( 'Who can suggest features', 'feature-request-system' ),
self::select( 'mwtfrs-board-submitting', BoardSettings::SUBMITTING, $who, (string) $settings[ BoardSettings::SUBMITTING ] ),
'',
],
'mwtfrs-board-moderation' => [
__( 'New requests', 'feature-request-system' ),
sprintf(
'' . esc_html__( 'Categories', 'feature-request-system' ) . ' ';
foreach ( $categories as $category ) {
$html .= sprintf(
'%2$s ', esc_attr( $id ), esc_html( $label ) );
}
/**
* Returns a dropdown.
*
* @param string $id HTML id.
* @param string $setting Setting the dropdown is for.
* @param array $options Labels by value.
* @param string $selected Selected value.
*/
private static function select( string $id, string $setting, array $options, string $selected ): string {
$html = sprintf( '', esc_attr( $id ), esc_attr( self::name( $setting ) ) );
foreach ( $options as $value => $label ) {
$html .= sprintf( '%3$s ', esc_attr( $value ), selected( $selected, $value, false ), esc_html( $label ) );
}
return $html . ' ';
}
/**
* Name of a setting's form field.
*
* @param string $setting Setting key.
*/
private static function name( string $setting ): string {
return self::FIELD . '[' . $setting . ']';
}
}