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

View File

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

View File

@ -13,6 +13,22 @@ use Drupal\Core\Executable\ExecutableInterface;
/**
* 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\Action\ActionManager
* @see \Drupal\Core\Action\ActionBase

View File

@ -28,6 +28,17 @@ use Drupal\Core\Plugin\PluginFormInterface;
* @todo Replace the dependency on \Drupal\Core\Form\FormInterface with a new
* 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\Executable\ExecutableInterface
* @see \Drupal\Core\Condition\ConditionManager