easyappointments/application/libraries/Google_sync.php

<?php defined('BASEPATH') or exit('No direct script access allowed');

/* ----------------------------------------------------------------------------
 * Easy!Appointments - Open Source Web Scheduler
 *
 * @package     EasyAppointments
 * @author      A.Tselegidis <alextselegidis@gmail.com>
 * @copyright   Copyright (c) 2013 - 2020, Alex Tselegidis
 * @license     http://opensource.org/licenses/GPL-3.0 - GPLv3
 * @link        http://easyappointments.org
 * @since       v1.0.0
 * ---------------------------------------------------------------------------- */

// Google API PHP Client is necessary to perform sync operations.
require_once __DIR__ . '/external/google-api-php-client/Google_Client.php';
require_once __DIR__ . '/external/google-api-php-client/contrib/Google_CalendarService.php';

/**
 * Google Synchronization Class
 *
 * This class implements all the core synchronization between the Google Calendar
 * and the Easy!Appointments system. Do not place any model handling inside this
 * library.
 *
 * @package Libraries
 */
class Google_Sync {
    /**
     * CodeIgniter Instance
     *
     * @var CI_Controller
     */
    protected $framework;

    /**
     * Google API Client
     *
     * @var Google_Client
     */
    protected $client;

    /**
     * Google Calendar Service
     *
     * @var Google_CalendarService
     */
    protected $service;

    /**
     * Class Constructor
     *
     * This method initializes the Google client class and the Calendar service
     * class so that they can be used by the other methods.
     */
    public function __construct()
    {
        $this->framework =& get_instance();

        $this->framework->load->library('session');

        // Initialize google client and calendar service.
        $this->client = new Google_Client();
        $this->client->setUseObjects(TRUE);

        $this->client->setApplicationName($this->framework->config->item('google_application_name'));
        $this->client->setClientId($this->framework->config->item('google_client_id'));
        $this->client->setClientSecret($this->framework->config->item('google_client_secret'));
        $this->client->setDeveloperKey($this->framework->config->item('google_api_key'));
        $this->client->setRedirectUri(site_url('google/oauth_callback'));

        $this->service = new Google_CalendarService($this->client);
    }

    /**
     * Get Google OAuth authorization url.
     *
     * This url must be used to redirect the user to the Google user consent page,
     * where the user grants access to his data for the Easy!Appointments app.
     */
    public function get_auth_url()
    {
        // "max_auth_age" is needed because the user needs to always log in
        // and not use an existing session.
        return $this->client->createAuthUrl() . '&max_auth_age=0';
    }

    /**
     * Authenticate the Google API usage.
     *
     * When the user grants consent for his data usage, google is going to redirect
     * the browser back to the given redirect url. There a authentication code is
     * provided. Using this code, we can authenticate the API usage and store the
     * token information to the database.
     *
     * @see Google Controller
     */
    public function authenticate($auth_code)
    {
        $this->client->authenticate($auth_code);
        return $this->client->getAccessToken();
    }

    /**
     * Refresh the Google Client access token.
     *
     * This method must be executed every time we need to make actions on a
     * provider's Google Calendar account. A new token is necessary and the
     * only way to get it is to use the stored refresh token that was provided
     * when the provider granted consent to Easy!Appointments for use his
     * Google Calendar account.
     *
     * @param string $refresh_token The provider's refresh token. This value is
     * stored in the database and used every time we need to make actions to his
     * Google Caledar account.
     */
    public function refresh_token($refresh_token)
    {
        $this->client->refreshToken($refresh_token);
    }

