Have you tried turning it
OFF and ON again?
Troubleshooting Joomla!
problems

Peter Martin, twitter: @pe7er
Joomla User Gr...
Peter Martin
●

●

Joomla website specialist
Marketing + Communicatie
achtergrond & technische affiniteit

●

Vrijwilliger...
Overview Presentation
a) Introduction
b) Troubleshooting process
c) Extensions – in short
d) Ten common errors and questio...
1. Extensions, an introduction
1. Extensions, an introduction
b) Troubleshooting process
b) Troubleshooting process
ISP

Domain Name System

Parameters

Wide Area Network

Access Control List (ACL)
.htaccess Ser...
b) Troubleshooting process
1. Make a backup first! (eg Akeeba)
2. Know difference between Components, Modules, Plugins,
Te...
c) Extensions – in short
c) Extensions – 5 types
Extending Joomla's functionality:
1. Components
2. Modules
3. Plugins
4. Templates
5. Language
Fil...
c) Extensions – Component
●

Determines functionality of a page
●

●

●

Multiple “Modi”: CRUD (Create, Read, Update, Dele...
c) Extensions – Module
●

Supportive, “Widget”, only display to screen (“Module Positie”)
●

●

●

One mode (e.g. Read fro...
c) Extensions – Plugin
●

Supportive. Works invisible in background.
●

●

●

One mode: does one thing (e.g. search & repl...
c) Extensions – Template
●

Supportive. Does layout of website
●

●

●

One mode (Display HTML with CSS & “Elements”)
One ...
c) Extensions – Language Files
●

Supportive. Translation for “system labels”
●

●

●

One language at a time (on a page)
...
c) Extensions – Working together
Joomla's search
functionality
●

Search inputbox

P Search in
database table

Component (...
d) 10 Common Errors & Questions
1. Blank Page
1. Error: “Blank Page”
●

●

After Upgrade - blank page in the front and backend!
Getting blank page when enabling the Sea...
Have you tried
turning it off
and on again?
1. Solution “Blank Page”
Blank page = PHP error & display errors = OFF
1. Joomla admin: System > Global Configuration > [S...
2. Deprecated
2. Error: “Deprecated”
●

●

●

●

Deprecated: Function eregi() is deprecated in
/home/public_html/includes/sef.php on lin...
I'm sorry,
are you from
the past?
2. Solution “Deprecated”
Error → Warning: “Some PHP function will not be available
anymore in next PHP version”
1. Get it ...
3. Missing Class
3. Error: “Missing Class”
●

●

●

●

●

Fatal error: Class 'JConfig' not found in
/var/www/includes/framework.php on line...
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.
3. Solution “Missing Class”
1. Google the error
●

Not too specific!

●

Remove “unique text” like your own folder structu...
4. Change did not work
4. Error: “Change did not work”
●

I changed x but does not work

●

Start Publishing does not work at all

●

Show Title ...
Memory is RAM!
4. Solution “Change did not work”
1. Refresh (“hard refresh”: CTRL + F5)
2. Check with other browser
3. Empty browser cach...
5. 404
5. Error: “Links give 404 error”
●

Menus don't work

●

Site does not work after move to other server

●

404 error for a...
What does
IT stand for?

What does it stand for?....
What doesn't it stand for?
5. Solution “Links give 404 error”
SEF = Search Engine Friendly
1. Apache:
rename htaccess.txt to .htaccess
2. Microsoft I...
6. Can't login
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'...
Hello
Hello Computer

Hello
6. Solution “Can't login”
●

Use phpMyAdmin
●

●

●

●

Reset password: new password + “Function” MD5,
after login → User ...
7. Can't install
7. Error: “Can't install”
●

Cannot install any templates, plugins, modules or components

●

Cannot install extensions on...
7. Solution “Can't install”
●

With specific Extension or all Extensions?

●

Extension right Joomla version?

●

Check Pe...
8. How to remove?
8. Question: “How to remove XYZ”
●

Changing the background color?

●

How can I Remove the "Powered by XYZ"?

●

How to c...
8. Solution “How to remove XYZ”
●

Analyze HTML/CSS with browser
●

Google Chrome or FireFox + addons:
–
–

●

Web Develop...
9. The Need for Speed
9. Error: “Website slow”
●

Why is my website so slow to load?

●

Slow website! Is it my hosting?

●

Website loading to ...
Have you tried
forcing
an unexpected
reboot?
9. Solution “Website slow”
●

Analyse database queries
●

●

Analyze loading time
●

●

Use Joomla's debug mode & check qu...
10. S1t3 G0t H@ck3d!
10. Error: “Site got hacked”
●

Unwanted Advertiser Pop-up appearing on admin front end.

●

I got hacked.... Cant reset s...
Dear Sir stroke Madam

Fire, exclamation mark
Fire, exclamation mark
Help me, exclamation mark
10. Solution “Site got hacked”
●

Do you have a back-up?

●

Find the cause
●

●

Analyze server log files

●

Search for ...
e) Tools
e) Tools 1/3
Joomla
●

Other Joomla site with example installation

●

Joomla Debug mode

●

Joomla SEF OFF -> full URL wi...
e) Tools 2/3
Server
●

Webserver access & error logfiles

●

PHP error logfile

●

.htaccess
Database

●

phpMyAdmin

●

G...
e) Tools 3/3
HTML Output
●

Inspect HTML / CSS
●

Google Chrome → Inspect Element

●

FireFox + Firebug Addon

●

Web Deve...
The
Questions?
●

Presentation available at www.db8.nl

Peter Martin
e-mail: info at db8.nl
website: www.db8.nl
twitter: @pe7e...
Used Photos 1/2
●

