diff options
| author | pantsucat <contact@pantsu.cat> | 2015-09-18 06:42:16 +0200 |
|---|---|---|
| committer | pantsucat <contact@pantsu.cat> | 2015-09-18 06:42:16 +0200 |
| commit | a01269acc196cac2064eaa9162e7d90b9dbe6626 (patch) | |
| tree | 6f02befa56074ae2273c99d13f03effbaaf6c8f0 /README.md | |
| parent | dbc1450225a3ebc4633f4d3b76bb8ad133f6ace7 (diff) | |
| parent | 2a0bc6e20ce1e348962301eadb055f1d5971e1de (diff) | |
Merge branch 'wub'
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 61 |
1 files changed, 42 insertions, 19 deletions
@@ -1,41 +1,55 @@ # Pomf -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. +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: -``` -$ npm install -g grunt-cli -$ git clone git://github.com/pantsucat/pomf.git -$ cd pomf/ -$ npm install -$ grunt -``` -After this, the pomf site is now compressed and set up inside `dist/`. +Assuming you already have Node and NPM working, compilation is easy. Use the +following shell code: #### 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 +npm install -g grunt-cli +git clone git://github.com/pantsucat/pomf.git +cd pomf/ +npm install +grunt ``` -Remember to enable `deflate_module` and `filter_module` modules in your Apache configuration file. -### Configuring -The majority of settings are in `static/includes/settings.inc.php`. Read the +After this, the pomf site is now compressed and set up inside `dist/`. + +## Configuring + +The majority of settings are in `static/includes/settings.inc.php`. Read the comments in that file for more information. -For file size configuration, there is no server-side verification: we assume -that PHP and Nginx provide ample protection in this department. There is, +For file size configuration, there is no server-side verification: we assume +that PHP and Nginx provide ample protection in this department. There is, however, client-side configuration for max size, the `data-max-size` attribute on the file input in `pages/upload_form.swig`. -Make sure to disable PHP from being executed on the file download domain/directory (e.g a.site.com), otherwise a attacker can upload a malicious .php file and execute it on your server. +Make sure to disable PHP from being executed on the file download +domain/directory (e.g a.site.com), otherwise a attacker can upload a malicious +.php file and execute it on your 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. ## Todo @@ -44,3 +58,12 @@ Make sure to disable PHP from being executed on the file download domain/directo ## Contact I can be contacted via hostmaster@pantsu.cat. +======= +## License + +Pomf is free software, and is released under the terms of the MIT (Expat) +license. See LICENSE. + +## Contact + +The maintainer can be contacted via hostmaster@pantsu.cat. |
