Lessn More 2.2.0

Homepage: http://lessnmore.net
Source/Fork: http://github.com/alanhogan/lessnmore

Lessn More is a free, open-source personal URL shortener.

Features

Attention to detail

Caveats

Requirements

History

v1.0

Lessn was the original personal URL shortening service, written by Shaun Inman. It required PHP, MySQL, and mod_rewrite.

v1.1

Buttered URLs is a Lessn fork by Jeremy Knope. Buttered URLs added logging, custom URLs, a migration mechanism, and support for more database types.

v2.0

Lessn More is a Buttered URLs fork by Alan Hogan. Lessn More increased the robustness of the insertion algorithm, prevented slug conflicts, updated the bookmarklets, added multiple auto-shorten modes, banned word lists, and enhanced security.

v2.1

Trims punctuation from the right of the slug, per best practices

v2.2

Better stats page.

More compatible with sqlite (see #7).

Other small fixes and improvements.

Supports a custom timezone in config.php.

Special thanks to Matt Wiebe for a lot of these changes.

Legal

Lessn is offered as-is, sans support and without warranty. Copyright © 2009-10 Shaun Inman and contributors. Offered under a BSD-like license; see license.txt.

Installation

Installation instructions are different depending on if you are upgrading or doing a fresh install.

Fresh Install

ONLY follow these instructions if you are not upgrading!

  1. Copy or rename /-/config-example.php to /-/config.php.

  2. Open /-/config.php in a plaintext editor and create a Lessn username and password then enter your database connection details. You may also choose other settings such as authentication salts, a default home page, and your current time zone.

  3. For the shortest URLs possible, upload the contents of this directory to your domain’s root public folder.

  4. Visit http://doma.in/install.php to create the necessary database tables. (Watch for errors.)

  5. Visit http://doma.in/-/ to log in & start using Lessn More! Be sure to grab the bookmarklets.

NOTE: If your Lessn’d urls aren’t working you probably didn’t upload the .htaccess file. Enable “Show invisible files” in your FTP application. It’s also possible that your host doesn’t like the <IfModule> directives; try removed them and just leaving the Rewrite* lines that were wrapped by the <IfModule>. (This seems to happen on 1and1).

Upgrading

If you are upgrading from a previous version of Lessn or ButteredURLs:

Upgrading from Lessn 1.0.0 or 1.0.1

  1. Using a tool like PhpMyAdmin or the MySQL CLI change the checksum index type to INDEX (from UNIQUE).
  2. Continue below with “ALL VERSIONS”

ALL VERSIONS: Upgrading to Lessn More 2

  1. You are strongly encouraged to back up your database.
  2. Note some old redirections so you can manually check they still work after upgrading (they should, but hey, it’s important).
  3. Manually merge your old configs into the new config file. There will be new options you will want to make decisions about.
  4. Upload all lessn/BU files, excluding config.php, or making sure to use the new one.
  5. Go to http://doma.in/install.php?start=N where N is 2 if upgrading from Lessn 1.0, or
    N is 4 if upgrading from ButteredURLs 1.1.
  6. Test some old known working redirections
  7. Delete install.php.
  8. Grab the new bookmarklets with custom short URL support!

Congratulations. You are running the latest version of Lessn More.

Upgrading from Lessn More 2.0 or 2.1 to LM 2.2

Just upload the latest copy of Lessn More to your server, but skip or delete install.php.

Note that since v2.2, there is only a config-example.php file in the distribution, and no config.php file. You will not need to take care to avoid overwriting your existing config.php file, but do take care not to replace the whole /-/ folder and your config.php file; please make a backup copy of it before upgrading.

API

You can find API documentation here. It’s super simple.

Issues

To report an issue or check known issues, visit the Lessn More issue tracker on GitHub.