Airport Guide Documentation

ShuttleController extends BaseController
in package

Shuttle Service Management Controller

This controller handles all operations related to airport shuttle services management. It provides CRUD operations for managing shuttle companies, their contact information, and associated airport data. The controller includes features for listing, creating, editing, viewing, and deleting shuttle service records with proper validation and admin activity logging.

Features:

  • DataTables integration with search and filtering
  • Airport code parsing and validation
  • Security validation with MD5 hash verification
  • Admin activity logging for all operations
  • Pagination and search functionality
  • Modal view for detailed information display
Tags
author

Airport Guide System

version
1.0
since
2024

Table of Contents

Methods

__construct()  : void
Constructor for ShuttleController
create()  : View
Show the form for creating a new shuttle service resource
destroy()  : RedirectResponse
Remove the specified shuttle service resource from storage
edit()  : View|RedirectResponse
Show the form for editing the specified shuttle service resource
index()  : View|DataTable
Display a listing of shuttle service resources
show()  : void
Display the specified shuttle service resource
store()  : RedirectResponse
Store a newly created shuttle service resource in storage
update()  : RedirectResponse
Update the specified shuttle service resource in storage

Methods

__construct()

Constructor for ShuttleController

public __construct() : void

Initializes the controller by checking user authentication and permissions. Redirects to login if user is not authenticated or lacks proper permissions.

create()

Show the form for creating a new shuttle service resource

public create(Request $request) : View

Displays the create form with necessary data for adding a new shuttle service. Prepares dropdown lists for airports, states, and other required fields.

Parameters
$request : Request

The HTTP request object

Tags
example

GET /admin/shuttle/create

Return values
View

Returns the create form view

destroy()

Remove the specified shuttle service resource from storage

public destroy(int $id) : RedirectResponse

Deletes a shuttle service record and creates an admin activity log entry. Performs soft delete if the model supports it, otherwise performs hard delete.

Parameters
$id : int

The ID of the shuttle service record to delete

Tags
example

DELETE /admin/shuttle/123

Return values
RedirectResponse

Redirects to index with success message

edit()

Show the form for editing the specified shuttle service resource

public edit(int $id, Request $request) : View|RedirectResponse

Displays the edit form for an existing shuttle service record with security validation. Includes MD5 hash verification to prevent unauthorized access and maintains pagination state and search filters in the form.

Parameters
$id : int

The ID of the shuttle service record to edit

$request : Request

The HTTP request object containing security key and pagination data

Tags
example

GET /admin/shuttle/123/edit?key=abc123&page_no=2

Return values
View|RedirectResponse

Returns edit form or redirects on security failure

index()

Display a listing of shuttle service resources

public index(Request $request) : View|DataTable

This method handles both AJAX and regular requests for displaying shuttle service data. For AJAX requests, it returns DataTables formatted data with search and filtering capabilities. For regular requests, it returns a view with pagination and search filters.

Features:

  • Pagination support with configurable page size
  • Search filtering by company name, address, phone, airport name, and airport code
  • DataTables integration for enhanced user experience
  • Action buttons for view, edit, and delete operations
  • Case-insensitive search with ILIKE and UPPER functions
Parameters
$request : Request

The HTTP request object containing search parameters and pagination data

Tags
example

// Regular request GET /admin/shuttle

// AJAX request with search filters GET /admin/shuttle?ajax=1&company_name=ABC&airport_code=JFK

Return values
View|DataTable

Returns view for regular requests or DataTable for AJAX

show()

Display the specified shuttle service resource

public show(int $id, Request $request) : void

Shows detailed information about a specific shuttle service record in HTML format. This method is typically called via AJAX to display data in a modal window. Only displays fields that have values (non-empty).

Parameters
$id : int

The ID of the shuttle service record to display

$request : Request

The HTTP request object

Tags
example

GET /admin/shuttle/123

Output:

Airport NameJohn F. Kennedy International Airport
Company NameABC Shuttle Service
Emailinfo@abcshuttle.com
Return values
void

Outputs HTML content directly to the response

store()

Store a newly created shuttle service resource in storage

public store(Request $request) : RedirectResponse

Validates and stores a new shuttle service record with the following features:

  • Validates required fields (airport_name)
  • Parses airport information from formatted string
  • Creates admin activity log entry
  • Handles airport code extraction and airport ID lookup
  • Supports multiple contact methods (phone, email, website)
Parameters
$request : Request

The HTTP request object containing form data

Tags
throws
ValidationException

When validation fails

example

POST /admin/shuttle

Request data: { "airport_name": "John F. Kennedy International Airport (JFK)", "company_name": "ABC Shuttle Service", "company_address": "123 Main St, New York, NY", "company_phone1": "+1-555-123-4567", "company_phone2": "+1-555-123-4568", "company_phone3": "+1-555-123-4569", "email": "info@abcshuttle.com", "company_link": "https://abcshuttle.com", "city": "New York", "state": "NY", "zip_code": "10001", "description": "Reliable airport shuttle service" }

Return values
RedirectResponse

Redirects to index with success message

update()

Update the specified shuttle service resource in storage

public update(Request $request, int $id) : RedirectResponse

Updates an existing shuttle service record with validation and security features:

  • Validates required fields
  • Parses airport information from formatted string
  • Creates admin activity log entry
  • Maintains pagination and search filter state
  • Handles airport code extraction and airport ID lookup
Parameters
$request : Request

The HTTP request object containing form data

$id : int

The ID of the shuttle service record to update

Tags
throws
ValidationException

When validation fails

example

PUT /admin/shuttle/123

Request data: { "airport_name": "John F. Kennedy International Airport (JFK)", "company_name": "Updated ABC Shuttle Service", "company_address": "456 Updated St, New York, NY", "company_phone1": "+1-555-987-6543", "email": "updated@abcshuttle.com", "city": "New York", "state": "NY", "zip_code": "10002" }

Return values
RedirectResponse

Redirects to index with success message and preserved filters


        
On this page

Search results