{"id":53282,"date":"2016-12-31T18:09:49","date_gmt":"2016-12-31T18:09:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/pinboard-bookmarks\/"},"modified":"2021-07-10T16:04:08","modified_gmt":"2021-07-10T16:04:08","slug":"pinboard-bookmarks","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/pinboard-bookmarks\/","author":414728,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.15.0","stable_tag":"1.15.0","tested":"5.8.13","requires":"3.0","requires_php":"5.3","requires_plugins":"","header_name":"Pinboard Bookmarks","header_author":"Aldo Latino","header_description":"","assets_banners_color":"ec7063","last_updated":"2021-07-10 16:04:08","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/dev.aldolat.it\/projects\/pinboard-bookmarks\/","header_plugin_uri":"https:\/\/dev.aldolat.it\/projects\/pinboard-bookmarks\/","header_author_uri":"https:\/\/www.aldolat.it\/","rating":5,"author_block_rating":0,"active_installs":20,"downloads":2870,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.0":{"tag":"1.0","author":"aldolat","date":"2017-01-03 18:58:19"},"1.1":{"tag":"1.1","author":"aldolat","date":"2017-01-04 20:44:52"},"1.10.0":{"tag":"1.10.0","author":"aldolat","date":"2020-03-07 14:28:54"},"1.11.0":{"tag":"1.11.0","author":"aldolat","date":"2020-05-24 08:36:38"},"1.12.0":{"tag":"1.12.0","author":"aldolat","date":"2020-05-27 19:07:27"},"1.13.0":{"tag":"1.13.0","author":"aldolat","date":"2020-05-28 18:46:32"},"1.13.1":{"tag":"1.13.1","author":"aldolat","date":"2020-05-29 16:34:56"},"1.14.0":{"tag":"1.14.0","author":"aldolat","date":"2020-08-02 06:07:57"},"1.14.1":{"tag":"1.14.1","author":"aldolat","date":"2020-11-21 18:40:55"},"1.15.0":{"tag":"1.15.0","author":"aldolat","date":"2021-07-10 16:04:08"},"1.2":{"tag":"1.2","author":"aldolat","date":"2017-04-29 10:02:47"},"1.3":{"tag":"1.3","author":"aldolat","date":"2017-04-29 14:06:26"},"1.4.0":{"tag":"1.4.0","author":"aldolat","date":"2017-07-14 10:56:34"},"1.5.0":{"tag":"1.5.0","author":"aldolat","date":"2017-07-15 16:59:18"},"1.6.0":{"tag":"1.6.0","author":"aldolat","date":"2017-09-24 11:07:31"},"1.7.0":{"tag":"1.7.0","author":"aldolat","date":"2018-03-25 18:39:23"},"1.7.1":{"tag":"1.7.1","author":"aldolat","date":"2018-05-19 09:04:18"},"1.7.2":{"tag":"1.7.2","author":"aldolat","date":"2018-06-02 15:30:26"},"1.7.3":{"tag":"1.7.3","author":"aldolat","date":"2018-10-21 09:57:31"},"1.7.4":{"tag":"1.7.4","author":"aldolat","date":"2019-02-24 18:27:34"},"1.8.0":{"tag":"1.8.0","author":"aldolat","date":"2019-04-28 05:30:20"},"1.8.1":{"tag":"1.8.1","author":"aldolat","date":"2019-10-26 10:40:31"},"1.8.2":{"tag":"1.8.2","author":"aldolat","date":"2019-11-02 16:53:05"},"1.9.0":{"tag":"1.9.0","author":"aldolat","date":"2019-11-03 12:24:31"}},"upgrade_notice":{"":"<p>No upgrade notice.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":1566306,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":1566306,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":1566306,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":1624097,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":1624097,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.10.0","1.11.0","1.12.0","1.13.0","1.13.1","1.14.0","1.14.1","1.15.0","1.2","1.3","1.4.0","1.5.0","1.6.0","1.7.0","1.7.1","1.7.2","1.7.3","1.7.4","1.8.0","1.8.1","1.8.2","1.9.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2451134,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2451134,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2451134,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"The dashboard panel to set up the widget (all panels closed).","2":"The dashboard panel to set up the widget (all panels opened).","3":"An example of rendered widget."}},"plugin_section":[],"plugin_tags":[495,6675,80,168,162],"plugin_category":[43,56],"plugin_contributors":[78205],"plugin_business_model":[],"class_list":["post-53282","plugin","type-plugin","status-closed","hentry","plugin_tags-bookmarks","plugin_tags-pinboard","plugin_tags-shortcode","plugin_tags-sidebar","plugin_tags-widget","plugin_category-customization","plugin_category-social-and-sharing","plugin_contributors-aldolat","plugin_committers-aldolat"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/pinboard-bookmarks\/assets\/icon.svg?rev=1566306","icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/pinboard-bookmarks_ec7063.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/pinboard-bookmarks\/assets\/screenshot-1.png?rev=2451134","caption":"The dashboard panel to set up the widget (all panels closed)."},{"src":"https:\/\/ps.w.org\/pinboard-bookmarks\/assets\/screenshot-2.png?rev=2451134","caption":"The dashboard panel to set up the widget (all panels opened)."},{"src":"https:\/\/ps.w.org\/pinboard-bookmarks\/assets\/screenshot-3.png?rev=2451134","caption":"An example of rendered widget."}],"raw_content":"<!--section=description-->\n<p>Pinboard Bookmarks allows you to publish bookmarks from Pinboard on your blog. The plugin lets you:<\/p>\n\n<ul>\n<li>retrieve the bookmarks from your account (or any account) on Pinboard;<\/li>\n<li>retrieve the bookmarks from one or more tags of your account (or any account).<\/li>\n<\/ul>\n\n<p>This plugin has also a shortcode, so you can publish the bookmarks in a post or a page.<\/p>\n\n<p>The plugin may display for each tag (you choose what to display):<\/p>\n\n<ul>\n<li>the title with link;<\/li>\n<li>the description if any;<\/li>\n<li>the date of the bookmark;<\/li>\n<li>the tags assigned to the bookmark;<\/li>\n<li>the base URL of the original site.<\/li>\n<\/ul>\n\n<p>Other options are available, such as:<\/p>\n\n<ul>\n<li>display items in random order;<\/li>\n<li>display the link to the entire archive of that tag on Pinboard;<\/li>\n<li>display the various elements of each bookmark in a certain order;<\/li>\n<li>and others.<\/li>\n<\/ul>\n\n<p>After the plugin's activation, you will have a new widget in Appearance \/ Widgets.<\/p>\n\n<h4>Usage as widget<\/h4>\n\n<p>The plugin provides a widget to be used in your sidebar. After activating the plugin, you will have a new widget in Appearance &gt; Widgets. Simply drag &amp; drop the \"Pinboard Bookmarks\" widget in the sidebar, adjust the options, and click Save.<\/p>\n\n<h4>Usage as shortcode<\/h4>\n\n<p>You can also use the plugin's shortcode to display your list on a static page or on a single post. Example usage:<\/p>\n\n<pre><code>[pbsc username=\"johndoe\"]\n<\/code><\/pre>\n\n<p>Change <code>username<\/code> as required.<\/p>\n\n<p>In the widget you can use the full set of options. So, for example, if you want to fetch the feed from bookmarks that have <code>books<\/code> and <code>comics<\/code> tags and display the tags, use:<\/p>\n\n<pre><code>[pbsc username=\"johndoe\" tags=\"books comics\" display_tags=1]\n<\/code><\/pre>\n\n<p>Note that the plugin will fetch bookmarks that have both the tags <code>books<\/code> and <code>comics<\/code>.<\/p>\n\n<p>Another more complex example:<\/p>\n\n<pre><code>[pbsc username=\"johndoe\" time=86400 display_desc=1 display_date=1 display_time=1 display_tags=1 display_hashtag=0 display_source=1 items_order=\"tags title description date\" date_text=\"Stored on:\" display_archive=1 admin_only=1 debug_options=1 debug_urls=1]\n<\/code><\/pre>\n\n<p>This is the list of the options for the shortcode:<\/p>\n\n<ul>\n<li><code>intro_text<\/code> (string) - An introductory text for the shortcode.<\/li>\n<li><code>username<\/code> (string) - A username on Pinboard.<\/li>\n<li><code>tags<\/code> (string) - A space separated list of tags or a single tag.<\/li>\n<li><code>source<\/code> (string) - The source in Pinboard, like <code>from:pocket<\/code>, <code>from:instapaper<\/code>, or <code>from:twitter<\/code>.<\/li>\n<li><code>quantity<\/code> (integer) - The number of bookmarks you want to display (Pinboard accepts 400 at most).<\/li>\n<li><code>random<\/code> (boolean, 1\/0) - If a random order should be used.<\/li>\n<li><code>display_desc<\/code> (boolean, 1\/0) - If the tag description should be displayed.<\/li>\n<li><code>truncate<\/code> (integer) - The maximum number of words the description should have.<\/li>\n<li><code>display_date<\/code> (boolean, 1\/0) - If the date of the bookmark (when it was archived on Pinboard) should be displayed.<\/li>\n<li><code>display_time<\/code> (boolean, 1\/0) - If the time of the bookmark (when it was archived on Pinboard) should be displayed.<\/li>\n<li><code>date_text<\/code> (string) - The text to be displayed before the date of the bookmark.<\/li>\n<li><code>display_tags<\/code> (boolean, 1\/0) - If the tags should be displayed.<\/li>\n<li><code>tags_text<\/code> (string) - The text to be displayed before the tags of the bookmark.<\/li>\n<li><code>display_hashtag<\/code> (boolean, 1\/0) - If the tags should be prefixed with a hashtag (<code>#<\/code>).<\/li>\n<li><code>use_comma<\/code> (boolean, 1\/0) - If a comma for separate tags should be used.<\/li>\n<li><code>display_source<\/code> (boolean, 1\/0) - If the source should be displayed.<\/li>\n<li><code>display_arrow<\/code> (boolean, 1\/0) - If an HTML arrow should be appended to the title of the bookmarks.<\/li>\n<li><code>time<\/code> (string) - The minimum time between two requests to Pinboard server.<\/li>\n<li><code>display_site_url<\/code> (boolean, 1\/0) - If the original site base URL should be displayed.<\/li>\n<li><code>leave_domain<\/code> (boolean, 1\/0) - If the domain should be displayed only.<\/li>\n<li><code>site_url_text<\/code> (string) - The text to be displayed before the original site URL.<\/li>\n<li><code>display_archive<\/code> (boolean, 1\/0) - If the link to the archive on Pinboard should be displayed.<\/li>\n<li><code>archive_text<\/code> (string) - The text to be used for the archive on Pinboard.<\/li>\n<li><code>list_type<\/code> (string) - The type of list to be used.<\/li>\n<li><code>display_arch_arr<\/code> (boolean, 1\/0) - If an HTML arrow should be appended to the archive text.<\/li>\n<li><code>new_tab<\/code> (boolean, 1\/0) - If the links should be open in a new browser tab.<\/li>\n<li><code>nofollow<\/code> (boolean, 1\/0) - If a <code>nofollow<\/code> attribute should be added to the external links.<\/li>\n<li><code>items_order<\/code> (string) - The order in which the elements of each item should be displayed.<\/li>\n<li><code>admin_only<\/code> (boolean, 1\/0) - If the debug should be displayed to Administrators only.<\/li>\n<li><code>debug_options<\/code> (boolean, 1\/0) - If the complete set of options of the widget should be displayed.<\/li>\n<li><code>debug_urls<\/code> (boolean, 1\/0) - If the URLs and the single parts, used to build them, should be displayed.<\/li>\n<\/ul>\n\n<h4>Usage as PHP function<\/h4>\n\n<p>You can also use the main PHP function directly in your theme. Add these lines where you want them to be displayed (the function echoes the result):<\/p>\n\n<pre><code>if ( function_exists( 'pinboard_bookmarks_fetch_feed' ) ) {\n    $args = array(\n        'intro_text'       =&gt; '',\n        'username'         =&gt; '',\n        'tags'             =&gt; '',\n        'source'           =&gt; '',\n        'quantity'         =&gt; 5,\n        'random'           =&gt; false,\n        'display_desc'     =&gt; false,\n        'truncate'         =&gt; 0,\n        'display_date'     =&gt; false,\n        'display_time'     =&gt; false,\n        'date_text'        =&gt; 'Stored on:',\n        'display_tags'     =&gt; false,\n        'tags_text'        =&gt; 'Tags:',\n        'display_hashtag'  =&gt; true,\n        'use_comma'        =&gt; false,\n        'display_source'   =&gt; false,\n        'display_arrow'    =&gt; false,\n        'time'             =&gt; 1800,\n        'display_site_url' =&gt; false,\n        'leave_domain'     =&gt; false,\n        'site_url_text'    =&gt; 'From:',\n        'display_archive'  =&gt; true,\n        'archive_text'     =&gt; 'See the bookmarks on Pinboard',\n        'list_type'        =&gt; 'bullet',\n        'display_arch_arr' =&gt; true,\n        'new_tab'          =&gt; false,\n        'nofollow'         =&gt; true,\n        'items_order'      =&gt; 'title description date tags',\n        'admin_only'       =&gt; true,\n        'debug_options'    =&gt; false,\n        'debug_urls'       =&gt; false\n    );\n    pinboard_bookmarks_fetch_feed( $args );\n}\n<\/code><\/pre>\n\n<p>If you want to return the result, use <code>get_pinboard_bookmarks_fetch_feed( $args )<\/code>.<\/p>\n\n<p>Make sure to properly use the opening and closing tags <code>&lt;?php<\/code> and <code>?&gt;<\/code> respectively.<\/p>\n\n<p>The only mandatory option is <code>username<\/code>. The other options are the default options which you can change according to your needs. It isn't necessary to insert all of them.<\/p>\n\n<h4>Help, Bugs, and Contributing<\/h4>\n\n<p>If you need help, please use <a href=\"http:\/\/wordpress.org\/support\/plugin\/pinboard-bookmarks\">WordPress forum<\/a>. Do not send private email unless it is really necessary.<\/p>\n\n<p>If you have found a bug, please report it on <a href=\"https:\/\/github.com\/aldolat\/pinboard-bookmarks\/issues\">GitHub<\/a>.<\/p>\n\n<p>This plugin is developed using <a href=\"https:\/\/github.com\/aldolat\/pinboard-bookmarks\">GitHub<\/a>. If you wrote an enhancement and would share it with the world, please send me a <a href=\"https:\/\/github.com\/aldolat\/pinboard-bookmarks\/pulls\">Pull request<\/a>.<\/p>\n\n<h4>Credits<\/h4>\n\n<p>I would like to say <em>Thank You<\/em> to all the people who helped me in making this plugin better and translated it into their respective languages.<\/p>\n\n<p>This plugin uses the following JavaScript code, released under the terms of the GNU GPLv2 or later:<\/p>\n\n<ul>\n<li>a modified version of @kometschuh's code for \"Category Posts Widget\" plugin, used to open and close panels in the widget admin user interface.<\/li>\n<\/ul>\n\n<p>Thanks to these developers for their work and for using the GNU General Public License.<\/p>\n\n<h4>Privacy Policy<\/h4>\n\n<p>This plugin does not collect any user data.<\/p>\n\n<!--section=installation-->\n<p>This section describes how to install the plugin and get it working.<\/p>\n\n<ol>\n<li>From your WordPress dashboard search the plugin Pinboard Bookmarks, install and activate it.<\/li>\n<li>Add the new widget on your sidebar.<\/li>\n<li>The only necessary option is the username on Pinboard. Add it and save the widget.<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.15.0<\/h4>\n\n<ul>\n<li>Added collapsible panels.<\/li>\n<li>Minimum height for text fields is 80 pixels now.<\/li>\n<li>Cleaned and beautified HTML code.<\/li>\n<\/ul>\n\n<p>The full changelog is documented in the changelog file released along with the plugin package and is hosted on <a href=\"https:\/\/github.com\/aldolat\/pinboard-bookmarks\/blob\/master\/CHANGELOG.md\">GitHub<\/a>.<\/p>","raw_excerpt":"Publish Pinboard bookmarks on your WordPress blog.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/53282","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=53282"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/aldolat"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=53282"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=53282"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=53282"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=53282"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=53282"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=53282"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}