Pular para o conteúdo

Códigos e funções do WordPress

Quem não esta acostumado a usar XHTML e muito menos código php, e mesmo assim arrisca ao tentar usar o WordPress.org ao invéz do wordpress.com (leia aqui para entender a difereça), sofre muito, alguns acabam se embaralhando com o código não tirando o ’proveito’ máximo que o wordpress.org pode trazer.

Extraindo e traduzindo algumas informações do codex do wordpress, vou ensinar alguns dos principais códigos usados para montar elementos indispensáveis para a criação de um site ou um blog.

O loop!

Creio que este seja o código mais importante perante os demais. O Loop é usado para o wordpress mostrar os posts que você escreveu que estão armazenados no banco de dados.

A maioria dos temas, acho que quase todos, tem o Loop assim:

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>

E terminara assim:

<?php endwhile; ?>

Básicos

São os códigos básicos para montar elementos iniciais no template. É praticamente impossível não usá-los! Abaixo alguns:

<?php the_author(); ?> – Este código tem a função de exibir o nome do autor do post.

<?php the_date(’d / m / Y’); ?>- Mostra a data em que o Post foi publicado

<?php the_time(’g:i a’); ? >- Mostra a hora em que o Post foi publicado.

<?php the_author_email(); ?>- Exibe o e-mail do autor que publicou o post.

<?php the_title(); ?>- Responsável por exibir o título do post

<?php the_permalink() ?>- Exibe o link do Post (permalink)

<?php get_calendar(); ?>-Exibe o calendário do seu Blog

Todos eles devem ser usado dentro do Loop. Usando a criatividade podemos montar os códigos da seguinte maneira:

Publicado por <a href="mailto:<?php the_author_email (); ?>"><?php the_author(); ?> </a> em <? php the_date(’d / m / Y’); ?> � s <?php the_time (’g:i a’); ?>.

vai ser exibido assim:

Públicado por Carlos , em 06 / 03 / 2007 ás 2:47 pm

Perceberam que onde esta "Carlos" é exibido um link de e-mail para autor que públicou o post. Isso aconteceu graças a função de e-mail(mostrada acima) eu apenas inseri o código <a href="mailto:<?php the_author_email(); ? >">php the_author(); ?></a>, sendo que o href tem a função no HTML de fazer links, assim seria exibido o e- mail do autor no lugar do código <?php the_author_email(); ? >, fazendo portanto um link de e-mail automático para cada autor.

Outro truque parecido é fazer o título do post em Link, o processo é quase o mesmo, só mudando os códigos necessários:

<a href="<?php the_permalink() ?>" ><?php the_title(); ?></a>

Vai ser exibido assim:

TITULO DO POST

Conteúdo dos posts

Outro código importante e sem dúvida é indispensável é o uso do código <?php the_content(’’); ?> , é com ele que é possível a exibição do conteúdo do post e também da personalização da tag <!–more–> que é usada para fazer "resumos" dos posts. Pode ser encontrado nos arquivos index.php , single.php, search.php, etc. Você pode substituir o código do seu template por estes para ver como funciona.

<?php the_content(’’); ?>- Mostra o conteúdo do posts por completo (se o mesmo não tiver a tag more dentre seus códigos) e também não exibe o link de "leia mais.."

<?php the_content(’Leia mais…’); ?> Mesma função acima, só que quando o post usa a tag <!– more–> é exibido o link "leia mais…".

<?php the_content("Continue lendo… " . the_title(’’, ’’, false)); ?>- Também a mesma função das outras, só que mostra: " Continue lendo…TITULO DO POST", ou seja, mostra o titulo do posts onde é colocado a tag <!–more–>

Abaixo um exemplo de um post que usa tags <!–more–>.

A maioria dos bloqueiros conhecem o WordPress(inclusive o PontoXP é feito com este sistema). Infelizmente na semana passada, durante uns 4 dias, do download da versão 2.1.1 do sistema esteve infectada por spywares.Continue lendo… WordPress é atacado por crackers

