swoichha / foodcoopshop

Open source software for foodcoops

An easy-to-use open source software for food-coops.

FoodCoopShop provides a lot of of useful functions to help the people running a food-coop.

• a user-friendly web shop for the consumers
• an admin area for both manufacturers and admins
• a fully automated payment system
• different delivery rhythms for products
• adapting orders in many ways
• self-service mode for stock products
• beautiful turnover charts

The software can be used with any modern web browser, tablet or smartphone. It's available in German, English and Polish.

Links

• Crowdfunding for new features
• Official homepage: https://www.foodcoopshop.com
• Demo version in German, English and Polish
• Software documentation: https://foodcoopshop.github.io
• Facebook / Twitter / List of users / Map of users

Legal information

• Before installing please read the legal information in German or English.

Requirements

• Server with shell access and cronjobs
• Apache with mod_rewrite
• PHP >= 7.3
• PHP intl extension INTL_ICU_VERSION >= 50.1
• PHP ZipArchive class
• MySQL >= 5.7.7 (to support utf8mb4)
• Node.js and npm (installation) developer packages
• Composer (installation) developer packages
• Basic understanding of Apache Webserver, MySQL Database and Linux Server administration
• PHP needs to be able to call mysqldump with exec() for database backups

Installation / Setting up dev environment

• Follow the installation guide for setup.
• If you have questions please create a new issue on Github.
• Before doing any of the configuration changes, follow the steps below.
• If you work on a local machine, do not change the owner of the files to www-data. Instead set permissions as shown below

Install required packages

$ composer install
$ npm --prefix ./webroot install ./webroot

Setting permissions

$ cd /path/to/project
$ chmod -R a+w ./files_private
$ chmod -R a+w ./tmp
$ chmod -R a+w ./webroot/cache
$ chmod -R a+w ./webroot/files
$ chmod -R a+w ./webroot/tmp

Unit Testing

• Create second database and add test database configuration to database.php. For details read Cake's testing documentation
• Import this dump into your test database

$ vendor/bin/phpunit

Supported by Netidee Calls 10 and 12

The FoodCoopShop project was supported by Netidee in 2016 and 2018. Netidee supports Internet and Open Source ideas with up to 50.000 Euro in funding. If you are working on an Open Source projects and are permanent resident in Austria, apply for your own funding!

Maintainer

Mario Rothauer started the project in 2014 and maintains it.