Pinboard Bookmarks

Descrizione

Pinboard Bookmarks ti consente di pubblicare i segnalibri di Pinboard sul tuo blog. Il plugin ti permette di:

  • prelevare i segnalibri dal tuo account (o da qualunque account) su Pinboard;
  • prelevare i segnalibri da uno o più tag del tuo account (o da qualunque account).

Il plugin ha anche uno shortcode, che ti consente di pubblicare i segnalibri in un articolo o in una pagina.

Il plugin può visualizzare per ciascun tag (tu puoi scegliere cosa far vedere):

  • Il titolo con un link;
  • La descrizione, se presente;
  • La data del segnalibro;
  • I tag assegnati al segnalibro;
  • Il link all’intero archivio di quel tag su Pinboard;
  • Visualizza le voci in ordine casuale.

Dopo l’attivazione del plugin, troverai un nuovo widget in Aspetto / Widget.

Uso come widget

Il plugin fornisce un widget da usare nella barra laterale. Dopo l’attivazione del plugin, troverai un nuovo widget in Aspetto > Widget. Ti basta trascinare e rilasciare il widget “Pinboard Bookmarks” nella barra laterale, cambiare le opzioni e fare clic su Salva.

Uso come shortcode

Puoi anche usare lo shortcode del plugin per visualizzare la lista in una pagina statica o su un articolo. Un esempio d’uso:

[pbsc username="johndoe"]

Cambia username come richiesto.

Nel widget puoi usare il set completo delle opzioni. Così, per esempio, se desideri prelevare il feed dai segnalibri che hanno i tag books e comics e visualizzare i tag, usa:

[pbsc username="johndoe" tags="books comics" display_tags=1]

Nota che il plugin preleverà i segnalibri che hanno entrambi i tag books e comics.

Questa è la lista delle opzioni per lo shortcode:

  • intro_text (string) – Testo introduttivo per lo shortcode.
  • username (stringa) – Un nome utente su Pinboard.
  • tags (stringa) – Una lista di tag separata con spazi o un singolo tag.
  • source (string) – La sorgente su Pinboard, come from:pocket, from:instapaper o from:twitter.
  • quantity (intero) – Il numero di segnalibri da visualizzare (Pinboard consente al massimo 400 voci).
  • random (booleana, 1/0) – Se utilizzare un ordinamento casuale.
  • display_desc (booleana, 1/0) – Se visualizzare la descrizione del tag.
  • truncate (intero) – Il numero massimo di parole per la descrizione.
  • display_date (booleana, 1/0) – Se visualizzare la data del segnalibro (cioè quando fu aggiunto su Pinboard).
  • display_time (boolean, 1/0) – Se mostrare l’ora del segnalibro (quando cioè fu archiviato su Pinboard).
  • date_text (stringa) – Il testo da aggiungere alla data del segnalibro.
  • display_tags (booleana, 1/0) – Se visualizzare i tag.
  • tags_text (stringa) – Il testo da aggiungere prima dei tag del segnalibro.
  • display_hashtag (booleana, 1/0) – Se aggiungere un hashtag (#) prima di ogni tag.
  • use_comma (booleana, 1/0) – Se usare una virgola per separare i tag.
  • display_source (boolean, 1/0) – Se la sorgente deve essere mostrata..
  • display_arrow (boolean, 1/0) – Se aggiungere una freccia HTML al titolo dei segnalibri.
  • display_archive (booleana, 1/0) – Se visualizzare il link all’archivio su Pinboard.
  • archive_text (stringa) – Il testo da usare per l’archivio su Pinboard.
  • list_type (string) – Il tipo di lista da usare.
  • display_arch_arr (booleana, 1/0) – Se aggiungere una freccia HTML al testo dell’archivio.
  • new_tab (booleana, 1/0) – Se i link debbano essere aperti in una nuova scheda del browser.
  • nofollow (booleana, 1/0) – Se aggiungere un attributo nofollow ai link esterni.
  • items_order (string) – L’ordine nel quale gli elementi di ogni voce debbano essere mostrati.
  • admin_only (boolean, 1/0) – Se il debug deve essere mostrato solo agli Amministratori.
  • debug_options (booleana, 1/0) – Se visualizzare il set completo delle opzioni del widget.
  • debug_urls (booleana, 1/0) – Se visualizzare gli URL e le sue singole parti, usate per costruirli.

Uso come funzione PHP

Puoi anche usare la funzione PHP principale direttamente nel tuo tema. Aggiungi queste linee dove desideri che vengano visualizzate (la funzione stampa il risultato):

if ( function_exists( 'pinboard_bookmarks_fetch_feed' ) ) {
    $args = array(
        'intro_text'       => '',
        'username'         => '',
        'tags'             => '',
        'source'           => '',
        'quantity'         => 5,
        'random'           => false,
        'display_desc'     => false,
        'truncate'         => 0,
        'display_date'     => false,
        'display_time'     => false,
        'date_text'        => 'Stored on:',
        'display_tags'     => false,
        'tags_text'        => 'Tags:',
        'display_hashtag'  => true,
        'use_comma'        => false,
        'display_source'   => false,
        'display_arrow'    => false,
        'display_archive'  => true,
        'archive_text'     => 'See the bookmarks on Pinboard',
        'list_type'        => 'bullet',
        'display_arch_arr' => true,
        'new_tab'          => false,
        'nofollow'         => true,
        'items_order'      => 'title description date tags',
        'admin_only'       => true,
        'debug_options'    => false,
        'debug_urls'       => false
    );
    pinboard_bookmarks_fetch_feed( $args );
}

Se vuoi restituire il risultato, usa get_pinboard_bookmarks_fetch_feed( $args ).

Assicurati di usare correttamente i tag di apertura e chiusura, rispettivamente <?php e ?>.

Le uniche opzioni richieste sono username e tags; devi usare almeno una delle due. Le altre opzioni sono le opzioni predefinite che puoi modificare a seconda delle tue esigenze. Non è necessario inserirle tutte.

Aiuto, bug e contributi

Se hai bisogno di aiuto, usa il forum di WordPress. Non inviare email private a meno che non sia veramente necessario.

Se hai trovato un bug, segnalalo su GitHub.

Questo plugin è sviluppato utilizzando GitHub. Se hai scritto un miglioramento e desideri condividerlo con il mondo, inviai una Pull request.

Screenshot

  • Il pannello per impostare il widget.
  • Un esempio d'uso del widget.

Installazione

Questa sezione spiega come installare il plugin e metterlo in funzione.

  1. Dalla Bacheca di WordPress cerca il plugin Pinboard Bookmarks, installalo e attivalo.
  2. Aggiungi il nuovo widget nella barra laterale.
  3. L’unica opzione necessaria è il nome utente su Pinboard. Aggiungilo e salva il widget.

Contributori & Sviluppatori

“Pinboard Bookmarks” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.

Collaboratori

“Pinboard Bookmarks” è stato tradotto in 1 lingua. Grazie ai traduttori per i loro contributi.

Traduci “Pinboard Bookmarks” nella tua lingua.

Interessato allo sviluppo?

Sfoglia il codice, accedi al repository SVN, oppure iscriviti al log di sviluppo tramite RSS.