You are here

Home » API reference » Datex 7

README.txt in Datex 7

Same filename and directory in other branches
  1. 7.3 README.txt
  2. 7.2 README.txt
INTRODUCTION
------------

Current Maintainer: Koosha Hosseiny <info@koosha.cc> lo2y4 at D.O

Datex and related module will help to create a better multilingual website for
languages needing a Jalali calendar instead of default Gregorian calendar.

  - Datex API: is the base module, And used by other modules to localize dates. 
    On it's own, It would do nothing.

  - Datex: When enabled, Will convert all dates to Jalali before display in
    page.

  - Datex_date For Jalali support in date module, This module should be enabled
    It supports "views" too. Currently only "select" widget is supported but a 
    popup widget will be added soon.


Since there is not a good "hook" in Drupal's core to alter dates and their
format, Some extra effort is needed to get "datex" module working. datex_date 
will work out of the box though.


There are two methods available for datex:

  - Converting dates to Jalali in theming layer. Using this method, You won't 
    have to patch the core, But you will might miss Jalali date in  some places
    It's been tried to keep it as good as possible in non-patching mode: Support
    of jalali date in views, in node edit form, scheduler module and...
    If you encounter no problem using this mode, This is the recomended (and 
    default) method. 

  - Patching core: There is a patch file provided within this module, If you
    apply it on 'common.inc' file, You get localized date everywhere.
    This patch adds a hook to core for altering format_date result with smallest
    footprint.

Keep in mind that hacking core is a *very bad* practice, So decide for yourself.

INSTALLATION
------------

Download module from http://drupal.org/project/datex and put it in your
sites/all/modules folder of your Drupal installation. Then enable it.
You could use drush too!

If you read above and want to apply the patch, Locate the patch file in 
module's folder "drupal-jalali_support-0-0.patch", and apply it to file 
"includes/common.inc". 
Instructions about patching files is at drupal.org.

Now visit the configuration forms and configure the modules to your needs.
They are located at 
  - admin/config/regional/date-time/datex_api
  - admin/config/regional/date-time/datex

File

README.txt
View source 
  1. 

  2. INTRODUCTION

  3. ------------

  4. 

  5. Current Maintainer: Koosha Hosseiny  lo2y4 at D.O

  6. 

  7. Datex and related module will help to create a better multilingual website for

  8. languages needing a Jalali calendar instead of default Gregorian calendar.

  9. 

  10.   - Datex API: is the base module, And used by other modules to localize dates. 

  11.     On it's own, It would do nothing.

  12. 

  13.   - Datex: When enabled, Will convert all dates to Jalali before display in

  14.     page.

  15. 

  16.   - Datex_date For Jalali support in date module, This module should be enabled

  17.     It supports "views" too. Currently only "select" widget is supported but a 

  18.     popup widget will be added soon.

  19. 

  20. 

  21. Since there is not a good "hook" in Drupal's core to alter dates and their

  22. format, Some extra effort is needed to get "datex" module working. datex_date 

  23. will work out of the box though.

  24. 

  25. 

  26. There are two methods available for datex:

  27. 

  28.   - Converting dates to Jalali in theming layer. Using this method, You won't 

  29.     have to patch the core, But you will might miss Jalali date in  some places

  30.     It's been tried to keep it as good as possible in non-patching mode: Support

  31.     of jalali date in views, in node edit form, scheduler module and...

  32.     If you encounter no problem using this mode, This is the recomended (and 

  33.     default) method. 

  34. 

  35.   - Patching core: There is a patch file provided within this module, If you

  36.     apply it on 'common.inc' file, You get localized date everywhere.

  37.     This patch adds a hook to core for altering format_date result with smallest

  38.     footprint.

  39. 

  40. Keep in mind that hacking core is a *very bad* practice, So decide for yourself.

  41. 

  42. INSTALLATION

  43. ------------

  44. 

  45. Download module from http://drupal.org/project/datex and put it in your

  46. sites/all/modules folder of your Drupal installation. Then enable it.

  47. You could use drush too!

  48. 

  49. If you read above and want to apply the patch, Locate the patch file in 

  50. module's folder "drupal-jalali_support-0-0.patch", and apply it to file 

  51. "includes/common.inc". 

  52. Instructions about patching files is at drupal.org.

  53. 

  54. Now visit the configuration forms and configure the modules to your needs.

  55. They are located at 

  56.   - admin/config/regional/date-time/datex_api

  57.   - admin/config/regional/date-time/datex