home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 May / PCWorld_1999-05_cd.bin / Komunik / PMailCz / pm32 / WPMSETUP.DAT < prev   
Text File  |  1999-04-12  |  17KB  |  338 lines
  1. ;
  2. ;  WPMSETUP.DAT
  3. ;  Sample ISP Setup file for Pegasus Mail for Windows v2.53 and later.
  4. ;
  5. ;  This file contains instructions for both the WinPMail Setup program,
  6. ;  and for the WinPMail WPMSETUP Extension, and is intended to be used
  7. ;  by service providers and network administrators to provide default
  8. ;  values for Pegasus Mail's setup and preferences.
  9. ;
  10. ;  The file looks like a Windows INI file to some extent, but is actually
  11. ;  handled differently; It is divided into sections, where each section
  12. ;  has a heading like this: "[Section-name]" on a line of its own. The
  13. ;  sections that can be found in this file are:
  14. ;
  15. ;      [Setup]   - instructions to the WinPMail setup program
  16. ;      [Prolog]  - text for a preamble dialog
  17. ;      [Prompt]  - create a dialog to prompt the user for information
  18. ;      [Script]  - instructions for setting up WinPMail's preferences
  19. ;
  20. ;  All the sections are optional - so, it is legitimate to have only a
  21. ;  "[Script]" section if you don't need to prompt the user for any data.
  22. ;
  23. ;  1: The [Setup] Section
  24. ;  The [Setup] section is read by the WinPMail setup program if WPMSETUP.DAT
  25. ;  is in the same directory as SETUP.EXE; it can also be placed in SETUP.DAT,
  26. ;  but WPMSETUP.DAT is used preferentially if it is present. The [Setup]
  27. ;  section can contain the following commands:
  28. ;
  29. ;      Set WinPMail directory = <d:\path>
  30. ;        - Set the location where WinPMail will be installed
  31. ;          (the default is C:\PMAIL)
  32. ;      Set WinPMail directory prompt = <Y|N>
  33. ;        - If 'Y', then setup will not ask the user to enter the
  34. ;          location where WinPMail should be installed and will use the
  35. ;          current or default value instead.
  36. ;      Set NetWare = <Y|N>
  37. ;        - If 'N', then setup will not offer the choice of installing
  38. ;          in NetWare mode and will force installation in standalone mode.
  39. ;      Set US Dictionary = <Y|N>
  40. ;        - If 'Y', Setup will install the US English dictionary as
  41. ;          the default for the spelling checker, otherwise the UK English
  42. ;          dictionary will be the default. If this option is present,
  43. ;          setup will not prompt the user for the choice.
  44. ;      Set Mailto Handler = <Y|N>
  45. ;        - If 'Y', Setup will install WinPMail in the Registry as the 
  46. ;          default handler for MAILTO: urls, which will allow it to act
  47. ;          as the mail front end for MS Internet Explorer. There is
  48. ;          usually no reason to set this to 'N'.
  49. ;      Set copy files = <Y|N>
  50. ;        - If 'N', setup will default to not copying the WinPMail program
  51. ;          files on its final setup screen.
  52. ;      Set create group = <Y|N>
  53. ;        - Set the default value of the control in the final setup dialog
  54. ;          that determines whether or not distribution files are copied.
  55. ;      Set manifest check = <Y|N>
  56. ;        - Tells setup whether or not to verify that all the files that
  57. ;          should be present actually are present. If set to 'N', no check
  58. ;          will be done but file copying will not be possible.
  59. ;      Set default user setup = <Y|N>
  60. ;          If this command is present and set to 'Y', then SETUP will
  61. ;          preconfigure the installed copy of Pegasus Mail with the
  62. ;          following values:
  63. ;           - WinPMail will start in Multi-user standalone mode
  64. ;           - Mailbox directories will be located in a subdirectory
  65. ;             called "MAIL" in the directory where WINPMAIL.EXE is
  66. ;             installed
  67. ;           - An administrative user called "Admin" will be automatically
  68. ;             created, and an icon added to the program manager group
  69. ;             that runs Pegasus Mail as that user.
  70. ;
  71. ;  2: The [Prolog] Section
  72. ;  This optional section allows you to put up an initial informational
  73. ;  dialog prior to entering the prompt screen. The section should contain
  74. ;  three lines of text - a title and two descriptive entries. If present,
  75. ;  the prolog dialog is displayed showing the text you provide and your
  76. ;  bitmap (if any). The user proceeds to the prompt screen by clicking
  77. ;  on a "Next >" button.
  78. ;
  79. ;  3: The [Prompt] Section
  80. ;  This section allows you to create a dialog that the WPMSETUP Extension
  81. ;  will present to the user prompting him or her for information. You can
  82. ;  prompt for up to nine separate pieces of information, then substitute
  83. ;  that information into any preferences field later when the [Script]
  84. ;  section is processed. The [Prompt] section can contain from 1 to 9
  85. ;  commands in the following format:
  86. ;
  87. ;     prompt <T|P|C> <"Prompt text"> ["Default"]
  88. ;        -  "T" means to present the item as a text field
  89. ;        -  "P" means to present the item as a password field
  90. ;        -  "C" means to present the item as a checkbox
  91. ;        -  "Prompt text" is a short string describing the field, and
  92. ;           is used as a caption for the associated control.
  93. ;        -  "Default" is an optional default value for the entry.
  94. ;
  95. ;  The WPMSETUP extension will create a dialog based on the "prompt"
  96. ;  statements in the file and allow the user to edit them. The value
  97. ;  entered by the user in response to each prompt statement is stored
  98. ;  in the internal variables v1 through to v9, in the order in which
  99. ;  the prompt statements appear in the file.
  100. ;
  101. ;  4: The [Script] Section
  102. ;  This section is processed after the WPMSETUP Extension has prompted
  103. ;  the user to enter the information requested in the [Prompt] section.
  104. ;  It can contain the following commands:
  105. ;
  106. ;     set <preference_variable> = <value>
  107. ;       - Set an internal WinPMail preferences or configuration string
  108. ;         with the data in "value". See below for a list of the possible
  109. ;         "preference_variables".
  110. ;     mkdir <path>
  111. ;       - Create a directory
  112. ;     copy <sourcefile> <destfile>
  113. ;       - Copy a file
  114. ;     write <filename> <string>
  115. ;       - The string "string" is appended to the file <filename>. If the
  116. ;         file does not exist, it is created. Both the filename and the
  117. ;         string can contain substitutions. This command is a handy way
  118. ;         of creating signature files (for instance, INETSIG.PM in the
  119. ;         user's home mail directory, for Internet mail).
  120. ;     run <commandline>
  121. ;       - Run a program; "commandline" is the command string passed to
  122. ;         the Windows "WinExec" function - it may be a DOS or a Windows
  123. ;         program and may have commandline parameters.
  124. ;
  125. ;  Substitutions: you can replace any variable value in the [Script]
  126. ;  section with user-supplied or system-level information using 
  127. ;  substitution strings. If you have ever used a Pegasus Mail gateway,
  128. ;  then these substitutions should be mostly familiar to you already.
  129. ;  The following substitutions are possible:
  130. ;
  131. ;  When this is seen...    This is substituted
  132. ;  -------------------------------------------------------------------
  133. ;     ~n                   the user's username in its simplest form.
  134. ;     ~8                   user's object name truncated to 8 chars
  135. ;     ~d                   a random integer, expressed as 4 hex digits
  136. ;     ~%name%              the value of environment variable %name%
  137. ;     ~p                   the user's personal name preference
  138. ;     ~a                   the directory where WINPMAIL.EXE is located
  139. ;     ~h                   the current user's home mailbox
  140. ;     ~w                   the current user's new mailbox
  141. ;     ~vX                  the value of variable "X" (0 < x < 10)
  142. ;     ~~                   a single tilde (~).
  143. ;
  144. ;  So, for example, if you have the line:
  145. ;
  146. ;     set Alternative From: field for message = ~8@~v1
  147. ;
  148. ;  Then if the current user's username is "peter" and the user has been
  149. ;  prompted for a domain name in variable #1, entering "foo.bar.com",
  150. ;  then the string will be set in his profile as "peter@foo.bar.com"
  151. ;
  152. ;  Preference variables: The [Script] section's "set" command expects
  153. ;  the name of an internal variable to be set by the command: this can
  154. ;  be given in one of two ways:
  155. ;
  156. ;     1: You can use the long name of the variable, which is identical to
  157. ;        the text found in PMAIL.INI representing the setting. You need
  158. ;        only use enough characters from the long name to identify the
  159. ;        variable uniquely - so, for instance, the preferences variable
  160. ;        "Tab width in message editor (0-disable)" can be abbreviated to
  161. ;        just "Tab width" if you wish.
  162. ;     2: You can use a numeric value for the variable.
  163. ;
  164. ;  So, the following three strings all have the same effect:
  165. ;
  166. ;     set Folder for copies to self = COPYSELF
  167. ;     set Folder for copies = COPYSELF
  168. ;     set 5 = COPYSELF
  169. ;
  170. ;  While you can set practically any program setting from the [Script]
  171. ;  section, you should normally be selective - most items in Pegasus Mail
  172. ;  have sensible default values and you should alter only those things
  173. ;  that actually need specific tailoring. Items not accessed by a "Set"
  174. ;  statement in the [Script] section are not touched at all - they retain
  175. ;  their current value. This ability to set items selectively makes the
  176. ;  WPMSETUP extension useful for propagating changes at any time, since
  177. ;  the user can always select it from the "Extensions" submenu of the
  178. ;  WinPMail "Tools" menu.
  179. ;
  180. ;  The following variable names (and their corresponding numeric values)
  181. ;  are recognized by the Setup extension
  182. ;
  183. ;  Personal name                                1
  184. ;  Default right margin                         2
  185. ;  Home mailbox location                        3
  186. ;  Copy to self                                 4
  187. ;  Folder for copies to self                    5
  188. ;  Commenting string                            6
  189. ;  Folder sort order                            7
  190. ;  Default reply-to address                     8
  191. ;  Reply field settings                         9
  192. ;  Edit mail before forwarding                 10
  193. ;  MHS mailbox name                            11
  194. ;  Request confirmation of reading             12
  195. ;  Startup directory                           13
  196. ;  MHS Application directory                   14
  197. ;  Scan MHS application directory              15
  198. ;  Open new mail folder at startup             16
  199. ;  Save deleted messages until exit            17
  200. ;  Prompt to select copy to self folder        18
  201. ;  Leave read mail in newmail folder           19
  202. ;  Address book sort order                     20
  203. ;  Require password at startup                 21
  204. ;  MHS address                                 22
  205. ;  Use MIME features                           23
  206. ;  Default MIME character set                  24
  207. ;  Encrypt copies-to-self of encrypted mail    25
  208. ;  Don't confirm message deletion              26
  209. ;  Enclose attachments instead of separating   27
  210. ;  Noticeboard sort order                      28
  211. ;  Lines to scan for message enclosures        29
  212. ;  Button panel mode                           30
  213. ;  Button panel is closed                      31
  214. ;  Button panel window rectangle               32
  215. ;  New mail folder window rectangle            33
  216. ;  Default signature for outgoing mail         34
  217. ;  Request confirmation of delivery            35
  218. ;  Application window frame is maximized       36
  219. ;  Application window rectangle                37
  220. ;  Editor window default width and depth       38
  221. ;  Reader window default width and depth       39
  222. ;  Font to use in message reader               40
  223. ;  Font to use in message editor               41
  224. ;  Font to use in folder browser               42
  225. ;  Font to use for printing                    43
  226. ;  Offer advanced reply options                44
  227. ;  Top/bottom margin for printing              45
  228. ;  Left/right margin for printing              46
  229. ;  Local user list window rectangle            47
  230. ;  Reformat hard line breaks in replies        48
  231. ;  Printer device name                         49
  232. ;  Printer driver name                         50
  233. ;  Printer port                                51
  234. ;  Tab width in message editor (0-disable)     52
  235. ;  Logged-in user list window rectangle        53
  236. ;  Save desktop state between sessions         54
  237. ;  Wrap long lines in message reader           55
  238. ;  Built-in POP3 transport options word        56
  239. ;  Don't autoload WINSOCK.DLL if found         57
  240. ;  Seconds between POP3 new mail checks        58
  241. ;  Seconds between regular new mail checks     59
  242. ;  Secondary organization name                 60
  243. ;  Timezone for internal transport             61
  244. ;  Refuse confirm-read requests (internal)     62
  245. ;  Telltale window mode                        63
  246. ;  Telltale window control word                64
  247. ;  Location of TLC of telltale window          65
  248. ;  DList Manager window rectangle              66
  249. ;  Noticeboard Manager window rectangle        67
  250. ;  Header printing setting                     68
  251. ;  Extensions manager window rectangle         69
  252. ;  WAV file for new mail sound alert           70
  253. ;  Folder manager window rectangle             71
  254. ;  Omit message headers when replying          72
  255. ;  Use custom header when replying             73
  256. ;  Custom header format string                 74
  257. ;  Allow 8bit MIME data (!discouraged!)        75
  258. ;  Font to use in folder manager window        76
  259. ;  Quick folder definition                     77
  260. ;  Quick folder operating flags                78
  261. ;  MHS directory service window rectangle      79
  262. ;  Use system colours                          80
  263. ;  Display hot URLs in reader                  81
  264. ;  Web Browser Commandline                     82
  265. ;  Message reader format options               83
  266. ;  Message editor format options               84
  267. ;  Message editor autosave interval            85
  268. ;  Default settings values                     86
  269. ;  New mail folder column widths               87
  270. ;  Combined multipart reader rectangle         88
  271. ;
  272. ;  Host where POP3 mail account is located   1001
  273. ;  POP3 mail account (username on host)      1002
  274. ;  Password for POP3 mail account            1003
  275. ;  Delete downloaded mail from host          1004
  276. ;  Largest message size to retrieve          1005
  277. ;  Directory to place incoming POP3 mail     1006
  278. ;  Transport control word                    1007
  279. ;  SMTP relay host for outgoing mail         1008
  280. ;  Search mask to locate outgoing messages   1009
  281. ;  Alternative From: field for message       1010
  282. ;  TCP/IP timeout value (seconds)            1011
  283. ;  TCP/IP server port                        1012
  284. ;  TCP/IP SMTP server port                   1013
  285. ;
  286. ;  Bitmaps:
  287. ;  You can include your own Bitmap in the WPMSETUP windows by creating
  288. ;  a 16-colour version of your logo, 140x120 pixels or smaller (WPMSETUP
  289. ;  will centre the bitmap if it is smaller) and placing it in the same
  290. ;  location as WPMSETUP.DAT under the name WPMSETUP.BMP. If you do not
  291. ;  provide a bitmap file, WPMSETUP will use a Pegasus Mail bitmap by
  292. ;  default.
  293. ;
  294.  
  295.  
  296.  
  297. [Prolog]
  298. EUnet-Czechia Setup.
  299. This wizard will prepare Pegasus Mail for use with EUnet services.
  300. Tento program vam pomuze nastavit Pegasus Mail pro pouzivani sluzeb EUnet Czechia.
  301.  
  302.  
  303. [Prompt]
  304. prompt T "Your personal name - Vase jmeno"
  305. prompt T "Your login name - Vas login " 
  306. prompt P "Your password - Vase heslo"
  307. prompt T "Your e-mail address - Vase e-mailova adresa" "@traveller.cz"
  308. prompt T "SMTP/POP3 server" "traveller.cz"
  309. ;prompt T "Enter POP3 server" "traveller.cz"
  310. ;prompt C "Delete downloaded mail" "Y"
  311.  
  312.  
  313. [Script]
  314. ;mkdir c:\pmail\foobar\mail
  315. set Personal name = ~v1
  316. set POP3 mail account = ~v2
  317. set Password for POP3 mail account = ~v3
  318. set Alternative From: field for message = ~v4
  319. set SMTP relay host = ~v5
  320. set Host where POP3 = ~v5
  321. ;set Delete downloaded mail = ~v7
  322. ;set Largest message size = 1024000
  323. :set TCP/IP timeout value = 150
  324. set TCP/IP server port = 110
  325. set TCP/IP SMTP server port = 25
  326. set Save deleted messages = 1
  327. set Font to use in message reader             = Arial CE, 16, 0
  328. set Font to use in message editor             = Arial CE, 15, 0
  329. set Font to use in folder browser             = Arial CE, 14, 0
  330. set Font to use for printing                  = Arial CE, 15, 0
  331. set Font to use in folder manager window      = Arial CE, 15, 0
  332. ;set Copy to self                              = Y
  333. ;set 86 = 0010000000000000
  334. set Save deleted messages until exit = Y
  335. set Use MIME features = Y
  336. set Default MIME character set = ISO-8859-2
  337. set Wrap long lines in message reader = Y
  338.