63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
# Quick start
|
||
|
||
We use `users` table come with `Laravel` for example,the structure of table is:
|
||
```sql
|
||
CREATE TABLE `users` (
|
||
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
|
||
`name` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
|
||
`email` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
|
||
`password` varchar(60) COLLATE utf8_unicode_ci NOT NULL,
|
||
`remember_token` varchar(100) COLLATE utf8_unicode_ci DEFAULT NULL,
|
||
`created_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
|
||
`updated_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
|
||
PRIMARY KEY (`id`),
|
||
UNIQUE KEY `users_email_unique` (`email`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci
|
||
```
|
||
And the model for this table is `App\User.php`
|
||
|
||
You can follow these steps to setup `CRUD` interfaces of table `users`:
|
||
|
||
## Add controller
|
||
|
||
Use the following command to create a controller for `App\User` model
|
||
|
||
```php
|
||
php artisan admin:make UserController --model=App\\User
|
||
|
||
// under windows use:
|
||
php artisan admin:make UserController --model=App\User
|
||
```
|
||
The above command will create the controller in `app/Admin/Controllers/UserController.php`.
|
||
|
||
## Add route
|
||
|
||
Add a route in `app/Admin/routes.php`：
|
||
```
|
||
$router->resource('demo/users', UserController::class);
|
||
```
|
||
|
||
## Add left menu item
|
||
|
||
Open `http://localhost:8000/admin/auth/menu`, add menu link and refresh the page, then you can find a link item in left menu bar.
|
||
|
||
> Where `uri` fills in the path part that does not contain the prefix of the route, such as the full path `http://localhost:8000/admin/demo/users`, just input `demo/users`, If you want to add an external link, just fill in the full url, such as `http://laravel-admin.org/`.
|
||
|
||
### Menu translations
|
||
|
||
append menu titles in menu_titles index at your language files.
|
||
For example 'Work Units' title:
|
||
|
||
in resources/lang/es/admin.php
|
||
```php
|
||
...
|
||
// lowercase and replace spaces with _
|
||
'menu_titles' => [
|
||
'work_units' => 'Unidades de trabajo'
|
||
],
|
||
```
|
||
|
||
## Build grid and form
|
||
|
||
The rest needs to be done is open `app/Admin/Contollers/UserController.php`, find `form()` and `grid()` method and write few lines of code with `model-grid` and `model-form`,for more detail, please read [model-grid](/en/model-grid.md) and [model-form](/en/model-form.md).
|