    /**
     * Add an appointment record to its providers Google Calendar account.
     *
     * This method checks whether the appointment's provider has enabled the Google Sync utility of Easy!Appointments
     * and the stored access token is still valid. If yes, the selected appointment record is going to be added to the
     * Google Calendar account.
     *
     * @param array $appointment Contains the appointment record data.
     * @param array $provider Contains the provider record data.
     * @param array $service Contains the service record data.
     * @param array $customer Contains the customer recod data.
     * @param array $settings Contains some company settings that are used by this method.
     *
     * @return Google_Event Returns the Google_Event class object.
     */
    public function add_appointment($appointment, $provider, $service, $customer, $settings)
    {
        $this->framework->load->helper('general');

        $event = new Google_Event();
        $event->setSummary(($service != NULL) ? $service['name'] : 'Unavailable');
        $event->setDescription($appointment['notes']);
        $event->setLocation(isset($appointment['location']) ? $appointment['location'] : $settings['company_name']);

        $start = new Google_EventDateTime();
        $start->setDateTime(date3339(strtotime($appointment['start_datetime'])));
        $event->setStart($start);

        $end = new Google_EventDateTime();
        $end->setDateTime(date3339(strtotime($appointment['end_datetime'])));
        $event->setEnd($end);

        $event->attendees = [];

        $event_provider = new Google_EventAttendee();
        $event_provider->setDisplayName($provider['first_name'] . ' '
            . $provider['last_name']);
        $event_provider->setEmail($provider['email']);
        $event->attendees[] = $event_provider;

        if ($customer != NULL)
        {
            $event_customer = new Google_EventAttendee();
            $event_customer->setDisplayName($customer['first_name'] . ' '
                . $customer['last_name']);
            $event_customer->setEmail($customer['email']);
            $event->attendees[] = $event_customer;
        }

        // Add the new event to the google calendar.
        $created_event = $this->service->events->insert($provider['settings']['google_calendar'], $event);

        return $created_event;
    }

    /**
     * Update an existing appointment that is already synced with Google Calendar.
     *
     * This method updates the google calendar event item that is connected with the
     * provided appointment record of Easy!Appointments.
     *
     * @param array $appointment Contains the appointment record data.
     * @param array $provider Contains the provider record data.
     * @param array $service Contains the service record data.
     * @param array $customer Contains the customer recod data.
     * @parma array $company_settings Contains some company settings that are used by this method.
     *
     * @return Google_Event Returns the Google_Event class object.
     */
    public function update_appointment($appointment, $provider, $service, $customer, $settings)
    {
        $this->framework->load->helper('general');

        $event = $this->service->events->get($provider['settings']['google_calendar'],
            $appointment['id_google_calendar']);

        $event->setSummary($service['name']);
        $event->setDescription($appointment['notes']);
        $event->setLocation(isset($appointment['location']) ? $appointment['location'] : $settings['company_name']);

        $start = new Google_EventDateTime();
        $start->setDateTime(date3339(strtotime($appointment['start_datetime'])));
        $event->setStart($start);

        $end = new Google_EventDateTime();
        $end->setDateTime(date3339(strtotime($appointment['end_datetime'])));
        $event->setEnd($end);

        $event->attendees = [];

        $event_provider = new Google_EventAttendee();
        $event_provider->setDisplayName($provider['first_name'] . ' '
            . $provider['last_name']);
        $event_provider->setEmail($provider['email']);
        $event->attendees[] = $event_provider;

        if ($customer != NULL)
        {
            $event_customer = new Google_EventAttendee();
            $event_customer->setDisplayName($customer['first_name'] . ' '
                . $customer['last_name']);
            $event_customer->setEmail($customer['email']);
            $event->attendees[] = $event_customer;
        }

        $updated_event = $this->service->events->update($provider['settings']['google_calendar'],
            $event->getId(), $event);

        return $updated_event;
    }

    /**
     * Delete an existing appointment from Google Calendar.
     *
     * @param array $provider Contains the provider record data.
     * @param string $google_event_id The Google Calendar event id to
     * be deleted.
     */
    public function delete_appointment($provider, $google_event_id)
    {
        try
        {
            $this->service->events->delete($provider['settings']['google_calendar'], $google_event_id);
        }
        catch (Exception $ex)
        {
            // Event was not found on Google Calendar.
        }
    }

