fromholdio/silverstripe-urlsegmenter

Adds an extension to add a URLSegment to any SilverStripe DataObject and manages slug collisions

Installs: 422

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 0

Open Issues: 0

Type:silverstripe-vendormodule

2.0.1 2021-10-13 04:15 UTC

This package is auto-updated.

Last update: 2021-11-13 04:42:08 UTC


README

Adds an extension to add a URLSegment to any SilverStripe DataObject and manages slug collisions.

That is, it does the basic lifting of:

  • Adding a URLSegment field of type DBVarchar to your object
  • Provides an optional update to object's CMS Fields, inserting a URLSegment field (enable this via config yml)
  • Auto-generates URLSegment based on object Title field

Requirements

SilverStripe 4

Installation

composer require fromholdio/silverstripe-urlsegmenter

Usage example

It's all plug-n-play once you apply the extension to your data object - with one exception.

To allow the extension to auto-generate a slug and manage collisions, you need to tell the extension what the scope of the collection you're setting the URLSegment within is.

class Widget extends DataObject
{
    // or apply via config.yml
    private static $extensions = [
        URLSegmenter::class
    ];
    
    private static $db = [
        'Title' => 'Varchar'
    ];

    private static $has_one = [
        'WidgetCategory' => WidgetCategory::class
    ];
    
    public function getURLSegmenterScope()
    {
        return self::get()
            ->filter('WidgetCategoryID' => $this->WidgetCategoryID)
            ->exclude('ID', $this->ID);
    }
}