briceburg/silverstripe-flexilink

Link to SiteTree Pages, External URLs, YouTube Videos, &c. from a single, flexible SilverStripe field.

silverstripe-flexilink

Link to SiteTree Pages, External URLs, YouTube Videos, &c. from a single, flexible SilverStripe field., _(*1)

Requirements

SilverStripe 3+, _(*2)

Screenshots

, _(*3)

See silverstripe-flexichoice for a similar text input field., _(*4)

Usage

• Add FlexiLink field types to your DataObject(s)

class BlockContentHeading extends DataObject {
  private static $db = array(
    'Title'     => 'Varchar',
    'Content'   => 'Text',
    'Link'      => 'FlexiLink',   // <--- here
    'LinkText'  => 'FlexiChoice', 
  );

Trigger the environment builder (/dev/build) after extending objects -- You will now see the FlexiLinkField appear in the CMS when editing your object., _(*5)

• FlexiLink provides the following public template methods
  • Type : The type of link (e.g. 'ExternalURL','Page','YouTubeID')
  • Value : The raw value of the link
  • URL : The link transformed into a URL (E.g. Page->Link(), 'http://www.google.com/', '//www.youtube.com/embed/[Value]')

  
$Title
  $Content
  
  
    

  
    
      WATCH MOVIE
    
      $LinkText
    
    
    
  
  

• You may define link selection types and their related fields in YAML Configuration. Here's an example /mysite/config/_config.yml

---
Name: mysite
After:
  - 'framework/*'
  - 'cms/*'
---
# YAML configuration for SilverStripe
# See http://doc.silverstripe.org/framework/en/topics/configuration
# Caution: Indentation through two spaces, not tabs
SSViewer:
  theme: 'site'

FlexiLinkField:
  allowed_types:
    - Page
    - Google

  field_types:
    Google:
      field: TextField
      description: TestTest

This example adds a custom 'Google' field type, and limits the dropdown selection to 'Page' and 'Google' (hides the built-in YouTubeID and ExternalURL)., _(*6)

Remember, ?flush=all after YML configuration changes to register them in the manifest., _(*7)