Admin:Troubleshooting

How do I connect to the wiki ?

Current Release 1.0.3 | e107.org | Download | Changelog | Forum | Plugins | Themes | RSS Feed of Latest Changes | Atom Feed of Latest Changes

Administrator : Troubleshooting your site

Main page > I : First Aid > II : Development > III : Administration > IV : How To's > V : Plugin Writing > VI : Theming & Shortcodes

Contents 1 Troubleshooting Topics 1.1 Banner-related problems 1.2 Image-related problems 1.3 Blank Screen problems 1.4 Database Related problems 1.5 File Upload problems 1.6 'Returned to Index Page' problems 1.7 Server Memory Allocation/Usage Issues 1.8 Problems sending emails 1.9 RSS related problems 1.10 PDF Generation problems 1.11 Login/logout problems 1.12 Other notes 2 Further Debugging Tests 2.1 Browsers & Local Caches 2.2 e107 Cache 2.3 e107 File Inspector 2.4 e107 Database Check 2.5 Apply Jayya as Admin Theme 2.6 Plugins and Custom Menus 2.7 Themes 2.8 Customised e107 Files 2.9 Search For Similar Issues 2.10 Report in the appropriate forum

Troubleshooting Topics

This page is intended to complement the more general troubleshooting pages, detailing less common problems and possible fixes.

Some of the likely problems and fixes may fit in more than one category, so its worth checking the whole of this page.

Its also worth checking the more general pages: post-install troubleshooting page and Post-install problems

Banner-related problems

Many problems with Firefox and banners (in the widest sense) relate to the use of AdBlocker in Firefox - it refuses to display things or to do certain things based on the presence of the word 'banner' in a URL. (The same problem can occur with other words). In most cases something works with other browsers, but not Firefox.

Image-related problems

Symptom	Possible cause	Likely fix
Icons don't display on site	Image 'hotlinking' (or 'leeching') blocked	Modify your .htaccess file to allow display of icons
Images don't resize on upload Thumbnails not created	Not enough memory for resizing program	Increase memory_limit in php.ini (your host may have to do this) from its typical default of 8M or 16M (Note: Problem may only occur with high resolution images - larger than about 640 x 480 pixels)

Blank Screen problems

Symptom	Possible cause	Likely fix
General	Flood protection triggered	Investigate cause; occasionally may be corrupt database
General	IP Address banned	Investigate cause; delete IP address from banlist if valid
Security	Access Denied Warnings	See the FAQ. Some older plugins do not support the e_Token system.

Database Related problems

Symptom	Possible cause	Likely fix
Error when updating user settings: "Column count doesn't match value count..."	Extra fields in user database table	Probably user database table modified by non-core plugin or custom code. Run database validator to identify the extra field(s) and delete it. Use extended user fields for extra user-related fields
User settings won't update	Extra database fields as previous line	As previous line

File Upload problems

Symptom	Possible cause	Likely fix
Uploads don't complete	PHP timing out	Increase the maximum execution time specified in php.ini (may need your host to do it). Usual default is max_execution_time = 30 or 60 seconds
'File too big' message	Filesize limit too low	First, check the maximum upload file size set in the admin options. If this is large enough, modify the php settings in php.ini for upload_max_filesize (typically 2M) and post_max_size (typically8M) need increasing - your host may have to do this
Uploads don't complete - "Cannot find server" / "Page Cannot Be Displayed" error	Server setup problem	make sure the httpd.conf LimitRequestBody setting is high enough to accommodate the size of the desired upload.
Changing Upload Sizes	Filesize limit too low	There is a trick that you can do to correct this error. Open Notepad and type: php_value upload_max_filesize 1024M      Replace the values i have with php_value post_max_size 1024M             the value you want left!! 1024M php_value max_execution_time 200        equals 1 gigabyte (This is Huge)! php_value max_input_time 200 After you replace the values and put the value you want, 1024M or any other size, then save as .htaccess in the root Directory and everything will work.

'Returned to Index Page' problems

Symptom	Possible cause	Likely fix
On attempting to sign up	Flood protection triggered	Investigate cause; probably too many users attempting to sign up in rapid succession. Occasionally may be corrupt database

Server Memory Allocation/Usage Issues

You may get an error such as: Fatal error: Allowed memory size of X bytes exhausted...

• See: How can I solve Fatal error: Allowed memory size of X bytes exhausted (tried to allocate Y bytes)?

Problems sending emails

Always upgrade to the latest version if these occur - a lot of work has been done in this area. Note that some free hosts restrict the sending of emails. Try the various options for email sending - smtp (preferred), php and sendmail. Support for pop before smtp email sending is added in version 0.7.6

