Download the PHP package livy/plumbing-normalize-links without Composer
On this page you can find all versions of the php package livy/plumbing-normalize-links. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download livy/plumbing-normalize-links
More information about livy/plumbing-normalize-links
Files in livy/plumbing-normalize-links
Package plumbing-normalize-links
Short Description Normalize the output of WordPress's native "link" in ACF.
License MIT
Informations about the package plumbing-normalize-links
= Normalize Links
image:https://travis-ci.org/alwaysblank/plumbing-normalize-links.svg?branch=dev["Build Status", link="https://travis-ci.org/alwaysblank/plumbing-normalize-links"]
The purpose of this small package is to ingest the link arrays produced by https://www.advancedcustomfields.com/resources/link/[ACF's "link" field type], do a bit of logic on them, and provide a nice interface for interacting with that data. It can also accept urls as plain strings.
== Usage
.ACF field [source,php]
$Link = new Normalized(get_field('some_link'));
$Link->valid(); //whether or not this is a "valid" link $Link->url(); // the URL of the link $Link->label(); // the "title" set for this link $Link->newTab(); // whether this link should be opened in a new tab $Link->probablyExternal() // if the link is (probably) external or not
.Simple string [source,php]
$Link = new Normalized('https://www.alwaysblank.org');
=== Settings
A small number of settings are also supported, which can be passed when instantiated.
[source,php]
$Link = new Normalized(get_field('some_link'), [
'label' => "Learn More", // Used as a fallback if there is no title.
'external_in_new_tab' => true, // Always open external links in new tab
'validate' => [
'url' => false,
'label' => false,
], // Validate url and/or label
]);
label
defaults to "Learn More" and external_in_new_tab
defaults to true
.
validate
defaults to not validating inputs.
You can specify which items (url
or label
) to validated, or set validate
to true
to validate all items.