# wpdeepl/trunk/client/deeplapi-functions.php

Translation with DeepL API, version trunk. 97 lines.

- Page: https://pluginprobe.com/plugins/wpdeepl/trunk/code/client/deeplapi-functions.php
- Raw: https://pluginprobe.com/plugins/wpdeepl/trunk/raw/client/deeplapi-functions.php
- Modified: 2025-12-17T06:21: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/wpdeepl/trunk/code/client/deeplapi-functions.php#L10-L20`.

```php
<?php
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
function deepl_translate( $source_lang = false, $target_lang = false, $strings = array(), $cache_prefix = '', $allow_cache = true  ) {
		$DeepLApiTranslate = new DeepLApiTranslate();
		$DeepLApiTranslate->setCachePrefix( $cache_prefix );
		$DeepLApiTranslate->allowCache( $allow_cache );

		if ( $source_lang ) {
			$DeepLApiTranslate->setLangFrom( $source_lang );
		}

		//var_dump($target_lang);		die('okzerzererrzer');
		if ( !$DeepLApiTranslate->setLangTo( $target_lang ) ) {
			/* translators: target language asked */
			return new WP_Error( sprintf( __( "Target language '%s' not valid", 'wpdeepl' ), $target_lang ) );
		}

		$DeepLApiTranslate->setTagHandling( 'html' );

		$DeepLApiTranslate->setFormality( DeepLConfiguration::getFormalityLevel( $target_lang) );

		$DeepLApiTranslate = apply_filters('deepl_translate_DeepLApiTranslate_before', $DeepLApiTranslate );

		//echo "\n pour lang $target_lang , formality = " . DeepLConfiguration::getFormalityLevel( $target_lang) ;
//		wpdeepl_debug_display($DeepLApiTranslate);		die('oazeaz+e48az4ea698k');
		
		$translations = $DeepLApiTranslate->getTranslations( $strings );

		if ( is_wp_error( $translations ) ) {
			return array(
				'success'	=> false,
				'errors'	=> $translations
			);
		}
		$request = array(
			'cached'				=> $DeepLApiTranslate->wasItCached(),
			'time'					=> $DeepLApiTranslate->getTimeElapsed(),
			'cache_file_request'	=> $DeepLApiTranslate->getCacheFile( 'request' ),
			'cache_file_response'	=> $DeepLApiTranslate->getCacheFile( 'response' ),
		);
		$success = true;
		$return = compact( 'success', 'request', 'translations' );
		return apply_filters( 'deepl_translate', $return, $source_lang, $target_lang, $strings, $cache_prefix );
}


function deepl_show_usage() {
	?>
		<h3><?php esc_html_e( 'Usage', 'wpdeepl' ); ?></h3>
		<?php
		$DeepLApiUsage = new DeepLApiUsage();
		$usage = $DeepLApiUsage->request();

		//wpdeepl_debug_display($usage);		wpdeepl_debug_display($DeepLApiUsage);

		if ( $usage && is_array( $usage ) && array_key_exists( 'character_count', $usage ) && array_key_exists( 'character_limit', $usage )) :
			$ratio = round( 100 * ( $usage['character_count'] / $usage['character_limit'] ), 3 );
			$left_chars = $usage['character_limit'] - $usage['character_count'];

		?>
			<div class="progress-bar blue">
				<span style="width: <?php echo esc_attr( round( (100 - absint( $ratio ) ), 0 ) ); ?>%"><b><?php 
				echo esc_html(
				    sprintf(
				        /* translators: characters remaining */
				        __( '%s characters remaining', 'wpdeepl' ),
				        // L'argument est déjà sécurisé par esc_html(), on le laisse tel quel.
				        number_format( $left_chars ) 
				    )
				); ?></b></span>
				<div class="progress-text"><?php
				echo esc_html(
					sprintf( 
					/* translators: characters translated / limit */
					__( '%1$s / %2$s characters translated', 'wpdeepl' ), 
					esc_html( number_format_i18n( $usage['character_count'] ) ), 
					esc_html( number_format_i18n( $usage['character_limit'] ) ) 
				));
				 echo " - " . esc_html( $ratio ); ?> %</div>
				 <small class="request_time"><?php 
				 echo esc_html( sprintf( 
				 	/* translators: time for the request */
				 	__( 'Request done in: %f milliseconds', 'wpdeepl' ), 
				 	esc_html( $DeepLApiUsage->getRequestTime( true ) )
				 )); ?></small>
			</div>
		<?php
		else :
			esc_html_e('No response from the server', 'wpdeepl');
			?><br /><?php
			/* translators: link to the DeepL website */
			echo wp_kses_post( sprintf(__('Did you select the right server ? If yes, check your plan on <a href="%s">DeepL Pro website</a>. "DeepL API" should be included in it.', 'wpdeepl' ),
				'https://www.deepl.com/pro-account/plan'
			));

		endif;
}
```