This is a manual merge of branch drop split view intro trunk.
[modest] / src / modest-defs.h
1 /* Copyright (c) 2006, Nokia Corporation
2  * All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  * * Redistributions of source code must retain the above copyright
9  *   notice, this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright
11  *   notice, this list of conditions and the following disclaimer in the
12  *   documentation and/or other materials provided with the distribution.
13  * * Neither the name of the Nokia Corporation nor the names of its
14  *   contributors may be used to endorse or promote products derived from
15  *   this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
18  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20  * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
21  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29
30
31 #ifndef __MODEST_DEFS_H__
32 #define __MODEST_DEFS_H__
33
34 #include <config.h>
35 #include <glib/gi18n.h>
36
37 /* Some interesting directories. NOTE, they should be prefixed
38  * with $HOME; Also, except for MODEST_DIR itself, they
39  * need to be prefixed with MODEST_DIR;
40  * The parts of the path are separate for crossplatform
41  * building of dirs from their components.
42  * g_build_dir is your friend
43  */
44 #define MODEST_DIR                        ".modest"
45 #define MODEST_CACHE_DIR                  "cache"
46 #define MODEST_IMAGES_CACHE_DIR           "images"
47 #define MODEST_IMAGES_CACHE_SIZE          (1024*1024)
48
49 #define MODEST_LOCAL_FOLDERS_ACCOUNT_ID   "local_folders"
50 #define MODEST_LOCAL_FOLDERS_ACCOUNT_NAME MODEST_LOCAL_FOLDERS_ACCOUNT_ID
51
52 /** Sent, Drafts, etc, are on-disk 
53  * but not outbox, because outbox is a virtual folder merged from the 
54  * various outboxes/<account-name>/outbox folders.
55  */
56 #define MODEST_LOCAL_FOLDERS_MAILDIR      MODEST_LOCAL_FOLDERS_ACCOUNT_ID
57
58 /** There is an outboxes/<account-name>/outbox/ folder for each account,
59  * though we merge them so that the user sees only one outbox.
60  */
61 #define MODEST_PER_ACCOUNT_LOCAL_OUTBOX_FOLDER_ACCOUNT_ID_PREFIX "outboxes"
62 #define MODEST_PER_ACCOUNT_LOCAL_OUTBOX_FOLDERS_MAILDIR MODEST_PER_ACCOUNT_LOCAL_OUTBOX_FOLDER_ACCOUNT_ID_PREFIX
63
64 #define MODEST_MMC_ACCOUNT_ID             "mcc"
65
66 /* Without the trailing / because gnome-vfs reports mounted 
67  * volume URIs without the trailing, and we want to match them: */
68 #define MODEST_MMC1_VOLUMEPATH_ENV        "MMC_MOUNTPOINT" 
69 #define MODEST_MMC1_VOLUMEPATH_URI_PREFIX "file://"
70
71 /* configuration key definitions for modest */
72 #define MODEST_CONF_NAMESPACE           "/apps/modest"
73
74 /* the mapping files, there are two possibilities; used in modest_maemo_open_mcc_mapping_file */
75 #define MODEST_MCC_MAPPING                 PREFIX "/share/modest/provider-data/mcc_mapping"
76 #define MODEST_OPERATOR_WIZARD_MCC_MAPPING "/usr/share/operator-wizard/mcc_mapping"
77
78 #define MODEST_PROVIDER_DATA_FILE         PREFIX "/share/modest/provider-data/modest-provider-data.keyfile"  
79 #define MODEST_MAEMO_PROVIDER_DATA_FILE   PREFIX "/share/modest/provider-data/maemo-provider-data.keyfile"  
80
81
82 #ifndef MODEST_TOOLKIT_GTK
83 #define MODEST_ICON_SIZE_SMALL            26
84 #define MODEST_ICON_SIZE_BIG              64
85 #else
86 #define MODEST_ICON_SIZE_SMALL            16
87 #define MODEST_ICON_SIZE_BIG              32
88 #endif
89
90 /* configuration key definitions for modest */
91 #define MODEST_ACCOUNT_NAMESPACE         MODEST_CONF_NAMESPACE "/accounts"
92 #define MODEST_CONF_DEFAULT_ACCOUNT      MODEST_CONF_NAMESPACE "/default_account"
93
94 /* Not used: #define MODEST_CONF_CONNECT_AT_STARTUP   MODEST_CONF_NAMESPACE "/connect_at_startup" */      
95
96 #define MODEST_CONF_SHOW_CC              MODEST_CONF_NAMESPACE "/show_cc"           
97 #define MODEST_CONF_SHOW_BCC             MODEST_CONF_NAMESPACE "/show_bcc"           
98
99 /* This is the alarmd cookie, obtained from alarm_event_add(), 
100  * which apparently remains valid between application instances.
101  * We store it so that we can remove it later.
102  */
103 #define MODEST_CONF_ALARM_ID MODEST_CONF_NAMESPACE "/alarm_id"
104
105 /*
106  * in the maemo case, we try to replace this
107  * with the device name
108  */
109 #define MODEST_LOCAL_FOLDERS_DEFAULT_DISPLAY_NAME  N_("Local folders")
110
111 /* the name of the device; in case of maemo this is set and updated
112  * using dbus; see modest-maemo-utils.[ch]
113  */
114 #define MODEST_CONF_DEVICE_NAME       MODEST_CONF_NAMESPACE "/device_name"
115
116
117 /* place for widget settings */
118 #define MODEST_CONF_WIDGET_NAMESPACE     MODEST_CONF_NAMESPACE "/widgets"
119 #define MODEST_CONF_FOLDER_VIEW_KEY      "folder-view"
120 #define MODEST_CONF_HEADER_VIEW_KEY      "header-view"
121 #define MODEST_CONF_MAIN_PANED_KEY       "modest-main-paned"
122 #define MODEST_CONF_MSG_PANED_KEY        "modest-msg-paned"
123 #define MODEST_CONF_FOLDER_PANED_KEY     "modest-folder-paned"
124 #define MODEST_CONF_MAIN_WINDOW_KEY      "modest-main-window"
125 #define MODEST_CONF_EDIT_WINDOW_KEY      "modest-edit-msg-window"
126 #define MODEST_CONF_MSG_VIEW_WINDOW_KEY  "modest-msg-view-window"
127
128 #define MODEST_SERVER_ACCOUNT_NAMESPACE  MODEST_CONF_NAMESPACE "/" "server_accounts"
129
130 /* show toolbar settings */
131 #define MODEST_CONF_MAIN_WINDOW_SHOW_TOOLBAR MODEST_CONF_WIDGET_NAMESPACE "/" MODEST_CONF_MAIN_WINDOW_KEY "/show_toolbar"
132 #define MODEST_CONF_EDIT_WINDOW_SHOW_TOOLBAR MODEST_CONF_WIDGET_NAMESPACE "/" MODEST_CONF_EDIT_WINDOW_KEY "/show_toolbar"
133 #define MODEST_CONF_MSG_VIEW_WINDOW_SHOW_TOOLBAR MODEST_CONF_WIDGET_NAMESPACE "/" MODEST_CONF_MSG_VIEW_WINDOW_KEY "/show_toolbar"
134 #define MODEST_CONF_MAIN_WINDOW_SHOW_TOOLBAR_FULLSCREEN MODEST_CONF_WIDGET_NAMESPACE "/" MODEST_CONF_MAIN_WINDOW_KEY "/show_toolbar_fullscreen"
135 #define MODEST_CONF_EDIT_WINDOW_SHOW_TOOLBAR_FULLSCREEN MODEST_CONF_WIDGET_NAMESPACE "/" MODEST_CONF_EDIT_WINDOW_KEY "/show_toolbar_fullscreen"
136 #define MODEST_CONF_MSG_VIEW_WINDOW_SHOW_TOOLBAR_FULLSCREEN MODEST_CONF_WIDGET_NAMESPACE "/" MODEST_CONF_MSG_VIEW_WINDOW_KEY "/show_toolbar_fullscreen"
137
138 /* per-account data */
139 #define MODEST_ACCOUNT_DISPLAY_NAME      "display_name"      /* string */
140 #define MODEST_ACCOUNT_STORE_ACCOUNT     "store_account"     /* string */
141 #define MODEST_ACCOUNT_TRANSPORT_ACCOUNT "transport_account" /* string */
142 #define MODEST_ACCOUNT_FULLNAME          "fullname"          /* string */
143 #define MODEST_ACCOUNT_EMAIL             "email"             /* string */
144
145 /* This is a list of strings, with each strings, 
146  * alernating between a connection name, followed by a corresponding server account name.
147  * That's not pretty, but it's nicer than dealing with escaping of a = separator if 
148  * putting them both in one string. */
149 #define MODEST_CONF_CONNECTION_SPECIFIC_SMTP_LIST MODEST_CONF_NAMESPACE "/specific_smtp" /* one list used for all accounts. */
150 #define MODEST_ACCOUNT_USE_CONNECTION_SPECIFIC_SMTP  "use_specific_smtp" /* boolean */
151
152 /* server account keys */
153 #define MODEST_ACCOUNT_PASSWORD          "password"          /* string */
154 #define MODEST_ACCOUNT_REMEMBER_PWD      "remember_pwd"      /* boolean */
155 #define MODEST_ACCOUNT_HOSTNAME          "hostname"          /* string */
156 #define MODEST_ACCOUNT_USERNAME          "username"          /* string */
157 #define MODEST_ACCOUNT_USERNAME_HAS_SUCCEEDED          "username_succeeded"          /* string */
158 #define MODEST_ACCOUNT_USE_SIGNATURE         "use_signature"         /* boolean */
159 #define MODEST_ACCOUNT_SIGNATURE         "signature"         /* string */
160
161 /* Only used for mbox and maildir accounts: */
162 #define MODEST_ACCOUNT_URI               "uri"               /* string */
163
164 #define MODEST_ACCOUNT_PROTO             "proto"             /* string */
165 #define MODEST_ACCOUNT_ENABLED           "enabled"           /* boolean */
166 #define MODEST_ACCOUNT_TYPE              "type"              /* string */
167 #define MODEST_ACCOUNT_LAST_UPDATED      "last_updated"      /* int */
168
169 #define MODEST_ACCOUNT_LEAVE_ON_SERVER   "leave_on_server"   /* boolean */
170 #define MODEST_ACCOUNT_PREFERRED_CNX     "preferred_cnx"     /* string */
171 #define MODEST_ACCOUNT_PORT                      "port"              /* int */
172
173 #define MODEST_ACCOUNT_AUTH_MECH         "auth_mech"         /* string */
174 #define MODEST_ACCOUNT_AUTH_MECH_VALUE_NONE "none"
175 #define MODEST_ACCOUNT_AUTH_MECH_VALUE_PASSWORD "password"
176 #define MODEST_ACCOUNT_AUTH_MECH_VALUE_CRAMMD5 "cram-md5"
177
178 #define MODEST_ACCOUNT_RETRIEVE  "retrieve"          /* string */
179 #define MODEST_ACCOUNT_RETRIEVE_VALUE_HEADERS_ONLY "headers-only"
180 #define MODEST_ACCOUNT_RETRIEVE_VALUE_MESSAGES "messages"
181 #define MODEST_ACCOUNT_RETRIEVE_VALUE_MESSAGES_AND_ATTACHMENTS "messages-and-attachments"
182
183 #define MODEST_ACCOUNT_LIMIT_RETRIEVE    "limit-retrieve"            /* int */
184
185 #define MODEST_ACCOUNT_SECURITY "security"
186 #define MODEST_ACCOUNT_SECURITY_VALUE_NONE "none"
187 #define MODEST_ACCOUNT_SECURITY_VALUE_NORMAL "normal" /* Meaning "Normal (TLS)", as in our UI spec. */ 
188 #define MODEST_ACCOUNT_SECURITY_VALUE_SSL "ssl"
189
190 /* Macros for different text formats in mail editor */
191 #define MODEST_FILE_FORMAT_PLAIN_TEXT 0
192 #define MODEST_FILE_FORMAT_FORMATTED_TEXT 1
193
194 /* Global settings */
195 #define MODEST_CONF_AUTO_UPDATE MODEST_CONF_NAMESPACE "/auto_update" /* bool */
196 #define MODEST_CONF_UPDATE_WHEN_CONNECTED_BY MODEST_CONF_NAMESPACE "/update_when_connected_by" /* int */
197 #define MODEST_CONF_UPDATE_INTERVAL MODEST_CONF_NAMESPACE "/update_interval" /* int */
198 #define MODEST_CONF_MSG_SIZE_LIMIT MODEST_CONF_NAMESPACE "/msg_size_limit" /* int */
199 #define MODEST_CONF_PLAY_SOUND_MSG_ARRIVE MODEST_CONF_NAMESPACE "/play_sound_msg_arrive" /* bool */
200 #define MODEST_CONF_PREFER_FORMATTED_TEXT MODEST_CONF_NAMESPACE "/prefer_formatted_text" /* bool */
201 #define MODEST_CONF_REPLY_TYPE           MODEST_CONF_NAMESPACE "/reply_type"        /*  int  */
202 #define MODEST_CONF_FORWARD_TYPE         MODEST_CONF_NAMESPACE "/forward_type"      /*  int  */
203
204 /* hidden global settings */
205 #define MODEST_CONF_FETCH_HTML_EXTERNAL_IMAGES MODEST_CONF_NAMESPACE "/fetch_external_images" /* bool */
206
207 /* Notification ids */
208 #define MODEST_CONF_NOTIFICATION_IDS MODEST_CONF_NAMESPACE "/notification_ids"      /* list of ints */
209
210
211 #define MODEST_EXAMPLE_EMAIL_ADDRESS "first.last@example.com"
212
213
214 /* max size of message we still allow to save/send when we're in low-mem
215  * condition
216  */
217 #define MODEST_MAX_LOW_MEMORY_MESSAGE_SIZE (25*1024)
218 #define MODEST_MAX_ATTACHMENT_SIZE (15*1024*1024)
219
220 #endif /*__MODEST_DEFS_H__*/