Query rewriting can't return an empty WHERE clause.
[project/i18n.git] / INSTALL.txt
1 ********************************************************************
2                      D R U P A L    M O D U L E                         
3 ********************************************************************
4 Name: i18n module and translation module
5 Author: Jose A. Reyero
6
7 ********************************************************************
8   This is the 6.x version of i18n module, and works with Drupal 6.x
9 ********************************************************************
10
11 ********************************************************************
12 Updated documentation will be kept on-line at http://drupal.org/node/67817
13 ********************************************************************
14
15 INSTALLATION:
16 ============
17
18 1. Create folder 'sites/all/modules/i18n' and copy all the modules files, keeping directory structure, to this folder.
19 2. If updating, run the update.php script following the standard procedure for Drupal updates.
20
21 POST-INSTALLATION/CONFIGURATION:
22 ============
23 - Enable the module/s in: Administer > Site building > modules
24   These modules are grouped under 'Multilanguage - i18n' package
25   Recommeded default is to enable: Internationalization, Translation
26   * Other modules are for very specific features.
27   
28 - Configure the modules in 
29         Administer > Site Configuration > Multilingual system
30
31 - Set up language for existing nodes, editing them manually.
32 - Set up language for existing taxonomy terms
33   Only terms in the node's language or terms without language will show up when editing a node
34
35 Language dependent variables
36 ============================
37   The list of variables to be made language dependent must be defined in the config file:
38
39   I.e.
40   
41     $conf['i18n_variables'] = array(
42         // Site configuration
43         'site_name',
44         'site_slogan',
45         'site_mission',
46         'site_footer',
47         'anonymous',
48         // Node help
49         'blog_help',
50         'story_help',
51         // User configuration
52         'user_registration_help',
53         'user_mail_welcome_subject',
54         'user_mail_welcome_body',
55         'user_mail_approval_subject',
56         'user_mail_approval_body',
57         'user_mail_pass_subject',
58         'user_mail_pass_body',
59         // Primary and secondary links
60         'menu_primary_menu',
61         'menu_secondary_menu';
62         // Theme settings. This is an 'all or nothing' for each theme
63         // This is for 'garland' theme, for other theme it would be 'theme_[themename]_settings'
64                     'theme_garland_settings',
65     
66     );
67     
68   These are only some suggested ones, but you can add as many Drupal variables as you want to the array.
69     
70   You need to redefine these variables for the first time for every language, as previous values are lost and they return to defaults -they will be back if you disable i18n-. 
71     
72 Language dependent tables 
73 =========================
74   [ADVANCED, NOT REQUIRED, HANDLE WITH CARE, MAY BREAK YOUR SITE, just for experimentation and *really advanced* use]
75   This module can manage language dependent tables, which means you can have different specific tables for each language, and the one for the current language will be selected at run time. 
76   
77   You need to modify $db_prefix and add a new global variable $db_prefix_i18n in .conf file. This is a sample:
78     
79     $db_prefix=array (
80
81         'default' => 'prefix_', // The default prefix
82
83     );
84
85    [IMPORTANT UPDATE: The way to add a new global variable, since Drupal 4.7 is through the $GLOBALS array]
86    
87     $GLOBALS['db_prefix_i18n'] = array (
88         // '**' will be replaced by language code at runtime.
89         'table1'    => 'prefix_**_'  
90         'table2'    => 'prefix_**_',
91     );
92     
93
94 Additional Support
95 ==================
96 For support, please create a support request for this module's project: http://drupal.org/project/i18n
97
98 If you need professional support, contact me by e-mail: freelance at reyero dot net
99
100
101 ====================================================================
102 Jose A. Reyero, freelance at reyero dot net, http://www.reyero.net
103
104 Feedback is welcomed.