O que, por que e como fazer para criar um plug-in WordPress específico do site

120 ComentáriosDeixe uma resposta

1. Syed Balkhi says

   maio 9, 2024 em 2:24 pm

   Hey WPBeginner readers,
   Did you know you can win exciting prizes by commenting on WPBeginner?
   Every month, our top blog commenters will win HUGE rewards, including premium WordPress plugin licenses and cash prizes.
   You can get more details about the contest from here.
   Start sharing your thoughts below to stand a chance to win!

2. Stephanie says

   maio 16, 2016 em 10:55 am

   I’m getting the same error as Sonya above. Does anyone have a fix?

   Parse error: syntax error, unexpected T_LNUMBER in /home/statisu0/public_html/wp-content/plugins/statisticshowto-plugin/statisticshowto.com-plugin.php on line 10

   Responder

   • WPBeginner Support says

     maio 16, 2016 em 9:59 pm

     your plugin file name contains .com in it. It should be statisticshowto.php instead.

     Responder

     Administrador

3. Susan says

   abr 5, 2016 em 12:09 pm

   Hi again. I’ve been reading through all of the comments above and, while some show your answer and resolution to the problem, many don’t. So it’s hard for me to learn from how others resolved their problems! Anyway, here’s what I’m wondering: if by following the instructions in this post to create a folder within my “plugins” folder, how will I be able to see my new site-specific plugin file?
   For example, I followed the instructions to create a folder called susansinthegarden-plugin. Then I put my plugin code in a file called susansinthegarden-plugin.php. I can’t see the plugin when I go to plugins on my dashboard.
   Is this because the new plugin text file exists in a sub-folder under “plugins”? I can’t figure out what I’m missing but really need to resolve this. Is there anyone out there who can help me? Thanks so much!

   Responder

   • WPBeginner Support says

     abr 5, 2016 em 8:02 pm

     No. Please make sure that your plugin’s header area is properly formatted.

     Responder

     Administrador

     • emy says

       abr 20, 2017 em 5:37 pm

       Hi,
       What is a plugin header and how do I format it?

       Responder

       • WPBeginner Support says

         abr 24, 2017 em 5:04 pm

         Hey Emy,

         The plugin header is the part that tells WordPress that this file should be treated as a plugin. It also tells WordPress the name of the plugin, version, and other information.

         In the code shown above, the header part begins right after the first line and ends at line 5. It contains plugin’s title and description.

   • Susan says

     abr 6, 2016 em 12:04 pm

     OK, I resolved my program. Not being a code-writer, I didn’t realize that there was a separate header to wrap around the code I was borrowing. Duh. Thanks for your help.

     Responder

4. Susan says

   abr 4, 2016 em 10:23 pm

   I followed your instructions to create a folder under wp-content/plugins etc. and put the file containing the code into that folder but I can’t see my new plugin when I go to my dashboard and look under plugins. Did I miss a step? Thanks in advance for your help!

   Responder

5. Edgar Ramirez says

   mar 26, 2016 em 3:27 pm

   Hello

   I created the directory and the php file but i cannot see the plugin at all

   /wp-content/plugins/yoursitename-plugin/
   Open a blank file and save it as “yoursitename-plugin.php”

   dont see it on the dashboard plugin list and neither in the Plugin>editor

   Can you please help me

   Responder

6. Sonia Lacasse says

   mar 10, 2016 em 9:38 pm

   Never mind! Looks like I found the problem. Thanks for your awesome work!

   Responder

7. Sonia Lacasse says

   mar 10, 2016 em 9:32 pm

   When I try to activate the plugin, I get the following error message:

   Plugin could not be activated because it triggered a fatal error.
   Parse error: syntax error, unexpected ’06’ (T_LNUMBER) in /var/www/domain/wp-content/plugins/ETK-PLUGIN/ETK-PLUGIN.php on line 10

   Can you please help?

   Thanks!

   Responder

