You are here

README.txt in Advanced Forum 7.2

Same filename and directory in other branches
  1. 5 README.txt
  2. 6.2 README.txt
  3. 6 README.txt
CONTENTS OF THIS FILE
---------------------
 * Introduction
 * Installation
 * Other configuration
 * Credits
 
INTRODUCTION
------------
Advanced Forum (http://drupal.org/project/advanced_forum) enhances Drupal's forum module to provide the look and, with the help of other modules, much of the functionality found in common forum software. Because it uses the core forum module, it uses the node and comment system built into Drupal and is completely integrated, not a bridge.

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

1. Enable all dependencies: Author Pane ( http://drupal.org/project/author_pane ), Forum, 
   Taxonomy, Comment. (Optionally: Statistics)
   
2. Copy the entire advanced_forum project directory (not just the contents) to your 
   normal module directory (ie: sites/all/modules)
   
3. Enable the advanced forum module at ?q=admin/build/modules

4. Visit the Advanced Forum settings page at ?q=admin/config/content/advanced-forum
   # General:
     * "Advanced forum style directory" Select the style you are using. 
       See http://drupal.org/node/234042 for more information on this.
     * "Use graphical buttons for links" Check this if you want links to use graphical 
        buttons (where available).
     * "Treat all site comments like forum comments" If you would like advanced forum to 
       take over the theming of all comments, even those outside the forum, choose yes.
     * "Use fields from taxonomy term in forum" Allows to use fields from taxonomy term
        on the form of creation or editing of the forum. You can add your own fields into
        taxonomy term from vocabulary "Forums" and these fields will be available on the
        creation/editing form of the Forum if this option is active.
   # Forum and topic lists
     * "Hide the created column on the topic list" This option hides the created column
       on the topic list page, which can't be done purely in theming due to the header
       tablesort. If you hide this column, it is up to you to change the tenplate to
       display the information elsewhere.
     * "Get the number of new comments per forum on the forum list" Core forum shows the 
       number of new topics. If checked, Advanced Forum will get the number of new 
       comments as well and show it under "posts" on the forum overview. Slow query not 
       recommended on large forums.
     * "Number of characters to display for the topic title" On the main forums page, the
       title of the last topic is shown. Because this is a narrow column, it is 
       truncated. This option sets how many characters are shown.
     * "Number of hours before switching to date posted in displays" In the forum / topic
       listing, recent posts are shown like "1 day, 3 hours ago" and older posts will
       have the actual date. You control the cutoff here.
   # Topics
     * "Use topic navigation" Core forum gets the next and previous topics and shows 
       links to them under the top post. This is turned off by default as the query has 
       performance issues and the placement of the links is poor.
     * "User picture preset" You will only see this option if you have imagecache 2
        enabled. If you choose a preset here, it will be used for the avatars in forum
        posts. This can be used to give a more uniform appearance if people have many
        different sizes for avatars. If you don't want to use a preset, just leave it
        blank.

OTHER CONFIGURATION
-------------------
   
1. Forum settings ( ?q=admin/content/forum/settings ) 
    * Hot topic threshold: Up to you.
    * Topics per page: Up to you.
    * Default order: "Date - newest first" so the most recent posts are at the top of the 
      topic list.
2. Select content types to use in forums ( ?q=admin/content/taxonomy ) 
3. Edit the forum vocabulary
   * Check all content types you want to use in forums.
4. Comment settings ( ?q=admin/content/node-type/forum ) [Note: do this for each content 
   type used in forums] 
   * Expand "Comment settings" fieldset.
   * Default comment setting: "Read/write"
   * Set Default display mode: Flat list - expanded. (Advforum is intended to be used 
     flat. Using it threaded should mostly work but is unsupported and may have some 
     issues.) 
   * Default display order: Date - oldest first 
   * Default comments per page: Up to you. (If you chose to have a threaded forum, 
     setting this number to the maximum will reduce issues with pagination and threading.) 
   * Comment controls: "Do not display" is recommended.
   * Anonymous commenting: Up to you.
   * Comment subject field: Up to you. If disabled, advforum will not display the Drupal 
     default subject, which is the first few words of the comment.
   * Preview comment: Up to you.
   * Location of comment submission form: Up to you. Displaying below provides a non-ajax 
     quick reply.
5. User settings ( ?q=admin/user/settings ) 
   * Signature support: Enabled
   * Picture support: Enable this for avatars in the forum.
   * Picture maximum dimensions: If you change this from the default 85x85, you will want 
     to size it in either CSS or with imagecache to avoid breaking the forum layout.
6. Statistics settings ( ?q=admin/reports/settings ) 
   * Enable access log: Enabled
   * Count content views: Enabled - Needed for topic views count.   
    
CREDITS
-------
Developer and maintainer: Michelle Cox ( http://drupal.org/user/23570 )

Advanced forum was originally based on flatforum. Though there is little or no code left
from that module, its authors deserve credit for the idea.

The Naked styles, which are the basis of all the other styles, were created by 
stephthegeek (http://drupal.org/user/47874). Previous theme work was done by eigentor 
(http://drupal.org/user/96718) and jacine (http://drupal.org/user/88931)

Icons provided by paris (http://drupal.org/user/14747) and yoroy 
(http://drupal.org/user/41502)

File

README.txt
View source
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Introduction
  4. * Installation
  5. * Other configuration
  6. * Credits
  7. INTRODUCTION
  8. ------------
  9. Advanced Forum (http://drupal.org/project/advanced_forum) enhances Drupal's forum module to provide the look and, with the help of other modules, much of the functionality found in common forum software. Because it uses the core forum module, it uses the node and comment system built into Drupal and is completely integrated, not a bridge.
  10. INSTALLATION
  11. ------------
  12. 1. Enable all dependencies: Author Pane ( http://drupal.org/project/author_pane ), Forum,
  13. Taxonomy, Comment. (Optionally: Statistics)
  14. 2. Copy the entire advanced_forum project directory (not just the contents) to your
  15. normal module directory (ie: sites/all/modules)
  16. 3. Enable the advanced forum module at ?q=admin/build/modules
  17. 4. Visit the Advanced Forum settings page at ?q=admin/config/content/advanced-forum
  18. # General:
  19. * "Advanced forum style directory" Select the style you are using.
  20. See http://drupal.org/node/234042 for more information on this.
  21. * "Use graphical buttons for links" Check this if you want links to use graphical
  22. buttons (where available).
  23. * "Treat all site comments like forum comments" If you would like advanced forum to
  24. take over the theming of all comments, even those outside the forum, choose yes.
  25. * "Use fields from taxonomy term in forum" Allows to use fields from taxonomy term
  26. on the form of creation or editing of the forum. You can add your own fields into
  27. taxonomy term from vocabulary "Forums" and these fields will be available on the
  28. creation/editing form of the Forum if this option is active.
  29. # Forum and topic lists
  30. * "Hide the created column on the topic list" This option hides the created column
  31. on the topic list page, which can't be done purely in theming due to the header
  32. tablesort. If you hide this column, it is up to you to change the tenplate to
  33. display the information elsewhere.
  34. * "Get the number of new comments per forum on the forum list" Core forum shows the
  35. number of new topics. If checked, Advanced Forum will get the number of new
  36. comments as well and show it under "posts" on the forum overview. Slow query not
  37. recommended on large forums.
  38. * "Number of characters to display for the topic title" On the main forums page, the
  39. title of the last topic is shown. Because this is a narrow column, it is
  40. truncated. This option sets how many characters are shown.
  41. * "Number of hours before switching to date posted in displays" In the forum / topic
  42. listing, recent posts are shown like "1 day, 3 hours ago" and older posts will
  43. have the actual date. You control the cutoff here.
  44. # Topics
  45. * "Use topic navigation" Core forum gets the next and previous topics and shows
  46. links to them under the top post. This is turned off by default as the query has
  47. performance issues and the placement of the links is poor.
  48. * "User picture preset" You will only see this option if you have imagecache 2
  49. enabled. If you choose a preset here, it will be used for the avatars in forum
  50. posts. This can be used to give a more uniform appearance if people have many
  51. different sizes for avatars. If you don't want to use a preset, just leave it
  52. blank.
  53. OTHER CONFIGURATION
  54. -------------------
  55. 1. Forum settings ( ?q=admin/content/forum/settings )
  56. * Hot topic threshold: Up to you.
  57. * Topics per page: Up to you.
  58. * Default order: "Date - newest first" so the most recent posts are at the top of the
  59. topic list.
  60. 2. Select content types to use in forums ( ?q=admin/content/taxonomy )
  61. 3. Edit the forum vocabulary
  62. * Check all content types you want to use in forums.
  63. 4. Comment settings ( ?q=admin/content/node-type/forum ) [Note: do this for each content
  64. type used in forums]
  65. * Expand "Comment settings" fieldset.
  66. * Default comment setting: "Read/write"
  67. * Set Default display mode: Flat list - expanded. (Advforum is intended to be used
  68. flat. Using it threaded should mostly work but is unsupported and may have some
  69. issues.)
  70. * Default display order: Date - oldest first
  71. * Default comments per page: Up to you. (If you chose to have a threaded forum,
  72. setting this number to the maximum will reduce issues with pagination and threading.)
  73. * Comment controls: "Do not display" is recommended.
  74. * Anonymous commenting: Up to you.
  75. * Comment subject field: Up to you. If disabled, advforum will not display the Drupal
  76. default subject, which is the first few words of the comment.
  77. * Preview comment: Up to you.
  78. * Location of comment submission form: Up to you. Displaying below provides a non-ajax
  79. quick reply.
  80. 5. User settings ( ?q=admin/user/settings )
  81. * Signature support: Enabled
  82. * Picture support: Enable this for avatars in the forum.
  83. * Picture maximum dimensions: If you change this from the default 85x85, you will want
  84. to size it in either CSS or with imagecache to avoid breaking the forum layout.
  85. 6. Statistics settings ( ?q=admin/reports/settings )
  86. * Enable access log: Enabled
  87. * Count content views: Enabled - Needed for topic views count.
  88. CREDITS
  89. -------
  90. Developer and maintainer: Michelle Cox ( http://drupal.org/user/23570 )
  91. Advanced forum was originally based on flatforum. Though there is little or no code left
  92. from that module, its authors deserve credit for the idea.
  93. The Naked styles, which are the basis of all the other styles, were created by
  94. stephthegeek (http://drupal.org/user/47874). Previous theme work was done by eigentor
  95. (http://drupal.org/user/96718) and jacine (http://drupal.org/user/88931)
  96. Icons provided by paris (http://drupal.org/user/14747) and yoroy
  97. (http://drupal.org/user/41502)