]> jfr.im git - uguu.git/blobdiff - README.md
Update rain.tpl.class.php
[uguu.git] / README.md
index 3a61f7d79288336a873634ae27f4b41770c745c0..8700b94a3870a857fe0b31c3dc01097ff45aae93 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,25 +1,46 @@
 # About
-[Uguu.se](http://uguu.se) source code, stores files and deletes after 1 hour.
+[Uguu.se](http://uguu.se) source code, stores files and deletes after X amount of time.
 
 # Install
-Tested with Nginx+PHP5-FPM (PHP 5.4) on Debian 7 Wheezy.
+Tested with:
+* Nginx+PHP5-FPM (PHP 5.4) on Debian 7 Wheezy 
+* Apache (PHP 5.4) on Ubuntu 14.04 LTS
+* Nginx+PHP5-FPM (PHP 5.6) on Debian 8 Jessie
 
-Modify core.php where to save the files, add check.sh to Cron, edit everything else to your likings.
+Modify 
+* core.php on where to save the files (line 4) and the prepend to the uploaded URL (line 26)
+* Cron with check.sh: `crontab -e` 
+* Some extensions are blocked by default, this can be changed via includes/core.php's $block array.
+* Everything else to your likings.
 
 Change php.ini and nginx.conf settings to allow bigger uploads.
 
+Make the uguu/ directory modifiable to the nginx user:
+`setfacl -m u:www-data:rwx /path/to/uguu/directory/`
+
 # Todo
 
-Proper design, commit new design and updated code (when finished, in preview phase).
+* Respond with JSON rather then a white page with echo, will break current tools for the page tho, maybe add a switch so using the webpage will respond using JSON by default and using the 'API' will respond with a plain echo by default?
+* Probably a lot of things but I'm a lazy fuck, come with suggestions.
 
 
 # Using the API
 
+  Be sure to set a user agent, otherwise CF might reject you as malicious.
+
   Leaving POST value 'name' empty will cause it to save using the original filename.
   Leaving POST value 'randomname' empty will cause it to use original filename or custom name if 'name' is set to file.ext.
   
   Putting anything into POST value 'randomname' will cause it to return a random filename + ext (xxxxxx.ext).
   Putting a custom name into POST value 'name' will cause it to return a custom filename (yourpick.ext).
+  
+  E.g:
+  
+  
+  curl -i -F name=test.jpg -F file=@localfile.jpg http://uguu.se/api.php?d=upload (HTML Response)
+  
+  
+  curl -i -F name=test.jpg -F file=@localfile.jpg http://uguu.se/api.php?d=upload-tool (Plain text Response)
 
 
 This will probably get changed later since it's messy and unpractical.