-
Notifications
You must be signed in to change notification settings - Fork 26
Installation instructions
Installation instructions for JoomFish (jf-future) on Joomla 2.5
- Joomla 2.5.x
- PHP 5.2 (ideally 5.3)
- mysqli driver (not mysql, note the ending i) - just go to Joomla 2.5 Global Configuration —> Server —> Database Settings and be sure that the database Type is Mysqli
- The Joomla multilingual system present in the core is not compatible with translations made using JoomFish. This means you must either use JoomFish to translate your contents or you must use the core Joomla way to create a multi-lingual website. If you choose to use JoomFish you have to make sure to disable the core Joomla Language Switcher module (Backend > Extensions > Module Manager > select the modules "Language Switcher" and unpublish them) and disable the Language filter and Language code system plugins (Backend > Extensions > Plug-in Manager > select the plugins "System - Language Code" and "System - Language Filter" and unpublish them).
- Set Error reporting to Maximum in the Global Configuration (Backend > Site > Global Configuration > Server > Error Reporting = Maximum).
- Set Debug System to Yes in the Global Configuration (Backend > Site > Global Configuration > System > Debug System = Yes).
- 1 - Get jf-future from GitHub: https://github.com/JoomFish/jf-future (There is a link to a zip available if you don't want to use git).
- 2a - Use the zip file to install: Install the component as you're used to: Backend > Extensions > Extensions Manager, browse to the downloaded zip file and click Upload & Install [OR]
- 2b - Don't use the zip file, use the directory created from the GitHub repository: Install the component with the Install from Directory in the Extension Manager.
This installs the component, the module (mod_jflanguageselection) and the three plugins (jfdatabase, jfrouter and jfoverrides) in one go.
Check whether the frontend JoomFish language selector module (Backend > Extensions > Module Manager > "JoomFish language selector") is published, assigned to relevant pages and published on a position that appears in your template.
- Status = Published
- Choose a position, e.g. "position-6" on Joomla's default template Beez
- Assign the module, e.g. "On all pages" (or at least a selection)
Check the Content Languages (Backend > Components > JoomFish > Content Languages): only active languages are shown in the frontend. Make sure each language has an Internal Title and a Native Title.
Disable the core Joomla Language Switcher module and the Language filter and Language code system plugins. The core Joomla multilingual system is not compatible with Joomfish translations so you must decide which system you will use on the site. See pre-requisite nr. 4.
The Joomfish system plugins need to come before all other system plugins and their ordering numbers must be: 1 - "Joomfish - Basic Router", 2 - "Joomfish - Database Abstraction Layer", 3 - "Joomfish - Core overrides". All other system plugins need to have ordering numbers higher than 3. Find your system plugins here: Backend > Extensions > Plug-in Manager > Dropdownbox: - Select Type - = system.
When you install a new language after you have installed JoomFish the language automatically shows up in the Content Languages screen (Backend > Components > JoomFish > Content Language). You may want to change the Internal title (title of the language used in JoomFish' backend) and the Native Title (title used in the language selection module in the frontend). The language is only shown in the frontend language selection module if it is set to active (check the box and save).
Do NOT use multiple languages with the same prefix, e.g. en-US and en-UK, this will confuse joomfish as it uses prefix to switch languages and on multiple other places
Currently the installation manifest (intentionally) does not use the "upgrade" method. This means that when you want to install a later version of jf-future you have to uninstall JoomFish and then install the later version. Uninstall JoomFish via Backend > Extensions > Extension Manager > Manage > select: Joom!Fish (the component) and click uninstall. Database entries are kept, only the JoomFish files (component, module and plugins) are removed.