So, you think you found a bug? Well, please let us know!
But first, please make sure it is a problem with UserFrosting, and not a problem with the way your server is configured. If you're getting a "white screen of death" when you try to install, there is a good chance that your server is not configured properly. See the troubleshooting guide for help.
We recommend that you install a local development server on your computer, rather than testing your code directly on the production server. This means you can test your code directly on your own computer, making development faster and without the risk of exposing sensitive information to the public. We recommend installing XAMPP if you don't already have a local server set up.
Please also make sure you check the installation requirements. Notably, UserFrosting requires PHP 5.4 or higher to work!
If you know all of this already, and you're pretty sure the problem is in our code, please open up an issue. Try to provide as much information as possible, including what you were doing when the problem occurred, what type of server you are running on (Apache, IIS, nginx, etc), and any errors in your PHP error log and/or browser console.
Tips for reporting issues
- Remember that courtesy and proper grammar go a long way. Please take the time to craft a precise, polite issue. We will do our best to help, but remember that this is an open source project - none of us are getting paid a salary to develop this project, or act as your personal support hotline ;-)
- Carefully search the existing issues, both opened and closed. Your question may have already been asked and answered before!
- Report any error messages you get. There are two main places where you may find error messages:
- Backend (PHP-related) errors: in your PHP error log. This is usually a file called
php_error_log or something like that. In XAMPP, the default location of this file is XAMPP/xamppfiles/logs/. For other web hosting platforms, please consult the documentation or do a quick Google search (i.e. "where is the php error log in _____"). Some web hosts may provide a special interface for accessing the php error log, through ssh, cpanel, etc. Please ask them directly for help with this.
- Frontend (Javascript-related) errors: in your browser's Javascript console. This can be accessed from "Tools->Web Developer" menu in Firefox, or "More tools->Javascript Console" in Chrome. For help with other browsers, please Google "where is the javascript console in ____".
- If you find a problem in any of the tutorials, let us know on the Issues page. Also, please feel free to contribute to the wiki pages if you have something relevant and useful to add.