8. Catherine Argyros says

   fev 27, 2016 em 6:46 pm

   hi there, when i put this in the directory

   I received this error message

   The plugin generated 2 characters of unexpected output during activation. If you notice “headers already sent” messages, problems with syndication feeds or other issues, try deactivating or removing this plugin.

   but my plug in is activated….. please help me understand what is going on?
   thank you

   Responder

   • WPBeginner Support says

     fev 28, 2016 em 10:02 am

     Most probable cause for this error could be an empty space after the last ?> closing tag.

     Responder

     Administrador

     • error message says

       fev 28, 2016 em 3:56 pm

       wonderful, thats exactly what the problem was. Thank you for helping me create my first plugin!

       Responder

       • WPBeginner Support says

         mar 3, 2016 em 1:14 am

         Glad to help

9. xin a day says

   jan 27, 2016 em 3:39 am

   “All you have to do is create a new folder in the plugins directory. Example: /wp-content/plugins/yoursitename-plugin/
   Open a blank file and save it as “yoursitename-plugin.php”
   Put the following code in the file:”

   i hv few question on these .

   1. i can’t create a folder onthe plugin directory.
   2. where to open a blank file ?
   3. the plugin diretory cant install that file.

   thank you

   Responder

10. Sacha says

    jan 8, 2016 em 11:31 pm

    Awesome idea! I’ve always found functions.php a pain, so this method works great!

    Responder

11. Alan Shapiro says

    dez 29, 2015 em 1:07 am

    This is a really useful post–thank you! Perhaps someone else asked this and I just missed it in all the comments, but: will a site-specific plugin override a function that is in the theme’s functions.php? For instance, if there is a “remove_action” in the functions.php, will the same “add_action” in the plugin take precedence?

    Responder

    • WPBeginner Support says

      dez 29, 2015 em 7:55 pm

      Both functions.php file and site-specific plugin are treated as plugins. Functions.php file loads after plugins but they do not have precedence over eachother. This is why using the same function in both files can cause unexpected results. The best way to override pluggable code is by using hooks and filters.

      Responder

      Administrador

12. Robert Masters says

    nov 23, 2015 em 5:17 am

    I’m building a plugin at the moment for a multisite network and I need certain functionality available only in specific sites, so this is a perfect article for me right now.
    I have one question though…..how do I name the site plugin folder for a site that is created as a subdomain? Example: subdomain.mainsite.com would it be subdomain-mainsite-plugin or just subdomain-plugin?
    Hope this makes sense, question based on your tutorial.

    Responder

13. hans says

    set 25, 2015 em 2:03 pm

    very good. when you create a second instance don’t forget do give the “register and load” function an own name, like i did

    Responder

14. Eric Ellis says

    jun 9, 2015 em 1:12 pm

    That’s great. I always figured it was pretty simple. Thank you for the information.

    Responder

15. Jide says

    maio 29, 2015 em 4:08 am

    Nice one there. Kindly update the post to inform readers that after activating the plugin, they will have to click on the “edit” link on the plugins page, to add their codes.

    Most newbies might not know this…

    Responder

    • WPBeginner Support says

      maio 30, 2015 em 11:36 am

      Actually we do not recommend editing plugins and themes from WordPress admin area. Instead, we would recommend editing your plugins in a text editor via FTP client. This way in case of an error you would be able to quickly fix it without losing access to admin area for too long.

      Responder

      Administrador

16. Mark Holland says

    maio 5, 2015 em 11:41 am

    Thank you thank you thank you!! This has solved an issue that’s been puzzling me for weeks – and now solved in less than 1 minute.

    Can’t express how grateful I am for you sharing your knowledge – thanks again!

    Responder

17. Luca says

    abr 28, 2015 em 5:08 am

    Thank you for the advice! But now I’m confused: what’s the difference between this method and the plugin “Code Snippet”? Is the result the same? Or do they accomplish the same thing in a different way?

    Responder

18. Malcolm says

    abr 2, 2015 em 9:54 am

    Three years later this post is still giving – It’s changed the way I think about customising wordpress – Thank you!

    I tried this today and created a a site-specific-plugin with code to hide the wordpress menu bar for non-admins, and to add my latest post to a ‘Current issue’ menu item. Both worked perfectly.

    But the third snippet I added to the plugin failed to work. When I copied the code to the child theme’s functions.php it worked as expected.

    Can you explain why this would happen?

    I’m trying to modify the effect of the plugin “Restricted Site Access” by allowing access to more than a single page. The code I tried in my site specific plugin and the functions.php was:

    //
    add_filter( ‘restricted_site_access_is_restricted’, ‘my_restricted_check’ );
    function my_restricted_check( $is_restricted ) {
    global $wp;
    if (
    $wp->query_vars[‘pagename’] == ‘contact’ ||
    $wp->query_vars[‘pagename’] == ‘subscribe’ ||
    $wp->query_vars[‘name’] == ‘aplr-2013-volume-21-number-2’
    )
    $is_restricted = false;

    return $is_restricted;
    }

    Any advice or comment would be welcome. I’m confused!

    Responder

