aleph1.co.uk Git - yaffs-website/blob - web/core/lib/Drupal/Core/Config/Entity/ThirdPartySettingsInterface.php

   1 <?php
   2
   3 namespace Drupal\Core\Config\Entity;
   4
   5 /**
   6  * Interface for configuration entities to store third party information.
   7  *
   8  * A third party is a module that needs to store tightly coupled information to
   9  * the configuration entity. For example, a module alters the node type form
  10  * can use this to store its configuration so that it will be deployed with the
  11  * node type.
  12  */
  13 interface ThirdPartySettingsInterface {
  14
  15   /**
  16    * Sets the value of a third-party setting.
  17    *
  18    * @param string $module
  19    *   The module providing the third-party setting.
  20    * @param string $key
  21    *   The setting name.
  22    * @param mixed $value
  23    *   The setting value.
  24    *
  25    * @return $this
  26    */
  27   public function setThirdPartySetting($module, $key, $value);
  28
  29   /**
  30    * Gets the value of a third-party setting.
  31    *
  32    * @param string $module
  33    *   The module providing the third-party setting.
  34    * @param string $key
  35    *   The setting name.
  36    * @param mixed $default
  37    *   The default value
  38    *
  39    * @return mixed
  40    *   The value.
  41    */
  42   public function getThirdPartySetting($module, $key, $default = NULL);
  43
  44
  45   /**
  46    * Gets all third-party settings of a given module.
  47    *
  48    * @param string $module
  49    *   The module providing the third-party settings.
  50    *
  51    * @return array
  52    *   An array of key-value pairs.
  53    */
  54   public function getThirdPartySettings($module);
  55
  56   /**
  57    * Unsets a third-party setting.
  58    *
  59    * @param string $module
  60    *   The module providing the third-party setting.
  61    * @param string $key
  62    *   The setting name.
  63    *
  64    * @return mixed
  65    *   The value.
  66    */
  67   public function unsetThirdPartySetting($module, $key);
  68
  69   /**
  70    * Gets the list of third parties that store information.
  71    *
  72    * @return array
  73    *   The list of third parties.
  74    */
  75   public function getThirdPartyProviders();
  76
  77 }