4.3.1 Follow links

Add functions to ‘wwe-follow-link-functions’ to do something when a link button is pressed. These can be used to handle URLs that the web browser doesn’t handle. The default functions set for this hook are ‘wwe-follow-link-compose-mail’ which calls ‘compose-mail’ by default (see ‘url-mail-command’ to set the mailer for mailto URLs), ‘wwe-follow-link-ftp’ which calls ‘ange-ftp’, ‘wwe-follow-link-read-news’ which calls ‘url-news’ (see ‘url-news-server’ to set the news server to use), and ‘wwe-follow-link-javascript’ which flashes an error message.

Some other examples for this hook:

• Add music files and streaming URLs to an EMMS playlist
• Edit EmacsWiki pages with ‘simple-wiki-edit’

Note that this hook is called only when pressing a link button in a WwE buffer. Since the ‘wwe-follow-link-functions’ and ‘wwe-url-retrieve-functions’ hooks overlap somewhat in their functionality, you might find it better to use ‘wwe-url-retrieve-functions’ for most of your extensions.

Each function should take the following arguments:

• URL - The URL to visit, a string. Should be a valid URL, unless working with a link from a local file or HTML region with no base URL indicated.
• REUSE-BUFFER - Whether or not a specific request was made to reuse the pressed link’s buffer. If yes, it’s a buffer Lisp object.
• REFERRER - The URL of the page where the link was pressed.
• SAVE - Whether or not to save the contents of URL. If non-nil, the page is to be saved without displaying (argument’s value is sent to ‘wwe-url-retrieve’).

Functions are called with ‘run-hook-with-args-until-success’, so if no other function is supposed to run after a certain function, that function should return t. Otherwise return nil. Note also the order in which functions are called.