name = esc_html__( 'Address', 'wpforms-lite' );
$this->type = 'address';
$this->icon = 'fa-map-marker';
$this->order = 70;
$this->group = 'fancy';
// Allow for additional or customizing address schemes.
$default_schemes = [
'us' => [
'label' => esc_html__( 'US', 'wpforms-lite' ),
'address1_label' => esc_html__( 'Address Line 1', 'wpforms-lite' ),
'address2_label' => esc_html__( 'Address Line 2', 'wpforms-lite' ),
'city_label' => esc_html__( 'City', 'wpforms-lite' ),
'postal_label' => esc_html__( 'Zip Code', 'wpforms-lite' ),
'state_label' => esc_html__( 'State', 'wpforms-lite' ),
'states' => wpforms_us_states(),
],
'international' => [
'label' => esc_html__( 'International', 'wpforms-lite' ),
'address1_label' => esc_html__( 'Address Line 1', 'wpforms-lite' ),
'address2_label' => esc_html__( 'Address Line 2', 'wpforms-lite' ),
'city_label' => esc_html__( 'City', 'wpforms-lite' ),
'postal_label' => esc_html__( 'Postal Code', 'wpforms-lite' ),
'state_label' => esc_html__( 'State / Province / Region', 'wpforms-lite' ),
'states' => '',
'country_label' => esc_html__( 'Country', 'wpforms-lite' ),
'countries' => wpforms_countries(),
],
];
/**
* Allow modifying address schemes.
*
* @since 1.2.7
*
* @param array $schemes Address schemes.
*/
$this->schemes = apply_filters( 'wpforms_address_schemes', $default_schemes ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
$this->init_pro_field();
$this->hooks();
}
/**
* Hooks.
*
* @since 1.9.4
*/
protected function hooks() {
}
/**
* Field options panel inside the builder.
*
* @since 1.9.4
*
* @param array $field Field data.
*/
public function field_options( $field ) { // phpcs:ignore Generic.Metrics.CyclomaticComplexity.MaxExceeded
/*
* Basic field options.
*/
// Options open markup.
$this->field_option(
'basic-options',
$field,
[
'markup' => 'open',
'after_title' => $this->get_field_options_notice(),
]
);
// Label.
$this->field_option( 'label', $field );
// Address Scheme - was "format" key prior to 1.2.7.
$scheme = ! empty( $field['scheme'] ) ? esc_attr( $field['scheme'] ) : 'us';
if ( empty( $scheme ) && ! empty( $field['format'] ) ) {
$scheme = esc_attr( $field['format'] );
}
$tooltip = esc_html__( 'Select scheme format for the address field.', 'wpforms-lite' );
$options = array_map(
static function ( $s ) {
return $s['label'];
},
$this->schemes
);
$output = $this->field_element(
'label',
$field,
[
'slug' => 'scheme',
'value' => esc_html__( 'Scheme', 'wpforms-lite' ),
'tooltip' => $tooltip,
],
false
);
$output .= $this->field_element(
'select',
$field,
[
'slug' => 'scheme',
'value' => $scheme,
'options' => $options,
],
false
);
$this->field_element(
'row',
$field,
[
'slug' => 'scheme',
'content' => $output,
]
);
// Description.
$this->field_option( 'description', $field );
// Required toggle.
$this->field_option( 'required', $field );
// Options close markup.
$this->field_option(
'basic-options',
$field,
[
'markup' => 'close',
]
);
/*
* Advanced field options.
*/
// Options open markup.
$this->field_option(
'advanced-options',
$field,
[
'markup' => 'open',
]
);
// Size.
$this->field_option( 'size', $field );
// Address Line 1.
$address1_placeholder = ! empty( $field['address1_placeholder'] ) ? esc_attr( $field['address1_placeholder'] ) : '';
$address1_default = ! empty( $field['address1_default'] ) ? esc_attr( $field['address1_default'] ) : '';
printf(
'';
// Address Line 2.
$address2_placeholder = ! empty( $field['address2_placeholder'] ) ? esc_attr( $field['address2_placeholder'] ) : '';
$address2_default = ! empty( $field['address2_default'] ) ? esc_attr( $field['address2_default'] ) : '';
$address2_hide = ! empty( $field['address2_hide'] );
printf(
'';
// City.
$city_placeholder = ! empty( $field['city_placeholder'] ) ? esc_attr( $field['city_placeholder'] ) : '';
$city_default = ! empty( $field['city_default'] ) ? esc_attr( $field['city_default'] ) : '';
printf(
'';
// State.
$state_placeholder = ! empty( $field['state_placeholder'] ) ? $field['state_placeholder'] : '';
printf(
'';
// ZIP/Postal.
$postal_placeholder = ! empty( $field['postal_placeholder'] ) ? esc_attr( $field['postal_placeholder'] ) : '';
$postal_default = ! empty( $field['postal_default'] ) ? esc_attr( $field['postal_default'] ) : '';
$postal_hide = ! empty( $field['postal_hide'] );
$postal_visibility = ! isset( $this->schemes[ $scheme ]['postal_label'] ) ? 'wpforms-hidden' : '';
printf(
'',
sanitize_html_class( $postal_visibility ),
wpforms_validate_field_id( $field['id'] ) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
);
echo '';
// phpcs:disable WordPress.Security.EscapeOutput.OutputNotEscaped
echo '
';
// phpcs:enable WordPress.Security.EscapeOutput.OutputNotEscaped
echo '
',
wpforms_sanitize_classes( $slug ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
wpforms_sanitize_classes( $scheme_hide_class ) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
);
// Row 1 - Address Line 1.
printf(
'
',
esc_attr( $address1_placeholder ),
esc_attr( $address1_default ),
esc_html( $address1_label )
);
// Row 2 - Address Line 2.
printf(
'
',
wpforms_sanitize_classes( $address2_hide ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
esc_attr( $address2_placeholder ),
esc_attr( $address2_default ),
esc_html( $address2_label )
);
// Row 3 - City & State.
echo '
';
// Row 4 - Zip & Country.
echo '
';
// End wrapper.
echo '