User Tools

Site Tools


debugging

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
debugging [2014/10/14 13:50]
shawn_a [Reporting issues in forums, or requesting assistance]
debugging [2023/11/27 18:55] (current)
Knobbles [The error log]
Line 12: Line 12:
 To turn on debugging, uncomment the GSDEBUG line in /​path/​to/​getsimple/​gsconfig.php to enable full PHP errors output to help debug in your browser. To turn on debugging, uncomment the GSDEBUG line in /​path/​to/​getsimple/​gsconfig.php to enable full PHP errors output to help debug in your browser.
  
 +===== The error log =====
 All PHP errors are also written to a log,​regardless of the GSDEBUG setting, check /​path/​to/​getsimple/​**data/​other/​logs/​errorlog.txt** All PHP errors are also written to a log,​regardless of the GSDEBUG setting, check /​path/​to/​getsimple/​**data/​other/​logs/​errorlog.txt**
 +
 +Hint: you can also write your own debug messages to the error log, just use the built-in php function **error_log("​My debug message"​)**.\\ ​
 +Do not forget to remove your error_log() commands when troubleshooting is finished, so as not to constantly fill up the error log!
  
 ===== 500 error in browser ===== ===== 500 error in browser =====
Line 55: Line 59:
  
 ===== How do I know if debug mode is enabled? ===== ===== How do I know if debug mode is enabled? =====
-http://​zegnat.net/​getsimple/​debugmode.png 
  
-When you are logged in to your admin panel it will display a small red notice in the top-right corner. 
  
 +When you are logged in to your admin panel it will display a small red notice in the top-right corner.
  
 +{{:​debug-mode.jpg?​300|}}
 ===== When should I enable debug mode? ===== ===== When should I enable debug mode? =====
 If you want to see PHP errors displayed on the website you will need to enable debug mode. This would apply to you if you are working with PHP, for instance when developing a theme or plugin . If you want to see PHP errors displayed on the website you will need to enable debug mode. This would apply to you if you are working with PHP, for instance when developing a theme or plugin .
Line 67: Line 71:
 ===== Reporting issues in forums, or requesting assistance ===== ===== Reporting issues in forums, or requesting assistance =====
 **DO NOT PRIVATE MESSAGE ADMINISTRATORS FOR ASSISTANCE UNLESS TOLD TO** This is a bannable offense **DO NOT PRIVATE MESSAGE ADMINISTRATORS FOR ASSISTANCE UNLESS TOLD TO** This is a bannable offense
 +
 +GetSimple is an open source and free, volunteer supported application. ​
 +
 +Thanks to an incredible community of knowledgeable folks, forum member-to-member assistance is typically very quick and effective, most problems are solved quickly, provided that users are as respectful and helpful in reporting them. Please keep this in mind when interacting with the community and always help by posting any solutions you find on your own, it will most likely help someone else. Also please submit issues of things you encounter that may be confusing or you had trouble understanding so they can be addressed in future versions.
 +
 +You may want to read this entire page(scroll to top) as it describes specific steps to troubleshoot common issues.
 +
 +Check Health Check
 +[[http://​get-simple.info/​wiki/​how_to:​support#​website_health_check]]
  
 Post your issue in the appropriate forum. Post your issue in the appropriate forum.
Line 75: Line 88:
  
 If you see a filename in the error that is in the plugins folder, report the issue to the specific support thread for THAT PLUGIN if you can determine, it is likely a plugin error and possibly known issue and you will receive much better support, otherwise post in the general questions/ problems thread. If you see a filename in the error that is in the plugins folder, report the issue to the specific support thread for THAT PLUGIN if you can determine, it is likely a plugin error and possibly known issue and you will receive much better support, otherwise post in the general questions/ problems thread.
 +
 +It is also useful to check your hosts error logs, as they will show configuration issues and causes of 500 errors and 403 errors, which are sometimes causes by security blocking software on your host.
  
 Mark your post with issue or question depending on the nature of the issue. Mark your post with issue or question depending on the nature of the issue.
Line 80: Line 95:
 Always post Always post
  
 +  * Version of PHP
   * Your platform, windows etc.   * Your platform, windows etc.
   * If your host is a special one, free or cloud based or lamp/wamp   * If your host is a special one, free or cloud based or lamp/wamp
Line 89: Line 105:
   * Post information on your setup, how many pages, plugins installed, special languages?   * Post information on your setup, how many pages, plugins installed, special languages?
   * Did it work before, is this sudden, is this new, did you do anything?   * Did it work before, is this sudden, is this new, did you do anything?
 +  * Save everyone'​s time by doing due diligence to solve issues on your own, search the wiki and search the forum for same issue, everyone here is a volunteer, no-one owes you anything, nor will you get much help you if your post consists of "it does not work" or "is broken"​ 
 +  * screenshots are welcome, especially if english is not your primary language, or your issue is difficult to explain.
debugging.1413294604.txt.gz · Last modified: 2014/10/14 13:50 by shawn_a