rslanzi/nova-translatable

A Laravel Nova field for astrotomic/laravel-translatable.

0.2.3 2021-03-31 22:55 UTC

Requires

• php: >=7.3.0
• astrotomic/laravel-translatable: ^11.5
• laravel/nova: ^2.9 || ^3.0
• waynestate/nova-ckeditor4-field: ^0.6.0

MIT

• Riccardo Slanzi

• translatable
• CKEditor
• nova
• laravel

README

Laravel Nova Translatable

This Laravel Nova field allows you to manage translated fields with astrotomic/laravel-translatable.

Requirements

laravel/nova: ^2.9 || ^3.0
astrotomic/laravel-translatable: ^11.0
waynestate/nova-ckeditor4-field: ^0.6.0

Features

• Supports almost all Nova fields
• Supports default validation automatically
• Simple to implement with minimal code changes (after astrotomic/laravel-translatable support)
• Locale tabs to switch between different locale values of the same field

Supported fields

• Code
• Counted text (with max char and warning treshold)
• CKEditor
• Json
• Sluggable
• Text (also single line)
• Textarea
• Trix

Installation

Firstly, set up astrotomic/laravel-translatable.

Install the package in a Laravel Nova project via Composer:

# Install nova-translatable
composer require rslanzi/nova-translatable

# Publish configuration (optional, but useful for setting default locales)
php artisan vendor:publish --tag="nova-translatable-config"

Usage

Text Field

Single line text field

NovaTranslatable::make('Title')
    ->singleLine()

Textarea Field:

Multi line text field

NovaTranslatable::make('Text')
    ->hideFromIndex()

Counted Text Field:

Text field with chars counter

NovaTranslatable::make('Title')
    ->singleLine()
    ->counted()

Counted with max chars threshold.

Exceeded the threshold, the counter turns red.

NovaTranslatable::make('Title')
    ->singleLine()
    ->counted()
    ->maxChars(60)
    ->warningAt(50),

Counted with max chars and warning thresholds.

Exceeded the warning threshold, the counter turns orange, exceeded the max chars threshold, the counter turns red.

NovaTranslatable::make('Title')
    ->singleLine()
    ->counted()
    ->maxChars(60)
    ->warningAt(50),

CKEditor Field

CKEditor WYSIWYG editor. Usefull to manage HTML fields.

NovaTranslatable::make('Text')
    ->ckeditor()

Trix Field

Trix field

NovaTranslatable::make('Text')
    ->trix()

Sluggable Field

Automatically populate a slug field based on another field. Title in this case.

NovaTranslatable::make('Title')
    ->sluggable('Slug'),
NovaTranslatableSlug::make('Slug')
    ->hideFromIndex(),

Code Field

Code field. Use a syntax highlighted text area.

NovaTranslatable::make('Text')
    ->code()

Code Field with custom language

Code field. Use a syntax highlighted text area.

NovaTranslatable::make('Text')
    ->code()
    ->language('php')

The Code field's currently supported languages are: dockerfile, javascript, markdown, nginx, php, ruby, sass, shell, vue, xml, yaml

Json Field

NovaTranslatable::make('Text')
    ->json()

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Support the development

Do you like this project? Support it by donating

• PayPal: Donate

Security Vulnerabilities

If you discover a security vulnerability within Nova Translatable, please send an e-mail to Riccardo Slanzi at [e-mail]. All security vulnerabilities will be promptly addressed.

License

Nova Translatable is free software distributed under the terme of the MIT license.