1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
# Pomf
Pomf is a simple file uploading and sharing platform.
## Features
- One click uploading, no registration required
- A minimal, modern web interface
- Drag & drop supported
- Upload API with multiple response choices
- JSON
- HTML
- Text
- CSV
- Supports [ShareX](https://getsharex.com/) and other screenshot tools
### Demo
See the real world example at [Pantsu.cat](https://pantsu.cat/).
## Requirements
Original development environment is Nginx + PHP5.5 + MySQL, but is confirmed to
work with Apache 2.4 and newer PHP versions. Should work with any other
PDO-compatible database.
## Install
For the purposes of this guide, we won't cover setting up Nginx, PHP, MySQL,
Node, or NPM. So we'll just assume you already have them all running well.
### Compiling
The assets are minified and combined using [Grunt](http://gruntjs.com/).
Assuming you already have Node and NPM working, compilation is easy. Use the
following shell code:
npm install -g grunt-cli
git clone https://git.pantsu.cat/pantsu/pomf.git
cd pomf/
npm install
grunt
After this, the pomf site is now compressed and set up inside `dist/`.
## Configuring
The majority of the settings are in `static/includes/settings.inc.php`.
For file size configuration, open `Gruntfile.js` in an editor and modify the
`max_upload_size` value. The value is expressed in mebibytes (MiB). Run `grunt`
again to rebuild the pages for the changes to take effect.
If you intend to allow uploading files larger than 2 MB, you may also need to
increase POST size limits in `php.ini` and webserver configuration. For PHP,
modify `upload_max_filesize` and `post_max_size` values. The configuration
option for nginx webserver is `client_max_body_size`.
A best practice is to disable executing `.php` files on the `POMF_URL` domain
for uploaded files. This assures that a malicious user cannot execute arbitrary
PHP code on the server.
### Apache
If you are running Apache and want to compress your output when serving files,
add to your `.htaccess` file:
AddOutputFilterByType DEFLATE text/html text/plain text/css application/javascript application/x-javascript application/json
Remember to enable `deflate_module` and `filter_module` modules in your Apache
configuration file.
## Getting help
The Pomf community gathers on IRC. You can also email the maintainer for help.
- IRC (users): `#pomfret` on Rizon (`irc.rizon.net`)
- IRC (developers): `#pomf` on Partyvan (`irc.partyvan.eu`)
- Email: <hostmaster@pantsu.cat>
## Contributing
For source code changes, please submit `git-format-patch(1)` formatted patches
via email or come talk to us on IRC to merge your branch. See "Getting help".
At this time, we do not use any Git service issue tracking for issues or pull
requests due to ethical and technical objections.
We'd really like if you can take some time to make sure your coding style is
consistent with the project. Pomf follows [PHP
PSR-2](http://www.php-fig.org/psr/psr-2/) and [Airbnb JavaScript
(ES5)](https://github.com/airbnb/javascript/tree/master/es5) (`airbnb/legacy`)
coding style guides. We use ESLint and PHPCS tools to enforce these standards.
You can also help by sending us feature requests or writing documentation and
tests.
Thanks!
## Credits
Pomf was created by Eric Johansson and Peter Lejeck for
[Pomf.se](http://pomf.se/). The software is currently maintained by the
community.
## License
Pomf is free software, and is released under the terms of the Expat license. See
`LICENSE`.
|
