When developing a WordPress theme from scratch it\u2019s a good practice to internationalize your theme so it\u2019s available for translation. It will allow people from all over the world to use it in whatever language they need.<\/p>\n
What is Internationalization (i18n) and Localization (l10n)?<\/strong><\/p>\n I18n<\/strong> is a process of making your theme translatable. This is the job of the theme developer to get it ready. It\u2019s often abbreviated as i18n because there are 18 letters between the i<\/em> and the n<\/em>.<\/p>\n L10n<\/strong> refers to the process of actually translating your theme to another language. This can be done by the theme\u2019s users. In order to localize the theme it has to be internationalized first. Localization is abbreviated as l10n because there are 10 letters between the l<\/em> and the n<\/em>.<\/p>\n Gettext libraries<\/strong><\/p>\n WordPress uses gettext libraries to load the translations. It has three types of files:<\/p>\n POT (Portable Object Template):<\/em> The first step in the translation process. This file is responsible for generating strings that need to be translated. However it doesn’t contain any translations by itself.<\/p>\n PO (Portable Object):<\/em> These files on the other hand contain the translations and the original strings.<\/p>\n MO (Machine Object):<\/em> These files are used by functions to load the translations. It\u2019s not human-readable, but they are the most important.<\/p>\n Preparing the Theme<\/strong><\/p>\n Preparing your theme for internationalization is not as complicated as it might seem. WordPress already provides a set of handy functions for that. First of all we need to include a function in functions.php which will load the translations:<\/p>\n The next step is editing text strings. In order to make strings translatable they should not be hardcoded. Wrap the original strings in one of the WordPress localization functions.<\/strong> The most commonly used functions:<\/p>\n Example:<\/p>\n Sometimes you need to output variables, date or plurals in your strings. WordPress provides localization functions for all these cases. Check the full list here.<\/a><\/p>\n When your theme files are ready, the next step is to generate POT file. There are a couple of ways to generate POT file that are described here.<\/a> I usually use Gulp task runner while developing WordPress themes, so I also create POT file using Gulp (see gulp-wp-pot<\/a> package).<\/p>\nfunction my_theme_load_theme_textdomain() {\r\n load_theme_textdomain( 'my-theme', get_template_directory() . '\/languages' );\r\n}\r\nadd_action( \u2018after_setup_theme','my_theme_load_theme_textdomain' );<\/pre>\n__() \/* returns the translation of its argument *\/\r\n\r\n_e() \/* echos the string to the browser *\/\r\n\r\nesc_html__() \/* escapes and returns the translation of its argument *\/\r\n\r\nesc_html_e() \/* escapes and echos the translation of its argument *\/<\/pre>\n
<h1><?php __( 'Translatable text goes here', 'theme-domain' ); ?><\/h1>\r\n<h3><?php esc_html__( 'Translatable text goes here', 'theme-domain' ); ?><\/h3><\/pre>\n
npm install --save-dev gulp-wp-pot\r\n\r\nvar gulp = require('gulp');\r\nvar wpPot = require('gulp-wp-pot');\r\n \r\ngulp.task('default', function () {\r\n return gulp.src('src\/*.php')\r\n .pipe(wpPot( {\r\n domain: 'domain',\r\n package: 'Example project'\r\n } ))\r\n .pipe(gulp.dest('file.pot'));\r\n});<\/pre>\n