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

problems

Peter Martin, twitter: @pe7er Joomla World Conference, Sat Nov 9th 20 !

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

Peter Martin, twitter: @pe7er Joomla World Conference, Sat Nov 9th 20 !

Overview Presentation
a)Introduction b)Troubleshooting process c)Extensions in short d)Ten common errors and questions e)Some useful tools f) uestions!

>>> Sheets via: www.db8.nl <<<

"# Extensions$ an introduction

"# Extensions$ an introduction

b) Troubleshooting process

b) Troubleshooting process
3omain Name S$%tem Parameter% 0cce%% Control ,i%t &0C,' 6htacce%% Server override% 3rd party extensions Joomla extensions Joomla file% Joomla data(a%e 2ile4folder permi%%ion%

ISP Computer of website visitor

2irewall .ir/%%canner -row%er

Wide 0rea Networ1

Modem45o/ter

,ocal 0rea Networ1

-row%er addon%

Server with website

,oad(alancer M$S+, data(a%e %erver P)P &ver%ion*' We(%erver "peratin# S$%tem &"S'
9

"peratin# S$%tem &"S' 7e$(oard Chair

User

b) Troubleshooting process
"#%a&e a backup first' (eg )&eeba) *#+now difference between ,omponents$ %odules$ Plugins$ Templates - .anguage files /#0ind the cause of the error1

2eproduce the error with different parameters ,hange one parameter at a time - then test# ,hec& all different 3chains4 - var5 them 3extremel54 )s& the right question in right forum - right sub7ect title 8ive sufficient information$ be concise - bullet lists
10

6#)s& for help1

9#:e 3Open Source4 - report back!

c) Extensions in short

11

c) Extensions 9 t5pes
Extending ;oomla<s functionalit51 "#,omponents *#%odules /#Plugins 6#Templates 9#.anguage 0iles

12

c) Extensions ,omponent

=etermines functionalit5 of a page

%ultiple 3%odi41 ,2>= (Create, Read, Update, Delete) Onl5 one component on a page

)ctivation

via >2. ? -option@comAcomponentname

Example

comAcontent

13

c) Extensions %odule

Supportive$ 3Bidget4$ onl5 displa5 to screen (3%odule Positie4)

One mode (e#g# 2ead from database - =ispla5) %ultiple modules on a page

)ctivation

via menu item1 >2. ? -Itemid@x

Example

modAbreadcrumbs

14

c) Extensions Plugin

Supportive# Bor&s invisible in bac&ground#

One mode1 does one thing (e#g# search - replace) %ultiple plugins at a time

)ctivation

via certain 3events4 (of 3hoo&s4) in components

Example Plugin

,ontent C Email ,loa&ing

15

c) Extensions Template

Supportive# =oes la5out of website

One mode (=ispla5 DT%. with ,SS - 3Elements4) One template on a page$ multiple possible

)ctivation

=efault and assigned ones in parameter %enu Item

Example

;oomla /#x default template 3Protostar4

16

c) Extensions .anguage 0iles

Supportive# Translation for 3s5stem labels4

One language at a time (on a page) %ultiple possibleEmultilanguage website

)ctivation

=efault - .anguage Overrides in database

Example FlanguageFenC8:FenC8:#ini

17

c) Extensions Bor&ing together ;oomla<s search

functionalit5 %odule (%)

C 2orm

M 2orm

Search inputbox 0orm 2esults )rticles ,ategories ,ontacts

C 5e%/lt% C Proce%%in# P Search in data(a%e ta(le P Search in data(a%e ta(le P Search in data(a%e ta(le

,omponent (,)

Plugin (P)

18

d) "G ,ommon Errors uestions

19

"# :lan& Page

20

"# Error1 3:lan& Page4

After Upgrade - blank page in the front and backend! Getting blank page when enabling the Search Engine Friendl !h " #ite i# blank page after "o$ing to other #er$er% Searching ret&rn# blank page! 'lank page after ad"in login

21

)ave $o/ tried t/rnin# it off and on a#ain8

22

"# Solution 3:lan& Page4

:lan& page @ PDP error - displa5 errors @ O00 "#;oomla admin1 S5stem H 8lobal ,onfiguration H IServerJ H Error 2eporting1 %aximum *#Increase PDP error level1 .htaccess phpAflag displa5Aerrors on phpAvalue errorAreporting C"
23