A tag <?php the_content(’’); ?>- também pode ser subistituída por outra,chamada de <?php the_excerpt(); ?> *, é geralmente usada no arquivo search.php para facilitar os resultados das buscas. Ela gera automáticamente um resumo do código, sem necessidade de você inserir tags como <!– more–>. Veja um exemplo de um post usando ela:

A maioria dos bloqueiros conhecem o WordPress(inclusive o PontoXP é feito com este sistema). Infelizmente na semana passada, durante uns 4 dias, do download da versão 2.1.1 do sistema esteve infectada por spywares[…]

*nota-se que não exibido nenhum link de "leia mais" ou "continue lendo", pois a função da tag é gerar um resumo automático, no fim do post você vai ver conchetes como estes […]

Posts em lista e Query Posts

Eis um código que é indispensável para quem quer fazer do wordpress, um sistema CMS para gerenciar todo o conteúdo do site. Abaixo eu vou mostrar como fazer de uma maneira super simples uma lista dos posts, determinando qual categoria será exibida e muito mais! Segue o código básico que deve ser inserido entre o loop:

<ul><li><span><?php the_time (’d-m-y’) ?></span><a href="<?php the_permalink() ?>"><?php the_title(); ?></a> </li></ul>

Vai ficar assim no seu XHTML:

<?php while (have_posts()) : the_post(); // start your Loop ?>

<ul><li><span><?php the_time(’d-m- y’) ?></span><a href="<?php the_permalink () ?>"><?php the_title(); ?></a></li> </ul>

<?php endwhile; ?>

É simples,basicamente a tag <?php the_permalink() ?> faz o link. Não tem segredo.

Agora se você quer exibir listas de posts de uma determinada categoria, é mais fácil ainda usando Query Posts. É só colocar em cima do Loop o código correspondente, assim:

<?php query_posts (’posts_per_page=6&cat=5’); ?>

<?php while (have_posts()) : the_post(); // start your Loop ?>

<ul><li><span><?php the_time(’d-m- y’) ?></span><a href="<?php the_permalink () ?>"><?php the_title(); ?></a></li> </ul>

<?php endwhile; ?>

Vamos analizar o código para você entender:

<?php query_posts (’posts_per_page=6&cat=5’); ?>

posts_per_page=6 mostra o número de itens que você quer se seja exibido na lista, onde "6" é número (exemplo)….altere como você quiser

&cat=5 – Determina qual categoria será exibida, onde "5" é a ID da categoria (Para saber a ID, é só ir no Painel de controle do wordpress-> Gerenciar-> Categorias).

Resultado:

Você pode ter quantas listas quiser, desde que faça um loop para cada uma.

Fácil, fácil….

Comentários

Agora alguns códigos para personalização dos comentários do seu site. Primeiro abra o arquivo comments.php( fica na pasta do tema), é nele que se encontra todos os códigos que nós vamos estudar.

<?php comment_text() ?> – Mostra o texto, o conteúdo, de cada comentário.

<?php comment_date() ?> – Mostra a data exata que o comentário foi enviado

<?php comment_time(’H:i:s’); ?> – Mostra a Hora que o comentário foi enviado.

<?php comment_author_link() ?> – Mostra o nome do autor do comentário, junto com um link para o site dele.

<?php comment_author(); ?> – Mostra o nome do autor do comentário.

<?php comments_number(__(’0 ’), __(’1 comentário’), __(’% comentários’)); ?> – Mostra o número de comentário do post, podendo ser personalizável.

<?php if ($comment->comment_approved == ’0’) : ?> <p><em> Seu comentário precisa ser aprovado</em></p> <?php endif; ?>

– mostra uma mensagem, que é exibida quando o usuário envia um comentário dizendo que o comentário precisa ser aprovado.

Categorias

Alguns códigos ótimos para personalizar as categorias do seu wordpress. Abra o arquivo category.php que é o arquivo do template das categorias do blog.

