Club Drupal

// @todo: flag_reset_flag():

// - it should delete the flaggings.

// - (it has other issues; see http://drupal.org/node/894992.)

// @todo: Discuss: Note that almost all functions/identifiers dealing with

// flaggings *aren't* prefixed by "flag_". For example:

/**

 * Implements hook_entity_query_alter().

  // Alter only flagging queries with bundle conditions.

  if (isset($conditions['entity_type']) && $conditions['entity_type']['value'] == 'flagging' && isset($conditions['bundle'])) {

    // Make value and operator of the bundle condition accessible

    // in hook_query_TAG_alter.

    $query->addMetaData('flag_name_value', $conditions['bundle']['value']);

  );

  $items[FLAG_ADMIN_PATH . '/manage/%flag'] = array(

    'page callback' => 'drupal_get_form',

    'page arguments' => array('flag_form', FLAG_ADMIN_PATH_START + 1),

    'access callback' => 'user_access',

    'title arguments' => array(FLAG_ADMIN_PATH_START + 1),

  );

  $items[FLAG_ADMIN_PATH . '/manage/%flag/edit'] = array(

    'title' => 'Edit flag',

    'type' => MENU_DEFAULT_LOCAL_TASK,

    'weight' => -10,

    'type' => MENU_CALLBACK,

  );

  $items[FLAG_ADMIN_PATH . '/manage/%flag/update'] = array(

    'title' => 'Update',

    'page callback' => 'flag_update_page',

    'page arguments' => array(FLAG_ADMIN_PATH_START + 1),

    case FLAG_ADMIN_PATH:

      $output = '<p>' . t('This page lists all the <em>flags</em> that are currently defined on this system.') . '</p>';

      return $output;

    case FLAG_ADMIN_PATH . '/add':

      $output = '<p>' . t('Select the type of flag to create. An individual flag can only affect one type of object. This cannot be changed once the flag is created.') . '</p>';

      return $output;

    case FLAG_ADMIN_PATH . '/manage/%/fields':

      // Get the existing link types that provide a flagging form.

      $link_types = flag_get_link_types();

function flag_create_handler($entity_type) {

  $definition = flag_fetch_definition($entity_type);

  if (isset($definition) && class_exists($definition['handler'])) {

  }

  else {

  }

  $handler->entity_type = $entity_type;

  $handler->construct();

        $extra[$flag->entity_type][$bundle_name]['form']['flag'] = array(

          'label' => t('Flags'),

          'description' => t('Checkboxes for toggling flags'),

        );

      }

 * Warning: will not work on entity types that are not fieldable, as this relies

 * on a field module hook.

 *

 */

function flag_field_attach_form($entity_type, $entity, &$form, &$form_state, $langcode) {

  list($id) = entity_extract_ids($entity_type, $entity);

/**

 * Implements hook_field_attach_submit().

 *

 */

function flag_field_attach_submit($entity_type, $entity, $form, &$form_state) {

  // This is invoked for each flag_field_attach_form(), but possibly more than

/**

 * Shared saving routine between flag_field_attach_insert/update().

 *

 */

function flag_field_attach_save($entity_type, $entity) {

  list($id) = entity_extract_ids($entity_type, $entity);

      list($entity_id) = entity_extract_ids($entity_type, $entity);

      if (!$flag->access($entity_id) && (!$flag->is_flagged($entity_id) || !$flag->access($entity_id, 'flag'))) {

        continue;

      }

        'title' => $flag->theme($flag->is_flagged($entity_id) ? 'unflag' : 'flag', $entity_id),

        'html' => TRUE,

      );

    // The pseudofield output.

    if ($flag->show_as_field) {

      $entity->content['flag_' . $flag->name] = array(

      );

    }

  }

  $object = $flag->fetch_entity($entity_id);

  // Generic "all flags" actions.

    if ($aid) {

      actions_do($aid, $object, $context);

    }

  $flag =& $variables['flag'];

  $action = $variables['action'];

  $entity_id = $variables['entity_id'];

  $flag_css_name = str_replace('_', '-', $flag->name);

  // Generate the link URL.

      $variables['message_classes_array'][] = 'flag-' . $variables['status'] . '-message';

      $variables['message_text'] = $flag->get_label($inverse_action . '_message', $entity_id);

      $variables['flag_classes_array'][] = $variables['status'];

      $variables['message_classes_array'][] = 'flag-auto-remove';

    }

  }

      ->countQuery()

      ->execute()

      ->fetchField();

  }

  return $counts[$flag->name][$entity_type];

    $query = db_select('flag', 'f');

    $query->leftJoin('flag_types', 'fn', 'fn.fid = f.fid');

    $result = $query

      ->fields('fn', array('type'))

      ->execute();

    foreach ($result as $row) {

        // Ensure overridden flags are associated with their parent module.

        $flags[$name]->module = $default_flag->module;

        if (isset($default_flag->locked)) {

          $flags[$name]->locked = $default_flag->locked;

          foreach ($default_flag->locked as $property) {

  $default_flags = array();

  $flag_status = variable_get('flag_default_flag_status', array());

  foreach (module_implements('flag_default_flags') as $module) {

    $function = $module . '_flag_default_flags';

    foreach ($function() as $flag_name => $flag_info) {

      // Backward compatibility: old exported default flags have their names

        'name' => $flag_name,

        'module' => $module,

      );

    }

  }

 * @return

 *   If returning a single item's flags (that is, when $entity_id isn't NULL),

 *   an array of the structure

 *

 *   If returning all items' flags, an array of arrays for each flag:

 *   [flag_name] => [entity_id] => Object from above.

 */

function flag_get_user_flags($entity_type, $entity_id = NULL, $uid = NULL, $sid = NULL) {

  $flagged_content = &drupal_static(__FUNCTION__);

    $query->orderBy('timestamp', 'ASC');

  }

  else {

  }

  $result = $query->execute();

  $i = 1;

  }

  module_invoke_all('flag_reset', $flag, $entity_id, $rows);

  // Update the flag_counts table.

  $count_query = db_delete('flag_counts')->condition('fid', $flag->fid);

  if ($entity_id) {

 * @ingroup callbacks

 */

function flag_properties_get_user_sid($entity, array $options, $name, $entity_type, $property_info) {

  return $sid;

}