summaryrefslogtreecommitdiff
path: root/sites/all/modules/ctools/plugins/arguments/user_name.inc
blob: f6f3b4635c5015903f6ab2510e66c8a88ba76208 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<?php

/**
 * @file
 *
 * Plugin to provide an argument handler for a username
 */

/**
 * Plugins are described by creating a $plugin array which will be used
 * by the system that includes this file.
 */
$plugin = array(
  'title' => t("User: name"),
  // keyword to use for %substitution
  'keyword' => 'user',
  'description' => t('Creates a user context from a user name.'),
  'context' => 'ctools_argument_user_name_context',
  'placeholder form' => array(
    '#type' => 'textfield',
    '#description' => t('Enter the username of a user for this argument'),
  ),
);

/**
 * Discover if this argument gives us the user we crave.
 */
function ctools_argument_user_name_context($arg = NULL, $conf = NULL, $empty = FALSE) {
  // If unset it wants a generic, unfilled context.
  if ($empty) {
    return ctools_context_create_empty('user');
  }

  // We can accept either a node object or a pure nid.
  if (is_object($arg)) {
    return ctools_context_create('user', $arg);
  }

  $account = user_load_by_name($arg);
  if (!$account) {
    return NULL;
  }
  return ctools_context_create('user', $account);
}