19. harklord says

    mar 14, 2015 em 9:32 pm

    after trying this. My site is opening blank… Please help.. Av tried deleting the files i created but still blank

    Responder

20. WPBeginner Staff says

    mar 1, 2015 em 11:10 pm

    Make sure that your stored the plugin’s php file in /wp-content/plugins/ folder and not in your theme directory.

    Responder

    • Mohammed Amine says

      mar 12, 2015 em 7:01 pm

      Fixed, actually it is necessary to add that php comment in the php file, or else it wont appear on the admin panel.
      That php comment is used to show the discription of the plugin in the admin panel.

      Responder

21. Paolo Bergomi says

    fev 28, 2015 em 8:18 am

    Hello,
    This is Paolo, i am building my website and theme with WP last edition 4.1.1.
    i Am trying to learn custom type fields and I found your website very useful. i hav ea issue, though: even if following this post i created the folder my theme plugin and with the related file .php you mentioned here, for the site specific plugin, copy all in localhost using WAMP server. i opened then my dashboard, went to plugins but my new plugin dont appear. what is going on? did i miss anything? thanks
    paolo

    Responder

22. WPBeginner Staff says

    jan 11, 2015 em 3:18 pm

    You can try and fit your modifications in site-specific plugin by using filters. However, since you had to edit specific files we doubt that all your edits can be implemented in a site-specific plugin using filters. In that case you should make those changes into a child theme. All your custom CSS should also go into your child theme’s stylesheet. You can also use your site-specific plugin to enqueue a custom stylesheet.

    Responder

23. Bas van der Linden says

    jan 9, 2015 em 9:13 am

    Hmm, looks like my last post went missing while registering for this annoying disqus plugin.

    Anyways:
    At first I’d like to thank you for sharing this information.

    Secondly I do have several questions regarding this post.

    1) Is it possible to also make site specific plugins for other .php’s where I’ve added some codes?
    Such as front-page.php post-page.php and post-archives.php

    2) Is it possible to do something like this for .css codes?
    I run genesis as framework(Parent theme) and a child-theme that I’ve downloaded.
    Now since there are no grand-child theme’s in wordpress I’ve made my alterations in the child-theme’s folder

    This includes a lot of different .css edits, Is there a way to make site specific .css files/plugins like this, so I can maintain the origional child-theme (and perform an update if any updates are released)?

    3) When I create a site-specific plugin to change the footer and activate it, I will see both the origional footer and my own footer on the site.
    Is there a way to go around this?

    My plugin looks like this:

    Once again thank you for sharing this information on site-specific plugins, and I hope to hear soon from you guys.

    Responder

24. Chelsey says

    jun 16, 2014 em 5:12 pm

    Thank you for your patience… I’m still trying to figure out how to ‘create a new folder to plugins directory’

    Responder

    • Rodney Lacambra says

      jun 27, 2014 em 5:14 am

      Hi Chelsey. Consider this guide:

      Go to “File Manager”. It will take you to “/public_html” directory. Click on “wp-content >> plugins” . This is where you will “create” a folder called “yoursitename-plugin”. After that, create a file using some text editor(notepad++), paste the code given above and save the file as “yoursitename-plugin.php”. Upload it to “yoursitename-plugin” folder and activate it in your wordpress admin area. Easy as that!

      Hope it helps you a lot.

      Regards,
      NomadTech

      Responder

      • Benjamin Mukasa says

        fev 23, 2015 em 4:35 pm

        This is a great post. I followed the instructions but the plugin is not appearing in my plugin list.

        Responder

        • Paolo Bergomi says

          fev 28, 2015 em 8:35 am

          me same..where did we make wrong? thanks in advance for any tips to solve this

