Email Field in WordPress

An email field stores an email address and validates the format as it is entered, so a typo is caught before it is saved.

What It Does

The field behaves like a text field with email validation. The browser refuses obviously malformed addresses, and the value is sanitised as an email on save.

Before You Start

• Nexter Extension is installed and active.
• Content Fields is enabled under Nexter → Content Fields.
• You have a field group, or are about to create one.

Add an Email Field

1. Go to Nexter → Content Fields and open the Group Fields tab.

2. Open a field group, or create a new one.

3. Click Add Field.

4. Set Field Label to Enquiries email. The Field Name fills in automatically and is what you use in code.

5. Set Field Type to Email.

6. Click Update.

Field Settings

Every field is configured across four tabs. These are the settings this field type offers, read from the field group builder in Nexter Extension 4.9.0.

General

Setting	Options	What it does
Default Value		No help text in the UI.

Validation

Setting	Options	What it does
Required		No help text in the UI.

Presentation

Setting	Options	What it does
Instructions		No help text in the UI.
Placeholder Text		No help text in the UI.
Prepend		No help text in the UI.
Append		No help text in the UI.
Wrapper Attributes		No help text in the UI.

Conditional Logic

Setting	Options	What it does
Conditional Logic		No help text in the UI.

When to Use It

• A per-listing enquiries address.
• A contact address on a directory entry.
• A department address on a location page.

Display the Value

Render it as a mailto link, escaping both the address and the URL:

<?php
$email = nxt_field_value( 'enquiries' );
if ( $email && is_email( $email ) ) {
    printf(
        '<a href="%s">%s</a>',
        esc_url( 'mailto:' . $email ),
        esc_html( $email )
    );
}

Limitations

• Validation checks the format only. It cannot confirm the address exists or accepts mail.
• One address per field. For several, use a repeater with an email sub-field.

Troubleshooting

A malformed address was saved anyway

Format validation happens in the browser and can be bypassed by programmatic writes. Check with is_email() before using the value, as above.

Publishing the address attracts spam

Rendering a raw mailto link exposes the address to scrapers. Consider a contact form instead if that matters.

Related Docs

• Create your first field group
• Display a field value on the front end