__( 'Dropdown with flags', 'langferry' ), 'dropdown' => __( 'Dropdown', 'langferry' ), 'globe' => __( 'Globe icon', 'langferry' ), 'popup' => __( 'Popup with search', 'langferry' ), 'flags' => __( 'Flags', 'langferry' ), 'flags_name' => __( 'Flags with names', 'langferry' ), 'flags_code' => __( 'Flags with codes', 'langferry' ), 'names' => __( 'Language names', 'langferry' ), 'codes' => __( 'Language codes', 'langferry' ), ); } public static function menu() { add_menu_page( 'Langferry', 'Langferry', 'manage_options', self::SLUG, array( __CLASS__, 'render_settings' ), 'dashicons-translation', 81 ); add_submenu_page( self::SLUG, __( 'Langferry Settings', 'langferry' ), __( 'Settings', 'langferry' ), 'manage_options', self::SLUG, array( __CLASS__, 'render_settings' ) ); add_submenu_page( self::SLUG, __( 'Translations', 'langferry' ), __( 'Translations', 'langferry' ), 'manage_options', self::EDITOR_SLUG, array( __CLASS__, 'render_editor' ) ); } public static function action_links( $links ) { array_unshift( $links, '' . esc_html__( 'Settings', 'langferry' ) . '' ); return $links; } public static function assets( $hook ) { if ( false === strpos( (string) $hook, 'langferry' ) ) { return; } wp_enqueue_style( 'langferry-admin', LANGFERRY_URL . 'assets/css/admin.css', array(), LANGFERRY_VERSION ); wp_enqueue_style( 'langferry-switcher', LANGFERRY_URL . 'assets/css/switcher.css', array(), LANGFERRY_VERSION ); wp_enqueue_script( 'langferry-admin', LANGFERRY_URL . 'assets/js/admin.js', array( 'wp-api-fetch', 'wp-i18n' ), LANGFERRY_VERSION, true ); $config = Settings::effective(); wp_localize_script( 'langferry-admin', 'langferryAdmin', array( 'languages' => $config['languages'], 'names' => array_map( static function ( $l ) { return $l['name']; }, Languages::all() ), 'canEdit' => true, ) ); } /* ------------------------------------------------------------------ */ /* Notices */ /* ------------------------------------------------------------------ */ private static function flash( $type, $message ) { set_transient( 'langferry_notice_' . get_current_user_id(), array( $type, $message ), 60 ); } private static function show_flash() { $key = 'langferry_notice_' . get_current_user_id(); $notice = get_transient( $key ); if ( $notice ) { delete_transient( $key ); printf( '

%s

', esc_attr( $notice[0] ), wp_kses_post( $notice[1] ) ); } } /** * Only on the Dashboard and Plugins screens (Langferry's own pages say it themselves), and the * connect reminder can be dismissed for good. */ public static function global_notices() { $screen = get_current_screen(); if ( ! current_user_can( 'manage_options' ) || ! $screen || ! in_array( $screen->id, array( 'dashboard', 'plugins' ), true ) ) { return; } $conn = Settings::connection(); if ( ! Settings::is_connected() ) { if ( get_user_meta( get_current_user_id(), 'langferry_dismissed_connect', true ) ) { return; } printf( '

Langferry — %s %s %s

', esc_html__( 'Connect your site to start translating it.', 'langferry' ), esc_url( admin_url( 'admin.php?page=' . self::SLUG ) ), esc_html__( 'Connect', 'langferry' ), esc_url( wp_nonce_url( admin_url( 'admin-post.php?action=langferry_dismiss_connect' ), 'langferry_dismiss_connect' ) ), esc_html__( 'Dismiss', 'langferry' ) ); } elseif ( ! empty( $conn['api_key_invalid'] ) ) { printf( '

Langferry — %s %s

', esc_html__( 'The API key was revoked or replaced. Translation is paused.', 'langferry' ), esc_url( admin_url( 'admin.php?page=' . self::SLUG ) ), esc_html__( 'Reconnect', 'langferry' ) ); } } /* ------------------------------------------------------------------ */ /* Actions */ /* ------------------------------------------------------------------ */ public static function handle_dismiss_connect() { check_admin_referer( 'langferry_dismiss_connect' ); if ( current_user_can( 'manage_options' ) ) { update_user_meta( get_current_user_id(), 'langferry_dismissed_connect', 1 ); } wp_safe_redirect( wp_get_referer() ? wp_get_referer() : admin_url() ); exit; } /** * Suggested text for the site's privacy policy (Settings → Privacy → Policy Guide). */ public static function privacy_policy_text() { if ( ! function_exists( 'wp_add_privacy_policy_content' ) ) { return; } $text = '

' . esc_html__( 'This site uses Langferry to translate its pages. When a page, a page address or a WooCommerce email contains text that has not been translated yet, that text is sent to Langferry Cloud and translated by Google Cloud Translation. Visitors\' IP addresses, cookies and requests are not sent. Text on pages shown to signed-in visitors and in order emails can include personal details such as names or addresses, unless those pages or emails are excluded in the Langferry settings. Langferry does not keep that text in its shared translation cache, and this site deletes it 30 days after it was last used.', 'langferry' ) . '

' . '

' . wp_kses_post( sprintf( /* translators: 1: Langferry privacy policy URL, 2: Google privacy policy URL */ __( 'Langferry\'s privacy policy: %1$s. Google\'s privacy policy: %2$s.', 'langferry' ), 'https://langferry.com/privacy/', 'https://policies.google.com/privacy' ) ) . '

'; wp_add_privacy_policy_content( 'Langferry', wp_kses_post( wpautop( $text, false ) ) ); } /** * Only administrators run the plugin's settings actions. */ private static function require_admin() { if ( ! current_user_can( 'manage_options' ) ) { wp_die( esc_html__( 'You are not allowed to do that.', 'langferry' ), 403 ); } } /** * For actions that read nothing from the request. Actions that read the form check their nonce * themselves, right before they read it. */ private static function guard( $action ) { self::require_admin(); check_admin_referer( 'langferry_' . $action ); } private static function back( $page = self::SLUG ) { wp_safe_redirect( admin_url( 'admin.php?page=' . $page ) ); exit; } /** * The "Langferry Cloud URL" field, already sanitized by the handler that read it ('' when it was * left empty or wasn't a URL). * * @param string $url */ private static function maybe_set_cloud_url( $url ) { if ( defined( 'LANGFERRY_CLOUD_URL' ) || '' === $url ) { return; } if ( ! Settings::is_allowed_cloud_url( $url ) ) { self::flash( 'error', __( 'The Langferry Cloud URL must use HTTPS.', 'langferry' ) ); self::back(); } Settings::update_connection( array( 'cloud_url' => $url ) ); } public static function handle_connect() { self::require_admin(); check_admin_referer( 'langferry_connect' ); self::maybe_set_cloud_url( isset( $_POST['cloud_url'] ) && is_string( $_POST['cloud_url'] ) ? untrailingslashit( esc_url_raw( wp_unslash( $_POST['cloud_url'] ) ) ) : '' ); $state = wp_generate_password( 32, false ); set_transient( 'langferry_connect_state_' . get_current_user_id(), $state, 15 * MINUTE_IN_SECONDS ); $url = add_query_arg( array( 'site_url' => rawurlencode( home_url() ), 'site_name' => rawurlencode( get_bloginfo( 'name' ) ), // The return carries a nonce for this admin user, checked before anything else is read. 'return_url' => rawurlencode( add_query_arg( '_wpnonce', wp_create_nonce( 'langferry_connect_return' ), admin_url( 'admin-post.php?action=langferry_connect_return' ) ) ), 'state' => $state, 'plugin_version' => LANGFERRY_VERSION, ), Settings::cloud_url() . '/connect' ); // Langferry Cloud is another host by design; allow just that one for this redirect. $cloud_host = (string) wp_parse_url( $url, PHP_URL_HOST ); add_filter( 'allowed_redirect_hosts', static function ( $hosts ) use ( $cloud_host ) { $hosts[] = $cloud_host; return $hosts; } ); wp_safe_redirect( $url ); exit; } public static function handle_connect_return() { self::require_admin(); // The return address handle_connect() sent carries this nonce; Langferry Cloud keeps it. check_admin_referer( 'langferry_connect_return' ); $key = 'langferry_connect_state_' . get_current_user_id(); $expected = (string) get_transient( $key ); $state = isset( $_GET['state'] ) ? sanitize_text_field( wp_unslash( $_GET['state'] ) ) : ''; $code = isset( $_GET['code'] ) ? sanitize_text_field( wp_unslash( $_GET['code'] ) ) : ''; delete_transient( $key ); if ( isset( $_GET['error'] ) ) { self::flash( 'warning', __( 'Connection was cancelled.', 'langferry' ) ); self::back(); } // The random state (bound to this admin user) also ties the return to the request this site started. if ( '' === $expected || '' === $code || ! hash_equals( $expected, $state ) ) { self::flash( 'error', __( 'Connection request expired or was not started from this site. Please try again.', 'langferry' ) ); self::back(); } $data = Cloud::request( 'POST', '/connect/exchange', array( 'code' => $code, 'site_url' => home_url(), ), array( 'auth' => false ) ); if ( is_wp_error( $data ) || empty( $data['api_key'] ) ) { self::flash( 'error', sprintf( /* translators: %s: error message */ __( 'Could not connect: %s', 'langferry' ), is_wp_error( $data ) ? esc_html( $data->get_error_message() ) : 'no key returned' ) ); self::back(); } self::finish_connect( $data['api_key'] ); } public static function handle_connect_key() { self::require_admin(); check_admin_referer( 'langferry_connect_key' ); self::maybe_set_cloud_url( isset( $_POST['cloud_url'] ) && is_string( $_POST['cloud_url'] ) ? untrailingslashit( esc_url_raw( wp_unslash( $_POST['cloud_url'] ) ) ) : '' ); $api_key = isset( $_POST['api_key'] ) ? trim( sanitize_text_field( wp_unslash( $_POST['api_key'] ) ) ) : ''; if ( 0 !== strpos( $api_key, 'lf_' ) ) { self::flash( 'error', __( 'That does not look like a Langferry API key (they start with "lf_").', 'langferry' ) ); self::back(); } self::finish_connect( $api_key ); } private static function finish_connect( $api_key ) { Settings::update_connection( array( 'api_key' => $api_key, 'config_version' => 0, ) ); delete_transient( 'langferry_cloud_backoff' ); delete_transient( 'langferry_quota_exceeded' ); Translator::clear_plan_pauses(); $result = Cloud::sync(); if ( is_wp_error( $result ) ) { Settings::clear_connection(); self::flash( 'error', sprintf( /* translators: %s: error message */ __( 'Could not connect: %s', 'langferry' ), esc_html( $result->get_error_message() ) ) ); self::back(); } if ( ! wp_next_scheduled( 'langferry_hourly' ) ) { wp_schedule_event( time() + 300, 'hourly', 'langferry_hourly' ); } $count = count( Settings::effective()['languages'] ); self::flash( 'success', $count /* translators: %d: number of languages */ ? sprintf( _n( 'Connected to Langferry — translating into %d language.', 'Connected to Langferry — translating into %d languages.', $count, 'langferry' ), $count ) : __( 'Connected to Langferry. Choose your languages below to start translating.', 'langferry' ) ); self::back(); } public static function handle_disconnect() { self::guard( 'disconnect' ); Cloud::request( 'DELETE', '/site/connection' ); Settings::clear_connection(); self::flash( 'success', __( 'Disconnected. Your translations are kept on this site.', 'langferry' ) ); self::back(); } public static function handle_sync() { self::guard( 'sync' ); delete_transient( 'langferry_cloud_backoff' ); delete_transient( 'langferry_quota_exceeded' ); Translator::clear_plan_pauses(); $conn = Settings::connection(); if ( ! empty( $conn['config_dirty'] ) ) { $pushed = Cloud::push_config( Settings::config() ); if ( ! is_wp_error( $pushed ) ) { Settings::update_connection( array( 'config_dirty' => false ) ); } } $result = Cloud::sync(); if ( is_wp_error( $result ) ) { self::flash( 'error', esc_html( $result->get_error_message() ) ); } else { self::flash( 'success', __( 'Synced with your Langferry dashboard.', 'langferry' ) ); } self::back(); } public static function handle_purge() { self::require_admin(); check_admin_referer( 'langferry_purge' ); $lang = isset( $_POST['lang'] ) ? sanitize_text_field( wp_unslash( $_POST['lang'] ) ) : ''; $lang = Languages::exists( $lang ) ? $lang : null; $n = Translation_Memory::purge( $lang ); Slugs::purge( $lang ); delete_transient( 'langferry_quota_exceeded' ); Translator::clear_plan_pauses(); /* translators: %d: number of strings */ self::flash( 'success', sprintf( _n( '%d machine translation deleted. It will be re-translated on the next visit.', '%d machine translations deleted. They will be re-translated on the next visit.', $n, 'langferry' ), $n ) ); self::back( self::EDITOR_SLUG ); } public static function handle_save() { self::require_admin(); check_admin_referer( 'langferry_save' ); $config = Settings::config(); // Each field is sanitized as it is read. Settings::sanitize_config() then validates the whole // config: a field that isn't one of its setting's allowed values falls back to the default. $text = array(); foreach ( array( 'default_language', 'url_mode', 'languages_order', 'switcher_style', 'switcher_position', 'switcher_flag_shape', 'switcher_theme', 'switcher_menu_location' ) as $field ) { $text[ $field ] = isset( $_POST[ $field ] ) ? sanitize_text_field( wp_unslash( $_POST[ $field ] ) ) : null; } // Lists of lines: tags are removed and the lines kept (percent-encoded paths stay as they are). $lines = array(); foreach ( array( 'exclude_paths', 'exclude_selectors', 'glossary' ) as $field ) { $lines[ $field ] = isset( $_POST[ $field ] ) && is_string( $_POST[ $field ] ) ? wp_strip_all_tags( wp_unslash( $_POST[ $field ] ) ) : ''; } $lists = array(); foreach ( array( 'languages', 'custom_domains', 'switcher_flags' ) as $field ) { $lists[ $field ] = isset( $_POST[ $field ] ) ? self::strings( map_deep( wp_unslash( $_POST[ $field ] ), 'sanitize_text_field' ) ) : array(); } $config['default_language'] = $text['default_language'] ?? $config['default_language']; $config['languages'] = Settings::keep_order( $config['languages'], $lists['languages'], $text['languages_order'] ); $config['url_mode'] = $text['url_mode'] ?? $config['url_mode']; $config['custom_domains'] = $lists['custom_domains']; $config['switcher'] = array( 'style' => $text['switcher_style'] ?? 'dropdown_flags', 'position' => $text['switcher_position'] ?? 'bottom_right', 'native_names' => ! empty( $_POST['switcher_native_names'] ), 'show_flags' => ! empty( $_POST['switcher_show_flags'] ), 'flag_shape' => $text['switcher_flag_shape'] ?? 'rect', 'theme' => $text['switcher_theme'] ?? 'light', 'menu_location' => $text['switcher_menu_location'] ?? '', 'flags' => $lists['switcher_flags'], ); $config['seo'] = array( 'hreflang' => ! empty( $_POST['seo_hreflang'] ), 'x_default' => ! empty( $_POST['seo_x_default'] ), 'translate_slugs' => ! empty( $_POST['seo_translate_slugs'] ), 'sitemap' => ! empty( $_POST['seo_sitemap'] ), 'noindex_incomplete' => ! empty( $_POST['seo_noindex_incomplete'] ), ); $config['auto_redirect'] = ! empty( $_POST['auto_redirect'] ); $config['exclusions'] = array( 'paths' => $lines['exclude_paths'], 'selectors' => $lines['exclude_selectors'], ); $config['glossary'] = $lines['glossary']; $config = Settings::sanitize_config( $config ); Settings::save_config( $config ); if ( ! Settings::is_connected() ) { self::flash( 'success', __( 'Settings saved. Connect your site to start translating.', 'langferry' ) ); self::back(); } $result = Cloud::push_config( $config ); if ( is_wp_error( $result ) ) { $status = (int) ( $result->get_error_data()['status'] ?? 0 ); if ( 409 === $status ) { self::flash( 'warning', __( 'These settings were changed in your Langferry dashboard in the meantime. The latest version has been loaded — please review and save again.', 'langferry' ) ); } else { Settings::update_connection( array( 'config_dirty' => true ) ); self::flash( 'warning', sprintf( /* translators: %s: error */ __( 'Saved on this site, but syncing to your dashboard failed (%s). It will retry automatically.', 'langferry' ), esc_html( $result->get_error_message() ) ) ); } } else { Settings::update_connection( array( 'config_dirty' => false ) ); $dropped = array_diff( $config['languages'], $result['languages'] ?? array() ); if ( $dropped ) { self::flash( 'warning', __( 'Saved. Some languages exceed your plan and were not enabled — upgrade in your dashboard to add more.', 'langferry' ) ); } else { self::flash( 'success', __( 'Settings saved and synced to your dashboard.', 'langferry' ) ); } } self::back(); } /** * The text values of an already-sanitized form field, keyed as sent ("es" => "es.example.com"); * a single value counts as a list of one, and nested arrays are dropped. * * @param mixed $value * @return array */ private static function strings( $value ) { return array_filter( (array) $value, 'is_string' ); } /* ------------------------------------------------------------------ */ /* Screens */ /* ------------------------------------------------------------------ */ private static function plan_badge( $conn ) { $name = $conn['plan']['name'] ?? __( 'Free', 'langferry' ); $id = $conn['plan']['id'] ?? 'free'; return '' . esc_html( $name ) . ''; } private static function upgrade_link( $text = null ) { $conn = Settings::connection(); $url = ! empty( $conn['dashboard_url'] ) ? $conn['dashboard_url'] : Settings::cloud_url(); return ' ' . esc_html( $text ? $text : __( 'Upgrade', 'langferry' ) ) . ' ↗'; } public static function render_settings() { if ( ! current_user_can( 'manage_options' ) ) { return; } $conn = Settings::connection(); if ( Settings::is_connected() && ( time() - (int) ( $conn['last_sync'] ?? 0 ) ) > 5 * MINUTE_IN_SECONDS ) { Cloud::sync(); $conn = Settings::connection(); } $config = Settings::config(); $ent = Settings::entitlements(); $conn = Settings::connection(); self::$progress = null; // Read again for this page. ?>
Langferry
↗

· ·

robots.txt file, so WordPress can\'t add the multilingual sitemap to it. Add this line to the file: Sitemap: %s', 'langferry' ), esc_url( Seo::sitemap_url() ) ), array( 'code' => array() ) ); ?>

$lang ) : ?>

Queue::state() ) ); self::$progress = is_array( $progress ) ? $progress : array(); } return self::$progress; } /** * The usage card's lines about the main pages, under the pace line (PRIO-SHOW-002). They say what the * dashboard's card says (cloud/app/estimate.py, main_pages_line). */ private static function render_main_pages( array $usage ) { $config = Settings::config(); $size = Site_Size::get(); $per_day = is_array( $usage['pace'] ?? null ) ? (int) ( $usage['pace']['per_day'] ?? 0 ) : 0; $lines = self::main_pages_lines( self::main_progress(), self::main_left( (int) $size['main_chars'], self::main_progress(), $config['languages'] ), $per_day ); if ( ! $lines ) { return; } ?>

0 ) { $total += (int) ceil( $main_chars * ( (int) $pair[1] - (int) $pair[0] ) / (int) $pair[1] ); } else { $total += (int) $main_chars; } } return $total; } /** A number of days in words, as admin.js and the dashboard say it. */ private static function duration( $days ) { if ( $days <= 1 ) { return __( 'about a day', 'langferry' ); } if ( $days < 14 ) { /* translators: %1$d: a number of days */ return sprintf( __( 'about %1$d days', 'langferry' ), $days ); } if ( $days < 61 ) { /* translators: %1$d: a number of weeks */ return sprintf( __( 'about %1$d weeks', 'langferry' ), (int) floor( $days / 7 + 0.5 ) ); } /* translators: %1$d: a number of months */ return sprintf( __( 'about %1$d months', 'langferry' ), (int) min( 12, floor( $days / 30.44 + 0.5 ) ) ); } /** * The card's lines, plain text (escape when printing): progress, pace, pages set aside, a cache's * note, and a paused worker. The sentences are the dashboard's (cloud/app/estimate.py main_pages_line); * the plugin adds two of its own: that it can't clear the site's page cache, after the cache's note, * when no caching tool found clears a language's pages one by one (clears_languages()), and its next * step after a paused worker's. * * @param array $progress Priority::progress() with the worker's state. * @param int $left Main characters still to translate in the ticked languages. * @param int $per_day Characters the plan translates a day, 0 when not paced. * @return string[] */ public static function main_pages_lines( array $progress, $left = 0, $per_day = 0 ) { $lines = array(); $main = array(); foreach ( (array) ( $progress['main'] ?? array() ) as $code => $pair ) { if ( is_array( $pair ) && isset( $pair[0], $pair[1] ) && (int) $pair[1] > 0 ) { $main[ $code ] = array( (int) $pair[0], (int) $pair[1] ); } } if ( $main ) { $finished = count( array_filter( $main, static function ( $pair ) { return $pair[0] === $pair[1]; } ) ); /* translators: 1: languages whose main pages are all done, 2: languages in all */ $text = sprintf( __( 'Main pages: done in %1$d of %2$d languages.', 'langferry' ), $finished, count( $main ) ); $next = is_array( $progress['next'] ?? null ) ? $progress['next'] : null; $then = $progress['then'] ?? null; if ( $next && $finished < count( $main ) ) { $page = Languages::name( (string) ( $next['lang'] ?? '' ) ); $name = (string) ( $next['label'] ?? '' ); if ( is_string( $then ) && '' !== $then ) { /* translators: 1: a language, 2: a page's title, 3: the language after it */ $text .= ' ' . sprintf( __( 'Next: %1$s (%2$s), then %3$s.', 'langferry' ), $page, $name, Languages::name( $then ) ); } else { /* translators: 1: a language, 2: a page's title */ $text .= ' ' . sprintf( __( 'Next: %1$s (%2$s).', 'langferry' ), $page, $name ); } } $lines[] = $text; } if ( $left > 0 && $per_day > 0 ) { /* translators: %1$s: "about 3 days" */ $lines[] = sprintf( __( 'All main pages in %1$s at your plan\'s pace.', 'langferry' ), self::duration( (int) ceil( $left / $per_day ) ) ); } $aside = array(); foreach ( (array) ( $progress['set_aside'] ?? array() ) as $entry ) { if ( is_array( $entry ) && isset( $entry['lang'], $entry['label'] ) ) { $aside[] = $entry; } } if ( $aside ) { $items = array(); $cache = array(); // The languages of the pages set aside for a cache. foreach ( $aside as $entry ) { /* translators: 1: a page's title, 2: a language */ $items[] = sprintf( __( '%1$s (%2$s)', 'langferry' ), (string) $entry['label'], Languages::name( (string) $entry['lang'] ) ); if ( 'cache' === ( $entry['reason'] ?? '' ) ) { $cache[] = (string) $entry['lang']; } } $named = count( $aside ); $total = is_int( $progress['set_aside_total'] ?? null ) && $progress['set_aside_total'] > $named ? $progress['set_aside_total'] : $named; /* translators: %s: how many more pages than the ones named, e.g. "10" */ $more = $total > $named ? sprintf( __( ', and %s more', 'langferry' ), number_format_i18n( $total - $named ) ) : ''; /* translators: 1: number of pages, 2: "Projects (Spanish), Contact (French)", 3: ", and 10 more" or nothing */ $lines[] = sprintf( _n( '%1$s page couldn\'t be finished yet: %2$s%3$s.', '%1$s pages couldn\'t be finished yet: %2$s%3$s.', $total, 'langferry' ), number_format_i18n( $total ), implode( ', ', $items ), $more ); if ( $cache ) { $lines[] = __( 'Pre-translation is being answered from a cache, so some pages are retried later.', 'langferry' ); // The plugin's own line, after the shared one (ruling R47): no caching tool found can clear // those languages' pages one by one, none found or each skipped for them (rulings R49-R53). if ( ! self::clears_languages( $cache ) ) { $lines[] = __( 'Langferry can\'t clear this site\'s page cache, so finished pages reach visitors when that cache expires.', 'langferry' ); } } } if ( 'paused_loopback' === ( $progress['worker'] ?? '' ) ) { $lines[] = __( 'Pre-translation can\'t reach your site, so pages are translated as people visit them.', 'langferry' ) . ' ' . __( 'Ask your host to let the site request its own pages, or run wp langferry translate.', 'langferry' ); } return $lines; } /** * Whether a caching tool found clears the pages of each of these languages one by one: its call is * exact (Cache_Purge::clears()) for the language's home address in the current URL mode, which stands * for its pages (a set-aside entry carries no address). Nothing is cleared. * * @param string[] $langs Language codes. */ private static function clears_languages( array $langs ) { $router = Router::instance(); $home = home_url( '/' ); foreach ( array_unique( $langs ) as $lang ) { if ( ! Cache_Purge::clears( (string) $router->translate_url( $home, $lang ) ) ) { return false; } } return true; } /** * What admin.js needs for the estimate (docs/qa/scenarios/site-estimate.md): the site's size, characters * translated per language, and, when connected, what the plan has left and its pace. */ private static function estimate_data() { $size = Site_Size::get(); $data = array( 'chars' => (int) $size['chars'], 'pages' => (int) $size['pages'], 'main' => (int) $size['main_chars'], 'done' => (object) Translation_Memory::chars(), 'plan' => null, 'priority' => null, ); $conn = Settings::connection(); $usage = $conn['usage'] ?? null; if ( Settings::is_connected() && is_array( $usage ) && isset( $usage['chars_quota'] ) ) { $pace = is_array( $usage['pace'] ?? null ) ? $usage['pace'] : null; $data['plan'] = array( 'name' => (string) ( $conn['plan']['name'] ?? '' ), 'kind' => 'lifetime' === ( $usage['kind'] ?? '' ) ? 'lifetime' : 'year', 'remaining' => max( 0, (int) $usage['chars_quota'] - (int) ( $usage['chars_translated'] ?? 0 ) ), 'available' => $pace ? (int) $pace['available'] : null, 'perDay' => $pace ? (int) $pace['per_day'] : null, 'until' => $usage['next_unlock'] ?? ( $usage['resets_on'] ?? null ), 'unlocks' => ! empty( $usage['next_unlock'] ), ); // What the main pages still need, for the sentence about when they finish. $main = (array) ( self::main_progress()['main'] ?? array() ); $data['priority'] = array( 'main' => (object) $main ); } return $data; } private static function render_switcher_card( array $config ) { $sw = $config['switcher']; $locations = get_registered_nav_menus(); ?>

$flags ) : $chosen = $sw['flags'][ $lang ] ?? ''; $options = array( '' => Languages::get( $lang )['flag'] ) + array_combine( $flags, $flags ); // Choice => flag shown; '' is the usual flag. ?>
$flag ) : ?>
$sw['style'] ) ), Switcher::allowed_html() ); ?>

Language Switcher block, the widget, or the [langferry] shortcode. Switcher shortcodes from a previous translation plugin, such as [gtranslate], keep working.', 'langferry' ), array( 'strong' => array(), 'code' => array() ) ); ?>