You are here

bakery.api.php in Bakery Single Sign-On System 7.2

Same filename and directory in other branches
  1. 6.2 bakery.api.php
  2. 7.4 bakery.api.php

This file contains no working PHP code; it exists to provide additional documentation for doxygen as well as to document hooks in the standard Drupal manner.

File

bakery.api.php
View source
<?php

/**
 * @file
 * This file contains no working PHP code; it exists to provide additional
 * documentation for doxygen as well as to document hooks in the standard
 * Drupal manner.
 */

/**
 * @defgroup bakery Bakery module integrations.
 *
 * Module integrations with the Bakery SSO.
 */

/**
 * Bakery data transmit hook invoked before data is sent to another site.
 *
 * Invoked on master during user_save before syncing to subsites. Also invoked
 * on subsite when requesting account data from master for account creation.
 *
 * @param array $edit
 *   The array of form values submitted by the user from hook_user_presave().
 * @param object $account
 *   User account object.
 * @param string $category
 *   The active category of user information being edited.
 *
 * @return array
 *   Keyed array of data to pass along to other sites.
 */
function hook_bakery_transmit($edit, $account, $category) {
  return array(
    'example_field' => 'example_value',
  );
}

/**
 * Bakery data receive hook invoked on response from data sync from master.
 *
 * Invoked on subsites after requesting account data from master for account
 * creation. Also invoked on subsites during account data sync from master.
 *
 * Note, callers are responsible for data validation.
 *
 * @param object $account
 *   User account object.
 * @param array $cookie
 *   Data sent from the master. Custom data sent by master's
 *   hook_bakery_transmit() will be available as top-level elements.
 */
function hook_bakery_receive($account, $cookie) {
  if (!empty($cookie['example_field'])) {
    db_update('example_table')
      ->fields(array(
      'example_field' => $cookie['example_field'],
    ))
      ->execute();
  }
}

Functions

Namesort descending Description
hook_bakery_receive Bakery data receive hook invoked on response from data sync from master.
hook_bakery_transmit Bakery data transmit hook invoked before data is sent to another site.