briceburg/silverstripe-flexilink

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

0.1.0 2015-01-28 04:39 UTC

This package is not auto-updated.

Last update: 2024-03-16 13:48:03 UTC


README

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

Requirements

SilverStripe 3+

Screenshots

flexichoice field

See silverstripe-flexichoice for a similar text input field.

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.

  • FlexiLink provides the following public template methods
<div class="block-heading">
  <h1>$Title</h1>
  $Content
  
  <% if Link.exists %>
    <div class="link">
  
    <% if Link.Type == 'YouTubeID' %>
      <a class="button" href="$Link.URL" target="_blank">WATCH <span>MOVIE</span></a>
    <% else %>
      <a class="button" href="$Link.URL">$LinkText</a>
    <% end_if %>
    
    </div>
  <% end_if %>
  
</div>
  • 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).

Remember, ?flush=all after YML configuration changes to register them in the manifest.