Jak dodać tłumaczenia dla elementów motywu WordPress

Jak przetłumaczyć motyw WordPressPrzewodnik po tłumaczeniu motywu WordPressDodawanie tłumaczeń do motywu WordPressTłumaczenie elementów motywu WordPressNajlepsza wtyczka do tłumaczenia motywu WordPressTutorial lokalizacji motywu WordPressJak używać Loco Translate w WordPressKrok po kroku tłumaczenie motywu WordPressTłumaczenie motywów i wtyczek WordPressMetody tłumaczenia motywów WordPress

Objaśnienie

Aby uczynić swój motyw WordPress wielojęzycznym, musisz go przygotować do tłumaczeń. Oto prosty przewodnik, który pomoże Ci zacząć:

Ładowanie tłumaczeń:

Użyj load_theme_textdomain(), aby poinformować WordPress, gdzie znaleźć pliki tłumaczeń. Pliki te powinny znajdować się w folderze o nazwie languages w katalogu Twojego motywu.

Tłumaczenie tekstu:

Owiń każdy tekst, który chcesz przetłumaczyć, w funkcję __(). Funkcja ta przyjmuje dwa argumenty: tekst oraz textdomain Twojego motywu.

Tłumaczenie elementów motywu:

Dla elementów takich jak menu i paski boczne, użyj funkcji __() w funkcjach takich jak register_nav_menus() i register_sidebar(), aby zapewnić, że ich nazwy i opisy mogą być tłumaczone.

Bezpieczeństwo:

Zawsze używaj esc_html__(), gdy wyświetlasz przetłumaczone ciągi, aby zapewnić ich bezpieczeństwo przed potencjalnymi zagrożeniami.

Używanie Loco Translate:

Gdy Twój motyw jest gotowy, możesz użyć wtyczki Loco Translate do tworzenia i zarządzania tłumaczeniami. To obejmuje generowanie pliku POT, który działa jako szablon dla Twoich tłumaczeń.

Pamiętaj, aby zastąpić 'your-theme-textdomain' rzeczywistym textdomain Twojego motywu, aby wszystko działało płynnie.

Kod
<?php
// Load theme textdomain for translations
function wp_dudecom_load_theme_textdomain() {
    load_theme_textdomain( 'your-theme-textdomain', get_template_directory() . '/languages' );
}
add_action( 'after_setup_theme', 'wp_dudecom_load_theme_textdomain' );

// Example of translating a string in a theme
function wp_dudecom_display_translated_string() {
    echo __( 'Hello, World!', 'your-theme-textdomain' );
}

// Register a custom function to translate theme elements
function wp_dudecom_translate_theme_elements() {
    // Example: Translating a menu item
    register_nav_menus( array(
        'primary' => __( 'Primary Menu', 'your-theme-textdomain' ),
    ) );

    // Example: Translating a widget title
    register_sidebar( array(
        'name'          => __( 'Sidebar', 'your-theme-textdomain' ),
        'id'            => 'sidebar-1',
        'description'   => __( 'Main sidebar that appears on the right.', 'your-theme-textdomain' ),
        'before_widget' => '<aside id="%1$s" class="widget %2$s">',
        'after_widget'  => '</aside>',
        'before_title'  => '<h2 class="widget-title">',
        'after_title'   => '</h2>',
    ) );
}
add_action( 'after_setup_theme', 'wp_dudecom_translate_theme_elements' );

// Security best practice: Escape translated strings
function wp_dudecom_escaped_translated_string() {
    echo esc_html__( 'Securely Translated String', 'your-theme-textdomain' );
}

// Example of using Loco Translate plugin
// Ensure the theme is ready for translation by creating a POT file
// Use Loco Translate to create and manage translations for your theme

// Note: Replace 'your-theme-textdomain' with your actual theme's textdomain
?>

Instrukcja

Lokalizacja pliku: Dodaj poniższy kod do pliku functions.php swojego motywu.

Wymagania wstępne:

Upewnij się, że masz zainstalowaną i aktywowaną wtyczkę Loco Translate do zarządzania tłumaczeniami.

Kroki wdrożenia:

Przygotuj swój motyw do tłumaczeń:
- Utwórz folder o nazwie languages w katalogu swojego motywu, jeśli jeszcze nie istnieje.
- Upewnij się, że textdomain twojego motywu jest poprawnie ustawiony. Zastąp 'your-theme-textdomain' rzeczywistym textdomain twojego motywu w kodzie.
Załaduj textdomain motywu:
- Funkcja wp_dudecom_load_theme_textdomain() jest podpięta do after_setup_theme, aby załadować pliki tłumaczeń z folderu languages.
Tłumacz ciągi:
- Użyj __() do tłumaczenia ciągów w swoim motywie, jak pokazano w wp_dudecom_display_translated_string().
Tłumacz elementy motywu:
- Użyj __() w funkcjach takich jak register_nav_menus() i register_sidebar(), aby tłumaczyć elementy menu i tytuły widgetów, jak pokazano w wp_dudecom_translate_theme_elements().
Zadbaj o bezpieczeństwo:
- Użyj esc_html__() do bezpiecznego wyświetlania przetłumaczonych ciągów, jak pokazano w wp_dudecom_escaped_translated_string().
Zarządzaj tłumaczeniami za pomocą Loco Translate:
- Użyj wtyczki Loco Translate, aby wygenerować plik POT i zarządzać tłumaczeniami swojego motywu.

Potrzebujesz pomocy przy wdrożeniu lub bardziej zaawansowanej funkcjonalności? Odwiedź wp-dude.com po profesjonalne usługi WordPress.