Hello there,

Thank you for reaching out to us.

Unfortunately, no we do not yet have developer documentation just regular documentation and each hook that we have you have there. We can ask our developers for their opinion so that they can point you in the right direction but we would need more details than that. Please elaborate more or send example what you want to achieve exactly and we will forward this to our developers so that they can offer their opinions.

Looking forward to your reply. 

Hello again,

We are not sure if this can be achieved or not we can ask our developers for their opinion and as soon as they send us feedback we will reach out to you again on this ticket. 

Hello again,

We just got the feedback from our colleagues and they have told us that the 'amelia_after_booking_added' hook is fired after the booking is added from the search form. This is the structure of the parameter sent.

To get the same data you will need to put $appointment['appointment']. 

add_action('amelia_after_appointment_added', 'ccccc_amelia_appointments_exec', 10, 1);
add_action('amelia_after_booking_added', 'ccccc_amelia_appointments_exec', 10, 1);
function ccccc_amelia_appointments_exec ($appointmentData) {
if (!empty($appointmentData['appointment'])) {
   $appointment = $appointmentData['appointment'];
} else {
   $appointment = $appointmentData;
}
wp_remote_request( 'https://api.example.com/index.php/appointment/create', array(
    'method'    => 'GET',
    'body'      => array( "start" => $appointment['bookingStart'] ,
  "client_id" => $appointment['bookings'][0]['customer']['id'] ,
  "fname" => $appointment['bookings'][0]['customer']['firstName'] ,
  "sname" => $appointment['bookings'][0]['customer']['lastName'] ,
  "amelialink" => $appointment['id'], 
  "ameliaserviceid" => $appointment['serviceId']),
) );
}

We are working on improving our documentation.

We wish you all the best and hope you have a wonderful day ahead. 

Hello again,

Please try again and let us know how it goes. 

We wish you all the best and hope you have a wonderful day ahead. 

Hello again,

I will forward this to my colleagues again. As soon as they send us feedback we will reach out to you again on this ticket. 

Hello there.

Marko is out of the office, so I'll jump in.

We have tested the webhook using our mailing services with this code example:

add_action('amelia_after_booking_added', 'ccccc_amelia_appointments_exec', 10, 1);
function ccccc_amelia_appointments_exec ($appointmentData) {
    if (!empty($appointmentData['appointment'])) {
       $appointment = $appointmentData['appointment'];
    } else {
       $appointment = $appointmentData;
    }    
    $container = require AMELIA_PATH . '/src/Infrastructure/ContainerConfig/container.php';
    /** @var SMTPService $mailService */
    $mailService = $container->get('infrastructure.mail.service');
        
    $mailService->send(
                       '[email protected]',
                       'serviceId : ' . $appointment['serviceId'],
                       'test email, appointment start date: ' . $appointment['bookingStart'] . '; customer: ' . $appointment['bookings'][0]['customer']['firstName'] . '  '. $appointment['bookings'][0]['customer']['lastName']
                      );     
}

And have received an email when booking from the search form (this hook is tied to all the forms)

You can turn debug on in the wp-config.php file:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

and see if any error logs are made in wp-content/debug.log

Hello again.

It seems the hook does not fire when using WooCommerce, we have tested initially with on-site. We will fix this in the next update. For now you can add

do_action('amelia_after_booking_added', $result ? $result->getData() : null);

in WooCommerceService.php under these lines

$result = $reservationService->processRequest($data, $reservation, true);
if (!$paid && $result->getResult() === CommandResult::RESULT_ERROR) {
    $cartUrl = self::getPageUrl($data);
    $removeAppointmentMessage = FrontendStrings::getCommonStrings()['wc_appointment_is_removed'];
    $errorMessage = self::getBookingErrorMessage($result, $data['type']);
    if ($errorMessage) {
        throw new \Exception($errorMessage . "<a href='{$cartUrl}'>{$removeAppointmentMessage}</a>");
    }
}

For getting an appointment by its id:

/** @var Container $container */
$container = require AMELIA_PATH . '/src/Infrastructure/ContainerConfig/container.php';
/** @var AppointmentRepository $appointmentRepo */
$appointmentRepo = $container->get('domain.booking.appointment.repository');
/** @var Appointment $appointment */
$appointment = $appointmentRepo->getById($appointmentId);
$appointmentArray = $appointment->toArray()

I apologize for that oversight.

It's in \wp-content\plugins\ameliabooking\src\Infrastructure\WP\Integrations\WooCommerce\ folder.

Hello again.

This code:

do_action('amelia_after_booking_added', $result ? $result->getData() : null);

Goes below this:

$result = $reservationService->processRequest($data, $reservation, true);
if (!$paid && $result->getResult() === CommandResult::RESULT_ERROR) {
    $cartUrl = self::getPageUrl($data);
    $removeAppointmentMessage = FrontendStrings::getCommonStrings()['wc_appointment_is_removed'];
    $errorMessage = self::getBookingErrorMessage($result, $data['type']);
    if ($errorMessage) {
        throw new \Exception($errorMessage . "<a href='{$cartUrl}'>{$removeAppointmentMessage}</a>");
    }
}

So around line 2966:

The last piece of code is not our code:

/** @var Container $container */
$container = require AMELIA_PATH . '/src/Infrastructure/ContainerConfig/container.php';
/** @var AppointmentRepository $appointmentRepo */
$appointmentRepo = $container->get('domain.booking.appointment.repository');
/** @var Appointment $appointment */
$appointment = $appointmentRepo->getById($appointmentId);
$appointmentArray = $appointment->toArray()

It was sent because you asked how you can fetch an appointment using the ID.

Hi again.

This error is nothing to worry about, even though it's annoying:

Cannot read properties of null (reading 'replaceChild')

It is something our developers plan to fix, but the point is that it doesn't break anything in the plugin and it continues to work normally even with this error displayed.

The code I sent needs to be added in this file:

\wp-content\plugins\ameliabooking\src\Infrastructure\WP\Integrations\WooCommerce\WooCommerceService.php

So, once you access this file, just search for the first line:

$result = $reservationService->processRequest($data, $reservation, true);

There's only one line like this in this file, and you need to add the code I mentioned below the entire line I sent:

If this is where you added it, it should be OK. Just make sure to purge the cache on your website.

If you believe this addition causes the issue with recurring appointments, try removing it (reverting the file to the original state) and test again (after purging the cache, of course).

If you can't replicate the issue with recurring appointments once the added code is removed, I'll ask our developers to revisit the case.