Home Documentation Tutorials Basic configuration after installing Joom!Fish
Basic configuration after installing Joom!Fish PDF Print E-mail
Written by Carolien de Groot   
Saturday, 17 October 2009 23:04

Congratulations, you installed Joom!Fish and we hope you're going to enjoy the component. Before we're going to translate the content, we walk through some basic setup choices.

The default settings right now are the following:

  • if a visitor enters your website, he/she sees the website in the language according to the browser settings.
  • the language part in the URL is represented as a folder, so you'll see : www.mysite.com/langprefix
  • if there is no translation available your visitor sees a message 'there are no translations available' above the original article, which is displayed too
  • the language selection is represented with flags

To change them you need to be in different places in the Joomla! backend, so we're going to do them step by step.

If a visitor enters your website, he/she sees the website in the language according to the browser settings

To change this, go the the JFrouter plugin, which is in extensions > plugin manager > system plugins. This plugin should be the first system plugin, so you can check that right away. If you open the plugin, you'll see the parameters.

Set 'Enable Language determination' to yes, and then you can play with the settings for 'Language selection for new users'. This parameters has three options:

  • Ordering of languages in Joom!Fish component. You can use this setting if you want your second language to come up first. Then you need to set the language you want to show first to first in ordering
  • Browser settings. This is the setting we have now. If you have a website with German and English, then everyone with an English browser will see English first, and everyone with a German browser will see German first
  • Site default language. The site default language will always come up first. The site default language must be the language you've written your articles in.

Press save or apply to save your settings.

The language part in the URL is represented as a folder, so you'll see : www.mysite.com/langprefix

Joom!Fish also offers the option to display the different languages according to (sub)domain. If you want to use (sub)domains you need to create those subdomains first with your hosting. You can also choose to change the 'langprefix' in a full language name for example.

So how do we do that?

We go to the JFrouter again (or we're still there) and see the option 'use SEF prefix or subdomains'. Right now it's set to prefix and set it to sub-domain if you want to use other domains or subdomains.

In the following boxes you can set whatever must be visible in the URL if a users selects that language. So if you selected SEF prefix in the above setting, then fill in the boxes at SEF prefix. If you selected sub-domain then fill in the boxes at Sef subdomain.

Press save or apply to save your settings.

If there is no translation available your visitor will see a message 'there are no translations available' above the original article, which is displayed too

We can change this behaviour in the Joom!Fish parameters. These parameters you can find in the Joom!Fish Control Panel. When you're in the Joom!Fish Control Panel as Super Administrator you should see a parameters button in the top right bar, where you'll usually see the save buttons.

If you open this button then you'll see all parameters. The first parameter is the one whe should have. It's called 'What to show if there are no translations available'. The possible options are:

  • The original content, so there is not message or anything to show that there is no translation available
  • Default text, this you can set up in the box below. Note that you cannot translate this text
  • The original content with information. The information string is taken from the Joom!Fish component language files. You can also set translate this string in the Language configuration (components > Joom!Fish > Languages). There you need to open the config of a language. There you need to fill in the default text
  • The original content with information offering available translations too. This uses the same information string as stated above and when other translations are available, the flags for those translations will be visible.

You can select the option you want and then press 'save' to save your option.

The language selection is represented with flags

The language selection on the frontend is displayed through the language selection module. In this module we can change how we display the language selection. To change this, go to the module manager (extensions > module manager) and open the language selection module.

The language selection module is by default positioned in position 'user 4'. If you don't see the module on the frontend then please select a position which is available in your template. You can see all your available positions by entering: www.mysite.com/index.php?tp=1

The main parameter in the language selection module is the 'appearance of language selector'. You have the following options:

  • Dropdown of names
  • Dropdown of names with current language flag. The behaviour of the flags along with the names are different per browser. With Firefox you only see the flag of the current language, with IE you see all flags besides the names.
  • ul-list of names. This is a list with bullets with the names of the languages. You can change those names in the language configuration (Components > Joom!Fish > Languages). You need only to change the name in the name box.
  • ul-list of names with flags. It's the same as the above, with a flag displaying besides the name
  • ul-list of flags. This is a list with bullets with the flags representing the language displaying
  • Raw display of images. Here you'll only see the flags (or other images you specified in the language configuration under image) without any markup. This is the default setting of Joom!Fish

Joom!Fish comes with its own CSS for the language selection module. In the advanced parameters you can select whether or not it must be used.

Conclusion

Here you've seen several places in Joom!Fish where you can change the behaviour and appearance of your translations to your visitors. These 3 places: JFrouter plugin, Language Selection Module and the parameters in the component are the areas to change settings in Joom!Fish. You can find more information about the settings in the club documentation pdf or in the video's about the language selection module and about the configuration of Joom!Fish

 

0 Comments

joomfish_2.2_download

Selected Contributors

From the Joom!Fish Core team (Alex, Geraint & Carolien) a big thank you to all the people of the JoomFish community!
A special thank to Harri for the moderation in the forum and all our translators.