<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* WordPress Translation Installation Administration API

[2] Fix | Delete

*

[3] Fix | Delete

* @package WordPress

[4] Fix | Delete

* @subpackage Administration

[5] Fix | Delete

*/

[6] Fix | Delete

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Retrieve translations from WordPress Translation API.

[10] Fix | Delete

*

[11] Fix | Delete

* @since 4.0.0

[12] Fix | Delete

*

[13] Fix | Delete

* @param string $type Type of translations. Accepts 'plugins', 'themes', 'core'.

[14] Fix | Delete

* @param array|object $args Translation API arguments. Optional.

[15] Fix | Delete

* @return array|WP_Error {

[16] Fix | Delete

* On success an associative array of translations, WP_Error on failure.

[17] Fix | Delete

*

[18] Fix | Delete

* @type array $translations {

[19] Fix | Delete

* List of translations, each an array of data.

[20] Fix | Delete

*

[21] Fix | Delete

* @type array ...$0 {

[22] Fix | Delete

* @type string $language Language code.

[23] Fix | Delete

* @type string $version WordPress version.

[24] Fix | Delete

* @type string $updated Date the translation was last updated, in MySQL datetime format.

[25] Fix | Delete

* @type string $english_name English name of the language.

[26] Fix | Delete

* @type string $native_name Native name of the language.

[27] Fix | Delete

* @type string $package URL to download the translation package.

[28] Fix | Delete

* @type string[] $iso Array of ISO language codes.

[29] Fix | Delete

* @type array $strings Array of translated strings used in the installation process.

[30] Fix | Delete

* }

[31] Fix | Delete

* }

[32] Fix | Delete

* }

[33] Fix | Delete

*/

[34] Fix | Delete

function translations_api( $type, $args = null ) {

[35] Fix | Delete

if ( ! in_array( $type, array( 'plugins', 'themes', 'core' ), true ) ) {

[36] Fix | Delete

return new WP_Error( 'invalid_type', __( 'Invalid translation type.' ) );

[37] Fix | Delete

}

[38] Fix | Delete

[39] Fix | Delete

/**

[40] Fix | Delete

* Allows a plugin to override the WordPress.org Translation Installation API entirely.

[41] Fix | Delete

*

[42] Fix | Delete

* @since 4.0.0

[43] Fix | Delete

*

[44] Fix | Delete

* @param false|array $result The result array. Default false.

[45] Fix | Delete

* @param string $type The type of translations being requested.

[46] Fix | Delete

* @param object $args Translation API arguments.

[47] Fix | Delete

*/

[48] Fix | Delete

$res = apply_filters( 'translations_api', false, $type, $args );

[49] Fix | Delete

[50] Fix | Delete

if ( false === $res ) {

[51] Fix | Delete

$url = 'http://api.wordpress.org/translations/' . $type . '/1.0/';

[52] Fix | Delete

$http_url = $url;

[53] Fix | Delete

$ssl = wp_http_supports( array( 'ssl' ) );

[54] Fix | Delete

if ( $ssl ) {

[55] Fix | Delete

$url = set_url_scheme( $url, 'https' );

[56] Fix | Delete

}

[57] Fix | Delete

[58] Fix | Delete

$options = array(

[59] Fix | Delete

'timeout' => 3,

[60] Fix | Delete

'body' => array(

[61] Fix | Delete

'wp_version' => wp_get_wp_version(),

[62] Fix | Delete

'locale' => get_locale(),

[63] Fix | Delete

'version' => $args['version'], // Version of plugin, theme or core.

[64] Fix | Delete

),

[65] Fix | Delete

);

[66] Fix | Delete

[67] Fix | Delete

if ( 'core' !== $type ) {

[68] Fix | Delete

$options['body']['slug'] = $args['slug']; // Plugin or theme slug.

[69] Fix | Delete

}

[70] Fix | Delete

[71] Fix | Delete

$request = wp_remote_post( $url, $options );

[72] Fix | Delete

[73] Fix | Delete

if ( $ssl && is_wp_error( $request ) ) {

[74] Fix | Delete

wp_trigger_error(

[75] Fix | Delete

__FUNCTION__,

[76] Fix | Delete

sprintf(

[77] Fix | Delete

/* translators: %s: Support forums URL. */

[78] Fix | Delete

__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),

[79] Fix | Delete

__( 'https://wordpress.org/support/forums/' )

[80] Fix | Delete

) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),

[81] Fix | Delete

headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE

[82] Fix | Delete

);

[83] Fix | Delete

[84] Fix | Delete

$request = wp_remote_post( $http_url, $options );

[85] Fix | Delete

}

