Field handler to provide a list of roles.
@Plugin(
id = "user_roles",
module = "user"
)
Expanded class hierarchy of Roles
class Roles extends PrerenderList {
/**
* Overrides Drupal\views\Plugin\views\field\FieldPluginBase::init().
*/
public function init(ViewExecutable $view, &$options) {
parent::init($view, $options);
$this->additional_fields['uid'] = array(
'table' => 'users',
'field' => 'uid',
);
}
public function query() {
$this
->add_additional_fields();
$this->field_alias = $this->aliases['uid'];
}
function pre_render(&$values) {
$uids = array();
$this->items = array();
foreach ($values as $result) {
$uids[] = $this
->get_value($result);
}
if ($uids) {
$query = db_select('role', 'r');
$query
->join('users_roles', 'u', 'u.rid = r.rid');
$query
->addField('r', 'name');
$query
->fields('u', array(
'uid',
'rid',
));
$query
->condition('u.uid', $uids);
$query
->orderBy('r.name');
$result = $query
->execute();
foreach ($result as $role) {
$this->items[$role->uid][$role->rid]['role'] = check_plain($role->name);
$this->items[$role->uid][$role->rid]['rid'] = $role->rid;
}
}
}
function render_item($count, $item) {
return $item['role'];
}
function document_self_tokens(&$tokens) {
$tokens['[' . $this->options['id'] . '-role' . ']'] = t('The name of the role.');
$tokens['[' . $this->options['id'] . '-rid' . ']'] = t('The role machine-name of the role.');
}
function add_self_tokens(&$tokens, $item) {
if (!empty($item['role'])) {
$tokens['[' . $this->options['id'] . '-role' . ']'] = $item['role'];
$tokens['[' . $this->options['id'] . '-rid' . ']'] = $item['rid'];
}
}
}
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
Roles:: |
function | |||
PluginBase:: |
protected | function | ||
FieldPluginBase:: |
property | |||
FieldPluginBase:: |
property | |||
FieldPluginBase:: |
function | Add 'additional' fields to the query. | ||
Roles:: |
function |
Add any special tokens this field might use for itself. Overrides FieldPluginBase:: |
||
PluginBase:: |
public | function | Adds elements for available core tokens to a form. | |
HandlerBase:: |
public static | function | Breaks x,y,z and x+y+z into an array. Numeric only. | |
HandlerBase:: |
public static | function | Breaks x,y,z and x+y+z into an array. Works for strings. | |
FieldPluginBase:: |
function | Call out to the theme() function, which probably just calls render() but allows sites to override output fairly easily. | ||
HandlerBase:: |
public | function | Called just prior to query(), this lets a handler set up any relationship it needs. | |
Roles:: |
public | function |
Called to add the field to a query. Overrides FieldPluginBase:: |
|
FieldPluginBase:: |
function | Called to determine what to tell the clicksorter. | 1 | |
HandlerBase:: |
public | function | Check whether current user has access to this handler. | 6 |
FieldPluginBase:: |
function | Checks if a field value is empty. | ||
PluginBase:: |
public | function | Clears a plugin. | 2 |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
HandlerBase:: |
public | function |
Constructs a Handler object. Overrides PluginBase:: |
|
HandlerBase:: |
public | function | Creates cross-database SQL date formatting. | |
HandlerBase:: |
public | function | Creates cross-database SQL dates. | |
PrerenderList:: |
public | function |
Default options form that provides the label widget that all fields
should have. Overrides FieldPluginBase:: |
1 |
HandlerBase:: |
public | function | Define if the exposed input has to be submitted multiple times. This is TRUE when exposed filters grouped are using checkboxes as widgets. | 1 |
PluginBase:: |
protected | property | Denotes whether the plugin has an additional options form. | 8 |
HandlerBase:: |
public | function | Determine if a handler can be exposed. | 2 |
PrerenderList:: |
function |
Determine if advanced rendering is allowed. Overrides FieldPluginBase:: |
||
HandlerBase:: |
public | function | Determine if the handler is considered 'broken', meaning it's a a placeholder used when a handler can't be found. | 6 |
FieldPluginBase:: |
function | Determine if this field is click sortable. | 1 | |
HandlerBase:: |
public | function | Determine if this item is 'exposed', meaning it provides form elements to let users modify the view. | |
FieldPluginBase:: |
function | Determines if this field will be available as an option to group the result by in the style settings. | ||
HandlerBase:: |
public | function | Determines the entity type used by this handler. | |
Roles:: |
function |
Document any special tokens this field might use for itself. Overrides FieldPluginBase:: |
||
HandlerBase:: |
public | function | Ensure the main table for this handler is in the query. This is used a lot. | 8 |
HandlerBase:: |
public static | function | Fetches a handler to join one table to a primary table from the data cache. | |
HandlerBase:: |
public static | function | Figure out what timezone we're in; needed for some date manipulations. | |
HandlerBase:: |
public | function | Form for exposed handler options. | 2 |
HandlerBase:: |
public | function | Get information about the exposed form for the form renderer. | 1 |
FieldPluginBase:: |
function | Get the 'render' tokens to use for advanced rendering. | ||
FieldPluginBase:: |
function | Get the entity matching the current row and relationship. | ||
HandlerBase:: |
public | function | Get the join object that should be used for this handler. | |
FieldPluginBase:: |
function | Get the value that's supposed to be rendered. | 1 | |
FieldPluginBase:: |
public | function | Get this field's label. | |
HandlerBase:: |
public | function | If a handler has 'extra options' it will get a little settings widget and another form called extra_options. | 1 |
HandlerBase:: |
public | function | If set to remember exposed input in the session, store it there. | 1 |
PluginBase:: |
public | function |
Implements Drupal\Component\Plugin\PluginInterface::getDefinition(). Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function |
Implements Drupal\Component\Plugin\PluginInterface::getPluginId(). Overrides PluginInspectionInterface:: |
|
PrerenderList:: |
protected | function |
Information about options for all kinds of purposes will be held here.
@code
'option_name' => array( Overrides FieldPluginBase:: |
1 |
PluginBase:: |
public | property | Options for this plugin will be held here. | |
Roles:: |
public | function |
Overrides Drupal\views\Plugin\views\field\FieldPluginBase::init(). Overrides FieldPluginBase:: |
|
FieldPluginBase:: |
function | Perform an advanced text render for the item. | ||
HandlerBase:: |
public | function | Perform any necessary changes to the form exposes prior to storage. There is no need for this function to actually store the data. | |
HandlerBase:: |
public | function | Perform any necessary changes to the form values prior to storage. There is no need for this function to actually store the data. | 1 |
HandlerBase:: |
public | function | Perform any necessary changes to the form values prior to storage. There is no need for this function to actually store the data. | |
FieldPluginBase:: |
public | function |
Performs some cleanup tasks on the options array before saving it. Overrides HandlerBase:: |
|
PluginBase:: |
public | property | Plugins's definition | |
HandlerBase:: |
public | function | Provide a form for aggregation settings. | 1 |
HandlerBase:: |
public | function | Provide a form for setting options. | 1 |
FieldPluginBase:: |
public | function |
Provide a full list of possible theme templates used by this style. Overrides PluginBase:: |
|
PluginBase:: |
public | function | Provide a list of additional theme functions for the theme information page | |
FieldPluginBase:: |
function | Provide a list of elements valid for field HTML. | ||
HandlerBase:: |
public | function | Provide defaults for the handler. | |
FieldPluginBase:: |
public | function |
Provide extra data to the administration form Overrides HandlerBase:: |
|
HandlerBase:: |
protected | function | Provides a unique placeholders for handlers. | |
HandlerBase:: |
public | function | Provides the handler some groupby. | 2 |
FieldPluginBase:: |
function | Recursive function to add replacements for nested query string parameters. | ||
FieldPluginBase:: |
function | Render a field using advanced settings. | ||
PrerenderList:: |
function | Render all items in this field together. | ||
HandlerBase:: |
public | function | Render our chunk of the exposed handler form when selecting | 1 |
FieldPluginBase:: |
function | Render the field. | 32 | |
FieldPluginBase:: |
function | Render this field as a link, with the info from a fieldset set by the user. | ||
FieldPluginBase:: |
function | Render this field as altered text, from a fieldset set by the user. | ||
FieldPluginBase:: |
function | Replace a value with tokens from the last field. | ||
FieldPluginBase:: |
public | function |
Return a string representing this handler's name in the UI. Overrides HandlerBase:: |
1 |
PrerenderList:: |
function | Return an array of items for the field. | ||
FieldPluginBase:: |
function | Return an HTML element based upon the field's element type. | 1 | |
FieldPluginBase:: |
function | Return an HTML element for the label based upon the field's element type. | ||
FieldPluginBase:: |
function | Return an HTML element for the wrapper based upon the field's element type. | ||
FieldPluginBase:: |
function | Return the class of the field's label. | ||
FieldPluginBase:: |
function | Return the class of the field's wrapper. | ||
FieldPluginBase:: |
function | Return the class of the field. | ||
PluginBase:: |
public | function | Return the human readable name of the display. | |
PluginBase:: |
public | function | Returns a string with any core tokens replaced. | |
PluginBase:: |
public | function | Returns an array of available token replacements. | |
PluginBase:: |
public | function | Returns the summary of the settings in the display. | 6 |
PluginBase:: |
public | function | Returns the usesOptions property. | 8 |
HandlerBase:: |
public | function | Returns TRUE if the exposed filter works like a grouped filter. | 1 |
HandlerBase:: |
public | function | Run after the view is executed, before the result is cached. | |
Roles:: |
function |
Run before any fields are rendered. Overrides FieldPluginBase:: |
||
HandlerBase:: |
public | function | Run before the view is built. | 1 |
HandlerBase:: |
protected | function | Sanitize the value for output. | |
HandlerBase:: |
public | function | Set new exposed option defaults when exposed setting is flipped on. | 2 |
HandlerBase:: |
public | function | Shortcut to display the expose/hide button. | 2 |
HandlerBase:: |
public | function | Shortcut to display the exposed options form. | |
HandlerBase:: |
public | function | Shortcut to get a handler's raw field value. | |
FieldPluginBase:: |
property | Stores additional fields which get's added to the query. The generated aliases are stored in $aliases. | ||
PrerenderList:: |
property | Stores all items which are used to render the items. It should be keyed first by the id of the base table, for example nid. The second key is the id of the thing which is displayed multiple times per row, for example the tid. | ||
HandlerBase:: |
public | function | Submit the exposed handler form | |
HandlerBase:: |
public | function | Take input from exposed handlers and assign to this handler, if necessary. | 1 |
HandlerBase:: |
public | property | The actual field in the database table, maybe different on other kind of query plugins/special handlers. | |
HandlerBase:: |
public | property | The alias of the table of this handler which is used in the query. | |
PluginBase:: |
protected | property | The discovery object. | |
PluginBase:: |
public | property | The display object this plugin is for. | |
FieldPluginBase:: |
public | property | The field value prior to any rewriting. | |
PluginBase:: |
protected | property | The plugin_id. | |
HandlerBase:: |
public | property | The relationship used for this field. | |
HandlerBase:: |
public | property | The table this handler is attached to. | |
PluginBase:: |
public | property | The top object of a view. | 1 |
HandlerBase:: |
protected | function | Transform a string by a certain method. | |
FieldPluginBase:: |
function | Trim the field down to the specified length. | ||
PluginBase:: |
public | function | Unpack options over our existing defaults, drilling down into arrays so that defaults don't get totally blown away. | |
HandlerBase:: |
public | function | Validate the exposed handler form | 4 |
HandlerBase:: |
public | function |
Validate the options form. Overrides PluginBase:: |
4 |
HandlerBase:: |
public | function | Validate the options form. | |
HandlerBase:: |
public | function | Validate the options form. | 1 |
HandlerBase:: |
public | function |
Validates the handler against the complete View. Overrides PluginBase:: |
1 |
HandlerBase:: |
public | property | When a field has been moved this property is set. | |
HandlerBase:: |
public | property | When a table has been moved this property is set. | |
HandlerBase:: |
public | property | Where the $query object will reside: | 1 |
HandlerBase:: |
public | property | With field you can override the realField if the real field is not set. |