2016-02-12 17:41:42 +01:00
# [![Logo](http://i.imgur.com/aOtrJNz.png)](https://project.polr.me)
2015-11-04 03:25:30 +01:00
#####v2 Devel
:aerial_tramway: A modern, minimalist, and lightweight URL shortener.
2016-02-13 22:57:29 +01:00
[![GitHub license ](https://img.shields.io/badge/license-GPLv2%2B-blue.svg )]()
[![Builds status ](https://travis-ci.org/cydrobolt/polr.svg )](https://travis-ci.org/cydrobolt/polr)
2015-11-15 16:51:02 +01:00
[![Docs ](https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat )](http://polr.readthedocs.org/en/2.0-dev/)
2015-11-07 02:27:11 +01:00
Welcome to Polr's 2.0 development branch.
2016-02-12 17:41:42 +01:00
Please keep in mind 2.0 is currently unstable, and should not be used in production.
Polr is an enterprise-class open-source link shortening web application designed to operate at many scales, built on the Software-as-a-Service paradigm. It allows you to host your own URL shortener, to brand your URLs, and to gain control over your data. Polr is especially easy to use, and provides a modern, themable feel.
[Getting Started ](http://docs.polr.me/en/2.0-dev/user-guide/installation/ ) - [API Documentation ](http://docs.polr.me/en/2.0-dev/developer-guide/api/ ) - [Contributing ](https://github.com/cydrobolt/polr/blob/2.0-dev/CONTRIBUTING.md ) - [Bugs ](https://github.com/cydrobolt/polr/issues ) - [IRC ](http://webchat.freenode.net/?channels=#polr )
#### Quickstart
Polr is written in PHP and Laravel, using MySQL as its primary database.
2016-02-12 17:42:02 +01:00
- To get started with Polr on your server, check out the [installation guide ](http://docs.polr.me/en/2.0-dev/user-guide/installation/ ). You can clone this repository, or download a [release ](https://github.com/cydrobolt/polr/releases ).
- To get started with the Polr API, check out the [API guide ](http://docs.polr.me/en/2.0-dev/developer-guide/api/ ).
2015-11-04 03:25:30 +01:00
2016-02-29 05:06:17 +01:00
_Installation TL;DR: clone or download this repository, set document root to `public/` , MySQL create database, go to `yoursite.com/setup` _
2016-02-12 17:41:42 +01:00
####Versioning
2015-11-04 03:25:30 +01:00
2016-02-12 17:41:42 +01:00
Polr uses [Semantic Versioning ](http://semver.org/ )
2015-11-15 16:51:02 +01:00
2015-11-04 03:25:30 +01:00
####License
2016-01-19 00:15:35 +01:00
Copyright (C) 2013-2016 Chaoyi Zha
2015-11-04 03:25:30 +01:00
2015-11-07 02:27:11 +01:00
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
2015-11-04 03:25:30 +01:00
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
2015-11-07 02:27:11 +01:00
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.