<?php echo single_cat_title(); ?> – Exibe o título da categoria

<?php echo category_description(); ?> – Exibe a descrição dela ( primeiro deve-se criar a descrição no painel de controle )

<?php wplistcats(); ?> – Mostra em forma de lista todas as categorias do site

<?php the_category(’ , ’) ? > – Mostra qual ou quais categorias o Post foi públicado (ideal em ser usado no single.php)

Blog Info (informações do blog)

Têm a função de exibir informações sobre seu Blog, são varias tags, todas fáceis…Eu pessoalmente uso no header.php para montar as tags <head>. Abaixo estão as básicas, logo depois ensinarei como montar algumas tags no header.php.

<?php bloginfo(’name’); ? > – Exibe o título do seu Blog

<?php bloginfo(’charset’); ? > – Mostra o Charset que seu Blog usa

<?php bloginfo (’description’); ?> – Mostra a descrição do seu Blog

<?php bloginfo(’rss2_url’); ?> – Exibe a URL do RSS do seu Blog

<?php bloginfo (’pingback_url’); ?> – Mostra o pingback

<?php bloginfo (’stylesheet_url’); ?> – Exibe a URL da folha CSS do atual tema

Bom, usando os códigos acima da para montar no header.php, entre as tags<head> e </head> os seguintes efeitos:

<link rel="alternate" type="application/rss+xml" title="RSS 2.0" href="<?php bloginfo(’rss2_url’); ?>" / >

<link rel="alternate" type="application/atom+xml" title="Atom 0.3" href="<?php bloginfo(’atom_url’); ?>" / >

<link rel="pingback" href="<?php bloginfo(’pingback_url’); ?> " />

<style type="text/css" media="screen">@import url( <?php bloginfo (’stylesheet_url’); ?> );</style>

Verde: habilita o uso do RSS 2.0 no seu site/blog

Azul: habilita o uso do Atom 0.3 no seu site/blog

Vermelho: Habilita o uso do pingback

Rosa: importa a seu arquivo CSS do tema para ser usado no seu blog.

Coloque os códigos acima no seu header e você terá os efeitos desejados.

Include Tags

Ótimo quebra-galho se você não quer usar a função include para chamar os arquivos do seu tema. Funciona como template. Veja abaixo o que elas podem fazer:

<?php get_header(); ?> – Inclui na página o arquivo header.php, puxando o mesmo.

<?php get_footer(); ?> – "Puxa" o rodapé da sua página, chamando o arquivo footer.php

<?php get_sidebar(); ?> – "Puxa" a sidebar

<?php comments_template(); ?> – Inclui o arquivo coments.php do seu atual tema. Deve ser usado no single.php pois este código faz aparecer os comentários da sua página.

Usando os códigos acima, da pra fazer páginas customizadas como as " erro 404". Faça assim:

<?php get_header(); ?> <h2>Página não encontrada!</h2> <?php get_sidebar(); ?> <?php get_footer(); ?>

Salve como 404.php no diretório do tema que você usa. Justamente a linha acima vai fazer aparecer uma página onde tem a sidebar, o rodapé, e também as tags <head> e </head>, depois é só acessar qualquer posts inexistente e você verá esta página, lembrando que talvez você terá alinhar algumas linhas com CSS.

Poupem trabalho usando estes códigos. É simples e fácil.

Finalizando…

Não foram abordados aqui alguns códigos cujos os mesmo eram mais complexos e/ou
de utilidade muito baixa. Enfim, o wordpress é super personalizado, você pode deixar seu blog como quiser…desde que saiba os principais códigos e um pouco de CSS+XHTML.

Qualquer dúvida ou sugestão você pode fazer um comentário usando o formulário logo abaixo. E não esqueçam que agora você pode escrever seu próprio artigo/dica/notícia para o pontoxp, é só clicar no banner correspondente na home page.

Até mais!