An open API service indexing awesome lists of open source software.

https://github.com/tomhatzer/nova-slug-field

Slug field for Laravel Nova
https://github.com/tomhatzer/nova-slug-field

laravel laravel-nova nova slug

Last synced: 5 months ago
JSON representation

Slug field for Laravel Nova

Awesome Lists containing this project

README

          

# Laravel Nova Slug Field

Simple Laravel Nova Slug field. Generating a slugified version of a text
input. See the result of the slug while typing.

### Edit form

![details page select](https://raw.githubusercontent.com/benjaminhirsch/benjaminhirsch.github.io/master/repository-assets/nova-slug-demo.gif)

## Installation

In order to use this package, you need a Laravel installation which uses [Nova](https://nova.laravel.com).

**Composer**

```bash
composer require benjaminhirsch/nova-slug-field
```

## Usage
Define the following fields in your resource in the ```fields``` method:
```
use Benjaminhirsch\NovaSlugField\Slug;
use Benjaminhirsch\NovaSlugField\TextWithSlug;

...

TextWithSlug::make('Name')
->slug('slug'),

Slug::make('Slug'),
```

##### Slug with a preview of the generated URL
This will display the full URL including the generated slug as a link below the input field.
```
use Benjaminhirsch\NovaSlugField\Slug;
use Benjaminhirsch\NovaSlugField\TextWithSlug;

...

TextWithSlug::make('Name')
->slug('slug'),

Slug::make('Slug')
->showUrlPreview('http://www.foo.bar'),
```

##### Slug with disabled auto update
This is especially usefull, when you are updating the field which the slug belongs to and don't wan't the slug to be updated automatically.
```
use Benjaminhirsch\NovaSlugField\Slug;
use Benjaminhirsch\NovaSlugField\TextWithSlug;

...

TextWithSlug::make('Name')
->slug('slug'),

Slug::make('Slug')
->disableAutoUpdateWhenUpdating(),
```

This first field definition is the field which you want to create the slug of. The second field
definition represents the slugified version. With the ```->slug('name')``` method, you define
the name of the field which holds the slug. It is possible to create multiple slugs on a single
resource, just add more field definitions. Every ```TextWithSlug``` field needs a corresponding
```Slug``` field.