You are here

Home » API reference » Language Cookie 8

README.txt in Language Cookie 8

Same filename and directory in other branches
  1. 7.2 README.txt
  2. 7 README.txt
CONTENTS OF THIS FILE
---------------------
 * Introduction
 * Usage
 * Support
 * Compatibility


INTRODUCTION
------------

Adds an extra "Cookie" field to the Language Negotiation settings, allowing the
language to be set according to a cookie.

The cookie name & expiration date are configurable in the settings page.


USAGE
------

- Enable the module and go to: Administration » Configuration » Regional and
  language » Languages » Detection and selection (available at the following
  URL: 'admin/config/regional/language/detection/language_cookie').

- Enable the "Cookie" detection method and re-arrange the user interface
  language detection as you see fit. The language cookie will be set to
  whichever language the user interface turns out to be in. The recommended
  setup is (from top to bottom):
    URL -> Cookie -> Language Selection Page -> Default.

  Just to illustrate, another possible setup is:
    User -> Session -> Cookie -> Default

- If you use URL-based caching such as Varnish and want the cookie to be set on
  all pages, there is a setting for this in the administration interface: Go to
  'admin/config/regional/language/configure/cookie' and check the relevant
  checkbox. If you want cookie-based automatic language selection without
  invoking Drupal, you will need to implement a Javascript based solution which
  reads the cookie and redirects the user to the right page.


SUPPORT
-------

If you find a bug or have a feature request please file an issue:

http://drupal.org/node/add/project-issue/language_cookie

COMPATIBILITY
-------------

A lot of work has gone into ensuring maximum compatibility with other contrib
modules. If you find a bug please use the issue tracker for support. Thanks!

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. ---------------------

  3.  * Introduction

  4.  * Usage

  5.  * Support

  6.  * Compatibility

  7. 

  8. 

  9. INTRODUCTION

  10. ------------

  11. 

  12. Adds an extra "Cookie" field to the Language Negotiation settings, allowing the

  13. language to be set according to a cookie.

  14. 

  15. The cookie name & expiration date are configurable in the settings page.

  16. 

  17. 

  18. USAGE

  19. ------

  20. 

  21. - Enable the module and go to: Administration » Configuration » Regional and

  22.   language » Languages » Detection and selection (available at the following

  23.   URL: 'admin/config/regional/language/detection/language_cookie').

  24. 

  25. - Enable the "Cookie" detection method and re-arrange the user interface

  26.   language detection as you see fit. The language cookie will be set to

  27.   whichever language the user interface turns out to be in. The recommended

  28.   setup is (from top to bottom):

  29.     URL -> Cookie -> Language Selection Page -> Default.

  30. 

  31.   Just to illustrate, another possible setup is:

  32.     User -> Session -> Cookie -> Default

  33. 

  34. - If you use URL-based caching such as Varnish and want the cookie to be set on

  35.   all pages, there is a setting for this in the administration interface: Go to

  36.   'admin/config/regional/language/configure/cookie' and check the relevant

  37.   checkbox. If you want cookie-based automatic language selection without

  38.   invoking Drupal, you will need to implement a Javascript based solution which

  39.   reads the cookie and redirects the user to the right page.

  40. 

  41. 

  42. SUPPORT

  43. -------

  44. 

  45. If you find a bug or have a feature request please file an issue:

  46. 

  47. http://drupal.org/node/add/project-issue/language_cookie

  48. 

  49. COMPATIBILITY

  50. -------------

  51. 

  52. A lot of work has gone into ensuring maximum compatibility with other contrib

  53. modules. If you find a bug please use the issue tracker for support. Thanks!