load_child_theme_textdomain( string $domain, string $path = false )

Load the child themes translated strings.


Description Description

If the current locale exists as a .mo file in the child themes root directory, it will be included in the translated strings by the $domain.

The .mo files must be named based on the locale exactly.


Parameters Parameters

$domain

(string) (Required) Text domain. Unique identifier for retrieving translated strings.

$path

(string) (Optional) Path to the directory containing the .mo file.

Default value: false


Top ↑

Return Return

(bool) True when the theme textdomain is successfully loaded, false otherwise.


Top ↑

Source Source

File: wp-includes/l10n.php

function load_child_theme_textdomain( $domain, $path = false ) {
	if ( ! $path ) {
		$path = get_stylesheet_directory();
	}
	return load_theme_textdomain( $domain, $path );
}

Top ↑

Changelog Changelog

Changelog
Version Description
2.9.0 Introduced.

Top ↑

More Information More Information

Internationalization and localization (other common spellings are internationalisation and localisation) are means of adapting computer software to different languages.

  • l10n is an abbreviation for localization.
  • i18n 18 stands for the number of letters between the first i and last n in internationalization.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Drew Jaynes

    The load_child_theme_textdomain() function should generally be called from within the after_setup_theme action hook, just the same as with its related load_theme_textdomain() function.

    /**
     * Loads the child theme textdomain.
     */
    function wpdocs_child_theme_setup() {
        load_child_theme_textdomain( 'my_parent_theme', get_stylesheet_directory() . '/languages' );
    }
    add_action( 'after_setup_theme', 'wpdocs_child_theme_setup' );
    

    ‘my_parent_theme’ = The name of the Main theme

    The .mo files must use language-only filenames, like languages/de_DE.mo in your child theme directory.

    Unlike plugin language files, a name like my_child_theme-de_DE.mo will NOT work. Although plugin language files allow you to specify the text-domain in the filename, this will NOT work with themes and child themes. Language files for themes should include the language shortcut ONLY.

  2. Skip to note 2 content
    Contributed by vonJanne

    Might be useful for beginners to also know that in the note above
    ‘wpdocs_child_theme_setup’ = The name of your child theme,
    hence that needs to be changed in line 4 and line 7 in the code snippet shown above.
    And in that same example the .mo and .po files are not uploaded to the child-theme root, but to a folder named languages inside the child-folder.

You must log in before being able to contribute a note or feedback.