caps = $caps; } /** * Check if a capability is on in the map. * * @param string $capability Capability key from Capabilities::defaults() or an add-on. * @return bool */ public function allows( string $capability ) { return $this->caps->allows( $capability ); } /** * Enforce a capability or throw. * * @param string $capability Capability key. * @param string $message Optional custom error message. * @throws RuntimeException If capability is not available. */ public function require( string $capability, string $message = '' ) { if ( $this->allows( $capability ) ) { return; } throw new RuntimeException( $message ?: sprintf( 'Capability "%s" is not available.', $capability ) ); // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped } /** * Get the underlying Capabilities instance. * * @return Capabilities */ public function capabilities(): Capabilities { return $this->caps; } /** * Swap the capability map this gate reads, for example after an add-on * has added its `subtleforms/capabilities` filter. * * @since 2.7.1 * * @param Capabilities $caps Capability map. */ public function setCapabilities( Capabilities $caps ): void { $this->caps = $caps; } }