contrib/mail.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <PwmdApplicationForm>
   3   <name>Create E-Mail Client Elements</name>
   4   <shortDescription>Elements for the SMTP, IMAP and POP protocols.</shortDescription>
   5   <description>
   6 &lt;p&gt;
   7 This wizard creates
   8 &lt;a href=&quot;https://gitlab.com/bjk/pwmd/wikis/&quot;&gt;pwmd&lt;/a&gt;
   9 elements for common e-mail protocols with authentication details.
  10 &lt;/p&gt;
  11 &lt;p&gt;
  12 Click &lt;em&gt;Next&lt;/em&gt; to proceed to fill out the form.
  13 Help is available by right-clicking on a form label.
  14 &lt;/p&gt;
  15   </description>
  16
  17   <!-- This ID is reserved by QPwmc. -->
  18   <formRow>
  19     <label>Pwmd socket:</label>
  20     <type>lineEdit</type>
  21     <placeholderText>Default</placeholderText>
  22     <value />
  23     <elementSelector />
  24     <id>pwmdSocket</id>
  25     <whatsThis>The pwmd server to connect to.</whatsThis>
  26   </formRow>
  27
  28   <!-- This ID is reserved by QPwmc. -->
  29   <formRow>
  30     <label>Pwmd filename:</label>
  31     <type>lineEdit</type>
  32     <placeholderText>Required</placeholderText>
  33     <value />
  34     <elementSelector />
  35     <id>pwmdFilename</id>
  36     <required />
  37     <whatsThis>The data file on the pwmd server to open. Required.</whatsThis>
  38   </formRow>
  39
  40   <!-- This ID is reserved by QPwmc. -->
  41   <formRow>
  42     <label>Root element:</label>
  43     <type>lineEdit</type>
  44     <placeholderText>Element path...</placeholderText>
  45     <value>mail</value>
  46     <elementSelector />
  47     <id>pwmdRootElement</id>
  48 <whatsThis>The root element for all other created elements. If not specified then the other elements will be created at the document root.</whatsThis>
  49   </formRow>
  50
  51   <formRow>
  52     <label>Account name:</label>
  53     <type>lineEdit</type>
  54     <placeholderText>Required</placeholderText>
  55     <value>myISP</value>
  56     <childOf>pwmdRootElement</childOf>
  57     <id>accountName</id>
  58     <required />
  59 <whatsThis>The name or label of the server to retrieve mail from. This field is required.</whatsThis>
  60   </formRow>
  61
  62   <formRow>
  63     <label>Hostname:</label>
  64     <type>lineEdit</type>
  65     <placeholderText>Required</placeholderText>
  66     <value>hostname.com</value>
  67     <element>hostname</element>
  68     <childOf>protocol</childOf>
  69     <id>hostname</id>
  70     <required />
  71     <whatsThis>The hostname of the mail server.</whatsThis>
  72   </formRow>
  73
  74   <formRow>
  75     <label>Protocol:</label>
  76     <type>radioButton</type>
  77     <radio>SMTP</radio>
  78     <radio>IMAP</radio>
  79     <radio>POP3</radio>
  80     <value>IMAP</value>
  81     <childOf>accountName</childOf>
  82     <id>protocol</id>
  83     <whatsThis>The protocol to create elements for.</whatsThis>
  84   </formRow>
  85
  86   <formRow>
  87     <label>Port:</label>
  88     <type>spinBox</type>
  89     <value>993</value>
  90     <element>port</element>
  91     <childOf>protocol</childOf>
  92     <id>port</id>
  93     <whatsThis>Usually port 993 is used for IMAP, port 110 for POP3 and port 25 for SMTP.</whatsThis>
  94   </formRow>
  95
  96   <formRow>
  97     <label>Username:</label>
  98     <type>lineEdit</type>
  99     <placeholderText>Required</placeholderText>
 100     <value />
 101     <element>username</element>
 102     <childOf>accountName</childOf>
 103     <id>username</id>
 104     <required />
 105     <whatsThis>The username to login as on the mail server. Required.</whatsThis>
 106   </formRow>
 107
 108   <formRow>
 109     <label>Password:</label>
 110     <type>lineEdit</type>
 111     <value />
 112     <element>password</element>
 113     <childOf>accountName</childOf>
 114     <id>password</id>
 115     <hiddenInput />
 116     <whatsThis>The password for the mail server.</whatsThis>
 117     <passwordGenerator />
 118     <expiry />
 119   </formRow>
 120
 121 </PwmdApplicationForm>