__( '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
Langferry — %s %s
' . 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· ·
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() ) ); ?>
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() ) ); ?>