Bookmarklets

YOURLS comes with four handy bookmarklets for easier link shortening.

Standard or Instant, Simple or Custom

• The Standard Bookmarklets will take you to a page where you can easily edit or delete your brand new short URL.
• The Instant Bookmarklets will pop the short URL without leaving the page you are viewing.
• The Simple Bookmarklets will generate a short URL with a random or sequential keyword
• The Custom Keyword Bookmarklets will prompt you for a custom keyword first

With the Standard Bookmarklets you will also get a Quick Share tool box to make posting to Twitter, Facebook or Friendfeed a snap. If you want to share a description along with the link you're shortening, simply select text on the page you're viewing before clicking on your bookmarklet link

The Bookmarklets

Click and drag links to your toolbar (or right-click and bookmark it)

	Standard (new page)	Instant (popup)
Simple	Shorten	Instant Shorten
Custom Keyword	Custom shorten	Instant Custom Shorten

Prefix-n-Shorten

When viewing a page, you can also prefix its full URL: just head to your browser's address bar, add "/" to the beginning of the current URL (right before its 'http://' part) and hit enter.

Note: this will probably not work if your web server is running on Windows .

Secure passwordless API call

YOURLS allows API calls the old fashioned way, using username and password parameters. If you're worried about sending your credentials into the wild, you can also make API calls without using your login or your password, using a secret signature token.

Your secret signature token: (It's a secret. Keep it secret)

This signature token can only be used with the API, not with the admin interface.

• Usage of the signature token

  Simply use parameter signature in your API requests. Example:

  /yourls-api.php?signature=&action=...

• Usage of a time limited signature token

  <?php
  $timestamp = time();
  // actual value: $time = 
  $signature = md5( $timestamp . '' ); 
  // actual value: $signature = ""
  ?> 
  

  Now use parameters signature and timestamp in your API requests. Example:

  /yourls-api.php?timestamp=$timestamp&signature=$signature&action=...

  Actual values:
  /yourls-api.php?timestamp=&signature=&action=...

  This URL would be valid for only seconds

(See the API documentation for more)