watson / nameable
Format names of users into full, familiar and abbreviated forms
Installs: 5 379
Dependents: 0
Suggesters: 0
Security: 0
Stars: 30
Watchers: 2
Forks: 4
Open Issues: 0
Requires
- php: ^8.1
- illuminate/contracts: ^10.0|^11.0
- illuminate/support: ^10.0|^11.0
Requires (Dev)
- laravel/pint: ^1.17
- phpunit/phpunit: ^10.0|^11.0
README
This package provides a caster and a formatter class for presenting your user's names. It can get a user's first, last or full name, their initials, and common abbreviations. Instead of separating the fields over a few database columns you can store a user's name in a single column and fetch what you need.
This package is based upon Basecamp's name_of_person
package for Ruby/Rails.
Installation
You can install the package via Composer:
composer require watson/nameable
Then use the Nameable
cast for any Eloquent models you want to use as a name.
use Watson\Nameable\Nameable; class User extends Model { protected $casts = [ 'name' => Nameable::class, ]; }
Alternatively, you can interact with the Name
class directly.
use Watson\Nameable\Name; $name = new Name('Dwight', 'Conrad Watson'); $name = Name::from('Dwight Conrad Watson');
Usage
$user = new User(['name' => 'Dwight Watson']); $user->name->full // Dwight Watson $user->name->first // Dwight $user->name->last // Watson $user->name->familiar // Dwight W. $user->name->abbreviated // D. Watson $user->name->sorted // Watson, Dwight $user->name->initials // DW
In addition there are possessive variants you can use which will work correctly with names that end in s
.
$user = new User(['name' => 'Dwight Watson']); $user->name->full_possessive // Dwight Watson's $user->name->first_possessive // Dwight's $user->name->last_possessive // Watson's $user->name->abbreviated_possessive // D. Watson's $user->name->sorted_possessive // Watson, Dwight's $user->name->initials_possessive // DW's $user = new User(['name' => 'Angus Young']); $user->name->full_possessive // Angus Young's $user->name->first_possessive // Angus'
If a user doesn't provide a full name (for example, just a first name) the attributes will just omit the last name.
License
The MIT License (MIT). Please see License File for more information.