Horgok: foglalások

A foglalások horgaival módosíthatod a foglalás adatait, vagy saját kódot futtathatsz, amikor egy foglalás létrejön, lemondásra kerül, átütemeződik, mentésre kerül, vagy a foglalás utáni műveletek (értesítések, naptáresemények, online megbeszélések) elindulnak. A bővítmény fájljaihoz nem kell nyúlnod. A horgokhoz programozási ismeret kell, a támogatás csak általános tanácsot ad. A szűrők és műveletek közötti különbséget a WordPress-horgok áttekintése írja le.

Foglalás hozzáadása

Ezek a horgok akkor futnak, amikor a vásárló a foglalási űrlapon foglal, vagy amikor csomagból időpontot vesznek fel a háttérfelületen vagy a vásárlói panelen.

Horog	Típus	Mikor fut	Paraméterek
amelia_before_booking_added_filter	szűrő	a foglalás hozzáadása előtt, módosíthatod az adatokat	$appointment
amelia_before_booking_added	művelet	a foglalás hozzáadása előtt	$appointment
amelia_after_booking_added	művelet	a foglalás hozzáadása után	$appointment

function example($appointment)
{
    // az időpont módosítása
    return $appointment;
}

add_filter('amelia_before_booking_added_filter', 'example', 10, 1);

Foglalás lemondása

Akkor futnak, amikor a foglalást a vásárlói panelről vagy e-mailből mondják le.

Horog	Típus	Mikor fut	Paraméterek
amelia_before_booking_canceled	művelet	a lemondás előtt	$booking
amelia_after_booking_canceled	művelet	a lemondás után	$booking

function example($booking)
{
    // saját művelet
}

add_action('amelia_before_booking_canceled', 'example', 10, 1);

Foglalás átütemezése

Akkor futnak, amikor a foglalást a vásárlói panelről vagy a háttérfelület naptárnézetéből ütemezik át.

Horog	Típus	Mikor fut	Paraméterek
amelia_before_booking_rescheduled	művelet	az átütemezés előtt	$oldAppointment, $booking, $bookingStart
amelia_after_booking_rescheduled	művelet	az átütemezés után	$oldAppointment, $booking, $bookingStart

A $booking értéke a vásárlói panelről átütemezve az aktuális felhasználó foglalása az időponton belül. A háttérfelület naptárnézetéből átütemezve null, mert egy időpontban több foglalás is lehet.

function example($oldAppointment, $booking, $bookingStart)
{
    // saját művelet
}

add_action('amelia_after_booking_rescheduled', 'example', 10, 3);

Foglalás utáni műveletek

A foglalás utáni műveletek közé tartozik az értesítések küldése, a naptáresemények létrehozása és az online megbeszélések létrehozása. Ezek elindulása előtt módosíthatod az adatokat, vagy saját kódot futtathatsz.

Horog	Típus	Mikor fut	Paraméterek
amelia_before_post_booking_actions_filter	szűrő	a foglalás utáni műveletek előtt, módosíthatod az adatokat	$resultData
amelia_before_post_booking_actions	művelet	a foglalás utáni műveletek előtt	$resultData

function example($resultData)
{
    // az adatok módosítása
    return $resultData;
}

add_filter('amelia_before_post_booking_actions_filter', 'example', 10, 1);

A webhookoknak küldött adatok módosítása

Ezek a szűrők a foglalás utáni műveletek után, a webhook elküldése előtt futnak, és az elküldött adatot módosíthatják vagy bővíthetik. A szűrőnek mindig vissza kell adnia az adatot.

Típus	Szűrő neve
időpont foglalás lemondva	AmeliaAppointmentBookingCanceledFilter
időpont foglalás hozzáadva	AmeliaAppointmentBookingAddedFilter
időpont foglalás státusza módosítva	AmeliaAppointmentBookingStatusUpdatedFilter
eseményfoglalás lemondva	AmeliaEventBookingCanceledFilter
eseményfoglalás hozzáadva	AmeliaEventBookingAddedFilter
eseményfoglalás státusza módosítva	AmeliaEventBookingStatusUpdatedFilter

function example($data)
{
    return $data;
}

add_filter('AmeliaAppointmentBookingAddedFilter', 'example', 10, 1);

Saját kód futtatása a webhook elküldése előtt

Ezek a műveletek szintén a foglalás utáni műveletek után, a webhook elküldése előtt futnak. Három paramétert kapnak: $reservation, $bookings, $container.

Típus	Művelet neve
időpont foglalás lemondva	AmeliaAppointmentBookingCanceled
időpont foglalás hozzáadva	AmeliaAppointmentBookingAdded
időpont foglalás státusza módosítva	AmeliaAppointmentBookingStatusUpdated
eseményfoglalás lemondva	AmeliaEventBookingCanceled
eseményfoglalás hozzáadva	AmeliaEventBookingAdded
eseményfoglalás státusza módosítva	AmeliaEventBookingStatusUpdated

function example($reservation, $bookings, $container)
{
    // saját művelet
}

add_action('AmeliaAppointmentBookingCanceled', 'example', 10, 3);

A webhook fejléceinek módosítása

Ezekkel a szűrőkkel a webhook fejlécében küldött adatot módosíthatod a küldés előtt. Két paramétert kapnak ($headers, $data), és a $headers értékét kell visszaadniuk.

Típus	Szűrő neve
időpont foglalás lemondva	AmeliaAppointmentBookingCanceledFilterHeader
időpont foglalás hozzáadva	AmeliaAppointmentBookingAddedFilterHeader
időpont foglalás státusza módosítva	AmeliaAppointmentBookingStatusUpdatedFilterHeader
eseményfoglalás lemondva	AmeliaEventBookingCanceledFilterHeader
eseményfoglalás hozzáadva	AmeliaEventBookingAddedFilterHeader
eseményfoglalás státusza módosítva	AmeliaEventBookingStatusUpdatedFilterHeader

function example_callback($headers, $data)
{
    return $headers;
}

add_filter('AmeliaAppointmentBookingAddedFilterHeader', 'example_callback', 10, 2);

Foglalás mentése

Horog	Típus	Mikor fut	Paraméterek
amelia_before_appointment_booking_saved_filter	szűrő	az adatbázisba mentés előtt, módosíthatod a foglalást	$booking, $service, $appointment
amelia_before_appointment_booking_saved	művelet	az adatbázisba mentés előtt	$booking, $service, $appointment
amelia_after_appointment_booking_saved	művelet	az adatbázisba mentés után	$booking, $service, $appointment

function example($booking, $service, $appointment)
{
    // a foglalás módosítása
    return $booking;
}

add_filter('amelia_before_appointment_booking_saved_filter', 'example', 10, 3);