Code

. #517734 ] web header customisation is obscure
[roundup.git] / roundup / templates / classic / instance_config.py
1 #
2 # Copyright (c) 2001 Bizar Software Pty Ltd (http://www.bizarsoftware.com.au/)
3 # This module is free software, and you may redistribute it and/or modify
4 # under the same terms as Python, so long as this copyright message and
5 # disclaimer are retained in their original form.
6 #
7 # IN NO EVENT SHALL BIZAR SOFTWARE PTY LTD BE LIABLE TO ANY PARTY FOR
8 # DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING
9 # OUT OF THE USE OF THIS CODE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
10 # POSSIBILITY OF SUCH DAMAGE.
11 #
12 # BIZAR SOFTWARE PTY LTD SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
13 # BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
14 # FOR A PARTICULAR PURPOSE.  THE CODE PROVIDED HEREUNDER IS ON AN "AS IS"
15 # BASIS, AND THERE IS NO OBLIGATION WHATSOEVER TO PROVIDE MAINTENANCE,
16 # SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
17
18 # $Id: instance_config.py,v 1.13 2002-03-14 23:59:24 richard Exp $
20 MAIL_DOMAIN=MAILHOST=HTTP_HOST=None
21 HTTP_PORT=0
23 try:
24     from localconfig import *
25 except ImportError:
26     localconfig = None
28 import os
30 # roundup home is this package's directory
31 INSTANCE_HOME=os.path.split(__file__)[0]
33 # The SMTP mail host that roundup will use to send mail
34 if not MAILHOST:
35     MAILHOST = 'localhost'
37 # The domain name used for email addresses.
38 if not MAIL_DOMAIN:
39     MAIL_DOMAIN = 'fill.me.in.'
41 # the next two are only used for the standalone HTTP server.
42 if not HTTP_HOST:
43     HTTP_HOST = ''
44 if not HTTP_PORT:
45     HTTP_PORT = 9080
47 # This is the directory that the database is going to be stored in
48 DATABASE = os.path.join(INSTANCE_HOME, 'db')
50 # This is the directory that the HTML templates reside in
51 TEMPLATES = os.path.join(INSTANCE_HOME, 'html')
53 # A descriptive name for your roundup instance
54 INSTANCE_NAME = 'Roundup issue tracker'
56 # The email address that mail to roundup should go to
57 ISSUE_TRACKER_EMAIL = 'issue_tracker@%s'%MAIL_DOMAIN
59 # The web address that the instance is viewable at
60 ISSUE_TRACKER_WEB = 'http://some.useful.url/'
62 # The email address that roundup will complain to if it runs into trouble
63 ADMIN_EMAIL = 'roundup-admin@%s'%MAIL_DOMAIN
65 # Somewhere for roundup to log stuff internally sent to stdout or stderr
66 LOG = os.path.join(INSTANCE_HOME, 'roundup.log')
68 # Where to place the web filtering HTML on the index page
69 FILTER_POSITION = 'bottom'      # one of 'top', 'bottom', 'top and bottom'
71 # Deny or allow anonymous access to the web interface
72 ANONYMOUS_ACCESS = 'deny'       # either 'deny' or 'allow'
74 # Deny or allow anonymous users to register through the web interface
75 ANONYMOUS_REGISTER = 'deny'     # either 'deny' or 'allow'
77 # Deny or allow anonymous users to register through the mail interface
78 ANONYMOUS_REGISTER_MAIL = 'deny'     # either 'deny' or 'allow'
80 # Send nosy messages to the author of the message
81 MESSAGES_TO_AUTHOR = 'no'       # either 'yes' or 'no'
83 # Where to place the email signature
84 EMAIL_SIGNATURE_POSITION = 'bottom'
86 # Default class to use in the mailgw if one isn't supplied in email
87 # subjects. To disable, comment out the variable below or leave it blank.
88 # Examples:
89 MAIL_DEFAULT_CLASS = 'issue'   # use "issue" class by default
90 #MAIL_DEFAULT_CLASS = ''        # disable (or just comment the var out)
92 # Define what index links are available in the header, and what their
93 # labels are. Each key is used to look up one of the index specifications
94 # below - so 'DEFAULT' will use 'DEFAULT_INDEX'.
95 # Where the FILTERSPEC has 'assignedto' with a value of None, it will be
96 # replaced by the id of the logged-in user.
97 HEADER_INDEX_LINKS = ['DEFAULT', 'UNASSIGNED', 'USER']
99 # list the classes that users are able to add nodes to
100 HEADER_ADD_LINKS = ['issue']
102 # Now the DEFAULT display specification. TODO: describe format
103 DEFAULT_INDEX = {
104   'LABEL': 'All Issues',
105   'CLASS': 'issue',
106   'SORT': ['-activity'],
107   'GROUP': ['priority'],
108   'FILTER': ['status'],
109   'COLUMNS': ['id','activity','title','creator','assignedto'],
110   'FILTERSPEC': {
111     'status': ['-1', '1', '2', '3', '4', '5', '6', '7'],
112   },
115 # The "unsassigned issues" index
116 UNASSIGNED_INDEX = {
117   'LABEL': 'Unassigned Issues',
118   'CLASS': 'issue',
119   'SORT': ['-activity'],
120   'GROUP': ['priority'],
121   'FILTER': ['status', 'assignedto'],
122   'COLUMNS': ['id','activity','title','creator','status'],
123   'FILTERSPEC': {
124     'status': ['-1', '1', '2', '3', '4', '5', '6', '7'],
125     'assignedto': ['-1'],
126   },
129 # The "my issues" index -- note that the user's id will replace the None
130 # valud of the "assignedto" filterspec
131 USER_INDEX = {
132   'LABEL': 'My Issues',
133   'CLASS': 'issue',
134   'SORT': ['-activity'],
135   'GROUP': ['priority'],
136   'FILTER': ['status', 'assignedto'],
137   'COLUMNS': ['id','activity','title','creator','status'],
138   'FILTERSPEC': {
139     'status': ['-1', '1', '2', '3', '4', '5', '6', '7'],
140     'assignedto': None,
141   },
146 # $Log: not supported by cvs2svn $
147 # Revision 1.12  2002/02/15 00:13:38  richard
148 #  . #503204 ] mailgw needs a default class
149 #     - partially done - the setting of additional properties can wait for a
150 #       better configuration system.
152 # Revision 1.11  2002/02/14 23:46:02  richard
153 # . #516883 ] mail interface + ANONYMOUS_REGISTER
155 # Revision 1.10  2001/11/26 22:55:56  richard
156 # Feature:
157 #  . Added INSTANCE_NAME to configuration - used in web and email to identify
158 #    the instance.
159 #  . Added EMAIL_SIGNATURE_POSITION to indicate where to place the roundup
160 #    signature info in e-mails.
161 #  . Some more flexibility in the mail gateway and more error handling.
162 #  . Login now takes you to the page you back to the were denied access to.
164 # Fixed:
165 #  . Lots of bugs, thanks Roché and others on the devel mailing list!
167 # Revision 1.9  2001/10/30 00:54:45  richard
168 # Features:
169 #  . #467129 ] Lossage when username=e-mail-address
170 #  . #473123 ] Change message generation for author
171 #  . MailGW now moves 'resolved' to 'chatting' on receiving e-mail for an issue.
173 # Revision 1.8  2001/10/23 01:00:18  richard
174 # Re-enabled login and registration access after lopping them off via
175 # disabling access for anonymous users.
176 # Major re-org of the htmltemplate code, cleaning it up significantly. Fixed
177 # a couple of bugs while I was there. Probably introduced a couple, but
178 # things seem to work OK at the moment.
180 # Revision 1.7  2001/10/22 03:25:01  richard
181 # Added configuration for:
182 #  . anonymous user access and registration (deny/allow)
183 #  . filter "widget" location on index page (top, bottom, both)
184 # Updated some documentation.
186 # Revision 1.6  2001/10/01 06:10:42  richard
187 # stop people setting up roundup with our addresses as default - need to
188 # handle this better in the init
190 # Revision 1.5  2001/08/07 00:24:43  richard
191 # stupid typo
193 # Revision 1.4  2001/08/07 00:15:51  richard
194 # Added the copyright/license notice to (nearly) all files at request of
195 # Bizar Software.
197 # Revision 1.3  2001/08/02 06:38:17  richard
198 # Roundupdb now appends "mailing list" information to its messages which
199 # include the e-mail address and web interface address. Templates may
200 # override this in their db classes to include specific information (support
201 # instructions, etc).
203 # Revision 1.2  2001/07/29 07:01:39  richard
204 # Added vim command to all source so that we don't get no steenkin' tabs :)
206 # Revision 1.1  2001/07/23 23:28:43  richard
207 # Adding the classic template
209 # Revision 1.1  2001/07/23 04:33:21  anthonybaxter
210 # split __init__.py into 2. dbinit and instance_config.
213 # vim: set filetype=python ts=4 sw=4 et si