# 3.1

## Features

* Replaced Sentry with Sentinel
* Uses laravelcollective/html in place of illuminate/html
* Fixed a typo in news\_item page

## Files changed

**Modified**

* app/Http/Controllers/AuthController.php
* app/Http/Controllers/GroupsController.php
* app/Http/Controllers/JoshController.php
* app/Http/Controllers/UsersController.php
* app/Http/routes.php
* app/User.php
* database/seeds/AdminSeeder.php
* resources/lang/en/groups/message.php
* resources/views/admin/groups/edit.blade.php
* resources/views/admin/groups/index.blade.php
* resources/views/admin/layouts/default.blade.php
* resources/views/admin/users/edit.blade.php
* resources/views/admin/users/index.blade.php
* resources/views/news\_item.blade.php

## Update guide

### Replace sentry with sentinel

please have a look at [sentinel documentation](https://cartalyst.com/manual/sentinel/2.0) before we start which covers installation manual aswell.

open composer.json and remove reference to sentry and add sentinel

**remove sentry** 

`"cartalyst/sentry": "dev-feature/laravel-5",`

 **add sentinel** 

`"cartalyst/sentinel": "2.0.*"`

### Replace illuminate/html with laravelcollective/html

Illuminate/html is not being updated so we are switching to laravelcollective/html

 **remove illuminate/html** 

`"illuminate/html": "~5.0"`

 **add laravelcollective/html** 

`"laravelcollective/html": "5.1.*"`

### composer update

To make above changes, in your terminal hit `composer update`

### updating service providers

we need to remove references to old packages and add references to new packages.

open `config/app.php` and in providers `providers` array,

remove

```
'Illuminate\Html\HtmlServiceProvider',

'Cartalyst\Sentry\SentryServiceProvider',
```

add

```
Collective\Html\HtmlServiceProvider::class,
'Cartalyst\Sentinel\Laravel\SentinelServiceProvider',
```

now in aliases array

remove

```
'Form' => 'Illuminate\Html\FormFacade',
'Html' => 'Illuminate\Html\HtmlFacade',
'Sentry' => 'Cartalyst\Sentry\Facades\Laravel\Sentry',
```

add

```
'Form' => Collective\Html\FormFacade::class,
'Html' => Collective\Html\HtmlFacade::class,
'Activation' => 'Cartalyst\Sentinel\Laravel\Facades\Activation',
'Reminder'   => 'Cartalyst\Sentinel\Laravel\Facades\Reminder',
'Sentinel'   => 'Cartalyst\Sentinel\Laravel\Facades\Sentinel',
```

### publish config and configure model

in your command line hit

```
php artisan vendor:publish --provider="Cartalyst\Sentinel\Laravel\SentinelServiceProvider"
```

this will publish sentinel config file `cartalyst.sentinel.php` to config folder

 **setting up config to use our model**

since we have different requirements (extra fields in users table), we need to change sentinel config to use our user Model,

to do that open `config/cartalyst.sentinel.php`

at line 56, find

```
'model' => 'Cartalyst\Sentinel\Users\EloquentUser',
```

replace it with

```
'model' => 'App\User',
```

### Copy migration files and run migrations

In downloaded folder, you will find `Sentry_Sentinel_Migration` folder,

please copy files from that folder to your laravel5.1 installation

since sentry and sentinel contains some common table names... we are doing small magic with these files and finally moving all users from sentry to sentinel

 **run migrations** 

run following in terminal

`php artisan migrate`

 **move users from sentry to sentinel** 

run following in terminal

`php artisan db:seed --class=SentinelUpdateSeeder`

now all users moved to sentinel tables.