Slide 1

Slide 1 text

Plugin 
 Troubleshooting 
 Guide

Slide 2

Slide 2 text

This is my profile page on WordPress.org. I'm a WordPress plugin developer, 
 and also engaged in many other activities in the community.

Slide 3

Slide 3 text

Fukuoka, Japan I'm from Fukuoka, Japan. Fukuoka is known as the birthplace of Wapuu.

Slide 4

Slide 4 text

This is the world's first Wapuu cake. We made it for WordCamp Fukuoka 2011.

Slide 5

Slide 5 text

This is Contact Form 7's plugin page on WordPress.org. 
 I have been maintaining this plugin for more than 10 years.

Slide 6

Slide 6 text

According to BuiltWith.com, Contact Form 7 has a 71% market share 
 in the “Feedback Forms and Surveys on the Entire Internet" category.

Slide 7

Slide 7 text

Because of its popularity, I constantly receive a lot of support requests. 
 Today, I tell you the secret of troubleshooting.

Slide 8

Slide 8 text

Troubleshooting 
 in General

Slide 9

Slide 9 text

Troubles caused by 
 WordPress core are 
 very rare. 
 Most troubles are 
 caused by its plugins 
 and themes.

Slide 10

Slide 10 text

To find out which plugin 
 is the culprit:
 •Try deactivating all plugins 
 at one time. •If the problem disappears, 
 re-activate them 
 one by one.

Slide 11

Slide 11 text

If you click on the "delete" link, the plugin will try to wipe out all data related to it. 
 If this is inconvenient for you, access the server via FTP and delete the plugin files manually. Be careful 
 when you 
 delete plugins

Slide 12

Slide 12 text

Cache might be connected 
 to the trouble. 
 Try deleting all browser cache and page cache, and 
 check to see if the behavior changes.

Slide 13

Slide 13 text

Some troubles are seen only when you are logged-in, or when you are logged-out, 
 and this information will be 
 a useful hint to troubleshoot 
 in many cases.

Slide 14

Slide 14 text

Getting Support from Community-based Forums

Slide 15

Slide 15 text

Don't send a direct message 
 to developers to get support. Many developers don't like 
 to answer questions privately. Use public support forums instead.

Slide 16

Slide 16 text

Each plugin has a dedicated support forum on WordPress.org. 
 This screenshot image points to the "Support" link on a plugin page.

Slide 17

Slide 17 text

This is an example of a support forum for a plugin.

Slide 18

Slide 18 text

At the bottom of the plugin support forum, there is a form to create a new topic. 
 Detailed information is necessary to get helpful support.

Slide 19

Slide 19 text

WP.org Support Forums are:
 •Volunteer-based
 Be polite and kind to others.
 •Public forums 
 Providing information publicly is needed.

Slide 20

Slide 20 text

Before using support forums, look through the Forum Guidelines 
 and FAQ on WordPress.org. Let's have a look at some of the topics.

Slide 21

Slide 21 text

Do Not Spam Don't do spammy activities on the forum. Don't post comments 
 for the purpose of promoting something. If you do that, you'll get a penalty.

Slide 22

Slide 22 text

No "Bump" Some users just post "Bump" with an attempt to get attention for their forum posts. 
 This will never work, and is prohibited.

Slide 23

Slide 23 text

No "Me Too" Don't hijack others' topics with a "Me too" comment. It is rude to the original poster, 
 and your problem is different from theirs in almost all cases.

Slide 24

Slide 24 text

Do Not Offer to Pay for Help Do Not Offer to Work For Hire WordPress.org support forums are not a place to look for jobs or paid services.

Slide 25

Slide 25 text

If you are looking for jobs or paid services, use jobs.wordpress.net instead.

Slide 26

Slide 26 text

Do Not Post About 
 Commercial Products Posting about commercial products is prohibited. 
 The responsibility of support lies with the vendor of the product.

Slide 27

Slide 27 text

Do Not Post 
 Sensitive Information Login ID and password, email addresses, 
 or any kind of keys or secrets should not be posted.

Slide 28

Slide 28 text

There are many other topics in the guidelines and FAQ. 
 Read them carefully and be a good forum participant.

Slide 29

Slide 29 text

Preventing Troubles 
 from Happening

Slide 30

Slide 30 text

You can avoid troubles if you use trustworthy plugins only
 ✓ hosted on wordpress.org (100% GPL and free) ✓ maintained by 
 experienced developers ✓ updated to the latest WordPress versions

Slide 31

Slide 31 text

Feedback is the most important factor in maintaining a quality of software. Most commercial plugin and theme vendors can't get enough feedback 
 in quality and quantity. 
 Avoid them if you want to avoid troubles.

Slide 32

Slide 32 text

Thank you!