Issue #1805568 by greggles | YuriDunaev: PDOException: SQLSTATE... Base table or...
[project/comment_notify.git] / INSTALL.TXT
1 INSTALLATION
2 ------------
3
4 1. Enable the module from the Modules admin page from "Modules"
5  - /admin/modules
6
7 2. Grant permission to use this module from "People > Permissions"
8  - /admin/people/permissions#module-comment_notify
9
10 3. Set permissions for commenting as per usual from "People > Permissions"
11  - /admin/people/permissions#module-comment
12
13 4. Configure the settings for comments for content types from Structure 
14    > Content types > [Your content type] > Edit: "Comment settings" 
15  - /admin/structure/types/manage/[your_content_type] 
16  - e.g. /admin/structure/types/manage/page
17         
18  - Look for "Anonymous commenting" and set to either:
19      "Anonymous posters may leave their contact information" OR
20      "Anonymous posters must leave their contact information"
21
22 5. Configure this module at Configuration > People > Comment Notify
23         - /admin/config/people/comment_notify
24
25   -Determine which content types to activate it for
26   -Determine which subscription modes are allowed
27   -Configure the templates for the e-mails
28   
29 6. Set your node-notify settings per user (optional)
30
31 The module includes a feature to notify the node author of all comments on 
32 their nodes. To enable this go to "My account" > Edit (e.g. user/1/edit)
33 and change the settings there, i.e., "Comment follow-up notification settings"
34
35 TEMPLATE TRANSLATION
36 --------------------
37
38 Notification templates are passed through t() before being added to the
39 email's body. Therefore, for you to translate them to other languates you
40 need to:
41
42 1. Enable the Locale module.
43
44 2. Choose a node in which you are not the auther and has comments and comment
45 on it. This will send an email to the author and other commenters.
46
47 3. Open the Translation Interface, located at
48    admin/config/regional/translate/translate
49
50 4. Search for the template strings and add the translations.
51
52 OPTIONAL MODULES
53 ----------------
54
55 Performance: If you notice that your site is very slow when submitting
56 new comments it is possible that the problem is with sending the mails. 
57 One option is to use the Queue Mail module
58 http://drupal.org/project/queue_mail
59
60 COMPATIBILITY NOTE
61 ------------------
62
63 Comment Notify is not built to work on sites where other notification related 
64 modules are installed (modules like Actions, Notify, Subscriptions, and 
65 Organic Groups are popular examples). If you install both Comment Notify and
66 one of these other mail modules on your site in addition to Comment Notify
67 it may send duplicate messages and/or have user interface elements that will
68 appear to be duplicates and confuse your site visitors.
69
70 The suggested configuration in these instances is to separate Comment Notify and
71 whatever other mail module you have installed. Common ways to separate them are
72 by content type or user permissions.
73