Thunderbird:Autoconfiguration:ConfigFileFormat: Difference between revisions

Add user input fields, usable as placeholders
(Intro)
(Add user input fields, usable as placeholders)
Line 19: Line 19:
       <displayShortName>GMail</displayShortName>
       <displayShortName>GMail</displayShortName>


      <inputfields>
        <inputfield key="USERNAME" label="Screen name"></field>
        <inputfield key="GRANDMA" label="Grandma">Elise Bauer</field>
        <!-- label will be shown to the user as description for the field
            It's not localizable (too much effort, and most ISPs are local).
            key can be used as placeholder in the settings (see below)
            The content can be empty or a default or example value.
            The example value may be the default text field content,
            shown as example next to the textfield, or not shown at all.
        -->
      </inputfields>
       <incomingServer type="pop3">
       <incomingServer type="pop3">
         <hostname>pop.googlemail.com</hostname>
         <hostname>pop.googlemail.com</hostname>
Line 35: Line 48:
                 GSSAPI (Kerberos v5),
                 GSSAPI (Kerberos v5),
             -->
             -->
        <displayName>Google Mail</displayName> <!-- needed? -->
         <pop3>
         <pop3>
            <!-- remove the following and leave to client/user? -->
             <leaveMessagesOnServer>true</leaveMessagesOnServer>
             <leaveMessagesOnServer>true</leaveMessagesOnServer>
             <deleteMailLeftOnServer>false</deleteMailLeftOnServer>
             <deleteMailLeftOnServer>false</deleteMailLeftOnServer>
            <authentication>plain</authentication> <!-- todo list -->
         </pop3>
         </pop3>
        <!-- remove the following and leave to client/user? -->
        <loginAtStartUp>true</loginAtStartUp>
        <downloadDuringNewMailCheck>true</downloadDuringNewMailCheck>
        <rememberPassword>true</rememberPassword>
       </incomingServer>
       </incomingServer>


Line 51: Line 59:
         <port>587</port>
         <port>587</port>
         <socketType>TLS</socketType> <!-- see above -->
         <socketType>TLS</socketType> <!-- see above -->
         <username>%EMAILFIRSTPART%</username> <!-- if smtp-auth -->
         <username>%USERNAME%</username> <!-- if smtp-auth -->
         <authentication>smtp-auth</authentication>
         <authentication>smtp-auth</authentication>
             <!-- none (server grants access based on IP address),
             <!-- none (server grants access based on IP address),
Line 57: Line 65:
                 smtp-after-pop (authenticate to incoming mail server first
                 smtp-after-pop (authenticate to incoming mail server first
                 before contacting the smtp server)-->
                 before contacting the smtp server)-->
        <displayName>Google Mail</displayName> <!-- needed? -->
         <addThisServer>true</addThisServer>
         <addThisServer>true</addThisServer>
         <useGlobalPreferredServer>true</useGlobalPreferredServer>
         <useGlobalPreferredServer>true</useGlobalPreferredServer>
Line 67: Line 74:
               for its customers -->
               for its customers -->
       </identity>
       </identity>
      <!-- Will not be used with this proposal: -->
      <sampleEmail>example@googlemail.com</sampleEmail>
      <sampleUserName>example</sampleUserName>
      <usernameDescription>Google Mail Username</usernameDescription>


     <emailProvider>
     <emailProvider>
Line 84: Line 86:
* %EMAILDOMAIN% (email address, part after @)
* %EMAILDOMAIN% (email address, part after @)
* %REALNAME% (needed?)
* %REALNAME% (needed?)
* The key (surrounded by %) in <inputfield key="">
These placeholders can be used as value or value part in most settings which take a string.


TODO:
TODO:
* IMAP
* IMAP
* All settings and enum values
* All settings and enum values
Confirmed users
591

edits