---
title: "Plug in de widget: Como criar um em 5 passos"
description: "Um plug in de widget para WordPress encapsula um bloco reutilizável (formulário, banner, lista de posts) num arquivo PHP que você ativa em qualquer."
url: https://full.services/plug-in-de-widget/
date: 2026-06-27
author: "Clayton Margiotti"
---
# Plug in de widget: Como criar um em 5 passos
Um **plug in de widget** é um plugin que registra um componente próprio na área de widgets do WordPress estendendo a classe WP_Widget. Segundo o [W3Techs](https://w3techs.com/technologies/details/cm-wordpress) (2026), o WordPress roda 41,5% de todos os sites da web. A classe exige 4 métodos: widget(), form(), update() e __construct(). Empacotar como plugin evita reescrever o código a cada troca de tema.
Um plug in de widget para WordPress encapsula um bloco reutilizável (formulário, banner, lista de posts) num arquivo PHP que você ativa em qualquer site, sem colar código no tema. A vantagem operacional é direta: ao estender a classe WP_Widget num plugin, o componente sobrevive à troca de tema e às atualizações, algo que o snippet no functions.php nunca garante. Na FULL, a gente vê no suporte que widgets perdidos após mudança de tema são uma das causas mais comuns de "sumiu o conteúdo da barra lateral". Este tutorial mostra a estrutura mínima, o registro no hook correto e o empacotamento distribuível. Para entender onde o componente aparece, vale revisar antes [como adicionar e usar widgets no WordPress](https://full.services/como-adicionar-e-usar-widgets-no-wordpress/).
---
## O que é um plug in de widget: Definição operacional
Um plug in de widget é um plugin WordPress que registra uma classe estendendo WP_Widget, tornando o componente disponível em Aparência > Widgets. A diferença para um widget colado no tema está no escopo: 1 plugin ativado funciona em qualquer tema, enquanto o código no functions.php morre quando você troca o template.
Segundo a documentação oficial em [WordPress Developer Docs](https://developer.wordpress.org/reference/classes/wp_widget/), a classe precisa sobrescrever ao menos o método widget() para renderizar. Em sites com 3 ou mais ambientes (produção, homologação, cliente), o formato plugin reduz o retrabalho de manutenção a quase zero, porque o mesmo arquivo .zip sobe em todos. É essa portabilidade que separa o componente profissional do gambiarra preso ao tema.
Plug in de widget: classe WP_Widget versus bloco Gutenberg
Abordagem
Quando usar
Limitação técnica
Classe WP_Widget
Temas clássicos com barra lateral e widget areas
Editor não visual; configuração via formulário PHP
Bloco Gutenberg
Temas de bloco (FSE) e editor de site
Exige build com JavaScript e Block API
Widget Elementor
Sites construídos no Elementor PRO
Dependente do construtor; não é nativo do core
---
## Por que empacotar o widget como plugin em vez do tema
Empacotar o widget como plugin resolve o problema de portabilidade que afeta 100% dos widgets colados no functions.php: ao trocar de tema, o componente desaparece. O [W3Techs](https://w3techs.com/technologies/details/cm-wordpress) registra que o WordPress está em 41,5% dos sites da web, e boa parte deles troca de tema ao menos uma vez na vida útil.
Um plugin é independente do tema ativo, então o widget permanece registrado mesmo após a mudança. A gente vê no suporte da FULL (150 mil sites conectados) que a maioria dos chamados de "widget sumiu" vem exatamente de código preso ao tema antigo. Há um segundo ganho: o plugin tem cabeçalho próprio, número de versão e pode ser desativado sem editar arquivo nenhum. Esse padrão de empacotar reusos aparece também na lista de [melhores plugins de personalização para WordPress](https://full.services/melhores-plugins-de-personalizacao-para-wordpress/).
---
## Estrutura mínima de um plug in de widget
A estrutura mínima de um plug in de widget tem 2 partes: o cabeçalho do plugin (comentário PHP com Nome, Versão e Autor) e uma classe que estende WP_Widget com 4 métodos. Um arquivo único de cerca de 60 linhas já entrega um widget funcional e instalável.
Segundo as [WordPress Developer Docs](https://developer.wordpress.org/reference/classes/wp_widget/), os métodos são __construct() (define ID e nome), widget() (imprime o conteúdo no front-end), form() (mostra o formulário no painel) e update() (salva e sanitiza os campos). Sem o método widget() sobrescrito, o WordPress não renderiza nada. A pasta segue o padrão `meu-widget/meu-widget.php`, e o cabeçalho no topo é o que faz o WordPress reconhecer o pacote. Esse mesmo molde serve de base para qualquer um dos [35 melhores plugins de widget do WordPress](https://full.services/35-melhores-plugins-de-widget-do-wordpress/).
Legenda: a pasta do plugin isola o widget do tema, garantindo que ele sobreviva a qualquer troca de template.
---
## Como criar um plug in de widget: Passo a passo
Criar um plug in de widget leva cerca de 30 minutos para quem já programa PHP e envolve 5 etapas: criar a pasta, escrever o cabeçalho, estender WP_Widget, sobrescrever os 4 métodos e registrar a classe no hook widgets_init. O passo que mais gera ticket de suporte é o registro, e por um motivo específico.
Uma classe perfeita que nunca é registrada no hook simplesmente não aparece no painel, sem nenhum erro visível no log. Por isso o registro é tão crítico quanto a escrita da classe. As etapas abaixo seguem a ordem exata que validamos em instalação limpa de WordPress 6.x com PHP 8.2.
### Passo 1: Crie a pasta e o cabeçalho do plugin
Crie a pasta `meu-widget` em `wp-content/plugins/` e, dentro dela, o arquivo `meu-widget.php`. No topo do arquivo, escreva o cabeçalho de plugin com Plugin Name, Version e Author dentro de um comentário PHP. Esse cabeçalho é a única exigência para o WordPress listar o pacote em Plugins. Sem o campo Plugin Name, o arquivo é ignorado pelo carregador. Use a versão 1.0.0 como ponto de partida e mantenha o slug do plugin igual ao nome da pasta para evitar conflito de carregamento.
### Passo 2: Estenda a classe de widget do Core
Declare `class Meu_Widget extends WP_Widget`. No método __construct(), chame `parent::__construct()` passando o ID base (ex: 'meu_widget'), o nome visível ('Meu Widget') e um array de opções com a descrição. Esse ID base precisa ser único no site inteiro: dois widgets com o mesmo ID se sobrescrevem e um deles some do painel. O nome visível é o texto que aparece na tela Aparência > Widgets, então use algo descritivo que o editor do site reconheça sem abrir a documentação.
### Passo 3: Sobrescreva os métodos widget, form e update
Sobrescreva os 3 métodos de comportamento. O método widget() recebe `$args` e `$instance` e imprime o HTML no front-end, sempre passando o texto por esc_html(). O método form() desenha os campos de configuração no painel. O método update() recebe o input antigo e o novo e devolve o valor salvo, e é aqui que entra a regra de ouro: passe todo campo de texto por sanitize_text_field() antes de salvar. Pular essa sanitização no update() abre uma brecha de XSS armazenado, um dos erros que a gente mais flagra em revisão de código na FULL.
### Passo 4: Registre o widget no hook widgets_init
Registre a classe com `register_widget('Meu_Widget')` dentro de uma função enganchada em `add_action('widgets_init', ...)`. Este é o passo que destrava o widget no painel: sem o register_widget() no hook correto, a classe existe mas nunca é instanciada, e o componente não aparece em Aparência > Widgets nem gera erro no log. Confirme que o nome passado em register_widget() é idêntico ao nome da classe, com a mesma capitalização, porque o PHP diferencia maiúsculas em alguns contextos de autoload.
### Passo 5: Ative e teste o plug in de widget
Ative o plugin em Plugins > Plugins Instalados e abra Aparência > Widgets. O widget recém-criado aparece na lista de blocos disponíveis. Arraste-o para uma widget area (barra lateral ou rodapé), preencha o campo do formulário e salve. Recarregue o front-end e confirme que o conteúdo renderiza no lugar certo. Se o widget aparecer no painel mas não no site, o erro quase sempre está na widget area: o tema precisa ter `register_sidebar()` declarado, senão não há onde encaixar o componente.
---
## Erros comuns ao criar um plug in de widget
Os 3 erros mais frequentes ao criar um plug in de widget concentram quase todos os tickets do tema: classe não registrada no hook, ID base duplicado e ausência de sanitização no update(). O primeiro é silencioso, porque a classe está correta mas nada aparece, e o desenvolvedor perde tempo procurando erro de sintaxe que não existe.
O segundo erro gera comportamento fantasma, com um widget sobrescrevendo o outro por causa do ID repetido. O terceiro é o mais grave, porque vira vetor de segurança. Para o ID base, padronize um prefixo único por projeto (ex: `full_` ou as iniciais do cliente). Para a sanitização, lembre que update() é a última barreira antes do banco: tudo que entra ali precisa de sanitize_text_field() ou wp_kses(). Quem usa o Elementor encontra padrões parecidos no [tutorial de Elementor para iniciantes](https://full.services/elementor-tutorial-iniciantes/).
---
## Quando usar bloco Gutenberg em vez do widget clássico
Use o bloco Gutenberg em vez da classe WP_Widget quando o site roda um tema de bloco (FSE) e a edição precisa ser visual dentro do editor de site. A partir do (julho de 2021), a tela de widgets passou a aceitar blocos, e em temas FSE a barra lateral clássica deixou de existir.
Nesses casos, registrar um widget pela classe WP_Widget ainda funciona por compatibilidade, mas o caminho recomendado é construir um bloco com a Block API e registrá-lo via register_block_type(). O bloco exige um passo de build com JavaScript, o que aumenta a complexidade inicial. A decisão prática se resume ao tema: clássico com barra lateral pede a classe; tema de bloco moderno pede o bloco. Para componentes arrasta-e-solta no construtor, veja [como adicionar widgets personalizados ao Elementor com plugins](https://full.services/como-adicionar-widgets-personalizados-ao-elementor-com-plugins/).
---
## Acelere a entrega com os plugins certos no plano da FULL
Montar um plug in de widget do zero faz sentido para componentes sob medida, mas boa parte das necessidades de barra lateral, formulário e listagem já é resolvida por plugins premium prontos. O plano PRO da FULL custa R$849 e reúne o pacote que cobre esses casos sem você reescrever código.
Para quem gerencia vários sites, isso equivale a cerca de R$85 por site no bundle, contra o custo avulso de cada licença comprada separadamente. A gente vê no suporte da FULL que a maioria das agências economiza horas de desenvolvimento ao partir de um widget pronto e só customizar o que falta. Conheça o que está incluído em [FULL.services/planos](https://full.services/planos) e decida, caso a caso, quando construir e quando reusar um componente já testado.
---
---
## Perguntas frequentes sobre plug in de widget
Por que meu plug in de widget não aparece em Aparência > Widgets?
Na quase totalidade dos casos, falta o register_widget() dentro do hook widgets_init. A classe pode estar correta, mas sem o registro no hook o WordPress nunca a instancia, e o widget não surge no painel nem gera erro no log. Confirme que existe um add_action('widgets_init', ...) chamando register_widget() com o nome exato da classe. Esse é o erro silencioso número 1 do tema.
É possível criar um plug in de widget sem saber PHP avançado?
Sim, é possível com PHP básico. A estrutura mínima tem cerca de 60 linhas e segue um molde fixo: cabeçalho do plugin, classe que estende WP_Widget e 4 métodos com nomes pré-definidos. Você adapta o conteúdo do método widget() e os campos do form() ao seu caso. Não exige orientação a objetos profunda, apenas entender que a classe herda comportamento do core do WordPress.
Qual a diferença entre um widget clássico e um bloco Gutenberg?
O widget clássico usa a classe WP_Widget em PHP e funciona em temas com barra lateral; o bloco Gutenberg usa a Block API com JavaScript e funciona no editor de site dos temas de bloco (FSE). Desde o WordPress 5.8 (2021), a tela de widgets aceita blocos. Para tema clássico, a classe é mais rápida; para tema de bloco moderno, o bloco integra melhor ao editor visual.
Quanto tempo leva para empacotar um plug in de widget distribuível?
Para quem já programa PHP, cerca de 30 minutos: a pasta, o cabeçalho, a classe com os 4 métodos e o registro no hook. Empacotar como .zip distribuível leva mais alguns minutos, bastando compactar a pasta do plugin. O tempo extra vai para a sanitização correta no update() e o teste em tema clássico e de bloco, etapas que evitam retrabalho depois da entrega ao cliente.
O que a classe WP_Widget exige para o widget funcionar?
A classe WP_Widget exige no mínimo a sobrescrita do método widget(), que imprime o conteúdo no front-end. Para ter opções configuráveis, sobrescreva também form() e update(). O __construct() define o ID base único e o nome visível. Segundo a documentação oficial do WordPress, sem o método widget() sobrescrito o componente não renderiza. O registro no hook widgets_init completa o ciclo.
---
## Próximos passos para dominar widgets no WordPress
Criar um plug in de widget é a base para qualquer componente reutilizável no WordPress: a partir da classe WP_Widget e do hook widgets_init, você entrega barras laterais, rodapés e blocos próprios que sobrevivem à troca de tema. O caminho mais seguro é começar pela estrutura mínima, validar cada um dos 4 métodos e só então empacotar como plugin distribuível.
Para continuar aprendendo, o [FULL Academy](https://full.services/academy/) reúne tutoriais, guias e reviews de WordPress num só lugar, e a categoria de [tutoriais de WordPress da FULL](https://full.services/tutoriais-wordpress/) aprofunda os próximos temas de desenvolvimento.
---
**Meta description:** Crie um plug in de widget para WordPress em 5 passos: classe WP_Widget, hooks, registro e empacotamento. Tutorial técnico com código e validação.
**Title tag:** Plug in de widget: como criar um em 5 passos
---
## Metadados Estruturados (Schema.org)
```json-ld
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "TechArticle",
"@id": "https://full.services/plug-in-de-widget/#article",
"headline": "Plug in de widget: Como criar um em 5 passos",
"description": "Um plug in de widget para WordPress encapsula um bloco reutilizável (formulário, banner, lista de posts) num arquivo PHP que você ativa em qualquer site, sem colar código no tema.",
"url": "https://full.services/plug-in-de-widget/",
"datePublished": "2026-06-27T09:00:00-03:00",
"dateModified": "2026-06-27T09:00:00-03:00",
"inLanguage": "pt-BR",
"articleSection": "Tutoriais WordPress",
"keywords": [
"plug in de widget",
"WordPress",
"Web Development"
],
"author": {
"@id": "https://full.services/#person-clayton"
},
"publisher": {
"@id": "https://full.services/#org"
},
"about": [
{
"@type": "Thing",
"name": "WordPress",
"@id": "https://www.wikidata.org/wiki/Q13166",
"sameAs": "https://www.wikidata.org/wiki/Q13166"
},
{
"@type": "Thing",
"name": "Web Development",
"@id": "https://www.wikidata.org/wiki/Q386275",
"sameAs": "https://www.wikidata.org/wiki/Q386275"
}
],
"mentions": [
{
"@type": "Organization",
"name": "WordPress",
"url": "https://wordpress.org/",
"@id": "https://www.wikidata.org/wiki/Q13166",
"sameAs": "https://www.wikidata.org/wiki/Q13166"
}
],
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://full.services/plug-in-de-widget/"
},
"wordCount": 2433,
"citation": [
{
"@type": "CreativeWork",
"name": "W3Techs",
"url": "https://w3techs.com/technologies/details/cm-wordpress",
"publisher": {
"@type": "Organization",
"name": "W3Techs"
}
},
{
"@type": "CreativeWork",
"name": "WordPress Developer Docs",
"url": "https://developer.wordpress.org/reference/classes/wp_widget/",
"publisher": {
"@type": "Organization",
"name": "WordPress Developer Docs"
}
}
]
},
{
"@type": "FAQPage",
"@id": "https://full.services/plug-in-de-widget/#faq",
"isPartOf": {
"@id": "https://full.services/plug-in-de-widget/#article"
},
"mainEntity": [
{
"@type": "Question",
"@id": "https://full.services/plug-in-de-widget/#faq-q1",
"name": "Por que meu plug in de widget não aparece em Aparência > Widgets?",
"inLanguage": "pt-BR",
"acceptedAnswer": {
"@type": "Answer",
"text": "Na quase totalidade dos casos, falta o register_widget() dentro do hook widgets_init. A classe pode estar correta, mas sem o registro no hook o WordPress nunca a instancia, e o widget não surge no painel nem gera erro no log. Confirme que existe um add_action('widgets_init', ...) chamando register_widget() com o nome exato da classe. Esse é o erro silencioso número 1 do tema.",
"author": {
"@id": "https://full.services/#org"
}
}
},
{
"@type": "Question",
"@id": "https://full.services/plug-in-de-widget/#faq-q2",
"name": "É possível criar um plug in de widget sem saber PHP avançado?",
"inLanguage": "pt-BR",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sim, é possível com PHP básico. A estrutura mínima tem cerca de 60 linhas e segue um molde fixo: cabeçalho do plugin, classe que estende WP_Widget e 4 métodos com nomes pré-definidos. Você adapta o conteúdo do método widget() e os campos do form() ao seu caso. Não exige orientação a objetos profunda, apenas entender que a classe herda comportamento do core do WordPress.",
"author": {
"@id": "https://full.services/#org"
}
}
},
{
"@type": "Question",
"@id": "https://full.services/plug-in-de-widget/#faq-q3",
"name": "Qual a diferença entre um widget clássico e um bloco Gutenberg?",
"inLanguage": "pt-BR",
"acceptedAnswer": {
"@type": "Answer",
"text": "O widget clássico usa a classe WP_Widget em PHP e funciona em temas com barra lateral; o bloco Gutenberg usa a Block API com JavaScript e funciona no editor de site dos temas de bloco (FSE). Desde o WordPress 5.8 (2021), a tela de widgets aceita blocos. Para tema clássico, a classe é mais rápida; para tema de bloco moderno, o bloco integra melhor ao editor visual.",
"author": {
"@id": "https://full.services/#org"
}
}
},
{
"@type": "Question",
"@id": "https://full.services/plug-in-de-widget/#faq-q4",
"name": "Quanto tempo leva para empacotar um plug in de widget distribuível?",
"inLanguage": "pt-BR",
"acceptedAnswer": {
"@type": "Answer",
"text": "Para quem já programa PHP, cerca de 30 minutos: a pasta, o cabeçalho, a classe com os 4 métodos e o registro no hook. Empacotar como .zip distribuível leva mais alguns minutos, bastando compactar a pasta do plugin. O tempo extra vai para a sanitização correta no update() e o teste em tema clássico e de bloco, etapas que evitam retrabalho depois da entrega ao cliente.",
"author": {
"@id": "https://full.services/#org"
}
}
},
{
"@type": "Question",
"@id": "https://full.services/plug-in-de-widget/#faq-q5",
"name": "O que a classe WP_Widget exige para o widget funcionar?",
"inLanguage": "pt-BR",
"acceptedAnswer": {
"@type": "Answer",
"text": "A classe WP_Widget exige no mínimo a sobrescrita do método widget(), que imprime o conteúdo no front-end. Para ter opções configuráveis, sobrescreva também form() e update(). O __construct() define o ID base único e o nome visível. Segundo a documentação oficial do WordPress, sem o método widget() sobrescrito o componente não renderiza. O registro no hook widgets_init completa o ciclo.",
"author": {
"@id": "https://full.services/#org"
}
}
}
]
},
{
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://full.services/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Tutoriais WordPress",
"item": "https://full.services/tutoriais-wordpress/"
},
{
"@type": "ListItem",
"position": 3,
"name": "Plug in de widget: Como criar um em 5 passos",
"item": "https://full.services/plug-in-de-widget/"
}
]
},
{
"@type": "Organization",
"@id": "https://full.services/#org",
"name": "FULL Services",
"url": "https://full.services",
"logo": {
"@type": "ImageObject",
"url": "https://full.services/wp-content/uploads/full-services-logo.png",
"width": 200,
"height": 60
},
"sameAs": [
"https://www.instagram.com/fullservicesbr",
"https://www.facebook.com/fullservices.br",
"https://www.linkedin.com/company/fullservicesbr/"
],
"knowsAbout": [
"WordPress",
"WordPress Hosting",
"Web Development",
"Performance Optimization",
"WordPress Security",
"SEO para WordPress"
],
"award": [
"Gold Medal - The WP Weekly Awards 2023 (https://thewpweekly.com/awards-2023/)",
"Gold Medal - The WP Weekly Awards 2024 (https://thewpweekly.com/awards-2024/)"
],
"hasCredential": {
"@type": "EducationalOccupationalCredential",
"credentialCategory": "certification",
"name": "CVE Numbering Authority (CNA)",
"description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Certificação válida desde 2022-05-03, com abrangência global.",
"url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL",
"recognizedBy": {
"@type": "Organization",
"name": "CISA — Cybersecurity and Infrastructure Security Agency",
"url": "https://www.cisa.gov/",
"sameAs": "https://www.cisa.gov/"
}
}
},
{
"@type": "Person",
"@id": "https://full.services/#person-clayton",
"name": "Clayton Margiotti",
"givenName": "Clayton",
"familyName": "Margiotti",
"jobTitle": "Fundador e CEO da FULL Services",
"description": "Fundador e CEO da FULL Services, plataforma WordPress SaaS com 50 mil clientes e 150 mil sites conectados, e anchor do ecossistema Elevor Global. Em 2024 conduziu a FULL a se tornar a primeira e unica empresa brasileira aprovada como CVE Numbering Authority sob a CISA (DHS/EUA). Mais de 20 anos construindo empresas digitais, com 13+ reconhecimentos internacionais (Facebook, GPTW, ONU, RD Summit).",
"url": "https://full.services/sobre-nos/",
"image": "https://full.services/wp-content/uploads/2026/05/clayton-margiotti.jpg",
"sameAs": [
"https://www.linkedin.com/in/cmargiotti/"
],
"knowsAbout": [
"Artificial Intelligence",
"Cybersecurity",
"CVE Program",
"WordPress Enterprise",
"SaaS Platforms",
"Digital Infrastructure",
"Technology Entrepreneurship",
"Company Building",
"Business Leadership",
"Digital Growth"
],
"hasOccupation": {
"@type": "Occupation",
"name": "Fundador e CEO",
"occupationalCategory": "11-1011.00"
},
"knowsLanguage": [
{
"@type": "Language",
"name": "Portuguese",
"alternateName": "pt-BR"
},
{
"@type": "Language",
"name": "English",
"alternateName": "en"
}
],
"memberOf": {
"@type": "Organization",
"name": "CVE Numbering Authorities",
"url": "https://www.cve.org/",
"sameAs": "https://www.cve.org/"
},
"alumniOf": [
{
"@type": "EducationalOrganization",
"name": "Global Scaling Academy (Blitzscaling Program)",
"url": "https://www.blitzscalingacademy.com"
},
{
"@type": "EducationalOrganization",
"name": "Esade",
"url": "https://www.esade.edu"
},
{
"@type": "EducationalOrganization",
"name": "Business School Sao Paulo (BSP)",
"url": "https://bsp.edu.br/"
},
{
"@type": "EducationalOrganization",
"name": "Tera",
"url": "https://somostera.com"
},
{
"@type": "EducationalOrganization",
"name": "Le Wagon",
"url": "https://www.lewagon.com"
},
{
"@type": "EducationalOrganization",
"name": "FIAP",
"url": "https://www.fiap.com.br"
},
{
"@type": "EducationalOrganization",
"name": "PUCRS",
"url": "https://online.pucrs.br/"
}
],
"award": [
"Digital Disruptor – Engaging Experiences Master (Globant, 2021)",
"Maior ROI do e-commerce brasileiro – Letrissimas (Facebook, 2019)",
"1º lugar – Melhores Empresas para Trabalhar no Brasil – Eleva Digital (Great Place to Work, 2018)",
"Case global de educacao no Facebook – Metodo SUPERA (Facebook, 2017)",
"Maquina de Geracao de Leads, Agencia do Ano (RD Summit / RD Station, 2015)",
"Monthly Recurring Revenue, top performance (RD Summit / RD Station, 2015)",
"Quality/Efficiency – Entrepreneurship Training (UNCTAD / PNUD-ONU, 2010)"
],
"subjectOf": [
{
"@type": "NewsArticle",
"url": "https://www.globant.com/news/globant-reveals-inaugural-digital-disruptors-award-winners",
"publisher": {
"@type": "Organization",
"name": "Globant"
}
},
{
"@type": "NewsArticle",
"url": "https://www.prnewswire.com/news-releases/letrissimas-com-e-destaque-do-e-commerce-brasileiro-com-maior-roi-de-2018-877517801.html",
"publisher": {
"@type": "Organization",
"name": "PR Newswire"
}
},
{
"@type": "NewsArticle",
"url": "https://www.segs.com.br/seguros/102599-gestao-de-pessoas-garante-mais-lucro-as-empresas",
"publisher": {
"@type": "Organization",
"name": "Segs"
}
},
{
"@type": "NewsArticle",
"url": "https://franquiaeducacional.com/negocios-inovadores-facebook-elege-supera-case-mundial-de-educacao",
"publisher": {
"@type": "Organization",
"name": "Franquia Educacional"
}
},
{
"@type": "NewsArticle",
"url": "https://acontecendoaqui.com.br/marketing/resultados-digitais-divulga-vencedores-do-premio-agencias-de-resultados-2015-durante-o-rd",
"publisher": {
"@type": "Organization",
"name": "Acontecendo Aqui"
}
}
],
"worksFor": {
"@type": "Organization",
"@id": "https://full.services/#org"
}
},
{
"@type": "HowTo",
"@id": "https://full.services/plug-in-de-widget/#howto",
"isPartOf": {
"@id": "https://full.services/plug-in-de-widget/#article"
},
"name": "Passo a passo: plug in de widget",
"description": "Guia passo a passo sobre plug in de widget para WordPress.",
"url": "https://full.services/plug-in-de-widget/",
"totalTime": "PT30M",
"author": {
"@type": "Organization",
"@id": "https://full.services/#org"
},
"step": [
{
"@type": "HowToStep",
"position": 1,
"name": "Passo 1: Crie a pasta e o cabeçalho do plugin",
"text": "Crie a pasta `meu-widget` em `wp-content/plugins/` e, dentro dela, o arquivo `meu-widget.php`. No topo do arquivo, escreva o cabeçalho de plugin com Plugin Name, Version e Author dentro de um comentário PHP. Esse cabeçalho é a única exigência para o WordPress listar o pacote em Plugins. Sem o campo Plugin Name, o arquivo é ignorado pelo carregador. Use a versão 1.0.0 como ponto de partida e mantenha o slug do plugin igual ao nome da pasta para evitar conflito de carregamento."
},
{
"@type": "HowToStep",
"position": 2,
"name": "Passo 2: Estenda a classe de widget do Core",
"text": "Declare `class Meu_Widget extends WP_Widget`. No método __construct(), chame `parent::__construct()` passando o ID base (ex: 'meu_widget'), o nome visível ('Meu Widget') e um array de opções com a descrição. Esse ID base precisa ser único no site inteiro: dois widgets com o mesmo ID se sobrescrevem e um deles some do painel. O nome visível é o texto que aparece na tela Aparência > Widgets, então use algo descritivo que o editor do site reconheça sem abrir a documentação."
},
{
"@type": "HowToStep",
"position": 3,
"name": "Passo 3: Sobrescreva os métodos widget, form e update",
"text": "Sobrescreva os 3 métodos de comportamento. O método widget() recebe `$args` e `$instance` e imprime o HTML no front-end, sempre passando o texto por esc_html(). O método form() desenha os campos de configuração no painel. O método update() recebe o input antigo e o novo e devolve o valor salvo, e é aqui que entra a regra de ouro: passe todo campo de texto por sanitize_text_field() antes de salvar. Pular essa sanitização no update() abre uma brecha de XSS armazenado, um dos erros que a gente mais flagra em revisão de código na FULL."
},
{
"@type": "HowToStep",
"position": 4,
"name": "Passo 4: Registre o widget no hook widgets_init",
"text": "Registre a classe com `register_widget('Meu_Widget')` dentro de uma função enganchada em `add_action('widgets_init', ...)`. Este é o passo que destrava o widget no painel: sem o register_widget() no hook correto, a classe existe mas nunca é instanciada, e o componente não aparece em Aparência > Widgets nem gera erro no log. Confirme que o nome passado em register_widget() é idêntico ao nome da classe, com a mesma capitalização, porque o PHP diferencia maiúsculas em alguns contextos de autoload."
},
{
"@type": "HowToStep",
"position": 5,
"name": "Passo 5: Ative e teste o plug in de widget",
"text": "Ative o plugin em Plugins > Plugins Instalados e abra Aparência > Widgets. O widget recém-criado aparece na lista de blocos disponíveis. Arraste-o para uma widget area (barra lateral ou rodapé), preencha o campo do formulário e salve. Recarregue o front-end e confirme que o conteúdo renderiza no lugar certo. Se o widget aparecer no painel mas não no site, o erro quase sempre está na widget area: o tema precisa ter `register_sidebar()` declarado, senão não há onde encaixar o componente. --- Os 3 erros mais frequentes ao criar um plug in de widget concentram quase todos os tickets do tema: classe não registrada no hook, ID base duplicado e ausência de sanitização no update(). O primeiro é silencioso, porque a classe está correta mas nada aparece, e o desenvolvedor perde tempo procurando erro de sintaxe que não existe. O segundo erro gera comportamento fantasma, com um widget sobrescrevendo o outro por causa do ID repetido. O terceiro é o mais grave, porque vira vetor de segurança. Para o ID base, padronize um prefixo único por projeto (ex: `full_` ou as iniciais do cliente). Para a sanitização, lembre que update() é a última barreira antes do banco: tudo que entra ali precisa de"
}
]
}
]
}
```