• Home
• Bastidores
• Design
• Destaques
• Dicas e tutorias
• Entre o sistema
• Mr. WP Themes
• Notícias
• Plugins
• Temas

Assinantes

3 maneiras diferentes de customizar a função the_excerpt

Primeiro tuto do blog…

Bom, eu lembro muito bem quando quebrava a cabeça com isso. No início de 2005(acho) quando comecei a "futucar" o WordPress sempre apanhava com as tais tags the_excerpt e the_content. Eu queria de qualquer maneira limitar a quantidade de palavras que elas geravam.

Por padrão quando você queria exibir apenas um resumo do post em vez do post inteiro na home, você optava por usar o more ou usar a tag <?php the_excerpt();?> no lugar de <?php the_content('leia mais..');?>.

Não sei se fui bem claro. Mas enfim, a the_content quando usada exibe o conteúdo do post por inteiro (se não usado o more), já o the_excerpt exibe só um resumo do post, que por padrão, chama os últimos 55 caracteres.

Se mesmo assim não entendeu, abra o index.php do seu tema e com certeza você vai encontrar uma dessas duas tags lá. Na verdade pra quem já é intimo dos temas do WordPress é mais fácil de entender.

Focando no assunto… Como já disse, por padrão, o Wordpress exibe só os últimos 55 caracteres do post quando usado o the_excerpt. Mas e se você quisesse mais ou menos caracteres? Bom, há uma solução, na verdade, TRÊS e nenhuma delas usando plugins, ou seja, você só vai usar o que o WordPress oferece…

1ª Maneira: Editando o formating.php

Abra o arquivo formating.php na pasta wp-includes/. Lá exatamente na linha 810, você irá encontrar um código como esse:
function wp_trim_excerpt($text) { // Fakes an excerpt if needed global $post; if ( '' == $text ) { $text = get_the_content(''); $text = apply_filters('the_content', $text); $text = str_replace(']]>', ']]>', $text); $text = strip_tags($text); $excerpt_length = 55; $words = explode(' ', $text, $excerpt_length + 1); if (count($words) > $excerpt_length) { array_pop($words); array_push($words, '...'); $text = implode(' ', $words); } } return $text; }

É esse o código responsável pelas funções do the_excerpt. Agora observem a linha:

$excerpt_length = 55;
Precisa falar mais alguma coisa? Apenas edite o número para que ele chame a quantidade de caracteres que você quer que seja exibida, depois logicamente, faça o upload de volta pro wp-includes e se necessário, substituindo o arquivo original. Daí sempre que você usar o the_excerpt ele vai gerar só a quantidade de caracteres que você configurou.

Porém há um ponto negativo: Tenha um backup desse arquivo que você editou, pois sempre que você atualizar o WordPress você terá que re-enviar o mesmo.

Ps: Essa é a mais simples.

2ª Maneira: Criando um resumo personalizado

Caso você não saiba, na mesma tela onde você escreve seus posts, há um campo responsável por criar um resumo do post personalizado.
Não encontrou? O campo fica meio escondido como uma aba em abaixo dos "uploads".

Para usá-lo é só escrever o que você quiser no campo, publique o post e pronto. Daí, em vez de exibir os tais 55 caracteres, ele exibe o que você escreveu no campo. O único problema mesmo é que da um pouquinho de trabalho, já que não é automático. Portanto você terá que criar um desses pra cada post.

3ª Maneira: Usando programação!

O Ezequiel da comunidade WordPress Brasil no Orkut, postou uma dica de como limitar a quantidade de caracteres. Só que nessa dica é criada uma nova tag, ou seja, não se usa nem the_excerpt e nem the_content.

Não sei explicar muito bem o que cada código faz, já que não sou nenhum expert em php, mas vou fazer um "copy-paste" de como ele fez (com a devida autorização)!

Coloque o seguinte código no header.php do tema, na primeira linha de preferência.

<?php function limit_the_content($excerpt_length = 55, $resume = 'Continue Lendo »', $resume_link = true) { global $post; if($resume_link) $resume = '<a href="'.get_permalink().'" title="'.$resume.'">'.$resume.'</a>'; $text = get_the_content(''); $text = apply_filters('the_content', $text); $text = str_replace(']]>', ']]>', $text); $text = strip_tags($text); $words = explode(' ', $text, $excerpt_length + 1); if (count($words) > $excerpt_length) { array_pop($words); array_push($words, $resume); $text = implode(' ', $words); } echo $text; } ?>

Simples, em vez de usar <?php the_content(); ?> ou <?php the_excerpt(); ?> você usará uma nova tag :

<?php limit_the_content(); ?>

Personalizando:

<?php limit_the_content(palavras, more, link); ?>

Palavras: A quantidade de palavras que será exibida.
more: É o que vai ser exibido no fim do resumo, no caso é Continue Lendo, mas claro que poderá ser editado.
link: coloque como "false" se não quiser que "Continue lendo" aponte para um link pro resto do post e TRUE para o contrário.

Exemplo:

<?php limit_the_content(25, "(...)", false); ?>

O código acima vai exibir as últimas 25 palavras do post, terminará o resumo com um "(…)" que não apontará para nenhum link.

E é isso, espero que tenham gostado!

Posts relacionados

• 48 maneiras diferentes de usar o WordPress!
• Dica: Personalizando datas no WordPress
• Explorando as Template Tags
• Criando uma caixa de texto para divulgar seus posts
• Promoção de páscoa!! Ganhe um Pen Drive de 2GB!

Populares

• Criando um Slide Show de imagens com o WordPress [SEM PLUGINS]
• FAQ para iniciantes
• 3 maneiras diferentes de customizar a função the_excerpt
• Criando uma imagem (thumbnail) para cada post [sem plugins]
• Explorando as Template Tags

MrWP » Free Themes

BB Clean Theme

Simple Blue Magazine