Download the PHP package pstaender/kirby-uri-field without Composer
On this page you can find all versions of the php package pstaender/kirby-uri-field. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pstaender/kirby-uri-field
More information about pstaender/kirby-uri-field
Files in pstaender/kirby-uri-field
Package kirby-uri-field
Short Description Kirby 3 uri field which can be assigned also assigned to a page or a file.
License MIT
Informations about the package kirby-uri-field
kirby-link-field
Kirby 3 Field for links of any kind - external, page, file, email, phone. Has settings for text, popup true/false, and hash. Original plugin is this, created by Thomas Günther.
The plugin uses the native Kirby fields for pages, files, url, email, and tel:
If used inside a structure field, link fields get a nice preview. Links to pages and files get the native page/file preview:
Installation
With Composer:
...or check out other plugin installation methods.
Blueprint
Add a field and set its type to link
:
To define what link types you want, use options
. Possible values are url
, page
, file
, email
, and tel
:
By default, you can also specify link text, popup true/false, and hash. You can disable those options or change their appearance by using the settings
value:
To disable settings altogether, set:
You could also apply such settings globally:
config/config.php
...or:
Pages/Files Settings
You could specify settings for the pages/files field. For example:
Usage
To render the links, use the provided toLinkObject()
method. It returns an instance of the Link class.
Let's say you have a field with the following values:
$link->url()
Returns the link URL, including the hash:
Note: For email
and tel
links, the value is null
since they're not actual links.
$link->href()
Returns link href:
If the link type is email
or tel
, it has mailto:
or tel:
accordingly.
Note: This is automatically called when you try to convert the class to string, meaning that:
...is the same as:
$link->attr([$attributes])
Returns the link attributes, merged with the optional $attributes
:
$link->tag([$attributes])
Returns a full <a>
tag with merged attributes from the optional $attributes
:
$link->title()
Returns either the link text, page title, file title, filename, or finally the value. Used to generate the link text for the tag()
method.
Retrieving Properties
You can get the properties of a link by invoking them as a method:
Migrating From URL Fields
If you've previously used a URL field:
...you could simply change it to:
...and it'll work. Also, the toLinkObject()
method can handle both link formats in your TXT files. It's the same if you have:
...or: