fbs.module

<?php

/**
 * @file
 * FBS provider module.
 */

use FBS\Model\PatronV3;
use FBS\Model\PatronSettingsV3;
use FBS\Model\Period;
use FBS\Model\Periodical;
use FBS\Model\PeriodicalReservation;
use FBS\Model\UpdatePatronRequestV3;

include_once 'fbs.features.inc';

// Load Field module hooks. Wrapping in function exists, so we'll still be
// able to load this file in tests.
if (function_exists('module_load_include')) {
  module_load_include('inc', 'fbs', 'fbs.field');
}

/**
 * Implements hook_xautoload().
 */
function fbs_xautoload($adapter) {
  $adapter->absolute()->addPsr4('FBS\\', drupal_get_path('module', 'fbs') . '/src');
  $adapter->absolute()->addPsr4('Reload\\Prancer\\', drupal_get_path('module', 'fbs') . '/prancer');
}

/**
 * Implements hook_libraries_info().
 *
 * For defining external libraries.
 */
function fbs_libraries_info() {
  return array(
    'jsonmapper' => array(
      'name' => 'JsonMapper',
      'vendor url' => 'https://github.com/cweiske/jsonmapper',
      'download url' => 'https://github.com/cweiske/jsonmapper',
      'version' => 'v0.4.4',
      'xautoload' => function ($adapter) {
        $adapter->addClassMap(
        // Would like to:
        // $adapter->composerJson('composer.json');
        // But xautoload can't figure it out.
          array(
            'JsonMapper' => 'src/JsonMapper.php',
            'JsonMapper_Exception' => 'src/JsonMapper/Exception.php',
          )
        );

      },
    ),
    'http-message' => array(
      'name' => 'Common interface for HTTP messages',
      'vendor url' => 'https://github.com/php-fig/http-message',
      'download url' => 'https://github.com/php-fig/http-message',
      'version' => '1.0',
      'xautoload' => function ($adapter) {
        $adapter->composerJson('composer.json');
      },
    ),
    'phly-http' => array(
      'name' => 'PSR-7 message implementation',
      'vendor url' => 'https://github.com/phly/http',
      'download url' => 'https://github.com/phly/http',
      'version' => '0.11.1',
      'xautoload' => function ($adapter) {
        $adapter->composerJson('composer.json');
      },
    ),
  );
}

/**
 * Implements hook_ding_provider().
 */
function fbs_ding_provider() {
  $path = drupal_get_path('module', 'fbs');
  return array(
    'title' => 'FBS provider',
    'settings' => 'fbs_settings_form',
    'provides' => array(
      'availability' => array(
        'prefix' => 'availability',
        'file' => $path . '/includes/fbs.availability.inc',
      ),
      'debt' => array(
        'prefix' => 'debt',
        'file' => $path . '/includes/fbs.debt.inc',
      ),
      'loan' => array(
        'prefix' => 'loan',
        'file' => $path . '/includes/fbs.loan.inc',
      ),
      'reservation' => array(
        'prefix' => 'reservation',
        'file' => $path . '/includes/fbs.reservation.inc',
      ),
      'user' => array(
        'prefix' => 'user',
        'file' => $path . '/includes/fbs.user.inc',
      ),
      'wayf' => array(
        'prefix' => 'wayf',
        'file' => $path . '/includes/fbs.wayf.inc',
      ),
      'user_consent' => array(
        'prefix' => 'user_consent',
        'file' => $path . '/includes/fbs.user_consent.inc',
      ),
    ),
  );
}

/**
 * Get info for patron.
 *
 * Wrapper around ding_user_get_creds() to facilitate testing.
 *
 * @param object|null $account
 *   User to get patron info about. Uses current user if not supplied.
 *
 * @return array
 *   Patron info.
 */
function fbs_get_patron_info($account = NULL) {
  global $user;

  if (!$account) {
    $account = $user;
  }

  // If set on user, use those. This should only be the case in tests.
  if (isset($account->creds)) {
    return $account->creds;
  }

  $creds = ding_user_get_creds($user);
  return $creds;
}

/**
 * Return patron id for user.
 *
 * @param object|null $account
 *   User to get patron id for. Optional, defaults to current user.
 *
 * @return string|null
 *   Patron id or NULL if not found.
 */
function fbs_patron_id($account = NULL) {
  $patron_info = fbs_get_patron_info($account);
  return isset($patron_info['patronId']) ? $patron_info['patronId'] : NULL;
}

/**
 * Get the service object.
 *
 * Parameters is for injecting in tests. Don't use.
 *
 * @param string|null $agency_id
 *   Local agency id. Defaults to fbs_agency variable.
 * @param string|null $endpoint
 *   Url of service endpoint. Defalts to fbs_endpoint variable.
 * @param Reload\Prancer\HttpClient|null $client
 *   HTTP client to use. Defaults to new instance of FBSFakeHttpClient if
 *   endpoint matches "localtest".
 * @param Reload\Prancer\Serializer|null $serializer
 *   Serializer to use.
 * @param bool $reset
 *   Don't use cache but return a new instance.
 *
 * @return FBS
 *   Service class.
 */
function fbs_service($agency_id = NULL, $endpoint = NULL, $client = NULL, $serializer = NULL, $reset = FALSE) {
  // No drupal_static. We want to be callable from tests.
  static $service;
  if (!$service || $reset) {
    // Check that libraries are properly loaded. Just throwing an exception is a
    // bit harsh, but we're in a hurry here.
    foreach (array('jsonmapper', 'http-message', 'phly-http') as $lib) {
      // Checking for FALSE, as it's actually a count of how many files was
      // included, and none is included for our libraries.
      if (!($library = libraries_load($lib)) || $library['loaded'] === FALSE) {
        throw new Exception($lib . ' library not installed');
      }
    }

    $agency_id = !empty($agency_id) ? $agency_id : variable_get('fbs_agency', '');
    $endpoint = !empty($endpoint) ? $endpoint : variable_get('fbs_endpoint', '');

    if ($endpoint && preg_match('{localtest}', $endpoint)) {
      $client = new FBSFakeHttpClient();
    }

    // Ensure exactly one trailing slash.
    $endpoint = rtrim($endpoint, '/') . '/';
    try {
      $service = new FBS($agency_id, $endpoint, $client, $serializer);
    }
    catch (FBSException $e) {
      watchdog_exception('fbs', $e);

      return FALSE;
    }
  }

  return $service;
}

/**
 * Provider settings form.
 */
