Como criar um widget para WordPress para exibir ofertas da Lomadee – Parte 01

Developers, devido ao grande avanço do WordPress no Brasil e no mundo, iremos hoje fazer uma integração do WordPress com a Lomadee, através da API de plugins e widgets do WordPress e da API do Buscapé.

Implementaremos um widget para WordPress em que o usuário poderá informar o seu source ID, definir palavras-chave para filtrar as ofertas e definir a quantidade de ofertas que deverão ser exibidas. Dividiremos este artigo em duas partes. Agora abordaremos um pouco sobre widgets e plugins para WordPress, desenvolvendo a área de configuração do widget. Na segunda parte iremos incluir o wrapper para PHP, obter os dados de acordo com os filtros aplicados e exibir a vitrine de ofertas.

Então vamos lá! Para começar, vamos criar um plugin que será a forma como disponibilizaremos nosso widget aos usuários do WordPress. Ou seja, o widget estará automaticamente disponível para ser configurado e exibido quando o usuário instalar o nosso plugin em seu site.

Caso você ainda não saiba como se cria um plugin ou widget para WordPress, recomendo a leitura da documentação da API de plugins e de widgets do WordPress antes de iniciar.

Nosso plugin se chamará “Vitrine de ofertas Lomadee” e será criado dentro da pasta “showcase-offers-lomadee” que deverá ser incluída dentro da pasta “plugins” do WordPress. Sendo assim, teremos então a seguinte estrutura de pastas e arquivos:

No arquivo “showcase-offers-lomadee-widget.php”, nós implementaremos os métodos relacionados ao widget e no arquivo “showcase-offers-lomadee.php”, os relacionados ao plugin – sendo este o principal arquivo do nosso plugin, no qual executaremos os principais métodos para seu funcionamento.

No arquivo “showcase-offers-lomadee.php” daremos início ao desenvolvimento da primeira parte do plugin, que é definir sua descrição e registrar o widget. Segue abaixo o código com todos os comentários necessários para seu acompanhamento.

<?php
/**
 * Plugin Name: Vitrine de ofertas da Lomadee
 * Plugin URI: http://developer.buscape.com
 * Description: Cria um widget para exibição de uma vitrine de ofertas Lomadee.
 * Version: 1.0
 * Author: BuscaPé Developer
 * Author URI: http://developer.buscape.com
 */
 
class Showcase_Offers_Lomadee {
 
    public function __construct()
    {
        // Ao inicializar os widgets, chama-se o método para registro do widget
        add_action( 'widgets_init', array( &$this, 'register_widget' ) );
    }
 
    /**
     * Registra o widget de vitrine de ofertas da Lomadee
     *
     * @return void
     */
    public function register_widget()
    {

No arquivo “showcase-offers-lomadee-widget.php”, que é requerido no método de registro do widget mostrado no código acima, vamos criar a classe do widget extendendo a WP_Widget, que é onde se concentra a API de widgets do WordPress. Nesse arquivo, criaremos o método construtor que definirá as configurações iniciais do widget como ID, nome, descrição, etc. Serão criados também inicialmente os métodos para definição do formuário de configurações do widget e de atualização desses dados. Segue abaixo o código com todos os comentários necessários para seu acompanhamento.

<?php
class Showcase_Offers_Lomadee_Widget extends WP_Widget {
 
    /**
     * Método construtor. Inicializa o widget de acordo com as opções definidas
     */
    public function __construct()
    {
        $widget_ops = array(
            'classname'     => 'widget_showcase_offers_lomadee',
            'description'   => 'Exibe uma vitrine de ofertas da Lomadee.'
        );
 
        parent::__construct( 'showcase-offers-lomadee-widget', 'Vitrine de ofertas Lomadee', $widget_ops );
    }
 
    /**
     * Cria o formulário de configurações do widget
     *
     * @param array $instance Configurações salvas atualmente
     * @return void
     */
    public function form( $instance )
    {
        $title      = ( $instance['title'] )        ? $instance['title'] : '';
        $source_id  = ( $instance['source_id'] )    ? esc_html( $instance['so

Bom, é isso! Para que possa ver seu widget já em funcionamento, ative o plugin em sua instalação WordPress de testes (vá no menu Aparências->Widgets e arraste o novo widget para a área de widgets desejada). Você terá um resultado como este:

Como combinamos, no nosso próximo artigo, implementaremos a inclusão do wrapper para PHP, o método para obter os dados de acordo com os filtros aplicados no widget e a exibição da vitrine de ofertas completa.

Espero que tenham gostado e deixo aberto à dúvidas e sugestões para o próximo artigo.