# wplingua/2.12.1/inc/api-key.php

Translate and Go multilingual – Automatic AI translation – wpLingua, version 2.12.1. 416 lines.

- Page: https://pluginprobe.com/plugins/wplingua/2.12.1/code/inc/api-key.php
- Raw: https://pluginprobe.com/plugins/wplingua/2.12.1/raw/inc/api-key.php
- Modified: 2026-04-30T00:13:10+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/wplingua/2.12.1/code/inc/api-key.php#L10-L20`.

```php
<?php

// If this file is called directly, abort.
if ( ! defined( 'WPINC' ) ) {
	die;
}


/**
 * Validate a wpLingua API key
 *
 * @param string $api_key
 * @return bool
 */
function wplng_is_valid_api_key_format( $api_key ) {

	$regex = '/^[a-zA-Z0-9]{42}$/s';

	if (
		empty( $api_key )
		|| ! is_string( $api_key )
		|| false === preg_match( $regex, $api_key )
	) {
		return false;
	}

	return true;
}


/**
 * Get the wpLingua registered API key
 *
 * @return string
 */
function wplng_get_api_key() {

	$api_key = trim( get_option( 'wplng_api_key' ) );

	if ( ! wplng_is_valid_api_key_format( $api_key ) ) {
		$api_key = '';
	}

	return $api_key;
}


/**
 * Get wpLingua API key data
 * - Website language (id or 'all')
 * - Target language(s) (array)
 * - Enabled features
 *
 * @return array
 */
function wplng_get_api_data( $try_update_from_api = false ) {

	global $wplng_api_data;

	if ( $wplng_api_data !== null && $try_update_from_api === false ) {
		return $wplng_api_data;
	}

	if ( empty( wplng_get_api_key() ) ) {
		return array();
	}

	/**
	 * Get data from cache or API
	 */

	$data_checked    = array();
	$data            = array();
	$data_from_cache = get_option( 'wplng_api_key_data' );

	if ( ! empty( $data_from_cache ) ) {
		$data_from_cache = json_decode( $data_from_cache, true );
		if ( ! is_array( $data_from_cache ) ) {
			$data_from_cache = array();
		}
	}

	if ( empty( $data_from_cache ) ) {

		/**
		 * No data in cache
		 */

		// Try to get update from API
		$data = wplng_api_call_validate_api_key();

		// If no data in cache and no data from API, return empty array
		if ( empty( $data ) ) {
			return array();
		}

		$data['time'] = time();

	} else {

		/**
		 * Data is in cache
		 */

		$data = $data_from_cache;

		// Time of last update is not define, set is as current time
		if ( empty( $data['time'] )
			|| ! is_int( $data['time'] )
		) {
			$data['time'] = time();
		}

		// Time of last update older than 8 hours
		// Or $try_update_from_api is true
		// Try to get update from API
		if ( ( $data['time'] + ( 8 * HOUR_IN_SECONDS ) ) <= time()
			|| $try_update_from_api === true
		) {

			$data_from_api = wplng_api_call_validate_api_key();

			if ( ! empty( $data_from_api ) ) {
				$data         = $data_from_api;
				$data['time'] = time();
			}
		}
	}

	/**
	 * Check the API key data
	 */

	if ( ! empty( $data['language_original'] )
		&& (
			wplng_is_valid_language_id( $data['language_original'] )
			|| 'all' === $data['language_original']
		)
		&& ! empty( $data['languages_target'] )
		&& wplng_is_valid_language_ids( $data['languages_target'] )
		&& isset( $data['features'] )
		&& is_array( $data['features'] )
		&& ! empty( $data['status'] )
		&& ! empty( $data['time'] )
		&& is_int( $data['time'] )
	) {

		/**
		 * Sanitize languages target
		 */

		$languages_target = array();

		foreach ( $data['languages_target'] as $id ) {

			if ( ! wplng_is_valid_language_id( $id ) ) {
				continue;
			}

			$languages_target[] = sanitize_key( $id );
		}

		/**
		 * Sanitize features list
		 */

		$features = array();

		foreach ( $data['features'] as $key => $allow ) {

			if ( ! is_string( $key ) || ! is_bool( $allow ) ) {
				continue;
			}

			$key   = sanitize_key( $key );
			$allow = ( true === $allow );

			$features[ $key ] = $allow;
		}

		/**
		 * Sanitize status
		 */

		$status = 'FREE';

		if ( 'PREMIUM' === $data['status']
			|| 'VIP' === $data['status']
		) {
			$status = $data['status'];
		}

		/**
		 * Make the checked response
		 */

		$data_checked = array(
			'language_original' => sanitize_key( $data['language_original'] ),
			'languages_target'  => $languages_target,
			'features'          => $features,
			'status'            => $status,
			'time'              => $data['time'],
		);

		/**
		 * Add expiration
		 */

		if ( ! empty( $data['expiration'] )
			&& is_string( $data['expiration'] )
		) {
			$data_checked['expiration'] = $data['expiration'];
		}
	}

	// Set data in DB cache (option)
	if ( ! empty( $data_checked )
		&& $data_checked !== $data_from_cache
	) {
		update_option(
			'wplng_api_key_data',
			wp_json_encode( $data_checked ),
			true
		);

		wp_cache_flush();
	}

	// Set data for global variable
	$wplng_api_data = $data_checked;

	return $data_checked;
}


/**
 * Get website language from wpLingua API data
 *
 * @return string Language ID, 'all' or ''
 */
function wplng_get_api_language_website() {

	$data = wplng_get_api_data();

	if (
		! empty( $data['language_original'] )
		&& (
			wplng_is_valid_language_id( $data['language_original'] )
			|| 'all' === $data['language_original']
		)
	) {
		return $data['language_original'];
	}

	return '';
}


/**
 * Get target languages from wpLingua API data
 *
 * @return mixed Language IDs array, 'all' or false
 */
function wplng_get_api_languages_target() {

	$data = wplng_get_api_data();

	if ( empty( $data['languages_target'] ) ) {
		return false;
	} elseif ( 'all' === $data['languages_target'] ) {
		return 'all';
	} elseif ( is_array( $data['languages_target'] ) ) {

		$all_languages        = wplng_get_languages_all();
		$languages_id_ordered = array();

		foreach ( $all_languages as $language ) {
			foreach ( $data['languages_target'] as $language_id ) {

				if (
					! wplng_is_valid_language_id( $language_id )
					|| empty( $language['id'] )
					|| $language['id'] !== $language_id
				) {
					continue;
				}

				$languages_id_ordered[] = $language_id;
				break;

			}
		}

		return $languages_id_ordered;
	}

	return false;
}


/**
 * Get enabled features from wpLingua API data
 * ('search', 'commercial', 'detection')
 *
 * @return array
 */
function wplng_get_api_feature() {

	$data     = wplng_get_api_data();
	$all      = array( 'search', 'commercial', 'detection' );
	$features = array();

	if ( ! empty( $data['features'] ) && is_array( $data['features'] ) ) {
		foreach ( $data['features'] as $feature_name => $feature_allow ) {
			if ( $feature_allow && in_array( $feature_name, $all ) ) {
				$features[] = $feature_name;
			}
		}
	}

	return $features;
}


/**
 * Return true if the feature is enable in wpLingua API key data
 *
 * @param string $feature_name
 * @return bool
 */
function wplng_api_feature_is_allow( $feature_name ) {
	return in_array( $feature_name, wplng_get_api_feature() );
}


/**
 * Check if the wpLingua API is overloaded
 *
 * This function determines whether the wpLingua API is currently overloaded
 * based on a stored timestamp. If the API is overloaded, it returns true.
 * Otherwise, it clears the overloaded status and returns false.
 *
 * @global bool|null $wplng_api_is_overloaded Cached overloaded status
 * @return bool True if the API is overloaded, false otherwise
 */
function wplng_get_api_overloaded() {

	global $wplng_api_is_overloaded;

	// If overload is true, return directly
	// Else, recheck the value
	if ( ! empty( $wplng_api_is_overloaded ) ) {
		return $wplng_api_is_overloaded;
	}

	$overloaded = get_option( 'wplng_api_overloaded' );

	if ( ! empty( $overloaded )
		&& ( $overloaded + ( 2 * MINUTE_IN_SECONDS ) ) > time()
	) {
		$wplng_api_is_overloaded = true;
	} else {
		$wplng_api_is_overloaded = false;
		delete_option( 'wplng_api_overloaded' );
	}

	return $wplng_api_is_overloaded;
}


/**
 * Mark the wpLingua API as overloaded
 *
 * This function sets the overloaded status for the wpLingua API by updating
 * a timestamp in the database. If the API is already marked as overloaded,
 * the function does nothing.
 *
 * @global bool|null $wplng_api_is_overloaded Cached overloaded status
 * @return void
 */
function wplng_set_api_overloaded() {

	if ( wplng_get_api_overloaded() ) {
		return;
	}

	global $wplng_api_is_overloaded;
	$wplng_api_is_overloaded = true;

	update_option(
		'wplng_api_overloaded',
		time(),
		true
	);

	wp_cache_flush();
}


/**
 * Clear wpLingua API key data if wpLingua key is changed
 *
 * @param string $old_value JSON
 * @param string $new_value JSON
 * @return void
 */
function wplng_on_update_option_wplng_api_key( $old_value, $new_value ) {

	delete_option( 'wplng_api_key_data' );
	delete_option( 'wplng_website_language' );
	delete_option( 'wplng_website_flag' );

	wplng_clear_translations_cache();
	wplng_clear_slugs_cache();
}

```