*# =eprecated

24

*# Error1 3=eprecated4

Deprecated( F&nction eregi)) i# deprecated in *ho"e*p&blic+ht"l*incl&de#*#ef,php on line -.Deprecated( F&nction #et+"agic+/&ote#+r&nti"e)) i# deprecated in *$ar*www*librarie#*php"ailer*php"ailer,php on line 0102 Deprecated( A##igning the ret&rn $al&e of new b reference i# deprecated in *$ar*www*"od&le#*"od+e3"en&405*e3"en&*e3"en&,cla##,php on line 56 Deprecated( F&nction #plit)) i# deprecated in *$ar*www*librarie#*php"ailer*php"ailer,php on line 789
25

9:m %orr$, are $o/ from the pa%t8

26

*# Solution 3=eprecated4
Error E Barning1 3Some PDP function will not be available an5more in next PDP version4 "#8et it fixed'

;oomla! 2eport in bugtrac&er /rd part5 extension! ,ontact developer with warning message In php#ini1 errorAreporting @ EA).. - KEA=EP2E,)TE= In #htaccess1 phpAflag displa5Aerrors off
27

*#Dide warning

/# %issing ,lass

28

/# Error1 3%issing ,lass4

Fatal error( Cla## :;Config: not fo&nd in *$ar*www*incl&de#*fra"ework,php on line 56 Fatal error( Cla## :<=>Reader: not fo&nd in *librarie#*c"#*feed*factor ,php on line 6. Fatal error( Cla## :=od=en&?elper: not fo&nd in *4oo"la*ad"ini#trator*"od&le#*"od+"en&* t"pl*defa&lt+enabled,php on line 08Fatal error( Cla## :;Error: not fo&nd in *p&blic+ht"l*incl&de#*fra"ework,php on line 71 Fatal error( Cla## :;=ail?elper: not fo&nd
29

9 am the head of 9; and 9 have it on #ood a/thorit$ that

if $o/ t$pe <=oo#le< into =oo#le, $o/ can (rea1 the 9nternet6

30

/# Solution 3%issing ,lass4

1.Google the error

Lot too specific' 2emove 3unique text4 li&e 5our own folder structure get original ;oomla full pac&age from same version upload all files overwriting the ones on the server

2.Re-upload files

31

6# ,hange did not wor&

32

6# Error1 3,hange did not wor&4

@ changed 3 b&t doe# not work Start A&bli#hing doe# not work at all Show Bitle doe# not work Article change# not $i#ible in front end =ain "en& not #howing on =&ltiling&al web#ite Article# option not working in ;oo"la 1,5 Article# not #howing,,,!% ?ow co&ld thi# be% = #ite de#cription not #howing on google @"age# not $i#ible in Categor 'log S&b"en& ite"# not $i#ible an "ore in ;-,0,0%
33

Memor$ i% 50M*

34

6# Solution 3,hange did not wor&4 "#2efresh (3hard refresh41 ,T2. ? 09)
*#,hec& with other browser /#Empt5 browser cache 6#Empt5 ;oomla<s cache 9#=isable hosting server cache E via #htaccess M#Switch off SE0 >2.s N#,hange parameters with 3extreme4 numbers O#,hec& Template Overrides P#,hec& Template for hardcoded stuff "G#,hec& ),.$ .anguage etc
35

9# 6G6

36

9# Error1 3.in&s give 6G6 error4

=en&# don:t work Site doe# not work after "o$e to other #er$er 797 error for all article*#ite link# 797 Error on All >ink# =A@C =ECU 797 ERRDR plea#e help!!!! "en& ite"# gi$e 797 error =en& ite" no longer working - ret&rn# with 797 error 797 error# on all link#, front page of 4oo"la fine Strange UR>:# in ;oo"la 1,5,. URGENT HELP URGENT help error 797
37

What doe% 9; %tand for8

What doe% it %tand for86666 What doe%n:t it %tand for8

38

9# Solution 3.in&s give 6G6 error4 SE0 @ Search Engine 0riendl5

"#)pache1 rename htaccess#txt to #htaccess *#%icrosoft IISN1 rename web#config#txt to web#config /#Lginx1 put in virtual domain bloc&1 location F Q index index#php index#html index#htmR tr5Afiles Suri SuriF Findex#php!q@SrequestAuriR T
39

M# ,an<t login

40

M# Error1 3,an<t login4

@ can:t login to " ad"in panel Site ?acked and now locked o&t of ad"in ;oo"la 1,5 can:t login to Ad"in or Site Cannot log in into *ad"ini#trator back-end Can:t login ad"in or &#er, Cannot Acce## Ad"ini#tration Aage Cannot login to backend After "o$e of #ite cannot login, loop >ocked o&t of the Ad"in S&per U#er >ocked D&t of ;oo"la 1,5
41

)ello )ello Comp/ter

)ello

