Make WordPress Plugins

Recent Updates Page 2 Toggle Comment Threads | Keyboard Shortcuts

  • Ipstenu (Mika Epstein) 4:36 pm on July 6, 2016 Permalink |
    Tags: , ,   

    Repository Guideline Reminder: Do Not Remote Load Content 

    In a very irregular feature, we’re posting about various plugin guidelines and what they really mean to you.

    This week, we want to remind you about a long-standing guideline in the repository, which is covered in item #7 – Don’t phone home without consent.

    No “phoning home” without user’s informed consent. This seemingly simple rule actually covers several different aspects:

    The guideline goes on to break down what we mean in four main points:

    1. No unauthorized collection of user data
    2. All images and scripts shown should be part of the plugin
    3. No 3rd party ad tracking
    4. No ad-spam

    That second item (which I emphasized) is what we want to remind you of today.

    Your images, your scripts, your CSS, etc, should all be included locally. Besides not tracking users, keeping everything locally will make your plugins faster. It obviates the problem of external load. It means when your server is down for maintenance, you didn’t just slow down everyone’s wp-admin. It means you’ll never DDoS yourself on accident.

    Unless you’re a service, your plugin has no business phoning home to your own servers to load data. If you are a service, you must have this clear in your readme as to what the service entails, preferably with a link to your ToS and and explanation as to what is tracked. This is for your protection. By remote loading files, you have the ability to track users. Data tracking is a huge deal, and while we understand you want to do it for metrics, it someone was taking your data without permission or consent and selling it or using it to promote their code, you’d be pretty ticked off.

    You can (and should) re-read all the guidelines on https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/ – we rarely change them though we may reword things for clarity.

    If you have suggestions as to how we can be more clear about #7, please leave a comment and let us know.

    Keep in mind, we’re not going to spell out everything to the letter, as in our experience that leads to people playing nit-picky fake-lawyers about everything, and still violating the ultimate rule of the guidelines which is ‘Don’t be a spammer.’ For example, we’re not going to make a rule for not stealing other people’s plugins. You already know stealing is bad, right? 😈

    • vovafeldman 12:58 am on July 7, 2016 Permalink | Log in to Reply

      Hey Mika, I totally understand the not phoning home guideline. What is the reviewers’ view on using JS libraries from popular CDNs like MaxCDN, ClodFlare… It’s beneficial for the site owner because it’s reducing the load to the CDN (efficiency, speed and $$$ wise), it reduces the size of the plugin so it saves storage on the SVN repo, etc.

      Just a thought, maybe you can create a collection of “approved” CDNs, or create a WP.org CDN for the community. What do you think?

      • Ipstenu (Mika Epstein) 5:42 am on July 7, 2016 Permalink | Log in to Reply

        We currently do not recommend cdns for us libraries for a related reason – unnessecary dependencies. If the cdn is blocked, like if you’re on a private network, it causes a terrible experience to the user.

        Fonts are our only exception, and even then I caution developers often, as google fonts are NOT universally accessible.

        Edit: also it’s not as much of a money/speed gain as you’d think :/

    • Joel James 5:19 am on July 7, 2016 Permalink | Log in to Reply

      Hey @ipstenu,

      What if we ask for user permission to place a link, then place a link to the public site when search engines or bots (not real users) visits the site? Is that illegal?

      • Ipstenu (Mika Epstein) 5:46 am on July 7, 2016 Permalink | Log in to Reply

        Please don’t use the term ‘illegal’ – it’s an incorrect term.

        Short answer: don’t do it

        Long answer:

        Strictly speaking, it would be permissible in the guidelines, especially if you make it clear that’s exactly what’s happening.

        Now that said, you’ll screw up your SEO like that, because Google can tell when you’ve made bot/search engine only content. And they consider it a scam.

        So … Y’know, don’t 🙂 it would end badly for you, it would hurt your SEO, it MIGHT hurt that of the sites you’re linked from. It is a terrible idea.

        • Joel James 6:06 am on July 7, 2016 Permalink | Log in to Reply

          Yup 🙂 When we say SEO, it is Google. Lol.

          Thanks @ipstenu

        • chesio 1:41 pm on August 17, 2016 Permalink | Log in to Reply

          @ipstenu, and still he did [link removed]

          I know that you are already aware of this situation. It just irritated me when I found @joelcj91 claiming “he was honestly not aware of this” [link removed]

          I hope he has learned his lesson well.

          • Ipstenu (Mika Epstein) 4:51 pm on August 17, 2016 Permalink | Log in to Reply

            I’m aware of the situation, I’ve spoken directly, privately, respectfully with Joel about the issue and why it was bad and what exactly was bad. It is my belief that this was a monumental screw up, and that he wasn’t aware of ‘this’ meaning he didn’t realize what his partner did.

            There are nuances to the ‘no remote loading’ that people often misunderstand. I don’t expect everyone to read my mind, and I know the quality of the guidelines is pretty bad right now. I am actively working on better ones to make things easier to understand.

            We can move on now and stop dog shaming people.

          • Joel James 5:29 pm on August 17, 2016 Permalink | Log in to Reply


            Yes, I learned well.

            I never said(or at least I never meant) I was not aware about the remote loading. But I was not aware about the remote content changes he made. That made this serious spam.

            Also I misunderstood this – “Strictly speaking, it would be permissible in the guidelines, especially if you make it clear that’s exactly what’s happening”.

    • Paul de Wouters 8:09 am on July 7, 2016 Permalink | Log in to Reply

      Does this mean a plugin cannot retrieve content from an API then?

      • Ipstenu (Mika Epstein) 2:34 pm on July 7, 2016 Permalink | Log in to Reply

        An API is a service, is it not? Services are noted, in this post and the guidelines, as being an exception.

        Make sure it’s clearly documented in the readme that your plugin uses a service, link to the service, explain how to sign up for it or what the tos are.

        • Paul de Wouters 6:42 am on July 8, 2016 Permalink | Log in to Reply

          thanks for clarifying. I personally didn’t know “service” had that meaning in this context

        • Paul de Wouters 6:44 am on July 8, 2016 Permalink | Log in to Reply

          we’re not a “service” though, we just just retrieve content via a call to the WP API on a remote site.

          • Ipstenu (Mika Epstein) 8:44 pm on July 11, 2016 Permalink | Log in to Reply

            I’m not really psychic 🙂 When you said “an API”I assumed “An external system or service that provides information not otherwise available to a WordPress site.”

            Now turning around and saying “The WP API” doesn’t make the source of your data any more clear to me. If you said “This plugin reaches out to the WordPress.org plugin API to pull in data…” I would still say “Document it as a service.”

            If you’re calling data from outside the user’s site and server, then the user MUST know. Plain and simple 🙂

    • Nathan Johnson 5:03 pm on July 7, 2016 Permalink | Log in to Reply

      FYI, WordFence attempts to load their logoon the dashboard widget from their domain.

      • Ipstenu (Mika Epstein) 8:56 pm on July 7, 2016 Permalink | Log in to Reply

        In general we ask you email `plugins@wordpress.org` with that, so as not to public shame people. I’ll contact them, though. Thank you for letting us know.

    • Chuck Reynolds 2:44 am on July 15, 2016 Permalink | Log in to Reply

      like this one i just found? [redacted]

    • chesio 1:46 pm on August 17, 2016 Permalink | Log in to Reply

      Remote loading of content can also result in security issues when plugin domain expires: https://blog.sucuri.net/2016/08/plugin-expired-domain-security-threat.html

  • Ipstenu (Mika Epstein) 8:44 pm on June 26, 2016 Permalink |

    WCEU Contributor Day 

    I want to thank everyone for coming to the first ever plugin review contributor workshop!

    We did not get half as much covered as I’d like to but I hope that we were able to enlighten some of you as to how the repository and review system works.

    I’m looking forward to the near future when we’ll be able to start adding some of the wonderful people who came to contributor day to the review team! Since that’s still a bit in the future, what we can do right now is welcome everyone to #pluginreview !


    That’s right, we have #pluginreview as a channel now. This channel is for us (yes, you and us) to talk about plugins, finding issues like base64 and creative commons code. At this time, in order not to put users at risk, please continue to send security issues to plugins@wordpress.org only.

    I plan on posting some plugins for you to download and look at and discuss, as well as possibly have open hours or a scheduled time every once in a while to talk about reviewing a plugin as a group.

    Also if you have a question about the plugin repository in general, please feel free to ask there. Please remember to be reasonable, though, and try not to ask “When will my plugin be reviewed?” 😁

    Getting Started

    In the mean time, what can you do to get started?

    First, read the guidelines. Read all the guidelines. Memorize them. Be familiar with things like phoning home, and the difference between a serviceware API and a license check that cripples software needlessly. Don’t worry too much about that, but do get familiar with the guidelines.

    Next! Grab the Mark Jaquith Plugin Directory Slurper. The repo is about 25 gigs, more or less, and will take you a few hours to download. By a few what I mean is set your laptop not to sleep, put it in a cool room with a fan, and go to bed. The Slurper doesn’t work well on Windows that I know of (sorry Windows people). Anyone who wants to improve that, pull requests and forks are welcome.

    Now once you have the whole repo, start poking at things. Look for code you know is not allowed in the repository (non-GPL is a great start, pick a popular library you know isn’t GPL and grep or ack for it).

    Talk about what you find in the Slack channel. Remember: Slack is public. Do not post anything rude, insulting, antagonistic, or mean there. Also don’t post security issues there. Please keep that to email.

    Finally, if you’re really super into code ideas, download the (broken) Plugin Check plugin! Have a look at it. Try to figure out how you’d make it work, and maybe fork it onto GitHub and start tinkering. Start with the basics (check for non GPL, calling wp-load directly, including jquery etc) and see how far you can get. More hands make light work, after all.

    When Will We Accept New Members?

    Soon! I’m sorry, but I just don’t have an ETA.

    We need the UX for the repository revamp to be usable and acceptable first. Until then, we’re on that lousy, single-threaded, bbPress setup. Once that changes, the plan is to start letting people apply (and yes, we will post requirements for that) and adding them with access to review privately. Think of it as moderated reviews. But trust me here, we can see the end and we have a plan.

    We’re like Cylons.

  • Ipstenu (Mika Epstein) 5:06 pm on June 24, 2016 Permalink |  

    FYI: Yes the reviews are backlogged.

    Please just be patient. Half of us are at WordCamp EU so it may be a bit before we catch up.

    We’re back on track.

  • Ipstenu (Mika Epstein) 8:55 pm on May 31, 2016 Permalink |
    Tags: bribery,   

    Reminder: Do Not Compensate Reviewers 

    It was brought to our attention that some plugin developers on WordPress.org have used various third party services to find new users for their plugins and to have them leave reviews on our site.

    It’s time for a reminder.

    We do not allow for compensated reviews to be on our site, by any means whatsoever, and consider those reviews to be disingenuous.

    The WordPress.org plugin and theme directories are for users to write their experiences, not for companies to use market their products. A compensated or recruited review should be posted on someone’s own site, the reviewers own site, or the 3rd party site itself.

    While you may not consider getting a product free (or at a discount) to be compensation, we do. It messes up the system, which really is meant for people who legitimately use a plugin to leave a review of their experience. It’s also misleading, in our eyes, because it was not made by an actual user of the product in question.

    Asking an existing user to leave a review is one thing. Emailing your user base, while possibly annoying to many people, is totally fine. Reaching out to new people and saying ‘please try and review’ inflates the number of reviews in an unnatural manner.

    You may have heard about how Amazon does permit reviews like that, as long as the reviewer “clearly and conspicuously disclose[s] that fact” in their review. We’re not Amazon, and being a much smaller community, we’re able to monitor our reviews in a tighter manner. Paid reviews, compensated reviews, or recruited reviews are all the same idea. You’re ‘paying’ someone to review.

    The Consumerist has a long article about this, asking Is Amazon Doing Anything To Fight Latest Wave Of Fake, Paid-For Reviews? This article illustrates the issues these kinds of reviews cause, primarily they break the trust a reader has in any review. Also keep in mind that companies like Yelp hire people to blacklist companies who reward people for leaving reviews.

    This is just something you should avoid and reviews that are found to have been compensated for will be removed.

    • A5hleyRich 9:04 pm on May 31, 2016 Permalink | Log in to Reply

      While I agree that those types of reviews are bad, it’s frustrating that you remove them but not the 1 star reviews left by users trying to pressure plugin authors into providing support.

      • FolioVision 9:25 pm on May 31, 2016 Permalink | Log in to Reply

        Yes, it’s quite ironic as Mika has personally told me that vendetta reviews (where one refuses to sell the product to someone demanding one build him a site for free) are fine. Otto has personally told me that ignorance reviews (criticizing a plugin for the absence of features it clearly has) and/or extortion reviews are fine (and should stand) – and that one should drown those bad reviews out with positive reviews.

        If encouraging one’s existing users to write positive reviews is considered over the edge, what is an honest plugin author supposed to do?

        What’s particularly irritating is that favourites like Yoast or JetPack get special treatment (they get direct heads up from the plugin team about bad reviews at which point storm troopers like Jan Dembowski are dispatched to bludgeon the reviewers senseless). A negative review on either of those products is not allowed comments and is closed immediately if one appears.

        It’s discouraging to see where the spirit of open source attached to VC and slick marketers and an insiders’ game is taking us.

        PS. Mika, I appreciate you trying to clean up the plugin directory but I fear it’s the honest long term participants who will suffer while the scoundrels will bribe or weasel their way out.

        • Drew Jaynes 9:34 pm on May 31, 2016 Permalink | Log in to Reply

          > If encouraging one’s existing users to write positive reviews is considered over the edge, what is an honest plugin author supposed to do?

          To be fair, that’s not what she said at all. You can reach out to your existing users all you want and ask them to write reviews. But you can’t ‘pay’ them in some way to do it.

          > Asking an existing user to leave a review is one thing. Emailing your user base, while possibly annoying to many people, is totally fine. Reaching out to new people and saying ‘please try and review’ inflates the number of reviews in an unnatural manner.

          Emphasis mine.

        • Ipstenu (Mika Epstein) 9:42 pm on May 31, 2016 Permalink | Log in to Reply

          A vendetta review is ‘fine’ is it’s one review. If someone is harassing you or stalking you off the site, tell us and they’ll be permabanned. We protect people from abuse.

          But people being pissed and acting like idiots because they don’t like your product? Okay… yes. Par for the course. It makes them an unreliable reviewer to pretty much everyone.

          What’s particularly irritating is that favourites like Yoast or JetPack get special treatment (they get direct heads up from the plugin team about bad reviews at which point storm troopers like Jan Dembowski are dispatched to bludgeon the reviewers senseless).

          Not true. Not once. Not ever. I have never, nor shall I ever, alert plugin devs to bad reviews UNLESS it’s “Hey, this user went insane and I deleted it, PLEASE DO NOT PICK A FIGHT!” And that’s happened… twice? Maybe.

          Also Jan is not ‘dispatched’ to do anything. He monitors the reviews as an ambassador without portfolio. We don’t ask him to. He does it because he cares.

          If encouraging one’s existing users to write positive reviews is considered over the edge, what is an honest plugin author supposed to do?

          You seem to have conflated the terms ‘encourage’ and ‘compensate’ somehow though I don’t really get how you did that.

          Encourage them all you want 🙂 Just don’t pay them with money, rewards, free stuff, etc etc.

          “Hey if you like this plugin, please consider leaving a five star review.”

          That’s encouragement.

          “Hey if you leave me a five star review, you can have this add-on for free!”

          That’s compensation.

          • FolioVision 11:55 pm on May 31, 2016 Permalink | Log in to Reply

            Hi Mika,

            Thanks for taking the time to answer. My experience is different. I could document my experience of this with specific threads and direct quotations but it would take us too far away from your original important topic.

            Encourage/compensate – I think it’s perfectly legitimate to give real clients small favors in exchange for getting off their backsides and writing detailed, helpful reviews. Beats nagging people to death (the alternative). Harassment via dashboard admin notifications is completely abusive and in my opinion highly destructive to WordPress (we’ll be introducing notification suppression and sestration in BusinessPress very soon).

            Bribing people who either don’t use your software or at least not that product to leave positive reviews that’s something I would have an issue with it. So no I don’t think the line is as clear as we’d all like it to be.


            • Ipstenu (Mika Epstein) 12:22 am on June 1, 2016 Permalink

              If I could write something that was never misinterpreted by someone, I’d run for political office.

      • Ipstenu (Mika Epstein) 9:37 pm on May 31, 2016 Permalink | Log in to Reply

        We actually do, in some cases, but in general your mature and well mannered response, telling them to please open a support ticket, is better than an arbitrary number.

        Also they can change their reviews.

    • emanweb 10:09 pm on May 31, 2016 Permalink | Log in to Reply

      Some reviews are obviously not natural. Either good or bad. I guess the only way to help avoid a bit this problem is to do the same as Amazon and ask “Was this review helpful to you?” And of course only allow users withing certain “level” to judge. Then sort the reviews by relevance like Amazon also do. It would also help with right next to the reviewer username show a summary of his contribution to WP.

      • Ipstenu (Mika Epstein) 11:18 pm on May 31, 2016 Permalink | Log in to Reply

        Read the link at the bottom of the post. It actually talks about why what Amazon’s doing is making reviews LESS relevant :/

        Bots can mark things as helpful too, and yes, that’s ALSO a problem.

        Instead of adding more systems to the mix, we’re hoping that appealing to the humanity of things and ‘don’t ruin this for everyone’ will be more beneficial.

        • FolioVision 12:04 am on June 1, 2016 Permalink | Log in to Reply

          Would it be possible to build some kind of a trust score system which removes low quality reviewers votes, Mika? I know it’s not easy (simple systems are equally vulnerable to gaming) but sites like SlashDot and Reddit and StackExchange have managed to make reputation work well.

          As Emanuel notes, some members have been contributing to WordPress, Wordcamps and the ecosphere since 2007 or even earlier, with a rich history of presentations and/or plugins and/or core contribution. Many others are simple drivebys or paid flacks. It should be easy to see the difference (a simple visible trust score?).

          From what I’ve seen of the current internet, ‘don’t ruin this for everyone’ won’t work anymore. There’s also a fair number of people sending saboteurs out to hit up their competitors with negative reviews (hopefully you catch the obvious ones). This isn’t just a WordPress.org issue, sabotage (via fake reviews) is a real, real problem at MacUpdate for instance. It didn’t use to be (i.e. the weather is changing).

          Thanks, Alec

          • Ipstenu (Mika Epstein) 12:20 am on June 1, 2016 Permalink | Log in to Reply

            Not at this time. It’s a monumental amount of code, and no ones been able to make it work yet. The sites you mention have their own vote scam issues. We’d trade one for the other, and we know it.

            • FolioVision 12:53 pm on June 1, 2016 Permalink

              There’s a lot of open source code out there Mika that WordPress.org could tap into to make the reputation dance work. What we have now does NOT work for plugin publishers. We are vulnerable to both extortion demands (we had to pay the user to remove the bad review), revenge reviews (similar to extortion but the user has given up on getting what it is they want and simply wants to destroy your company – in particular the review here has nothing to do with plugin functionality or our free plugin), reviews where the user seems to be using another plugin (as we have no nag screens and never have: two posts at WordPress.org in five years, no response to our questions) and simple drivebys (one star, only review written, user clearly doesn’t have expertise to self-publish).

              On the other side, in certain areas plugin authors face competitors who are prepared to break every rule to win and as I mentioned before, “favored son” candidates like JetPack who have internal protectors as well as endless highlighting in “Featured” lists. Muddling along while it may suit the volunteer moderators does not suit most plugin authors. Some kind of reputation weighting would make the WordPress.org reviews much more useful to users and fairer to plugin authors.

              Once again thank you Mika for raising the important topic of bias in reviews and taking some action on the matter.

    • Monika 7:25 am on June 1, 2016 Permalink | Log in to Reply

      @FolioVision, Besides the fact that it is technically a lot of effort, there is a language problem. I can write qualified reviews in German, but hardly in English. English is not my first language.

      I use plugins and always ask my customers whether they would like to give a review. Very often they want, but can’t because they do not speak English.
      None of my clients have ever been on a WordCamp or MeetUp. But they are often happy, satisfied users. Therefore, the visibility in the “WordPress world” can’t be a measure of reputation for reviews.

      Each voting system can be manipulated. Fairness in the business world is an illusion. Even outside the WWW. 🙁

      • Marcel Pol 11:20 am on June 1, 2016 Permalink | Log in to Reply

        I am always happy to receive a 5-star review in German, Russian or Portuguese. So if your customers don’t speak English, you could tell them to post a review in German. I don’t see anything wrong with that, it would be even a bit charming.

      • Ipstenu (Mika Epstein) 3:13 pm on June 1, 2016 Permalink | Log in to Reply

        Most of us are happy to attempt to use Google and get reviews in any language. And with the new setup for international plugins, I think it may be easier to go to de.wordpress.org/plugins/hello-dolly to leave reviews.

    • Scott Wyden Kivowitz 12:57 pm on June 1, 2016 Permalink | Log in to Reply

      I agree with companies not compensating, however if that is going to be enforced I think illegitimate reviews (like ones that should be support forum threads) should be removed as well.

      • Ipstenu (Mika Epstein) 3:11 pm on June 1, 2016 Permalink | Log in to Reply

        Those aren’t really illegitimate, and it’s a totally different issue.

        Reviews that should be support are people who used your product and somehow can’t find how to do things but can find how to leave a review. They are real users.

        Paid for reviews are people who probably wouldn’t otherwise have touched your product being compensated for a review.

        Both are problematic. One is ignorance, and one is intentionally gaming a system.

        • FolioVision 10:23 pm on June 2, 2016 Permalink | Log in to Reply

          Scott’s point is sound. I really don’t understand why illegitimate accidental reviews should get better treatment than illegitimate deliberate reviews. Mika, your job (collective you, plugin repository moderators) should incorporate advocating for plugin authors and not just unqualified/casual users.

          High quality free plugin authors (Alex King, John Godley, Pippin Williamson, us to name just a few) are the people most responsible for WordPress’s popularity. Please give a thought to us and how to make our work easier. Fighting extortion reviews which should be support tickets is a crippling process which we should not have to go through. There should be a set process for disqualifying simply incorrect reviews (wrong plugin, no competence at all with web technology) and extortion reviews (should be support tickets).

          To keep it simple, when a 1 star review is so vague that it could be for any plugin and the plugin author has requested more information and has not been answered after a period of time the author could flag the review for a moderator. Then the moderator could request formally request more information, possibly screenshots. If the “reviewer” has a dead email or can’t be bothered to respond, the review disappears.

          Reviewing is not a right: it is a privilege. Plugin authors are the ones volunteering their time and contributing for free (in some cases for many years, we have maintained plugins which six years old and have contributed to plugins which are ten years old).

          In the end, higher quality reviews benefit both users and plugin authors. It’s a win-win situation.

          Thanks again for listening.

          • Ipstenu (Mika Epstein) 5:02 pm on June 3, 2016 Permalink | Log in to Reply

            It’s not the point of THIS post, folks.

            This post is merely about people who pay for reviews.

            Are there other issues? Of course. Am I going to get into every single one in a comment debate with people? Good lord no. It’s pointless and it detracts from people who are having questions about what we mean by ‘Don’t compensate people for their reviews.’

            If you have questions or concerns about that, please ask them here.

    • Joy 2:20 pm on June 1, 2016 Permalink | Log in to Reply

      The problem with reviews is that they live where the user doesn’t. The point at which you buy or download the product is where you should see usage stats, not where you should leave a review — because new users don’t have anything to say.
      The review system should be embedded in the user’s admin panel, and only become visible after a reasonable amount of usage.

      • Ipstenu (Mika Epstein) 3:13 pm on June 1, 2016 Permalink | Log in to Reply

        The only issue there is we still need them to have a .org account for … accountability.

        Also Amazon reviews aren’t where the users live either and it doesn’t seem to stop them.

        • Joy 7:56 pm on June 1, 2016 Permalink | Log in to Reply

          Having an account doesn’t sound like an issue. They need one today, don’t they? Or if you used the domain name as the accountability, you could limit them to one review per domain.
          Amazon reviews have all the issues you guys are arguing about. They have to cover digital and physical products, so they are at a disadvantage. WordPress has the advantage of being only digital *and* controlling that digital product so that only actual users can review. It seems like the perfect answer to me.

          • Ipstenu (Mika Epstein) 9:37 pm on June 1, 2016 Permalink | Log in to Reply

            Nope, you don’t need an account to download plugins or install them. And a domain wouldn’t work, since splogs and tracking domains without permission etc are major issues.

            The monitoring of accounts is something that cannot be automated sadly. We need acutall people checking on reviews and making sure they’re real people. Which … well. Not a lot of people want to do that 🙂

  • Samuel Sidler 9:57 pm on May 20, 2016 Permalink
    Tags: , taxonomy   

    More on Taxonomies in the New Plugin Directory 

    Hello again everyone! I posted a proposal for taxonomies in the new plugin directory on the make/meta site. Please leave your questions and comments over there.

    Taxonomies in the Plugin Directory

  • Ipstenu (Mika Epstein) 11:55 pm on May 19, 2016 Permalink  

    Please check out the proposed plugin directory redesign 

    Plugin Directory Prototypes

    This is talking about the theme only 🙂 Jump in and leave constructive comments please!

    • Varun Sridharan 1:20 am on May 20, 2016 Permalink

      I really like this.. the plugin homepage with a featured slider and also the plugin listing.. 🙂

      any changes on single plugin page too ?
      and i hope you will add sliders for the plugin listing like Beta Plugins in homepage 🙂

  • Ipstenu (Mika Epstein) 10:14 pm on May 12, 2016 Permalink |
    Tags: ,   

    Policy Reminder: Tracking Users 

    Do not, under any circumstances, track usage of your plugin without explicit consent.

    If you want to ask your users if you can track them, by all means ask. But you may not require it, and you shouldn’t make it look like they have to in order to use your plugin. That’s being dishonest.

    This has been a guideline for a very long time, it’s not negotiable. Assume people do not want to be tracked and have it to be an opt-in feature.

    If your plugin uses Google Analytics, emails you on plugin activation, triggers some complex check on your servers when a plugin is updated, or tracks usage in any other way when a user has not clearly said “Yes, I allow you to track me,” your plugin will be removed from the repository and you will have to correct this in order to get it back.

    This extends to ads provided by a third party service. If your plugin includes advertising from a third party service, then it has to default to completely disabled. This is to prevent tracking information from being collected from the user without their consent. Again, this is all about people opting into being tracked.

    (For those thinking about using Adsense, don’t. Re-read their Adsense Display Guidelines and note that they do not want you to put ads on non-content pages … which is what the whole WP Dashboard is.)

    Don’t assume that just because someone said they agreed to have usage tracked by you that they’re okay with usage tracked by someone else. Don’t be shady or vague. Tell people upfront “This is who will get the following data…”

    Remember, user trust is paramount to your plugin’s success. If people find out you’re sneaky tracking them, you will lose that trust in a heartbeat and there’s nothing anyone can do to help you restore it.

    • buzztone 10:49 pm on May 12, 2016 Permalink | Log in to Reply

      RE: “you shouldn’t make it look like they have to in order to use your plugin”

      I’ve recently noticed some plugins in the repository that do this. What’s the best way to report of this?

      • Ipstenu (Mika Epstein) 1:18 am on May 13, 2016 Permalink | Log in to Reply

        First be a good person and point it out to them directly 🙂 “Hey, I like your plugin, but you’re making it look like people have to do X… Did you know that was against the rules?”

        Sometimes people simply don’t know. They should, but I can’t make people RTFM 🙂 Link them back here and give them a chance to be good people. If they don’t, then report it to us as a guideline violation (plugins AT wordpress.org) and we’ll be a little firmer.

    • David Anderson 10:07 am on May 13, 2016 Permalink | Log in to Reply

      Hi Mika,

      Thanks for the continual drip-feed of articles reminding plugin authors of best practices. Can I make a suggestion for a future one? One problem that eats up enormous amounts of man hours (for both site owners and plugin developers) is plugin conflicts. Lots could easily be avoided by simply enqueueing your scripts/stylesheets only on relevant pages.

      e.g. In wp-admin, first check it’s your page before your enqueue. That way, all issues of incompatible scripts/CSS would just disappear for a lot of cases.
      Similarly for loading PHP SDKs – only register your auto-loader, or whatever, for an SDK when it’s time to use it, instead of globally every time WP loads (which is also bad for performance).

      If more plugin authors were aware of some of these best practices, and spent a few minutes implementing them, it’d save huge amounts of time for people finding problems on their sites, investigating, forum-posting, etc.


  • Ipstenu (Mika Epstein) 4:24 pm on May 3, 2016 Permalink |
    Tags: ,   

    Handling Bad Reviews 

    In general, the Plugin Review team is not the go-to recourse for bad reviews.  Instead, we have a totally brilliant forum support team! There’s some overlap of jurisdiction of course, and some of us are on both teams, but the point here is you should go to the right group to get the right help.

    I’m also going to put this out there. You will get a bad review. Most of the time, it will not be deleted. So before you get any further in this post, know that the way you chose to respond, in public, to a 1-star review of your plugin is your own choice.

    Our goal with the WordPress.org repository is to have a good place for users to get plugins that fulfill their needs. The reviews are an extension of that, and should viewed as a way for users to educate other users on their experiences. Also a review is about an experience. If someone’s experience with your product is poor, that doesn’t make their review invalid. And to go back to that previous statement, the way you react to those poor experiences is going to impact your reputation, and that of your plugin, a heck of a lot more than that review.

    Now, that said, we have a few ‘common’ types of problems with reviews. This post is going to help you handle them and explain when you should call for help, as well as from whom. Later on we’ll be adding it to our documentation, once it’s refined as best we can make it. Please remember, we do not want to make a ‘rule’ for everything. That just invites people to play rules-lawyers and tip over everyone’s cornflakes.

    Here’s how you do it and when and why.

    First off… How to add a tag!

    99.999999% of the time, you’re going to be adding ‘tags’ to posts. This is so easy, you may kick yourself for missing it. On a post, look on the right hand side, under About this Topic and you’ll see a section for Tags

    Tags are listed on the right hand side of a post

    This is a free-form field where you can add any tag you want. Anyone can add any tag. The forum moderators have an easy way to know who added what, though, so keep in mind we do monitor that. If you want to add a tag to a post and reply, add the tag, press the Add button, and THEN come back to reply. It works better.

    Tag abuse (that is calling moderators needlessly) is not okay. Be smart. Be thoughtful. Remember that every last member of the forum and plugin teams is a volunteer. We’re not being paid by Automattic to do this.

    The spam review

    This is easy. Don’t reply, just add the tag modlook to the post and walk away. The forum team will delete it. If you think it may not be obvious spam, add the tag spam as well.

    The sockpuppet review

    When a person (or group of persons) makes multiple accounts with the sole intention of leaving reviews on their own plugins (or leaving poor reviews on their competitors), this is called being a Sock Puppet.

    This behavior is expressly NOT welcome on the WordPress Forums as it is spamming. But it comes in two flavors:

    1. Someone 5-star spamming their own plugin
    2. Someone 1-star spamming their competition

    Both are bad behavior. Both will get plugins removed from the repository and a stern email from us. If you’re doing this, stop right away. Contact your team and tell them ‘Don’t do this!’ Also keep in mind, asking everyone in your company to 5-star review your own plugins is gauche. I mean, really. You’re stacking the deck on purpose and that’s not beneficial to anyone.

    Again, do not reply! Add the tag modlook AND sockpuppet to the post and walk away.

    The attack/troll review

    These are the worst. When someone attacks you and the review seems like all it exists for is to make you feel terrible, you’re going to have to take a deep breath and walk away. An attack is a troll, regardless of how the original poster (OP) feels, they’ve basically been a troll. They’re writing something they know will make you mad and hurt and angry, and they’re doing it on purpose. That’s a troll. And you shouldn’t feed the trolls. You won’t win, and you’ll just make yourself look bad.

    Again, do not reply! Add the tag modlook to the post and walk away. These are usually pretty self evident after all.

    The review that should have been a support post

    This includes the sub-genre “People who submit 1-star reviews in order to emotionally blackmail you for support.”

    We all get them.

    1. Reply with a link to the support section of your plugin (or directions on how to get support, or even a note that you don’t provide free support) and remind them that next time, they should ask for help before reviewing.
    2. See if you can fix the problem, but give it no more or less priority than you would any other support request.
    3. If you can solve it, ask them to modify their review. If they go back to https://wordpress.org/support/view/plugin-reviews/PLUGINNAME and scroll to the bottom, they can edit their reviews!

    You’ll notice we’re not telling you to tag the post? Right now we can’t move a review into the support forums and vice versa, so there’s really no point. The forum moderators won’t do anything about it except say “Well, that does suck.” If we could move them, we would, but right now we technically don’t have that ability.

    The review about your premium/pro version

    If you upsell your plugin’s pro version in the free one, and someone leaves a bad review because the pro version they bought, on the basis of your free one, is bad, congratulations. The review stays. You opened the door with your upsell, encouraging them to do this, and that experience reflects on your plugin as a whole.

    If you do not upsell, and there’s no direct link between the free and pro version, or the plugin having the issue is a premium only add-on, tag it modlook and someone will come take a look.

    The review about someone else’s plugin

    This one can be fixed! Reply and let them know it’s not your plugin, it’s the other one, and then tag it modlook and then use the tag wrongplugin (all one word) to let the mods know what’s going on.

    But I really need a plugin moderator!

    Okay. So you think you’re an exception? Use the tag pluginmod and a plugin admin will come take a look. Be prepared, though, as we generally will perform a full review on your plugin and any and all guideline violations will result in your plugin being removed until you fix them. Including using too many tags.

    • Austin Passy 4:39 pm on May 3, 2016 Permalink | Log in to Reply

      Thanks Mika!

      It’s good to know that these tags exist.

    • Phil Derksen 4:48 pm on May 3, 2016 Permalink | Log in to Reply

      Very helpful Mika. Thanks.

      I also found it helpful to use the #forums channel on wordpress.slack.com. Great place to discuss how to respond to negative reviews.

    • Syed Balkhi 5:06 pm on May 3, 2016 Permalink | Log in to Reply

      Thanks Mika – this would be very helpful.

    • dudo 5:20 pm on May 3, 2016 Permalink | Log in to Reply

      Hi Mika, thank you for sharing this.

      Some people just rate 1 star because there is not a function that they want/need.

      Does the pluginmod tag can be used in a case this?

      • dudo 5:21 pm on May 3, 2016 Permalink | Log in to Reply

        Sorry for typos

      • Ipstenu (Mika Epstein) 6:09 pm on May 3, 2016 Permalink | Log in to Reply

        No, do not use pluginmod for that. That would be the “People who submit 1-star reviews in order to emotionally blackmail you for support.” folk. We won’t remove them, but you can learn from them by either improving your documentation to be more clear about what features aren’t included, or maybe add them. Either way, that was someone’s experience. They used your plugin, they wanted it to have more to be truly functional for them.

    • Chad Butler 7:13 pm on May 3, 2016 Permalink | Log in to Reply

      Awesome information as usual Mika!

      I am in general agreeance with the policies, and having been around awhile, I know these have been the general policies for quite some time.

      My personal feeling is that the weakest point of the plugin review system is brought on by misuse by a small number of users in the community (most of whom aren’t really even participants in the community). In general, the community is great – and most people post worthwhile reviews.

      But there is a portion of the community that improperly uses the review system, as you’ve already pointed out – trolls, reviews that should be support questions, etc. And then there’s they guy who I place in a separate category – the useless review: 1 star, invalid complaint, never to be heard from again.

      Would it be possible to consider adding review voting to the system at some point in the future? Something similar to Amazon where people who read reviews can answer whether they found the review helpful or not.

      I think this would allow the community to self police this since the majority of the WP community are reasonable people.

      I was tremendously glad to see the addition of requiring an actual review in addition to just the star rating (that seems so long ago…). Would this be a next logical step?

      • Ipstenu (Mika Epstein) 11:15 pm on May 9, 2016 Permalink | Log in to Reply

        It’s a possibility, but it’s low on the to-do list. It would have to come well after the plugin revamp (in progress) and the forum rebuild (getting started).

        Limited resources.

    • Sakin Shrestha 1:37 am on May 4, 2016 Permalink | Log in to Reply

      Thanks Mika for sharing.

    • dartiss 8:31 am on May 4, 2016 Permalink | Log in to Reply

      That. Is. Brilliant. Never knew these existed but glad they do!

      • dartiss 8:36 am on May 4, 2016 Permalink | Log in to Reply

        One quick question – I have a review that I’d like looking at but it’s old enough that it’s closed so I can’t add tags. Is there a way around this?

    • Brad Touesnard 12:03 pm on May 4, 2016 Permalink | Log in to Reply

      Very helpful, thanks!

    • Maruti Mohanty 6:55 am on May 5, 2016 Permalink | Log in to Reply

      Superb. Thanks a ton

    • David Anderson 12:19 pm on May 6, 2016 Permalink | Log in to Reply

      One modest improvement I’d love to see to the review system, is that only reviews from the last 2 years (or some other value) affect a plugin’s rating.

      As it is currently, for mature plugins, there’ll be plenty of reviews which – whether for better or worse – are reviews of a plugin that doesn’t really exist any more. Currently, both good and bad reviews (fair or unfair) are part of a plugin’s rating forever.

      • Max Foundry 3:02 pm on May 6, 2016 Permalink | Log in to Reply

        I agree with this David.

      • Ipstenu (Mika Epstein) 11:13 pm on May 9, 2016 Permalink | Log in to Reply

        The reviews reflect the growth and development of the plugin in both code and attitude. For now, they bear weight as a historical basis.

        Maybe one day we’ll have ‘reviews for this version’ like Apple does. That would be more fair than just age, since not all plugins change that much 🙂

        • David Anderson 10:09 am on May 13, 2016 Permalink | Log in to Reply

          Hi Mika,

          I wasn’t suggesting removing old reviews – I agree that there’s value in seeing the growth/development. The suggestion was that they stop affecting the star rating after a reasonable amount of time. This allows the star rating to better reflect the current plugin, rather than being dragged towards a historical average which doesn’t affect what users can actually download and use.


    • screamingdev 8:13 pm on May 7, 2016 Permalink | Log in to Reply

      Wow Mika Epstein. This phrase really catched me: “and any and all guideline violations will result in your plugin being removed”. Maybe we can get in touch because I am serving codebook.cc which does and will do a lot of checks for your guidelines on many plugins 😉 Please ping me via reply or Twitter @ScreamingDev. Cheers!

    • Ahmad Awais 12:28 am on June 3, 2016 Permalink | Log in to Reply

      Thanks Mika for this one. I didn’t know a few of those.

  • Ipstenu (Mika Epstein) 8:19 pm on April 27, 2016 Permalink |  

    Rewarding Vulnerability Finders 

    We don’t. We’re 100% volunteer driven, so when you tell us a plugin has a vulnerability, you don’t get anything more than a thank you and our undying affection. Yes, even if you’re that person who sent 45 reports one day.

    But. If you’re a bigger than average plugin (say Derpack size) this isn’t a really great way to find out about vulnerabilities. You’d really like it people could report these securely and in a way that would make them inspired to help more. You know. Money.

    Enter HackerOne – a free service.

    Here’s how it works in a nutshell. You make an account and tell people what you’re looking for. For example, the WP API. Their profile explains the scope (WP 3.9 and up) and they list (with links) everything related.

    If someone finds a security hole in the WP-API, they can log into the site and fill in a form explaining what the hack is, how to exploit it, and so on. The developers will review the report and, if they determines it’s valid, pay for the report.

    Some pages list how much the payout is, some don’t.

    You can search right now for ‘wordpress‘ in the directory and there are a handful of WP companies and individuals listed already. Hi, Automattic! Fancy seeing you here.

    If you’re a WordPress plugin or theme company, this could be a great way to get the community in on helping you plug those security holes.

    • Jeff Chandler 9:17 pm on April 27, 2016 Permalink | Log in to Reply

      Do you forward those reports to the plugin authors and let them take it from there?

      • Ipstenu (Mika Epstein) 10:02 pm on April 27, 2016 Permalink | Log in to Reply

        Yes, we forward them to the authors and, depending on the nature of the issue, we may close the plugin to prevent new installs. If it’s incredibly difficult to reproduce and requires a bunch of ‘IF you do X while on Y network…’ we may only inform.

    • J.D. Grimes 9:34 pm on April 27, 2016 Permalink | Log in to Reply

      I’ve been using HackerOne for one of my plugins for a while now, and as a developer who often finds security holes in other plugins, it would be much easier if those plugins were also using a platform like HackerOne so that I could report the vulnerabilities easier.

      The HackerOne platform is great, and the only complaint that I’d have is that sometimes you get a lot of low-quality reports (i.e., false positives). But other than that it is a great way to make it easier both for those reporting and those triaging vulnerabilities. Thanks to the plugins team for suggesting it to plugin authors.

  • Ipstenu (Mika Epstein) 3:41 pm on April 13, 2016 Permalink |  

    [Somewhat Resolved] Assets/Readmes not showing properly on Plugin Pages 

    1624 UTC – Tue 19 April

    This is MOSTLY resolved, but basically we’re going to be facing sync issues for a while until someone sorts out why they’re getting so behind. The best thing to do here is to WAIT and not push anything. The more you push, the longer the queue gets and slower it gets :/

    1541 UTC – Wed 13 April

    We are aware of an issue where your assets (banners etc) and readme information isn’t loading properly, and we are looking into it.

    Please DO NOT push your code multiple times! It’s like ringing a doorbell over and over. It doesn’t actually make things work better 😉

    As a general reminder, though, please try to keep your readme to under 10k. You can shuffle your changelog off to a separate file (chaneglog.txt) to keep things smaller. After all, no one really reads the 1.x version of your changelog from 6 years ago.

    In addition, if your plugin is very large, it’s okay to remove old versions from SVN. That will ensure processing and syncing is faster 🙂

    We will update this post with any information as we determine exactly what’s wrong.

    Update 1: One of the servers is running behind again. So please just be patient. Go for a run. Dance. Sing. It’ll catch up 🙂

    Update 2: Still running slow. There are moments where this will work fine, and then it will drag. Sorry.

compose new post
next post/next comment
previous post/previous comment
show/hide comments
go to top
go to login
show/hide help
shift + esc
Skip to toolbar