[86] Fix | Delete

[87] Fix | Delete

if ( is_wp_error( $request ) ) {

[88] Fix | Delete

$res = new WP_Error(

[89] Fix | Delete

'translations_api_failed',

[90] Fix | Delete

sprintf(

[91] Fix | Delete

/* translators: %s: Support forums URL. */

[92] Fix | Delete

__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),

[93] Fix | Delete

__( 'https://wordpress.org/support/forums/' )

[94] Fix | Delete

),

[95] Fix | Delete

$request->get_error_message()

[96] Fix | Delete

);

[97] Fix | Delete

} else {

[98] Fix | Delete

$res = json_decode( wp_remote_retrieve_body( $request ), true );

[99] Fix | Delete

if ( ! is_object( $res ) && ! is_array( $res ) ) {

[100] Fix | Delete

$res = new WP_Error(

[101] Fix | Delete

'translations_api_failed',

[102] Fix | Delete

sprintf(

[103] Fix | Delete

/* translators: %s: Support forums URL. */

[104] Fix | Delete

__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),

[105] Fix | Delete

__( 'https://wordpress.org/support/forums/' )

[106] Fix | Delete

),

[107] Fix | Delete

wp_remote_retrieve_body( $request )

[108] Fix | Delete

);

[109] Fix | Delete

}

[110] Fix | Delete

}

[111] Fix | Delete

}

[112] Fix | Delete

[113] Fix | Delete

/**

[114] Fix | Delete

* Filters the Translation Installation API response results.

[115] Fix | Delete

*

[116] Fix | Delete

* @since 4.0.0

[117] Fix | Delete

*

[118] Fix | Delete

* @param array|WP_Error $res {

[119] Fix | Delete

* On success an associative array of translations, WP_Error on failure.

[120] Fix | Delete

*

[121] Fix | Delete

* @type array $translations {

[122] Fix | Delete

* List of translations, each an array of data.

[123] Fix | Delete

*

[124] Fix | Delete

* @type array ...$0 {

[125] Fix | Delete

* @type string $language Language code.

[126] Fix | Delete

* @type string $version WordPress version.

[127] Fix | Delete

* @type string $updated Date the translation was last updated, in MySQL datetime format.

[128] Fix | Delete

* @type string $english_name English name of the language.

[129] Fix | Delete

* @type string $native_name Native name of the language.

[130] Fix | Delete

* @type string $package URL to download the translation package.

[131] Fix | Delete

* @type string[] $iso Array of ISO language codes.

[132] Fix | Delete

* @type array $strings Array of translated strings used in the installation process.

[133] Fix | Delete

* }

[134] Fix | Delete

* }

[135] Fix | Delete

* }

[136] Fix | Delete

* @param string $type The type of translations being requested.

[137] Fix | Delete

* @param object $args Translation API arguments.

[138] Fix | Delete

*/

[139] Fix | Delete

return apply_filters( 'translations_api_result', $res, $type, $args );

[140] Fix | Delete

}

[141] Fix | Delete

[142] Fix | Delete

/**

[143] Fix | Delete

* Get available translations from the WordPress.org API.

[144] Fix | Delete

*

[145] Fix | Delete

* @since 4.0.0

[146] Fix | Delete

*

[147] Fix | Delete

* @see translations_api()

[148] Fix | Delete

*

[149] Fix | Delete

* @return array {

[150] Fix | Delete

* Array of translations keyed by the language code, each an associative array of data.

[151] Fix | Delete

* If the API response results in an error, an empty array will be returned.

[152] Fix | Delete

*

[153] Fix | Delete

* @type array ...$0 {

[154] Fix | Delete

* @type string $language Language code.

[155] Fix | Delete

* @type string $version WordPress version.

[156] Fix | Delete

* @type string $updated Date the translation was last updated, in MySQL datetime format.

[157] Fix | Delete

* @type string $english_name English name of the language.

[158] Fix | Delete

* @type string $native_name Native name of the language.

[159] Fix | Delete

* @type string $package URL to download the translation package.

[160] Fix | Delete

* @type string[] $iso Array of ISO language codes.

[161] Fix | Delete

* @type array $strings Array of translated strings used in the installation process.

[162] Fix | Delete

* }

[163] Fix | Delete

* }

[164] Fix | Delete

*/

