Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Copa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

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

Nota editorial: Ganhamos uma comissão de links de parceiros no WPBeginner. As comissões não afetam as opiniões ou avaliações de nossos editores. Saiba mais sobre Processo editorial.

Deseja adicionar um plug-in específico do site ao seu site WordPress?

Um plug-in específico do site permite que você adicione facilmente trechos de código ao seu site WordPress sem depender do seu tema.

Neste artigo, explicaremos como criar um plug-in do WordPress específico para o site e por que ele é importante.

Site Specific WordPress Plugin

O que é um plug-in WordPress específico do site?

Um plugin WordPress específico do site é um plugin autônomo que pode ser usado para adicionar todos os trechos de personalização que não dependem do tema.

Ao trabalhar no seu site, você encontrará com frequência tutoriais do WordPress solicitando que você adicione código ao arquivo functions.php do seu tema ou a um plug-in específico do site.

O WordPress não vem com um plug-in específico para o site. Você precisará criar o seu próprio, instalá-lo e ativá-lo.

Por que criar um plug-in do WordPress específico para o site?

Como mencionamos anteriormente, você encontrará com frequência tutoriais que mostram alguns códigos que podem ser adicionados ao arquivo functions.php do seu tema ou a um plug-in específico do site.

Esses códigos personalizados podem ser usados para adicionar novos tipos de postagem, taxonomias, códigos de acesso e muitos outros recursos para aprimorar seu site.

Se você adicionar o código personalizado ao arquivo de funções do seu tema, ele desaparecerá se você atualizar ou trocar de tema.

Você pode criar um tema filho e usar o arquivo de funções do tema filho para salvar seu código. No entanto, seu código ainda desaparecerá se você trocar de tema.

Um plug-in do WordPress específico do site permite que você adicione facilmente trechos de código personalizados ao seu site do WordPress e garanta que eles sejam independentes do tema. É um plug-in autônomo do WordPress, o que significa que não depende do seu tema e que você pode atualizar ou trocar de tema.

Dito isso, vamos dar uma olhada em como adicionar facilmente o código personalizado usando um plug-in específico do site. Mostraremos duas maneiras de fazer isso, e você pode escolher o método que funciona melhor para você (dica: o método nº 2 é mais fácil para iniciantes).

Método 1: Criar manualmente um plug-in do WordPress específico do site

Sabemos que isso pode parecer um pouco nerd para os iniciantes, mas tentaremos simplificar ao máximo para você.

Primeiro, você precisa criar uma nova pasta na área de trabalho e dar a ela o nome do seu site. Por exemplo: mywebsite-plugin.

Creating your site-specific plugin folder

Agora, abra um editor de texto simples em seu computador, como o Notepad ou o TextEdit.

Você precisa criar um novo arquivo e salvá-lo como mywebsite-plugin.php na pasta do plugin em sua área de trabalho.

Creating the plugin file for your site-specific plugin

Seu arquivo de plug-in precisa de um código de cabeçalho específico para que o WordPress possa reconhecê-lo como um plug-in. Vá em frente e adicione o seguinte código ao seu arquivo mywebsite-plugin.php:

<?php
/*
Plugin Name: Site Plugin for example.com
Description: Site specific code changes for example.com
*/
/* Start Adding Functions Below this Line */

/* Stop Adding Functions Below this Line */
?>

Você pode substituir example.com por seu próprio nome de domínio. Depois de fazer isso, seu plug-in específico do site estará pronto.

Há duas maneiras de carregar o plug-in específico do site em seu site. Você pode carregá-lo por meio do painel de administração do WordPress ou usar o FTP.

1. Instale o plug-in específico do site na área de administração do WordPress (recomendado)

Esse método é mais fácil e recomendado para todos os usuários.

Primeiro, você precisa criar um arquivo zip da pasta do plug-in específico do seu site.

Os usuários do Windows podem simplesmente clicar com o botão direito do mouse na pasta do plug-in e selecionar Send to ” Compressed (zip) folder.

