Guida alla installazione e configurazione di ultimate tag warrior 3, un plugin per wordpress 2.2 che permette di introdurre i tags nel vostro blog.
Ultimate Tag Warrior 3 è un plugin per Wordpress che permette di integrare una tag cloud nel nostro blog.
L'installazione è molto semplice: scaricare il pacchetto dal sito ufficiale http://www.neato.co.nz/ultimate-tag-warrior/.
Scompattarlo e copiare la cartella contenuta in plugins/ nella cartella plugins/ della nostra insallazione wordpress.
Aprire la cartella themes, aprire example-bits e copiare nel nostro tema i files tags.php, tag.php e searchtags.php.
A questo punto aprire il pannello wp-admin di Wordpress, attiviamo il plugin e lo configuriamo: andare su Manage, selezionare il pannello Tags. Abilitiamo alcune opzioni utili, come l'url rewrite, gli embedded tags, gli automatic feed tags.
Se il blog è già avviato da tempo, conviene utilizzare la comoda opzione di ispezionare i post già inseriti ed aggiungere i tags in funzione delle categorie a cui questi post sono assegnati, selezionando "Automatically add categories as tags".
Salvare le impostazioni, cliccare "Manage Tags" e scorrere fino a Import Embedded Tags e cliccare il pulsante omonimo. Come sottolinea il commento sulla pagina, mi raccomando i backups!
A questo punto visualizziamo la nostra bella tag cloud nella sidebar del sito... o dove volete voi! Come si fa?
Aggiungete l'istruzione
<div class="sidebartags"><?php UTW_ShowWeightedTagSetAlphabetical("coloredsizedtagcloud","","25") ?></div>
nel template, dove volete che si posizioni, ad esempio in sidebar.php.
Ora cliccando sui tags verrà aperta la pagina tag.php, che quindi dovrà essere sistemata in modo da essere bene integrata nel template grafico e per la lingua in uso. Ad esempio la mia pagina, per il sito che state leggendo ora, era così:
<?php get_header(); ?>
<div id="center">
<h2><?php UTW_ShowCurrentTagSet('tagsetcommalist') ?></h2>
<?php if (have_posts()) : ?>
<?php while (have_posts()) : the_post(); ?>
<div class="post" id="post-<?php the_ID(); ?>">
<div class="dateline"><span class="date"><?php the_time('DdMY') ?></span><span class="time"><?php the_time('hiA') ?> <!-- by <?php the_author() ?> --></span></div><h2 class="posttitle"><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2>
<h3 class="tags"><?php UTW_ShowTagsForCurrentPost("commalist", array('last'=>' and %taglink%', 'first'=>'tagged %taglink%',)) ?></h3>
<div class="entry">
<?php the_content('Read the rest of this entry »'); ?>
</div>
<?php edit_post_link('Edit','','/'); ?><?php comments_popup_link('No Comments »', '1 Comment »', '% Comments »'); ?><br />
</div>
<?php endwhile; ?>
<?php else : ?>
<h2 class="center">Non trovata</h2>
<p class="center">Spiacenti, ma la pagina cercata non è stata trovata.</p>
<?php include (TEMPLATEPATH . "/searchform.php"); ?>
<?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>
ed è stata trasformata in
<?php get_header(); ?>
<div id="primaryContent" class="tags">
<h2>Stai visualizzando i post con tag: <?php UTW_ShowCurrentTagSet('tagsetcommalist') ?></h2>
<?php if (have_posts()) : ?>
<?php while (have_posts()) : the_post(); ?>
<div class="box default post" id="post-<?php the_ID(); ?>">
<div class="cbb">
<div class="dateline">
<span class="date"><?php the_time('D d M Y') ?></span>
<span class="time"><?php the_time('h i A') ?><!-- by <?php the_author() ?> --></span>
</div>
<h3 class="posttitle">
<a href="<?php the_permalink() ?>" rel="bookmark" title="Collegamento a <?php the_title(); ?>"><?php the_title(); ?></a>
</h3>
<div class="entry">
<?php the_content('Leggi il resto di questo post »'); ?>
</div>
<?php edit_post_link('Edit','','/'); ?><?php comments_popup_link('Nessun commento »', '1 Commento »', '% Commenti »'); ?><br />
</div>
</div>
<?php endwhile; ?>
<?php else : ?>
<h2 class="center">Non trovato</h2>
<p class="center">Spiacenti, ma stai cercando qualcosa che non c'è.</p>
<?php include (TEMPLATEPATH . "/searchform.php"); ?>
<?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>
In header.php aggiungiamo una riga nel title, perchè modifichi il titolo delle pagine tag.php.
<title><?php bloginfo('name'); ?> <?php if ( is_single() ) { ?> : Blog Archive <?php } ?> <?php if (is_tag()) { echo ' : '; UTW_ShowCurrentTagSet('tagsettextonly'); } ?><?php wp_title(':'); ?></title>
Quello che ci interessa è <?php if (is_tag()) { echo ' : '; UTW_ShowCurrentTagSet('tagsettextonly'); } ?>. Modificatelo come meglio vi pare.
Nel mio sito questa riga è
<title> <?php if (is_tag()) { echo 'Tag : '; UTW_ShowCurrentTagSet('tagsettextonly'); } ?><?php wp_title(); ?> <?php if(wp_title(' ', false)) { echo ' · '; } ?> <?php bloginfo('name'); ?> Weblog</title>
A questo punto possiamo aggiungere anche le informazioni sui tags dei singoli post, direttamente dall'interfaccia administrator, senza toccare il template.
Consiglio di utilizzare il controllo superajax che permetterà all'admin del sito di modificare i tags dei post direttamente navigando sul sito, aggiustando in tal modo gli eventuali errori e arricchendo il sito di informazioni.
Possiamo quindi dare un poco di stile alla nostra lista, usando il selettore CSS .UTWPrimaryTags. Ad esempio:
.UTWPrimaryTags {
display: block;
background: #F7E0D4;
}
Il risultato di questa serie di operazioni lo vedete su questo sito.
Una nota: è possibile aggiungere un prefisso alla lista di tags, ma non sono riuscito a separare il prefisso dall'inizio dei tags se non con un &nbps, che tra l'altro occorre ri-scrivere ogni volta che si aggiorna una impostazione del plugin!
Articoli correlati:
November 6th, 2007 at 3:52 pm
[...] read more | digg story [...]
February 11th, 2008 at 10:39 am
[...] perchè quando è uscita la 2.3 ancora non era molto chiaro come trasformare i tags gestiti da Ultimate Tag Warrior in tags nativi di Wordpress… e anche perché non ho mai trovato il tempo (o la voglia, [...]