Download the PHP package taylornetwork/username-suggester without Composer
On this page you can find all versions of the php package taylornetwork/username-suggester. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download taylornetwork/username-suggester
More information about taylornetwork/username-suggester
Files in taylornetwork/username-suggester
Package username-suggester
Short Description A package to suggest usernames based on taylornetwork/laravel-username-generator
License MIT
Informations about the package username-suggester
Username Suggester
A package to suggest usernames from taylornetwork/laravel-username-generator
This would be useful if you want to show your users a list of suggested usernames based on their entry if their selection is unavailable.
Install
Via composer
Publish Config
This will publish to config/username_suggester.php
Set Up
You will need to follow the quickstart guide for taylornetwork/laravel-username-generator.
At minimum your User
model needs to use the TaylorNetwork\UsernameGenerator\FindSimilarUsernames
(see set up)
Defaults
The suggester will generate 3
unique usernames based on the given name. It will use the increment
driver which will use the
TaylorNetwork\UsernameGenerator\Generator
class to convert the name to a username and then add incrementing numbers on the end to make them unique.
If no name is entered it will generate random usernames, same as TaylorNetwork\UsernameGenerator\Generator
Usage
Available Methods
suggest
The suggest()
method accepts an optional parameter of the name to suggest usernames for.
setDriver
This will allow you to set a different driver than the default.
This method returns an instance of the Suggester
class, so you're able to chain methods.
setAmount
This will allow you to set a different amount of suggestions than the default.
This method returns an instance of the Suggester
class, so you're able to chain methods.
setGeneratorConfig
This will allow you to override the TaylorNetwork\UsernameGenerator\Generator
config.
Same as setAmount
and setDriver
this method also returns the Suggester
instance.
Example
Basic with Random Usernames
Basic with Entered Name
Different Driver and Amount
This will use the Random
driver to append random numbers after the username and generate 5 usernames.
Using the Facade
A UsernameSuggester
facade is included so all the methods can be accessed that way.
Custom Drivers
You can create any custom drivers by extending the TaylorNetwork\UsernameSuggester\Drivers\BaseDriver
class.
The only requirement is that you implement the makeUnique
method to make the username unique in some way.
You'll also need to register the driver in app/username_suggester.php
You can access it using the key you set.
All versions of username-suggester with dependencies
illuminate/support Version >=8.0
taylornetwork/laravel-username-generator Version ^2.6