User Manual

Permissions Management

KMFasTrans supports the management of native Joomla permissions and also introduces a new layer of language-level permissions. Thus, the actions permitted to a user on languages and elements of a language will be divided into two main categories:

A. Language Permissions

These are the com_languages component permissions but are managed within KMFasTrans. They affect the management of languages only, ie Installed Site Languages, Installed Administrator languages, Content Languages and Overrides. You can allow or deny management of languages for a user group. If you deny, the users of that group will not have access to these functions. Actually they will not see the links neither in KMFasTrans submenus nor in pages.

A new button 'Language Manager Options' has been added to the Control Panel toolbar to configure the 'Language Permissions'. 

B. Translations Permissions

These are permissions to create, delete, edit, edit state or edit own of translations elements and are a combination of the following levels of permissions:

      • 1. KMFasTrans component permissions. These are the highest priority translations permissions. If an action (such as editing the state) is denied in KMFasTrans it will can not be taken at any level.
      • 2. The permissions of the Element-Component. This refers to the component that contains the items being treated. For example com_content if we are creating or editing an article, or com_banners if we are editing or creating a banner.
      • 3. The permissions of an specific language. For example, you can not edit an article or any other item in English if you have not edit permission for English language.

Permissions of of an specific language are only supported on KMFasTrans PRO. Subscribe now!..

      • 4. The permissions of a particular item. It applies to articles or categories. You can not edit a particular article if you do not have permission to edit this article.

Using these two categories and four levels of permissions you will have great flexibility in determining what a translator can do. You can deny all administration permissions for all components except KMFasTrans, only allowing users to create new translations or edit existing ones. In terms of security this is similar to creating translations from the front-end.

For example you could set up a group of translators who only are allowed to translate banners to the French language, and unable to publish or unpublish the banners they create. To do this you have to:

    • Allow Access Administration Interface to this group in KMFasTrans Options.
    • Deny Access Administration Interface to this group in Language Manager Options of KMFasTrans.
    • Deny Delete, Edit and Edit State to this group for every language except French in KMFasTrans Content Languages.
    • Deny Access Administration Interface to this group in every component including com_banners.
    • Deny Create, Delete, Edit, Edit State, Edit Own in every component except com_banners.
    • Allow Create, Delete, Edit and deny Edit State in com_banners.

When a user of this group access the administration it will see one screen similar to the following one:

 

KMFasTrans permissions only

 In the above image you can see several things:

1. The user only has access to the component KMFasTrans, within it, only to Control Panel and Translations Management Dashboard. He is not allowed to manage languages because the Access Administration Interface has been denied.

2. The element types he can select in the - Select Element Type - dropdown list are Categories and Banners only (Banners is selected in the image). 

3. In the listing you can see that all languages except French are in gray, ie nothing can be changed.

3. The status in the column Frances (FR) is also in gray because we have denied Edit State for this users.

 

With respect to Translations Permissions, if you do not have permission to take a certain action, you can not click on the text or image that enables the action. Furthermore, in order to recognize that you do not have permissions, the text or image will appear in gray and in most cases by placing the mouse over the text or the image, an explanatory text will be shown.

To assign permissions to users, you must create one or more user groups and assign each of them the desired permissions.

How to create a group could be as follows:

a). Go to Users-> Group-> Add new group.
b). Set as Group Title: "Translators".
c). Set as Parent Group: "Manager".
d). Save and go to Users-> Access Levels-> New Access Level.
e). Set as Title Level "Translations" and check the "Translators" checkbox.
f). Go to Components-> KM FasTrans PRO-> Control Panel and click Options on the toolbar.
g). In the Permissions tab and in the group Translators, the Action 'Configure' should be 'Denied' and the Action 'Access Administrator Interface' must be 'Allowed'. The remaining actions, 'Create', 'Delete', 'Edit' and 'Edit State must be configured as appropriate for the user group that is being defined.
h). Click 'Save' and make sure that the settings are correct.

If you want to allow or deny language permissions for this group you have to access tha Language Permission screen:

a). Go to Components-> KM FasTrans PRO-> Control Panel and click Language Manager Options on the toolbar.

The Language Manager Options screen will open and you can configure the permissions of the grupo in the Joomla Language Manager standard way.

Now you can register a user belonging to the group 'Translators' and access to the Joomla Administration. With this basic configuration the user can do all that was allowed in each component. You can refine the group permissions by setting the desired options in each component.

Then, if you want to, you can set permissions for each language for that user group. To see in detail how to do this see KM FasTrans New/Edit Content Languages Help.

Setting Language Permissions.

Language Permissions are set from within KMFasTrans. If allowed, you simply need to click on the 'Language Manager Options' button on the right side of the toolbar of any screen except editing. After clicking on the 'Permissions' tab, the standard Joomla permissions management screen will be displayed.

Setting permissions of KMFasTrans.

