# wplingua/2.12.1/inc/translator/json.php

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

- Page: https://pluginprobe.com/plugins/wplingua/2.12.1/code/inc/translator/json.php
- Raw: https://pluginprobe.com/plugins/wplingua/2.12.1/raw/inc/translator/json.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/translator/json.php#L10-L20`.

```php
<?php

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


/**
 * wpLingua translate : Get translated JSON
 *
 * @param string $json
 * @param array  $args
 * @return string
 */
function wplng_translate_json( $json, $args = array() ) {

	if ( empty( $json ) ) {
		return $json;
	}

	$json_translated = '';
	$json_decoded    = json_decode( $json, true );

	if ( empty( $json_decoded ) || ! is_array( $json_decoded ) ) {
		return $json;
	}

	/**
	 * Update args
	 */

	wplng_args_setup( $args );

	if ( empty( $args['translations'] ) && empty( $args['texts_unknow'] ) ) {

		$texts = wplng_parse_json_array(
			$json_decoded,
			$args['parents']
		);

		wplng_args_update_from_texts(
			$args,
			$texts
		);
	}

	/**
	 * Translate JSON
	 */

	$json_translated = wp_json_encode(
		wplng_translate_json_array(
			$json_decoded,
			$args
		)
	);

	if ( empty( $json_translated ) ) {
		return $json;
	}

	return $json_translated;
}


/**
 * wpLingua translate : Get translated array from decoded JSON
 *
 * @param array $json_decoded
 * @param array $translations
 * @param array $parents
 * @return array
 */
function wplng_translate_json_array( $json_decoded, $args = array() ) {

	$array_translated = $json_decoded;

	/**
	 * Update args
	 */

	wplng_args_setup( $args );

	if ( empty( $args['translations'] ) && empty( $args['texts_unknow'] ) ) {

		$texts = wplng_parse_json_array(
			$json_decoded,
			$args['parents']
		);

		wplng_args_update_from_texts(
			$args,
			$texts
		);
	}

	/**
	 * Don't parse JSON if it's exclude
	 */

	if ( wplng_json_element_is_excluded( $json_decoded, $args['parents'] ) ) {

		if ( WPLNG_DEBUG_JSON === true ) {

			$debug = array(
				'title'   => 'wpLingua JSON debug - Excluded parent',
				'parents' => $args['parents'],
				'value'   => $json_decoded,
			);

			error_log(
				var_export(
					$debug,
					true
				)
			);
		}

		return $json_decoded;
	}

	/**
	 * Parse each JSON elements
	 */

	foreach ( $json_decoded as $key => $value ) {

		$current_parents = array_merge( $args['parents'], array( $key ) );

		/**
		 * Don't parse element if it's exclude
		 */

		if ( wplng_json_element_is_excluded( $json_decoded, $current_parents ) ) {

			if ( true === WPLNG_DEBUG_JSON ) {

				$debug = array(
					'title'   => 'wpLingua JSON debug - Excluded element',
					'parents' => $current_parents,
					'value'   => $value,
				);

				error_log(
					var_export(
						$debug,
						true
					)
				);
			}

			continue;
		}

		if ( is_array( $value ) ) {

			/**
			 * If element is an array, parse it
			 */

			$args['parents'] = $current_parents;

			$array_translated[ $key ] = wplng_translate_json_array(
				$value,
				$args
			);

			$args['parents'] = array_splice( $args['parents'], 0, -1 );

		} elseif ( is_string( $value ) ) {

			$debug_type = '';

			/**
			 * If element is a string
			 */

			if ( wplng_str_is_locale_id( $value ) ) {

				/**
				 * If is a local ID (fr_FR, fr, FR, ...), replace by current
				 */

				$debug_type               = 'String - Local ID';
				$array_translated[ $key ] = $args['language_target'];

			} elseif ( wplng_str_is_json( $value ) ) {

				/**
				 * If element is a JSON, parse and translate it
				 */

				$debug_type      = 'String - JSON';
				$args['parents'] = $current_parents;

				$array_translated[ $key ] = wplng_translate_json(
					$value,
					$args
				);

			} elseif ( wplng_str_is_html( $value ) ) {

				/**
				 * If element is a HTML, parse and translate it
				 */

				$debug_type               = 'String - HTML';
				$array_translated[ $key ] = wplng_translate_html(
					$value,
					$args
				);

			} elseif ( wplng_str_is_url( $value ) ) {

				/**
				 * If element is an URL, replace by translated URL
				 */

				$debug_type               = 'String - URL';
				$array_translated[ $key ] = wplng_url_translate( $value );

			} elseif ( wplng_str_is_script_i18n( $value ) ) {

				/**
				 * If element is a i18n script, replace by translated script
				 */

				// Voluntarily don't pass $current_parents
				$debug_type               = 'String - Script i18n';
				$array_translated[ $key ] = wplng_translate_js_json_in_i18n_script( $value );

			} else {

				/**
				 * Element is a unknow string,
				 *  - check if it's translatable
				 *  - Check if is an included element
				 */

				if ( ! wplng_text_is_translatable( $value ) ) {

					$debug_type = 'String - Untranslatable';

				} elseif ( ! wplng_json_element_is_included( $value, $current_parents ) ) {

					$debug_type = 'String - Not included';

				} else {

					$debug_type               = 'String - Translatable';
					$array_translated[ $key ] = wplng_get_translated_text_from_translations(
						$value,
						$args['translations']
					);

				}
			}

			/**
			 * Print debug data in debug.log file
			 */

			if ( true === WPLNG_DEBUG_JSON
				&& isset( $json_decoded[ $key ] )
				&& isset( $array_translated[ $key ] )
				// && $debug_type === 'String - Not included'
			) {

				$debug = array(
					'title'   => 'wpLingua JSON debug',
					'parents' => $current_parents,
					'type'    => $debug_type,
					'value'   => $json_decoded[ $key ],
				);

				if ( $json_decoded[ $key ] !== $array_translated[ $key ] ) {
					$debug['translated'] = $array_translated[ $key ];
				}

				error_log( var_export( $debug, true ) );
			}
		}
	}

	return $array_translated;
}

```