[165] Fix | Delete

function wp_get_available_translations() {

[166] Fix | Delete

if ( ! wp_installing() ) {

[167] Fix | Delete

$translations = get_site_transient( 'available_translations' );

[168] Fix | Delete

if ( false !== $translations ) {

[169] Fix | Delete

return $translations;

[170] Fix | Delete

}

[171] Fix | Delete

}

[172] Fix | Delete

[173] Fix | Delete

$api = translations_api( 'core', array( 'version' => wp_get_wp_version() ) );

[174] Fix | Delete

[175] Fix | Delete

if ( is_wp_error( $api ) || empty( $api['translations'] ) ) {

[176] Fix | Delete

return array();

[177] Fix | Delete

}

[178] Fix | Delete

[179] Fix | Delete

$translations = array();

[180] Fix | Delete

// Key the array with the language code.

[181] Fix | Delete

foreach ( $api['translations'] as $translation ) {

[182] Fix | Delete

$translations[ $translation['language'] ] = $translation;

[183] Fix | Delete

}

[184] Fix | Delete

[185] Fix | Delete

if ( ! defined( 'WP_INSTALLING' ) ) {

[186] Fix | Delete

set_site_transient( 'available_translations', $translations, 3 * HOUR_IN_SECONDS );

[187] Fix | Delete

}

[188] Fix | Delete

[189] Fix | Delete

return $translations;

[190] Fix | Delete

}

[191] Fix | Delete

[192] Fix | Delete

/**

[193] Fix | Delete

* Output the select form for the language selection on the installation screen.

[194] Fix | Delete

*

[195] Fix | Delete

* @since 4.0.0

[196] Fix | Delete

*

[197] Fix | Delete

* @global string $wp_local_package Locale code of the package.

[198] Fix | Delete

*

[199] Fix | Delete

* @param array[] $languages Array of available languages (populated via the Translation API).

[200] Fix | Delete

*/

[201] Fix | Delete

function wp_install_language_form( $languages ) {

[202] Fix | Delete

global $wp_local_package;

[203] Fix | Delete

[204] Fix | Delete

$installed_languages = get_available_languages();

[205] Fix | Delete

[206] Fix | Delete

echo "<label class='screen-reader-text' for='language'>Select a default language</label>\n";

[207] Fix | Delete

echo "<select size='14' name='language' id='language'>\n";

[208] Fix | Delete

echo '<option value="" lang="en" selected="selected" data-continue="Continue" data-installed="1">English (United States)</option>';

[209] Fix | Delete

echo "\n";

[210] Fix | Delete

[211] Fix | Delete

if ( ! empty( $wp_local_package ) && isset( $languages[ $wp_local_package ] ) ) {

[212] Fix | Delete

if ( isset( $languages[ $wp_local_package ] ) ) {

[213] Fix | Delete

$language = $languages[ $wp_local_package ];

[214] Fix | Delete

printf(

[215] Fix | Delete

'<option value="%s" lang="%s" data-continue="%s"%s>%s</option>' . "\n",

[216] Fix | Delete

esc_attr( $language['language'] ),

[217] Fix | Delete

esc_attr( current( $language['iso'] ) ),

[218] Fix | Delete

esc_attr( $language['strings']['continue'] ? $language['strings']['continue'] : 'Continue' ),

[219] Fix | Delete

in_array( $language['language'], $installed_languages, true ) ? ' data-installed="1"' : '',

[220] Fix | Delete

esc_html( $language['native_name'] )

[221] Fix | Delete

);

[222] Fix | Delete

[223] Fix | Delete

unset( $languages[ $wp_local_package ] );

[224] Fix | Delete

}

[225] Fix | Delete

}

[226] Fix | Delete

[227] Fix | Delete

foreach ( $languages as $language ) {

[228] Fix | Delete

printf(

[229] Fix | Delete

'<option value="%s" lang="%s" data-continue="%s"%s>%s</option>' . "\n",

[230] Fix | Delete

esc_attr( $language['language'] ),

[231] Fix | Delete

esc_attr( current( $language['iso'] ) ),

[232] Fix | Delete

esc_attr( $language['strings']['continue'] ? $language['strings']['continue'] : 'Continue' ),

[233] Fix | Delete

in_array( $language['language'], $installed_languages, true ) ? ' data-installed="1"' : '',

[234] Fix | Delete

esc_html( $language['native_name'] )

[235] Fix | Delete

);

[236] Fix | Delete

}

[237] Fix | Delete

echo "</select>\n";

[238] Fix | Delete

echo '<p class="step"><span class="spinner"></span><input id="language-continue" type="submit" class="button button-primary button-large" value="Continue" /></p>';

[239] Fix | Delete

}

