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="content-type" content="text/html; charset=utf-8" />\r
   5         <title>YOURLS: Your Own URL Shortener</title>\r
   6         <style type="text/css" media="screen">\r
   7                 /* Default Style */\r
   8                 body {\r
   9                         font-family: Verdana, Arial;\r
  10                         font-size: 12px;\r
  11                         color: #595441;\r
  12                         background:#F3FAFD;\r
  13                 }\r
  14                 p {\r
  15                         padding-left: 10px;\r
  16                 }\r
  17                 code {\r
  18                         background:#eaeaef;\r
  19                         padding:0 2px;\r
  20                 }\r
  21                 tt {\r
  22                         background:#ffc;\r
  23                         padding:0 2px;          \r
  24                 }\r
  25                 pre tt {\r
  26                         display:block;\r
  27                 }\r
  28                 blockquote {\r
  29                         margin: 10px 20px 0px 20px;\r
  30                         padding: 10px;\r
  31                         border: 1px solid #8d8d8d;\r
  32                         background-color: #f5f5f5;\r
  33                 }\r
  34                 li {\r
  35                         margin-top: 20px;\r
  36                 }\r
  37                 ul li ul li {\r
  38                         margin-top: 10px;\r
  39                 }\r
  40                 a, a:active, a:link, a:visited {\r
  41                         color: #5b87b4;\r
  42                         text-decoration: none;\r
  43                 }\r
  44                 a:hover {\r
  45                         color: #5577a5;\r
  46                         text-decoration: underline;\r
  47                 }\r
  48                 div.sshot {\r
  49                         text-align:center;\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);">Installation</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>Random (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                         \r
 249                         <h2>Credits</h2>\r
 250                         \r
 251                         <p>YOURLS is made by:</p>\r
 252                         <ul>\r
 253                                 <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
 254                                 <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
 255                         </ul>\r
 256                 </div>\r
 257 \r
 258                 <!-- Installation Instructions -->\r
 259                 <div id="InstallDiv" style="display: none;">\r
 260                         <h2>Fresh Install</h2>\r
 261                         <ol>\r
 262                                 <li>Unzip the YOURLS archive</li>\r
 263                                 <li>Copy <code>includes/config-sample.php</code> to <code>includes/config.php</code></li>\r
 264                                 <li>Open <code>includes/config.php</code> with a raw text editor (like Notepad) and fill in the required settings</li>\r
 265                                 <li>Upload the unzipped files to your domain <code>public_html</code> or <code>www</code> folder</li>\r
 266                                 <li>Create a new database (see <a href="#Config" onclick="toggle(this);">Configuration</a> &ndash; you can also use an existing one)</li>\r
 267                                 <li>Point your browser to <code>http://yoursite.com/admin/install.php</code></li>\r
 268                         </ol>\r
 269                         \r
 270                         <h2>Upgrade from YOURLS 1.3 or earlier</h2>\r
 271                         <ol>\r
 272                                 <li>The configuration file has changed a bit, see <code>config-sample.php</code> and update your own <code>config.php</code> accordingly</li>\r
 273                                 <li><strong>Backup the database!</strong></li>\r
 274                                 <li>Point your browser to <code>http://yoursite.com/admin/</code> and follow instructions</li>\r
 275                         </ol>\r
 276                         \r
 277                 </div>\r
 278 \r
 279                 <!-- Configuration Instructions -->     \r
 280                 <div id="ConfigDiv" style="display: none;">\r
 281                         <h2>Configuration (in includes/config.php)</h2>\r
 282                         <h3>MySQL settings</h3>\r
 283                         <ul>\r
 284                                 <li><code>YOURLS_DB_USER</code><br/>\r
 285                                 your MySQL username<br/>\r
 286                                 <em>Example:</em> <tt>'joe'</tt></li>\r
 287                                 <li><code>YOURLS_DB_PASS</code><br/>\r
 288                                 your MySQL password<br/>\r
 289                                 <em>Example:</em> <tt>'MySeCreTPaSsW0rd'</tt></li>\r
 290                                 <li><code>YOURLS_DB_NAME</code>:\r
 291                                 The database name<br/>\r
 292                                 <em>Example:</em> <tt>'yourls'</tt></li>\r
 293                                 <li><code>YOURLS_DB_HOST</code><br/>\r
 294                                 The database host<br/>\r
 295                                 <em>Example:</em> <tt>'localhost'</tt></li>\r
 296                                 <li><code>YOURLS_DB_PREFIX</code><br/>\r
 297                                 The name prefix for all the tables YOURLS will need<br/>\r
 298                                 <em>Example:</em> <tt>'yourls_'</tt></li>\r
 299                         </ul>\r
 300                         \r
 301                         <h3>Site options</h3>\r
 302                         <ul>\r
 303                                 <li><code>YOURLS_SITE</code><br/>\r
 304                                 Your (short) domain URL, no trailing slash<br/>\r
 305                                 <em>Example:</em> <tt>'http://ozh.in'</tt></li>\r
 306                                 <li><code>YOURLS_HOURS_OFFSET</code><br/>\r
 307                                 Timezone GMT offset<br/>\r
 308                                 <em>Example:</em> <tt>'-5'</tt></li>\r
 309                                 <li><code>YOURLS_PRIVATE</code><br/>\r
 310                                 Private means protected with login/pass as defined below. Set to false for public usage<br/>\r
 311                                 <em>Example:</em> <tt>'true'</tt></li>\r
 312                                 <li><code>YOURLS_UNIQUE_URLS</code><br/>\r
 313                                 Allow multiple short URLs for a same long URL<br/>\r
 314                                 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
 315                                 <em>Example:</em> <tt>'true'</tt></li>\r
 316                                 <li><code>YOURLS_COOKIEKEY</code><br/>\r
 317                                 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
 318                                 <em>Example:</em> <tt>'qQ4KhL_pu|s@Zm7n#%:b^{A[vhm'</tt></li>\r
 319                                 <li><code>yourls_user_passwords</code><br/>\r
 320                                 A list of username(s) and password(s) allowed to access the site if private<br/>\r
 321                                 <em>Example:</em> <tt>'joe' => 'mypassword'</tt></li>\r
 322                         </ul>\r
 323                         \r
 324                         <h3>URL Shortening settings</h3>\r
 325                         <ul>\r
 326                                 <li><code>YOURLS_URL_CONVERT</code><br/>\r
 327                                 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
 328                                 <li><code>yourls_reserved_URL</code><br/>\r
 329                                 A list of reserved keywords that won't be used as short URLs. Define here negative, unwanted or potentially misleading keywords<br/>\r
 330                                 <em>Example:</em> <tt>'porn', 'faggot', 'sex', 'nigger', 'fuck', 'cunt', 'dick', 'gay'</tt></li>\r
 331                         </ul>\r
 332                         \r
 333                         <h3>Optional settings</h3>\r
 334                         <ul>\r
 335                                 <li><code>YOURLS_PRIVATE_INFOS</code><br/>\r
 336                                 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
 337                                 <tt>define('YOURLS_PRIVATE_INFOS', false);</tt>\r
 338                                 </li>\r
 339                                 <li><code>YOURLS_PRIVATE_API</code><br/>\r
 340                                 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
 341                                 <tt>define('YOURLS_PRIVATE_API', false);</tt>\r
 342                                 </li>\r
 343                 </div>\r
 344                 \r
 345                 <!-- WordPress plugin -->\r
 346                 <div id="PluginDiv" style="display:none">\r
 347                         <h2>WordPress Plugin</h2>\r
 348                         \r
 349                         <h3>Features</h3>\r
 350                         <ul>\r
 351                                 <li>Generate short URLs for each new post or page</li>\r
 352                                 <li>Send a tweet on your Twitter account with the post title and short URL as you publish them</li>\r
 353                                 <li>Works if YOURLS is hosted on the same server or on a remote server</li>\r
 354                                 <li>Also compatible with tr.im, is.gd, tinyurl.com and bit.ly for maximum fun</li>\r
 355                         </ul>\r
 356                         \r
 357                         <h3>Screenshots</h3>\r
 358                         <div class="sshot">\r
 359                         <img src="http://yourls.org/images/wpplugin.gif"/>\r
 360                         </div>\r
 361                         \r
 362                         <h3>Download &amp; more informations</h3>\r
 363                         <ul>\r
 364                                 <li>Download <a href="http://yourls.org/plugin">YOURLS: WordPress to Twitter</a> from the official WordPress plugin repository</li>\r
 365                                 <li>More information, tips and feedback on <a href="http://yourls.org/plugindoc">the plugin page</a> from planetOzh</li>\r
 366                         </ul>\r
 367                 \r
 368                 </div>\r
 369                 \r
 370                 <!-- API -->\r
 371                 <div id="APIDiv" style="display:none">\r
 372                         <h2>YOURLS' API</h2>\r
 373                         \r
 374                         <h3>Features</h3>\r
 375                         <ul>\r
 376                                 <li>Generate or get existing short URLs, with sequential or custom keyword</li>\r
 377                                 <li>Get some statistics about your links: top clicked links, least clicked links, newest links</li>\r
 378                                 <li>Output format: JSON, XML, or simple raw text</li>\r
 379                         </ul>\r
 380                         \r
 381                         <h3>Usage</h3>\r
 382                         <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
 383                         <ul>\r
 384                                 <li>A valid <code>username</code></li>\r
 385                                 <li>A valid <code>password</code></li>\r
 386                                 <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
 387                                 <li>With <tt>action = "shorturl"</tt> :\r
 388                                         <ul>\r
 389                                                 <li>the <code>url</code> to shorten</li>\r
 390                                                 <li>optional <code>keyword</code> for custom short URLs</li>\r
 391                                                 <li>output <code>format</code>: either <tt>"json"</tt>, <tt>"xml"</tt> or <tt>"simple"</tt></li>\r
 392                                         </ul>\r
 393                                 </li>\r
 394                                 <li>With <tt>action = "expand"</tt> :\r
 395                                         <ul>\r
 396                                                 <li>the <code>shorturl</code> to expand (can be either 'abc' or 'http://site/abc')</li>\r
 397                                                 <li>output <code>format</code>: either <tt>"json"</tt>, <tt>"xml"</tt> or <tt>"simple"</tt></li>\r
 398                                         </ul>\r
 399                                 </li>\r
 400                                 <li>With <tt>action = "stats"</tt> :\r
 401                                         <ul>\r
 402                                                 <li>the <code>filter</code>: either <tt>"top"</tt>, <tt>"bottom"</tt> , <tt>"rand"</tt> or <tt>"last"</tt></li>\r
 403                                                 <li>the <code>limit</code> (maximum number of links to return)</li>\r
 404                                                 <li>output <code>format</code>: either <tt>"json"</tt> or <tt>"xml"</tt></li>\r
 405                                         </ul>\r
 406                                 </li>\r
 407                         </ul>\r
 408                         \r
 409                         <h3>Sample return</h3>\r
 410                         <pre><tt>&lt;result&gt;\r
 411         &lt;url&gt;\r
 412                 &lt;id&gt;62019439011&lt;/id&gt;\r
 413                 &lt;keyword&gt;shorter&lt;/keyword&gt;\r
 414                 &lt;url&gt;http://somereallylongurlyouneedtoshrink.com/&lt;/url&gt;\r
 415                 &lt;date&gt;2009-06-23 18:08:07&lt;/date&gt;\r
 416                 &lt;ip&gt;127.0.0.1&lt;/ip&gt;\r
 417         &lt;/url&gt;\r
 418         &lt;status&gt;success&lt;/status&gt;\r
 419         &lt;message&gt;http://somereallylongurlyouneedtoshrink.com/ (ID: shorter) added to database&lt;/message&gt;\r
 420         &lt;shorturl&gt;http://yoursite.com/shorter&lt;/shorturl&gt;\r
 421 &lt;/result&gt;</tt></pre>\r
 422 \r
 423                         <h3>Sample file</h3>\r
 424                         <p>There's a sample file included that serves as an example on how to play with the API</p>\r
 425 \r
 426                 </div>\r
 427                 \r
 428 \r
 429                 <!-- FAQ Instructions -->       \r
 430                 <div id="FAQDiv" style="display: none;">\r
 431                         <h2>FAQ</h2>\r
 432 \r
 433                         <h3>Server requirements</h3>\r
 434                         <ol>\r
 435                                 <li>A server with <strong>mod_rewrite</strong> enabled</li>\r
 436                                 <li>At least <strong>PHP 4.3</strong></li>\r
 437                                 <li>At least <strong>MYSQL 4.1</strong></li>\r
 438                                 <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
 439                         </ol>\r
 440 \r
 441                         <h3>Server recommendations</h3>\r
 442                         <ul>\r
 443                                 <li>PHP <a href="http://www.php.net/curl">CURL extension</a> installed if you plan on playing with the API</li>\r
 444                                 <li>PHP <a href="http://www.php.net/manual/en/ref.bc.php">BCMath extension</a> for handling large integers (ie many (really many many) links or long custom keyword URLs)</li>  \r
 445                         </ul>\r
 446                         \r
 447                         <h3>Limitations</h3>\r
 448                         <ul>\r
 449                                 <li>Maximum length of custom keyword is <strong>12 characters</strong></li>\r
 450                                 <li><strong>4,738,381,338,321,617,846</strong> available URLs</li>\r
 451                         </ul>\r
 452                         \r
 453                         <h3>Difference Between Base 36 And Base 62 Encoding</h3>\r
 454                         <ul>\r
 455                                 <li>Base 36 encoding uses <code>0123456789abcdefghijklmnopqrstuvwxyz</code></li>\r
 456                                 <li>Base 62 encoding uses <code>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz</code></li>\r
 457                                 <li>Stick to one setting, don't change after you've created links as it will change all your short URLs!</li>\r
 458                                 <li>Base 36 should be picked. Use 62 only if you understand what it implies.</li>\r
 459                                 <li>Using base 62 means you *need* PHP extension BCMath</li>\r
 460                                 <li>Consider Base 62 encoding a <code>beta feature</code></li>\r
 461                         </ul>\r
 462                         \r
 463                         <h3>Getting a short domain name for your YOURLS install</h3>\r
 464                         <ul>\r
 465                                 <li>Unless you plan on making it public, any shared hosting should be fine</li>\r
 466                                 <li><a href="http://domai.nr/">Domainr</a> is a fun search tool that might inspire and help you</li>\r
 467                                 <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
 468                         </ul>\r
 469 \r
 470                         <h3>YOURLS needs its own .htaccess</h3>\r
 471                         <ul>\r
 472                                 <li>You cannot install YOURLS and, say, WordPress, in the same directory. Both of them need to handle URLs differently</li>\r
 473                                 <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
 474                         </ul>\r
 475                         \r
 476                         <h3>If YOURLS generates 404 for your short URLs</h3>\r
 477                         <ul>\r
 478                                 <li>Make sure <strong>mod_rewrite</strong> is enabled with your Apache server</li>\r
 479                                 <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
 480                         </ul>\r
 481                         \r
 482                         <h3>Feedback and bug reporting</h3>\r
 483                         <ul>\r
 484                                 <li>Please don't get in touch directly by mail or Twitter</li>\r
 485                                 <li>Raise an <a href="http://yourls.org/issues">issue here</a> and give all the details. Thanks!</li>\r
 486                         </ul>\r
 487 \r
 488                 </div>\r
 489                 \r
 490                 \r
 491                                 <!-- Showcase -->       \r
 492                 <div id="ShowcaseDiv" style="display: none;">\r
 493                         <h2>Showcase</h2>\r
 494 \r
 495                         <h3>Here are a few examples of sites running YOURLS with a unique design or concept</h3>\r
 496                         \r
 497                         <ul>\r
 498                                 <li><a href="http://hmm.ph/">http://hmm.ph/</a><br/>\r
 499                                 Funny domain name, nicely styled</li>\r
 500                                 <li><a href="http://qte.me/">http://qte.me/</a><br/>\r
 501                                 Another YOURLS setup with a cute quote look</li>\r
 502                                 <li><a href="http://unsl.im/">http://unsl.im/</a><br/>\r
 503                                 Gorgeous design listing latest links with a custom RSS feed (private use)</li>\r
 504                                 <li><a href="http://mrte.ch/">http://mrte.ch/</a><br/>\r
 505                                 Mr Tech's public YOURLS setup, listing top links and some stats</li>\r
 506                                 <li><a href="http://s4c.in/">http://s4c.in/</a><br/>\r
 507                                 Shorten 4 Charity, a public YOURLS setup with shortened links displayed within a frame containing ads for charities     </li>\r
 508                                 <li><a href="http://girv.in/">http://girv.in/</a><br/>\r
 509                                 John Girvin's YOURLS setup with all links in a sortable display</li>\r
 510                                 <li><a href="http://www.iyeman.net/">http://www.iyeman.net/</a><br/>\r
 511                                 <a href="http://tinytags.co.cc/">http://tinytags.co.cc/</a><br/>\r
 512                                 Examples of portals for your online self with links to your places (blog, Twitter) and your URL shortener</li>\r
 513                                 <li><a href="http://li.nkto.me/">http://li.nkto.me/</a><br/>\r
 514                                 A nice domain name hack :)</li>\r
 515                                 <li><a href="http://vb.ly/">http://vb.ly/</a><br/>\r
 516                                 Public YOURLS setup run by famous sex writer Violet Blue as "the internet's first and only sex-positive url shortener"</li>\r
 517                                 \r
 518                         </ul>\r
 519                         \r
 520                         <h3>More stuff about or with YOURLS</h3>\r
 521                         \r
 522                         <ul>\r
 523                                 <li><a href="http://screenr.com/nTs">http://screenr.com/nTs</a><br/>\r
 524                                 A screencast explaining how to setup YOURLS</li>\r
 525                                 <li><a href="http://foolrulez.org/blog/2009/09/yourls-widget-released">YOURLS Widget for WordPress</a><br/>\r
 526                                 This widget adds a convenient short URL service into your sidebar. Check the above link for a live example</li>\r
 527                                 <li><a href="http://github.com/pjain/WWW-Shorten-Yourls">WWW-Shorten-Yourls</a><br/>\r
 528                                 A Perl module to shorten URLs using YOURLS</li>\r
 529                                 <li>YOURLS featured on <a href="http://lifehacker.com/5335216/make-your-own-url-shortening-service">Lifehacker</a></li>\r
 530                         </ul>\r
 531 \r
 532                 </div>\r
 533         </div> <!-- content -->\r
 534 </div> <!-- container -->\r
 535 \r
 536 <div id="Copyright"><p><a href="http://yourls.org/">YOURLS</a>: Your Own URL Shortener<br />All Free & GPL &ndash; 2009</p></div>\r
 537 \r
 538         <script type="text/javascript">\r
 539         /* <![CDATA[*/\r
 540         // Dynamically get tabs\r
 541         function getTabs() {\r
 542                 var d = document.getElementById('Tabs');\r
 543                 var matches = d.innerHTML.match(/<li id="(.+?)Tab"/g);\r
 544                 var tabs = []\r
 545                 for (i in matches) {\r
 546                   tabs[i]= matches[i].replace('<li id="','').replace('Tab"', '');\r
 547                 }\r
 548                 tabs = tabs.reverse();\r
 549                 return (tabs)\r
 550         }\r
 551         // Toggle tab display\r
 552         function toggle(el) {\r
 553                 //var tabs = ["About", "Install", "Config", "Plugin", "FAQ"];\r
 554                 var target = el.toString().replace(/^.*#/, '');\r
 555                 for (var tab in tabs) {\r
 556                         // reinit tabs\r
 557                         document.getElementById(tabs[tab]+'Tab').className = 'Tab';\r
 558                         // reinit divs\r
 559                         document.getElementById(tabs[tab]+'Div').style.display= 'none';\r
 560                 }\r
 561                 // highlight & display target\r
 562                 document.getElementById(target+'Div').style.display = 'block';\r
 563                 document.getElementById(target+'Tab').className = 'SelectedTab';\r
 564                 try { el.blur(); } catch(err) {}\r
 565         }\r
 566         // Get tab list\r
 567         var tabs = getTabs();\r
 568         // On page load/refresh display required tab\r
 569         if (location.hash) {\r
 570                 toggle(location.hash);\r
 571         }\r
 572         /* ]]> */\r
 573         </script>\r
 574 \r
 575 \r
 576 </body>\r
 577 </html>