Download the PHP package dynamic/silverstripe-linkable without Composer
On this page you can find all versions of the php package dynamic/silverstripe-linkable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dynamic/silverstripe-linkable
More information about dynamic/silverstripe-linkable
Files in dynamic/silverstripe-linkable
Package silverstripe-linkable
Short Description A couple of handy form fields and objects for managing external and internal links on DataObjects
License BSD-3-Clause
Homepage http://github.com/dynamic/silverstripe-linkable
Informations about the package silverstripe-linkable
SilverStripe Linkable
This module is no longer maintained. Please checkout the following excellent alternatives
Requirements
- SilverStripe 4.x
- Display Logic
See 1.x branch/releases for SilverStripe 3.x support
Maintainers
Description
This module contains a couple of handy FormFields / DataObjects for managing external and internal links on DataObjects, including oEmbed links.
Installation with Composer
Link / LinkField
A Link Object can be linked to a URL, Email, Phone number, an internal Page or File in the SilverStripe instance. A DataObject, such as a Page can have many Link objects managed with a grid field, or one Link managed with LinkField.
Example usage
In your template, you can render the links anchor tag with
Adding custom class to link
The anchor tag can be rendered with a class or classes of your choosing by passing the class string to the setCSSClass()
method within your template.
Customising link templates
Link tags are rendered with the Link.ss template. You can override this template by copying it into your theme or project folder and modifying as required.
You can also specify a custom template to render any Link with by calling the renderWith function and passing in the name of your custom template
Finally, you can optionally offer CMS users the ability to select from a list of templates, allowing them to choose how their Link should be rendered. To enable this feature, create your custom template files and register them in your site config.yml file as below.
Limit allowed Link types
To limit link types for each field.
You can also globally limit link types. To limit types define them in your site config.yml file as below.
The default types available are:
Adding custom Link types
Sometimes you might have custom DataObject types that you would like CMS users to be able to create Links to. This can be achieved by adding a DataExtension to the Link DataObject, see the below example for making Product objects Linkable.
In your config.yml
Please see the wiki for more customisation examples.
EmbeddedObject/Field
Use the EmbeddedObject/Field to easily add oEmbed content to a DataObject or Page.
Example usage
In your template, you can render the object with the name of the has_one relation
You can also access other metadata on the object via
See EmbeddedObject.php for a list of properties saved available in $db.
Custom query params
Sometimes you may want to add custom query params to the GET request which fetches the LinkEditForm
.
This is very useful in a situation where you want to customise the form based on specific situation.
Custom query params are a way how to provide context for your LinkEditForm
.
To add custom params you need to add data-extra-query
.
You can then use the updateLinkForm
extension point and extract the param value with following code:
Development
Front end uses pre-processing and requires the use of Yarn
.
All versions of silverstripe-linkable with dependencies
silverstripe/framework Version ^4.0
unclecheese/display-logic Version ^2.0