Visto il discreto successo del plugin Zelig dropdown cats, eccone un altro della stessa serie, che tra l’altro risponde ad alcune richieste dei miei lettori.
Questo plugin mostra i link nella sidebar come una semplice lista di selezione a discesa. Qualora si utilizzassero diverse categorie di link, verranno visualizzate altrettante liste.
Il plugin dovrebbe sostituire la funzione standard get_links_list() e potrà essere sicuramente utile a chi ha degli elenchi di link molto lunghi ma allo stesso tempo non vuole ingombrare troppo la barra laterale del blog.
ISTRUZIONI:
- Scaricare il file zip contenente il plugin. Esistono due versioni, entrambe con le stesse caratteristiche, da scegliere a seconda della versione di WordPress che state usando:
Zelig Dropdown Links 1.2 – Per WP 2.1 (e seguenti, spero…);
Zelig Dropdown Links 1.1 – Per versioni di WP precedenti.
- Estrarre il file zelig-dropdown-links.php nella cartella dei plugin della vostra installazione di WordPress (wp-content/plugins).
- Entrare nel pannello di amministrazione di WordPress, aprire la pagina dei Plugin e attivare il plugin stesso.
- Inserire il seguente codice HTML da qualche parte in una pagina del vostro template, fuori dal loop (il suo posto naturale è nella sidebar):
<?php zelig_dropdown_links(); ?>
La funzione zelig_dropdown_links() ha alcuni parametri che possono essere specificati (prestare attenzione al fatto che la sintassi dei parametri è cambiata rispetto alla versione 1.0):
Parametro |
Valori |
Descrizione |
Default |
boxwidth |
numero |
larghezza della list box in pixel. Se non specificata o se impostata a zero, la lista assumerà la larghezza del nome più lungo dei link che contiene. Se invece viene impostato un valore, i nomi eventualmente più lunghi potrebbero essere troncati in quel punto, a seconda del browser utilizzato (IE6…) |
0 |
exclude |
numero o elenco di numeri separati da virgole |
categoria di link o elenco di categorie di link (numeri ID) da non visualizzare. Se non specificato o se impostato a zero, tutte le categorie di link verranno visualizzate. |
0 |
include |
numero o elenco di numeri separati da virgole |
categoria di link o elenco di categorie di link (numeri ID) da visualizzare. Se non specificato o se impostato a zero, tutte le categorie di link verranno visualizzate. |
0 |
title |
0
1 |
se impostato a zero, non viene mostrato il nome della categoria di link come prima riga della lista (quella visibile quando è chiusa). |
1 |
ESEMPI:
<?php zelig_dropdown_links('boxwidth=120'); ?>
Ogni lista sarà larga esattamente 120 pixel.
<?php zelig_dropdown_links('boxwidth=120&exclude=1'); ?>
Ogni lista sarà larga esattamente 120 pixel e non verrà mostrata la categoria di link con ID 1.
<?php zelig_dropdown_links('boxwidth=120&exclude=1,2,3'); ?>
Ogni lista sarà larga 120 pixel e non verranno mostrate le categorie di link con ID 1, 2 e 3.
<?php zelig_dropdown_links('include=1&title=0'); ?>
Verrà mostrata solamente la categoria di link con ID 1 e senza il nome della categoria come “titolo” della lista.
Questo plugin, anche per le caratteristiche stesse del tipo di visualizzazione, non tiene conto di molti elementi impostabili nei link di WordPress, come immagine, descrizione, punteggio, target e rel. Vengono utilizzati solo l’URI, il nome, il tipo di ordinamento, la visibilità e il limite per ogni categoria.
NOTE:
E’ possibile usare diverse istanze della funzione nella stessa pagina (purché non si visualizzino gli stessi link).
Il codice restituito dalla funzione è valido XHTML Strict.
Plugin testato solamente con WordPress da 2.0.4 a 2.1.
AGGIORNAMENTI:
- Versione 1.2 (16 febbraio 2007): compatibile con WordPress 2.1.
- Versione 1.1 (17 gennaio 2007): aggiunte le opzioni “include”, “exclude” e “title”.
This plugin is similar to the Zelig dropdown cats one, and it’s also an answer to some requests of my readers.
It displays the links in the sidebar as a simple dropdown list (select box). If you have more link categories, every one will be shown in it’s own list.
This is supposed to replace the original get_links_list() function and should be useful if you have a lot of links, but you don’t want to clutter up your sidebar with them!
INSTRUCTIONS:
- Download the zip file containing the plugin. There are two versions, both with equal functionality, to choose depending on the WordPress version you are using:
Zelig Dropdown Links 1.2 – For WP 2.1 (and following, I hope…);
Zelig Dropdown Links 1.1 – For previous WP versions.
- Extract the zelig-dropdown-links.php file into the plugins directory in your WordPress installation (wp-content/plugins).
- Log in to WordPress administration. Go to the Plugins page and Activate this plugin.
- Put this code somewere in your template page, outside the loop (usually in sidebar):
<?php zelig_dropdown_links(); ?>
The zelig_dropdown_links() function has some parameters you can pass (please note that options syntax is changed from version 1.0):
Parameter |
Values |
Description |
Default |
boxwidth |
number |
width size (in pixel) of the list box. If you don’t use this parameter or if you set it to 0, the list box will assume the width of the longest category name it contains. If you set a width value, longer names may be truncated at that point, depending on browser (IE6…) |
0 |
exclude |
number or comma separated list of numbers |
link category or categories (ID numbers) to hide. If not set or set to 0, all link categories will be displayed. |
0 |
include |
number or comma separated list of numbers |
link category or categories (ID numbers) to display. If not set or set to 0, all link categories will be displayed. |
0 |
title |
0
1 |
set to 0 if you don’t want the first row of the list as a title with the name of the link category (text appearing in the list box when it’s closed). |
1 |
EXAMPLES:
<?php zelig_dropdown_links('boxwidth=120'); ?>
Set the width of the list to 120 pixels.
<?php zelig_dropdown_links('boxwidth=120&exclude=1'); ?>
Set the width of the list to 120 pixels and hide link category with ID 1.
<?php zelig_dropdown_links('boxwidth=120&exclude=1,2,3'); ?>
Set the width of the list to 120 pixels and hide link categories with ID 1, 2 and 3.
<?php zelig_dropdown_links('include=1&title=0'); ?>
Displays only link category with ID 1 and without the category name as a list “title”.
This plugin, due to the peculiarity of the type of visualization, ignores a lot of elements of WordPress links, like image, description, score, target and rel. Only URI, name, visibility, sorting type and category limit are used.
NOTES:
You can use more than one istance of the function in the same page (provided that not showing the same links).
The output code is valid XHTML Strict.
Tested with WordPress from 2.0.4 to 2.1 only.
CHANGE LOG:
- Version 1.2 (february 16, 2007): WordPress 2.1 compatibile.
- Version 1.1 (january 17, 2007): added “exclude”, “include” and “title” options.