| 1 |
INTRODUCTION
|
| 2 |
============
|
| 3 |
Drupal module : localizer
|
| 4 |
Drupal version : 5.x
|
| 5 |
Current version : 3.0
|
| 6 |
Date of release : 2008-02-05
|
| 7 |
Author : Roberto Gerola, roberto.gerola@speedtech.it , http://www.speedtech.it
|
| 8 |
Support, documentation and testing : Edward Ray, http://drupal.org/user/93820
|
| 9 |
|
| 10 |
This file presents "quick start" instructions for installing/upgrading to
|
| 11 |
the Localizer 3.x module. More detailed documentation for installing and
|
| 12 |
configuring Localizer can be found at http://drupal.org/node/103419.
|
| 13 |
|
| 14 |
|
| 15 |
Install instructions (New installation: Localizer 3.x on Drupal 5.x)
|
| 16 |
|
| 17 |
0. Make sure you have a working Drupal 5.x site.
|
| 18 |
1. Backup your Drupal database (and, as a normal precaution, your whole site
|
| 19 |
if you haven't done so for some time).
|
| 20 |
2. Download the various Localizer 3.x components. This includes Localizer
|
| 21 |
itself, which can be found at http://drupal.org/project/localizer and flags
|
| 22 |
and patches, both of which can be found at
|
| 23 |
http://www.speedtech.it/drupal-localizer.
|
| 24 |
3. Extract the localizer-5.x-3.x.tar.gz archive under
|
| 25 |
sites/all/modules/ (create the modules directory if needed). This will
|
| 26 |
create the localizer directory and put the localizer application files in
|
| 27 |
sites/all/modules/localizer.
|
| 28 |
Under sites/all/modules/localizer, extract the flag and patch archives. This
|
| 29 |
will create the directories flags, menu and taxonomy under
|
| 30 |
sites/all/modules/localizer/.
|
| 31 |
4. To the end of your sites/default/settings.php file, append the following
|
| 32 |
code and save (overwrite the file):
|
| 33 |
|
| 34 |
include_once('sites/all/modules/localizer/localizer_settings.php');
|
| 35 |
|
| 36 |
View the settings.php file to be sure it has changed. (Note that you may
|
| 37 |
have to temporarily reset the permissions on settings.php for you changes to
|
| 38 |
actually be saved.)
|
| 39 |
|
| 40 |
5. Login to your site as administrator (UID=1)
|
| 41 |
6. Under Administer > Site building > modules, enable all the
|
| 42 |
Localizer-related modules you need. Click Save configuration.
|
| 43 |
7. Visit www.yoursite.com/update.php and run the update script.
|
| 44 |
8. Under Administer > Site configuration > Localizer, configure options.
|
| 45 |
9. Under Administer > User management > Access control, be sure to enable
|
| 46 |
(at a minimum) "access translations" under localizer module.
|
| 47 |
10. Enjoy!
|
| 48 |
|
| 49 |
|
| 50 |
Upgrade instructions (Upgrade from Localizer 1.10 on Drupal 5.x to
|
| 51 |
Localizer 3.x on Drupal 5.x)
|
| 52 |
|
| 53 |
0. Make sure you have a working site with Drupal 5.x + Localizer 1.10.
|
| 54 |
(The latest stable combination before Localizer 3.x is Drupal 5.5 +
|
| 55 |
Localizer 1.10)
|
| 56 |
1. Backup your Drupal database (and as a normal precaution, your whole site if
|
| 57 |
you haven't done so for some time).
|
| 58 |
2. Download the various Localizer 3.x components. This includes Localizer
|
| 59 |
itself, which can be found at http://drupal.org/project/localizer and flags
|
| 60 |
and patches, both of which can be found at
|
| 61 |
http://www.speedtech.it/drupal-localizer, but don't upload them yet.
|
| 62 |
3. Login to your site as administrator and under Administer > Site
|
| 63 |
building > modules, disable all the Localizer-related modules
|
| 64 |
4. Delete the old localizer directory under sites/all/modules/.
|
| 65 |
5. Extract the localizer-5.x-3.x.tar.gz archive under sites/all/modules/.
|
| 66 |
This will create the localizer directory and put the localizer application
|
| 67 |
files in sites/all/modules/localizer.
|
| 68 |
Under sites/all/modules/localizer, extract the flag and patch archives. This
|
| 69 |
will create the directories flags, menu and taxonomy under
|
| 70 |
sites/all/modules/localizer/.
|
| 71 |
|
| 72 |
6. If you have previously setup Localizer 1.x correctly, you will have appended
|
| 73 |
the following code to the end of your sites/default/settings.php file:
|
| 74 |
|
| 75 |
$conf= array
|
| 76 |
(
|
| 77 |
'cache_inc' =>
|
| 78 |
'sites/all/modules/localizer/system/includes/cache.inc',
|
| 79 |
);
|
| 80 |
|
| 81 |
Delete this code, and instead, append the following code to the end of your
|
| 82 |
sites/default/settings.php file.
|
| 83 |
|
| 84 |
include_once('sites/all/modules/localizer/localizer_settings.php');
|
| 85 |
|
| 86 |
View the settings.php file to be sure it has changed. (Note that you may
|
| 87 |
have to temporarily reset the permissions on settings.php for you changes to
|
| 88 |
actually be saved.)
|
| 89 |
|
| 90 |
7. Login to your site as administrator (UID=1).
|
| 91 |
8. Under Administer > Site building > modules, enable all the
|
| 92 |
Localizer-related modules you need. Click Save configuration.
|
| 93 |
You should see your modules page reappear intact, but with a list of errors.
|
| 94 |
You can ignore these errors and continue with the next step.
|
| 95 |
9. Visit www.yoursite.com/update.php (or just click on the link on the modules
|
| 96 |
page) and run the update script. (The errors on the modules page should go
|
| 97 |
away.)
|
| 98 |
10. Go to Administer > Site configuration > Localizer to configure options.
|
| 99 |
11. Under Administer > User management > Access control, be sure to enable
|
| 100 |
(at a minimum) "access translations" under localizer module.
|
| 101 |
12. Enjoy!
|