You are here

README.txt in Archive 5

Same filename and directory in other branches
  1. 6 README.txt
  2. 7.2 README.txt
  3. 7 README.txt
This is replacement for the Drupal archive.module which was available in
Drupal core in Drupal 4.7.x and previous versions. It provides a calendar
block that shows the current month with links to the archive for days that
have posts. It also allows browsing of all content by date or node-type,
so if you have a linked list users can browse just those nodes.

Installation:
  Install module like normal
  Visit admin/settings/archive and configure which node types you want
    browseable (required)
  Add link to /archive somewhere on your site. 

Alternatives:
  Weekly archive module: http://drupal.org/project/week
  Views module (much more general): http://drupal.org/project/views
                                    http://drupal.org/node/52037 

Originally by CodeMonkeyX

--------------------------------------------------------------------------------
*Developer* notes 
 
Access permissions:
 - The archive module provides no permissions on its own. Users in
   roles with "access content" permissions may view and select
   content from the /archive page.

Timezone handling:

 - Drupal sets $node->created to time() on node creation and storage
 - Then on display it invokes format_date() to get a date display,
   which adds a timezone to the timestamp and then uses gmdate()
 => This means that "time() + timezone" is used as the displayed date

 - Archive module sets today to time() + timezone to conform
 - SQL injected timestamps should have timezone substracted, since
   we need to move the window on the queried nodes "back" to get
   nodes for the date the user expects to get
 - Displayed timestamps should have timezone added to them
 - Archive module uses "gm" functions, so that the server timezone
   is not added upon the used timestamps
--------------------------------------------------------------------------------

File

README.txt
View source
  1. This is replacement for the Drupal archive.module which was available in
  2. Drupal core in Drupal 4.7.x and previous versions. It provides a calendar
  3. block that shows the current month with links to the archive for days that
  4. have posts. It also allows browsing of all content by date or node-type,
  5. so if you have a linked list users can browse just those nodes.
  6. Installation:
  7. Install module like normal
  8. Visit admin/settings/archive and configure which node types you want
  9. browseable (required)
  10. Add link to /archive somewhere on your site.
  11. Alternatives:
  12. Weekly archive module: http://drupal.org/project/week
  13. Views module (much more general): http://drupal.org/project/views
  14. http://drupal.org/node/52037
  15. Originally by CodeMonkeyX
  16. --------------------------------------------------------------------------------
  17. *Developer* notes
  18. Access permissions:
  19. - The archive module provides no permissions on its own. Users in
  20. roles with "access content" permissions may view and select
  21. content from the /archive page.
  22. Timezone handling:
  23. - Drupal sets $node->created to time() on node creation and storage
  24. - Then on display it invokes format_date() to get a date display,
  25. which adds a timezone to the timestamp and then uses gmdate()
  26. => This means that "time() + timezone" is used as the displayed date
  27. - Archive module sets today to time() + timezone to conform
  28. - SQL injected timestamps should have timezone substracted, since
  29. we need to move the window on the queried nodes "back" to get
  30. nodes for the date the user expects to get
  31. - Displayed timestamps should have timezone added to them
  32. - Archive module uses "gm" functions, so that the server timezone
  33. is not added upon the used timestamps
  34. --------------------------------------------------------------------------------