Thunderbird:Autoconfiguration:ConfigFileFormat: Difference between revisions

spelling
(→‎OAuth2: Scope)
(spelling)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Author: [[User:BenB|Ben Bucksch]]. Please do not change this doc without checking with the author.
Author: [[User:BenB|Ben Bucksch]]. Please do not change this doc without checking with the author.


This page is the authorative specification of the config file that the Mozilla ISPDB and config services at ISPs return.
This page is the authoritative specification of the config file that the Mozilla ISPDB and config services at ISPs return.


It is XML, with a clearly defined format, to be stable and usable by other mail clients, too. Update Aug 2010: In fact, [http://projects.gnome.org/evolution/ Evolution] and [http://userbase.kde.org/KMail KMail] and [http://www.kontact.org Kontact] now use it, too.
It is XML, with a clearly defined format, to be stable and usable by other mail clients, too. Update Aug 2010: In fact, [http://projects.gnome.org/evolution/ Evolution] and [http://userbase.kde.org/KMail KMail] and [http://www.kontact.org Kontact] now use it, too.
Line 108: Line 108:
         <password>optional: the user's password</password>
         <password>optional: the user's password</password>
       </outgoingServer>
       </outgoingServer>
      <!-- Add this only when users (who already have an account) have to
          do something manually before the account can work with IMAP/POP or SSL.
          Note: Per XML, & (ampersand) needs to be escaped to & a m p ;
          (without spaces).
          Not yet implemented, see bug 586364. -->
      <enable
        visiturl="https://mail.google.com/mail/?ui=2&amp;shva=1#settings/fwdandpop">
        <instruction>Check 'Enable IMAP and POP' in Google settings page</instruction>
        <instruction lang="de">Schalten Sie 'IMAP und POP aktivieren' auf der Google Einstellungs-Seite an</instruction>
      </enable>


       <!-- A page where the ISP describes the configuration.
       <!-- A page where the ISP describes the configuration.
Line 126: Line 137:
     </emailProvider>
     </emailProvider>


     <!-- Syncronize the user's address book / contacts. Not yet implemented. -->
     <!-- Syncronize the user's address book / contacts. Not implemented. Thunderbird uses RFC 6764 to do auto discovery. -->
    <!-- TODO: delete this section!! -->
     <addressBook type="carddav">
     <addressBook type="carddav">
       <username>%EMAILADDRESS%</username>
       <username>%EMAILADDRESS%</username>
Line 143: Line 155:
     </addressBook>
     </addressBook>


     <!-- Syncronize the user's calendar. Not yet implemented. -->
     <!-- Syncronize the user's calendar. Not implemented. Thunderbird uses RFC 6764 to do auto discovery. -->
    <!-- TODO: delete this section!! -->
     <calendar type="caldav">
     <calendar type="caldav">
       <username>%EMAILADDRESS%</username>
       <username>%EMAILADDRESS%</username>
Line 150: Line 163:
     </calendar>
     </calendar>


     <!-- Upload files, allowing the user to share them. Not yet implemented.
     <!-- Upload files, allowing the user to share them. Not implemented.
         This can be used for Thunderbird's FileLink feature,
         This can be used for Thunderbird's FileLink feature,
         or to set up a file sync folder on the user's desktop. -->
         or to set up a file sync folder on the user's desktop. -->
    <!-- TODO: delete this section!! Obsoleted by RFC 6764. -->
     <fileShare type="webdav">
     <fileShare type="webdav">
       <username>%EMAILADDRESS%</username>
       <username>%EMAILADDRESS%</username>
Line 204: Line 218:
     <inputField key="USERNAME" label="Screen name"></inputField>
     <inputField key="USERNAME" label="Screen name"></inputField>
     <inputField key="GRANDMA" label="Grandma">Elise Bauer</inputField>
     <inputField key="GRANDMA" label="Grandma">Elise Bauer</inputField>
    <!-- Add this only when users (who already have an account) have to
        do something manually before the account can work with IMAP/POP or SSL.
        Note: Per XML, & (ampersand) needs to be escaped to & a m p ;
        (without spaces).
        Not yet implemented, see bug 586364. -->
    <enable
      visiturl="https://mail.google.com/mail/?ui=2&amp;shva=1#settings/fwdandpop">
      <instruction>Check 'Enable IMAP and POP' in Google settings page</instruction>
      <instruction lang="de">Schalten Sie 'IMAP und POP aktivieren' auf der Google Einstellungs-Seite an</instruction>
    </enable>


     <clientConfigUpdate url="https://www.example.com/config/mozilla.xml" />
     <clientConfigUpdate url="https://www.example.com/config/mozilla.xml" />