URL field
Purpose
A link to a web page (or, when enabled, a mailto: / tel: link).
Field type name
url
Settings
| Setting | Description |
|---|---|
| Instructions | Shown to editors below the field label. (max 2000 characters) |
| Default Value | Returned when nothing has been saved yet. Must be a valid URL. (max 2048 characters) |
| Placeholder | Hint shown inside the empty input. (max 255 characters) |
| Allowed Schemes | Which kinds of links are accepted: http, https, mailto, tel. |
| Translation | How the field behaves in other languages: translate, copy, copy_once or do_not_translate. Used on top-level fields when WPML is active. See WPML. |
| Width | Width on edit screens, to place fields side by side: 100 (full), 75, 66, 50, 33 or 25 (%). Phones always show full width. |
| Label per language | The label and instructions per language code while editing in that language, e.g. {"nl": {"label": "Prijs"}}. Set on the Translation tab when WPML is active. See WPML. |
PHP return value
string, or null.
Example
$url = cafe_get_field( 'website' );
if ( $url ) {
echo '<a href="' . esc_url( $url ) . '">' . esc_html__( 'Visit website', 'my-theme' ) . '</a>';
}