Download the PHP package ntavelis/auth-email without Composer

On this page you can find all versions of the php package ntavelis/auth-email. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of ntavelis/auth-email

Informations about the package auth-email

Laravel auth-email

Latest Stable Version License

Auth-email provides out of the box email authentication for your Laravel >=5.4 application. It leverages the Laravel's functionality provided by the make:auth command, which runs for you and then proceeds to configure email authentication. Which means that every user that registers to your application, will receive an email with an activate account button. He will have to click the activate account, in order to prove that he is the owner of the email and therefore activate his account.

Installation

Via Composer

Then add the service provider in config/app.php:

Note: Starting with Laravel 5.5 this package gets auto discovered so you can skip this step!

Run your new command:

Finally run your migrations. Now you have email Authentication. Visit /register to register a new user via email.

Note: Make sure you configured your email settings properly.

Options/Parameters

Auth-email provides the following options:

If you have already bootstrapped your application with make:auth before you discovered this package, then you can pass the -o, --only flag, to make auth-email skip running make:auth command.

Auth-email can run your migrations after setup, to keep installation process as minimum as possible. Pass it the -m, --migrate flag.

Note: Make sure you configured your database settings properly before running the command.

Auth-email can make your generated app/mail/ActivateAccount.php implement the ShouldQueue interface. Pass it the -s, --queue flag.

Note: Make sure you configured your queue driver properly.

You can also run the command with any number of flags.

Migrations

After the initial installation, you need to run your migrations, auth-email added 2 migration files on your database/migrations/ path. Which provide 1 new table to store activation tokens and 1 new column in the user table, create_users_table migration is provided by default in laravel, we just add 1 column with the new migration to track the authenticated(Via email) users.

Alternatively as mentioned above pass it the -m flag to instantly run the migrations for you after setup.

Email markup

To change the look of the activation email you send to the user, you have to modify the resources/views/emails/auth.blade.php blade file.

This file uses Laravel's 5.4 new feature markdown mailables, please refer to the Laravel documentation for details. https://laravel.com/docs/5.4/mail#markdown-mailables

The mailable that is responsible for the markup (subject,sender etc) of the activation mail, is located in the app/Mail/ActivateAccount.php.

Flash messages

Auth-email provides 2 flash messages out of the box.

The authEmail.mailSend message informs the user after registration to check their inbox and activate their account.

The authEmail.confirm message informs the user, who just tried to login without being authenticated, that they have to click the activate button on the email we sent them.

If you need to change these messages, you can do so from this file resources/lang/en/authEmail.php.

Queue

The default behavior is not to implement the ShouldQueue interface, for simplicity on setup. But I strongly encourage you to use queues.

If you want your email to implement ShouldQueue interface, therefore to be queueable. You can pass it the -s, --queue flag. Then your generated email in the app/mail/ActivateAccount.php would implement the ShouldQueue interface.

Alternatively you can manually make it implement ShouldQueue interface.

You can read more about queues on Laravel's documentation https://laravel.com/docs/5.4/queues.

Validation

This package adds one more validation rule called alpha_spaces. It considers valid alphanumeric characters and spaces, and is used to validate the name, on the registration form.

You can find the displayed message in, resources/lang/en/validation.php, and if you are interested the validation logic is located in this package's ServiceProvider on the register method.

Generated Files

List of all the generated files from the auth:email command:

File Location Functionality
LoginController.php /app/Http/Controllers/Auth/ Adds authenticated method
RegisterController.php /app/Http/Controllers/Auth/ Adds 4 new methods for email authentication
login.blade.php /resources/views/auth/ Adds flash message logic, to display alerts
auth.blade.php /resources/views/emails/ Activation email, with activation link
Y_m_d_His_create_user_activations_table.php /database/migrations/ Migration that creates table user_activations
Y_m_d_His_add_boolean_column_to_users_table.php /database/migrations/ Adds column activated to users table
authEmail.php /resources/lang/en/ The messages text exists in this file
ActivateAccount.php /app/Mail/ Mailable, sends the activation mail.

Also one more line is appended into your routes file web.php, which creates the activation route of your application. The activation route looks like this /user/activation/{token}.

Requirements

Requires PHP >= 5.6.*

Laravel Framework to be installed, with version >= 5.4

Supported Laravel versions

This package supports all Laravel versions from 5.4 onwards.

Change log

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

Testing

Contributing

Please see CONDUCT for details.

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.

All versions of auth-email with dependencies

PHP Build Version
Package Version
Requires illuminate/contracts Version ~5.4
illuminate/http Version ~5.4
illuminate/support Version ~5.4
illuminate/filesystem Version ~5.4
php Version >=5.6.4
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package ntavelis/auth-email contains the following files

Loading the files please wait ....