IT Crowd © 2006-2010, Produced by Talkback Thames for Channel 4 Television
Corporation.

●

IT Crowd ph...
Used Photos 2/2
●

Doodled desks 2 - "igoghost" http://www.sxc.hu/photo/1193228

●

Tree of Change 1 - Kimberly Vohsen htt...
JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in  Joomla
JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in  Joomla
JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in  Joomla
JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in  Joomla
Upcoming SlideShare
Loading in …5
×

JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in Joomla

9,089 views

Published on

Witte schermen, deprecated errors, missing Class errors, kan niet inloggen, kan niet installeren, mijn website is langzaam, mijn website is gehacked...

We hebben allemaal wel eens dergelijke problemen.
Deze presentatie werd op ma 9 december 2013 gegeven bij Joomla User Group Utrecht en leert je:
* identificeren van een probleem
* identificeren van het achterliggende probleem
* het probleem op te lossen
* of hulp te krijgen door de juiste vragen te stellen
En tijdens het probleem oplossen, leer je tevens iets over Joomla's Debug modus, .htaccess, phpMyAdmin, XAMPP, Akeeba Backup, Admin Tools, Google Chrome Inspect Element, FireFox Firebug, diff...

Published in: Self Improvement
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
9,089
On SlideShare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
5
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

JUG Utrecht 2013 - Have you tried turning it off and on again? Problemen oplossen in Joomla

  1. 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. 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. 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 <<<
  4. 4. 1. Extensions, an introduction
  5. 5. 1. Extensions, an introduction
  6. 6. b) Troubleshooting process
  7. 7. 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)
  8. 8. 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!
  9. 9. c) Extensions – in short
  10. 10. c) Extensions – 5 types Extending Joomla's functionality: 1. Components 2. Modules 3. Plugins 4. Templates 5. Language Files
  11. 11. 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
  12. 12. 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
  13. 13. 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
  14. 14. 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”
  15. 15. 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
  16. 16. 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
  17. 17. d) 10 Common Errors & Questions
  18. 18. 1. Blank Page
  19. 19. 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
  20. 20. Have you tried turning it off and on again?
  21. 21. 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
  22. 22. 2. Deprecated
  23. 23. 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
  24. 24. I'm sorry, are you from the past?
  25. 25. 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
  26. 26. 3. Missing Class
  27. 27. 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
  28. 28. 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.
  29. 29. 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
  30. 30. 4. Change did not work
  31. 31. 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?
  32. 32. Memory is RAM!
  33. 33. 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
  34. 34. 5. 404
  35. 35. 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
  36. 36. What does IT stand for? What does it stand for?.... What doesn't it stand for?
  37. 37. 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; }
  38. 38. 6. Can't login
  39. 39. 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
  40. 40. Hello Hello Computer Hello
  41. 41. 6. Solution “Can't login” ● Use phpMyAdmin ● ● ● ● Reset password: new password + “Function” MD5, after login → User Manager, New password! add new Super Admin + password, see: http://docs.joomla.org/How_do_you_recover_or_reset_your_ admin_password%3F check plugins in #__extensions: plg_user_Joomla → enabled = 1 ? plg_authentication_joomla → enabled = 1 ? Security extension? → ?token-after-url
  42. 42. 7. Can't install
  43. 43. 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
  44. 44. 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”?
  45. 45. 8. How to remove?
  46. 46. 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?
  47. 47. 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)
  48. 48. 9. The Need for Speed
  49. 49. 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
  50. 50. Have you tried forcing an unexpected reboot?
  51. 51. 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
  52. 52. 10. S1t3 G0t H@ck3d!
  53. 53. 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
  54. 54. Dear Sir stroke Madam Fire, exclamation mark Fire, exclamation mark Help me, exclamation mark
  55. 55. 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
  56. 56. e) Tools
  57. 57. 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
  58. 58. 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)
  59. 59. 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)
  60. 60. The
  61. 61. Questions? ● Presentation available at www.db8.nl Peter Martin e-mail: info at db8.nl website: www.db8.nl twitter: @pe7er
  62. 62. Used Photos 1/2 ● IT Crowd © 2006-2010, Produced by Talkback Thames for Channel 4 Television Corporation. ● IT Crowd photos: http://spoilertv.co.uk ● power button - "gerard79" http://www.sxc.hu/photo/1009485 ● Old Polish TV - Konrado Fedorczyko http://www.sxc.hu/photo/1187553 ● Discarded - Therese Branton http://www.sxc.hu/photo/705372 ● chains - Pablo Herrera http://www.sxc.hu/photo/1381655 ● Motherboard 4 - Lisa Zanchi http://www.sxc.hu/photo/103914 ● note paper - ilker http://www.sxc.hu/photo/1266532 ● Roadside Assistance Required - jamie brelsford http://www.sxc.hu/photo/603001
  63. 63. Used Photos 2/2 ● Doodled desks 2 - "igoghost" http://www.sxc.hu/photo/1193228 ● Tree of Change 1 - Kimberly Vohsen http://www.sxc.hu/photo/1077609 ● _error - Alexandre Galant http://www.sxc.hu/photo/682383 ● Lock - Robert Linder http://www.sxc.hu/photo/1395379 ● tap joint - Asif Akbar http://www.sxc.hu/photo/864387 ● claws - esra su http://www.sxc.hu/photo/206896 ● Speedometer – Abdulhamid AlFadhly http://www.sxc.hu/photo/1390189 ● Crowbar - Richard Dudley http://www.sxc.hu/photo/854266 ● Tools - J Boontje http://www.sxc.hu/photo/805571 ● signs signs - Jason Antony http://www.sxc.hu/photo/751034 ● Face - Questions - Bob Smith http://www.sxc.hu/photo/418215

×