Giter VIP home page Giter VIP logo

nova-sluggable's Introduction

Slug field for Laravel Nova

Latest Version on Packagist

Slug field for Laravel Nova that can generate unique slug for your model while typing.

nova-sluggable demo

Installation

You can install the package in to a Laravel app that uses Nova via composer:

composer require drobee/nova-sluggable

Usage

Add a new SluggableText and a Slug field to your Nova Resource:

use Drobee\NovaSluggable\SluggableText;
use Drobee\NovaSluggable\Slug;

class User extends Resource
{
    // ...

    public function fields(Request $request)
    {
        return [
            // ...

            SluggableText::make('Title'),
            Slug::make('Slug'),

            // ...
        ];
    }
}

When the user types a string in the SluggableText field the value is being sent the API to generate the slug and and then it sets the Slug field's value to the that. The slug is updated on every key up event, but it can be tied to blur event on the title field.

By default it looks for a Slug type field with the name Slug.

In order to work properly every defined SluggableText field need a corresponding Slug field.

Options

Slug field with custom name

Set the Slug fields name on the SluggableText field with the slug() method:

SluggableText::make('Title')->slug('SEO Title');
Slug::make('SEO Title', 'slug');

Language

Set the language to use for the generation with the Slug field's slugLanguage() method:

Slug::make('Slug')->slugLanguage('hu');

Default value: en

Maximum length

Limit the maximum length of the generated slug with the Slug field's slugMaxLength() method:

Slug::make('Slug')->slugMaxLength(100);

Default value: 255

Maximum length

Set the string all the whitespaces will be replaced with with the Slug field's slugSeparator() method:

Slug::make('Slug')->slugSeparator('.');

Default value: -

Note: the generated slug may be few characters longer than the value specified, due to the suffix which is added to make it unique.

Update event

By default the slug updates on every keyup event, but you can tie it to the blur event:

Slug::make('Slug')->event('blur');

Accepted values: keyup, blur

Default value: keyup

Unique slug and Eloquent model

The generated slugs won't be unique unless you call the slugUnique() method on your Slug field.

You also need to specify what Eloquent model should the generator use to make the slug unique by calling the slugModel() method. In most cases you would want to use the same Eloquent model as your resource. To do so call the method with the resource's static $model attribute.

Slug::make('Slug')
    ->slugUnique()
    ->slugModel(static::$model);

When these to options are set the generated slug will be unique on the set model regarding the attribute value of the Slug field.

Usage with Spatie\Sluggable

If the Eloquent model you specified with slugModel() uses Spatie\Sluggable's HasSlug trait and implements its getSlugOptions() method, then you don't have to set the separator, maximum length or language for the field. In such cases the generator uses the values you already set on your model.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

Acknowledgments

Special thanks to:

nova-sluggable's People

Contributors

drobee avatar cookieseater avatar kukac7 avatar alexhiggins avatar bashgeek avatar u12206050 avatar jonrobinson avatar kduma avatar guillaumesozen avatar wize-wiz avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.