Tell Users What You’re Doing

Cat Surprise
  1. Blogging for Hippo
  2. Schedule Sales with WooCommerce
  3. The Problem with Focus
  4. Give Thanks
  5. Be Thankful for the People Who Inspire You
  6. Give Yourself Space
  7. Build Resources From Support
  8. How Hard Can Membership Be?
  9. Adding Social Media Icons to WooCommerce Product Pages
  10. How to Export WooCommerce Subscriptions
  11. Upgrade Your Contact Form With Ninja Forms
  12. Why I Write
  13. Blog Comments Policy
  14. Content Marketing Works – Even with Furnace Filters
  15. Making Email from Your Website More Reliable with Email Delivery Tools
  16. A Happiness Podcast?
  17. Podcast Compensation
  18. Wishlists Done Right
  19. Enable Free Shipping on a Per Product Basis
  20. Improve Your Writing with the Hemingway Editor
  21. Tell Users What You're Doing
  22. 2014 Business Review
  23. Mind Your Own Business
  24. Think Different to 10x Your Business
  25. Let Projects Die
  26. Maximize Your Creative Energy
  27. Use Git Bisect to Find Bugs in Your Codebase
  28. My Personal Value of Remote Work
  29. Don't Spam Email Receipts
  30. Make Your Own Luck
  31. Cold Showers and the Power of Challenges

Imagine coming home from a long day of work. You open the front door, set down your keys, take off your shoes, and then see a present on the kitchen table. If you have a partner living with you it's probably a nice gesture of some sort. But what if you're the only person with keys to your home? Then it gets creepy right?

That's what I experienced today. Not with my home but with my site.

Finding the Present

Shortly after WordPress 4.1 came out I accidentally pasted a link in the text editor. I saw a loading animation and then the code sample popped right into my code editor. Awesome! WordPress 4.1 must have added oEmbed support for gists. That makes it that much easier to copy code samples into my posts. That means that I can remove the plugin I used to use to do this for me.

I went into my site this afternoon to do a little maintenance and replace the shortcodes I had to use with the older plugin. And this is where it gets a bit weird. On my test site I had the exact same version of WordPress, no plugins activated and it wasn't working. That means that WordPress doesn't handle this. Somehow a feature got added to my site and I have no idea how. Think back to finding a present on your kitchen table. It's a nice idea but not when it's unexpected.

Who Delivered the Present?

It took a 21 minute scavenger hunt but I did manage to find the culprit. It's actually one of my favorite plugins that's had some trouble in the past. I love Jetpack. It add's a lot of value to my site but what I don't like is when they add functionality without telling me. They've broken their plugin into dozens of modules which you can turn on and off. One of those modules is Shortcode Embed.

Jetpack Shortcode Embed Description

The description for Jetpack's Shortcode Embed module.

If you're familiar with the WordPress world you probably know that shortcodes are kind of a user friendly version of code. It's sort of readable and it's basically a placeholder for some sort of extra content. Meanwhile oEmbeds you just paste a link into the editor and it loads it. By comparison, it's very user friendly. It's kind of like the difference between taking a chairlift to the top of a mountain versus teleporting to the top of the mountain.

Now when you're looking for the engine that powers the teleporters are you going to look in the chairlift shack? Hell no. During my 21 minute scavenger hunt I actually found the module and looked at the description. I decided to not disable it because I was confident that it wasn't the culprit.

Leave Presents at the Door

With WooCommerce 99.9% of users will need us to automatically create the cart, checkout, and my account pages for them. But we don't do this automatically. We let the user know that we're creating pages. That way when they see extra pages in the WordPress admin they don't freak out. They know exactly why they were created.

WooCommerce Install Pages

WooCommerce prompts users before installing any pages

So here's my plea for developers. Don't do anything without informing the user. Just because it's obvious to you doesn't mean it's obvious to anyone else.

Image credit: Giphy

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.