[240] Fix | Delete

[241] Fix | Delete

/**

[242] Fix | Delete

* Download a language pack.

[243] Fix | Delete

*

[244] Fix | Delete

* @since 4.0.0

[245] Fix | Delete

*

[246] Fix | Delete

* @see wp_get_available_translations()

[247] Fix | Delete

*

[248] Fix | Delete

* @param string $download Language code to download.

[249] Fix | Delete

* @return string|false Returns the language code if successfully downloaded

[250] Fix | Delete

* (or already installed), or false on failure.

[251] Fix | Delete

*/

[252] Fix | Delete

function wp_download_language_pack( $download ) {

[253] Fix | Delete

// Check if the translation is already installed.

[254] Fix | Delete

if ( in_array( $download, get_available_languages(), true ) ) {

[255] Fix | Delete

return $download;

[256] Fix | Delete

}

[257] Fix | Delete

[258] Fix | Delete

if ( ! wp_is_file_mod_allowed( 'download_language_pack' ) ) {

[259] Fix | Delete

return false;

[260] Fix | Delete

}

[261] Fix | Delete

[262] Fix | Delete

// Confirm the translation is one we can download.

[263] Fix | Delete

$translations = wp_get_available_translations();

[264] Fix | Delete

if ( ! $translations ) {

[265] Fix | Delete

return false;

[266] Fix | Delete

}

[267] Fix | Delete

foreach ( $translations as $translation ) {

[268] Fix | Delete

if ( $translation['language'] === $download ) {

[269] Fix | Delete

$translation_to_load = true;

[270] Fix | Delete

break;

[271] Fix | Delete

}

[272] Fix | Delete

}

[273] Fix | Delete

[274] Fix | Delete

if ( empty( $translation_to_load ) ) {

[275] Fix | Delete

return false;

[276] Fix | Delete

}

[277] Fix | Delete

$translation = (object) $translation;

[278] Fix | Delete

[279] Fix | Delete

require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';

[280] Fix | Delete

$skin = new Automatic_Upgrader_Skin();

[281] Fix | Delete

$upgrader = new Language_Pack_Upgrader( $skin );

[282] Fix | Delete

$translation->type = 'core';

[283] Fix | Delete

$result = $upgrader->upgrade( $translation, array( 'clear_update_cache' => false ) );

[284] Fix | Delete

[285] Fix | Delete

if ( ! $result || is_wp_error( $result ) ) {

[286] Fix | Delete

return false;

[287] Fix | Delete

}

[288] Fix | Delete

[289] Fix | Delete

return $translation->language;

[290] Fix | Delete

}

[291] Fix | Delete

[292] Fix | Delete

/**

[293] Fix | Delete

* Check if WordPress has access to the filesystem without asking for

[294] Fix | Delete

* credentials.

[295] Fix | Delete

*

[296] Fix | Delete

* @since 4.0.0

[297] Fix | Delete

*

[298] Fix | Delete

* @return bool Returns true on success, false on failure.

[299] Fix | Delete

*/

[300] Fix | Delete

function wp_can_install_language_pack() {

[301] Fix | Delete

if ( ! wp_is_file_mod_allowed( 'can_install_language_pack' ) ) {

[302] Fix | Delete

return false;

[303] Fix | Delete

}

[304] Fix | Delete

[305] Fix | Delete

require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';

[306] Fix | Delete

$skin = new Automatic_Upgrader_Skin();

[307] Fix | Delete

$upgrader = new Language_Pack_Upgrader( $skin );

[308] Fix | Delete

$upgrader->init();

[309] Fix | Delete

[310] Fix | Delete

$check = $upgrader->fs_connect( array( WP_CONTENT_DIR, WP_LANG_DIR ) );

[311] Fix | Delete

[312] Fix | Delete

if ( ! $check || is_wp_error( $check ) ) {

[313] Fix | Delete

return false;

[314] Fix | Delete

}

[315] Fix | Delete

[316] Fix | Delete

return true;

[317] Fix | Delete

}

[318] Fix | Delete

[319] Fix | Delete