Drupal
/
drupal
mirror of https://git.drupalcode.org/project/drupal.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Issue #2268467 by fago: Document foreseeable changes to conditions and action APIs.

8.0.x
Alex Pott 2014-10-01 17:50:23 +02:00
parent 2c11d0eaef
commit d805ed7b09
3 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
core/lib/Drupal/Component/Plugin/Context/ContextDefinitionInterface.php
View File

@ -9,6 +9,9 @@ namespace Drupal\Component\Plugin\Context;
/** /**
* Interface for context definitions. * Interface for context definitions.
*
* WARNING: This interface is going to receive some additions as part of
* https://www.drupal.org/node/2346999.
*/ */
interface ContextDefinitionInterface { interface ContextDefinitionInterface {

16
core/lib/Drupal/Core/Action/ActionInterface.php
View File

@ -13,6 +13,22 @@ use Drupal\Core\Executable\ExecutableInterface;
/** /**
* Provides an interface for an Action plugin. * Provides an interface for an Action plugin.
* *
* WARNING: The action API is going to receive some additions before release.
* The following additions are likely to happen:
* - The way configuration is handled and configuration forms are built is
* likely to change in order for the plugin to be of use for Rules.
* - Actions are going to become context-aware in
* https://drupal.org/node/2011038, what will deprecated the 'type'
* annotation.
* - Instead of action implementations saving entities, support for marking
* required context as to be saved by the execution manager will be added as
* part of https://www.drupal.org/node/2347017.
* - Actions will receive a data processing API that allows for token
* replacements to happen outside of the action plugin implementations,
* see https://www.drupal.org/node/2347023.
* - Actions will have to implement access control for checking who is allowed
* to configure or perform the action at https://www.drupal.org/node/2172017.
*
* @see \Drupal\Core\Annotation\Action * @see \Drupal\Core\Annotation\Action
* @see \Drupal\Core\Action\ActionManager * @see \Drupal\Core\Action\ActionManager
* @see \Drupal\Core\Action\ActionBase * @see \Drupal\Core\Action\ActionBase

11
core/lib/Drupal/Core/Condition/ConditionInterface.php
View File

@ -28,6 +28,17 @@ use Drupal\Core\Plugin\PluginFormInterface;
* @todo Replace the dependency on \Drupal\Core\Form\FormInterface with a new * @todo Replace the dependency on \Drupal\Core\Form\FormInterface with a new
* interface from https://drupal.org/node/2006248. * interface from https://drupal.org/node/2006248.
* *
* WARNING: The condition API is going to receive some additions before release.
* The following additions are likely to happen:
* - The way configuration is handled and configuration forms are built is
* likely to change in order for the plugin to be of use for Rules.
* - Condition will receive a data processing API that allows for token
* replacements to happen outside of the plugin implementations,
* see https://www.drupal.org/node/2347023.
* - Conditions will have to implement access control for checking who is
* allowed to configure or perform the action at
* https://www.drupal.org/node/2172017.
*
* @see \Drupal\Core\TypedData\TypedDataManager::create() * @see \Drupal\Core\TypedData\TypedDataManager::create()
* @see \Drupal\Core\Executable\ExecutableInterface * @see \Drupal\Core\Executable\ExecutableInterface
* @see \Drupal\Core\Condition\ConditionManager * @see \Drupal\Core\Condition\ConditionManager