Blank screens, deprecated errors, missing Class errors, can't login, can't install, my website is slow, my website got hacked... We all have run into one or two of those. If not, other people have... If you don't believe me, just visit http://forum.joomla.org/ :-)
On the basis of the 10 most common problems seen in Joomla Forum, Peter will learn you to:
* identify a problem
* identify the real problem behind it
* solve that problem
* or get help quickly by asking the right questions
In the process you might learn something more about Joomla's Debug mode, .htaccess, phpMyAdmin, permissions, XAMPP, Akeeba Backup, Admin Tools, Google Chrome Inspect Element, FireFox Firebug, diff...
1. Troubleshooting
Joomla! Problems
(Have you tried turning it
OFF and ON again?)
Peter Martin, www.db8.nl. twitter: @pe7er
Joomladay.de – 12+13 september 2014
2. Overview Presentation
a)Introduction
b)Troubleshooting process
c)Extensions – in short
d)Ten common errors and questions
e)Some useful tools
f) Questions?
>>> Sheets via: www.db8.nl <<<
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
3. 1. Extensions, an introduction
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
4. 1. Extensions, an introduction
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
8. b) Troubleshooting process
Parameters
Access Control List (ACL)
.htaccess Server overrides
3rd party extensions
Joomla extensions
Joomla files
Loadbalancer
MySQL database server
PHP (version!)
Webserver
Domain Name System
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
Firewall
Local Area Network
Virusscanner
Browser addons
Operating System (OS)
Operating System (OS)
Browser
Wide Area Network
Modem/Router
Joomla database
Server with website
Computer of website visitor
ISP
User
Keyboard
Chair
File/folder permissions
9. b) Troubleshooting process
1. Make a backup first! (eg Akeeba)
2. Know difference between Components, Modules, Plugins,
Templates & Language files
3. Find the cause of the error:
● Reproduce the error with different parameters
● Change one parameter at a time & then test.
● Check all different “chains” & vary them “extremely”
4. Ask for help:
● Ask the right question in right forum & right subject title
● Give sufficient information, be concise & bullet lists
5. Be “Open Source” & report back!
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
10. c) Extensions – in short
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
11. c) Extensions – 5 types
Extending Joomla's functionality:
1.Components
2.Modules
3.Plugins
4.Templates
5. Language
Files
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
12. c) Extensions – Component
● Determines functionality of a page
– Multiple “Modi”: CRUD (Create, Read, Update, Delete)
– Only one component on a page
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Activation
– via URL + &option=com_componentname
● Example
– com_content
13. c) Extensions – Module
● Supportive, “Widget”, only display to screen (“Module Positie”)
– One mode (e.g. Read from database & Display)
– Multiple modules on a page
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Activation
– via menu item: URL + &Itemid=x
● Example
– mod_breadcrumbs
14. c) Extensions – Plugin
● Supportive. Works invisible in background.
– One mode: does one thing (e.g. search & replace)
– Multiple plugins at a time
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Activation
– via certain “events” (of “hooks”) in components
● Example Plugin
– Content - Email Cloaking
15. c) Extensions – Template
● Supportive. Does layout of website
– One mode (Display HTML with CSS & “Elements”)
– One template on a page, multiple possible
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Activation
– Default and assigned ones in parameter Menu Item
● Example
– Joomla 3.x default template “Protostar”
16. c) Extensions – Language Files
● Supportive. Translation for “system labels”
– One language at a time (on a page)
– Multiple possible→multilanguage website
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Activation
– Default & Language Overrides in database
● Example
/language/en-GB/en-GB.ini
17. c) Extensions – Working together
Joomla's search
functionality
C Processing
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Module (M)
– Search inputbox
● Component (C)
– Form
– Results
● Plugin (P)
– Articles
– Categories
– Contacts
C Form
C Results
M Form
P Search in
database table
P Search in
database table
P Search in
database table
18. d) 10 Common Errors & Questions
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
20. 1. Error: “Blank Page”
● After Upgrade - blank page in the front and backend!
● Getting blank page when enabling the Search Engine
Friendly
● Why my site is blank page after moving to other server?
● Searching returns blank page!
● Blank page after admin login
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
21. Have you tried
turning it off
and on again?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
22. 1. Solution “Blank Page”
Blank page = PHP error & display errors = OFF
1. Joomla admin: System > Global Configuration > [Server]
> Error Reporting: Maximum
2. Increase PHP error level:
.htaccess
php_flag display_errors on
php_value error_reporting -1
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
24. 2. Error: “Deprecated”
● Deprecated: Function eregi() is deprecated in
/home/public_html/includes/sef.php on line 393
● Deprecated: Function set_magic_quotes_runtime() is
deprecated in /var/www/libraries/phpmailer/phpmailer.php
on line 1218
● Deprecated: Assigning the return value of new by reference
is deprecated in
/var/www/modules/mod_exmenu-j15/exmenu/exmenu.class.
php on line 56
● Deprecated: Function split() is deprecated in
/var/www/libraries/phpmailer/phpmailer.php on line 470
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
25. I'm sorry,
are you from
the past?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
26. 2. Solution “Deprecated”
Error → Warning: “Some PHP function will not be
available anymore in next PHP version”
1.Get it fixed!
● Joomla?
Report in bugtracker
● 3rd party extension?
Contact developer with warning message
2.Hide warning
● In php.ini:
error_reporting = E_ALL & ~E_DEPRECATED
● In .htaccess:
php_flag display_errors off
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
27. 3. Missing Class
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
28. 3. Error: “Missing Class”
● Fatal error: Class 'JConfig' not found in
/var/www/includes/framework.php on line 56
● Fatal error: Class 'XMLReader' not found in
/libraries/cms/feed/factory.php on line 69
● Fatal error: Class 'ModMenuHelper' not found in
/joomla/administrator/modules/mod_menu/
tmpl/default_enabled.php on line 173
● Fatal error: Class 'JError' not found in
/public_html/includes/framework.php on line 42
● Fatal error: Class 'JMailHelper' not found
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
30. 3. Solution “Missing Class”
1.Google the error
● Not too specific!
● Remove “unique text” like your own folder structure
2.Re-upload files
● get original Joomla full package from same version
● upload all files overwriting the ones on the server
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
31. 4. Change did not work
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
32. 4. Error: “Change did not work”
● I changed x but does not work
● Start Publishing does not work at all
● Show Title does not work
● Article changes not visible in front end
● Main menu not showing on Multilingual website
● Articles option not working in Joomla 2.5
● Articles not showing...!? How could this be?
● My site description not showing on google
● Images not visible in Category Blog
● Submenu items not visible anymore in J3.1.1?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
33. Memory is RAM!
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
34. 4. Solution “Change did not work”
1.Refresh (“hard refresh”: CTRL + F5)
2.Check with other browser
3.Empty browser cache
4.Empty Joomla's cache
5. Disable hosting server cache → via .htaccess
6.Switch off SEF URLs
7.Change parameters with “extreme” numbers
8.Check Template Overrides
9.Check Template for hardcoded stuff
10.Check ACL, Language etc
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
36. 5. Error: “Links give 404 error”
● Menus don't work
● Site does not work after move to other server
● 404 error for all article/site links
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● 404 Error on All Links
● MAIN MENU 404 ERROR
● please help!!!! menu items give 404 error
● Menu item no longer working - returns with 404 error
● 404 errors on all links, front page of joomla fine
● Strange URL's in Joomla 2.5.9 URGENT HELP
● URGENT help error 404
37. What does
IT stand for?
What does it stand for?....
What doesn't it stand for?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
38. 5. Solution “Links give 404 error”
SEF = Search Engine Friendly
1.Apache:
rename htaccess.txt to .htaccess
2.Microsoft IIS7:
rename web.config.txt to web.config
3.Nginx:
put in virtual domain block:
location / {
index index.php index.html index.htm;
try_files $uri $uri/ /index.php?q=$request_uri;
}
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
40. 6. Error: “Can't login”
● I can't login to my admin panel
● Site Hacked and now locked out of admin
● Joomla 2.5 can't login to Admin or Site
● Cannot log in into /administrator back-end
● Can't login admin or user.
● Cannot Access Administration Page
● Cannot login to backend
● After move of site cannot login, loop
● Locked out of the Admin
● Super User Locked Out of Joomla 2.5
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
46. 7. Solution “Can't install”
● With specific Extension or all Extensions?
● Extension right Joomla version?
● Check Permissions
– Files 644, Folders 755
– System > System Information > Directory Permissions
● Check Ownership (FTP user vs Webserver)
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
– With FTP
● Check PHP File Upload & Upload Size
– file_uploads = ON, upload_max_filesize = e.g. 10M
● Check Disk Space
● Unzip in /tmp/ folder & “Install from Directory”?
47. 8. How to remove?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
48. 8. Question: “How to remove XYZ”
● Changing the background color?
● How can I Remove the "Powered by XYZ"?
● How to change the colour of the article title text?
● Change logo?
● Beez3 header change?
● Possibility to change text color in article?
● Logo change position?
● Change module position beez20?
● Change H3 to another header in moduletable:
● Remove copyright info at the bottom?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
50. 8. Solution “How to remove XYZ”
● Analyze HTML/CSS with browser
– Google Chrome or FireFox + addons:
● Web Developer
● FireBug (or Google Chrome's Inspector)
● Module? Display Module Positions:
– Extensions > Template Manager > Preview Module Positions:
enabled
– URL + ?tp=1
● Template? Change template as test
● Plugin? Disable plugin as test
● Component or Module? HTML override?
● IDE (Netbeans, Eclipse, Firestorm)
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
51. 9. The Need for Speed
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
52. 9. Error: “Website slow”
● Why is my website so slow to load?
● Slow website! Is it my hosting?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Website loading to slow
● Changes to web page slow to load
● My website is loading extremely slow
● Slow queries on large website
● Slow loading website (unstable performance)
● Very slow page loading (Waiting on fonts.googleapis.com)
● Trying to increase the speed of my website
● It's too slow
53. Have you tried
forcing
an unexpected
reboot?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
54. 9. Solution “Website slow”
● Analyse database queries
– Use Joomla's debug mode & check queries
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Analyze loading time
– Use Yslow (FireFox / Chrome browser addon)
analyse loading of website
● Compare with other hosting
– Backup (with Akeeba)
– Local webserver op PC (with XAMPP)
– Restore backup on local PC, test speed & compare
56. 10. Error: “Site got hacked”
● Unwanted Advertiser Pop-up appearing on admin front end.
● I got hacked.... Cant reset superuser password
● Just got hacked, advice needed
● I just got hacked by xxxx -aarrgghh!
● Website got hacked by insert PHP code in all file
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● Joomla site hacked
● Several sites compromised
● My site has been hacjed! please help
● Webhost malware scan deletes some files
● Got Hacked
57. Dear Sir stroke Madam
Fire, exclamation mark
Fire, exclamation mark
Help me, exclamation mark
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
58. 10. Solution “Site got hacked”
● Do you have a back-up?
● Find the cause
– Did you keep all software up-to-date?
– Analyze server log files
– Search for similar hacks on shared hosting neighbors
– Outdated Joomla & extensions version?
– Weird files in /images/ ?
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
● SSH access?
– Search recent modified files
– Search for “eval(base64_decode”
● http://docs.joomla.org/Security_Checklist
– You have been hacked or defaced
60. JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
e) Tools 1/3
Joomla
● Other Joomla site with example installation
● Joomla Debug mode
● Joomla SEF OFF -> full URL with all commands
● Joomla System Info
● PHP Information
● Directory Permissions (and or use FTP to analyze permissions
& owner/group)
● Admin Tools (3rd party Extension)
● Analyze & fix directory permissions
● Repair & optimize database tables
64. Questions?
● Presentation available at www.db8.nl
JJoooommllaaddaayy DDeeuuttsscchhllaanndd 22001144
Peter Martin
e-mail: info at db8.nl
website: www.db8.nl
twitter: @pe7er