25. WPBeginner Staff says

    jun 11, 2014 em 12:09 am

    yes you can use it for multiple functions.

    Responder

26. WPBeginner Staff says

    jun 8, 2014 em 11:16 pm

    Your code seems to be correct. Here is what you can do:

    Make sure you have saved the plugin file in the /wp-content/plugins/ directory.

    Make sure that your plugin file name is correct. We recommend using yoursitename.php format. For example if your domain name is black-circles then your plugin file name should be black-circles.php

    Responder

    • SteveMTNO says

      jun 9, 2014 em 6:48 pm

      I originally had the plugin file (bc-plugin.php) in its own directory called blackcircles/wp-content/plugins/bc-plugins. That didn’t work.

      Then I tried moving the bc-plugin.php file from that folder to the blackcircles/wp-content/plugins folder. Still doesn’t show up in my admin panel.

      Do I have to “enable” it first before it shows up or something?

      Confused….

      Responder

      • WPBeginner Staff says

        jun 9, 2014 em 7:49 pm

        If the file is correctly placed in your plugins folder then you will see it in your WordPress admin area under Plugins. If you see your plugin there, then you will have to click on the activate link below the file to activate the plugin.

        Did you try renaming the file to something else?

        Responder

        • SteveMTNO says

          jun 9, 2014 em 10:22 pm

          Tried renaming it 3 times – none of them show up….

          I must be doing something wrong (or not doing something that I should be doing)…

        • SteveMTNO says

          jun 9, 2014 em 10:30 pm

          So can I use this one site-specific plugin for multiple functions, or is it best to do something similar to this for each one?

    • Michael Cuomo says

      set 24, 2014 em 1:49 pm

      I’m having a similar issue with mine. I’ve created a site specific plugin to create a custom content type, but the custom content type is not showing up in my admin panel underneath pages like it should.

      Responder

27. SteveMTNO says

    jun 8, 2014 em 4:46 pm

    I posted this yesterday, but it seems to have vanished…

    Anyway, I followed the instructions above, but can’t see the site-specific plugin in my admin panel.

    Here’s a link to my code:

    http://pastebin.com/fbeGr8gh

    Responder

28. SteveMTNO says

    jun 7, 2014 em 11:33 pm

    I followed all of the instructions above, but my plugin doesn’t appear in my admin panel.

    Here’s my pastebin link:

    http://pastebin.com/fbeGr8gh

    Thanks!

    SteveMTNO

    Responder

29. WPBeginner Staff says

    jun 1, 2014 em 9:53 pm

    There were spaces in your PHP opening and close tags
    is the closing tag there is no space between them. See the corrected version here and compare it with your code. Hope this helps
    http://pastebin.com/JJ7WfpUR

    Responder

30. UgochukwuEmmanuelAgbams says

    maio 31, 2014 em 2:05 pm

    i got this message while trying to install it.

    The package could not be installed. No valid plugins were found.

    Responder

    • WPBeginner Staff says

      maio 31, 2014 em 3:58 pm

      This usually happens when your plugin’s header is not valid. Please paste your code in pastebin.org and paste the link in a comment.

      Responder

      • UgochukwuEmmanuelAgbams says

        jun 1, 2014 em 1:34 pm

        thank you for your response. here is the link of the code on pastebin http://pastebin.com/vksUVmCa

        Responder

31. Rajesh Ghadge says

    maio 12, 2014 em 3:19 am

    Very useful aticle it can help any novice in the designing field thanks a million

    Responder

32. Joe Librizzi says

    abr 2, 2014 em 2:04 pm

    This is a fantastic post, thanks! Quick question – could this same method be used to modify an existing plugin, sort of like you can use a child theme to modify existing CSS? I know you can modify a plugin directly, but I’m trying to avoid losing the modifications when the plugin is updated.

    Responder

    • WPBeginner Support says

      abr 2, 2014 em 3:51 pm

      Joe, yes this can be used to modify plugins. Another way to modify plugins safely is by changing their header information. You can use the header shown in the above code as an starting point.

      Responder

      Administrador

33. Correen says

    mar 29, 2014 em 7:24 pm

    Successful! Thanks for showing me how to get this accomplished.

    Responder

