Overview
The Page link field allows the selection of 1 or more posts, pages or custom post types. This field is useful for easily linking to another post because it will return the post’s url (permalink). To get more data from the selected post, please use the post object field.
Screenshots
Interface
Settings
Changelog
- Added ‘Allow Archive URLs’ setting in version 5.4.0
- Select2 UI added in v5.0.0
Settings
| Name | Description |
|---|---|
| Post Type | Filter available posts via 1 or more post type |
| Taxonomy | Filter available posts via 1 or more taxonomies |
| Allow Null | If selected, the select list will begin with an empty choice labelled “- Select -“. If using the ‘Stylized UI’ setting, this empty choice will be replaced by a ‘x’ icon allowing you to remove the selected value(s) |
| Allow Archives | If selected, the select list will begin with a group of post type archive urls |
| Multiple | This setting will allow you to select more than one choice. If using the ‘Stylized UI’ setting, you may also drag/drop reorder the selected choices |
Template usage
Basic
This example shows how to load and display a selected page link value.
<a href="<?php the_field('page_link'); ?>">Read this!</a>Multiple
This example shows how to load and display multiple selected page link values
<?php
// vars
$urls = get_field('urls');
// check
if( $urls ): ?>
<h3>Further reading</h3>
<ul>
<?php foreach( $urls as $url ): ?>
<li>
<a href="<?php echo $url ?>"><?php echo $url; ?></a>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>Advanced
This example shows how to load the selected page link value in it’s raw form (post_id) and use this to load extra data about the post.
<?php
// vars
$post_id = get_field('url', false, false);
// check
if( $post_id ): ?>
<a href="<?php echo get_the_permalink($post_id); ?>"><?php echo get_the_title($post_id); ?></a>
<?php endif; ?>