WebOpal - A webinterface for Opal

For current development news see our blog...

• 1. Requirements
• 2. Installation
• 3. Update
• 4. Optimize Javascript & CSS
• 5. Optional features
• 5.1. Bugreportsystem
• 6. Protecting userfiles

##1. Minimum Requirements##

You need to install Opal on your server.

##2. Installation##

• 1. Clone this repository into your webservers document root.
• 2. Create the directories 'tmp'.
• 3. Make the dir 'tmp' writeable by the webserver
• 4. Rename config.example.php to config.php
• 5. Edit config.php
• 6. Recommended: Run make compile (See 4.)
• 7. Recommended: Enable gzip compression (See 5.)
• 8. Upload it to your server

##3. Update##

• 1. Run git pull
• 2. Recommended: Run make compile (See 4.)
• 3. Edit config.php
• 4. Upload it to your server

##4. Optimize Javascript & CSS##

###4.1. Requirements### For Javascript Optimization you will need a JRE like OpenJDK or Java

For CSS Optimization you will need Sass

###4.2. How to###

• For optimizing both: Run make compile
• For optimizing Javascript: Run make compile-js
• For optimizing CSS: Run make compile-css

###4.3. Why?### This optimization fastenes the speed of the PHP-Webopal on old PCs and/or smartphones/mobiles.

###4.4. What if I dont want to do this?### If you don't want to use the optimized versions, there are fallback CSS and Javascript available, which will be chosen, if you never run make compile.

Please note, that once you did run make compile you will need to run it after each update or delete the following files:

• js/jquery-*.min.js
• js/script.min.js
• css/style.css

##4.5. Enable gzip compression## In order to shrink server load, you are able to enable gzip compression:

• 1. Rename .htaccess.example to .htaccess
• 2. Adjust the paths in .htaccess (Please note that absolute Paths are necessary!)

##5. Optional features##

###5.1. Bugreportsystem###

We implemented an bugreportsystem, which will give your visitors the possibility of reportings bugs or ideas directly in WebOpal.

• 1. Get a keypair for recaptcha from Recaptcha.net
• 2. Paste the keys in your config.php file
• 3. Add your github username and password in your config.php
• 4. Edit $ISSUEUSER and $ISSUEREPO in your config.php
• 5. Set $BUGREPORT from false to true in your config.php

##Protecting userfiles##

###Deny access to userfiles with lighttpd###

Just paste the following code into your /etc/lighttpd/lighttpd.conf

$HTTP["url"] =~ "/tmp/files|/tmp/uploads/tmp|/userfiles|/tmp/users" {
	url.access-deny = ( "" )
}

###Deny access to userfiles with .htacess###

Create a .htaccess file with the following content

deny from all

in the following directorys:

/tmp/files/
/tmp/userfiles/
/tmp/uploads/

Create another .htaccess in the /tmp/ directory and fill it with this:

	<FilesMatch /users>
		Order deny, allow
		Deny from all
	</FilesMatch>