function fbs_settings_form() {
  $form = array();

  $form['fbs'] = array(
    '#type' => 'fieldset',
    '#title' => t('FBS service settings'),
    '#tree' => FALSE,
  );

  $form['fbs']['fbs_endpoint'] = array(
    '#type' => 'textfield',
    '#title' => t('FBS endpoint URL'),
    '#description' => t('The URL for the FBS REST service, usually something like https://et.cicero-fbs.com/rest'),
    '#required' => TRUE,
    '#default_value' => variable_get('fbs_endpoint', ''),
  );

  $form['fbs']['fbs_agency'] = array(
    '#type' => 'textfield',
    '#title' => t('ISIL'),
    '#description' => t('ISIL code of the library, for example DK-810015.'),
    '#required' => TRUE,
    '#default_value' => variable_get('fbs_agency', ''),
  );

  $form['fbs']['fbs_username'] = array(
    '#type' => 'textfield',
    '#title' => t('Username'),
    '#description' => t('Username for FBS.'),
    '#default_value' => variable_get('fbs_username', ''),
  );

  $form['fbs']['fbs_password'] = array(
    '#type' => 'textfield',
    '#title' => t('Password'),
    '#description' => t('Password for FBS.'),
    '#default_value' => variable_get('fbs_password', ''),
  );

  // Add the option to select default interest period, which default as default
  // to 180 days.
  $periods = fbs_interest_periods();
  $default = variable_get('fbs_default_interest_period', 180);
  $form['fbs'] += ding_reservation_interest_period_selector('fbs_default_interest_period', $default, $periods);

  $form['fbs']['fbs_enable_reservation_deletion'] = array(
    '#type' => 'checkbox',
    '#title' => t('Enable reservation deletion'),
    '#default_value' => variable_get('fbs_enable_reservation_deletion', FALSE),
    '#description' => t('Allow users to delete their reservations as well as ready for pickup ones.'),
  );

  $form['fbs']['fbs_allow_profile_edit'] = array(
    '#type' => 'checkbox',
    '#title' => t('Enable profile edit'),
    '#description' => t('Allow users to edit their own Email, Branch and Phone fields.'),
    '#default_value' => variable_get('fbs_allow_profile_edit', FALSE),
  );

  $form['fbs']['fbs_sort_departments'] = array(
    '#type' => 'select',
    '#title' => t('Sort departments alphabetically'),
    '#description' => t('Allow to sort the information on departments of the library in alphabetical order. Default is "Ascending".'),
    '#options' => array(
      SORT_ASC => t('Ascending'),
      SORT_DESC => t('Descending'),
    ),
    '#default_value' => variable_get('fbs_sort_departments', SORT_ASC),
  );

  // Branches and blacklisted branches.
  $form['branches'] = array(
    '#type' => 'fieldset',
    '#title' => t('Search Branches Blacklist'),
    '#description' => t('Choose which branches to blacklist from searches'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
  );

  $form['branches']['fbs_branches_blacklist'] = array(
    '#type' => 'checkboxes',
    '#title' => t('Branches blacklist'),
    '#options' => fbs_branches(),
    '#default_value' => variable_get('fbs_branches_blacklist', array()),
  );

  $form['user_branches'] = array(
    '#type' => 'fieldset',
    '#title' => t('User Branches Blacklist'),
    '#description' => t('Choose which branches to blacklist from user profile.'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
  );

  $form['user_branches']['fbs_user_branches_blacklist'] = array(
    '#type' => 'checkboxes',
    '#title' => t('User branch blacklist'),
    '#options' => fbs_branches(),
    '#default_value' => variable_get('fbs_user_branches_blacklist', array()),
  );

  $form['holding_branches'] = array(
    '#type' => 'fieldset',
    '#title' => t('Holdings Branches Blacklist'),
    '#description' => t('Choose which branches to blacklist from availability lists.'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
  );

  $form['holding_branches']['fbs_holdings_branches_blacklist'] = array(
    '#type' => 'checkboxes',
    '#title' => t('Holdings branch blacklist'),
    '#options' => fbs_branches(),
    '#default_value' => variable_get('fbs_holdings_branches_blacklist', array()),
  );

  return system_settings_form($form);
}

/**
 * Submit function. Trim values.
 */
function fbs_settings_form_submit($form, &$form_state) {
  foreach ($form_state['values'] as $name => $value) {
    $form_state['values'][$name] = trim($value);
  }
  system_settings_form_submit($form, $form_state);
}

/**
 * Implements hook_profile2_presave().
 */
function fbs_profile2_presave($entity) {
  global $user;
  if ($entity->type != 'provider_fbs') {
    return;
  }
  if (isset($entity->is_new) && $entity->is_new) {
    // Profile is being created, return.
    return;
  }

  if ($entity->uid != $user->uid) {
    // Profile is not the current user's. We can't get the existing values, so
    // we wont try to update.
    return;
  }
  $patron = ding_user_get_creds($user);
  $wrapper = entity_metadata_wrapper('profile2', $entity);

  $current_on_hold = array();
  $current_on_hold = $wrapper->field_fbs_on_hold->value();
  if (!$current_on_hold) {
    $current_on_hold = array('from' => '', 'to' => '');
  }

  $current = array(
    'phoneNumber' => $wrapper->field_fbs_phone->value(),
    'emailAddress' => $wrapper->field_fbs_mail->value(),
    'receiveSms' => (bool) $wrapper->field_fbs_phone_notification->value(),
    'receiveEmail' => (bool) $wrapper->field_fbs_mail_notification->value(),
    'preferredPickupBranch' => $wrapper->field_fbs_preferred_branch->value(),
    'preferredLanguage' => $wrapper->field_fbs_preferred_language->value(),
  );

  if ($patron['on_hold']) {
    $existing_on_hold = $patron['on_hold'];
  }
  else {
    $existing_on_hold = array('from' => '', 'to' => '');
  }
  $existing = array(
    'phoneNumber' => $patron['phone'],
    'emailAddress' => $patron['mail'],
    'receiveSms' => (bool) $patron['phone_notification'],
    'receiveEmail' => (bool) $patron['mail_notification'],
    'preferredPickupBranch' => $patron['preferred_branch'],
    'onHold' => $patron['on_hold'],
    'preferredLanguage' => $patron['preferred_language'],
  );

  if (array_diff_assoc($current, $existing) || array_diff_assoc($current_on_hold, $existing_on_hold)) {
    $period = new Period();
    $period->from = $current_on_hold['from'];
    $period->to = $current_on_hold['to'];

    $update = new UpdatePatronRequestV3();
    $patron_settings = new PatronSettingsV3();
    foreach ($current as $key => $val) {
      $patron_settings->{$key} = $val;
    }
    $patron_settings->onHold = $period;
    $update->patron = $patron_settings;

    $res = NULL;
    try {
      $res = fbs_service()->Patron->update(fbs_service()->agencyId, $patron['patronId'], $update);
    }
    catch (Exception $e) {
      watchdog_exception('fbs', $e);
    }

    $result = array();
    if ($res) {
      $result['creds'] = _fbs_patron_info($res->patron);
    }

    ding_user_save_creds($result);
  }
}

/**
 * Update preferred branch if it is not set.
 *
 * @param object $account
 *   User to update preferred branch on.
 * @param string $branch_id
 *   Branch id to update to.
 */
function fbs_update_preferred_branch($account, $branch_id) {
  global $user;

  // Only update when it's for the current user.
  if ($account->uid != $user->uid) {
    return;
  }

  $profile = ding_user_provider_profile($account);
  $wrapper = entity_metadata_wrapper('profile2', $profile);

  if (!$wrapper->field_fbs_preferred_branch->value()) {
    $wrapper->field_fbs_preferred_branch->set($branch_id);
    $current_on_hold = $wrapper->field_fbs_on_hold->value();
    if (!empty($current_on_hold['from'])) {
      $wrapper->field_fbs_on_hold->set(array(
        'from' => date('Y-m-d', $current_on_hold['from']),
        'to' => date('Y-m-d', $current_on_hold['to']),
      ));
    }

    $profile->save();
  }
}

/**
 * Get library branches.
 *
 * @return array
 *   Array of ISIL => branchname.
 */
function fbs_branches() {
  $branches = &drupal_static(__FUNCTION__, NULL);
  if (is_null($branches)) {

    $res = array();
    try {
      $res = fbs_service()->Placement->getBranches(fbs_service()->agencyId);
    }
    catch (Exception $e) {
      watchdog_exception('fbs', $e);
    }

    $branches = array();
    foreach ($res as $branch) {
      $branches[$branch->branchId] = $branch->title;
    }

    asort($branches);
  }

  return $branches;
}

/**
 * Get user select-able branches.
 */
function fbs_user_branches($account) {
  $branches = fbs_branches();
  $blacklist = array_filter(variable_get('fbs_user_branches_blacklist', array()));

  if (ding_user_is_provider_user($account)) {
    $patron_info = fbs_get_patron_info($account);

    $preferred_branch = $patron_info['preferred_branch'];

    // If users preferred branch is blacklisted, remove it from the blacklist to
    // allow the user to keep their old preference.
    if ($preferred_branch && isset($blacklist[$preferred_branch])) {
      unset($blacklist[$preferred_branch]);
    }
  }

  return array_diff_key($branches, $blacklist);
}

/**
 * Get FBS languages.
 *
 * @return array
 *   Array of languages.
 */
function fbs_languages() {
  $languages = &drupal_static(__FUNCTION__, NULL);
  if (is_null($languages)) {
    $service = fbs_service();

    if ($service) {
      $res = array();
      $languages = array();
      try {
        $res = $service->Patron->getLanguages($service->agencyId);
      }
      catch (Exception $e) {
        watchdog_exception('fbs', $e);
      }

      $lang_list = language_list();

      include_once DRUPAL_ROOT . '/includes/iso.inc';
      $predefined = _locale_get_predefined_list();

      foreach ($res as $language) {
        if (isset($lang_list[$language->language])) {
          $languages[$language->language] = $lang_list[$language->language]->native;
        }
        else {
          $languages[$language->language] = $predefined[$language->language][0];
        }
      }
    }
  }

  return $languages;
}

/**
 * Get interest periods.
 *
 * @return array
 *   Array of days => human readable string.
 */
function fbs_interest_periods() {
  $periods = array(
    1 => 30,
    2 => 60,
    3 => 90,
    6 => 180,
    12 => 360,
  );
  $options = array();
  foreach ($periods as $months => $days) {
    $options[$days] = format_plural($months, '1 month', '@count months');
  }
  return $options;
}

/**
 * Implements hook_form_FORM_ID_form_alter().
 *
 * Remove order_nr from the reservation listing. We don't have anything sane to
 * display there.
 */
function fbs_form_ding_reservation_reservations_form_alter(&$form, &$form_state) {
  if (isset($form['reservations'])) {
    foreach ($form['reservations'] as &$reservation) {
      if (isset($reservation['#information']['order_nr'])) {
        unset($reservation['#information']['order_nr']);
      }
    }
  }
}

/**
 * Implements hook_form_FORM_ID_alter().
 *
 * Access options for the attributes in the holdings field.
 */
function fbs_form_ding_availability_admin_holdings_settings_alter(&$form, &$form_state, $form_id) {
  $form['holdings'] = array(
    '#type' => 'fieldset',
    '#title' => t('Holdings levels display'),
    '#description' => t('Configure holdings display modes.'),
  );
  $form['holdings']['fbs_show_material_group'] = array(
    '#type' => 'checkbox',
    '#title' => t('Show material group description'),
    '#default_value' => variable_get('fbs_show_material_group', 0),
  );
  $form['holdings']['fbs_holdings_suffix_type'] = array(
    '#type' => 'radios',
    '#title' => t('Holdings suffix'),
    '#description' => t('Select which type of suffix to use for holdings. Simple shows a mix between DK5 and inverted creator, while Shelf mark simulates the shelf mark from ALMA using marc-data from the well.'),
    '#default_value' => variable_get('fbs_holdings_suffix_type', 'shelf_mark'),
    '#options' => array(
      'simple' => t('Simple'),
      'shelf_mark' => t('Shelf mark'),
    ),
  );
}

/**
 * Pack patron info in an array.
 *
 * Saves all the data we'll need for profile editing into an array that can be
 * serialized in ding_user creds.
 *
 * @param FBS\Model\PatronV3 $patron
 *   Patron data to save.
 *
 * @return array
 *   Data to save.
 */
function _fbs_patron_info(PatronV3 $patron) {
  $creds = array(
    'patronId' => $patron->patronId,
    'name' => $patron->name,
    'phone' => $patron->phoneNumber,
    'mail' => $patron->emailAddress,
    'phone_notification' => $patron->receiveSms,
    'mail_notification' => $patron->receiveEmail,
    'preferred_branch' => $patron->preferredPickupBranch,
    'preferred_language' => $patron->preferredLanguage,
    'on_hold' => NULL,
    'address' => NULL,
  );

  if ($patron->onHold) {
    $creds['on_hold'] = array(
      'from' => $patron->onHold->from,
      'to' => $patron->onHold->to,
    );
  }

  if ($patron->address) {
    $creds['address'] = array(
      'street' => $patron->address->street,
      'city' => $patron->address->city,
      'postal' => $patron->address->postalCode,
      'country' => $patron->address->country,
    );
  }

  return $creds;
}

/**
 * Return a reversible local_id for a periodical.
 *
 * Ding wants an unique id for a periodical. We don't have that, so we pack the
 * record id and periodical information together in a pseudo id.
 *
 * @param string $record_id
 *   Id of the ting object.
 * @param FBS\Model\Periodical $periodical
 *   The Periodical instance.
 *
 * @return string
 *   The pseudo id.
 */
function _fbs_periodical_get_local_id($record_id, Periodical $periodical) {
  // We're using - as a placeholder for empty values, it ensures that there'll
  // be something between the colons, which in turn means we don't have to
  // deal with the possibility of two colons in a row.
  $parts = array(
    !empty($periodical->volume) ? $periodical->volume : '-',
    !empty($periodical->volumeYear) ? $periodical->volumeYear : '-',
    !empty($periodical->volumeNumber) ? $periodical->volumeNumber : '-',
    $record_id,
  );

  $parts = array_map(function ($part) {
    // "Escape" the colons, so we can split on ":" later.
    return strtr($part, array(':' => '::'));
  }, $parts);

  return 'fbs-' . implode(':', $parts);
}

/**
 * Parse local_id into record and periodical.
 *
 * Parse the pseudo id created by _fbs_periodical_get_local_id() into a record
 * id and periodical.
 *
 * @param string $local_id
 *   The pseudo id.
 *
 * @return array
 *   Array of record_id and PeriodicalReservation.
 */
function _fbs_periodical_parse_local_id($local_id) {
  $periodical = NULL;

  if (preg_match('/^fbs-(.*)$/', $local_id, $matches)) {
    // This is a zero-width negative lookbehind assertion ("(?<!:)") and a
    // zero-width negative lookahead assertion ("(?!:)") that checks that the
    // colon in the middle doesn't have a colon in front or behind it. The
    // "zero-width" means that the preceding/following char is not part of the
    // matched string. That's why "[^:]:[^:]" wont do, it'll match the
    // non-colon char, which means preg_split will shave chars off the strings
    // we want.
    $parts = preg_split('/(?<!:):(?!:)/', $matches[1]);

    // Replace '-' with NULL and reverse the "escaping" of colon.
    $parts = array_map(function ($part) {
      return $part === '-' ? NULL : strtr($part, array('::' => ':'));
    }, $parts);
  }

  $periodical = new PeriodicalReservation();
  [
    $periodical->volume,
    $periodical->volumeYear,
    $periodical->volumeNumber,
    $record_id
  ] = $parts;

  return array($record_id, $periodical);
}

/**
 * Static cache for WAYF logins.
 *
 * Not pretty, but due to the way that ding_wayf is implemented, this is what we
 * need.
 */
function _fbs_wayf_login($name, $value = NULL) {
  $logins = &drupal_static(__FUNCTION__, array());
  if ($value) {
    $logins['name'] = $value;
  }

  if (isset($logins['name'])) {
    return $logins['name'];
  }

  return NULL;
}

/**
 * Implements hook_user_account_update().
 *
 * This is needed for the ding_user_user_presave().
 * This function needs to be empty because all the update functionality is
 * implemented by the fbs_user_update_pincode().
 */
function fbs_user_account_update($account, $changes) {
}

/**
 * Initializing provider user profile.
 *
 * Clearing cache_field on provider user initialisation, in order to fill
 * profile with data.
 */
function fbs_user_profile_init() {
  cache_clear_all('*', 'cache_field', TRUE);
}

/**
 * Quote string for use in CQL.
 *
 * Adds " around the string and escapes inline ".
 */

function _fbs_cql_quote_string($name) {
  return '"' . preg_replace('/"/', '\\"', $name) . '"';
}

/**
 * Implements hook_form_FORM_ID_alter().
 *
 * Hide unnecessary fields.
 */
function fbs_form_profile2_edit_provider_fbs_form_alter(&$form, &$form_state, $form_id) {
  $allow_profile_edit = variable_get('fbs_allow_profile_edit', FALSE);
  $form['profile_provider_fbs']['field_fbs_mail']['#disabled'] = !$allow_profile_edit;
  $form['profile_provider_fbs']['field_fbs_mail_notification']['#disabled'] = !$allow_profile_edit;
  $form['profile_provider_fbs']['field_fbs_preferred_branch']['#disabled'] = !$allow_profile_edit;
  $form['profile_provider_fbs']['field_fbs_phone']['#disabled'] = !$allow_profile_edit;
  $form['profile_provider_fbs']['field_fbs_phone_notification']['#disabled'] = !$allow_profile_edit;

  // Disable "SMS Fee" notice.
  unset($form["ding_user_fee_sms"]);
}

/**
 * Implements hook_preprocess().
 */
function fbs_preprocess_panels_pane(&$variables) {
  if ($variables['pane']->type == 'user_profile') {
    $variables["content"]["profile_provider_fbs"]["#title"] = t('User profile');
    unset($variables["content"]["profile_provider_fbs"]["#prefix"]);
  }

  if ($variables['pane']->type == 'profile2_form' && $variables['pane']->subtype == 'profile2_form') {
    $variables['title'] = t('Edit user profile');
  }
}

/**
 * Replace entity for the reservation in the case object in not in Ting anymore.
 *
 * @param \DingEntityBase $ding_entity
 *   The lms item.
 *
 * @return \TingEntity
 *   Pseudo-object.
 */
function fbs_replace_entity(DingEntityBase $ding_entity) {
  // Just prepare an empty object.
  $pseudo_ting_object = ting_object_load('');

  $pseudo_ting_object->setTitle(!empty($ding_entity->title) ? $ding_entity->title : $ding_entity->display_name);
  $pseudo_ting_object->setDingEntityId($ding_entity->ding_entity_id);
  $pseudo_ting_object->setType($ding_entity->getType());
  $pseudo_ting_object->setCreators([$ding_entity->getCreator()]);
  $pseudo_ting_object->ding_entity_type = 'ding_entity';

  return $pseudo_ting_object;
}