Ti Ext Reservation Laravel Package

Getting Started

Install via Composer:

composer require vendor/package-name

Publish the package config (if needed):

php artisan vendor:publish --provider="Vendor\PackageName\PackageServiceProvider"

First Use Case: Leverage location-aware filtering for scoped operations. Example:

// Update reservation status for a specific location (new in v4.1.4)
Reservation::updateStatusForLocation($locationId, 'confirmed');

// Sync calendar events with location context
Reservation::syncCalendarEvents($locationId);

Implementation Patterns

Location-Aware Operations

Use the new location-scoped methods to avoid manual filtering:

// Location-specific status updates
Reservation::updateStatusForLocation($locationId, 'cancelled');

// Calendar sync with location context
Reservation::syncCalendarEvents($locationId, [
    'timezone' => Location::find($locationId)->timezone,
    'holidays' => LocationHolidays::get($locationId)
]);

Workflow Integration

1. Frontend: Pass location ID from UI (e.g., property selector).
2. Controller: Use the new methods directly:

   public function updateStatus(Request $request, $locationId)
   {
       Reservation::updateStatusForLocation($locationId, $request->status);
   }
   

3. Service Layer: Encapsulate location-aware logic:

   class ReservationService {
       public function bulkUpdateForLocation($locationId, array $updates)
       {
           Reservation::where('location_id', $locationId)->update($updates);
       }
   }
   

Event Syncing

Extend calendar event syncing with location-specific rules:

// Location-aware sync with custom parameters
event(new SyncCalendarEvents($locationId, [
    'timezone' => Location::find($locationId)->timezone,
    'blackout_dates' => LocationBlackouts::get($locationId)
]));

Gotchas and Tips

Pitfalls

• Missing Location Context: Always validate $locationId before using location-aware methods:

  if (!Location::exists($locationId)) {
      throw new InvalidArgumentException("Location {$locationId} not found.");
  }
  

• Performance: For large locations, use chunking:

  Reservation::where('location_id', $locationId)->chunk(200, function ($reservations) {
      // Process in batches
  });
  

Debugging

• Filtering Issues: Verify the location_id column exists and is indexed:

  php artisan schema:dump
  

• Sync Conflicts: Check for timezone mismatches in location settings.

Extension Points

• Custom Location Rules: Extend the model with location-specific validation:

  public static function boot()
  {
      static::updating(function ($reservation) {
          if ($reservation->isDirty('status') && !$reservation->location_id) {
              throw new \Exception('Location required for status updates.');
          }
      });
  }
  

• Observer Hooks: Add location-aware logic:

  class ReservationObserver {
      public function saved(Reservation $reservation)
      {
          if ($reservation->wasRecentlyCreated && $reservation->location_id) {
              Location::find($reservation->location_id)
                  ->increment('reservation_count');
          }
      }
  }
  

• Dynamic Scoping: Create location-specific query scopes:

  class Reservation extends Model {
      public function scopeForLocation($query, $locationId)
      {
          return $query->where('location_id', $locationId);
      }
  }