Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

109 lines (80 sloc) 5.76 kB

FYI Bookmarklets

The "fyi" bookmarklets make it easy to select text on a web page and fire off an email that quotes the selection and includes the page title and URL.

All of that is done without you doing copy-and-paste work or back-and-forth app switching.

Available versions include:

  • fyi-webkit -- optimized for iOS (iPhone/iPad/iPod) and Chrome
  • fyi-firefox -- optimized for Firefox to support address bar with custom keyword %s argument
  • fyi-ie -- works with Internet Explorer and its (odd-to-me) DOM selected text methods

Install

Desktop browser

Drag the desired bookmark to the bookmark bar or add bookmark/favorite. Optionally edit or rename the bookmark/favorite. Firefox users may want to set bookmark properties so the Name is "fyi email" and the custom Keyword is "fyi" for reasons detailed in Usage.

  • fyi-webkit -- fyi
  • fyi-firefox -- fyi
  • fyi-ie -- fyi

Mobile browser

Tap the link below, bookmark the new page and follow the instructions on the page to turn the followed bookmark into a JavaScript bookmarklet.

Usage

General Use

Visit a web page. Activate the fyi bookmarklet (click it on bookmark bar or use the Bookmarks/Favorites menu).

The fyi bookmarklet will open a new email with the page title in the subject line, the page title repeated again in the body, along with the selected text (if any text was selected), and the URL of the original page.

Quick Use

With Firefox Custom Keywords you'll be able to do something like:

Cmd-L/Ctr-L fyi user@domain.com Enter

Firefox Custom Keywords

Each bookmark in Firefox can have attributes including a Name, Tags, and a Keyword. Custom keywords can be used with a dynamic "replacement string" for the bookmark location (URL or javascript:…). For general information on Custom Keywords, see Firefox Custom Keywords.

The fyi Firefox bookmarklet can take advantage of a Custom Keyword, and a replacement string (to pre-address the email). The recommended bookmark Name is "fyi email" since this gives a syntax hint when using it. The recommended Keyword is "fyi".

Given a designated keyword (ie, "fyi"), the bookmarklet can be activated by typing the keyword in the address bar and pressing enter. The intended syntax is:

fyi [emailAddress(es)]

The optional argument is one or more email addresses, separated by semicolons. The email address(es) will be put in the TO field of the new email. Outlook users can include multiple recpients using syntax like:

fyi Lastname1,Firstname1;Lastname2,Firstname2;

There is a Known Issue with using Custom Keywords--- the current page URL appears properly in the email, but is over-written in the browser's address bar. The work-around is as follows: when you return to the browser, click in the address bar and press Esc.

Requirements

Web browser that supports javascript:… bookmarks/favorites.
Tested with Firefox 3.x-13.x, Safari 5.0-5.1.x, Mobile Safari 4.x-5.0.x, and IE 8.

License

MIT License - http://www.opensource.org/licenses/mit-license.php

Source Code Notes

Source code is available as text files for each bookmarklet. The JavaScript was written to be as small as practical when URL-encoded. Sorry if it isn't easy to read. The version number is embedded in the void() call at the end of the code in version 1.9 and later.

Version Notes

Inspired by Mike Chambers' Firefox Ubiquity fyi command.

Version 1.0 ~ April 5, 2011
First release

Version 1.1 ~ April 15, 2011
Optimized for shorter emails if no text was selected. Adds version for IE to accommodate IE DOM method weirdness.

Versions 1.2-1.8 ~ April 2011 - December 2011
Numerous encoding tweaks. Attempts to make each bookmarklet even 1 character shorter. Makefile automation for use of HTML Tidy validation, jsl (JavaScript Lint) check, and yuicompressor.

Version 1.9 ~ January 3, 2012
Streamlined message body of resulting email Embed version number of bookmarklet in bookmarklet itself, e.g., javascript:… void('1.9') for version 1.9

Version 2.0 - June 10, 2012
add code in embedded version number to identify associated browser, e.g., javascript:… void('2.0ff') for Firefox fyi-bookmarklet 2.0

Jump to Line
Something went wrong with that request. Please try again.