Linguist, customize translations with ease

clarkwinkelmann

Just released an update to Linguist UI (0.2.0). It now looks a lot more like other translation tools, and it should be a lot easier to search, browse and find the strings you want to replace !

No actual new "features" in this release, it still works exactly the same in the background !

You should be able to upgrade with

composer require flagrow/linguist
php flarum cache:clear

This new UI should solve some usability issues that were reported previously. Let me know what you think !

Kryonoglou

Perfect job!

clarkwinkelmann

Now compatible with beta 8, for your greatest pleasure 👌

With @Toby having just added translations caching in core, you can already expect Linguist to break again whenever that feature is released in a next Flarum upgrade. But I suppose it won't be before beta 9, so I have some time to find a way to make it work...

clarkwinkelmann

packetmane yes it's broken and was actually expected and announced back when b8 compatibility was added:

clarkwinkelmann With Toby having just added translations caching in core, you can already expect Linguist to break again whenever that feature is released in a next Flarum upgrade. But I suppose it won't be before beta 9, so I have some time to find a way to make it work...

The relevant GitHub issue can be found here flagrow/linguist8

I will add a message in the Linguist discussion to warn other people who might have missed the earlier warning.

Patbox

Hello, it's possible to export translation?

clarkwinkelmann

that's not a feature that's built-in at this time.

But you can easily use a database tool like phpMyAdmin to export the content of the flagrow_linguist_strings table and import them back on another install.

manny

Do you plan to include translations for e-mail templates too? I think, it's currently hard coded in english in those templates as discussed in this post: https://discuss.flarum.org/d/17802-beta-8-email-not-translated/8

clarkwinkelmann

manny For now there's no plan to allow translating anything that's not going through Flarum's translator. That could really hurt compatibility with other extensions that use emails as well.

Can't you use Pretty Mail or Pretty Mail + Linguist to achieve it though ?

manny

clarkwinkelmann

Good suggestion, this would work. Thanks! 🙂

szrcmk

Bazaar plugin does not accept translation
http://prntscr.com/mf3rfy

clarkwinkelmann

szrcmk it looks like Bazaar translations aren't loaded inside Flarum to begin with. What language pack are you using ? Did Bazaar text appear prior to using Linguist ?

Did you try clearing the cache manually, via the admin or the command line ?

Could you post the output of php flarum info ? It would give us flarum version, linguist version and which language pack(s) you have.

What you're doing there in Linguist shouldn't make any difference, English should be used by default if Bazaar isn't translated by your language pack and English text contains the same string you're trying to set.

ThomasBang

@clarkwinkelmann

How about adding "default fallback". So as long as the field is empty, it'll fall back to english, which everyone supports atm.

It's a huge headache with extentions that isn't multilingual.

clarkwinkelmann

ThomasBang Flarum should fallback to english automatically, but doesn't do so in the front-end as reported in this issue flarum/core1774

And it looks to me that fixing the issue in Flarum directly will require less work than trying to implement a fix via an extension like Linguist. The underlying problem in based on the fact that if you cross-reference translations that exist in English versus those that don't exist in English to find the ones to override, it goes over the standard memory limit and crashes PHP. If someone got any idea on a memory-frienly approach, feel free to add your thoughts to the Flarum issue linked above.

If you really need to fix some extensions, you could filter translations by extensions, then copy every English translation you need manually to "default translation".

clarkwinkelmann

Public service anouncement: as expected (since the beta 8 release already and announced above) this extension is affected by a breaking change in beta 9 and will require some changes to be compatible.

I recommend not installing the current version at all on beta 9 as it might mess up with the new translation logic.

You can follow the GitHub issue here: flagrow/linguist8

I'll try to take a look in the next few weeks. You may contact me directly if you'd like to sponsor the update to get it sooner 😉

Or if someone wants to have a try at a PR let me know so we don't start two different updates.

I'm adding the incompatible tag here in the meantime.

Alkir

clarkwinkelmann It will wait, because without this extension, my site has lost MY translation

Alkir

And if the opportunity to somehow pull out my translation, while you solve this problem?

clarkwinkelmann

Alkir you can extract your translations from the flagrow_linguist_strings database. Then you'll need to write a script or do some manual editing to put it into a Yaml file for a translation.

It's possible others have been able to continue using Linuist on beta9, by manually clearing the cache after every change. But I'm not 100% sure because nobody reported here.

ram0ng1

clarkwinkelmann

I just did a clean install, I installed the Flagrow Linguist, I activated it, then imporeti the old table to the new database.

worked perfectly on beta9

I used laragon to import with 100% certainty

nxta

Now that this extension is incompatible, what's the recommended way to change, for example, the text in the search bar, if any?

clarkwinkelmann

nxta it appears to actually work with beta 9, there are just some issues with translations caching that require manual cache clearing.

The other solutions involve creating a language pack, or loading a custom translation file from extend.php.

Tirual

clarkwinkelmann I can't seem to get it to work at all at beta 9, when i enable it inside my extensions it doesn't show any of my translations on my site after i cleared cache and everything?

Do you have to make a new clean install at beta 9 for it to work or?

So maybe if i removed it completely and installed it again on beta 9 and made my translations again that would work? What worked for you?

nxta

There is Linguist by Flagrow, but it's currently incompatible with beta 9.

clarkwinkelmann solutions involve creating a language pack, or loading a custom translation file from extend.php.