madebyprisma/better-link

There is no license information available for the latest version (4.12.1) of this package.

A model & field for linking to pages, or external URLs in SilverStripe.

4.12.1 2023-04-13 20:28 UTC

Requires

• silverstripe/display-logic: ^2.0
• silverstripe/recipe-cms: ~4.12.0@stable
• stevie-mayhew/hasoneedit: ^2.0

Unknown License

• Jesse Solomon

README

About

Adds a new DataObject to allow for more advanced link behaviour

Installation

composer require madebyprisma/better-link

Guide

Basic

<?php

use MadeByPrisma\BetterLink\BetterLink;
use MadeByPrisma\BetterLink\BetterLinkField;

class YourPage extends Page {
	private static $has_one = [
		"YourLink" => BetterLink::class
	];

	private static $owns = [
		"YourLink"
	];

	public function getCMSFields() {
		$fields = parent::getCMSFields();
		
		$fields->addFieldsToTab("Root.Main", [
			new BetterLinkField("YourLink", "Your Link")
		]);

		return $fields;
	}
}

Upgrading

This package was previously adair-creative/better-link and is no longer supported.

This new package is not compatible with the old one, so you will need to update your code, and rebuild the links.

Versions are denoted by the SilverStripe version they are compatible with. (i.e. 4.12.x is compatible with SilverStripe 4.12)

Also The new BetterLink model is versioned, so make sure the parent has an $owns relationship to the BetterLink object.