You are here

og_member.inc in Organic groups 7.2

Same filename and directory in other branches
  1. 7 plugins/access/og_member.inc

Plugin to provide access control based on user group membership.

File

plugins/access/og_member.inc
View source
<?php

/**
 * @file
 * Plugin to provide access control based on user group membership.
 */

/**
 * Plugins are described by creating a $plugin array which will be used
 * by the system that includes this file.
 */
$plugin = array(
  'title' => t("OG: user membership in group"),
  'description' => t('Control access by group membership.'),
  'callback' => 'og_member_ctools_access_check',
  'default' => array(
    'state' => OG_STATE_ACTIVE,
  ),
  'settings form' => 'og_member_ctools_access_settings',
  'summary' => 'og_member_ctools_access_summary',
  'required context' => array(
    new ctools_context_required(t('User'), 'user'),
    new ctools_context_required(t('Node'), 'node'),
  ),
);

/**
 * Settings form for the 'by perm' access plugin
 */
function og_member_ctools_access_settings($form, &$form_state, $conf) {
  $form['settings']['state'] = array(
    '#type' => 'select',
    '#options' => og_group_content_states(),
    '#title' => t('State in group'),
    '#multiple' => TRUE,
    '#default_value' => $conf['state'],
    '#description' => t('Only users with the specified state in group will be able to access this.'),
    '#required' => TRUE,
  );
  return $form;
}

/**
 * Check for access.
 */
function og_member_ctools_access_check($conf, $context) {

  // As far as I know there should always be a context at this point, but this
  // is safe.
  list($user_context, $node_context) = $context;
  if (empty($user_context) || empty($user_context->data)) {
    return;
  }
  if (empty($node_context) || empty($node_context->data)) {
    return;
  }
  $account = clone $user_context->data;
  $node = $node_context->data;
  return og_is_member('node', $node->nid, 'user', $account, $conf['state']);
}

/**
 * Provide a summary description based upon the checked roles.
 */
function og_member_ctools_access_summary($conf, $context) {
  list($user_context, $node_context) = $context;
  $states = og_group_content_states();
  $state = array();
  foreach ($conf['state'] as $value) {
    $state[] = $states[$value];
  }
  return t('@identifier has "@state in @group group"', array(
    '@identifier' => $user_context->identifier,
    '@state' => implode(',', $state),
    '@group' => $node_context->identifier,
  ));
}

Functions

Namesort descending Description
og_member_ctools_access_check Check for access.
og_member_ctools_access_settings Settings form for the 'by perm' access plugin
og_member_ctools_access_summary Provide a summary description based upon the checked roles.