Archive for March, 2011

Building a WordPress Rewrite Rule(Passing and Receiveing Parameters Using Permalink Url)

When you are working with WordPress, sometimes you may need to pass parameters to a page where you want to display posts data using the permalink url structure, e.g. http://yoursite/yourpage/2011/03/ where 2011 is the value for a year variable and 03 is the value for a month variable.
Quando você está trabalhando com WordPress, às vezes você pode precisar passar parâmetros para uma página onde quer exibir dados de posts usando a estrutura de url de permalinks, por exemplo, http://yoursite/yourpage/2011/03/ onde 2011 é o valor para uma variável de ano e 03 é o valor para uma variável de mês.

So, let’s take a look on the code.
Então, vamos dar uma olhada no código.

<?
// here we register the variables that will be used as parameters on the url
function add_my_var($public_query_vars) {
    $public_query_vars[] = 'yvar'; // year
    $public_query_vars[] = 'mvar'; // month
    return $public_query_vars;
}
add_filter('query_vars', 'add_my_var');

// building the rewrite rules, for the two parameters
function do_rewrite() {
     add_rewrite_rule('(yourpage)/[/]?([0-9]*)[/]?([0-9]*)$', 'index.php?pagename=yourpage&yvar=$matches[2]&mvar=$matches[3]','top');
}
add_action('init', 'do_rewrite');
?>

Now you are able to open a url like http://yoursite/yourpage/2011/03/, receiveing and printing some parameters. Here goes the code for printing the parameters on yourpage page.
Agora você é capaz de abrir uma url como http://yoursite/yourpage/2011/03/, recebendo e imprimindo alguns parâmetros. Aqui vai o código para imprimir os parâmetros na página yourpage

<?
echo "year:" .get_query_var( 'yvar' ) ."<br>";
echo "month: " .get_query_var( 'mvar' ) ."<br>";
echo "page :" .get_query_var('paged') ."<br>";
?>

There’s a important tip. After registering or changing any rewrite rule, go to wp-admin and simply visit the permalink settings page. It flushes all rules, so it will make your changes work 😉
Há uma dica importante. Depois de registrar ou mudar qualquer regra rewrite, vá até o wp-admin e simplesmente visite a página de configurações de permalink. Ela zera todas as regras, então isso vai fazer suas mudanças funcionar 😉

For further info, visit the Codex.
Para maiores informações, visite o Codex.

Advertisements

,

Leave a comment

WordPress Custom Taxonomy Page Example – Displaying Custom Post Types Posts

There is a little explanation before going to the code, you can read it or go straight to the code, copy it, paste it and make it work.
Há uma pequena explicação antes de ir ao código, você pode ler ou ir direto ao código, copiar, colar e fazer funcionar.

First of all, you’d better take a look on my two previous posts, about registering custom post types and displaying basic info from a custom taxonomy.
It will help you to understand where we are going.

Antes de mais nada, é melhor você dar uma olhada em meus dois posts anteriores, sobre registrar tipos de posts customizados e exibir informação básica de uma taxonomia customizada.
Isso vai te ajudar a compreender aonde estamos indo.

After a custom post type called ‘videos’ and a taxonomy called ‘genre’ are registered, and some posts are associated with the ‘scifi’ term on wp-admin, we will use the taxonomy.php page, on the theme directory, to retrieve content from the custom post type. So it’s good understand the WordPress template hierarchy.
Depois que um tipo de post customizado chamado ‘videos’ e uma taxonomia chamada ‘genre’ são registrados, e alguns posts são associados com o termo ‘scifi’ no wp-admin, nós vamos usar a página taxonomy.php, no diretório do tema, para retornar conteúdo do tipo de post customizado. Então é bom entender a hierarquia de templates WordPress.

Note that genre works like a “category menu” on wp-admin and scifiworks like a “specific category”.
Note que genre funciona como um “menu de categorias” no wp-admin e scifi funciona como uma “categoria específica”.

When you ask for a url like http://yoursite.com/genre/scifi on your browser, WordPress will search your theme directory for three files: “taxonomy-taxonomy-term.php”, “taxonomy-taxonomy.php” and “taxonomy.php” or, in our case, “taxonomy-genre-scifi.php”, “taxonomy-scifi.php” and “taxonomy.php”.

Quando você chama uma url como http://yoursite.com/genre/scifi no seu navegador, o WordPress vai procurar no seu diretório de temas três arquivos: “taxonomy-taxonomy-term.php”, “taxonomy-taxonomy.php” and “taxonomy.php” ou, no nosso caso, “taxonomy-genre-scifi.php”, “taxonomy-scifi.php” and “taxonomy.php”.

The code for the “taxonomy.php” page to display the “scifi” posts:
O código para a página “taxonomy.php” exibir os posts “scifi” é:

<?
// this line makes the page find the correct data when you call http://yourblog.com/genre/scifi on your browser
$term = get_term_by( 'slug', get_query_var( 'term' ), get_query_var( 'taxonomy' ) );

// here we print scifi name and description
echo $term->name;
echo $term->description;

// now let's retrieve the posts data
query_posts(array( 'post_type'=>'videos', 'genre' => $term->slug, 'posts_per_page' => -1 ));
if (have_posts()) :
  while (have_posts()) : the_post();
    $cttrm = get_the_terms( get_the_ID() , 'genre' );
    // here we print the term('category') name 
    foreach ( $cttrm as $txnam ) {
      echo $txnam->name."<br />";
    }
    echo get_the_title()."<br />";
    echo get_the_content()."<br />";
  endwhile;
