Pinboard Bookmarks

Fork me on GitHub

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);
  • prelevare gli ultimi segnalibri da Pinboard usando uno o più tag;

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:

  • 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.
  • 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(
        '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,
        '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.

Donate





About this plugin

Name of the plugin: Pinboard Bookmarks
Plugin version: 1.5.0
This plugin requires WordPress 3.0
Tested up to WordPress 4.8.1
Last updated: 15 luglio 2017 (1 mese ago)
Compatibility: Unknown with WordPress 4.8.1
Tags: bookmarks, pinboard, shortcode, sidebar, widget
Downloaded: 173
Rating: 0 stars

Latest changes

  • Display the source of the bookmark, even if a source has not been defined in the widget admin.
  • Minor fixes.

Download

You can get a copy from the page in the official repository: Pinboard Bookmarks. This plugin has been downloaded 173 times.

Author

Author’s name: Aldo Latino
Profile on wordpress.org: Aldo Latino

Screenshots

  1. Il pannello per impostare il widget.

    Il pannello per impostare il widget.

  2. Un esempio d'uso del widget.

    Un esempio d'uso del widget.

Changelog

1.5.0

  • Display the source of the bookmark, even if a source has not been defined in the widget admin.
  • Minor fixes.

1.4.0

  • Display the source of the bookmarks, if activated.
  • Fix time display: now the plugin displays correctly the seconds.
  • Fix URL when using more than 1 tag.
  • Display a different URL to the archive in different cases.
  • Improve control for username.
  • Changed some class names.
  • Minor fixes.

1.3

  • Updated shortcode options.

1.2

  • Added “no-follow” option to all external links.
  • Added the number of retrieved items in debug section.
  • Added option to select the type of list (bullet or numeric list).
  • Added option to get bookmarks labeled with the source, like from:pocket.
  • Added option to display debugging informations to admins only.
  • Added option to display the time of the bookmarks.
  • Changed capabilities for viewing debug informations.
  • Hardening security.

1.1

  • Hardening security.
  • Various small improvements.

1.0

  • First release of the plugin.

Contributors

<a href="https://profiles.wordpress.org/aldolat">aldolat</a>.

Other Notes

Support

You can get support in this forum.

Donations

Say your “Thanks!” to the developer with a small donation.