of the next row helper call. Used for rows that depend on a select:
* the select's row gets data-fwren-switch, the rows it controls data-fwren-case="value [value]".
*
* @param array $attrs name => value.
*/
public static function row_attr( array $attrs ) {
$out = '';
foreach ( $attrs as $k => $v ) {
$out .= ' ' . sanitize_key( $k ) . '="' . esc_attr( $v ) . '"';
}
self::$row_attrs = $out;
}
/** Row wrapper. */
private static function row( $label, $control, $desc = '', $for = '', $kind = 'field' ) {
$attrs = self::$row_attrs;
self::$row_attrs = '';
echo '
' . ( $for ? '' : esc_html( $label ) ) . '
' . $control . ( $desc ? '
' . wp_kses_post( $desc ) . '
' : '' ) . '
'; // phpcs:ignore
}
/** Open a group of settings: a heading and description above its panel(s). */
public static function section( $title, $desc = '' ) {
echo '
' . esc_html( $title ) . '
' . ( $desc ? '
' . esc_html( $desc ) . '
' : '' ) . '';
}
/** Close a group of settings. */
public static function section_end() {
echo '';
}
/**
* Open a settings panel.
*
* @param bool $dependent The first row is a switch; the rows after it only show while it is on.
*/
public static function panel( $dependent = false ) {
echo '
';
}
/** Close a settings panel. */
public static function panel_end() {
echo '
';
}
/** A small heading between the rows of a panel. */
public static function subhead( $title ) {
echo '
';
}
/** Restrictions. */
private static function tab_restrictions( $form_id, array $s ) {
$r = $s['restrictions'];
self::section( __( 'Limit entries', 'fieldwren' ), __( 'Close the form once it has enough submissions.', 'fieldwren' ) );
self::panel( true );
self::toggle( 'fwren[restrictions][limit_entries][enabled]', $r['limit_entries']['enabled'], __( 'Limit the number of entries', 'fieldwren' ) );
self::text( 'fwren[restrictions][limit_entries][count]', $r['limit_entries']['count'], __( 'Maximum entries', 'fieldwren' ), '', 'number' );
self::select( 'fwren[restrictions][limit_entries][period]', $r['limit_entries']['period'], __( 'Per', 'fieldwren' ), array( 'total' => __( 'In total', 'fieldwren' ), 'day' => __( 'Day', 'fieldwren' ), 'week' => __( 'Week', 'fieldwren' ), 'month' => __( 'Month', 'fieldwren' ), 'year' => __( 'Year', 'fieldwren' ) ) );
self::textarea( 'fwren[restrictions][limit_entries][message]', $r['limit_entries']['message'], __( 'Message when full', 'fieldwren' ), '', 2 );
self::panel_end();
self::section_end();
self::section( __( 'Schedule', 'fieldwren' ), __( 'Accept submissions only inside a date range.', 'fieldwren' ) );
self::panel( true );
self::toggle( 'fwren[restrictions][schedule][enabled]', $r['schedule']['enabled'], __( 'Open the form only between dates', 'fieldwren' ) );
self::text( 'fwren[restrictions][schedule][start]', $r['schedule']['start'], __( 'Opens', 'fieldwren' ), '', 'datetime-local' );
self::text( 'fwren[restrictions][schedule][end]', $r['schedule']['end'], __( 'Closes', 'fieldwren' ), '', 'datetime-local' );
self::textarea( 'fwren[restrictions][schedule][pending_message]', $r['schedule']['pending_message'], __( 'Message before opening', 'fieldwren' ), '', 2 );
self::textarea( 'fwren[restrictions][schedule][expired_message]', $r['schedule']['expired_message'], __( 'Message after closing', 'fieldwren' ), '', 2 );
self::panel_end();
self::section_end();
self::section( __( 'Who can submit', 'fieldwren' ), __( 'Ask for an account, or cap how often one person can submit.', 'fieldwren' ) );
self::panel( true );
self::toggle( 'fwren[restrictions][login_required][enabled]', $r['login_required']['enabled'], __( 'Require login', 'fieldwren' ) );
self::textarea( 'fwren[restrictions][login_required][message]', $r['login_required']['message'], __( 'Message for visitors', 'fieldwren' ), '', 2 );
self::panel_end();
self::panel( true );
self::toggle( 'fwren[restrictions][per_user][enabled]', $r['per_user']['enabled'], __( 'Limit entries per person', 'fieldwren' ) );
self::text( 'fwren[restrictions][per_user][count]', $r['per_user']['count'], __( 'Entries per person', 'fieldwren' ), '', 'number' );
self::select( 'fwren[restrictions][per_user][by]', $r['per_user']['by'], __( 'Identify by', 'fieldwren' ), array( 'ip' => __( 'IP address', 'fieldwren' ), 'user' => __( 'Logged-in user', 'fieldwren' ), 'cookie' => __( 'Browser cookie', 'fieldwren' ) ) );
self::textarea( 'fwren[restrictions][per_user][message]', $r['per_user']['message'], __( 'Message', 'fieldwren' ), '', 2 );
self::panel_end();
self::panel();
self::toggle( 'fwren[restrictions][deny_empty][enabled]', $r['deny_empty']['enabled'], __( 'Reject empty submissions', 'fieldwren' ) );
self::panel_end();
self::section_end();
self::section( __( 'Blocklist', 'fieldwren' ), __( 'Reject submissions with certain words, senders or IP addresses.', 'fieldwren' ) );
self::panel( true );
self::toggle( 'fwren[restrictions][blocklist][enabled]', $r['blocklist']['enabled'], __( 'Block submissions containing', 'fieldwren' ) );
self::textarea( 'fwren[restrictions][blocklist][keywords]', $r['blocklist']['keywords'], __( 'Words or phrases', 'fieldwren' ), __( 'One per line or comma separated.', 'fieldwren' ), 3 );
self::textarea( 'fwren[restrictions][blocklist][emails]', $r['blocklist']['emails'], __( 'Emails or domains', 'fieldwren' ), '', 2 );
self::textarea( 'fwren[restrictions][blocklist][ips]', $r['blocklist']['ips'], __( 'IP addresses', 'fieldwren' ), __( 'Use a trailing * for ranges, e.g. 203.0.113.*', 'fieldwren' ), 2 );
self::textarea( 'fwren[restrictions][blocklist][message]', $r['blocklist']['message'], __( 'Message', 'fieldwren' ), '', 2 );
self::panel_end();
self::section_end();
}
/** Spam. */
private static function tab_spam( $form_id, array $s ) {
$sp = $s['spam'];
self::section( __( 'Bot traps', 'fieldwren' ), __( 'Invisible checks that stop most automated spam without bothering people.', 'fieldwren' ) );
self::panel();
self::toggle( 'fwren[spam][honeypot]', $sp['honeypot'], __( 'Honeypot', 'fieldwren' ), __( 'A hidden field bots fill in.', 'fieldwren' ) );
self::text( 'fwren[spam][time_trap]', $sp['time_trap'], __( 'Minimum seconds before submitting', 'fieldwren' ), __( '0 = off.', 'fieldwren' ), 'number' );
self::panel_end();
self::section_end();
self::section( __( 'Captcha & filtering', 'fieldwren' ), __( 'A challenge or a reputation check for this form.', 'fieldwren' ) );
self::panel();
self::select( 'fwren[spam][captcha]', $sp['captcha'], __( 'Captcha', 'fieldwren' ), array( 'global' => __( 'Global default', 'fieldwren' ), 'none' => __( 'None', 'fieldwren' ), 'turnstile' => 'Cloudflare Turnstile', 'recaptcha_v3' => 'reCAPTCHA v3', 'recaptcha_v2' => 'reCAPTCHA v2', 'hcaptcha' => 'hCaptcha' ), __( 'Keys are set in Forms → Settings → Captcha.', 'fieldwren' ) );
self::toggle( 'fwren[spam][akismet]', $sp['akismet'], __( 'Check with Akismet', 'fieldwren' ) );
self::panel_end();
self::section_end();
self::section( __( 'Rate limit', 'fieldwren' ), __( 'Cap how often one IP address can submit.', 'fieldwren' ) );
self::panel( true );
self::toggle( 'fwren[spam][rate_limit][enabled]', $sp['rate_limit']['enabled'], __( 'Rate limit per IP', 'fieldwren' ) );
self::text( 'fwren[spam][rate_limit][count]', $sp['rate_limit']['count'], __( 'Submissions allowed', 'fieldwren' ), '', 'number' );
self::text( 'fwren[spam][rate_limit][minutes]', $sp['rate_limit']['minutes'], __( 'Per minutes', 'fieldwren' ), '', 'number' );
self::panel_end();
self::section_end();
}
/** Custom CSS & JS (styling itself lives in the block inspector). */
private static function tab_style( $form_id, array $s ) {
$l = $s['layout'];
echo '
' . Icons::svg( 'info', 18 ) . '
' . esc_html__( 'Field, label, input and button styles are set per block in the form editor (Style tab). Use custom CSS for anything else.', 'fieldwren' ) . '
'; // phpcs:ignore
self::panel();
self::textarea( 'fwren[layout][custom_css]', $l['custom_css'], __( 'Custom CSS', 'fieldwren' ), __( 'Selectors are scoped to this form automatically. Use {{form}} for the form wrapper itself.', 'fieldwren' ), 8 );
if ( current_user_can( 'unfiltered_html' ) ) {
self::textarea( 'fwren[layout][custom_js]', $l['custom_js'], __( 'Custom JavaScript', 'fieldwren' ), __( 'Runs when the form is ready. Variables: $form (the form element). Listen to fwren:submitted, fwren:step, fwren:change.', 'fieldwren' ), 6 );
}
self::panel_end();
}
/* ------------------------------------------------------------------ *
* Global settings
* ------------------------------------------------------------------ */
/** Page. */
public static function page_global() {
$tabs = apply_filters(
'fwren/admin/global_tabs',
array(
'general' => __( 'General', 'fieldwren' ),
'captcha' => __( 'Captcha', 'fieldwren' ),
'email' => __( 'Email', 'fieldwren' ),
'tracking'=> __( 'Conversion tracking', 'fieldwren' ),
)
);
$tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'general'; // phpcs:ignore
if ( ! isset( $tabs[ $tab ] ) ) {
$tab = 'general';
}
$g = Settings::all();
$nav = Admin_Dashboard::nav();
Admin_Dashboard::open( $tab, isset( $nav[ $tab ] ) ? $nav[ $tab ][0] : $tabs[ $tab ] );
if ( isset( $nav[ $tab ] ) ) {
echo '