Как построить систему бронирования классов с помощью Acuity Scheduling

Теперь все настроено, пришло время интегрироваться с Acuity Scheduling.

Список классов и их доступность

Первое, что нам нужно сделать, это перечислить классы и даты, на которые предлагается каждый класс. Мы уже настроили все это на стороне Acuity вместе с нашими метаданными, поэтому следующим шагом является вызов API для получения доступности. Конечной точкой для этого является availability/classes . SDK позволяет назвать это бризом.

availability/classes дает вам классы на указанный месяц. По умолчанию он включает только те классы с доступными слотами, хотя вы можете изменить это поведение. Мы сделаем это, но отметим те, у которых нет доступных слотов, соответственно.

Создайте новый класс контроллера — app/Http/Controllers/HomeController — и добавьте следующий метод:

 /** * Get the available classes for the given month * * @param Carbon $month * @return array */ public function getAvailablity( $month ) { return app( 'AcuityScheduling' )->request( 'availability/classes', [ 'query' => [ 'month' => $month->format( 'Ym' ), 'includeUnavailable' => 'true', ], ] ); } 

Теперь для домашней страницы. Создайте новый метод index() , и мы начнем с определения доступности на текущий и следующий месяц:

 /** * The homepage * * @return \Illuminate\View\View */ public function index( ) { // Get the dates for this month... $availability = $this->getAvailablity( Carbon::now( ) ); // ...and next month $availability += $this->getAvailablity( Carbon::now( )->addMonth( ) ); } 

Это вернет массив результатов. Прежде, чем мы это представим, давайте использовать силу коллекций Lumen, чтобы сделать две вещи:

1. «Внедрить» экземпляр Carbon, представляющий дату и время каждого класса; это свойство результатов, называемых time
2. Группировать результаты по классу; это представлено свойством assignTypeID

Вот код для этого:

 // Now go through and inject the date as a Carbon instance, then group by the class $instances = collect( $availability )->map( function( $instance ) { $instance[ 'date' ] = Carbon::parse( $instance[ 'time' ] ); return $instance; } )->groupBy( 'appointmentTypeID' ); 

Наконец, верните страницу:

Шаблон макета здесь не включен для краткости, но вы можете взять копию с GitHub.

 // Return the rendered homepage return view( 'home.index', [ 'classes' => $this->classes, 'instances' => $instances ] ); 

Теперь создайте новый файл в resources/views/home/index.blade.php :

 @extends( 'layouts.default' ) @section( 'content' ) <p>We offer three different classes, detailed below.</p> @foreach( $classes as $class ) <h2>{{ $class[ 'name' ] }}</h2> <p>{{ $class[ 'description' ] }}</p> <ul class="instances"> @foreach( $instances->get( $class[ 'acuity_id' ] ) as $instance ) <li> <h5> <time datetime="{{ $instance[ 'date' ]->toIso8601String( ) }}">{{ $instance[ 'date' ]->format( 'l jS F') }} at {{ $instance[ 'date' ]->format( 'ga') }}</time> @if ( $instance[ 'slotsAvailable' ] == 0 ) <span class="badge badge-danger">Fully booked</span> @elseif ( $instance[ 'slotsAvailable' ] < 2 ) <span class="badge badge-warning">Only {{ $instance[ 'slotsAvailable' ] }} available</span> @else <span class="badge badge-success">{{ $instance[ 'slotsAvailable' ] }} slots available</span> @endif </h5> @if ( $instance[ 'slotsAvailable' ] > 0 ) <a href="/{{ $class[ 'key' ] }}/{{ $instance[ 'date' ]->toIso8601String( ) }}/{{ $instance[ 'calendarID' ] }}/book" class="btn btn-primary btn-sm">Book Now</a> @endif </li> @endforeach </ul> @endforeach @stop 

Код должен быть относительно простым. Мы перебираем доступные классы и отображаем информацию о них. Затем мы проходим и перечисляем фактические классы вместе с ярлыком, который предоставляет некоторую информацию о доступности, и, наконец, показываем кнопку для бронирования в классы, которые имеют свободные слоты.

Вы можете взять то, что мы сделали до сих пор — запустить терминал и ввести:

 php -S localhost:8000 -t public/ 

Последний шаг для создания домашней страницы — определить маршрут — откройте routes/web.php . В зависимости от версии Lumen, которую вы установили (я использую 5.4), определения маршрутов могут быть в app/Http/routes.php . Замените маршрут по умолчанию следующим:

 $app->get( '/', 'HomeController@index' ); 

 <?php namespace App\Http\Controllers; use Illuminate\Http\Request; use Carbon\Carbon; class ClassesController extends Controller { /** * The booking page * * @param string $key * @param string$date * @param integer $calendarId * @return \Illuminate\View\View */ public function book( $key, $date, $calendarId ) { $class = collect( $this->classes )->where( 'key', $key )->first( ); return view( 'classes.book', [ 'class' => $class, 'date' => Carbon::parse( $date ), ] ); } } 

 @extends( 'layouts.default' ) @section( 'content' ) <p>You are booking a place on <strong>{{ $class[ 'name' ] }}</strong> on <time datetime="{{ $date->toIso8601String( ) }}">{{ $date->format( 'l jS F') }} at {{ $date->format( 'ga') }}</time></p> <form method="post"> <div class="form-group"> <label>Please enter your forename</label> <input name="firstName" placeholder="Your forename" class="form-control" required> </div> <div class="form-group"> <label>Please enter your surname</label> <input name="lastName" placeholder="Your surname" class="form-control" required> </div> <div class="form-group"> <label>Please enter your e-mail address</label> <input type="email" name="email" placeholder="Your e-mail address" class="form-control" required> </div> <button type="submit" class="btn btn-primary">Book Now</button> </form> @stop 

 /** * POST callback for making the booking * * @param string $key * @param string$date * @param integer $calendarId * @param Request $request * @return \Illuminate\View\View */ public function confirmBooking( $key, $date, $calendarId, Request $request ) { $class = collect( $this->classes )->where( 'key', $key )->first( ); $appointment = app( 'AcuityScheduling' )->request('/appointments', array( 'method' => 'POST', 'data' => array( 'appointmentTypeID' => $class[ 'acuity_id' ], 'calendarId' => $calendarId, 'datetime' => $date, 'firstName' => $request->input( 'firstName' ), 'lastName' => $request->input( 'lastName' ), 'email' => $request->input( 'email' ), ) ) ); // Return the rendered homepage return view( 'classes.booking-confirmation', compact( 'class', 'appointment' ) ); } 

 @extends( 'layouts.default' ) @section( 'content' ) <div class="alert alert-success" role="alert"> <strong>Your booking is confirmed!</strong> Your booking reference is {{ $appointment[ 'id' ] }}. </div> @stop 

 $app->get( '/{key}/{date}/{calendarId}/book', 'ClassesController@book' ); $app->post( '/{key}/{date}/{calendarId}/book', 'ClassesController@confirmBooking' );