# elasticpress/5.3.5/includes/classes/Screen/Settings.php

ElasticPress, version 5.3.5. 190 lines.

- Page: https://pluginprobe.com/plugins/elasticpress/5.3.5/code/includes/classes/Screen/Settings.php
- Raw: https://pluginprobe.com/plugins/elasticpress/5.3.5/raw/includes/classes/Screen/Settings.php
- Modified: 2026-08-27T16:27:46+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/elasticpress/5.3.5/code/includes/classes/Screen/Settings.php#L10-L20`.

```php
<?php
/**
 * Settings screen.
 *
 * @since 5.0.0
 * @package ElasticPress
 */

namespace ElasticPress\Screen;

use ElasticPress\Screen;
use ElasticPress\Utils;

defined( 'ABSPATH' ) || exit;

/**
 * Settings screen Class.
 */
class Settings {
	/**
	 * Previous language
	 *
	 * @var string
	 */
	protected $prev_ep_language = '';

	/**
	 * Previous URL host
	 *
	 * @var string
	 */
	protected $prev_ep_host = '';

	/**
	 * Previous credentials array
	 *
	 * @var array
	 */
	protected $prev_ep_credentials = [];

	/**
	 * Previous "Content Items per Index Cycle" setting
	 *
	 * @var int
	 */
	protected $prev_ep_bulk_setting = 350;

	/**
	 * Initialize class
	 */
	public function setup() {
		add_action( 'admin_enqueue_scripts', [ $this, 'admin_enqueue_scripts' ] );
		add_action( 'admin_init', [ $this, 'action_admin_init' ], 8 );
	}

	/**
	 * Enqueue script
	 */
	public function admin_enqueue_scripts() {
		if ( 'settings' !== Screen::factory()->get_current_screen() ) {
			return;
		}

		wp_enqueue_script(
			'ep_settings_scripts',
			EP_URL . 'dist/js/settings-script.js',
			Utils\get_asset_info( 'settings-script', 'dependencies' ),
			Utils\get_asset_info( 'settings-script', 'version' ),
			true
		);

		wp_set_script_translations( 'ep_settings_scripts', 'elasticpress' );
	}

	/**
	 * Admin-init actions
	 *
	 * Sets up Settings API.
	 */
	public function action_admin_init() {
		$post = wp_unslash( $_POST );

		if ( empty( $post['ep_settings_nonce'] ) || ! wp_verify_nonce( $post['ep_settings_nonce'], 'elasticpress_settings' ) ) {
			return;
		}

		$this->prev_ep_language     = Utils\get_language();
		$this->prev_ep_host         = Utils\get_host();
		$this->prev_ep_credentials  = Utils\get_epio_credentials();
		$this->prev_ep_bulk_setting = Utils\get_option( 'ep_bulk_setting', 350 );

		$language = sanitize_text_field( $post['ep_language'] );
		Utils\update_option( 'ep_language', $language );

		if ( isset( $post['ep_host'] ) ) {
			$host = esc_url_raw( trim( $post['ep_host'] ) );
			Utils\update_option( 'ep_host', $host );
		}

		if ( isset( $post['ep_credentials'] ) && ( ! defined( 'EP_CREDENTIALS' ) || ! EP_CREDENTIALS ) ) {
			$credentials = Utils\sanitize_credentials( $post['ep_credentials'] );

			// Preserve the existing token if the field was left empty (it is always empty on load).
			if ( empty( $credentials['token'] ) ) {
				$credentials['token'] = $this->prev_ep_credentials['token'];
			}

			Utils\update_option( 'ep_credentials', $credentials );
		}

		if ( isset( $post['ep_bulk_setting'] ) ) {
			Utils\update_option( 'ep_bulk_setting', $this->sanitize_bulk_settings( $post['ep_bulk_setting'] ) );
		}

		$es_info = \ElasticPress\Elasticsearch::factory()->get_elasticsearch_info( true );
		if ( empty( $es_info['version'] ) ) {
			if ( defined( 'EP_IS_NETWORK' ) && EP_IS_NETWORK ) {
				add_action( 'network_admin_notices', [ $this, 'add_validation_notice' ] );
			} else {
				add_action( 'admin_notices', [ $this, 'add_validation_notice' ] );
			}

			unset( $_POST['ep_host'] ); // Needed to prevent going to the next installation step
			$this->reset_settings();
		}
	}

	/**
	 * Add a notice to the Settings form when the host was not set yet
	 */
	public function add_validation_notice() {
		$target = ( Utils\is_epio() ) ?
			_x( 'ElasticPress.io account', 'Settings validation message', 'elasticpress' ) :
			_x( 'Elasticsearch server', 'Settings validation message', 'elasticpress' );

		$is_first_setup = empty( $this->prev_ep_host );

		if ( $is_first_setup ) {
			// Setting it for the first time -- probably during the install process.
			$message = sprintf(
				/* translators: EP.io account or ES server. */
				__( 'It was not possible to connect to your %s. Please check your settings and try again.', 'elasticpress' ),
				$target
			);
		} else {
			$message = sprintf(
				/* translators: EP.io account or ES server. */
				__( 'It was not possible to connect to your %s. Your settings were reverted.', 'elasticpress' ),
				$target
			);
		}
		?>
		<div class="notice notice-error">
			<p>
				<?php echo wp_kses( $message, 'ep-html' ); ?>
			</p>
			<?php if ( Utils\is_epio() && ! $is_first_setup ) : ?>
				<p>
					<?php esc_html_e( 'If you are trying to deactivate your site\'s communication with ElasticPress.io, temporarily disable the ElasticPress plugin instead.', 'elasticpress' ); ?>
				</p>
			<?php endif; ?>
		</div>
		<?php
	}

	/**
	 * Sanitize bulk settings.
	 *
	 * @param int $bulk_settings Number of bulk content items
	 * @return int
	 */
	protected function sanitize_bulk_settings( $bulk_settings = 350 ) {
		$bulk_settings = absint( $bulk_settings );

		return ( 0 === $bulk_settings ) ? 350 : $bulk_settings;
	}

	/**
	 * Reset settings to their previous values
	 */
	protected function reset_settings() {
		Utils\update_option( 'ep_language', $this->prev_ep_language );
		Utils\update_option( 'ep_host', $this->prev_ep_host );
		Utils\update_option( 'ep_credentials', $this->prev_ep_credentials );
		Utils\update_option( 'ep_bulk_setting', $this->prev_ep_bulk_setting );

		\ElasticPress\Elasticsearch::factory()->get_elasticsearch_info( true );
	}
}

```