34. Chris says

    mar 22, 2014 em 1:01 am

    I am new at this and learning as I go but I am confused as in the instructions both the singular and plural version of plugin was used. Am I to create one plugin file to put all snippets into or seperate plugins for each code/snippet/task?

    For example – I found this article by gooling for how to create more than one custom post type. Would I put each custom post type into a seperate plugin?

    Or could the code for custom post type go into the same plugin file as theme support for post thumbnails as I have it currently in my functions.php?

    Responder

    • WPBeginner Support says

      mar 23, 2014 em 4:44 pm

      The code for all your custom post types can go in one plugin.

      Responder

      Administrador

35. Shemul says

    dez 9, 2013 em 1:14 am

    what about custom.css? can we made something like this. it is good to have child theme then.

    Responder

    • WPBeginner Support says

      dez 9, 2013 em 3:18 pm

      A child theme is always recommended but there is a fine line as to how much functionality themes should have and what functionality should fall under plugin domain.

      Responder

      Administrador

36. Sussie T says

    nov 21, 2013 em 7:48 am

    Great article. I did this, and it was very easy. But now I am taking this further and made another file to my plugin for the site specific widgets. My first widget.
    Have fully created 2 widgets, but only the last one is showing in admin. I guess is something with hooks or register_widget, but i cant crack this one.
    Seams like an easy error to solve, if you got the experience. But for a beginner Google is not helping at all.

    Resume of my widget file:

    widget script
    widget script

    a function witch registers my 2 widgets

    Outside this function is add_action(widgets_init, name of above function)

    Please help

    Responder

37. paul says

    ago 9, 2013 em 11:07 am

    so when i read
    Paste this code in your theme’s functions.php file or your site-specific plugin
    i just create this site-specific plugin and add code to this rather than my functions.php

    Responder

38. Duy Dang says

    ago 2, 2013 em 11:34 pm

    Thank you so much, it’s very useful!

    Responder

39. Junior Godoi says

    maio 30, 2013 em 12:39 pm

    And what about mu-plugins folder?

    Responder

40. Max says

    mar 1, 2013 em 11:11 am

    Your site is god sent! I’ve literally been going through each of your tutorials, making a list of all the one’s I’m going to be implementing on my new site I’m developing. Some things you have covered, I would of never even have thought about, but now I am definitely dong them. Thanks for all the information you provide with your blog.

    Responder

    • Editorial Staff says

      mar 2, 2013 em 6:55 am

      Thanks a lot for the kind words Max. Let us know if you have any questions or suggestions by using our contact form.

      Responder

      Administrador

41. Hamza Aid says

    jan 15, 2013 em 6:41 pm

    I’m managing a heavy loaded WP portal, and I found many problem when performing modifications because the developer made the same mistake, and put all the code (functions, etc..) in functions.php

    Now, I re-designed the portal, and separated many functions to site specific plugins. Thanks for this great post

    Responder

42. Mattia Frigeri says

    jan 9, 2013 em 5:17 am

    It must be said.
    This is a superlative post.

    Responder