Creating zip file in Windows

Os usuários de Mac precisam clicar com o botão direito do mouse.

Em seguida, selecione “Compress mywebsite-plugin”.

Creating a zip folder on Mac

Depois de obter o arquivo zip do plug-in, vá para a página Plugins ” Add New (Adicionar novo ) na área de administração do WordPress.

Em seguida, clique no botão “Upload Plugin” na parte superior.

upload plugin

Em seguida, clique no botão “Choose File” (Escolher arquivo) para selecionar o arquivo zip criado anteriormente e, em seguida, clique no botão “Install Now” (Instalar agora).

O WordPress fará o upload e instalará o plug-in para você. Depois que ele for carregado, você precisará clicar no botão “Ativar plug-in” para começar a usar o plug-in específico do seu site.

Activate plugin

2. Faça upload do plug-in do WordPress específico do seu site via FTP

Para esse método, não é necessário criar um arquivo zip. Você fará o upload do plug-in via FTP.

Primeiro, você precisará se conectar ao seu site usando um cliente FTP.

Depois de conectado, vá para a pasta /wp-content/plugins/ na coluna do site remoto. Em seguida, você precisa selecionar a pasta de plug-ins específica do site e carregá-la em seu site.

Uploading plugin via FTP

Seu cliente FTP agora transferirá a pasta do plugin específico do site para o site do WordPress. Isso instalará o plug-in em seu site.

No entanto, você ainda precisará ativar o plug-in para começar a usá-lo. Você pode fazer isso acessando a página “Plugins” na área de administração do WordPress e clicando no link “Ativar” abaixo do plug-in específico do site.

Activate plugin

Isso é tudo. Seu plug-in específico do site está pronto para ser usado.

Adição de snippets de código personalizados ao seu plug-in específico do site

Há duas maneiras de editar seu plug-in e adicionar trechos de código personalizados a ele.

O primeiro método é fazer isso por meio da área de administração do WordPress. Você pode ir para a página Plugins ” Editor.

Você verá uma mensagem de aviso e precisará clicar no botão “I understand” (Eu entendo) para continuar. Como alternativa, se quiser uma maneira mais segura de editar os arquivos, pule para o segundo método abaixo.

Heads up warning in the plugin editor tool

Em seguida, você precisa selecionar o plug-in específico do site no menu suspenso denominado “Select plugin to edit” (Selecionar plug-in para editar).

O editor carregará o arquivo do plug-in e você poderá adicionar trechos de código a ele.

Select a plugin to edit in the plugin file editor tool

Quando terminar, clique no botão “Update File” (Atualizar arquivo) para salvar suas alterações.

Se houver algo faltando em seu código ou se houver a possibilidade de danificar seu site, o editor de plug-ins desfará automaticamente suas alterações.

No entanto, se o editor falhar e você vir a tela branca da morte, poderá usar o FTP para editar o arquivo do plug-in e desfazer essas alterações.

O segundo método é editar diretamente o arquivo do plug-in usando FTP. Basta acessar a pasta do plug-in usando seu cliente FTP. Clique com o botão direito do mouse no arquivo do plug-in e selecione “View/Edit” (Exibir/Editar).

Editing plugin file via FTP

Você também pode fazer o download do arquivo do plug-in em seu computador, editá-lo e carregá-lo novamente.

Método 2: Adicionar código personalizado usando o WPCode (recomendado)

Esse método é muito mais simples e oferece uma maneira melhor de gerenciar seus trechos de código individuais no WordPress usando o WPCode.

A primeira coisa que você precisa fazer é instalar e ativar o plug-in gratuito do WPCode em seu site. Para obter mais detalhes, consulte nosso guia passo a passo sobre como instalar um plug-in do WordPress.

Após a ativação, o plug-in adicionará um novo item de menu denominado “Code Snippets” ao menu de administração do WordPress. Ao clicar nele, você será levado a uma página onde poderá gerenciar todos os seus códigos personalizados.

