Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Core\ImageToolkit;
Chris@0: 
Chris@0: use Drupal\Core\Cache\CacheBackendInterface;
Chris@0: use Drupal\Core\Config\ConfigFactoryInterface;
Chris@0: use Drupal\Core\Extension\ModuleHandlerInterface;
Chris@0: use Drupal\Core\Plugin\DefaultPluginManager;
Chris@0: 
Chris@0: /**
Chris@0:  * Manages image toolkit plugins.
Chris@0:  *
Chris@0:  * @see \Drupal\Core\ImageToolkit\Annotation\ImageToolkit
Chris@0:  * @see \Drupal\Core\ImageToolkit\ImageToolkitInterface
Chris@0:  * @see \Drupal\Core\ImageToolkit\ImageToolkitBase
Chris@0:  * @see plugin_api
Chris@0:  */
Chris@0: class ImageToolkitManager extends DefaultPluginManager {
Chris@0: 
Chris@0:   /**
Chris@0:    * The config factory.
Chris@0:    *
Chris@0:    * @var \Drupal\Core\Config\ConfigFactoryInterface
Chris@0:    */
Chris@0:   protected $configFactory;
Chris@0: 
Chris@0:   /**
Chris@0:    * Constructs the ImageToolkitManager object.
Chris@0:    *
Chris@0:    * @param \Traversable $namespaces
Chris@0:    *   An object that implements \Traversable which contains the root paths
Chris@0:    *   keyed by the corresponding namespace to look for plugin implementations.
Chris@0:    * @param \Drupal\Core\Cache\CacheBackendInterface $cache_backend
Chris@0:    *   Cache backend instance to use.
Chris@0:    * @param \Drupal\Core\Extension\ModuleHandlerInterface $module_handler
Chris@0:    *   The module handler.
Chris@0:    * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
Chris@0:    *   The config factory.
Chris@0:    */
Chris@0:   public function __construct(\Traversable $namespaces, CacheBackendInterface $cache_backend, ModuleHandlerInterface $module_handler, ConfigFactoryInterface $config_factory) {
Chris@0:     parent::__construct('Plugin/ImageToolkit', $namespaces, $module_handler, 'Drupal\Core\ImageToolkit\ImageToolkitInterface', 'Drupal\Core\ImageToolkit\Annotation\ImageToolkit');
Chris@0: 
Chris@0:     $this->setCacheBackend($cache_backend, 'image_toolkit_plugins');
Chris@0:     $this->configFactory = $config_factory;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Gets the default image toolkit ID.
Chris@0:    *
Chris@0:    * @return string|bool
Chris@0:    *   ID of the default toolkit, or FALSE on error.
Chris@0:    */
Chris@0:   public function getDefaultToolkitId() {
Chris@0:     $toolkit_id = $this->configFactory->get('system.image')->get('toolkit');
Chris@0:     $toolkits = $this->getAvailableToolkits();
Chris@0: 
Chris@0:     if (!isset($toolkits[$toolkit_id]) || !class_exists($toolkits[$toolkit_id]['class'])) {
Chris@0:       // The selected toolkit isn't available so return the first one found. If
Chris@0:       // none are available this will return FALSE.
Chris@0:       reset($toolkits);
Chris@0:       $toolkit_id = key($toolkits);
Chris@0:     }
Chris@0: 
Chris@0:     return $toolkit_id;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Gets the default image toolkit.
Chris@0:    *
Chris@0:    * @return \Drupal\Core\ImageToolkit\ImageToolkitInterface
Chris@0:    *   Object of the default toolkit, or FALSE on error.
Chris@0:    */
Chris@0:   public function getDefaultToolkit() {
Chris@0:     if ($toolkit_id = $this->getDefaultToolkitId()) {
Chris@0:       return $this->createInstance($toolkit_id);
Chris@0:     }
Chris@0:     return FALSE;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Gets a list of available toolkits.
Chris@0:    *
Chris@0:    * @return array
Chris@0:    *   An array with the toolkit names as keys and the descriptions as values.
Chris@0:    */
Chris@0:   public function getAvailableToolkits() {
Chris@0:     // Use plugin system to get list of available toolkits.
Chris@0:     $toolkits = $this->getDefinitions();
Chris@0: 
Chris@0:     $output = [];
Chris@0:     foreach ($toolkits as $id => $definition) {
Chris@0:       // Only allow modules that aren't marked as unavailable.
Chris@0:       if (call_user_func($definition['class'] . '::isAvailable')) {
Chris@0:         $output[$id] = $definition;
Chris@0:       }
Chris@0:     }
Chris@0: 
Chris@0:     return $output;
Chris@0:   }
Chris@0: 
Chris@0: }