library carbon-fields-urlpicker

iamntz/carbon-fields-urlpicker

Carbon Fields extension, that adds a URL picker field type.

Carbon Field: urlpicker

(this is an extension of Carbon Fields plugin), _(*1)

Adds a urlpicker field type to Carbon Fields. Install using composer:, _(*2)

composer require iamntz/carbon-fields-urlpicker

You're using Carbon Fields v3? Then install it from the v3 branch!, _(*3)

composer require iamntz/carbon-fields-urlpicker:v3.x-dev

(first, make sure you have "minimum-stability": "dev" set in composer.json), _(*4)

Or by installing as a WP plugin (composer is recommended though; installing as a plugin may throw an error)., _(*5)

Return values:

The field will return an associative array with the following values:, _(*6)

url: the actual URL
anchor: the text anchor (might be blank)
blank: wether the link should open in a new window or not

Demo

https://img.iamntz.com/jing/video_2017-09-01__12_22.mp4, _(*7)

Example

Registering A Field

This goes in your functions.php as with other Carbon Fields fields. The only difference is that the type is urlpicker., _(*8)

use Carbon_Fields\Container;
use Carbon_Fields\Field;

add_action( 'carbon_fields_register_fields', 'crb_url_picker_test' );

function crb_url_picker_test() {
  Container::make( 'post_meta', 'URL Picker Test' )
    ->add_fields( array(
      Field::make( 'urlpicker', 'crb_my_link', 'URL Picker Test' )
      ->set_help_text( "This is a test of the URL picker." )
    ));
}

Using Field Values

<?php $my_link = carbon_get_the_post_meta( 'crb_my_link' ); ?>
<a href="<?= $my_link[url] ?>"<?= ( $my_link[blank] ? ' target="_blank"' : '') ?>><?= $my_link[anchor] ?></a>

Note that the anchor field will return 0 or 1, depending on whether the checkbox is ticked next to "Open link in a new tab"., _(*9)

Found this useful?

You can get hosting (and receive $10 credit!), donate or buy me a gift., _(*10)