Como criar um tema para o WordPress – parte II

Na primeira parte do tutorial expliquei como funciona um tema WordPress em linhas gerais e sobre os arquivos screenshot.png, style.css e header.php. Nesta segunda parte explicarei sobre o corpo principal do tema, o index.php.

Como vocês podem ver na imagem do corpo principal, este trecho está dividido em cinco partes bem distintas, são elas: o título do post, o conteúdo do post, o link para comentar, o autor e a data. Este é o conteúdo que irá se repetir até que não tenha mais posts ou o número de posts configurado para ser exibido na página principal seja alcançado. Esse é o famoso Loop do WordPress.

Vamos dar uma olhada no código HTML do template referente a este trecho.

<div id="container">
<div id="primaryContent">
<h2>Website Kulor on top yet again website Kulor on top yet again</h2>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Fusce condimentum nibh. Sed eros tellus, <strong>semper</strong> vel, dignissim at, feugiat sit amet, leo.</p>
<div id="comments">
<dl id="status">
<dt>Comments (1)</dt>
<dd>| <a href="#">Add comment</a></dd>
</dl>
<dl class="comment">
<dt><a href="#">John Doe</a></dt>
<dd class="date">on Wed 5 Aug 06</dd>
</dl>
</div>
</div>

E como fica o código com as tags do WordPress.

<?php get_header(); ?>
<?php if (have_posts()) : while (have_posts()) : the_post(); ?>
<div id="container">
<div id="primaryContent">
 <li ><code><h2><a href="<?php the_permalink() ?>" rel="bookmark"><?php the_title(); ?></a></h2>
<p><?php the_content(); ?></p>
<div id="comments">
<dl id="status">
<dt><a href="<?php the_permalink(); ?>"><?php comments_number('Nenhum coment&amp;aacute;rio', 'Um coment&amp;aacute;rio', '% coment&amp;aacute;rios' );?></a></dt>
</dl>
<dl class="comment">
<dt><?php the_author(); ?></dt>
<dd class="date">dia <?php the_time('j \d\e\ F \d\e\ Y'); ?></dd>
</dl>
<?php endwhile; else: ?>
<p><?php _e('Nenhum post encontrado.'); ?></p>
<?php endif; ?>
<?php posts_nav_link(' &amp;#8212; ', __('&amp;laquo; P&amp;aacute;gina anterior'), __('Pr&amp;oacute;xima p&amp;aacute;gina &amp;raquo;')); ?>
</div>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Agora o que significa cada uma dessas tags. Antes é importante esclarecer que o index.php é o arquivo base do tema e é por isso que nós vamos inserir nele os demais arquivos do tema, como o cabeçalho, o menu e o rodapé. Vamos lá.

• get_header() – insere o código do header.php, isto é, o cabeçalho do tema;
• if (have_posts()) : while (have_posts()) : the_post() – aqui na verdade nós temos três funções e elas é que dão início ao LOOP. A primeira tag verifica se há posts, a segunda solicita que, enquanto existir post continue no loop e a terceira “pega” todas as informações do post, como o título, conteúdo, data, autor, etc. É comum encontrar tags que só funcionam dentro do loop, isto quer dizer que a tag só irá retornar algum valor se estiver inserida após estas funções e antes de endwhile; e endif;, que terminam o loop.
• the_permalink() – o link do post;
• the_title() – o título do post;
• the_content() – o conteúdo do post;
• comments_number() – insere o número de comentários feitos no post. Além disso adiciona um texto dependendo da quantidade de comentários. Se não houver comentários a tag irá inserir o texto “Nenhum comentário”, se tiver apenas um comentário, irá inserir “Um comentário” e para mais de um comentário irá inserir “N comentários”, onde N é a quantidade de comentários, claro;
• the_author() – o autor do post;
• the_time() – a data em que o post foi postado;
• endwhile; else: – encerra o loop e adiciona a condicional que, se não houver nenhum post insira o conteúdo abaixo;
• _e(‘Nenhum post encontrado.’) – este é conteúdo que irá ser inserido caso não exista nenhum post;
• endif; – termina a condicional que verifica se há posts;
• posts_nav_link() – adiciona links de navegação, “próxima página” e “página anterior”;
• get_sidebar() – insere o menu lateral, que veremos na próxima etapa do tutorial;
• get_footer() – e por último, mas não menos importante, insere o rodapé.

Pronto, mais uma parte do nosso tutorial concluída. Até a próxima!