class AddContentByBundle in Add Content by Bundle Views Area Plugin 1.x
Defines an area plugin to display a bundle-specific node/add link.
Plugin annotation
@ViewsArea("add_content_by_bundle");
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\views\Plugin\views\PluginBase implements DependentPluginInterface, ContainerFactoryPluginInterface, TrustedCallbackInterface, ViewsPluginInterface
- class \Drupal\views\Plugin\views\HandlerBase implements ViewsHandlerInterface
- class \Drupal\views\Plugin\views\area\AreaPluginBase
- class \Drupal\add_content_by_bundle\Plugin\views\area\AddContentByBundle uses RedirectDestinationTrait
- class \Drupal\views\Plugin\views\area\AreaPluginBase
- class \Drupal\views\Plugin\views\HandlerBase implements ViewsHandlerInterface
- class \Drupal\views\Plugin\views\PluginBase implements DependentPluginInterface, ContainerFactoryPluginInterface, TrustedCallbackInterface, ViewsPluginInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of AddContentByBundle
File
- src/
Plugin/ views/ area/ AddContentByBundle.php, line 21
Namespace
Drupal\add_content_by_bundle\Plugin\views\areaView source
class AddContentByBundle extends AreaPluginBase {
use RedirectDestinationTrait;
/**
* The access manager.
*
* @var \Drupal\Core\Access\AccessManagerInterface
*/
protected $accessManager;
/**
* Constructs a new plugin instance.
*
* @param array $configuration
* A configuration array containing information about the plugin instance.
* @param string $plugin_id
* The plugin ID for the plugin instance.
* @param mixed $plugin_definition
* The plugin implementation definition.
* @param \Drupal\Core\Access\AccessManagerInterface $access_manager
* The access manager.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition, AccessManagerInterface $access_manager) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->accessManager = $access_manager;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('access_manager'));
}
/**
* {@inheritdoc}
*/
protected function defineOptions() {
$options = parent::defineOptions();
$options['bundle'] = [
'default' => NULL,
];
$options['label'] = [
'default' => NULL,
];
$options['class'] = [
'default' => NULL,
];
$options['target'] = [
'default' => '',
];
$options['width'] = [
'default' => '600',
];
$options['form_mode'] = [
'default' => NULL,
];
$options['params'] = [
'default' => '',
];
return $options;
}
/**
* {@inheritdoc}
*/
public function buildOptionsForm(&$form, FormStateInterface $form_state) {
parent::buildOptionsForm($form, $form_state);
// Use the entity_type defined for the view.
$entity_type = $this->view
->getBaseEntityType()
->id();
// Get all bundle types for our entity type.
$bundles = \Drupal::service('entity_type.bundle.info')
->getBundleInfo($entity_type);
// Assembled an options list of the bundles.
$bundlesList = [];
foreach ($bundles as $id => $bundle) {
$label = $bundle['label'];
$bundlesList[$id] = $label;
}
// New content bundle type.
// TODO: preselect if a single bundle specified for the view?
$form['bundle'] = [
'#title' => $this
->t('Add content bundle (Content) type'),
'#description' => $this
->t('The bundle (content) type of content to add.'),
'#type' => 'select',
'#options' => $bundlesList,
'#default_value' => !empty($this->options['bundle']) ? $this->options['bundle'] : '',
'#required' => TRUE,
];
// If the Form Mode Control module is installed, expose an option to use it.
if (\Drupal::service('module_handler')
->moduleExists('form_mode_control')) {
$form_modes = \Drupal::service('entity_display.repository')
->getFormModeOptions($entity_type);
// Only expose the form element if our entity type has more than one
// form mode.
if ($form_modes && is_array($form_modes) && count($form_modes) > 1) {
$form['form_mode'] = [
'#title' => $this
->t('Form mode'),
'#description' => $this
->t('The form mode to use for adding an entity.'),
'#type' => 'select',
'#options' => $form_modes,
'#default_value' => !empty($this->options['form_mode']) ? $this->options['form_mode'] : '',
];
}
}
$form['label'] = [
'#title' => $this
->t('Label'),
'#description' => $this
->t('The text of the link.'),
'#type' => 'textfield',
'#default_value' => $this->options['label'] ?: $this
->t('Add a new entry'),
'#required' => TRUE,
];
$form['class'] = [
'#title' => $this
->t('Class'),
'#description' => $this
->t('A CSS class to apply to the link. If using multiple classes, separate them by spaces.'),
'#type' => 'textfield',
'#default_value' => $this->options['class'],
];
$form['target'] = [
'#title' => $this
->t('Target'),
'#description' => $this
->t('Optionally have the form open on-page in a modal or off-canvas dialog.'),
'#type' => 'select',
'#default_value' => $this->options['target'],
'#options' => [
'' => $this
->t('Default'),
'tray' => $this
->t('Off-Screen Tray'),
'modal' => $this
->t('Modal Dialog'),
],
];
$form['width'] = [
'#title' => $this
->t('Dialog Width'),
'#description' => $this
->t('How wide the dialog should appear.'),
'#type' => 'number',
'#min' => '100',
'#default_value' => $this->options['width'],
'#states' => [
// Show this number field only if a dialog is chosen above.
'invisible' => [
':input[name="options[target]"]' => [
'value' => '',
],
],
],
];
$form['params'] = [
'#title' => $this
->t('Additional Parameters'),
'#description' => $this
->t('List any additional paramters, separating the key and value with a pipe (|). The use of tokens for the view\'s arguments is supported. An example is {{ arguments.user_id }}.'),
'#type' => 'textarea',
'#default_value' => $this->options['params'],
];
}
/**
* {@inheritdoc}
*/
public function validate() {
$errors = parent::validate();
// Validate that the specified form mode exists for the specified bundle.
if ($this->options['form_mode']) {
$entity_type = $this->view
->getBaseEntityType()
->id();
$form_modes = \Drupal::service('entity_display.repository')
->getFormModeOptionsByBundle($entity_type, $this->options['bundle']);
if (!isset($form_modes[$this->options['form_mode']])) {
$errors[] = $this
->t('%current_display: The %form_mode form display is not defined for the %bundle type.', [
'%current_display' => $this->displayHandler->display['display_title'],
'%form_mode' => $this->options['form_mode'],
'%bundle' => $this->options['bundle'],
]);
return $errors;
}
}
}
/**
* {@inheritdoc}
*/
public function render($empty = FALSE) {
$account = \Drupal::currentUser();
if ($empty && empty($this->options['bundle'])) {
return [];
}
$bundle_type = $this->options['bundle'];
$entity_type = $this->view
->getBaseEntityType();
// Assemble query params.
$params = $this
->getDestinationArray();
// If set, add form_mode to URL.
if (\Drupal::service('module_handler')
->moduleExists('form_mode_control') && ($form_mode = $this->options['form_mode'])) {
$params['display'] = $form_mode;
}
// If configured to add params, parse into our array.
if ($this->options['params']) {
$this
->extractParams($params, $this->options['params']);
}
// Try to be entity-type agnostic.
if ($entity_type
->id() === 'node') {
// Link to add a node of the specified type, then return to our view.
$url = Url::fromRoute('node.add', [
'node_type' => $bundle_type,
], [
'query' => $params,
]);
$access = $this->accessManager
->checkNamedRoute('node.add', [
'node_type' => $bundle_type,
], $account);
}
elseif ($entity_type
->id() === 'taxonomy_term') {
// Link to add a term of the specified type, then return to our view.
$url = Url::fromRoute('entity.taxonomy_term.add_form', [
'taxonomy_vocabulary' => $bundle_type,
], [
'query' => $params,
]);
$access = $this->accessManager
->checkNamedRoute('entity.taxonomy_term.add_form', [
'taxonomy_vocabulary' => $bundle_type,
], $account);
}
else {
// Try to get the entity creation path.
$entity_links = $entity_type
->get('links');
if (isset($entity_links['add-form'])) {
// Replace the bundle token with the specified value.
$path = preg_replace('/\\{[_a-z]+\\}/', $bundle_type, $entity_links['add-form']);
}
elseif (isset($entity_links['add-page'])) {
$path = str_replace('{' . $entity_type
->id() . '}', $bundle_type, $entity_links['add-page']);
}
if (empty($path)) {
// An entity we don't know how to process, so exit.
// TODO: throw a warning?
return;
}
// Prepend the path to make a valid internal URI.
$path = 'internal:' . $path;
$url = Url::fromUri($path, [
'query' => $params,
]);
// Now use the URL to check access.
$route_name = $url
->getRouteName();
$route_parameters = $url
->getrouteParameters();
$access = $this->accessManager
->checkNamedRoute($route_name, $route_parameters, $account);
}
// Parse and sanitize provided classes.
if ($this->options['class']) {
$classes = explode(' ', $this->options['class']);
foreach ($classes as $index => $class) {
$classes[$index] = Html::getClass($class);
}
}
else {
$classes = [];
}
// Assemble elements into a link render array.
$element = [
'#type' => 'link',
'#title' => $this->options['label'],
'#url' => $url,
'#options' => [
'attributes' => [
'class' => $classes,
],
],
'#access' => $access,
];
// Apply the selected dialog options.
if ($this->options['target']) {
$element['#options']['attributes']['class'][] = 'use-ajax';
$width = $this->options['width'] ?: 600;
$element['#options']['attributes']['data-dialog-options'] = Json::encode([
'width' => $width,
]);
switch ($this->options['target']) {
case 'tray':
$element['#options']['attributes']['data-dialog-renderer'] = 'off_canvas';
$element['#options']['attributes']['data-dialog-type'] = 'dialog';
break;
case 'modal':
$element['#options']['attributes']['data-dialog-type'] = 'modal';
break;
}
}
return $element;
}
/**
* Parse provided text into key-value pairs, checking for tokens.
*
* @param array $params
* The array to which parsed values will be added.
* @param string $input
* The configured input to parse.
*/
protected function extractParams(array &$params, $input) {
$list = explode("\n", $input);
$list = array_map('trim', $list);
$list = array_filter($list, 'strlen');
$display = $this->view
->getDisplay();
// @todo possible to support additional tokens?
$tokens = $display
->getArgumentsTokens();
foreach ($list as $text) {
// Check for an explicit key.
$matches = [];
if (preg_match('/(.*)\\|(.*)/', $text, $matches)) {
// Trim key and value to avoid unwanted spaces issues.
$key = trim($matches[1]);
$value = trim($matches[2]);
}
elseif (strlen($text) <= 255) {
$key = $value = $text;
}
// Check for tokens in the value.
if ($tokens) {
$value = $display
->viewsTokenReplace($value, $tokens);
}
$params[$key] = $value;
}
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AddContentByBundle:: |
protected | property | The access manager. | |
AddContentByBundle:: |
public | function |
Provide a form to edit options for this plugin. Overrides AreaPluginBase:: |
|
AddContentByBundle:: |
public static | function |
Creates an instance of the plugin. Overrides PluginBase:: |
|
AddContentByBundle:: |
protected | function |
Information about options for all kinds of purposes will be held here. Overrides AreaPluginBase:: |
|
AddContentByBundle:: |
protected | function | Parse provided text into key-value pairs, checking for tokens. | |
AddContentByBundle:: |
public | function |
Render the area. Overrides AreaPluginBase:: |
|
AddContentByBundle:: |
public | function |
Validate that the plugin is correct and can be saved. Overrides HandlerBase:: |
|
AddContentByBundle:: |
public | function |
Constructs a new plugin instance. Overrides HandlerBase:: |
|
AreaPluginBase:: |
public | property | The type of this area handler, i.e. 'header', 'footer', or 'empty'. | |
AreaPluginBase:: |
public | function |
Provide text for the administrative summary. Overrides HandlerBase:: |
|
AreaPluginBase:: |
public | function |
Overrides Drupal\views\Plugin\views\HandlerBase::init(). Overrides HandlerBase:: |
1 |
AreaPluginBase:: |
public | function | Does that area have nothing to show. | 1 |
AreaPluginBase:: |
public | function | Performs any operations needed before full rendering. | 1 |
AreaPluginBase:: |
public | function |
Provides the handler some groupby. Overrides HandlerBase:: |
|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
DependencySerializationTrait:: |
public | function | 2 | |
HandlerBase:: |
public | property | With field you can override the realField if the real field is not set. | |
HandlerBase:: |
protected | property | The module handler. | 3 |
HandlerBase:: |
public | property | Where the $query object will reside. | 7 |
HandlerBase:: |
public | property | The actual field in the database table, maybe different on other kind of query plugins/special handlers. | |
HandlerBase:: |
public | property | The relationship used for this field. | |
HandlerBase:: |
public | property | The table this handler is attached to. | |
HandlerBase:: |
public | property | The alias of the table of this handler which is used in the query. | |
HandlerBase:: |
protected | property | The views data service. | |
HandlerBase:: |
public | function | Take input from exposed handlers and assign to this handler, if necessary. | 1 |
HandlerBase:: |
public | function |
Check whether given user has access to this handler. Overrides ViewsHandlerInterface:: |
4 |
HandlerBase:: |
public | function |
Return a string representing this handler's name in the UI. Overrides ViewsHandlerInterface:: |
4 |
HandlerBase:: |
public static | function |
Breaks x,y,z and x+y+z into an array. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function |
Determines if the handler is considered 'broken', meaning it's a
placeholder used when a handler can't be found. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function | Render our chunk of the exposed handler form when selecting. | 1 |
HandlerBase:: |
public | function | Form for exposed handler options. | 2 |
HandlerBase:: |
public | function | Provide a form for setting options. | 1 |
HandlerBase:: |
public | function | Provide a form for aggregation settings. | 1 |
HandlerBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides PluginBase:: |
10 |
HandlerBase:: |
public | function | Determine if a handler can be exposed. | 2 |
HandlerBase:: |
protected | function | Transform a string by a certain method. | |
HandlerBase:: |
public | function | Set new exposed option defaults when exposed setting is flipped on. | 2 |
HandlerBase:: |
public | function | Provide defaults for the handler. | |
HandlerBase:: |
public | function | Displays the Expose form. | |
HandlerBase:: |
public | function |
Ensure the main table for this handler is in the query. This is used
a lot. Overrides ViewsHandlerInterface:: |
2 |
HandlerBase:: |
public | function | Get information about the exposed form for the form renderer. | 1 |
HandlerBase:: |
public | function | Creates cross-database SQL dates. | 2 |
HandlerBase:: |
public | function | Creates cross-database SQL date formatting. | 2 |
HandlerBase:: |
public | function |
Determines the entity type used by this handler. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function |
Shortcut to get a handler's raw field value. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function |
Get the join object that should be used for this handler. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
protected | function | Gets the module handler. | |
HandlerBase:: |
public static | function |
Fetches a handler to join one table to a primary table from the data cache. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
protected | function | Gets views data service. | |
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 | Returns TRUE if the exposed filter works like a grouped filter. | 1 |
HandlerBase:: |
public | function | Determine if this item is 'exposed', meaning it provides form elements to let users modify the view. | |
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 |
HandlerBase:: |
protected | function | Provides a unique placeholders for handlers. | |
HandlerBase:: |
public | function |
Run after the view is executed, before the result is cached. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function |
Run before the view is built. Overrides ViewsHandlerInterface:: |
2 |
HandlerBase:: |
public | function |
Add anything to the query that we might need to. Overrides PluginBase:: |
7 |
HandlerBase:: |
public | function |
Sanitize the value for output. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function | Sets the module handler. | |
HandlerBase:: |
public | function |
Called just prior to query(), this lets a handler set up any relationship
it needs. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function | ||
HandlerBase:: |
public | function | Shortcut to display the expose/hide button. | 2 |
HandlerBase:: |
public | function |
Shortcut to display the exposed options form. Overrides ViewsHandlerInterface:: |
|
HandlerBase:: |
public | function | If set to remember exposed input in the session, store it there. | 1 |
HandlerBase:: |
public | function | Submit the exposed handler form. | |
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. | |
HandlerBase:: |
public | function | Calculates options stored on the handler. | 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. | 1 |
HandlerBase:: |
public | function | A submit handler that is used for storing temporary items when using multi-step changes, such as ajax requests. | |
HandlerBase:: |
public | function | Validate the exposed handler form. | 4 |
HandlerBase:: |
public | function | Validate the options form. | 2 |
HandlerBase:: |
public | function | Validate the options form. | |
MessengerTrait:: |
protected | property | The messenger. | 27 |
MessengerTrait:: |
public | function | Gets the messenger. | 27 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
public | property | Plugins's definition. | |
PluginBase:: |
public | property | The display object this plugin is for. | |
PluginBase:: |
public | property | Options for this plugin will be held here. | |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
protected | property | Stores the render API renderer. | 3 |
PluginBase:: |
protected | property | Denotes whether the plugin has an additional options form. | 8 |
PluginBase:: |
public | property | The top object of a view. | 1 |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Clears a plugin. Overrides ViewsPluginInterface:: |
2 |
PluginBase:: |
protected | function | Do the work to filter out stored options depending on the defined options. | |
PluginBase:: |
public | function |
Filter out stored options depending on the defined options. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public | function |
Returns an array of available token replacements. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
2 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function |
Returns the plugin provider. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
protected | function | Returns the render API renderer. | 1 |
PluginBase:: |
public | function |
Adds elements for available core tokens to a form. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public | function |
Returns a string with any core tokens replaced. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
constant | Include entity row languages when listing languages. | ||
PluginBase:: |
constant | Include negotiated languages when listing languages. | ||
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
PluginBase:: |
protected | function | Makes an array of languages, optionally including special languages. | |
PluginBase:: |
public | function |
Return the human readable name of the display. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public static | function |
Moves form elements into fieldsets for presentation purposes. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public static | function |
Flattens the structure of form elements. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public static | function | Returns substitutions for Views queries for languages. | |
PluginBase:: |
protected | function | Fills up the options of the plugin with defaults. | |
PluginBase:: |
public | function |
Handle any special handling on the validate form. Overrides ViewsPluginInterface:: |
16 |
PluginBase:: |
public | function |
Returns the summary of the settings in the display. Overrides ViewsPluginInterface:: |
6 |
PluginBase:: |
public | function |
Provide a full list of possible theme templates used by this style. Overrides ViewsPluginInterface:: |
1 |
PluginBase:: |
public static | function |
Lists the trusted callbacks provided by the implementing class. Overrides TrustedCallbackInterface:: |
6 |
PluginBase:: |
public | function |
Unpack options over our existing defaults, drilling down into arrays
so that defaults don't get totally blown away. Overrides ViewsPluginInterface:: |
|
PluginBase:: |
public | function |
Returns the usesOptions property. Overrides ViewsPluginInterface:: |
8 |
PluginBase:: |
public | function |
Validate the options form. Overrides ViewsPluginInterface:: |
15 |
PluginBase:: |
protected | function | Replaces Views' tokens in a given string. The resulting string will be sanitized with Xss::filterAdmin. | 1 |
PluginBase:: |
constant | Query string to indicate the site default language. | ||
RedirectDestinationTrait:: |
protected | property | The redirect destination service. | 1 |
RedirectDestinationTrait:: |
protected | function | Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url. | |
RedirectDestinationTrait:: |
protected | function | Returns the redirect destination service. | |
RedirectDestinationTrait:: |
public | function | Sets the redirect destination service. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 4 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. | |
TrustedCallbackInterface:: |
constant | Untrusted callbacks throw exceptions. | ||
TrustedCallbackInterface:: |
constant | Untrusted callbacks trigger silenced E_USER_DEPRECATION errors. | ||
TrustedCallbackInterface:: |
constant | Untrusted callbacks trigger E_USER_WARNING errors. |