# wordpress-seo/28.1/src/ai/free-sparks/application/free-sparks-handler-interface.php

Yoast SEO – Advanced SEO with real-time guidance and built-in AI, version 28.1. 33 lines.

- Page: https://pluginprobe.com/plugins/wordpress-seo/28.1/code/src/ai/free-sparks/application/free-sparks-handler-interface.php
- Raw: https://pluginprobe.com/plugins/wordpress-seo/28.1/raw/src/ai/free-sparks/application/free-sparks-handler-interface.php
- Modified: 2026-03-17T12:01:04+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/wordpress-seo/28.1/code/src/ai/free-sparks/application/free-sparks-handler-interface.php#L10-L20`.

```php
<?php

// phpcs:disable Yoast.NamingConventions.NamespaceName.TooLong -- Needed in the folder structure.

namespace Yoast\WP\SEO\AI\Free_Sparks\Application;

/**
 * Interface Consent_Handler_Interface
 *
 * This interface defines the methods for handling user consent.
 */
interface Free_Sparks_Handler_Interface {

	/**
	 * Retrieves the timestamp.
	 *
	 * @param string $format The format in which to return the timestamp. Defaults to 'Y-m-d H:i:s'.
	 *
	 * @return ?string The timestamp when the user started using free sparks, or null if not set.
	 */
	public function get( string $format = 'Y-m-d H:i:s' ): ?string;

	/**
	 * Registers the starting of the free sparks.
	 *
	 * @param ?int $timestamp The timestamp when the user started using free sparks. If null, the current time will be
	 *                        used.
	 *
	 * @return bool True if the operation was successful, false otherwise.
	 */
	public function start( ?int $timestamp = null ): bool;
}

```