Eeemarv is open source web software for LETS groups.
It is based on the Symfony2 php framework.
Issues and feature requests are tracked in the Github issue tracker.
- Git 1.6+
- PHP 5.3.3+
- php5-intl
- memcached php extension
- mailparse php extension (wiki on installation)
- phpunit 3.6+ (optional)
- composer (see Installation)
- MySQL 5.5+
- LESS compiler to compile the stylesheets of Twitter Bootstrap. To install LESS, you need NPM.
npm install -g less
// todo node and node_paths params from assetic ->composer
go to the directory where you want to install eeemarv and get the files with git (from the command line):
git clone https://github.com/marttii/eeemarv.git
Create an empty MySQL database. The parameters are needed in the next step.
Composer is used to handle the dependencies. To get composer, run the following command in the eeemarv directory:
curl -s http://getcomposer.org/installer | php
To install the dependencies, run
php composer.phar install
You will be asked to fill in some parameters for your project (these are in the app/config/parameters.yml file):
- database parameters
- mailserver parameters
- a public and a private key for reCaptcha -> get them at recaptcha.net
- a random secret key for csrf protection, you can get one from eeemarv.net/unique
- a random unique_id for your letsgroup, you can get one from eeemarv.net/unique Never it change afterwards.
- a code for your letsgroup, maximum length 8 characters. Use lowercase characters from the english alphabet - and numbers if you wish.
- locale : code of the fallback locale (language + country) or the main locale. This can be a ISO639-1 two character language code, e.g.
enfor English OR language code extended with an underscore _ and ISO3166 Alpha-2 country code, e.g.fr_FRfor French/France - locales : array of all locales supported i.g.
[ en, fr ]all translations have to present (general + site-specific). - currency_rate : divider to display the value of your currency. Lets-seconds are used by eeemarv internally, 3600/hour. e.g. if your currency unit is worth 30/hour then currency_rate is 120 (30 = 3600/120)
The name of your currency and your site-name are site specific translations, these you have to edit in app/resources/translations/site.{locale-code}.yml. Provide a file for every locale you support.
Only the /web folder should be accessible by the browser. Keep the other folders (/app, /src, /vendor) outside the server root.
The app/cache and app/logs directories must be writable both by the web server and the command line user. Here a command to try to determine the name of your webserver user:
ps aux | grep -E '[a]pache|[h]ttpd' | grep -v root | head -1 | cut -d\ -f1
e.g. set permissions in Ubuntu with setfacl (whoami is your name, www-data is the name of your webserver user):
sudo setfacl -R -m u:www-data:rwX -m u:whoami:rwX app/cache app/logs
sudo setfacl -dR -m u:www-data:rwX -m u:whoami:rwX app/cache app/logs
For other systems you might use chmod +a, see Symfony2 installation for details.
Execute the check.php script from the command line:
php app/check.php
The script returns a status code of 0 if all mandatory requirements are met,
1 otherwise.
Access the config.php script from a browser:
http://localhost/path/to/eeemarv/app/web/config.php
If you get any warnings or recommendations, fix them before moving on.
Run command
app/console doctrine:schema:update --force
Run command
app/console doctrine:fixtures:load
run command assetic:dump
app/console assetic:dump
eeemarv is distributed under the MIT license. See the LICENSE file for the complete text.
For transparency and insight into the release cycle, releases (from version 1.0.0) will be numbered with the follow format:
..
And constructed with the following guidelines:
- Breaking backwards compatibility bumps the major
- New additions without breaking backwards compatibility bumps the minor
- Bug fixes and misc changes bump the patch
For more information on semantic versioning, please visit [http://semver.org/].