The document is a presentation on troubleshooting Joomla problems. It discusses the troubleshooting process, the different types of Joomla extensions and how they work together, 10 common errors and questions encountered and their solutions, and some useful troubleshooting tools. The presentation provides an overview of troubleshooting techniques and addresses issues such as blank pages, deprecated errors, missing classes, changes not working, 404 errors, login issues, installation problems, how to remove certain site elements, slow site performance, and hacked sites.
Call Girls in Kalyan Vihar Delhi 💯 Call Us 🔝8264348440🔝
JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in Joomla
1. Have you tried turning it
OFF and ON again?
Troubleshooting Joomla!
problems
Peter Martin, twitter: @pe7er
Joomla User Group Utrecht, 9 december 2013
2. Peter Martin
●
●
Joomla website specialist
Marketing + Communicatie
achtergrond & technische affiniteit
●
Vrijwilliger Joomla:
●
Community Leadership Team
Interesses:
●
●
Global Moderator
●
Nijmegen, vrouw, dochter 6, zoon
1,5
Open Source Software
Linux sinds 2007
(Ubuntu → Debian → Arch Linux
→ Debian)
●
Raspberry Pi
●
Open Coffee Nijmegen
●
Muziek (Vinyl)
●
Linux User Group Nijmegen
●
Filmhuisfilms
Website: www.db8.nl – e-mail: peter@db8.nl
LinkedIn: http://www.linkedin.com/in/pe7er – Twitter: @pe7er
3. 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 <<<
9. b) Troubleshooting process
ISP
Domain Name System
Parameters
Wide Area Network
Access Control List (ACL)
.htaccess Server overrides
Firewall
Joomla extensions
Local Area Network
Joomla files
Virusscanner
Joomla database
Browser addons
Browser
Operating System (OS)
Keyboard
User
3rd party extensions
Chair
File/folder permissions
Server with website
Computer of website visitor
Modem/Router
Loadbalancer
MySQL database server
PHP (version!)
Webserver
Operating System (OS)
10. 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!
12. c) Extensions – 5 types
Extending Joomla's functionality:
1. Components
2. Modules
3. Plugins
4. Templates
5. Language
Files
13. c) Extensions – Component
●
Determines functionality of a page
●
●
●
Multiple “Modi”: CRUD (Create, Read, Update, Delete)
Only one component on a page
Activation
●
●
via URL + &option=com_componentname
Example
●
com_content
14. c) Extensions – Module
●
Supportive, “Widget”, only display to screen (“Module Positie”)
●
●
●
One mode (e.g. Read from database & Display)
Multiple modules on a page
Activation
●
●
via menu item: URL + &Itemid=x
Example
●
mod_breadcrumbs
15. c) Extensions – Plugin
●
Supportive. Works invisible in background.
●
●
●
One mode: does one thing (e.g. search & replace)
Multiple plugins at a time
Activation
●
●
via certain “events” (of “hooks”) in components
Example Plugin
●
Content - Email Cloaking
16. c) Extensions – Template
●
Supportive. Does layout of website
●
●
●
One mode (Display HTML with CSS & “Elements”)
One template on a page, multiple possible
Activation
●
●
Default and assigned ones in parameter Menu Item
Example
●
Joomla 3.x default template “Protostar”
17. c) Extensions – Language Files
●
Supportive. Translation for “system labels”
●
●
●
One language at a time (on a page)
Multiple possible→multilanguage website
Activation
●
●
Default & Language Overrides in database
Example
/language/en-GB/en-GB.ini
18. c) Extensions – Working together
Joomla's search
functionality
●
Search inputbox
P Search in
database table
Component (C)
●
●
●
M Form
Module (M)
●
●
C Form
Form
Results
C Processing
P Search in
database table
Plugin (P)
●
Articles
●
Categories
●
Contacts
P Search in
database table
C Results
21. 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
25. 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_exmenuj15/exmenu/exmenu.class.php on line 56
Deprecated: Function split() is deprecated in
/var/www/libraries/phpmailer/phpmailer.php on line 470
27. 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
29. 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
30. I am the head of IT
and I have it on
good authority that
if you type "Google" into Google,
you can break the Internet.
31. 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
33. 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?
37. 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
●
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
38. What does
IT stand for?
What does it stand for?....
What doesn't it stand for?
39. 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;
}
41. 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
45. 7. Error: “Can't install”
●
Cannot install any templates, plugins, modules or components
●
Cannot install extensions on Joomla! 2.5
●
Help - Can't install extensions, JFolder::files: Path is not a
folder.
●
JInstaller::install: Failed to copy file
●
Unable to Find Install Package
●
Cannot install XYZ in Joomla on Hosting ZYX
●
Joomla cannot install; JSON issue
●
JInstaller::Install: Cannot find Joomla XML setup file
●
Can't install extensions
46.
47. 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)
●
●
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”?
49. 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?
50.
51. 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)
53. 9. Error: “Website slow”
●
Why is my website so slow to load?
●
Slow website! Is it my hosting?
●
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
55. 9. Solution “Website slow”
●
Analyse database queries
●
●
Analyze loading time
●
●
Use Joomla's debug mode & check queries
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
57. 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
●
Joomla site hacked
●
Several sites compromised
●
My site has been hacjed! please help
●
Webhost malware scan deletes some files
●
Got Hacked
58. Dear Sir stroke Madam
Fire, exclamation mark
Fire, exclamation mark
Help me, exclamation mark
59. 10. Solution “Site got hacked”
●
Do you have a back-up?
●
Find the cause
●
●
Analyze server log files
●
Search for similar hacks on shared hosting neighbors
●
Outdated Joomla & extensions version?
●
●
Did you keep all software up-to-date?
Weird files in /images/ ?
SSH access?
●
●
●
Search recent modified files
Search for “eval(base64_decode”
http://docs.joomla.org/Security_Checklist
●
You have been hacked or defaced
61. 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
62. e) Tools 2/3
Server
●
Webserver access & error logfiles
●
PHP error logfile
●
.htaccess
Database
●
phpMyAdmin
●
GUI based SQL navigator (Sequel Pro)
Code (PHP, HTML, Language strings)
●
IDE (e.g. NetBeans, Eclipse, FireStorm)
63. e) Tools 3/3
HTML Output
●
Inspect HTML / CSS
●
Google Chrome → Inspect Element
●
FireFox + Firebug Addon
●
Web Developer Addon (Chrome + FireFox)
●
Yslow (Browser Addon)
Database
●
Akeeba Backup
●
XAMPP
●
diff (GUI: Meld, WinMerge)