User Manual

Sets of Translations

As stated in the Introduction, when you translate content into several languages in Joomla!, what you are doing is creating a different item for each language. Each item is assigned to a language and has the same content (translated) that another item in another language. For example, suppose you have a website with three languages, English, Spanish and French. For each content (category, menu, banner, article ..) you have to create three items, one for English, one for Spanish and one for French. And these three elements are related and have many things in common.

In KMFasTrans we have created the concept of Set of Translations (or Translations Set). A Set of Translations is the set of items representing the same content in different languages. In the example above, if the items have the id's 6 for English and 84 for Spanish, we will have a Translations Set composed of 2 items whose id's are 6 and 84. The figure below shows what we will see at the Translations Dashboard Screen:

um set of translations 1

As you can see in the figure there is a row for the id 6 with title "Australian Parks". There are also several columns, which contain information of the items in English, Spanish and others, and the first one contains the information of the set of translations.

(For a detailed explanation visit KM FasTrans Translations Dashboard Help).

Hovering over each of the icons contained in these language columns you will see an explanatory text about its content and where appropriate a description of the action that will be taken when you press that id or image.

For example, if you hover over the edit icon of English column you would see:

um set of translations 2

If you hover over the two arrows icon in Spanish language you would see:

um set of translations 3

and so on.

Translation Set column

The Translation Set column shows two attributes, the Set Number and the Set Status.

The Set Number is a number assigned by KMFasTrans when creating the set of translations. It is a unique number for the entire web site and can not be changed. If you delete a set of translations, its number will not be reused.

The Set Status indicates the current status of the set of translations and is identified by an image and (hovering over the image) a text is displayed as follows:

    • Status: Not completed.

um set of translations 4

This state has two possible causes:

    • The set of translations lacks at least one translation id for some of the published content languages.
    • Not all id's of the set are published (This depends on the value of the option "Include published elements only for "Completion" of a Translations Set").
    • Status: Completed.

um set of translations 5

 

The set of translations has been completed when it contains as many translation id's as published content languages, and also all such id's are published (This depends on the value of the option "Include published elements only for "Completion" of a Translations Set"). As you can see in the example above, when you hover over the status image, the status and the completion date and time will be shown.

Each time you change the status of any id of the set to "Unpublished" or "Trashed", the set status will change to "Not Completed" regardless of the status it had before(depending on the value of the option mentioned above). When changing the status of an id of the set to "Published", the set status will change to "Completed" if it contains as many id's as published content languages and all of them are published(depending on the value of the option mentioned above).

Warning: from version 1.4.0 a set will not be allowed to contain an id assigned to language 'All', since by definition if an id is assigned to language 'All' it will be shown on all pages, and thus not required to be translated. For example, the module containing the login form will normally be assigned to language 'All', since the translation into every language is automatic using the standard language files of Joomla.

    • Status: Modified.

This functionality is only supported on KMFasTrans PRO. Subscribe now!.

um set of translations 6

 

The status "Modified" means that after completing the set of translations, at least some element of the set has been modified using the KMFasTrans edit form or the native Joomla editing form or the front-end editing form.
If the change is permanent, you can change the set status to "Completed" by clicking the Set Status icon.

If you changed the status of the modified id to unpublished, by changing its status to published, the set status will also change to "Completed"(depending on the value of the option mentioned above).

Creating a Translations Set

When you start to use KMFasTrans there are no set of translations. For example you could begin to translate the id 67 of the following figure:

um set of translations 7  

A set of translations can be created in two ways:

    • Manually

In the example in the figure above, to manually create a set of translations that contains for example the ID 67 in English and an ID in Spanish, you need to have previously created an ID in Spanish that is the translation of the ID 67 in English. Suppose you already have it and that its ID is 141. To create the set of translations you only have to click the link icon in the column Español (ES) and the following screen will display:

 um set of translations 8

Warning: the drop down list "Select Association:" must be set to "Not associated" to show only items that do not belong to any other set of translations. If you choose the value "Any", the list will contain all items in that language, whether or not they belong to another set of translations. In this case for each associated item you will see an association icon in the column 'Association' and you can see its associations by hovering over the icon. If you choose an item that already belongs to another set, such item will be disassociated from that set and associated to the set you are creating or updating.

By clicking on the title of the item you want, a set of translations will be created containing the two elements, 58 and 141. The Translations Dashboard screen will now show as follows:

um set of translations 9

As you can see, the set of translations just created has the number 165 and it is "Not Completed" because there are no translation into the other languages.

    • Automatically

This functionality is only supported on KMFasTrans PRO. Subscribe now!.

A set of translations is created automatically when you create a new item as a translation of another one using KMFasTrans New / Edit Translations form and there is no already a set.(If the set already exists it will be updated by assigning to it the new item just created).

You only have to click the create icon in the column whose language is the one in which you want to create the new item that is the translation into that language of the item in the row.

For example, in the above figure you can see that there is no translation into Italian of the Item with ID = 67 titled "Utility Modules". By clicking the edit icon in the column "Italiano", the following screen will be displayed:

(For a detailed description of the use of the edit screen visit KMFasTrans New / Edit Translations Help).

 um set of translations 11

On this screen fill all required fields to create the new item using the aids provided (such as the Translate and the Copy buttons). When you are ready, click any of the buttons "Save", "Save & Close" or "Save & Next", and at that time, in addition to creating the new item, it will also be created the set of translations if did not exist, or in the case of the example, the existing set (number 165) will be updated with the new Item just created. 

If everythig went correctly, the Translations Dashboard screen will now show as follows:

um set of translations 12

You can see that there's a new item in Italian language, whose ID is 143.

Deleting a Translations Set

A Translations Set is deleted when you unassign the second last translation item. By eliminating the set, the last two elements of the set will stay but not assigned to any set, ie not associated.

In addition to delete a set manually as described, a set of translations can also be deleted automatically when you change the language on an item in the KMFasTrans New / Edit form under certain conditions. For more details see the section "Language field" in KMFasTrans New / Edit Translations Items Help.

Modifiying a Translations Set

The set of translations is modified each time you change one of the items it contains. It is also modified when you associate or disassociate an item. Associating an item to a Set is performed in the same way as described in the preceding paragraph "Creating a Translations Set". To disassociate an item from the Set, just click on the broken link icon in the language column that contains the item you want to disassociate. Before dissociating the item you will see a confirmation screen.

Translations Set Details

By clicking on the Set Number you will see the details of its content as shown below:

um set of translations 10

The first five lines show attributes of the Translations Set:

    • Created on:

Date and time when the set of translations was created.

    • Current status:

Current status of the set. The set is usually created in status "Not Completed". It can be created in status "Completed" if there are only two languages.

    • Last status change: self-explanatory
    • Last action taken:

It can be Assign, Unassign or Modification of an Item.

    • Last element modification:

Indicates who, when and which item was last modified.

The list below the first five lines contains the elements of the set. The values for the columns are self explanatory.