Symptom	Possible cause	Likely fix
'Error 500 - Malformed header' when trying to send mail	.htaccess file causing problems.	Delete (or modify) the .htaccess file in the e107_handlers/phpmailer subdirectory

RSS related problems

The most common problem is an 'error in feed' message when trying to view one of the fields. This is caused by characters before the opening '<?php' or after the closing '?>' in certain files. First place to look is the e_module.php, e_rss.php and e_meta.php files in each plugin directory. (Non-core plugins are more likely to have this problem).

In e107 version 0.7.8 on, the 'plugin scanner' also checks all these e_xxx.php files, and highlights those with extra white space.

Within the e107 core, the problem is most likely caused by surplus white space in the e107_config.php file (as the one which is sometimes hand edited), although potentially it can occur in other files as well.

PDF Generation problems

The most common error is "FPDF error: Some data has already been output". As for RSS feed problems, this is often caused by surplus white space in files. If all is well with the RSS feeds (assuming you are using RSS) the theme files are a good place to start.

• See fpdf.org

Login/logout problems

You probably have a corrupt cookie.

1. Close the browser
2. delete all the cookies
3. Reopen the browser
4. sign in
5. try to signout again.

Note that you should set your own cookie name in security and protection preferences when you setup e107.

Solution submitted by trickdog http://e107.org/e107_plugins/forum/forum_viewtopic.php?7041

Other notes

• Dependent on the theme, you may see either a blank screen or a partial display when a problem occurs
• The wrong use of (") instead of (') in the theme.php
• Norton antivirus, has been found to cause problems with viewing parts of the site. Especially popups and banners, which get blocked by adblocker.
• If some admin functions are not accessible, its probably one or more corrupted language files.
• Language files must not have anything in the file prior to the '<?php' (This includes the BOM - Byte Order Marker - which is not visible in many editors, and may be added transparently).
• If image preloading is enabled for the current theme, non-image files in the image directory can cause obscure problems, crashes etc
• In versions up to 0.7.5 there was a potential conflict with the {EXTENDED} shortcode, which was used in both news and users. In 0.7.6 this has been changed to {USER_EXTENDED} for the user code. Typically this resulted in one or more extended user fields not being displayed in the user's profile.
• Review FAQ I can see the text SANITISED on my pages.

Further Debugging Tests

Before you start these checks, back-up your database with phpMyAdmin and Backup Your e107 File System via FTP them down to your local machine.

Retest your issue each time with the following conditions.

Browsers & Local Caches

Clear browser cookies/browser local cache (or Temp Internet Files) on your browser or better still try it on another browser.

Retest.

e107 Cache

Clear and Disable the e107 Cache System.

Admin -> Settings -> Cache

Retest.

e107 File Inspector

Remember to BACK-UP first!

Check Files are OK, using Admin -> Tools -> File Inspector.

Look for any Error files, with red X icon. Look for any php files which you have not put in the system.

Retest.

e107 Database Check

Remember to BACK-UP first!

Check e107 Database is OK, using Admin -> Tools -> Database - Check Database Validity.

Look for any database errors, select and attempt to fix.

Retest.

Apply Jayya as Admin Theme

Retest.

Plugins and Custom Menus

Remember to BACK-UP first!

Temporarily disable any custom menu's via Admin Area > Content > Menus.

If it works after this, sequentially re-enable the menus or plugins.

Retest.

Themes

Apply a site theme which came as standard with e107 - such as e107v4.

If it works after this, then we know there may be an issue with the site theme.

Retest.

Customised e107 Files

Remember to BACK-UP first!

Confirm no files where changed from e107 standard.

Comment out any changes, but ideally replace edited files with originals provided by e107. Avoid editing core files, this will help you at upgrade - the best way to extend e107 is through Plugins, Shortcodes or templates.

Retest.

Search For Similar Issues

Search e107 Forum

Report in the appropriate forum

When you report a problem, ensure you quote at very least :-

• e107 release number e.g. 1.0.3
• PHP Version
• MySQL Version

Ideally copy this from the left column of your Admin Area...

e107

Version 0.7.24 rc2

Site Theme

sebes

Admin Theme

Jayya v1.0

Install date

Sunday 13 December 2003 - 16:44:20

Current Server Time

Sun, 19 Sep 2010 15:40:54 -0400

Server

Apache/2.x.x (Unix) mod_ssl/2.x.x OpenSSL/0.x.x Blah blah

(host: hidethis.co.uk)

PHP Version

5.2.10

MySQL

5.0.89-community

Database: HIDE THIS

Charset

utf-8

How to add an article to the handbook