Download the PHP package bitsoftsol/laravel-administration without Composer

Laravel Administration

About Laravel Administration

Laravel Administration is a powerful package designed to simplify the development of Laravel applications by automating common CRUD (Create, Read, Update, Delete) operations. With this package, you can create models effortlessly and enjoy automatic route generation, views, and controller logic.

Features

• Automatic CRUD operations.
• RESTful API generation.
• Easy-to-use schema builder for advanced customization.
• User authentication and role management.
• MIT-licensed open-source software.

Installation Guide

To get started with Laravel Administration, follow these steps:

0. Create a Laravel Project:

   sh composer require bitsoftsol/laravel-administration

1. Add LaravelAdminServiceProvider:

   Open the config/app.php file and add the LaravelAdministration service provider to the providers array:

   sh php artisan vendor:publish

2. Install Frontend Assets:

   Run the following commands to build assets:

   sh php artisan migrate --seed

3. Enable Authentication Routes:

   Add the following line inside your routes/web.php file:

   sh php artisan serve

4. Access Laravel Administration:

   Open your browser and access the URL (host)/admin (e.g., http://127.0.0.1:8000/admin).

5. Login Credentials:

   Use the following credentials to log in:

   • Username: [email protected]
   • Password: bitsoftsol123

6. Create a Superuser:

   To create a superuser for your Laravel application, follow these steps:

   • Open your terminal and navigate to the root directory of your Laravel project.

   • Run the following command:

     bash php artisan make:model Seller -m

7. Define Seller Table Fields:

   Inside the generated migration file, define the Seller table fields, including name, email, city, country, and profile_image.

8. Add LaravelAdmin and LaravelAdminAPI Traits:

   Inside the generated migration file, define the Seller table fields, including name, email, city, country, and profile_image. Enhance the functionality of your Seller model by importing the LaravelAdmin and LaravelAdminAPI traits.

   • Import the LaravelAdmin Trait at the top of the Seller model class:

     php use Bitsoftsol\LaravelAdministration\Traits\LaravelAdminAPI;

   • Add these two lines inside the Seller model class to include the traits:

     php protected $fillable = [ "name", "email", "city", "country", "profile_image" ];

9. Run Migrations:

   Execute the migration to create the sellers table in your database:

   
     php artisan migrate

10. Access the Admin Panel:

    Open your web browser and visit http://127.0.0.1:8000/admin. This is where you can manage your sellers with CRUD operations.

11. Congratulations!

    You are now able to perform CRUD operations on the Seller model without the need for extensive coding.

    This guide empowers you to efficiently manage your sellers in your Laravel application.

Postman Guide

To use CRUD APIs for the Seller model, follow these steps:

1. Import the Postman Collection:

   Import the provided Postman collection to access the CRUD APIs efficiently. You can download it from here: Postman Collection - Laravel Administration.

2. Import the Environment Variables:

   Import the environment variables configuration into Postman for seamless testing. You can download it from here: Postman Environment - Laravel Administration.

3. Set the Host Variable:

   In Postman, configure the host variable to match your application's URL, typically something like http://127.0.0.1:8000.

4. Access the Login API:

   Make a POST request to the following API endpoint to log in:

   • API Endpoint: (host)/api/admin/login
   • Credentials:
     • Username: [email protected]
     • Password: bitsoft123

   After a successful login, you will receive an authentication token.

5. Set the Token Environment Variable:

   Once you receive the authentication token upon login, set it as the (token) environment variable in Postman for subsequent API requests.

6. Fetch the Model ID:

   Retrieve the model_id for the Seller model from the following API endpoint:

   • API Endpoint: {{host}}/api/admin/crud/models

   Set the obtained model_id as the (model_id) environment variable in Postman.

7. Access CRUD APIs for the Seller Model:

   You can now access the CRUD APIs for the Seller model using the environment variables:

   • Listing of Seller API: {{host}}/api/admin/crud/{{model_id}}
   • Detail of Seller API: {{host}}/api/admin/crud/{{model_id}}/2 (where 2 represents the seller's ID)
   • Store Seller API: {{host}}/api/admin/crud/{{model_id}}
   • Update Seller API: {{host}}/api/admin/crud/{{model_id}} (include the seller's ID in the form-data within the body tab of Postman)
   • Delete Seller API: {{host}}/api/admin/crud/{{model_id}}/3 (where 3 represents the seller's ID)

8. Congratulations!

   You can now perform CRUD operations on the Seller model without the need for additional coding. Enjoy the convenience of Laravel Administration for managing your sellers efficiently.

Schema Builder

In the Laravel Administration application, you can effortlessly create the Seller model and its associated migration file using the Schema Builder. Here's how:

1. Access the Schema Builder:

   • Navigate to (host)/admin/crud-schema/create in your web browser, replacing (host) with your application's URL.

2. Enter the Model Name:

   • On the provided page, input 'Seller' as the model name.
3. Submission:
   • Click the 'Submit' button to initiate the generation of the Seller model and its corresponding migration file in your project.

Upon successful creation, you'll be redirected to the Schema Builder list. Here, you can find the 'Seller' model in the list.

Managing Your Schema

• Deleting Schema:

  • To remove the 'Seller' model and its migration file from your project, click the 'Delete' button.

• Defining Schema Fields:

  • By clicking the 'Create Schema' button, you'll access a view where you can define the fields of the 'Seller' migration, including the ability to add more fields. If you wish to include image fields in the migration, ensure you suffix column names with '_image.'
• LaravelAdmin Trait:
  • On the 'Create Schema' view, you can select whether to use the 'LaravelAdmin' Trait by ticking the checkbox. If chosen, the trait will be automatically imported when defining seller field names.

Editing Schema

After creating the schema, you'll find an 'Open Editor' button in the 'Seller' row within the Schema Builder listing. Clicking this button will redirect you to a Visual Code Editor view, allowing you to edit the 'Seller' migration and model files.

• LaravelAdminAPI and LaravelAdmin Traits:

  • In the live editor, you can use the 'LaravelAdminAPI' Trait if required, and include the 'LaravelAdmin' Trait if desired. These traits will enable you to access CRUD routes for the Seller model, both through web and API interfaces.
• Defining Fillable Fields:
  • Set the fields of the 'sellers' table in the fillable array. These fields will be displayed in the Seller listing view.

Migration

After editing the model and migration files, you can click on the 'Migrate' button to apply the changes to your table. Once the seller table is migrated, you will no longer be able to open the editor or perform migrations, but you can still delete.

CRUD Operations

• LaravelAdmin Trait:

  • If you have included the 'LaravelAdmin' Trait in your Seller model, you can access Seller CRUD operations via the 'CRUD' tab on the web interface.
• LaravelAdminAPI Trait:
  • If you have included the 'LaravelAdminAPI' Trait in your Seller model, you can access Seller CRUD operation APIs using the Postman Collection.

Congratulations!, you've now completed the LaravelAdministration documentation. You're all set to make the most of this powerful tool for Laravel development. Happy coding!