42

M# Solution 3,an<t login4

>se php%5)dmin

Reset password1 new password ? 30unction4 %=9$ after login E >ser %anager$ Lew password' add new Super Admin ? password$ see1 http1FFdocs#7oomla#orgFDowAdoA5ouArecoverAorAr esetA5ourAadminApasswordU/0 chec& plugins in VAAextensions1 plgAuserA;oomla E enabled @ " ! plgAauthenticationA7oomla E enabled @ " !

Securit5 extension! E !to&enCafterCurl

43

N# ,an<t install

44

N# Error1 3,an<t install4

Cannot in#tall an te"plate#, pl&gin#, "od&le# or co"ponent# Cannot in#tall e3ten#ion# on ;oo"la! 1,5 ?elp - Can:t in#tall e3ten#ion#, ;Folder((file#( Aath i# not a folder, ;@n#taller((in#tall( Failed to cop file Unable to Find @n#tall Aackage Cannot in#tall <EF in ;oo"la on ?o#ting FE< ;oo"la cannot in#tallG ;SDC i##&e ;@n#taller((@n#tall( Cannot find ;oo"la <=> #et&p file Can:t in#tall e3ten#ion#
45

46

N# Solution 3,an<t install4

Bith specific Extension or all Extensions! Extension right ;oomla version! ,hec& Permissions

0iles M66$ 0olders N99 S5stem H S5stem Information H =irector5 Permissions Bith 0TP fileAuploads @ OL$ uploadAmaxAfilesiWe @ e#g# "G%
47

,hec& Ownership (0TP user vs Bebserver)

,hec& PDP 0ile >pload - >pload SiWe

,hec& =is& Space >nWip in FtmpF folder - 3Install from =irector54!

O# Dow to remove!

48

O# uestion1 3Dow to remove XYZ4 Changing the backgro&nd color%

?ow can @ Re"o$e the HAowered b <EFH% ?ow to change the colo&r of the article title te3t% Change logo% 'eeI- header change% Ao##ibilit to change te3t color in article% >ogo change po#ition% Change "od&le po#ition beeI19% Change ?- to another header in "od&letable( Re"o$e cop right info at the botto"%
49

50

O# Solution 3Dow to remove XYZ4 )nal5We DT%.F,SS with browser

8oogle ,hrome or 0ire0ox ? addons1

Beb =eveloper 0ire:ug (or 8oogle ,hrome<s Inspector)

%odule! =ispla5 %odule Positions1

Extensions H Template %anager H Preview %odule Positions1 enabled >2. ? !tp@"

Template! ,hange template as test Plugin! =isable plugin as test ,omponent or %odule! DT%. override! I=E (Letbeans$ Eclipse$ 0irestorm)
51

P# The Leed for Speed

52

P# Error1 3Bebsite slow4

!h i# " web#ite #o #low to load% Slow web#ite! @# it " ho#ting% !eb#ite loading to #low Change# to web page #low to load = web#ite i# loading e3tre"el #low Slow /&erie# on large web#ite Slow loading web#ite )&n#table perfor"ance) Jer #low page loading )!aiting on font#,googleapi#,co") Br ing to increa#e the #peed of " web#ite @t:# too #low
53

)ave $o/ tried forcin# an /ne>pected re(oot8

54

P# Solution 3Bebsite slow4

)nal5se database queries

>se ;oomla<s debug mode - chec& queries >se Yslow (0ire0ox F ,hrome browser addon) anal5se loading of website :ac&up (with )&eeba) .ocal webserver op P, (with X)%PP) 2estore bac&up on local P,$ test speed compare
55

)nal5We loading time

,ompare with other hosting

"G# S"t/ 8Gt D[c&/d'

56

"G# Error1 3Site got hac&ed4

Unwanted Ad$erti#er Aop-&p appearing on ad"in front end, @ got hacked,,,, Cant re#et #&per&#er pa##word ;&#t got hacked, ad$ice needed @ 4&#t got hacked b 3333 -aarrgghh! !eb#ite got hacked b in#ert A?A code in all file ;oo"la #ite hacked Se$eral #ite# co"pro"i#ed = #ite ha# been hac4ed! plea#e help !ebho#t "alware #can delete# #o"e file# Got ?acked
57

3ear Sir %tro1e Madam

2ire, e>clamation mar1 2ire, e>clamation mar1 )elp me, e>clamation mar1
58

"G# Solution 3Site got hac&ed4

=o 5ou have a bac&Cup! 0ind the cause

=id 5ou &eep all software upCtoCdate! )nal5We server log files Search for similar hac&s on shared hosting neighbors Outdated ;oomla - extensions version! Beird files in FimagesF ! Search recent modified files Search for 3eval(baseM6Adecode4 You have been hac&ed or defaced

SSD access!

http1FFdocs#7oomla#orgFSecurit5A,hec&list

59

e) Tools

60

e) Tools "F/
Joomla

Other ;oomla site with example installation ;oomla =ebug mode ;oomla SE0 O00 CH full >2. with all commands ;oomla S5stem Info

PDP Information =irector5 Permissions (and or use 0TP to anal5We permissions - ownerFgroup) )nal5We - fix director5 permissions 2epair - optimiWe database tables
61

)dmin Tools (/rd part5 Extension)

e) Tools *F/
Ser er

Bebserver access - error logfiles PDP error logfile #htaccess !atabase

php%5)dmin 8>I based S . navigator (Sequel Pro) "ode #$%$& %'()& )anguage strings*

I=E (e#g# Let:eans$ Eclipse$ 0ireStorm)

62

e) Tools /F/
%'() +utput

Inspect DT%. F ,SS

8oogle ,hrome E Inspect Element 0ire0ox ? 0irebug )ddon

Beb =eveloper )ddon (,hrome ? 0ire0ox) Yslow (:rowser )ddon) )&eeba :ac&up X)%PP diff (8>I1 %eld$ Bin%erge)
63

!atabase

The

64

uestions!

Presentation available at www#dbO#nl

Peter %artin eCmail1 info at dbO#nl website1 www#dbO#nl twitter1 [peNer

65

>sed Photos "F*

IT ,rowd \ *GGMC*G"G$ Produced b5 Tal&bac& Thames for ,hannel 6 Television ,orporation# IT ,rowd photos1 http1FFspoilertv#co#u& power button C ]gerardNP] http1FFwww#sxc#huFphotoF"GGP6O9 Old Polish T^ C +onrado 0edorcW5&o http1FFwww#sxc#huFphotoF""ON99/ =iscarded C Therese :ranton http1FFwww#sxc#huFphotoFNG9/N* chains C Pablo Derrera http1FFwww#sxc#huFphotoF"/O"M99 %otherboard 6 C .isa Zanchi http1FFwww#sxc#huFphotoF"G/P"6 note paper C il&er http1FFwww#sxc#huFphotoF"*MM9/* 2oadside )ssistance 2equired C 7amie brelsford http1FFwww#sxc#huFphotoFMG/GG"

66

>sed Photos *F*

=oodled des&s * C ]igoghost] http1FFwww#sxc#huFphotoF""P/**O Tree of ,hange " C +imberl5 ^ohsen http1FFwww#sxc#huFphotoF"GNNMGP Aerror C )lexandre 8alant http1FFwww#sxc#huFphotoFMO*/O/ .oc& C 2obert .inder http1FFwww#sxc#huFphotoF"/P9/NP tap 7oint C )sif )&bar http1FFwww#sxc#huFphotoFOM6/ON claws C esra su http1FFwww#sxc#huFphotoF*GMOPM Speedometer )bdulhamid )l0adhl5 http1FFwww#sxc#huFphotoF"/PG"OP ,rowbar C 2ichard =udle5 http1FFwww#sxc#huFphotoFO96*MM Tools C ; :oont7e http1FFwww#sxc#huFphotoFOG99N" signs signs C ;ason )nton5 http1FFwww#sxc#huFphotoFN9"G/6 0ace C uestions C :ob Smith http1FFwww#sxc#huFphotoF6"O*"9

67