summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJose Reyero2005-04-24 14:15:30 (GMT)
committer Jose Reyero2005-04-24 14:15:30 (GMT)
commit975aa33779610b0270a027569ad56a110eebd4cf (patch)
tree4412bb65d61c8e3b765a5960401aab4c495a070b
parent81669cd7a67ff83bb39162962259a00d47738211 (diff)
Preparing 4.6 release
-rw-r--r--INSTALL.txt46
-rw-r--r--README.txt30
-rw-r--r--i18n_db_update.mysql (renamed from patches/i18n_db_update.mysql)0
3 files changed, 43 insertions, 33 deletions
diff --git a/INSTALL.txt b/INSTALL.txt
index 8eaef3b..e7aa853 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -5,18 +5,33 @@ Name: i18n module
Author: Jose A. Reyero
Email: drupal at reyero dot net
-**************************************************************
-This module works with Drupal HEAD -development branch-
-**************************************************************
+********************************************************************
+ This is i18n module, version 4.6, and works with Drupal 4.6.0
+********************************************************************
INSTALLATION:
============
1. Create folder 'modules/i18n', and copy all the modules files, keeping directory structure, to this folder.
-2. Apply the patches to the Drupal core that are provided.
- Also, apply the database modifications from the SQL file 'i18n.mysql.'
- All of these modifications are located in the "patches" folder.
- ** Check for db updates in the patches folder
+2. Apply the patches to the Drupal core that are provided. Located in the 'patches' folder
+3. Apply the database modifications from the SQL file 'i18n.mysql.'
+ ** There's an update script to update the i18n database tables from 4.5 to 4.6 version: 18n_db_update.mysql
+
+POST-INSTALLATION/CONFIGURATION:
+============
+- Enable the module in administration > modules
+- Configure the module in administrations > settings > i18n
+- Check the node types to be made multilingual
+ A new field 'language' and a new tab 'translations' will be available when editing these node types
+- Enable the language selector block in administration > blocks
+
+- Set up language for existing nodes, editing them manually or directly updating in the database.
+ I.e. provided that all your existing nodes are in english:
+ UPDATE node SET language='en'
+
+- Set up language for existing taxonomy terms
+ Only terms in the node's language or terms without language will show up when editing a node
+
Language Definition
===================
You can use the languages defined -and enabled- in 'locale' module or modify the Drupal configuration file 'includes/conf.php' to define the languages you want to use.
@@ -24,7 +39,7 @@ You can use the languages defined -and enabled- in 'locale' module or modify the
$i18n_languages = array("es" => "spanish", "en" => "english");
-Add any flag icons beyond the four provided by placing them in 'modules/i18n/flags'.
+Add any flag icons beyond the ones provided by placing them in 'modules/i18n/flags'.
You can get more flag icons from: http://www.clickfire.com/content/graphics/favicons/flags_icons.php
* Yes, I know I could add a lot more to the module's tar file, but I want to keep the download as small as possible, so the current policy is including with the module only the ones I think will be more use, and the ones asked for by other module contributors.
@@ -52,7 +67,8 @@ Language dependent variables
'user_mail_approval_body',
'user_mail_pass_subject',
'user_mail_pass_body',
-
+ // Theme settings: primary and secondary links, logo, etc..
+ 'theme_settings',
// These are for PHPtemplate
'phptemplate_primary_links',
'phptemplate_primary_links_more',
@@ -66,8 +82,9 @@ Language dependent variables
To get more flags
=================
-You can try this:
-http://www.google.com/search?q=awstats+icon+flags
+Add any flag icons beyond the ones provided by placing them in 'modules/i18n/flags'.
+You can try this to get new icons:
+ http://www.google.com/search?q=awstats+icon+flags
Language dependent tables
=========================
@@ -91,11 +108,6 @@ Language dependent tables
);
-
-If you want to experiment with different tables, you may find this useful [Drupal ERD]:
-
- http://lists.drupal.org/pipermail/drupal-support/attachments/20030530/7a6fd04a/cdm1-0001.png
-
Additional Support
==================
For support, please create a support request for this module's project: http://drupal.org/project/i18n
@@ -104,6 +116,6 @@ If you need professional support, contact me by e-mail: freelance at reyero dot
====================================================================
-Jose A. Reyero, drupal at reyero dot net, http://freelance.reyero.net
+Jose A. Reyero, drupal at reyero dot net, http://www.reyero.net
Feedback is welcomed.
diff --git a/README.txt b/README.txt
index 2b56f79..91d2685 100644
--- a/README.txt
+++ b/README.txt
@@ -2,16 +2,14 @@ README.txt
==========
********************************************************************
- This version is under heavy development.
-********************************************************************
- It is intended for the upcoming Drupal 4.6
- Patches are against Drupal CVS (HEAD)
+ This is i18n module, version 4.6, and works with Drupal 4.6.0
********************************************************************
WARNING: It is not 100% backwards compatible with the old i18n module [4.5.x]
WARNING: DO READ THE INSTALL FILE
********************************************************************
This module implements multilingual support as outlined in http://drupal.org/node/11051
+Some more info about this module will be available here: http://reyero.net/en/drupal/i18n
It doesn't require anymore multiple language tables as previous versions
@@ -35,13 +33,12 @@ This module supports:
- Multilingual taxonomy vocabularies and terms
- Basic translation management for nodes and terms
-While this works fine when viewing the main page and managing single nodes, many modules generate node listings which are not yet language aware.
-This means you can have some blocks/pages listing nodes for all languages.
-All this issues will be addressed step by step, module by module, but it will take time.
+When you navigate the site using multiple languages, the pages will just show terms and nodes for the chosen language plus the ones that haven't a definde language.
+When editing a node, you must click on 'Preview' after changing language for the right vocabularies and terms to be shown.
-** If you are a module developer and you want to make your module 'language aware', which is quite simple, you can take a look at patched 'node.module' or drop me an e-mail if you need help.
+The multi language support is expected to work for all node types, and node listings in Drupal 4.6!!
-So far, I have not found incompatibilities with any module/node type. Please, let me know if you find any.
+So far, I have not found incompatibilities with any other module. Please, let me know if you find any.
And yes, flexinode works with multiple languages :-)
@@ -55,10 +52,11 @@ Thus, you can define aliases with or without language codes in them
The 'Front page: Language dependent' option means that when the request is for the front page '/', a language prefix will be added before doing the path translation, and then -> step 1 above
This language code will be taken from browser if enabled 'Browser language detection, or will be the default otherwise.
-About Synchronization [old i18n module style] :
-======================
-This is not required anymore, and probably the 'basic translation interface' will be enough
-However, I plan to implement some related options in the future, just to keep translations in sync
+To have aliases for a translated node/page, you have to define each of them. I.e.:
+ en/mycustompath -> node/34 (which is suppossed to be the english version)
+ es/mycustompath -> node/35 (which should be the spanish version)
+
+For outgoing URL's, the language code will be added authomatically.
About language dependent variables:
======================
@@ -72,9 +70,9 @@ Language dependent tables are not needed anymore for multilingual content.
This is kept for backwards compatibility, experimentation and may be some use in the future.
* This can be used to have per-language data for modules not language-aware, like language statistics... you can experiment...
-Samples: Sites using this module - e-mail me to be listed here
+Sample sites, using this module - e-mail me to be listed here
==========================================================
-http://freelance.reyero.net, well, its mine, no merit :-)
+ http://www.reyero.net, well, its mine, no merit :-)
Additional Support
=================
@@ -84,6 +82,6 @@ For support, please create a support request for this module's project:
If you need professional support, contact me by e-mail: freelance at reyero dot net
====================================================================
-Jose A. Reyero, drupal at reyero dot net, http://freelance.reyero.net
+Jose A. Reyero, drupal at reyero dot net, http://www.reyero.net
Feedback is welcomed. \ No newline at end of file
diff --git a/patches/i18n_db_update.mysql b/i18n_db_update.mysql
index 2bd98e7..2bd98e7 100644
--- a/patches/i18n_db_update.mysql
+++ b/i18n_db_update.mysql