    /**
     * Add unavailable period event to Google Calendar.
     *
     * @param array $provider Contains the provider record data.
     * @param array $unavailable Contains unavailable period's data.
     *
     * @return Google_Event Returns the google event's object.
     */
    public function add_unavailable($provider, $unavailable)
    {
        $this->framework->load->helper('general');

        $event = new Google_Event();
        $event->setSummary('Unavailable');
        $event->setDescription($unavailable['notes']);

        $start = new Google_EventDateTime();
        $start->setDateTime(date3339(strtotime($unavailable['start_datetime'])));
        $event->setStart($start);

        $end = new Google_EventDateTime();
        $end->setDateTime(date3339(strtotime($unavailable['end_datetime'])));
        $event->setEnd($end);

        // Add the new event to the google calendar.
        $created_event = $this->service->events->insert($provider['settings']['google_calendar'], $event);

        return $created_event;

    }

    /**
     * Update Google Calendar unavailable period event.
     *
     * @param array $provider Contains the provider record data.
     * @param array $unavailable Contains the unavailable period data.
     *
     * @return Google_Event Returns the Google_Event object.
     */
    public function update_unavailable($provider, $unavailable)
    {
        $this->framework->load->helper('general');

        $event = $this->service->events->get($provider['settings']['google_calendar'],
            $unavailable['id_google_calendar']);
        $event->setDescription($unavailable['notes']);

        $start = new Google_EventDateTime();
        $start->setDateTime(date3339(strtotime($unavailable['start_datetime'])));
        $event->setStart($start);

        $end = new Google_EventDateTime();
        $end->setDateTime(date3339(strtotime($unavailable['end_datetime'])));
        $event->setEnd($end);

        $updated_event = $this->service->events->update($provider['settings']['google_calendar'],
            $event->getId(), $event);

        return $updated_event;
    }

    /**
     * Delete unavailable period event from Google Calendar.
     *
     * @param array $provider Contains the provider record data.
     * @param string $google_event_id Google Calendar event id to be deleted.
     */
    public function delete_unavailable($provider, $google_event_id)
    {
        try
        {
            $this->service->events->delete($provider['settings']['google_calendar'], $google_event_id);
        }
        catch (Exception $ex)
        {
            // Event was not found on Google Calendar.
        }
    }

    /**
     * Get an event object from gcal
     *
     * @param array $provider Contains the provider record data.
     * @param string $google_event_id Id of the google calendar event.
     *
     * @return Google_Event Returns the google event object.
     */
    public function get_event($provider, $google_event_id)
    {
        return $this->service->events->get($provider['settings']['google_calendar'], $google_event_id);
    }

    /**
     * Get all the events between the sync period.
     *
     * @param string $google_calendar The name of the google calendar to be used.
     * @param string $start The start date of sync period.
     * @param string $end The end date of sync period.
     *
     * @return object Returns an array with Google_Event objects that belong on the given
     * sync period (start, end).
     */
    public function get_sync_events($google_calendar, $start, $end)
    {
        $this->framework->load->helper('general');

        $params = [
            'timeMin' => date3339($start),
            'timeMax' => date3339($end),
            'singleEvents' => TRUE,
        ];

        return $this->service->events->listEvents($google_calendar, $params);
    }

    /**
     * Return available google calendars for specific user.
     *
     * The given user's token must already exist in db in order to get access to his
     * Google Calendar account.
     *
     * @param string $google_token The user's token will be used to grant access to google calendar.
     *
     * @return array Returns an array with the available calendars.
     */
    public function get_google_calendars()
    {
        $calendarList = $this->service->calendarList->listCalendarList();
        $calendars = [];
        foreach ($calendarList->items as $google_calendar)
        {
            if ($google_calendar->getAccessRole() === 'reader')
            {
                continue;
            }

            $calendars[] = [
                'id' => $google_calendar->id,
                'summary' => $google_calendar->summary
            ];
        }
        return $calendars;
    }
}