Para adicionar seu primeiro trecho de código, clique no botão “Add New” (Adicionar novo).

Click the Add New Button to Add Your First Custom Code Snippet in WordPress

Isso o levará à página “Add Snippet”. Aqui, você pode escolher um trecho de código da biblioteca predefinida ou adicionar seu código personalizado.

Para adicionar o código personalizado, navegue até a opção “Add Your Custom Code (New Snippet)” (Adicionar seu código personalizado (novo snippet)) e clique no botão “Use snippet” (Usar snippet).

Add your new custom code snippet in WPCode

Agora, você pode inserir um título para seu snippet de código personalizado. Pode ser qualquer coisa que ajude você a identificar o código.

Depois disso, você pode ir em frente e colar seu snippet de código na caixa de código. Você também precisa selecionar o tipo “PHP Snippet” na lista suspensa “Code Type” (Tipo de código) à direita.

Adding custom code

Você também pode adicionar notas ao código na seção “Informações básicas”.

Você deve usar essa área para escrever o que esse código faz, onde o encontrou e por que o está adicionando ao seu site. Isso ajudará o “futuro você” a lembrar por que o “passado você” adicionou esse código.

Add notes and tags to identify and organize your code snippets

Você também tem a opção de atribuir tags aos seus trechos de código, o que pode ajudar a organizar os trechos de código por tópico e funcionalidade.

O plug-in também permite que você selecione como deseja executar o trecho de código. Na seção “Insertion” (Inserção), você pode selecionar o método “Auto Insert” (Inserção automática) para inserir e executar automaticamente o código no seu site.

Você pode escolher entre as opções da área de administração, front-end ou em qualquer lugar. Se você não tiver certeza, mantenha a opção padrão “Run Everywhere”.

Pick the insertion method for your custom code snippet

Ou você pode escolher o método “Shortcode”. Com esse método, o snippet não é inserido automaticamente. Depois de salvar o snippet, você receberá um shortcode que poderá inserir manualmente em qualquer lugar do seu site.

Você também pode usar a seção “Lógica condicional inteligente” para mostrar ou ocultar trechos inseridos automaticamente com base em um conjunto de regras.

Use smart conditional logic to decide when snippets should load

Por exemplo, você pode carregar trechos de código somente para usuários conectados, carregar trechos de código PHP somente em URLs de páginas específicas, mostrar trechos de código com base no tipo de página e muito mais.

Por fim, você pode alternar a chave de “Inativo” para “Ativo” e, em seguida, clicar no botão “Salvar snippet”.

Save and activate your custom code snippet

Se você quiser salvar o snippet de código sem ativá-lo, clique apenas no botão “Save Snippet”.

Depois de salvar e ativar um snippet de código, ele entrará em vigor automaticamente em seu site, se esse for o método de inserção escolhido.

Para obter mais detalhes, consulte nosso guia sobre como adicionar facilmente snippets de código personalizados no WordPress.

Esperamos que este artigo tenha ajudado você a saber por que e como criar um plugin WordPress específico para o site. Talvez você também queira ver nossa lista de dicas úteis sobre arquivos de funções e os hacks mais procurados do WordPress para usar melhor seu plug-in específico do site.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Divulgação: Nosso conteúdo é apoiado pelo leitor. Isso significa que, se você clicar em alguns de nossos links, poderemos receber uma comissão. Veja como o WPBeginner é financiado, por que isso é importante e como você pode nos apoiar. Aqui está nosso processo editorial.

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

O kit de ferramentas definitivo WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Reader Interactions

