Contributing: Getting Started

Getting Started

Logs

OpenPhoto does a lot of logging, which is very helpful during development. The destination for these logs depends on your PHP configuration. For example, by default on an Ubuntu installation with Apache, the settings of interest in /etc/php5/apache2/php.ini are:

log_errors = On
;error_log =     # default value is empty

It means that the logs can be found in /var/log/apache2/error.log (still on Ubuntu with Apache).

Useful debugging information is logged at the info logging level in OpenPhoto, which is not displayed by default. To enable it, add the following to your config file in src/userdata/configs/[config file].ini:

[epi]
logLevels="crit,warn,info"

The default value is "crit,warn" and is set in src/configs/defaults.ini.

Note: If you will be working on the set-up process, that happens before the config file in userdata is created, it can be useful to change the logLevels line in defaults.ini. Just make sure you don’t commit this change.

dev and prod modes

OpenPhoto runs in prod mode by default, where is combines, minifies(?) and caches CSS and JavaScript files for performance reasons. The cache is located in src/html/assets/cache/. Moreover, it uses the already minified JavaScript found in the src/html/assets/themes/[theme]/javascripts/min/ folder. Therefore, if you are going to modify the CSS or JavaScript, make sure you set the mode to dev in the config file:

[site]
mode=dev

The default value is prod and is set in src/configs/defaults.ini.