KMFasTrans permissions are configured as those of any component. If allowed, you simply need to click on the 'Options' button on the right side of the toolbar of the Control Panel or Translations Management Dashboard screens. After clicking on the 'Permissions' tab, the standard Joomla permissions management screen will be displayed.

Setting permissions of a particular language.

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

Permissions of a particular or specific language is an important feature of KMFasTrans PRO. This allows users groups access to different sets of languages. Permissions for a particular language are set as follows:

If allowed, on the 'Content Languages' Screen click on the title of the language or enable the CheckBox and click Edit in the toolbar. This opens a window where you can select one or more user groups (previously created).

For each user group you can set the following permissions:

    • Delete
    • Edit
    • Edit state

Setting Language Permissions has the following effects on the operation of KMFasTrans:

Language Component Permissions Effects in Installed languages Effects in Content languages Effects in specific Content Language Effects in Overrides Effects in Translations
Access Create Delete Edit EditState
N - - - - No access No access No access No access No effect
Y N N N N All actions denied All actions denied All actions denied All actions denied No effect
Y Y - - - No effect Can create a language.
Can create Default Home elements.
All actions denied Can create an override No effect
Y - Y - - No effect Can empty trash of any trashed language (*). Can empty trash of any trashed language (*). Can delete an override No effect
Y - - Y - No effect Can edit any language (*) Can edit language (*) Can edit an override No effect
Y - - - Y Can change default language for any language Can publish, unpublish, trash and untrash any language (*) Can publish, unpublish, trash and untrash any language (*) No effect No effect

(*) Subject to language specific permissions 

 

Setting KMFasTrans Component Permissions has the following effects on the operation of KMFasTrans:

KMFasTrans Component Permissions

Effects in languages

(Installed, Content, Overrides)

Effects in Translations Dashboard Effects in Translations Edit or Create Component Access
Access Create Delete Edit EditState
N - - - - No effect No access No access No effect
Y N N N N No effect All actions denied. Can see elements in read only mode All actions denied. Can see elements in read only mode No effect
Y Y - - - No effect Can assign translation Items for any language (*)&(**) Can create new Items  (*)&(**) No effect
Y - Y - - No effect Can unassign translation Items for any language (*)&(**) No effect No effect
Y - - Y - No effect Can access translation Items for editing (*)&(**)&(***).
Can change translation Iitems (*)&(**).
Can edit translation Items (except status) (*)&(**)&(***) No effect
Y - - - Y >No effect Can publish, unpublish and trash translation Items (*)&(**)&(***) No effect No effect

(*) Subject to language specific permissions

(**) Subject to Component-Element permissions

(***) Subject to Item permissions

Setting Element-Component Permissions has the following effects on the operation of KMFasTrans:

Element-Component Permissions

Effects in languages

(Installed, Content, Overrides)

Effects in Translations Dashboard Effects in Translations Edit or Create
Access Create Delete Edit EditState EditOwn
N - - - - - No effect Will not show the element type in the Element Type drop-down list No access
Y N N N N N No effect Can not change Item (Id)  status
Can not change Set status.
Can not assign translation Items
Can not unassign translation Items
Can not change translation Items
Can see any Item
Can not edit any Item
Can not create new Item
Y Y N N N N No effect Can assign translation Items for any language (*) Can create new items  (*)
Y N Y N N N No effect Can unassign translation Items for any language (*) No access
Y N N Y N N No effect Can access translation Items for editing (*)&(***) Can edit translation Items  (*)&(***)
Y N N N Y N No effect Can publish and unpublish translation Items in any language (*)&(***) No access
Y N N N N Y No effect Can edit the own Items only.  Can edit the own Items only. 

(*) Subject to language specific permissions

(***) Subject to Item permissions 

Setting particular Language Permissions has the following effects on the operation of KMFasTrans: 

Language Specific Permissions

Effects in languages

(Installed, Overrides)

Effects in Content languages Effects in Translations Dashboard Effects in Translations Edit or Create
Delete Edit EditState
N N N No effect All actions denied for the language. All language specific actions denied No access
Y N N No effect Can delete the language. Can unassign translation Items of the language (***) No acces
N Y N No effect Can edit the language. Can edit translation Items of the language(***) Can edit translation Items of the language (***)
N N Y No effect Can edit state of the language. Can publish, unpublish and trash translation Items of the language (***) No access

 (***) Subject to Item permissions 

Setting Item Permissions has the following effects on the operation of KMFasTrans:

Item Permissions Effects in Installed languages Effects in Content languages Effects in specific Content Language Effects in Translations Dashboard Effects in Translations Edit or Create
Delete Edit EditState
N N N No effect No effect No effect Can not assign, unassign, change, publish, unpublish or edit the Item No access
Y - - No effect No effect No effect Can unassign the Item No effect
- Y - No effect No effect No effect Can edit and change Item Can edit this Item
- - Y No effect No effect No effect Can publish, unpublish and trash the Item Can publish, unpublish and trash the Item

 Applies to: Articles and Categories