47 lines
1.0 KiB
PHP
47 lines
1.0 KiB
PHP
<?php
|
|
/**
|
|
* Interface Conditional.
|
|
*
|
|
* @link https://www.mwpd.io/
|
|
*
|
|
* @copyright 2019 Alain Schlesser
|
|
* @license MIT
|
|
*/
|
|
|
|
/**
|
|
* Original code modified for this project.
|
|
*
|
|
* @copyright 2021 Google LLC
|
|
* @license https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
|
|
*/
|
|
|
|
declare(strict_types = 1);
|
|
|
|
namespace Google\Web_Stories\Infrastructure;
|
|
|
|
/**
|
|
* Something that can be instantiated conditionally.
|
|
*
|
|
* A class marked as being conditionally can be asked whether it should be
|
|
* instantiated through a static method. An example would be a service that is
|
|
* only available on the admin backend.
|
|
*
|
|
* This allows for a more systematic and automated optimization of how the
|
|
* different parts of the plugin are enabled or disabled.
|
|
*
|
|
* @internal
|
|
*
|
|
* @since 1.6.0
|
|
*/
|
|
interface Conditional {
|
|
|
|
/**
|
|
* Check whether the conditional object is currently needed.
|
|
*
|
|
* @since 1.6.0
|
|
*
|
|
* @return bool Whether the conditional object is needed.
|
|
*/
|
|
public static function is_needed(): bool;
|
|
}
|