CoreFiles by mySites.guru
class-akismet-ability.php60 lines, 1,539 bytes, from wordpress-7.2-beta3.zip
Raw History Compare with 7.2-beta2
md5
0921a7aa51bbd5b8eabc4d5860e5474b
sha1
6e2bb5f35e5a32482c1d2ce4368b21c44af5f146
sha256
7eb568b57357468a06b7a730ed62383c1ea062464618c5835ca89373a31c9f9a
<?php
/**
 * Represents a Base Ability.
 *
 * This class holds a default constructor to register the ability and a default permission.
 *
 * @package Akismet
 * @since 5.7
 */

declare( strict_types = 1 );

/**
 * Base class for Akismet abilities.
 *
 * @package Akismet
 * @since 5.7
 */
abstract class Akismet_Ability implements Akismet_Ability_Interface {

	/**
	 * Get the ability name.
	 *
	 * Classes extending this must implement this method to provide the ability name into the registration.
	 *
	 * @return string The ability name.
	 */
	abstract protected function get_ability_name(): string;

	/**
	 * Get the config.
	 *
	 * Classes extending this must implement this method to provide the ability configuration into the registration.
	 *
	 * @return array The ability configuration array.
	 */
	abstract public function get_config(): array;

	/**
	 * Constructor - registers the ability.
	 */
	public function __construct() {
		wp_register_ability(
			$this->get_ability_name(),
			$this->get_config()
		);
	}

	// phpcs:disable Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Base class default, subclasses use $input.
	/**
	 * Permission callback for any ability that uses this trait.
	 *
	 * @param array|null $input The input parameters (unused).
	 * @return bool Whether the current user can use this ability.
	 */
	public function current_user_has_permission( ?array $input = null ): bool {
	// phpcs:enable Generic.CodeAnalysis.UnusedFunctionParameter.Found
		return current_user_can( 'moderate_comments' );
	}
}

The same content is in 36 releases, WordPress 7.0-RC3 to 7.2-RC2. See them all, or every version of this file.