Custom protocols

྅༻ Ǭɀħ ༄༆ཉ edited this page Jan 29, 2014 · 1 revision

Since version 1.6, YOURLS can shorten URLs with non standard protocols (other than http or https)

What for ?

All links are not intended to redirect to a website. Depending on your needs, you may want to shorten and share short links that redirect to a mailto: address, an ftp:// URL, your facetime: or skype: profile.

Example: http://yourls.org/mailto

When you shorten a non-standard link, a visual clue will be added next to the shortened link.

Supported and forbidden protocols

A wide variety of popular non-standard protocols is included out of the box. They include:

  • common stuff: http(s)://, ftp://, feed://, mailto:, news: ...
  • developer oriented protocols: git://, svn://, ...
  • p2p: ed2k://, magnet:, ...
  • streaming and music: lastfm://, spotify:, mms://, ...
  • text and voice: facetime://, gtalk:, irc://, skype:, teamspeak://, ...

Some protocol are deliberately forbidden for security reasons, such as javascript:, data:, about: or chrome://

I want to allow/forbid a specific protocol

Depending on your use you may want to restrict allowed protocols or add custom protocols to the white list. This is easily feasible: see Public-Shortening#wiki-protocols

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.