You are here

Home » API reference » Date 5.2

INSTALL.txt in Date 5.2

Same filename and directory in other branches
  1. 5 INSTALL.txt
  2. 6.2 INSTALL.txt
  3. 6 INSTALL.txt
  4. 7.3 INSTALL.txt
  5. 7 INSTALL.txt
  6. 7.2 INSTALL.txt
==================================================================================
Date API Installation instructions:
==================================================================================
1) If you have an earlier version of the Date module on your system, empty the
   date folder out completely. The files in version 2 have different names and are
   located in different places.

2) Download the whole package of files from http://drupal.org/project/date.

3) Upload the date files to the modules directory. The package includes files 
   needed by the Date API, and optional modules to to create CCK date fields.

4) Go to admin/build/modules and enable the needed modules from the Date/Time group. 

You should end up with a structure like: 

   /drupal/sites/all/modules/date/date_api.info
   /drupal/sites/all/modules/date/date_api.install
   /drupal/sites/all/modules/date/date_api.module
   ...

   /drupal/sites/all/modules/date/date/date.info
   /drupal/sites/all/modules/date/date/date.install
   /drupal/sites/all/modules/date/date/date.module
   ...

   /drupal/sites/all/modules/date/date_copy/date_copy.info
   /drupal/sites/all/modules/date/date_copy/date_copy.module
   ...

   /drupal/sites/all/modules/date/date_php4/date_php4.inc
   /drupal/sites/all/modules/date/date_php4/date_php4_lib.inc
   ...

==================================================================================
Older PHP versions
==================================================================================
If you are using PHP 4 or PHP 5.0 or 5.1, native date handling won't work right.
Install the Date_PHP4 module to enable wrapper functions so this code will work
in old PHP versions. 

==================================================================================
Enable Date Timezone
==================================================================================
In most cases, you should enable the Date Timezone module any time you use the
Date API to be able to set the site and user timezone names. It is not enabled by 
default in case another module is setting timezone names in the database.

Once you have enabled it, go to admin/settings/date-time and set the default 
site timezone name. If you are using user timezones, go to your account settings
and set up your own timezone name.

==================================================================================
Install CCK Date Fields:
==================================================================================

1) The CCK date field is included in the Date files at http://drupal.org/project/date.

2) Go to admin/build/modules and enable the Date module. Be sure that the Date API module,
   the Date Timezone module, and the Content module are also installed.

3) Go to admin/content/types to view cck content types and edit a content type.

4) Make sure the default timezone name has been set at admin/settings/date-time.

5) While viewing a content type, select the option to add a new field from the tabs at
   the top of the page. Several options for date fields should be visible.
   
==================================================================================
More documentation is available at http://drupal.org/node/92460.
==================================================================================

File

INSTALL.txt
View source 
  1. ==================================================================================

  2. Date API Installation instructions:

  3. ==================================================================================

  4. 1) If you have an earlier version of the Date module on your system, empty the

  5.    date folder out completely. The files in version 2 have different names and are

  6.    located in different places.

  7. 

  8. 2) Download the whole package of files from http://drupal.org/project/date.

  9. 

  10. 3) Upload the date files to the modules directory. The package includes files 

  11.    needed by the Date API, and optional modules to to create CCK date fields.

  12. 

  13. 4) Go to admin/build/modules and enable the needed modules from the Date/Time group. 

  14. 

  15. You should end up with a structure like: 

  16. 

  17.    /drupal/sites/all/modules/date/date_api.info

  18.    /drupal/sites/all/modules/date/date_api.install

  19.    /drupal/sites/all/modules/date/date_api.module

  20.    ...

  21. 

  22.    /drupal/sites/all/modules/date/date/date.info

  23.    /drupal/sites/all/modules/date/date/date.install

  24.    /drupal/sites/all/modules/date/date/date.module

  25.    ...

  26. 

  27.    /drupal/sites/all/modules/date/date_copy/date_copy.info

  28.    /drupal/sites/all/modules/date/date_copy/date_copy.module

  29.    ...

  30. 

  31.    /drupal/sites/all/modules/date/date_php4/date_php4.inc

  32.    /drupal/sites/all/modules/date/date_php4/date_php4_lib.inc

  33.    ...

  34. 

  35. ==================================================================================

  36. Older PHP versions

  37. ==================================================================================

  38. If you are using PHP 4 or PHP 5.0 or 5.1, native date handling won't work right.

  39. Install the Date_PHP4 module to enable wrapper functions so this code will work

  40. in old PHP versions. 

  41. 

  42. ==================================================================================

  43. Enable Date Timezone

  44. ==================================================================================

  45. In most cases, you should enable the Date Timezone module any time you use the

  46. Date API to be able to set the site and user timezone names. It is not enabled by 

  47. default in case another module is setting timezone names in the database.

  48. 

  49. Once you have enabled it, go to admin/settings/date-time and set the default 

  50. site timezone name. If you are using user timezones, go to your account settings

  51. and set up your own timezone name.

  52. 

  53. ==================================================================================

  54. Install CCK Date Fields:

  55. ==================================================================================

  56. 

  57. 1) The CCK date field is included in the Date files at http://drupal.org/project/date.

  58. 

  59. 2) Go to admin/build/modules and enable the Date module. Be sure that the Date API module,

  60.    the Date Timezone module, and the Content module are also installed.

  61. 

  62. 3) Go to admin/content/types to view cck content types and edit a content type.

  63. 

  64. 4) Make sure the default timezone name has been set at admin/settings/date-time.

  65. 

  66. 5) While viewing a content type, select the option to add a new field from the tabs at

  67.    the top of the page. Several options for date fields should be visible.

  68.    

  69. ==================================================================================

  70. More documentation is available at http://drupal.org/node/92460.

  71. ==================================================================================   

  72.    

  73.