Escolar Documentos
Profissional Documentos
Cultura Documentos
Desenvolvedores
Sumrio
O que o Wordpress................................................................................................................... 4
Caracterticas do Wordpress.......................................................................................................4
Instalando o Wordpress............................................................................................................... 4
Pacote de instalao............................................................................................................... 4
Configurao........................................................................................................................... 5
Temas.......................................................................................................................................... 6
Como instalar novos temas.....................................................................................................6
Adicionando novos temas utilizando o Painel de Administrao.............................................7
Arquivos de um tema.............................................................................................................. 7
A idia geral ........................................................................................................................... 7
Exemplos ............................................................................................................................... 8
A Hierarquia de Modelos em detalhe......................................................................................8
Exibir Home page............................................................................................................... 9
Exibir Postagem Individualmente........................................................................................9
Exibir Pgina...................................................................................................................... 9
Mostrar Categoria............................................................................................................... 9
Mostrar Tag........................................................................................................................ 9
Custom Post Tipos ............................................................................................................ 9
Taxonomias Personalizadas...............................................................................................9
Mostrar Dados de Autor....................................................................................................10
Arquivo por Data ..............................................................................................................10
Exibir Resultados da Pesquisa.........................................................................................10
Exibir pgina 404 (No Encontrado) ................................................................................10
Exibir Anexos.................................................................................................................... 10
Referenciando arquivos em templates..................................................................................10
Ganchos para Plugins...........................................................................................................10
Template tags....................................................................................................................... 11
O Loop.................................................................................................................................. 11
Exemplos de loop..................................................................................................................11
Loop bsico com contedo:..............................................................................................11
Excluir posts da categoria 3:.............................................................................................12
Mostra uma lista de posts duas vezes:.............................................................................13
Pega os ltimos 15 posts de uma categoria qualquer......................................................13
Se necessrio manter a query original, voc pode criar um novo objeto:......................13
Plugins....................................................................................................................................... 14
Estrutura............................................................................................................................... 14
API de Plugins....................................................................................................................... 14
Referncia de funes............................................................................................................... 17
Post, Pgina, Anexo e Bookmarks........................................................................................17
Categorias, tags e taxonomia................................................................................................18
Usurios e Autores................................................................................................................18
Feeds.................................................................................................................................... 18
Comentrios, Ping, e Trackback...........................................................................................19
Aes, Filtros e Plugins.........................................................................................................19
Relacionadas a Temas..........................................................................................................19
Formatao........................................................................................................................... 20
Diversas................................................................................................................................ 21
Referncia de Aes.................................................................................................................23
Requisies tpicas...............................................................................................................23
Pginas administrativas........................................................................................................23
Posts, pginas, anexos e categorias.....................................................................................23
Comentrios, pings e trackbacks..........................................................................................23
Links...................................................................................................................................... 24
Feeds.................................................................................................................................... 24
Templates............................................................................................................................. 24
Administrao....................................................................................................................... 24
Avanado.............................................................................................................................. 24
O que o Wordpress
O WordPress uma plataforma semntica de vanguarda para publicao pessoal, com foco na
esttica, nos Padres Web e na usabilidade. O WordPress ao mesmo tempo um software livre e
gratuito. Em outras palavras, o WordPress o que voc usa quando voc quer trabalhar e no
lutar com seu software de publicao de blogs.
Caracterticas do Wordpress
WordPress uma poderosa plataforma de publicao pessoal que vem com um grande conjunto
de caractersticas concebidas para tornar sua experincia como editor na Internet, fcil, agradvel
e o mais atraente possvel.
Instalado localmente Senha de proteo
Core Porttil Mensagem para o futuro
UTC amigvel Postagens Multi-paginada
Gesto de usurios Upload de imagens e arquivos
Perfis de usurio Categorias
Fcil instalao e atualizao Emoticons
Gerao dinmica de pginas Salvar rascunhos
Internacionalizao e Localizao Visualizar contedo no publicado
Feeds Ferramentas Desktop Disponveis
Links Permanentes sem "Cdigos Blog por e-mail
estranhos" Formatao
Comunicao entre-blogs Arquivamento
Template Tags Pesquisa Internat
Temas Importao/Exportao
Plugins
Instalando o Wordpress
O Wordpress um dos CMSs mais fceis de se utilizar, e sua instalao no poderia ser muito
diferente: trata-se de um procedimento simples e rpido que, na maioria das vezes, leva alguns
poucos minutos para ser finalizado. Isto, claro, supondo-se que o usurio j possua alguma
experincia com sistemas similares, e tambm com a criao de bancos de dados, definio de
usurios, senhas, upload de arquivos, etc.
No nada complicado, mas acredito que a presena de um tutorial bsico ser interessante
aqui no PluginMania, voltado principalmente aos usurios que esto iniciando o uso do
Wordpress. Procurei abordar todos os procedimentos necessrios instalao, desde a criao
dos bancos de dados MySQL at o primeiro login do usurio administrador. Aqui vamos ns,
portanto.
Pacote de instalao
Voc pode baixar do site internacional, ou da comunidade brasileira.
http://wordpress.org
http://br.wordpress.org
Aps o download, efetue a descompactao do arquivo .ZIP obtido, e voc obter uma pasta
chamada wordpress, com uma srie de arquivos e tambm 3 subpastas, conforme abaixo:
wp-admin: arquivos de administrao (Painel, instalador, ...)
wp-content: arquivos do website (Uploads, temas, plugins, cache...)
wp-includes: bibliotecas e classes (jQuery, SimplePie, FCKEditor, Prototype...)
Configurao
Este um procedimento que poder variar de acordo com o sistema operacional, painel de
controle e recursos disponibilizados no plano de hospedagem que voc assinou. Em alguns
painis de controle, como por exemplo o Cpanel, a criao de bases de dados e usurios, e
tambm a definio de acessos, pode ser feita atravs da opo MySQL Databases (bases de
dados MySQL), localizada dentro do grupo de opes Databases (bases de dados).
Algumas empresas de hospedagem trabalham com outros painis de controle, onde este
procedimento pode variar bastante, e existem at mesmo empresas que trabalham com painis
de controle prprios.
Ou seja, muito difcil encontrarmos um guia definitivo relativo a este ponto, mas vale ressaltar
que, independentemente do painel de controle, do sistema operacional ou at mesmo da empresa
de hospedagem que voc utiliza, o que voc precisa fazer o seguinte:
Criar uma base de dados MySQL;
Criar um usurio e definir uma senha para a base;
Disponibilizar para este usurio acesso completo base de dados recm criada.
Alguns painis de controle criam automaticamente o usurio e definem uma senha, outros no
permitem a definio de um nome para a base de dados que fornecida automaticamente. De
qualquer forma, aps os procedimentos acima voc ter em mos o nome da base de dados, o
usurio que acessar esta base de dados e a senha.
Utilizando um editor de textos qualquer, abra o arquivo wp-config-sample.php. O arquivo se
encontra da seguinte maneira:
define(DB_NAME, nomedoBD);
define(DB_USER, usuarioMySQL);
define(DB_PASSWORD, senha);
define(DB_HOST, localhost);
Aps as alteraes acima, salve o arquivo com o seguinte nome: wp-config.php e acesse o
endereo do website. Acesse o endereo para logar:
http://www.seusite.com.br/wp-admin/
Temas
Fundamentalmente, o sistema de temas WordPress uma forma de "skin" do seu weblog. No
entanto, mais do que apenas uma "skin". Sem skin, implica que s o design de seu site
alterado. Temas WordPress podem oferecer muito mais controle sobre a aparncia e a
apresentao do material em seu site.
Os temas WordPress so uma coleo de arquivos que trabalham juntos para produzir uma
interface grfica com um design subjacente e unificador para um weblog. Estes arquivos so
chamados arquivos de modelo (template files). Um tema modifica a maneira como o site exibido,
sem modificar o software subjacente e os dados que ele gerencia.
Os temas podem incluir arquivos de modelos personalizados, arquivos de imagem (*.jpg, *.gif),
folhas de estilos (*.css), pginas personalizadas, bem como de quaisquer arquivos de cdigo
necessrio (*.php).
Os temas so um jogo totalmente novo. Vamos dizer que voc escreve muito sobre o futebol e
msica. Atravs do uso inovador do Loop WordPress e arquivos de modelo, voc pode
personalizar suas postagens de forma diferente, de acordo com a categoria de tais postagens.
Assim, suas postagens sobre futebol podem aparecer num fundo verde, e as postagens sobre
msica num fundo branco, por exemplo.
Com este poderoso controle sobre como diferentes pginas e categorias aparecem em seu site,
voc s estpa limitado pela sua imaginao.
Arquivos de um tema
Seo obrigatria no arquivo style.css:
/*
Theme Name: Rose
Theme URI: the-theme's-homepage
Description: a-brief-description
Author: your-name
Author URI: your-URI
Template: use-this-to-define-a-parent-theme--optional
Version: a-number--optional
...
General comments/License Statement if any.
...
*/
A idia geral
O WordPress utiliza o Query String - Informaes contidas no interior de cada link em seu site -
para decidir qual o modelo ou conjunto de modelos sero utilizados para exibir a pgina.
Primeiro, o WordPress partidas cadeia de consulta para todos os tipos de consulta - ou seja, ele
decide que tipo de pgina (uma pgina de busca, uma pgina da categoria, a home page, etc)
est sendo solicitado.
Os modelos so ento escolhidos - e o contedo da pgina web gerada - na ordem sugerida
pela hierarquia Template WordPress, dependendo do que modelos esto disponveis num
determinado Tema WordPress.
Os arquivos so estes:
style.css: Folha de estilo do tema. category.php: Listagem de posts de uma
obrigatria e deve conter todos os estilos categoria.
ou chamadas de outras folhas de estilo tag.php: Listagem de posts de um tag.
para o tema. taxonomy.php: Listagem de uma
index.php: O template principal. usado taxonomia qualquer.
para exibir qualquer contedo quando um author.php: Listagem de posts de um
template especfico no for encontrado. autor.
comments.php: Listagem de date.php: Listagem de um intervalo de
comentrios logo abaixo dos posts. data (ano, ms, dia).
comments-popup.php: Lista de popups archive.php: Usado de maneira
em uma nova janela aberta via generalista para category.php,
Javascript. author.php, e date.php.
home.php: A capa do site. search.php: Resultados de uma busca.
single.php: Um post sozinho. 404.php: Pgina de erro para contedo
page.php: Uma pgina. no encontrado.
Todos estes arquivos so usados para substituir o index.php quando encontrados de acordo com
os tags condicionais. Voc pode tornar estes arquivos ainda mais especficos variandos suas
derivaes de nome, ou mesmo alterando seu cdigo com expresses que usam os mesmos tags
condicionais.
Exemplos
Se o seu blog est em http://example.com/wp/ e um visitante clica em um link para uma pgina da
categoria como http://example.com/wp/category/your-cat/, WordPress procura por um modelo
arquivo no diretrio do tema atual que corresponde ao ID da categoria.
Se a categoria de identificao 4, o WordPress procura por um arquivo de modelo category-
4.php . Se estiver em falta, o WordPress procura por um arquivo de modelo genrico,
category.php .
Se este arquivo no existe o WordPress procura por um arquivo de modelo genrico, archive.php.
Se no exisitir, ento ele procura pelo arquivo principal, index.php .
Se um visitante vai para sua homepage na http://example.com/wp/, o WordPress primeiro
determina se h uma Pgina esttica. Se uma pgina esttica foi definida, o WordPress exibe
primeiro a pgina principal e depois esta pgina definida, de acordo com o modelo de hierarquia.
Se uma pgina esttica no foi definida, ento o WordPress procura por um arquivo home.php e o
usa para gerar a pgina solicitada.
Se no h arquivo home.php, o WordPress procura por um arquivo chamado index.php no
diretrio do tema ativo, e usa esse modelo para gerar a pgina.
Dentro do arquivos CSS no necessrio oferecer o endereo completo de imagens, uma vez
que elas sero sempre relativas folha de estilo.
h1 { background-image: url('images/my_background.jpg'); }
<?php
// Antes de fechar a tag <head>:
wp_head();
?>
Template tags
Template Tags so utilizadas nos modelos do seu blog para exibir informaes de forma dinmica
ou personalizar seu blog, fornecendo as ferramentas para possibilitar a voc desfrutar ao mximo
das possibilidades de personalizao que o WordPress oferece. Abaixo est uma lista das tags
que esto disponveis no WordPress, classificadas por categoria de funo especfica.
Veja a referncia de funes.
O Loop
O loop a estrutura bsica do Wordpress. Assim chamado, ele recebe uma query string e executa
tudo o que est em seu interior, instanciando as variveis em um objeto que serve de referncia
para funes sintaxicamente comuns e fceis de se lembrar.
Comeamos verificando se existem posts chamados e instanciando as variveis, e terminamos
fechando os comandos PHP.
Exemplos de loop
<?php
query_posts('category_name=categoria_qualquer&posts_per_page=
15'); ?>
<?php while (have_posts()) : the_post(); ?>
<!-- Faz coisas com a categoria_qualquer. -->
<?php endwhile;?>
Estrutura
Um plugin basicamente um arquivo PHP com um cabealho que ser usado para exibio na
pgina administrativa de plugins. Este arquivo pode ser bem simples ou pode chamar vrios
outros scripts, criar tabelas no banco de dados, e elaborar toda uma estrutura de dados prpria,
ficando bem complexo.
O seguinte modelo de cabealho usado para que o WordPress detecte um plugin colocado
dentro da pasta wp-content/plugins/. Sem este cabealho um plugin sequer pode ser ativado no
painel de administrao.
<?php
/*
Plugin Name: Nome do Plugin
Plugin URI: http://URI_do_plugin
Description: Descrio de 140 caracteres.
Version: Nmero de verso
Author: Nome do autor
Author URI: http://URI_do_autor
License: Um "slug" da licena, algo como GPL2
*/
?>
API de Plugins
O WordPress quando carregado pelos navegadores, para cada etapa deste carregamento faz
uma pequena verificao para checar se h algum plugin ou tema que pede para que algo seja
executado ali naquele momento. Neste caso, o que ser executado uma funo enganchada,
(e da o nome hook). Estas funes so chamadas por estruturas divididas em duas categorias,
de acordo com a sua funcionalidade:
Aes: eventos disparados em certos momentos durante a execuo;
Filtros: lanados no momento de gravao ou apresentao de texto;
Os arquivos dos plugins funcionam principalmente base de ganchos (hooks), e aqui muito
importante a fixao deste conceito.
Sucintamente, estas estruturas no so nada mais que verificadores durante o processamento
do Wordpress. Atravs de um gancho voc atrela determinada funo um evento, acabando por
executar esta funo quando este evento ocorrer no carregamento.
Para definir os ganchos voc pode se perguntar Em que momento devo fazer isso? para cada
ao e ento verificar a lista de ganchos de aes e filtros para achar qual lhe atende. Existem
aes imaginveis para qualquer situao do WordPress. D uma olhada na referncia de aes,
pois esta parte do desenvolvimento bem flexvel.
Por exemplo, se quisermos exibir um alerta em Javascript de que a pgina terminou de ser
carregada para toda e qualquer pgina de uma instalao, podemos fazer assim:
<?php
add_action ('wp_footer', 'exibe_alerta');
function exibe_alerta() {
?>
<script type=text/javascript>
alert(Pgina carregada!);
</script>
<?php
}
?>
<?php
add_action('publish_post', 'avisar_admin');
function avisar_admin($id) {
$p = get_post($i = $id);
$email = get_option('admin_email');
$assunto = Novo post: $p->post_title;
$conteudo = apply_filters('the_content', $p-
>post_content);
if (wp_mail ($email, $assunto, $conteudo))
return true;
return false;
}
?>
Este pequeno trecho de cdigo, embora com uma funcionalidade simples, assume o
conhecimento de algumas propriedades do WordPress. Vamos por partes.
Antes de mais nada registramos o que queremos fazer. A funo add_action ('publish_post',
'avisar_admin') registra que a funo avisar_admin deve ser lanada sempre um um post for
publicado. Esta ao passa o ID do post publicado para a funo especificada, o que obrigatrio
caso queiramos utilizar informaes deste post na funo.
A funo $p = get_post ($i = $id) retorna um objeto post, que so todas as informaes do post
especificado por $id, tais como o contedo, autor, data de publicao, etc. Com isso temos o
objeto em mos para utilizar onde queremos.
A funo get_option() consulta diversas opes centrais do blog, tais como o endereo, pasta de
uploads, ttulo e subttulo, etc. Aqui queremos o e-mail do administrador.
Colocamos no assunto uma descrio que envolva o ttulo do post publicado. O item post_title
do objeto $p este ttulo.
A funo apply_filters aplica o filtro do parmetro um ao parmetro dois. H um filtro padro do
WordPress chamado the_content, este filtro formata um texto para adequar-se ao contedo de
um post. Coisas em HTML como adicionar quebras de linha, abertura e fechamento de
pargrafos, ou correes de tags quebradas. Tambm adiciona molduras legendadas s fotos.
Enfim, aqui a usamos para formatar a mensagem que ser enviada por e-mail.
A funo wp_mail utiliza o recurso do servidor mais apropriado para o envio de correio eletrnico.
H plugins que usam esta funo para automatizar autenticaes SMTP, limpa de tags HTML, etc,
motivo pelo qual simplesmente no usado a mail(), do PHP.
Retorna portanto, verdadeiro se um e-mail foi enviado, ou falso caso haja falha. Assim o $email
receber uma $mensagem com o $assunto personalizado para qualquer publicao.
Referncia de funes
Os arquivos do WordPress definem vrias funes PHP teis. Algumas das funes, conhecidas
como Template Tags, foram definidas especialmente para uso nos Temas WordPress. Existem
tambm algumas funes relacionadas com aes e filtros (a Plugin API), que so portanto
usadas a princpio para desenvolvimento de Plugins. O resto usado para criar as
funcionalidades ncleo do WordPress.
Muitas das funes ncleo do WordPress se teis aos desenvolvedores de Temas e Plugins.
Ento, este artigo lista a maioria das funes ncleo, excluindo as Template Tags. Ao final da
pgina, tem uma seo listando outros recursos para se encontrar informaes sobre as funes
do WordPress. Alm dessas informaes, o WordPress phpdoc site detalha todas as funes do
WordPress por verses desde a 2.6.1.