43. Greg says

    set 20, 2012 em 2:06 am

    I am not sure what it is I am doing wrong. I have done exactly as you have said and I can not get it to show in my WordPress Plugins.

    I have FTP’s it in, zipped it and tried to upload it via the admin and activating it (wp actually recognized it, and when I clicked the “Activate” link …. nada. It is like it was never there and when I FTP’d back in, it wasn’t there either.

    So I am trying Brent Logan’s plugin he mentioned (Code Snippets).

    Hopefully I’ll have better luck.
    I appreciate the article though. Thanks.

    (I am not that new to this. I have played with WordPress and Drupal and their plugins quite a bit. I am not sure why it is that I am having so much trouble with it.)

    comment would be appreciated — and I will keep reading here as well.

    Responder

    • Editorial Staff says

      set 20, 2012 em 5:29 am

      That is actually very weird. Even when you FTP this, the file goes away from the folder?

      Responder

      Administrador

44. Billy Patton says

    jul 30, 2012 em 2:32 pm

    …I tried to keep this method a secret. hahaha

    Responder

45. Brent Logan says

    jun 28, 2012 em 8:42 pm

    I was doing this until I found the Code Snippets plugin. This plugin makes it easy to add multiple snippets, with a place for easy descriptions, and then activate or deactivate the snippets individually. Quite slick.

    Responder

46. b.nijhoff says

    dez 5, 2011 em 3:45 am

    I always thought it was really hard but after seeing this I now know I could do it to. Thanks for sharing this, all your articles have been really helpful so far. Keep on the good work!

    Responder

47. ericsavina says

    dez 4, 2011 em 10:58 pm

    What I don’t get is that I keep reading everywhere that I should modify the functions.php instead of adding plugins. It is supposed to make the site faster. So, who should I trust? The idea of having a separate file for a the changes I’m making to the funtions.php file seems very interesting. At least, I would be able to easily update my theme without having to check every time the customs changes I made.

    Responder

    • CreativeBoulder says

      dez 4, 2011 em 11:10 pm

      @ericsavina From what I have been gathering, and I’ve been doing this for a good while, is that the speed and performance using a ton of PHP in your functions.php versus additional plugins that use the same code– I was not able to find much of a difference in speed. Now, anybody correct me if I am wrong and if anybody has different performance comparisons.

      At this point, I’m using my functions.php file as I outlined to keep my functions organized along with a few custom plugins that I have designed with multi-site purpose. Hope that all makes sense.

      Responder

      • ericsavina says

        dez 4, 2011 em 11:47 pm

        @CreativeBoulder Thanks for your answer. I will create this plugin and check if there are any differences in loading time.

        Responder

        • CreativeBoulder says

          dez 4, 2011 em 11:53 pm

          @ericsavina Not a problem. Please let me know if you find out some different results than I did? Google Chromes Web Developer Tools have been more than helpful in performance and load-time and same with http://loads.in/.

48. CreativeBoulder says

    dez 2, 2011 em 7:27 pm

    I fully understand the reasoning behind this setup. I really like the concept. When WordPress Upgrades, then you might need to upgrade some of your functions instead of having to navigate a possibly unorganized file structure. I was thinking about this about a week ago when working on a client site and did this with my functions.php:

    <?php

    // Require Administrator Functions/Classes

    require_once(“lib/php-classes/wp-admin-functions.php”);

    // require Custom WP Plugins (By BusinessName)

    require_once(“lib/php-classes/wp-general-functionality.php”);

    require_once(“lib/php-classes/wp-register-sidebars.php”);

    require_once(“lib/php-classes/wp-register-menus.php”);

    require_once(“lib/php-classes/wp-register-customposts.php”);

    require_once(“lib/php-classes/wp-load-jslibs.php”);

    require_once(“lib/php-classes/wp-breadcrumbs.php”);

    require_once(“lib/php-classes/wp-shortcodes.php”);

    ?>

    Which allowed me to basically work on certain aspects and know where certain custom widgets or shortcodes were instead of a huge functions.php file. What do you think? Which method works better for you?

    Responder

    • affanruslan says

      dez 5, 2011 em 6:03 pm

      @CreativeBoulder No, this function.php file is within your theme file, not the core wordpress file

      Responder

      • CreativeBoulder says

        dez 5, 2011 em 7:05 pm

        @affanruslan I fully understand what the concept here is. Thanks for the reply. The goal of creating a Site Specific Plugin is to keep your functions, widgets, short-codes (etc) separate so that they are easier to work with and more organized. My concept of using your Theme Specific functions.php and “modularizing” it into separate files is just as easy to stay organized. That’s what I was getting at. I appreciated this post. =)

        Responder

49. tomdana says

    dez 2, 2011 em 11:17 am

    At first I was confused on what this Post was about. Once I read it I realized the usefulness of doing exactly what you suggest. I named my plugin “site-specific-functions”. Thanks for the information and all you do.

    Responder

50. tomdana says

    dez 2, 2011 em 11:17 am

    At first I was confused on what this Post was about. Once I read it I realized the usefulness of doing exactly what you suggest. I named my plugin “site-specific-functions”. Thanks for the information and all you do.

    Responder

51. fergusonsarah says

    dez 2, 2011 em 9:27 am

    It’s really great to read such a valuable blog post here, thanks for sharing.

    Responder