{"id":626,"date":"2011-02-05T22:49:17","date_gmt":"2011-02-06T01:49:17","guid":{"rendered":"http:\/\/www.subterfugios.net\/blog\/?p=626"},"modified":"2011-02-05T23:40:09","modified_gmt":"2011-02-06T02:40:09","slug":"wordpress-arquivos-anuais-no-menu-dinamico","status":"publish","type":"post","link":"https:\/\/www.subterfugios.net\/blog\/wordpress-arquivos-anuais-no-menu-dinamico\/","title":{"rendered":"WordPress: arquivos anuais no menu din\u00e2mico"},"content":{"rendered":"

\"\"<\/a>

O objetivo.<\/p><\/div> Eu estava atualizando o tema do meu WordPress ontem e descobri que n\u00e3o havia maneira de configurar a lista de arquivos agrupada por ano, n\u00e3o meses (padr\u00e3o). Depois de um tempo analisando o c\u00f3digo-fonte e pesquisando na web, achei uma maneira legal de fazer isso. Vou compartilh\u00e1-la aqui, em dois idiomas, assim outras pessoas n\u00e3o precisam gastar o tempo que gastei com isso (de qualquer jeito, foi divertido).<\/p>\n

Se voc\u00ea fizer algumas buscas no c\u00f3digo PHP do WordPress, voc\u00ea vai perceber que widgets como o “Arquivos” s\u00e3o carregados no arquivo wp-includes\/default-widgets.php<\/code>. Se voc\u00ea alterar essa linha:<\/p>\n

<?php wp_get_archives(apply_filters('widget_archives_args', array('type' => 'monthly', 'show_post_count' => $c))); ?><\/code><\/p>\n

para:<\/p>\n

<?php wp_get_archives(apply_filters('widget_archives_args', array('type' => 'yearly', 'show_post_count' => $c))); ?><\/code><\/p>\n

Funcionar\u00e1. Mas, hey, n\u00e3o \u00e9 uma t\u00e1tica muito boa. Note o caminho do arquivo que voc\u00ea est\u00e1 alterando: wp-includes\/default-widgets.php<\/code>. N\u00e3o est\u00e1 dentro da pasta de temas. Isso significa que seu novo menu de arquivos desaparecer\u00e1 na pr\u00f3xima vez que voc\u00ea atualizar sua instala\u00e7\u00e3o do WordPress. Para evitar isso, voc\u00ea pode aproveitar o mecanismo de hooks<\/em> do WordPress<\/a>. O objetivo deste mecanismo \u00e9 exatamente expor alguns pontos de extens\u00e3o que podem ser usados por desenvolvedores de plugins e temas, assim eles n\u00e3o tem que ficar fu\u00e7ando no c\u00f3digo do n\u00facleo do WordPress. <\/p>\n

O widget Arquivos prov\u00ea um hook chamado “widget_archives_args” (dispon\u00edvel no WP >= 2.8). Voc\u00ea pode pendurar sua fun\u00e7\u00e3o neste hook, e ela ser\u00e1 usada como um filtro para os par\u00e2metros passados para wp_get_archives pela implementa\u00e7\u00e3o do widget. Nesta intercepta\u00e7\u00e3o, voc\u00ea pode alterar o tipo do arquivo para “yearly” (anual) atrav\u00e9s do seguinte trecho de c\u00f3digo:<\/p>\n

function yearly_archives_callback($args) { $args['type'] = 'yearly'; return $args; }
\nadd_filter('widget_archives_args', yearly_archives_callback);<\/code><\/p>\n

Coloque isso no in\u00edcio do arquivo functions.php do seu tema. Em sua sidebar, o widget agora mostrar\u00e1 uma lista de anos e, se voc\u00ea assim o configurou, o n\u00famero de posts naquele ano. Dado que o arquivo functions.php est\u00e1 dentro do diret\u00f3rio do seu tema, ele n\u00e3o ser\u00e1 sobrescrito em uma atualiza\u00e7\u00e3o do WordPress. Voc\u00ea apenas tem que cuidar para n\u00e3o usar o tema padr\u00e3o (twentyten) sem renome\u00e1-lo. Do contr\u00e1rio, o esfor\u00e7o de colocar o c\u00f3digo dentro do tema ter\u00e1 sido em v\u00e3o.<\/p>\n

This post is also available in english<\/a>.<\/p>\n