endif;
?>

, ,

3 Comments

Get Post List With Thumbnails 2.0.0 – Displays a List With WordPress Posts and Custom Size Thumbnails

Get Post List With Thumbnails 2.0.0 is the second version of the second plugin I created for WordPress. It displays a posts list with thumbnails, and there’s some cool features you can configure on wp-admin.
Get Post List With Thumbnails 2.0.0 é a segunda versão do segundo plugin que criei para WordPress. Ele exibe uma lista de posts com thumbnails e há algumas características legais que você pode configurar no wp-admin.

Passing some parameters you will be able to control list orientation, display only images, display or not the post date, date format, display or not the post title, category of posts, the number of posts, number of registers per line(for horizontal orientation), the table width, and the thumbnails dimensions.
Passando alguns parâmetros, você será capaz de controlar a orientação da lista, exibição apenas de imagens, exibição ou não da data do post, o formato da data, exibição ou não do título do post, categoria dos posts, número de posts, números de registros por linha(para a orientação horizontal), a largura da tabela, e as dimensões dos thumbnails.

Take a look on the plugin installation page, and see how it works in a easy way.
Dê uma olhada na página de instalação do plugin e veja como ele funciona de maneira simples.

Please let me know if you are using the plugin(and if you allow, I’ll tweet your site to my friends) or if you have doubts and suggestions, cos this second version was based on some comments I’ve received from Get Post List With Thumbnails 1.0.0 users.
Por favor me avise se você estiver usando o plugin(e se você permitir, twittarei seu site para meus amigos) ou se você tiver dúvidas e sugestões, porque esta segunda versão foi baseada em alguns comentários que recebi dos usuários do YouTubeNails.

4 Comments

Displaying Info From a Specific Custom Taxonomy Term(Hierarchical Taxonomies) On WordPress

See also Custom Taxonomy Page Example.

I’ve written before about registering and displaying custom post types on WordPress. So you’d better check my previous post to understand what is coming next(the example bellow is based on the previous post).
Eu escrevi anteriormente sobre registrar e exibir tipos de posts customizados no WordPress. Então é melhor você conferir meu post anterior, para entender o que vem por aí(o exemplo abaixo é baseado no post anterior).

As you could see, one of the cool things about WordPress custom post types is that you can register also hierarchical taxonomies that will work as “regular” post categories for your custom post types.
Como você pôde ver, uma das coisas legais nos tipos de posts customizados do WordPress, é que você pode também registrar taxonomias hierárquicas, que vão funcionar como categorias “normais” para seus tipos de posts customizados.

Although these facilities, it took me some work to find a simple way to display some info from hierarchical taxonomies(or, let’s say custom categories), and bellow(in few lines), I’ll share the result of this work with you.
Apesar destas facilidades, me custou algum trabalho descobrir um jeito simples de exibir algumas informações das taxonomias hierárquicas, e abaixo(em poucas linhas), eu vou dividir o resultado deste trabalho com vocês.

<?
// # to retrieve an array with all info from a custom term 'scifi' 
// that "begins" to a hierarquical taxonomy called 'genre'
$term = get_term_by('slug','scifi','genre');

// the example above uses slug to retrieve the info, but you can
// use other parameters, try searching for get_term_by method on WordPress Codex

// # to display 'scifi' term description defined on wp-admin
echo $term->description . "<br>";

//# you can also display the name, slug, or even the term_id
echo $term->name . "<br>";
echo $term->slug . "<br>";
echo $term->term_id . "<br>";

//# to print the array and see all the available info
print_r($term);
?>

Hope you find it useful. As I said, it looks simple and easy, but took me some work to find. 😉
Espero que você ache útil. Como eu disse, parece simples e fácil, mas me custou algum trabalho descobrir. 😉

For further info, visit the Codex.
Para mais informações, visite o Codex.

,

1 Comment

YouTubeNails 2.0.0 – Displays Thumbnails for your YouTube videos on WordPress sites

YouTubeNails 2.0.0 is the second version of the first plugin I created for WordPress. Basically, it displays a thumbnail gallery based on all your posts that contains YouTube videos.
YouTubeNails 2.0.0 é a segunda versão do primeiro plugin que criei para WordPress. Basicamente, ele exibe uma galeria de thumbnails baseada em todos os seus posts que contém vídeos do YouTube.

The cool thing about it, is that you can choose between easily configure a widget on wp-admin, or call it as a short code where you want, passing some parameters that allows you to set things like the number of posts you want to display, their category, and even the thumbnails size.
O legal é que você pode escolher entre configurar facilmente um widget no wp-admin, ou chamá-lo como um short code onde quiser, passando alguns parâmetros que te permitem configurar coisas como o número de posts que quer exibir, a categoria deles e mesmo o tamanho dos thumbnails.

Take a look on the plugin installation page, and see how it works in a easy way.
Dê uma olhada na página de instalação do plugin e veja como ele funciona de maneira simples.

Please let me know if you are using the plugin(and if you allow, I’ll tweet your site to my friends) or if you have doubts and suggestions, cos this second version was based on some comments I’ve received from YouTubeNails users.
Por favor me avise se você estiver usando o plugin(e se você permitir, twittarei seu site para meus amigos) ou se você tiver dúvidas e sugestões, porque esta segunda versão foi baseada em alguns comentários que recebi dos usuários do YouTubeNails.

,

Leave a comment

%d bloggers like this: