Troubleshooting tips for common WordPress problems, WordPress customization, Importing/Exporting

1. Troubleshoo*ng
WordPress
Common
Issues,
Customiza/on,
Import/Export
2014
WordCamp
Miami
Presented
by:
Gabriela
Levit
Glevit@JacarandaTech.com
@JacarandaTech
hCp://JacarandaTech.com
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com

2. Before
We
Start
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
•
Taking
notes
is
op/onal
-­‐
I
will
post
the
slides
•
Please
ask
ques/ons.
Chances
are
others
have
the
same
ques/on
as
you.
•
If
you
think
of
a
ques/on
aTer
the
presenta/on,
please
feel
free
to
contact
me
any
/me.
•
Feedback:
Please
let
me
know
how
I
did
or
any
sugges/ons.

3. Topics
Covered
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! General
Troubleshoo/ng
Tips
! Fixing
Common
WordPress
Issues
! Customiza/on
! Import/Export
Tools
! Resources

4. General
Troubleshoo/ng
Tips
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! Take
a
deep
breath
! Write
down
the
exact
error
message,
what
you
changed
&
theme/plugin
name

5. Fixing
Common
WordPress
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Syntax
Errors
–
OTen
when
you
copy
&
paste
code
from
another
site.
Eg.
Parse
error:
syntax
error
…
/wp-­‐
content/plugins/newplugin/
newplugin.php
on
line
145

6. Syntax
Errors
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Error
message
tells
you
which
file
has
an
error
&
the
line
number:
! If
you
just
copied
&
pasted,
access
file
via
FTP
&
remove
the
code

7. Understanding
Syntax
Errors
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Common
Syntax
Error
Causes:
! Missing
or
extra
php
tags
! Missing
or
extra
semi-­‐colons
or
curly
braces

8. Properly
Pas/ng
Code
Snippets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! Remove
open/close
tags
from
code
snippet
before
pas/ng
into
exis/ng
code
! Don’t
place
open/close
PHP
tags
inside
other
open/close
tags.

9. Properly
Pas/ng
Code
Snippets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
PHP
code
much
be
enclosed
by
open/close
tags.

10. Properly
Pas/ng
Code
Snippets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
This
is
correct
too.

11. Properly
Pas/ng
Code
Snippets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Incorrect

12. Blank
Screen
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
A.k.a.
“White
Screen
of
Death”
Possible
Causes:
! Syntax
errors
in
your
theme
or
plugin
! WordPress
Out
of
Memory
! Web
Site
Host
Issue

13. Diagnosing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
All
your
domains/sites
with
current
hos/ng
company
or
just
one?
! If
all
your
sites,
issue
likely
with
your
host
! Otherwise,
likely
an
issue
with
your
theme
or
a
plugin

14. Diagnosing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Only
a
single
post
or
page?
! Definitely
an
issue
with
your
site

15. Fixing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Out
of
memory?
! Increase
WordPress
PHP
limit

16. Fixing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Didn’t
help
or
memory
limit
already
high?
! Rename
plugins
folder
to
disable
all
plugins

17. Fixing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
If
that
fixed
it:
!
Re-­‐ac/vate
plugins
one
at
a
/me
un/l
you
figure
out
which
one
is
causing
the
problem

18. Fixing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Disabling
plugins
didn’t
fix
it?
!
Switch
to
a
default
theme

19. Fixing
Blank
Screen
Issues
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
If
that
fixed
it,
you
theme’s
fuc/ons.php
likely
the
cause:
!
Remove
extra
spaces
at
the
boCom
! Replace
poorly
wriCen
code

20. 500
Internal
Server
Error
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! Something
is
wrong
but
the
server
can’t
iden/fy
the
issue.
! Not
necessarily
related
to
WordPress

21. 500
Internal
Server
Error
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Possible
Causes:
! Theme
or
Plugin
Code
! Corrupt
.htaccess
File
(controls
permalinks)
! PHP
memory
limits

22. 500
Internal
Server
Error
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Troubleshoo/ng
(part
1):
Check
for
corrupt
.htaccess
file:
1. Rename
&
refresh
site
to
see
if
that
fixes
2. If
it
did:
Click
on
Sehngs
>
Permalinks
to
generate
a
new
.htaccess

23. 500
Internal
Server
Error
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Troubleshoo/ng
(part
2):
! If
re-­‐genera/ng
.htaccess
file
didn’t
work,
follow
same
steps
as
for
fixing
blank
screen
issues.

24. Customiza/on:
Widgets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! Content
Added
To
The
Sidebars
! Drag
&
Drop
Interface
! Widget
Types:
Category
Lists,
Tag
Clouds,
Social
Media
Feeds,
Naviga/on,
Search

25. Customiza/on:
Widgets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
New
Widget
Customizer
-­‐
Step
1

26. Customiza/on:
Widgets
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
New
Widget
Customizer
–
Step
2

27. Customiza/on:
Menus
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
WordPress
Supports
Mul/ple
Menus
! Loca/ons
Controlled
by
the
Theme
! Doesn’t
Require
Code
! Menu
items
can
include
Pages,
Posts,
Categories,
Tags,
Etc.

28. Crea/ng
Menus
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com

29. Tools:
Import/Export
Content
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! To/From
WordPress
Web
Sites
! Download
&
Ac/vate
Plugin
First
! Can
import
from
Blogger,
Movable
Type
and
Others
! Choose
Pages,
Posts
&
Custom
Types

30. Tools:
Import/Export
Content
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Step
1
–
Install
Importer
Plugin

31. Tools:
Import/Export
Content
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com

32. Tools:
Import/Export
Content
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Step
2
–
Import/Export
Content

33. Resources
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
Official
WordPress
Documenta*on
hCp://codex.wordpress.org/
Tutorials
&
Reference
hCp://www.wpbeginner.com/
hCp://code.tutsplus.com/series/wp101-­‐basix-­‐training-­‐-­‐
wp-­‐20968
FTP
Clients
FileZilla:
hCps://filezilla-­‐project.org/
CuteFTP
(Windows):
hCp://www.cuteTp.com/
Transmit
(Mac):
hCps://panic.com/transmit/

34. Ques/ons
&
Answers
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
???

35. Thank
You!
☺
Troubleshoo/ng
Common
WordPress
Issues
I
2014
WordCamp
Miami
I
May
9-­‐11,
2014
I
Gabriela
Levit
I
JacarandaTech.com
! All
the
2014
WordCamp
Miami
Organizers
&
Volunteers
for
your
effort
! 2014
WordCamp
Miami
ACendees
! MaC
Mullenweg,
co-­‐founder
of
WordPress,
and
all
the
WordPress
Contributors