readme.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
   2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
   3 <head>  \r
   4         <meta http-equiv="X-UA-Compatible" content="chrome=1">\r
   5         <meta http-equiv="content-type" content="text/html; charset=utf-8" />\r
   6         <title>YOURLS: Your Own URL Shortener</title>\r
   7         <style type="text/css" media="screen">\r
   8                 /* Default Style */\r
   9                 body {\r
  10                         font-family: Verdana, Arial;\r
  11                         font-size: 12px;\r
  12                         color: #595441;\r
  13                         background:#F3FAFD;\r
  14                 }\r
  15                 p {\r
  16                         padding-left: 10px;\r
  17                 }\r
  18                 code {\r
  19                         background:#eaeaef;\r
  20                         padding:0 2px;\r
  21                 }\r
  22                 tt {\r
  23                         background:#ffc;\r
  24                         padding:0 2px;          \r
  25                 }\r
  26                 pre tt {\r
  27                         display:block;\r
  28                 }\r
  29                 blockquote {\r
  30                         margin: 10px 20px 0px 20px;\r
  31                         padding: 10px;\r
  32                         border: 1px solid #8d8d8d;\r
  33                         background-color: #f5f5f5;\r
  34                 }\r
  35                 li {\r
  36                         margin-top: 20px;\r
  37                 }\r
  38                 ul li ul li {\r
  39                         margin-top: 10px;\r
  40                 }\r
  41                 a, a:active, a:link, a:visited {\r
  42                         color: #5b87b4;\r
  43                         text-decoration: none;\r
  44                 }\r
  45                 a:hover {\r
  46                         color: #5577a5;\r
  47                         text-decoration: underline;\r
  48                 }\r
  49                 div.sshot {\r
  50                 }\r
  51                 div.sshot p {\r
  52                         color:#5577a5;\r
  53                         font-size:90%;\r
  54                 }\r
  55                 div.sshot img {\r
  56                         margin-bottom:1em;\r
  57                         border-bottom:1px solid #ccc;\r
  58                 }\r
  59                 /* Place Holder Style */\r
  60                 #Container {\r
  61                         width: 780px;\r
  62                         margin-left: auto;\r
  63                         margin-right: auto; \r
  64                 }\r
  65                 #Content {\r
  66                         background-color: #fff;\r
  67                         border: 1px solid #2A85B3;\r
  68                         padding: 10px;\r
  69                         margin-top: -13px;\r
  70                         -moz-border-radius:15px;\r
  71                         -webkit-border-radius:15px;\r
  72                 }\r
  73                 /* Title Style */\r
  74                 h1 {\r
  75                         font-family: Verdana, Arial;\r
  76                         font-size: 22px;\r
  77                         font-weight: bold;\r
  78                         color: #2a85b3;\r
  79                         border-bottom: 1px solid #2a85b3;\r
  80                         margin-bottom: 10px;\r
  81                         background:transparent url(http://yourls.org/images/yourls-logo.png) top center no-repeat;\r
  82                         padding-top:90px;\r
  83                 }\r
  84                 h1:hover span {\r
  85                         color: #73A4D6;\r
  86                 }\r
  87                 h2 {\r
  88                         font-family: Verdana, Arial;\r
  89                         font-size: 18px;\r
  90                         font-weight: bold;\r
  91                         color: #5b87b4;\r
  92                 }\r
  93                 h2:before {\r
  94                         content: '\00BB';\r
  95                         color:#BFE0FE;\r
  96                 }\r
  97                 h3 {\r
  98                         font-family: Verdana, Arial;\r
  99                         font-size: 14px;\r
 100                         font-weight: bold;\r
 101                         color: #73a4d6;\r
 102                         margin-top:2em;\r
 103                 }\r
 104                 h3:before {\r
 105                         content: '\00BB';\r
 106                         color:#BFE0FE;\r
 107                 }\r
 108                 /* Tabs */\r
 109                 ul#Tabs {\r
 110                         font-family: Verdana, Arial;\r
 111                         font-size: 12px;\r
 112                         font-weight: bold;\r
 113                         list-style-type: none;\r
 114                         padding-bottom: 28px;\r
 115                         border-bottom: 1px solid #2A85B3;\r
 116                         margin-bottom: 12px;\r
 117                         margin-right:30px;\r
 118                         margin-left:30px;\r
 119                         z-index: 1;\r
 120                 }\r
 121                 #Tabs li.Tab {\r
 122                         float: right;\r
 123                         height: 25px;\r
 124                         background-color: #deedfb;\r
 125                         margin: 2px 0px 0px 5px;\r
 126                         border: 1px solid #2A85B3;\r
 127                         -moz-border-radius-topleft:5px;\r
 128                         -moz-border-radius-topright:5px;\r
 129                         -webkit-border-top-left-radius:5px;\r
 130                         -webkit-border-top-right-radius:5px;\r
 131                 }\r
 132                 #Tabs li.Tab a {\r
 133                         float: left;\r
 134                         display: block;\r
 135                         color: #666666;\r
 136                         text-decoration: none;\r
 137                         padding: 5px;\r
 138                 }\r
 139                 #Tabs li.Tab a:hover {\r
 140                         background-color: #bfe0fe;\r
 141                         border-bottom: 1px solid #bfe0fe;\r
 142                 }\r
 143                 /* Selected Tab */\r
 144                 #Tabs li.SelectedTab {\r
 145                         float: right;\r
 146                         height: 25px;\r
 147                         background-color: #fff;\r
 148                         margin: 2px 0px 0px 5px;\r
 149                         border-top: 1px solid #2A85B3;\r
 150                         border-right: 1px solid #2A85B3;\r
 151                         border-bottom: 1px solid #fafafa;\r
 152                         border-left: 1px solid #2A85B3;\r
 153                         -moz-border-radius-topleft:3px;\r
 154                         -moz-border-radius-topright:3px;\r
 155                         -webkit-border-top-left-radius:3px;\r
 156                         -webkit-border-top-right-radius:3px;\r
 157                 }\r
 158                 #Tabs li.SelectedTab a {\r
 159                         float: left;\r
 160                         display: block;\r
 161                         color: #666666;\r
 162                         text-decoration: none;\r
 163                         padding: 5px;\r
 164                         cursor: default;\r
 165                 }\r
 166                 /* Copyright */\r
 167                 #Copyright {\r
 168                         text-align: center;\r
 169                 }\r
 170                 #Copyright {\r
 171                         text-align:center;\r
 172                         margin-top:20px;\r
 173                 }\r
 174                 #Copyright p {\r
 175                         padding:10px;\r
 176                         background:white;\r
 177                         margin:0 auto;\r
 178                         width:750px;\r
 179                         -moz-border-radius:10px;\r
 180                         -webkit-border-radius:10px;\r
 181                         border:1px solid #2A85B3;\r
 182                         -moz-border-radius-bottomleft:30px;\r
 183                         -moz-border-radius-bottomright:30px;\r
 184                         -webkit-border-bottom-left-radius:25px;\r
 185                         -webkit-border-bottom-right-radius:25px;\r
 186                 }\r
 187                 #Copyright p a {\r
 188                         background:#fff url(http://yourls.org/images/favicon.gif) 2px center no-repeat;\r
 189                         padding-left:20px;\r
 190                 }\r
 191         </style>\r
 192 </head>\r
 193 <body>\r
 194 <div id="Container">\r
 195         <!-- Title -->\r
 196         <h1>YOURLS: <span>Y</span>our <span>O</span>wn <span>URL</span> <span>S</span>hortener</h1>\r
 197 \r
 198         <!-- Tabs -->\r
 199         <ul id="Tabs">\r
 200                 <li id="ShowcaseTab" class="Tab"><a href="#Showcase" onclick="toggle(this);">Showcase</a></li>\r
 201                 <li id="FAQTab" class="Tab"><a href="#FAQ" onclick="toggle(this);">FAQ</a></li>\r
 202                 <li id="APITab" class="Tab"><a href="#API" onclick="toggle(this);">API</a></li>\r
 203                 <li id="PluginTab" class="Tab"><a href="#Plugin" onclick="toggle(this);">WordPress plugin</a></li>\r
 204                 <li id="ConfigTab" class="Tab"><a href="#Config" onclick="toggle(this);">Configuration</a></li>\r
 205                 <li id="InstallTab" class="Tab"><a href="#Install" onclick="toggle(this);">Install/Upgrade</a></li>\r
 206                 <li id="AboutTab" class="SelectedTab"><a href="#About" onclick="toggle(this);">About</a></li>\r
 207         </ul>\r
 208 \r
 209         <!-- Content -->\r
 210         <div id="Content">\r
 211                 <!-- Index -->\r
 212                 <div id="AboutDiv">\r
 213                         <h2>About YOURLS</h2>\r
 214                         \r
 215                         <h3>What is YOURLS</h3>\r
 216                         <p>YOURLS is a small set of PHP scripts that will allow you to run your own URL shortening service (<em>a la</em> TinyURL). You can make it private or public, you can pick custom keyword URLs, it comes with its own API. You will love it.</p>\r
 217                         <p>There's a <a href="#Plugin" onclick="toggle(this);">WordPress plugin</a> available for YOURLS, making integration with your blog a snap: create short URLs and tweet them automagically as you publish blog posts.</p>\r
 218                         \r
 219                         <h3>YOURLS Features</h3>\r
 220                         <ul>\r
 221                                 <li><tt>Public</tt> (everybody can create short links) or <tt>private</tt> (your links only)</li>\r
 222                                 <li>Sequential or custom URL keyword</li>\r
 223                                 <li>Handy <tt>bookmarklet</tt> to easily shorten and share links</li>\r
 224                                 <li>Awesome <tt>stats</tt>: historical click reports, referrers tracking, visitors geo-location</li>\r
 225                                 <li>Neat <tt>AJAXed</tt> interface</li>\r
 226                                 <li>Developer <tt>API</tt></li>\r
 227                                 <li>Friendly <tt>installer</tt></li>\r
 228                         </ul>\r
 229                         <p>Note: some features are part of the upcoming version 1.4</p>\r
 230                         \r
 231                         <h3>Screenshots of the upcoming version 1.4</h3>\r
 232                         \r
 233                         <div class="sshot">\r
 234                                 <p>Main admin dashboard</p>\r
 235                                 <img src="http://yourls.org/images/admin-dashboard.gif" />\r
 236                                 \r
 237                                 <p>Stats for each short URL</p>\r
 238                                 <img src="http://yourls.org/images/stats_1.png" />\r
 239                                 <img src="http://yourls.org/images/stats_2.png" />\r
 240                                 <img src="http://yourls.org/images/stats_3.png" />\r
 241                                 \r
 242                                 <p>See a live example of YOURLS stats on <a href="http://yourls.org/download+">http://yourls.org/download+</a></p>\r
 243                         </div>\r
 244                         \r
 245                         <h2>Download</h2>\r
 246                         \r
 247                         <p><a href="http://yourls.org/download">Download YOURLS</a> from Google Code</p>\r
 248                         <p>You can follow YOURLS' development on the <a href="http://yourls.org/revisions">revision list</a> and get current snapshot <a href="http://yourls.org/svnco">using SVN</a></p>\r
 249                         \r
 250                         <h2>Credits</h2>\r
 251                         \r
 252                         <p>YOURLS is made by:</p>\r
 253                         <ul>\r
 254                                 <li><a href="http://yourls.org/lesterchan" title="Visit Lester Chan's site">Lester Chan</a> &ndash <a href="http://twitter.com/gamerz">@GamerZ</a> on Twitter</li>\r
 255                                 <li><a href="http://yourls.org/ozh" title"Visit Ozh's site">Ozh Richard</a> &ndash <a href="http://twitter.com/ozh">@Ozh</a> on Twitter</li>\r
 256                         </ul>\r
 257                 </div>\r
 258 \r
 259                 <!-- Installation Instructions -->\r
 260                 <div id="InstallDiv" style="display: none;">\r
 261                         <h2>Fresh Install</h2>\r
 262                         <ol>\r
 263                                 <li>Unzip the YOURLS archive</li>\r
 264                                 <li>Copy <code>includes/config-sample.php</code> to <code>includes/config.php</code></li>\r
 265                                 <li>Open <code>includes/config.php</code> with a raw text editor (like Notepad) and fill in the required settings</li>\r
 266                                 <li>Upload the unzipped files to your domain <code>public_html</code> or <code>www</code> folder</li>\r
 267                                 <li>Create a new database (see <a href="#Config" onclick="toggle(this);">Configuration</a> &ndash; you can also use an existing one)</li>\r
 268                                 <li>Point your browser to <code>http://yoursite.com/admin/</code></li>\r
 269                         </ol>\r
 270                         \r
 271                         <h2>Upgrade from YOURLS 1.3 or earlier</h2>\r
 272                         <ol>\r
 273                                 <li>Make a copy of your <code>config.php</code></li>\r
 274                                 <li>Copy <code>config-sample.php</code> to <code>config.php</code> and fill in details. <strong>Don't start with your old config file</strong>, use the new sample config file.</li>\r
 275                                 <li>In your new <code>config.php</code>, add the <em>defines</em> for <code>YOURLS_DB_TABLE_URL</code> and <code>YOURLS_DB_TABLE_NEXTDEC</code> you had in your previous config file\r
 276                                 <li><strong>Backup the database!</strong></li>\r
 277                                 <li>Point your browser to <code>http://yoursite.com/admin/</code> and follow instructions</li>\r
 278                                 <li>After upgrade is well and over, remove the define <code>YOURLS_DB_TABLE_NEXTDEC</code> from your config file</li>\r
 279                         </ol>\r
 280                         \r
 281                 </div>\r
 282 \r
 283                 <!-- Configuration Instructions -->     \r
 284                 <div id="ConfigDiv" style="display: none;">\r
 285                         <h2>Configuration (in includes/config.php)</h2>\r
 286                         <h3>MySQL settings</h3>\r
 287                         <ul>\r
 288                                 <li><code>YOURLS_DB_USER</code><br/>\r
 289                                 your MySQL username<br/>\r
 290                                 <em>Example:</em> <tt>'joe'</tt></li>\r
 291                                 <li><code>YOURLS_DB_PASS</code><br/>\r
 292                                 your MySQL password<br/>\r
 293                                 <em>Example:</em> <tt>'MySeCreTPaSsW0rd'</tt></li>\r
 294                                 <li><code>YOURLS_DB_NAME</code>:\r
 295                                 The database name<br/>\r
 296                                 <em>Example:</em> <tt>'yourls'</tt></li>\r
 297                                 <li><code>YOURLS_DB_HOST</code><br/>\r
 298                                 The database host<br/>\r
 299                                 <em>Example:</em> <tt>'localhost'</tt></li>\r
 300                                 <li><code>YOURLS_DB_PREFIX</code><br/>\r
 301                                 The name prefix for all the tables YOURLS will need<br/>\r
 302                                 <em>Example:</em> <tt>'yourls_'</tt></li>\r
 303                         </ul>\r
 304                         \r
 305                         <h3>Site options</h3>\r
 306                         <ul>\r
 307                                 <li><code>YOURLS_SITE</code><br/>\r
 308                                 Your (short) domain URL, no trailing slash<br/>\r
 309                                 <em>Example:</em> <tt>'http://ozh.in'</tt></li>\r
 310                                 <li><code>YOURLS_HOURS_OFFSET</code><br/>\r
 311                                 Timezone GMT offset<br/>\r
 312                                 <em>Example:</em> <tt>'-5'</tt></li>\r
 313                                 <li><code>YOURLS_PRIVATE</code><br/>\r
 314                                 Private means protected with login/pass as defined below. Set to false for public usage<br/>\r
 315                                 <em>Example:</em> <tt>'true'</tt></li>\r
 316                                 <li><code>YOURLS_UNIQUE_URLS</code><br/>\r
 317                                 Allow multiple short URLs for a same long URL<br/>\r
 318                                 Set to <tt>true</tt> to allow only one pair of shortURL/longURL (default YOURLS behavior), or to <tt>false</tt> to allow creation of multiple short URLs pointing to the same long URL (as bit.ly does)<br/>\r
 319                                 <em>Example:</em> <tt>'true'</tt></li>\r
 320                                 <li><code>YOURLS_COOKIEKEY</code><br/>\r
 321                                 A random secret hash used to encrypt cookies. You don't have to remember it, make it long and complicated. Hint: generate a unique one at <a href="http://yourls.org/cookie">http://yourls.org/cookie</a><br/>\r
 322                                 <em>Example:</em> <tt>'qQ4KhL_pu|s@Zm7n#%:b^{A[vhm'</tt></li>\r
 323                                 <li><code>yourls_user_passwords</code><br/>\r
 324                                 A list of username(s) and password(s) allowed to access the site if private<br/>\r
 325                                 <em>Example:</em> <tt>'joe' => 'mypassword'</tt></li>\r
 326                         </ul>\r
 327                         \r
 328                         <h3>URL Shortening settings</h3>\r
 329                         <ul>\r
 330                                 <li><code>YOURLS_URL_CONVERT</code><br/>\r
 331                                 URL shortening method: base <tt>36</tt> or <tt>62</tt>. See <a onclick="toggle(this);" href="#FAQ">FAQ</a> for more explanations</li>\r
 332                                 <li><code>yourls_reserved_URL</code><br/>\r
 333                                 A list of reserved keywords that won't be used as short URLs. Define here negative, unwanted or potentially misleading keywords<br/>\r
 334                                 <em>Example:</em> <tt>'porn', 'faggot', 'sex', 'nigger', 'fuck', 'cunt', 'dick', 'gay'</tt></li>\r
 335                         </ul>\r
 336                         \r
 337                         <h3>Optional settings</h3>\r
 338                         <ul>\r
 339                                 <li><code>YOURLS_PRIVATE_INFOS</code><br/>\r
 340                                 If <code>YOURLS_PRIVATE</code> is set to <tt>true</tt>, you can still easily make your individual stat pages public. To do so, override the global private setting with:<br/>\r
 341                                 <tt>define('YOURLS_PRIVATE_INFOS', false);</tt>\r
 342                                 </li>\r
 343                                 <li><code>YOURLS_PRIVATE_API</code><br/>\r
 344                                 If <code>YOURLS_PRIVATE</code> is set to <tt>true</tt>, you can still easily make your API public. To do so, override the global private setting with:<br/>\r
 345                                 <tt>define('YOURLS_PRIVATE_API', false);</tt>\r
 346                                 </li>\r
 347                 </div>\r
 348                 \r
 349                 <!-- WordPress plugin -->\r
 350                 <div id="PluginDiv" style="display:none">\r
 351                         <h2>WordPress Plugin</h2>\r
 352                         \r
 353                         <h3>Features</h3>\r
 354                         <ul>\r
 355                                 <li>Generate short URLs for each new post or page</li>\r
 356                                 <li>Send a tweet on your Twitter account with the post title and short URL as you publish them</li>\r
 357                                 <li>Works if YOURLS is hosted on the same server or on a remote server</li>\r
 358                                 <li>Also compatible with tr.im, is.gd, tinyurl.com and bit.ly for maximum fun</li>\r
 359                         </ul>\r
 360                         \r
 361                         <h3>Screenshots</h3>\r
 362                         <div class="sshot">\r
 363                         <img src="http://yourls.org/images/wpplugin.gif"/>\r
 364                         </div>\r
 365                         \r
 366                         <h3>Download &amp; more informations</h3>\r
 367                         <ul>\r
 368                                 <li>Download <a href="http://yourls.org/plugin">YOURLS: WordPress to Twitter</a> from the official WordPress plugin repository</li>\r
 369                                 <li>More information, tips and feedback on <a href="http://yourls.org/plugindoc">the plugin page</a> from planetOzh</li>\r
 370                         </ul>\r
 371                 \r
 372                 </div>\r
 373                 \r
 374                 <!-- API -->\r
 375                 <div id="APIDiv" style="display:none">\r
 376                         <h2>YOURLS' API</h2>\r
 377                         \r
 378                         <h3>Features</h3>\r
 379                         <ul>\r
 380                                 <li>Generate or get existing short URLs, with sequential or custom keyword</li>\r
 381                                 <li>Get some statistics about your links: top clicked links, least clicked links, newest links</li>\r
 382                                 <li>Output format: JSON, XML, or simple raw text</li>\r
 383                         </ul>\r
 384                         \r
 385                         <h3>Usage</h3>\r
 386                         <p>You need to send parameters to <code>http://yoursite.com/yourls-api.php</code> either via <code>GET</code> or <code>POST</code>. These parameters are:</p>\r
 387                         <ul>\r
 388                                 <li>A valid <code>username</code></li>\r
 389                                 <li>A valid <code>password</code></li>\r
 390                                 <li>The requested <code>action</code>: <tt>"shorturl"</tt> (get short URL for a link), <tt>"expand"</tt> (get long URL of a shorturl) or <tt>"stats"</tt> (get stats about your links)</li>\r
 391                                 <li>With <tt>action = "shorturl"</tt> :\r
 392                                         <ul>\r
 393                                                 <li>the <code>url</code> to shorten</li>\r
 394                                                 <li>optional <code>keyword</code> for custom short URLs</li>\r
 395                                                 <li>output <code>format</code>: either <tt>"json"</tt>, <tt>"xml"</tt> or <tt>"simple"</tt></li>\r
 396                                         </ul>\r
 397                                 </li>\r
 398                                 <li>With <tt>action = "expand"</tt> :\r
 399                                         <ul>\r
 400                                                 <li>the <code>shorturl</code> to expand (can be either 'abc' or 'http://site/abc')</li>\r
 401                                                 <li>output <code>format</code>: either <tt>"json"</tt>, <tt>"xml"</tt> or <tt>"simple"</tt></li>\r
 402                                         </ul>\r
 403                                 </li>\r
 404                                 <li>With <tt>action = "stats"</tt> :\r
 405                                         <ul>\r
 406                                                 <li>the <code>filter</code>: either <tt>"top"</tt>, <tt>"bottom"</tt> , <tt>"rand"</tt> or <tt>"last"</tt></li>\r
 407                                                 <li>the <code>limit</code> (maximum number of links to return)</li>\r
 408                                                 <li>output <code>format</code>: either <tt>"json"</tt> or <tt>"xml"</tt></li>\r
 409                                         </ul>\r
 410                                 </li>\r
 411                         </ul>\r
 412                         \r
 413                         <h3>Sample return</h3>\r
 414                         <pre><tt>&lt;result&gt;\r
 415         &lt;url&gt;\r
 416                 &lt;id&gt;62019439011&lt;/id&gt;\r
 417                 &lt;keyword&gt;shorter&lt;/keyword&gt;\r
 418                 &lt;url&gt;http://somereallylongurlyouneedtoshrink.com/&lt;/url&gt;\r
 419                 &lt;date&gt;2009-06-23 18:08:07&lt;/date&gt;\r
 420                 &lt;ip&gt;127.0.0.1&lt;/ip&gt;\r
 421         &lt;/url&gt;\r
 422         &lt;status&gt;success&lt;/status&gt;\r
 423         &lt;message&gt;http://somereallylongurlyouneedtoshrink.com/ (ID: shorter) added to database&lt;/message&gt;\r
 424         &lt;shorturl&gt;http://yoursite.com/shorter&lt;/shorturl&gt;\r
 425 &lt;/result&gt;</tt></pre>\r
 426 \r
 427                         <h3>Sample file</h3>\r
 428                         <p>There's a sample file included that serves as an example on how to play with the API</p>\r
 429 \r
 430                 </div>\r
 431                 \r
 432 \r
 433                 <!-- FAQ Instructions -->       \r
 434                 <div id="FAQDiv" style="display: none;">\r
 435                         <h2>FAQ</h2>\r
 436 \r
 437                         <h3>Server requirements</h3>\r
 438                         <ol>\r
 439                                 <li>A server with <strong>mod_rewrite</strong> enabled</li>\r
 440                                 <li>At least <strong>PHP 4.3</strong></li>\r
 441                                 <li>At least <strong>MYSQL 4.1</strong></li>\r
 442                                 <li><em>Note</em>: YOURLS can also run on Nginx (<a href="http://foolrulez.org/blog/2009/08/foolz-us-make-yourls-work-on-ngin/">Read more</a>)</li>\r
 443                         </ol>\r
 444 \r
 445                         <h3>Server recommendations</h3>\r
 446                         <ul>\r
 447                                 <li>PHP <a href="http://www.php.net/curl">CURL extension</a> installed if you plan on playing with the API</li>\r
 448                         </ul>\r
 449                         \r
 450                         <h3>Limitations</h3>\r
 451                         <ul>\r
 452                                 <li>Maximum length of long URLs to be shortened is <strong>2000 characters</strong></li>\r
 453                                 <li>Maximum length of custom keyword is <strong>200 characters</strong></li>\r
 454                                 <li>That makes about <strong>8 sexdecillions of centillions</strong> of available URLs (<a href="http://en.wikipedia.org/wiki/Names_of_large_numbers">seriously</a>. That's a 355 digits number). </li>\r
 455                         </ul>\r
 456                         \r
 457                         <h3>Difference Between Base 36 And Base 62 Encoding</h3>\r
 458                         <ul>\r
 459                                 <li>Base 36 encoding uses <code>0123456789abcdefghijklmnopqrstuvwxyz</code></li>\r
 460                                 <li>Base 62 encoding uses <code>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz</code></li>\r
 461                                 <li>Stick to one setting, don't change after you've created links as it will change all your short URLs!</li>\r
 462                                 <li>Base 36 should be picked. Use 62 only if you understand what it implies.</li>\r
 463                                 <li>Consider Base 62 encoding a <code>beta feature</code></li>\r
 464                         </ul>\r
 465                         \r
 466                         <h3>Getting a short domain name for your YOURLS install</h3>\r
 467                         <ul>\r
 468                                 <li>Unless you plan on making it public, any shared hosting should be fine</li>\r
 469                                 <li><a href="http://domai.nr/">Domainr</a> is a fun search tool that might inspire and help you</li>\r
 470                                 <li>Aim for exotic top level domains (.in, .im, .li ...), they're often cheap and a lot are still available. <a href="https://www.gandi.net/domain/buy/search/">Gandi</a> is a pretty comprehensive registrar, for instance.</li>\r
 471                         </ul>\r
 472 \r
 473                         <h3>YOURLS needs its own .htaccess</h3>\r
 474                         <ul>\r
 475                                 <li>You cannot install YOURLS and, say, WordPress, in the same directory. Both of them need to handle URLs differently</li>\r
 476                                 <li>If you want to install YOURLS on the same domain than your blog, give it its own (short) subdirectory, such as yourblog.com/s/ (for "short") or yourblog.com/x/ (for "exit")</li>\r
 477                         </ul>\r
 478                         \r
 479                         <h3>If YOURLS generates 404 for your short URLs</h3>\r
 480                         <ul>\r
 481                                 <li>Make sure <strong>mod_rewrite</strong> is enabled with your Apache server</li>\r
 482                                 <li>Some (crappy) hosts such as GoDaddy or 1and1 need <a href="http://code.google.com/p/yourls/issues/detail?id=25">a small fix</a> to .htaccess:</li>\r
 483                         </ul>\r
 484                         \r
 485                         <h3>Feedback and bug reporting</h3>\r
 486                         <ul>\r
 487                                 <li>Please don't get in touch directly by mail or Twitter</li>\r
 488                                 <li>Raise an <a href="http://yourls.org/issues">issue here</a> and give all the details. Thanks!</li>\r
 489                         </ul>\r
 490 \r
 491                 </div>\r
 492                 \r
 493                 \r
 494                                 <!-- Showcase -->       \r
 495                 <div id="ShowcaseDiv" style="display: none;">\r
 496                         <h2>Showcase</h2>\r
 497 \r
 498                         <h3>Here are a few examples of sites running YOURLS with a unique design or concept</h3>\r
 499                         \r
 500                         <ul>\r
 501                                 <li><a href="http://hmm.ph/">http://hmm.ph/</a><br/>\r
 502                                 Funny domain name, nicely styled</li>\r
 503                                 <li><a href="http://qte.me/">http://qte.me/</a><br/>\r
 504                                 Another YOURLS setup with a cute quote look</li>\r
 505                                 <li><a href="http://unsl.im/">http://unsl.im/</a><br/>\r
 506                                 Gorgeous design listing latest links with a custom RSS feed (private use)</li>\r
 507                                 <li><a href="http://mrte.ch/">http://mrte.ch/</a><br/>\r
 508                                 Mr Tech's public YOURLS setup, listing top links and some stats</li>\r
 509                                 <li><a href="http://s4c.in/">http://s4c.in/</a><br/>\r
 510                                 Shorten 4 Charity, a public YOURLS setup with shortened links displayed within a frame containing ads for charities     </li>\r
 511                                 <li><a href="http://girv.in/">http://girv.in/</a><br/>\r
 512                                 John Girvin's YOURLS setup with all links in a sortable display</li>\r
 513                                 <li><a href="http://www.iyeman.net/">http://www.iyeman.net/</a><br/>\r
 514                                 <a href="http://tinytags.co.cc/">http://tinytags.co.cc/</a><br/>\r
 515                                 Examples of portals for your online self with links to your places (blog, Twitter) and your URL shortener</li>\r
 516                                 <li><a href="http://li.nkto.me/">http://li.nkto.me/</a><br/>\r
 517                                 A nice domain name hack :)</li>\r
 518                                 <li><a href="http://vb.ly/">http://vb.ly/</a><br/>\r
 519                                 Public YOURLS setup run by famous sex writer Violet Blue as "the internet's first and only sex-positive url shortener"</li>\r
 520                                 \r
 521                         </ul>\r
 522                         \r
 523                         <h3>More stuff about or with YOURLS</h3>\r
 524                         \r
 525                         <ul>\r
 526                                 <li><a href="http://screenr.com/nTs">http://screenr.com/nTs</a><br/>\r
 527                                 A screencast explaining how to setup YOURLS</li>\r
 528                                 <li><a href="http://foolrulez.org/blog/2009/09/yourls-widget-released">YOURLS Widget for WordPress</a><br/>\r
 529                                 This widget adds a convenient short URL service into your sidebar. Check the above link for a live example</li>\r
 530                                 <li><a href="http://github.com/pjain/WWW-Shorten-Yourls">WWW-Shorten-Yourls</a><br/>\r
 531                                 A Perl module to shorten URLs using YOURLS</li>\r
 532                                 <li>YOURLS featured on <a href="http://lifehacker.com/5335216/make-your-own-url-shortening-service">Lifehacker</a></li>\r
 533                         </ul>\r
 534 \r
 535                 </div>\r
 536         </div> <!-- content -->\r
 537 </div> <!-- container -->\r
 538 \r
 539 <div id="Copyright"><p><a href="http://yourls.org/">YOURLS</a>: Your Own URL Shortener<br />All Free & GPL &ndash; 2009</p></div>\r
 540 \r
 541         <script type="text/javascript">\r
 542         /* <![CDATA[*/\r
 543         // Dynamically get tabs\r
 544         function getTabs() {\r
 545                 var d = document.getElementById('Tabs');\r
 546                 var matches = d.innerHTML.match(/<li id="(.+?)Tab"/g);\r
 547                 var tabs = []\r
 548                 for (i in matches) {\r
 549                   tabs[i]= matches[i].replace('<li id="','').replace('Tab"', '');\r
 550                 }\r
 551                 tabs = tabs.reverse();\r
 552                 return (tabs)\r
 553         }\r
 554         // Toggle tab display\r
 555         function toggle(el) {\r
 556                 //var tabs = ["About", "Install", "Config", "Plugin", "FAQ"];\r
 557                 var target = el.toString().replace(/^.*#/, '');\r
 558                 for (var tab in tabs) {\r
 559                         // reinit tabs\r
 560                         document.getElementById(tabs[tab]+'Tab').className = 'Tab';\r
 561                         // reinit divs\r
 562                         document.getElementById(tabs[tab]+'Div').style.display= 'none';\r
 563                 }\r
 564                 // highlight & display target\r
 565                 document.getElementById(target+'Div').style.display = 'block';\r
 566                 document.getElementById(target+'Tab').className = 'SelectedTab';\r
 567                 try { el.blur(); } catch(err) {}\r
 568         }\r
 569         // Get tab list\r
 570         var tabs = getTabs();\r
 571         // On page load/refresh display required tab\r
 572         if (location.hash) {\r
 573                 toggle(location.hash);\r
 574         }\r
 575         /* ]]> */\r
 576         </script>\r
 577 \r
 578 \r
 579 </body>\r
 580 </html>