Difference between revisions of "Jabber Email Header"

From XMPP WIKI
Jump to navigation Jump to search
 
m (remove tab)
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Tell the world that you use Jabber by including a "Jabber-ID" header in your outgoing email. This page describes how to set that up in various email clients. (Feel free to add the config for your email client, just put them in alphabetical order please. :-)
Tell the world that you use XMPP by including a "Jabber-ID" header in your outgoing email. This page describes how to set that up in various email clients. (Feel free to add the config for your email client, just put them in alphabetical order please. :-)


Note well: RFC 2822 does not allow anything but US-ASCII text in email headers, so if you have a Jabber ID with Unicode characters in it, you will need to escape those! See the [http://www.xmpp.org/drafts/draft-saintandre-jabberid-00.html Internet-Draft] for details.
Note well: RFC 5322 does not allow anything but US-ASCII text in email headers, so if you have a Jabber ID with Unicode characters in it, you will need to escape those! See the [https://datatracker.ietf.org/doc/draft-saintandre-jabberid/ Internet-Draft] for details.
 
== Claws Mail ==
 
In [https://www.claws-mail.org/ Claws Mail], do the following:
 
# Configuration > Preferences > Message View > Text options
# Select Display headers in message view
# Add the "Jabber-ID" header
 
For adding the header in outgoing mails do the following:
 
# Click Configuration > Edit Accounts > Edit
# Select Send/Add user defined header
# Choose the "Jabber-ID" header
# Add the "Jabber-ID" header


== Emacs ==
== Emacs ==
Line 7: Line 22:
If you use mail-mode for composing mail, this should do the trick:
If you use mail-mode for composing mail, this should do the trick:


  (setq mail-default-headers
  (if (not (string-match "Jabber-ID" mail-default-headers))
      (concat "Jabber-ID: your-jid-here\n"
    (setq mail-default-headers
              mail-default-headers))
          (concat "Jabber-ID: your-jid-here\n"
                  mail-default-headers)))


If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick:
If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick:


  (setq message-default-headers
  (if (not (string-match "Jabber-ID" message-default-headers))
      (concat "Jabber-ID: your-jid-here\n"
    (setq message-default-headers
              message-default-headers))
  (concat "Jabber-ID: your-jid-here\n"
  message-default-headers)))
 
This works for mu4e:
 
(add-hook 'mu4e-compose-mode-hook
      (defun my-add-jabberid ()
          "Add a Jabber-ID header."
          (save-excursion (message-add-header (format "Jabber-ID: %s\n" "my-jid@my-server")))))
 
=== Displaying the header ===
 
This works in mu4e >= 1.12:
 
(add-to-list 'mu4e-header-info
    '(:jabber-id :name "Jabber-ID" :shortname "JID" :help "The Jabber ID" :sortable t))
(add-to-list 'mu4e-header-info-custom
    '(:jabber-id .
        ( :name "Jabber-ID"
          :shortname "JID"
          :help "The Jabber ID"
          :function (lambda (msg)
              (or (mu4e-fetch-field msg "Jabber-ID") "")))))
(setq mu4e-view-fields
    '(:from :to :cc :subject :flags :date :maildir :mailing-list :tags :jabber-id))
 
== Evolution ==
 
In [https://wiki.gnome.org/Apps/Evolution Evolution], do the following ([https://help.gnome.org/users/evolution/stable/mail-composer-custom-header-lines.html.en source]):
 
# Select Edit > Plugins
# Enable Custom Header
# Click the Configuratin tab.
# Add the "Jabber-ID" header
 
For adding the header in outgoing mails do the following:
 
# Click New > Mail Message
# Select Insert > Custom Header
# Choose the "Jabber-ID" header
== KMail ==
 
In [http://kmail.kde.org/ KMail], do the following:
 
# Select Settings > Configure KMail
# Go to the Composer category
# Select the Headers tab (some versions call this 'Message List')
# Click on New
# In the Name: field, type "Jabber-ID"
# In the Value: field, type "[your-jid-here]"
# Click OK


== Mail.app ==
== Mail.app ==
Line 22: Line 89:


# Open a terminal window
# Open a terminal window
# Construct a command like: <blockquote><code>defaults write com.apple.mail UserHeaders '{"Jabber-ID" = "your-jid-here";}'</code></blockquote>
# Construct a command like:  
defaults write com.apple.mail UserHeaders '{"Jabber-ID" = "your-jid-here";}'


== Mutt ==
== Mutt ==
Line 29: Line 97:


# Open your .muttrc file
# Open your .muttrc file
# In the Composing section (or wherever) add a line that reads <blockquote><code>my_hdr Jabber-ID: your-jid-here</code></blockquote>
# In the Composing section (or wherever) add a line that reads
my_hdr Jabber-ID: your-jid-here


=== Displaying the header ===
To show the header for incoming mails add the following to the .muttrc file:
unignore Jabber-ID


== Thunderbird ==
== Thunderbird ==
Line 37: Line 110:


# Open the Preferences
# Open the Preferences
# Click the Advanced tab
# Click the Advanced icon
# Click the General tab
# Click the Config Editor button
# Click the Config Editor button
# Right-click anywhere in the about:config window
# Right-click anywhere in the about:config window
# Select New -> String
# Select New -> String
# For the preference name, type "mail.identity.id.header.jid"
# For the preference name, type <code>mail.identity.id.header.jid</code>
# For the preference value, type "Jabber-ID: your-jid-here"
# For the preference value, type <code>Jabber-ID: your-jid-here</code>
# That's the first pref; now right-click anywhere in the about:config window
# That's the first pref; now right-click anywhere in the about:config window
# Select New -> String
# Select New -> String
# For the preference name, type "mail.identity.id.headers"
# For the preference name, type <code>mail.identity.id.headers</code>
# For the preference value, type "jid"
# For the preference value, type <code>jid</code>
# If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.)
# If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.)


Note: The text "jid" can be anything, as long as it's consistent
Note: In the preference name for Step 7 and the preference value for Step 12, the string "jid" can be anything, as long as the string is the same for both.
 
=== Displaying the header ===
 
The preference <code>mailnews.headers.extraExpandedHeaders</code> is a list of '''space'''-delimited additional headers to be shown in the header section of the message pane. To show the <code>Jabber-ID</code> header on messages, just add <code>Jabber-ID</code> to this preference.
 
== Mail Gateways ==
 
More e-mail header information in [[Email Gateway]] page.

Latest revision as of 23:00, 5 May 2024

Tell the world that you use XMPP by including a "Jabber-ID" header in your outgoing email. This page describes how to set that up in various email clients. (Feel free to add the config for your email client, just put them in alphabetical order please. :-)

Note well: RFC 5322 does not allow anything but US-ASCII text in email headers, so if you have a Jabber ID with Unicode characters in it, you will need to escape those! See the Internet-Draft for details.

Claws Mail

In Claws Mail, do the following:

  1. Configuration > Preferences > Message View > Text options
  2. Select Display headers in message view
  3. Add the "Jabber-ID" header

For adding the header in outgoing mails do the following:

  1. Click Configuration > Edit Accounts > Edit
  2. Select Send/Add user defined header
  3. Choose the "Jabber-ID" header
  4. Add the "Jabber-ID" header

Emacs

If you use mail-mode for composing mail, this should do the trick:

(if (not (string-match "Jabber-ID" mail-default-headers))
    (setq mail-default-headers
          (concat "Jabber-ID: your-jid-here\n"
                  mail-default-headers)))

If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick:

(if (not (string-match "Jabber-ID" message-default-headers))
    (setq message-default-headers
	  (concat "Jabber-ID: your-jid-here\n"
		  message-default-headers)))

This works for mu4e:

(add-hook 'mu4e-compose-mode-hook
     (defun my-add-jabberid ()
         "Add a Jabber-ID header."
         (save-excursion (message-add-header (format "Jabber-ID: %s\n" "my-jid@my-server")))))

Displaying the header

This works in mu4e >= 1.12:

(add-to-list 'mu4e-header-info
    '(:jabber-id :name "Jabber-ID" :shortname "JID" :help "The Jabber ID" :sortable t))
(add-to-list 'mu4e-header-info-custom
    '(:jabber-id .
        ( :name "Jabber-ID"
          :shortname "JID"
          :help "The Jabber ID"
          :function (lambda (msg)
              (or (mu4e-fetch-field msg "Jabber-ID") "")))))
(setq mu4e-view-fields
    '(:from :to :cc :subject :flags :date :maildir :mailing-list :tags :jabber-id))

Evolution

In Evolution, do the following (source):

  1. Select Edit > Plugins
  2. Enable Custom Header
  3. Click the Configuratin tab.
  4. Add the "Jabber-ID" header

For adding the header in outgoing mails do the following:

  1. Click New > Mail Message
  2. Select Insert > Custom Header
  3. Choose the "Jabber-ID" header

KMail

In KMail, do the following:

  1. Select Settings > Configure KMail
  2. Go to the Composer category
  3. Select the Headers tab (some versions call this 'Message List')
  4. Click on New
  5. In the Name: field, type "Jabber-ID"
  6. In the Value: field, type "[your-jid-here]"
  7. Click OK

Mail.app

In Apple's Mail.app program, do the following:

  1. Open a terminal window
  2. Construct a command like:
defaults write com.apple.mail UserHeaders '{"Jabber-ID" = "your-jid-here";}'

Mutt

In Mutt, do the following:

  1. Open your .muttrc file
  2. In the Composing section (or wherever) add a line that reads
my_hdr Jabber-ID: your-jid-here

Displaying the header

To show the header for incoming mails add the following to the .muttrc file:

unignore Jabber-ID

Thunderbird

In Thunderbird, you need to define two separate config options, so do the following:

  1. Open the Preferences
  2. Click the Advanced icon
  3. Click the General tab
  4. Click the Config Editor button
  5. Right-click anywhere in the about:config window
  6. Select New -> String
  7. For the preference name, type mail.identity.id.header.jid
  8. For the preference value, type Jabber-ID: your-jid-here
  9. That's the first pref; now right-click anywhere in the about:config window
  10. Select New -> String
  11. For the preference name, type mail.identity.id.headers
  12. For the preference value, type jid
  13. If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.)

Note: In the preference name for Step 7 and the preference value for Step 12, the string "jid" can be anything, as long as the string is the same for both.

Displaying the header

The preference mailnews.headers.extraExpandedHeaders is a list of space-delimited additional headers to be shown in the header section of the message pane. To show the Jabber-ID header on messages, just add Jabber-ID to this preference.

Mail Gateways

More e-mail header information in Email Gateway page.