PastonBin/README.md

131 lines
4.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# PastonBin 2.12
____ _ ____ _
| _ \ __ _ ___| |_ ___ _ __ | __ )(_)_ __
| |_) / _` / __| __/ _ \| '_ \| _ \| | '_ \
| __/ (_| \__ \ || (_) | | | | |_) | | | | |
|_| \__,_|___/\__\___/|_| |_|____/|_|_| |_|
Customized by
(thanks @Kristuff)
Paste is forked from the original source pastebin.com used before it was bought.
The original source is available from the previous owner's **[GitHub repository](https://github.com/lordelph/pastebin)**
[![Frontend](https://blog.echosystem.fr/img/2f/pastebin.jpg)](http://pastebin.echosystem.fr)
Requirements
===
* Apache 2.X / Nginx
* PHP 5.3.7 (or later) with php-mcrypt & GD enabled [PHP5.5+ recommended]
* MySQL 5.x+
* apt install php7.0-mcrypt
---
Install
===
* Create a database for PASTE.
* Upload all files to a webfolder
* Point your browser to http(s)://example.com/install
* Input some settings, DELETE the install folder and you're ready to go.
Manual install
===
Do the first two steps above and import the database schema using the CLI (or import via phpMyAdmin)
```
mysql -uuser -ppassword databasename < docs/paste.mysqlschema.sql
```
Move docs/config.example.php to config.php and edit
Development setup
===
* Set up git
* Fork this repository
* Create a database for PASTE.
* Check out the current master branch of your fork
* Point your browser to http(s)://example.com/install and follow the instructions on screen or import docs/paste.mysqlschema.sql into your database and copy docs/config.example.php to config.php and edit
Now you can start coding and send in pull requests.
---
Clean URLs
===
Set mod_rewrite in config.php to 1
For Apache, just use .htaccess
For Nginx, use the example config in **[docs/nginx.example.conf](https://github.com/jordansamuel/PASTE/blob/master/docs/nginx.example.conf)**
---
Changelog
===
See **[docs/CHANGELOG.md](https://github.com/jordansamuel/PASTE/blob/master/docs/CHANGELOG.md)**
---
Paste now supports pastes of upto 4GB in size, and this is configurable in config.php
However, this relies on the value of post_max_size in your PHP configuration file.
```php
// Max paste size in MB. This value should always be below the value of
// post_max_size in your PHP configuration settings (php.ini) or empty errors will occur.
// The value we got on installation of Paste was: post_max_size = 1G
// Otherwise, the maximum value that can be set is 4000 (4GB)
$pastelimit = "1"; // 0.5 = 512 kilobytes, 1 = 1MB
```
To enable registration with OAUTH see this block in config.php
```php
// OAUTH (to enable, change to yes and edit)
$enablefb = "no";
$enablegoog = "no";
// "CHANGE THIS" = Replace with your details
// Facebook
define('FB_APP_ID', 'CHANGE THIS'); // Your application ID, see https://developers.facebook.com/docs/apps/register
define('FB_APP_SECRET', 'CHANGE THIS'); // What's your Secret key
// Google
define('G_Client_ID', 'CHANGE THIS'); // Get a Client ID from https://console.developers.google.com/projectselector/apis/library
define('G_Client_Secret', 'CHANGE THIS'); // What's your Secret ID
define('G_Redirect_Uri', 'http://urltoyour/installation/oauth/google.php'); // Leave this as is
define('G_Application_Name', 'Paste'); // Make sure this matches the name of your application
```
Everything else can be configured using the admin panel.
---
Credits
===
* Paul Dixon for developing **[the original pastebin.com](https://github.com/lordelph/pastebin)**
* **[Pat O'Brien](https://github.com/poblabs)** for numerous contributions to the project.
* **[Viktoria Rei Bauer](https://github.com/ToeiRei)** for her contributions to the project.
* Roberto Rodriguez (roberto.rodriguez.pino[AT]gmail.com) for PostgreSQL support on v1.9.
The Paste theme was built using Bootstrap, jQuery and various jQuery plugins for
present and future features, but we do try to keep it bloat free.
Icons are provided by FontAwesome.
____ _ ____ _
| _ \ __ _ ___| |_ ___ _ __ | __ )(_)_ __
| |_) / _` / __| __/ _ \| '_ \| _ \| | '_ \
| __/ (_| \__ \ || (_) | | | | |_) | | | | |
|_| \__,_|___/\__\___/|_| |_|____/|_|_| |_|