Multilingual Modules

Introduction

jDownloads supports Multilingual Modules. In this article it is assummed you have already set up your site for multilingual Categories and Downloads. 

For more information see Associations & Multilingual Support (opens in a separate window/tab)

In this article we will be using the jDownloads Top module as an example.  This module lists those Downloads that have been downloaded the most number of times.

Important You will still need the default jD menu item 'List All Categories' in the regular Main menu.  This may be a 'hidden' menu item. Please see Multilingual and Menu Items (opens in a separate window/tab) for more details.
 

Preparation

Most Modules have some optional text strings in the module tab that will benefit users by setting in the relevant language individually.  This is accomplished by using the 'language plugins' such as
{en-GB}English{/en-GB} {de-DE}Deutsche{/de-DE} and so on.

Most modules have text fields such as  'Version prefix',  'Label for Hits', 'Text between filename and category name' and  'Characters added at end of a shortened title'.

Because the same text strings will be required for each language in each module then it is sensible to preare a text file that contains the required text.  It can then be 'Copied and Pasted into place.

NOTE The Tree Module does not have any User edittable text fields so skip this section if you are just setting up that Module.

Prepare a txt file with lines such as:

Text Before {en-GB}This is Text Before{/en-GB}{ar-AR}هذا نص قبل{/ar-AR}{de-DE}Das ist Text vorher{/de-DE}{fr-FR}Ceci est le texte avant{/fr-FR} 

This allows a quick Copy and Paste from the text file into the relevant text field in each module.
text before02

Create Multilingual Module

The first step is to go to button modules and select mod multi04
This will open up the admin part of the standard module as illustrated opposite.


The next step is to make a copy by using the 'Save as Copy' button.
mod multi01
This will create a new invocation of the module with a name such as jDownloads Top (2) as illustrated opposite.mod multi02

Module Tab settings

1. Change the Title field to something appropriate.

2. Select the target position in your template.

3. Change the Status to Published.

4. And most importantly,  select the target Language which in this case is English.

The Text Before and Text After options, which appear at the start and end of the list, both support the multilingual plugins as illustrated below.

Because we will be making a copy of this  'multilingual' module for other languages then it is convenient to add any required text for these two options as illustated below.
mod multi03
mod multi04Amod multi04B
There are some optional text strings in the module tab that will require setting in the relevant language individually.  These are the options:
(a) Version prefix,
(b) Label for Hits,
(c) Text between filename and category name.

Menu Assignment

This is a key step as it controls which pages the module will appear upon.

First make sure that you select the option 'Only on the pages selected'. button pages only

In this example, which is setting the English Language version, then ensure that only the EN-GB menu items, as indicated with the relevant flag flag en , are selected.

Ensure those for any other language are NOT selected.

Always set the List All jD Cats in the Main Menu.
mod multi06

Add Text field info

Add in all the "language plugin" information that was prepared earlier in a text file with Copy and Paste.  Or you could type in directly each time!!

Then of course do a Save & Close after adjusting any of the other options in the Module tab.

ColinM December 2020 Updated July 2021

Tags: index

Print Email