This application was originally developed to track compost pickups / volumes for Rust Belt Riders. It has been open sourced to help other compost startups get started.
https://www.gnu.org/licenses/gpl-3.0.en.html
- Tracking of commercial pickups.
- Compost Pile Temperature / Turn Tracking
- User Management for employees and customers.
- Basic Reporting for volumes and invoicing needs.
The fastest way to get running is using a provider like Heroku.
- Create a Heroku Account if you don't already have one
- Set the variables when prompted before deploying.
- Configure the 'Deploy' tab in Heroku to integrate with GitHub for updates - https://devcenter.heroku.com/articles/github-integration
The default login of the application is --
User:admin Password: passwd. CHANGE THE PASSWORD of your application after login.
The second and very common way to run a PHP application is paying for hosting a traditional web hosting provider. This would provide a fixed cost each month to run your application. Most likely the basic level of hosting on many providers will be sufficient for many years of growing your business. We would recommend SiteGround (https://www.siteground.com/) if you don't have a preference to start with.
To start development your need to have + PHP 7 (or higher) with ext-dom (sudo apt install php-xml) + MySQL with a local db user created.
Create a configuration file config/.env
with contents (modify to fit your needs):
export APP_NAME="CompostingTracker"
export DATABASE_NAME="dbname"
export DEBUG="true"
export APP_ENCODING="UTF-8"
export APP_DEFAULT_LOCALE="en_US"
export APP_DEFAULT_TIMEZONE="UTC"
export DATABASE_URL="mysql://db_user:db_password@localhost/${DATABASE_NAME}?encoding=utf8&timezone=UTC&cacheMetadata=true"eIdentifiers=false&persistent=false"
export SECURITY_SALT="--------------replace with random string---------------------------------------"
export COMPANY_NAME="Compost R Us"
export LOGO_LETTERS="CRU"
export COMPANY_PHONE_NUMBER = "216-555-5555"
export COMPANY_ADDRESS = "555 Main St, Cleveland, OH, 44114, United States"
export COMPANY_FACEBOOK = "yourFaceBookName"
export COMPANY_EMAIL = "[email protected]";
export COMPANY_TWITTER = "twitterName";
Edit the ./.htaccess file and comment out the https redirect lines.