Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ahebrank/ACF-Link-Picker-Field

A new field for Advanced Custom Fields allowing use of standard link picker modal dialog. Now available at https://wordpress.org/plugins/acf-link-picker-field/
https://github.com/ahebrank/ACF-Link-Picker-Field

Last synced: 3 days ago
JSON representation

A new field for Advanced Custom Fields allowing use of standard link picker modal dialog. Now available at https://wordpress.org/plugins/acf-link-picker-field/

Awesome Lists containing this project

README 

        
=== Advanced Custom Fields: Link Picker Field ===



Contributors: BIOSTALL, caalami

Tags: acf, advanced custom fields, link picker, link chooser, acf link picker

Requires at least: 3.5

Tested up to: 4.8

Stable tag: trunk

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html



Adds an Advanced Custom Field field that allows the selection of a link utilising the WordPress link picker modal dialog



== Description ==



This add on for the already established Advanced Custom Fields plugin adds a new field type called 'Link Picker' which allows the user to enter a URL, or select from the existing pages. It is a thin wrapper around the link selector included with the WYSIWYG field editor.



This plugin is forked from the plugin of the same name hosted at https://github.com/BIOSTALL/ACF-Link-Picker-Field. This version is hosted at https://github.com/ahebrank/ACF-Link-Picker-Field and issues and PRs should be submitted there.



Note: Advanced Custom Fields must be installed for this add-on to work.



== Compatibility ==



This ACF field type is compatible with:



*	ACF 5

*	ACF 4



*ACF 4 support is deprecated, and new plugin features will generally not work with ACF 4.*



== Installation ==



1. Copy the `acf-link_picker` folder into your `wp-content/plugins` folder

2. Activate the 'Advanced Custom Fields: Link Picker' plugin via the plugins admin page

3. Create a new field via ACF and select the Link Picker type



== Usage ==



When outputting the link selection on the front end, you will have three object elements available:



*	url - The URL of the page

*	title - The title of the link, if entered

*	target - Will be either a blank string or '_blank', depending on whether the user has ticked the box for the link to open in a new window/tab.

* postid - Not available as part of wp_link, this is an ajax hack to attempt to look up the post ID of a selected link. This will return 0 if the post ID was not found.



Code example:



`$mylink = get_field('mylink');`

`var_dump($mylink);`



Outputs:



`array(3) {

  ["url"]=>

  string(31) "http://mysite.com/selected/url/"

  ["title"]=>

  string(10) "Link Title"

  ["target"]=>

  string(6) "_blank"

  ["postid"]=>

  int 2231

}`



== Changelog ==



= 1.2.8 =

* Some additional compatibility checks for ACF 4 (disable post ID lookups to suppress JS errors)



= 1.2.7 =

* Enqueue wysiwyg assets if needed (thanks, [dmarkowicz](https://github.com/dmarkowicz))



= 1.2.6 =

* Bugfix: revert setting empty values



= 1.2.5 =

* Multiple fixes from [Jontis00](https://github.com/Jontis00), including:

  * Set a default (empty) value for the field

  * Refactor the post ID lookup

  * Add sv_SE translations



= 1.2.3 =

* Make the link class a little more distinctive -- thanks, [dmarkowicz](https://github.com/dmarkowicz)



= 1.2.2 =

* New handlers for the updated link picker with WP 4.5.



= 1.2.1 =

* Attempt to add a post ID ($link["postid"]) to the field data



= 1.2 =

* Automatically update the link title when clicking on a link.  This functionality differs from the WYSIWYG link picker (which assumes highlighted text) but should be consistent with expected behavior of an ACF field.



= 1.1.2 =

* Add NL translation support from [vjanssens](https://github.com/vjanssens)



= 1.1.1 =

* Add PT translation support from [alvarogois](https://github.com/alvarogois)

* Bump compatibility information



= 1.1 =

* Bump version, preserve _blank target if set from [philmprice](https://github.com/philmprice)



= 1.0.3 =

* Translation support from [m0n0mind](https://github.com/m0n0mind)



= 1.0.2 =

* Forked by ahebrank and refactored, updated for compatibility with WP 4.2



= 1.0.1 =

* Solve bug with repeater fields (credit to Willy Bahuaud http://wabeo.fr/)

* Solve problem with empty values (credit to Willy Bahuaud http://wabeo.fr/)



= 1.0.0 =

* Initial Release.



== Upgrade Notice ==



= 1.1 =

Adds target attribute preservation



= 1.0.3 =

Adds German translation support



= 1.0.2 =

Adds WP 4.2+ support