load_child_theme_textdomain( string $domain, string|false $path = false ): bool

User Contributed Notes

1. Skip to note 3 content

   Drew Jaynes 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 8You must log in to vote on the helpfulness of this note

   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 4 content

   vonJanne 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   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.

   • No, a beginner will try to change that function name to “parenttheme-child” and a dash is not allowed there. That function name doesn’t matter much.

      /**   * Loads the child theme language.   */  function myfunction_child_theme_language() {     load_child_theme_textdomain( 'PARENTTHEMENAME', get_stylesheet_directory() . '/languages' );  }  add_action( 'after_setup_theme', 'myfunction_child_theme_language' ); 

     You need only update the PARENTTHEMENAME to the parent theme directory name. Put the .MO and .PO files in a folder called ‘languages’ under the child theme directory.

     interestica 6 years ago
   • It is not needed at all to rename “wpdocs_child_theme_setup”. It is just a callback function, it can be named as you like, as long as the names of the function and second argument of add_action match. You can even do this (PHP 5.3+), without the need for a name: add_action( 'after_setup_theme', function() { load_child_theme_textdomain( 'my_parent_theme', get_stylesheet_directory() . '/languages' ); } ); Or, from PHP 7.4+ add_action( 'after_setup_theme', () => { load_child_theme_textdomain( 'my_parent_theme', get_stylesheet_directory() . '/languages' ); } );

     Lovro Hrust 4 years ago