Difference between revisions of "Template:ShortURL"

Revision as of 23:54, 23 July 2009

This is not finished yet.

The template

...

Usage

This shortens external URLs. Consider that shortened URLs may cause wrong copy-paste by unexperienced users.
Note: Requires Extension:StringFunctions

Usage

{{ShortURL
|url    =
|count  =
|suffix =
|domainonly =(yes)
|domainbold =(yes)
|tolerance  =
|forcecount =(yes)
}}

• count: optional / default: 30

The number of displayed characters. It counts and returns the string without "http://" and "www." (if the URL is longer than the default 30 characters).

It uses a tolerance of 5. So if you define count=10 the string will not be shortened if it is between 1 and 15 characters long.

• suffix: optional / default: "…" (not ...)

Adds an suffix at the end of the shortened string. It is not recommend to set an empty suffix.

• domainonly: optional

domainonly=yes will only display the domain (including subdomains if given). A setting for count is useless here.

• domainbold: optional

domainbold=yes will highlight the domain bold. This is useful for lists of many different external URLs.

• tolerance: optional / default: 5

Override the default tolerance.

• forcecount: optional / default: no

forcecount=yes overrides the (default) tolerance and forces a strict count.

Examples

{{ShortURL|url=http://semeb.com/dpldemo/index.php/Template:ShortURL}}

The URL (without "http://" and "www") has 45 characters. That's more than count (default 30) + tolerance (default 5) = "ortURL" > 5.
Result: delete me

{{ShortURL|url=http://www.imdb.com|suffix=....}}

The URL is shorter than the count (default 30). It will be fully returned without suffix.
Result: delete me

{{ShortURL
|url=http://www.google.de/search?q=DLP&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:de:official&client=firefox-a
|count=50}}

We use a count of 50.
Result: delete me

{{ShortURL
|url=http://www.google.de/search?q=DLP&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:de:official&client=firefox-a
|count=40
|suffix='''....'''}}

We add a custom suffix.
Result: delete me

{{ShortURL
|url=http://commons.wikimedia.org/wiki/Commons:Village_pump/Archive/2008Sep#Hack_for_search_suggestion_field_width_will_be_obsolete
|count=40
|domainbold=yes}}

We highlight the domain.
Result: delete me

{{ShortURL
|url=http://commons.wikimedia.org/wiki/Category:Icons
|domainonly=yes}}

Only the domain should be returned.
Result: delete me

For forcecount and tolerance examples see {{Short}}.