120 ComentáriosDeixe uma resposta

  1. Syed Balkhi says

    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. BSubra says

    Is it possible to add code snippets like Google Analytics Code, Adsense code in Site Specific Pliugin. Or only possible to add codes we generally put in functions.php file.

    I mean, is it possible to add codes in site-specific plugin what we generally put in Header.php file.

    • WPBeginner Support says

      You can do that if you would like, you can also use the insert headers and footers plugin.

      Administrador

  3. Bola Oussou says

    hi
    Thanks for this tuto
    however is there a way to make this plugging(not to be visible) not in plugging list and also in a specific folder (not wp-content folder) ?

    Thanls

    • Tor-Bjorn Fjellner says

      Actually yes, there is:
      Instead of placing the plugin in …/wp-content/plugins/ you put it in …/wp-content/mu-plugins/ (You may have to create that directory, if it’s not there yet.

      Plugins that are placed in mu-plugins are ALWAYS run, so the only way to deactivate a MU plugin (MU currently is construed as “must use”) is to delete it (or remain the directly mu-plugins to something else…).

  4. Judith says

    Hi I tried to do the Site-specific plugin, but it is not working, I get this message “The package could not be installed. No valid plugins were found.

    Plugin installation failed.”
    What do I do?

    • WPBeginner Support says

      Hi Judith,

      This usually means that the plugin header information is incorrect. You can try again and make sure that your plugin header is exactly in the format displayed in the tutorial.

      Administrador

      • Jonathan Manheim says

        I get this same error. I have tried maybe 10 times. Uploaded through admin and on FTP. Cannot get it to upload. I am using TextEditor to paste the code. Notice several things you don’t mention in the post that I wonder could be an issue. First, won’t let me save the file as .php. I have to save it as .php.rtf OR .rtf then go back and rename the file after it is saved.
        Second, not sure what you mean by making sure the format for the plugin header is exactly the same. Should the line number be in there? If so, I can’t get that to work. If I copy and paste with the line numbers, the green vertical line doesn’t show up and there is no space between the line numbers and the code. Or am I supposed to just copy the code (without the line numbers)? Either way, I’ve tried everything I can with my current Textedit application and it will not work.
        Any ideas? I can send you screen shots of exactly what I have if you would like

        • WPBeginner Support says

          Hi Jonathan,

          You will need to save file as .php. Please use a different text editor on Windows you can use Notepad or download Notepad++. On Mac, you can use TextEdit or download and install TextWrangler.

          You don’t need to copy and paste line numbers.

        • Kacper says

          In my case the issue was that the file had Unicode encoding. Changing it to ANSI fixed the issue.

  5. Ikram says

    Hi,
    Good day!
    Would like to know how to set a white paper in my blog post article to download it with add email address from the visitor.
    Thanks, Ikram

  6. Alain Fradette says

    Great info! Thanks so much. I have been using WordPress for years and this little gem made it so much easier!

  7. Abhijeet says

    I have edited some code in Style.css . Will it be overwritten if i update a theme?
    is it possible to create style css file in this site specific plugin?

  8. dave says

    White screen on publishing pages.
    The code works to show child pages on a parent page using the shortcode however I am getting white screen. Anyone know why?

  9. Tommy says

    The plugin generated 3 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.

  10. Saurin says

    I believe best approach to add custom code to site is child theme. No matter if we need to customize theme or not. I mad a practice to always use child theme even if there is no customization. This habit saved my time & effort many times. I dont think it is good to create extra plugin for such customization.

    I believe in minimum use of plugin no matter how simple you created one.

  11. Jason says

    Which is better, site-specific plugin or Child Theme? or both?

    I need to create a custom post type to add some major functionality to my site so is the plugin better or the child theme and its functions.php?

    Thanks!

    • Josh says

      The thing is, is that you’re creating the plug-in yourself, using the functions the same exact way. So the answer to your question would be that neither is better, because you should be using them WITH each other.

  12. Vickey says

    How would I create a create a new plugin directory in Azure? I have WordPress running on Azure using MS SQL Server, which I activated using Project NAMI.

  13. vishal says

    not working on multisite with publisher theme can you help me this is my site and also tell me how can i remove featured image inside the post not from front page latest post

  14. Nadia Khan says

    Hi there,
    You WP Beginners are rock. and I want to thank you for your Struggles for us.
    Now come to the point. I have installed an theme and in that theme, there is an function that is showing wp toolbar for guests, I have tried so many times to find this function in theme files to remove this, but i can’t. So please help me to remove that toolbar, that is showing to every visitor with wordpress logo and wordpress’s own link to their website. Screen Shot is attached.

  15. Manuel says

    Does something like this work for plugins too? Im finding that I am making a few changes to plugins that I add to my site….many times deleting certain lines of code I dont want. I’m assuming that after I update that plugin, all my changes will be erased. How can I avoid this?

  16. Elizabeth says

    Hi, thanks for the post. I’m getting an error when I activate the plugin for some reason:

    Parse error: syntax error, unexpected ‘*’, expecting identifier (T_STRING) on line 9

    Any ideas what I’ve done wrong?

    Thanks!

    • WPBeginner Support says

      Hi Elizabeth,

      There is an unexpected asterisk sign in the code on line 9 which is blocking the php script. Edit the file again and copy the code exactly as it is shown above. Make sure that you don’t copy line numbers in the code click on the Copy button at the top right corner of the code snippet box

      .

      Administrador

  17. Steven Denger says

    I tried naming the new folder as you did in the example but I got an error that said something in the way of you cannot use a name like this. This Instruction may be helpful to some – but it is very difficult and confusing to me and does not help at all. As I said – you need to explain this down to the fine details or otherwise these tutorals will not help. The name of this site is wp BEGINNER – and that is what I am. You project these tutorals to the more experienced.

    I guess I will have to start going elswhere to get beginners instructiions because, most of time, wp beginner is not helpful – it is more like a techs only club.

  18. Steven Denger says

    How do you get to the /wp-content/plugins/yoursitename-plugin/ in wordpress and upload a file there? I am lost on the first line of instruction. You guys always assume that we know these things in your instructions but they are not clear enough.

    I went to cpanel and opened up the wpcontent > plugins – and it shows a list of plugins – but I am lost from this point. How do I go about uploading a file in here? I am a beginner – and you guys seem to always explain things like your instructing experienced techs. I am not but I go to WP Beginner to try to learn. It is usually difficult to follow your instructions and I end up having to go somewhere else in google search to find things explained down to a beginners level.
    If you want to be more helpful try breaking things down a little more simple.

    • Manuel says

      Hey Steven,

      I know the feeling! I’m far from a expert with wordpress and I pretty much live on google searches and this site trying to learn. I know a little bit and was able to get this to work. Send me your email and I’ll send you the steps with screenshots. I havent tested putting actual code into the plugin so we’ll see if that works….but I was able to see the newly created plugin on my admin page

  19. JoAnn Chateau says

    Thank you for the great advice and simple how-to instructions. I easily created a Site-Specific WordPress Plugin for my site and enabled shortcodes for widgets. Now I have less worry when changing themes, and I didn’t need to install another plugin. Again, thanks!

  20. george says

    hi i followed the instruction on how to make a site plugin for my site. ive uploaded it but cant see it in my list of plugins.

    any ideas why?

  21. Dawn says

    I cannot find where the folders live in the plug in directory. I tried searching for: /wp-content/plugins/yoursitename-plugin/ (with my site name).

  22. Kara says

    Never mind, I figured it out and got it activated. My hosting server was acting up, must have timed out or something…cheers!

  23. Kara says

    I followed your instructions but i don’t know how to activate it. It doesn’t show in my list of plugind in my wp-admin. Can you help?

Deixe um comentário para Alan Shapiro Cancelar resposta

Obrigado por deixar um comentário. Lembre-se de que todos os comentários são moderados de acordo com nossos política de comentários, e seu endereço de e-mail NÃO será publicado. NÃO use palavras-chave no campo do nome. Vamos ter uma conversa pessoal e significativa.