Localization and child theme

[mike-se]

As it is now the localization jumpstart.po file is in Jump Start/lang. When I create a translation the translated file only work if it is in that same folder, but not if I place it in Childtheme/lang folder. The translation file is then erased as soon as Jump Start gets an update, and needs to be uploaded again via ftp.

This is a bit of a hassle. Could you please make it so the localization files work from within the child theme structure.

Topic

[Ervan Erfian]

Hi Mike,
You can search “Load theme text domains” and change “get_template_directory” to “get_stylesheet_directory” for your language http://pastie.org/7121359 at jumpstart/framework/api/helpers.php

[mike-se]

Hi Ervan, and thanks. Thats all good but unfortunately it still doesn’t solve the issue with Jump Start updates.

[karlo]

Try also look in themeblvd.php, find

// Apply initial hooks
	add_action( 'themeblvd_localize', 'themeblvd_load_theme_textdomain' );

I have not tested but should mean you can remove_action your way to secure updating of lingo files. With Ervans code as content of new action.

remove_action( 'themeblvd_localize', 'themeblvd_load_theme_textdomain' );
add_action ( 'themeblvd_localize', 'themeblvd_load_theme_textdomain_MYWAY' );
function themeblvd_load_theme_textdomain_MYWAY() {
    load_theme_textdomain( 'themeblvd', get_stylesheet_directory() . '/lang' );
    load_theme_textdomain( 'themeblvd_frontend', get_stylesheet_directory() . '/lang' );
}

might work or can be tuned to work.

Also !function_exists means you can just copy it directly in to functions.php and change code. But I believe the remove/add thing is more correct.

I am not sure how lingo stuff works with Jump Start, or in general, so hopefully dev. comment.

[Ervan Erfian]

Yeah.. Karlo right and hooked via functions would be better for updates scenario .

[Jason Bobich]

To accomplish this, there are two things that need to happen.

1) In you PO file, all of the paths need to reference jumpstart from this new location. When you generate a new project in poEdit, if we were going to save into a directory of the Child theme called “lang” then the filepath would be ../../jumpstart/ — We’re moving up two directories into /wp-content/themes/ and then down into /jumpstart to search for all the translatable strings.

Here’s the result from doing this: http://themeblvd.com/temp/default.po

2) As the others were pointing out, you need to now register the theme’s text domain from the proper place. The trick on this is to make sure that this happens (a) before the framework’s API and (b) before the framework registers its localization.

So put the following snippet before the framework runs in your Child theme’s functions.php:

function my_load_theme_textdomain() {
    load_theme_textdomain( 'themeblvd', get_stylesheet_directory() . '/lang' );
    load_theme_textdomain( 'themeblvd_frontend', get_stylesheet_directory() . '/lang' );
}
add_action ( 'themeblvd_localize', 'my_load_theme_textdomain' );

This might look something like this in your Child theme’s functions.php.

Note: The thing here that is sort of unique is that we’re hooking to the framework’s “themeblvd_localize” action. Often themes will hook to “after_setup_theme” as shown in examples in the codex, but this will not work (for everything) in Jump Start because how all the unique API functions work with adding theme options, sliders, builder elements, etc.

[mike-se]

Thanks all, that solution works nicely. Perhaps you could add this functionality into the next update. I’m pretty sure more people in the future will stumble on this, since your target for Jump Start is the whole wide world 🙂

Thanks again though, I’m really starting to appreciate your work and great support more and more. Wish all devs were more like you.

[Jason Bobich]

Thanks, Mike!

I wanted to note here to anyone passing through, also, if you’re just to do a simple translation of the strings on the frontend of your website, you can the Theme Blvd String Swap plugin and avoid localization all together.

http://wordpress.org/extend/plugins/theme-blvd-string-swap/

[karlo]

Yeah that is nifty. Cover what matters, 9 out of 10 could not care less for what is not visible, but there is a combo hard to beat – Codestyling Localization http://wordpress.org/extend/plugins/codestyling-localization/ + lingo files in child theme. For the full translation experience 🙂

Poedit is also ok.

[karlo]

Since I just wasted half an hour messing with this I will report that just dumping snippet in functions.php does not necessarily work. Must come BEFORE

require_once( get_template_directory() . '/framework/themeblvd.php' );

Or like in image posted by Jason. I think I moved it about, heh.

[Jason Bobich]

So, in other words, follow instructions? lol

[karlo]

Doing byte comparison between Jump Start 1.0.1 and 1.0.2 to find out where you messed up translation never hurt anyone. I was starting to consider the option of corrupted file too. How to check that? Poedit I guess but can give false positives I have heard. This type of activity Is only fun for so long and I will probably go with instructions next time 🙂 May be also start to organize that functions.php file, or better split it up.

[karlo]

Thread is going in other direction but I might as well add what I forgot. I had to download full version 1.0.2 for my scientific comparison to 1.0.1 so found something weird in 1.0.2.

May be you should remove github repository from Jump Start 1.0.2 download. I dont think there are any secrets in there, like naked pics. If I am wrong better delete this post too as there is no reason to get people looking.

Auto update does not add github folder as far as I can tell.

[Jason Bobich]

Oh yeah, if the github hidden directory is in there, it’s just by mistake.

[Jason Bobich]

I’ve updated this. There should be no more hidden .github directory.

[karlo]

Thanks.

But jumpstart-boxed has one too. May be others, I only checked that one 🙂

[Author]

Replies