User Manual

Installation/Unistallation

Installation

KMFasTrans is composed of a component, a plugin and one or more modules. Installation is performed following the same procedure as the installation of any component, using the Joomla installer. When installing the component, the plugin and modules are also automatically installed without additional intervention.

From version 2.3.0 when you install KMFasTrans PRO for the first time or you upgrade to PRO from FREE, the installation process will autonatically create sets of translations based on existing Joomla associations. As this can be time consuming, especially in large websites with many items, you can override this process by modifying the installation file. Just open the php file named careate_sets.php in the root of the zip file and change 'YES' by 'NO' in the line "define('KMFT_CREATE_SETS', 'YES').

If you are installing for the first time, the installation process will check if the version of KMFasTrans to be installed is compatible with the version of Joomla, and if so, it will create all tables and data necessary for proper operation.

If it's an update, that is, it is not a first installation, KMFasTrans will keep all data as they were before the upgrade. The upgrade process checks, just like in the installation, if KMFasTrans version is compatible with the version of Joomla, and will also perform the following additional checks:

        • The version to be installed is equal to or higher than the installed version.
        • FREE version is not installed over PRO version.

If any of the above checks fails, the process aborts and displays an error message or a warning. The state existing prior to the installation or upgrade remains unchanged.

If you do not have InnoDB as storage engine atleas for table "menu_types" you will get the following error:

WARNING: You need to have the table option storage engine = InnoDB in MySQL at least in table "menu_types", otherwise the installation would fail. If your MySQL versión is 5.5.5 or higher this is the default. If it is lower you will have to do it manually. You can use PHPMyAdmin.

The way to correct this using PHPMyAdmin is as follow:

1 Open PHPMyAdmin and go to menu_types table.

2. Click Operations.

3. Select InnoDB as Storage Engine in the dropdown box

4. Click Go

The image below shows these steps:

phpmyadmin

When you change this option in the database the safest way to proceed is to uninstall the extension and install it again.

If you have installed KMFasTrans PRO under a Joomla version lower tha 2.5.4 you MUST disable the plugin option 'Language Permissions' BEFORE upgrading to Joomla 2.5.4 or higher. Otherwise the Joomla upgrade will finish in error. Once the Joomla upgrade has finished you should enable 'Language Permissions'.

If you had defined language permissions before the upgrade, such definitions will be maintained and made available again after the upgrade once you have enabled the option.

Installing support for third-party extensions

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

For KMFasTrans to know third-party extensions you need to install the proper support plugin for each third-party extension you want to use. When installing the plugin, the Joomla, KMFasTrans and third-party extension versions are checked and if incorrect the plugin is not installed or is not enabled if already installed.

If the plugin installation is sucessful, all extension elements supported will be accessible on the filter - Select Element Type -. For example, once the plugin for K2 support is installed that filter will show the following:

K2 elements

Extension specific Modules and Menu Items will also be available when selecting J-Modules or J-Menu Items in the filter.

You can view the supported third-party extensions and their versions and download the support plugin inThird-party extensions support

Uninstallation

KMFasTrans is uninstalled just like any component, but you only need to uninstall the main KMFasTrans component. By doing so, the plugin and all modules will also be unsinstalled.

You should not uninstall the product unless you do not want to continue using it anymore, because the uninstall process will remove without notice all tables and all data, and can not be recovered.

Otherwise you must upgrade. That is, to upgrade from one version to a higher version FREE or PRO, or to upgrade from FREE to PRO.

Needless to say that you should make a backup copy of the website prior to any installation or uninstallation of the component.

Post-First Installation

After the first installation it is necessary to perform the following tasks:

    • Set the appropriate language in the existing menus.

When you install the product the field language is added as a required field for menus, so you can easily control the language of the menu-items associated with a menu. The installation process sets the value 'All' for the language in all existing menus, and you need to change it manually to get the right one.

To do this you must edit each existing menu using the standard Joomla menu edit form. The KMFasTrans plugin will introduce a drop-down list of languages where you must select the appropriate language for the menu.

The menus you create later with KMFasTrans as translations to existing menus will automatically have the language in wich they are created.

    • Establish multi-language "infrastructure" if does not exist yet.

This is done by clicking 'Create Default Home' button (or 'Create Multilingual Infraestructure' button) on the toolbar of the Content Languages Screen.

This "infrastructure" consists of the following:

    • A menu with title "Menu-All", menu type "defaultallmenu" and type "Category List".
    • A menu item with title "Menu Item-All" in the menu "Menu-All" as the default Home page for language "All".
    • A menu module with title "Menu Module-All" in the position "default_all_menu_module_position" (a fictitious one) linked to menu "Menu-All" and unpublished.
    • A category with title "Root Category-All-Articles" that is required for "Menu Item-All".

Each time this button is pressed, KM FasTrans will try to create these four items and will create only thouse that do not exist yet. You will be informed of the items that already existed and those just created. You can also know at any moment the status of these items in the control panel screen.

Once these four items are created, your site is ready for multilanguage. You don't have to use these items for anything ( and is better if you don't use them at all as if problems arise you could delete them and recreate pressing this button. An exception to this might be the category, which may be used freely if needed). If you need a menu, menu item and menu module assigned to language 'All' you can create as many as you need without changing anything of those four items that were created automatically.

If you already had this infrastructure in place before installing KM FasTrans, you can just ignore the warning messages, or you can click on the button anyway because it will not affect what you had previosly, the only change will be that the default home page for language 'All' will be the new automatically created menu item with title "Menu Item-All". You also can use the proper option to disable the warning message.

Remember to publish the Language Filter plugin. If you want to have translated content switching when switching languages you have to set the value 'YES' for the option "Menu associations". If you forget to do it at first then you will have to re-edit all menus to create associations.

If you want to switch content at the article, contact or newsfeed level, you have to publish the KMFT Language Switcher and assign the position and pages as you want. Remember that this module requires menu associations to be in place to work properly.