{"id":11241,"date":"2010-11-17T17:26:32","date_gmt":"2010-11-17T17:26:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/links-shortcode\/"},"modified":"2019-11-10T15:28:37","modified_gmt":"2019-11-10T15:28:37","slug":"links-shortcode","status":"publish","type":"plugin","link":"https:\/\/te.wordpress.org\/plugins\/links-shortcode\/","author":6439626,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.8.3","stable_tag":"1.8.3","tested":"5.2.24","requires":"3.8","requires_php":"","requires_plugins":"","header_name":"Links Shortcode","header_author":"Maarten Swemmer","header_description":"","assets_banners_color":"99cefc","last_updated":"2019-11-10 15:28:37","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=donateviapaypal%40bigcircle%2enl&lc=HK&item_name=Wordpress%20plugin&item_number=linksshortcode%2dapp&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted","header_plugin_uri":"http:\/\/www.apprique.com\/wordpress-plugins","header_author_uri":"http:\/\/blog.bigcircle.nl","rating":4.5,"author_block_rating":0,"active_installs":900,"downloads":43496,"num_ratings":12,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":{"":"<p>No special actions required before upgrading.<\/p>"},"ratings":{"1":0,"2":"1","3":"1","4":"1","5":"9"},"assets_icons":[],"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"984037","resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"984037","resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.7","0.8","0.9","1.0","1.0.1","1.1","1.2","1.3","1.4","1.4.1","1.5","1.6","1.6.1","1.6.2","1.7","1.8","1.8.1","1.8.2","1.8.3"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"984037","resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":"984037","resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":"984037","resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Settings page","2":"Links Short code","3":"Resulting list of links"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[89,157,537,175,80],"plugin_category":[43],"plugin_contributors":[81069,81070],"plugin_business_model":[],"class_list":["post-11241","plugin","type-plugin","status-publish","hentry","plugin_tags-category","plugin_tags-facebook","plugin_tags-link","plugin_tags-links","plugin_tags-shortcode","plugin_category-customization","plugin_contributors-apprique","plugin_contributors-maartenjs","plugin_committers-apprique","plugin_committers-maartenjs"],"banners":{"banner":"https:\/\/ps.w.org\/links-shortcode\/assets\/banner-772x250.png?rev=984037","banner_2x":"https:\/\/ps.w.org\/links-shortcode\/assets\/banner-1544x500.png?rev=984037","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/links-shortcode_99cefc.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/links-shortcode\/assets\/screenshot-1.jpg?rev=984037","caption":"Settings page"},{"src":"https:\/\/ps.w.org\/links-shortcode\/assets\/screenshot-2.jpg?rev=984037","caption":"Links Short code"},{"src":"https:\/\/ps.w.org\/links-shortcode\/assets\/screenshot-3.jpg?rev=984037","caption":"Resulting list of links"}],"raw_content":"<!--section=description-->\n<p>The plugin re-enables the Link Manager in Wordpress and provides the shortcode 'links'. This shortcode displays a list of all links having specified characteristics, for example a link category name in your post. By default it includes a Facebook Like button for every link, but this can be easily disabled.<\/p>\n\n<p>The plugin supports a customizable <strong>template<\/strong> for showing links. This enables you to use the shortcode to display links in any format you like, for example in a list or a table, with or without link images, etc. All relevant properties of a link are supported and listed on the Settings page of the plugin.<\/p>\n\n<p>The typical format for the short code is<\/p>\n\n<blockquote>\n  <p>[links option1=\"x\" option2=\"y\" etc...]<\/p>\n<\/blockquote>\n\n<p>The following options are available:<\/p>\n\n<ul>\n<li><strong>fblike<\/strong>: Show the facebook Like button (default '1', to disable set to any value other than '1').<\/li>\n<li><strong>fbrecommend<\/strong>: Show the Facebook Recommend botton (default '', to enable set to '1').<\/li>\n<li><strong>orderby<\/strong>: Order the links by (default 'name'). Use 'order' to order links by order specified with 'My Link Order' plugin.<\/li>\n<li><strong>order<\/strong>: How to order, ASC or DESC (default 'DESC').<\/li>\n<li><strong>limit<\/strong>: Limit the number of links shown (default '-1', which means no limit). <\/li>\n<li><strong>category<\/strong>: Comma separated list of link category ID's.<\/li>\n<li><strong>category_name<\/strong>: Category name of a catgeory of links to show. Overrides category parameter.<\/li>\n<li><strong>hide_invisible<\/strong>: Hide links marked as not visible (default '1', yes).<\/li>\n<li><strong>include<\/strong>: Comma separated list of numeric link IDs to include. If 'include' is used, the category, category_name, and exclude parameters are ignored. <\/li>\n<li><strong>exclude<\/strong>: Comma separated list of numeric link IDs to exclude.<\/li>\n<li><strong>search<\/strong>: Shows all links matching this search string. It searches url, link name and link description.<\/li>\n<li><strong>links_per_page<\/strong>: To paginate lists of links. How many links to show per page. Below the links a pagination will be shown.<\/li>\n<li><strong>links_list_id<\/strong>: A unique identifyer on a page for the shortcode at hand. Mandatory in case 'links_per_page' is used to paginate. Optional to define custom styles for this id using css. <\/li>\n<li><strong>class<\/strong>: A class that can be inserted using the links template. You could for example use &lt;div class=\"[class]\"&gt; in the template to attache different style to different instances of the short code.<\/li>\n<li><strong>alttext<\/strong>: An alternative text that will be displayed if the shortcode does not return any links.<\/li>\n<\/ul>\n\n<p>Dafault options can be changed on a 'Links Shortcode' page in the Settings menu.<\/p>\n\n<p>Example:<\/p>\n\n<blockquote>\n  <p>[links category_name=\"Blogroll\"]<\/p>\n<\/blockquote>\n\n<p>Using the customizable template, all properties of a link can be displayed. An example template is included. This  template uses the Name, Web Address, Description and Rating of your links. The Name will link to the Web Address.<\/p>\n\n<p>If the Name starts with a date, formatted as: yyyy-mm-dd followed by ':', a separate property  for the date is available.<\/p>\n\n<p>Templates are fully customizable. For more information see http:\/\/www.apprique.com\/community\/wordpress-plugins.<\/p>\n\n<p>Please note that the Description of a link has a limited length, but the Wordpress UI does not show this. After saving changes to a Link in the Links section, Wordpress only saves the first 255 characters. This has nothing to do with this Plugin.<\/p>\n\n<!--section=installation-->\n<p>Just use the \"Add New\" button in Plugin section of your Wordpress blog's Control panel. To find the plugin there, search for 'Links Shortcode'.<\/p>\n\n<p>After installing you can use the shortcode anywhere in your blog as described in the description.<\/p>\n\n<!--section=changelog-->\n<h4>1.8.3 (20-01-2018)<\/h4>\n\n<ul>\n<li>Compatible up to Wordpress 4.9<\/li>\n<li>Fixed warning for dates that do not include '-' character.<\/li>\n<\/ul>\n\n<h4>1.8.2 (21-04-2016)<\/h4>\n\n<ul>\n<li>Compatible up to Wordpress 4.5<\/li>\n<\/ul>\n\n<h4>1.8 (08-09-2014)<\/h4>\n\n<ul>\n<li>Compatible up to Wordpress 4.0<\/li>\n<li>If no links match the shortcode, an alternative text is displayed if provided, via [links alttext=\"This text will be displayed when no links have been found matching the shortcode.\"]<\/li>\n<\/ul>\n\n<h4>1.7 (16-06-2014)<\/h4>\n\n<ul>\n<li>Compatible up to Wordpress 3.9.1<\/li>\n<li>Star rating of links can now be displayed on other backgrounds than white by providing your own background image. Use [links emptystarsimg=\"absolutepathto\/filename\" fullstarsimg=\"absolutepathto\/filename\"] to indicate your own replacements of the emptystars.png and fullstars.png images.  <\/li>\n<\/ul>\n\n<h4>1.6.2 (28-12-2013)<\/h4>\n\n<ul>\n<li>Compatible up to WordPress 3.8<\/li>\n<\/ul>\n\n<h4>1.6.1 (29-09-2013)<\/h4>\n\n<ul>\n<li>Fixed issue with initializing Links shortcode template on first activation.<\/li>\n<li>Fixed issue with table names not starting with the default 'wp_'.<\/li>\n<\/ul>\n\n<h4>1.6 (02-09-2013)<\/h4>\n\n<ul>\n<li>In Wordpress 3.5 the Link manager is disabled by default if you don't have any Links. This plugin now enables it anyway (which would be a logical thing to do if you want to use Links Shortcodes) in exactly the same way that the Links Manager plugin does this.<\/li>\n<li>A HTML class can be added to a shortcode to enable custom CSS for each shortcode. Use [links class=\"your_class\" ..] as a shortcode and [class] in the template on the settings page.<\/li>\n<li>The default CSS is now optional<\/li>\n<li>Small bug fixes<\/li>\n<\/ul>\n\n<h4>1.5 (13-06-2013)<\/h4>\n\n<ul>\n<li>Added long desired option to paginate links. Let me know your opinion so I can improve where necessary.<\/li>\n<li>Removed \"Links Shortcode\" link to settings from Settings menu. Plugin settings can now only be found in the Links menu, where it should be.<\/li>\n<li>The default template now includes schema.org code for link ratings (http:\/\/schema.org\/Rating)<\/li>\n<li>The plugin now supports nested shortcodes as described in http:\/\/www.sitepoint.com\/wordpress-nested-shortcodes\/<\/li>\n<\/ul>\n\n<h4>1.4.1 (01-03-2013)<\/h4>\n\n<ul>\n<li>Fixed issue where newly installed plugin does not contain a default template, resulting in no links being shown by default.<\/li>\n<\/ul>\n\n<h4>1.4 (27-02-2013)<\/h4>\n\n<ul>\n<li>Made Facebook button SSL friendly as well, to prevent https security warnings<\/li>\n<li>Compatible with latest version of Wordpress<\/li>\n<li>Small bug fixes (making code neater)<\/li>\n<\/ul>\n\n<h4>1.3 (21-07-2012)<\/h4>\n\n<ul>\n<li>Corrected code to be SSL friendly.<\/li>\n<li>Added option to choose Facebook like button color (light or dark).<\/li>\n<li>Added functionality to save the date on which links are added or updated. This date is also available for sorting (use [links orderby=\"link_updated\"]). The date is also availabel for display, where it can be overruled by adding the date in front of the link title as yyyy-mm-dd followed by ':'.<\/li>\n<li>Added the following fields to display dates in the links template: [date], [date_year], [date_month], [date_day]. <\/li>\n<li>Added a link to the settings page to the Links menu, where they should be easier to find. The settings page can also still be found under Settings.<\/li>\n<li>Officially removed support for displaying category name, as this field is not supported by Wordpress in almost all cases. The value will still be supported if available.<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Fixed issue where settings were deleted when the plugin was deactivated. Now, settings will only be deleted on uninstall.<\/li>\n<li>Link_owner now displays the owner's display name instead of the useless owner ID.<\/li>\n<li>Added a new template tag \"[link_rating_stars]\" which displays the rating of a link using 0 to 5 stars.<\/li>\n<li>Improved the manual at http:\/\/blog.bigcircle.nl\/about\/wordpress-plugins\/links-shortcode<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Added compatibility with 'My Link Order' plugin<\/li>\n<li>Fixed bug in link retrieving logic<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Added some example templates to choose from, including one that shows images (if you have entered image urls for your links)<\/li>\n<li>Added compatibility with what 'Andy's Link Last Edited Meta Box' does WordPress's link_updated field (thanks to wlindley)<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Added customizable template to display links in any way you like<\/li>\n<li>Added customizable alternative layout in case link property is empty<\/li>\n<\/ul>\n\n<h4>0.9<\/h4>\n\n<ul>\n<li>Corrected spelling error<\/li>\n<\/ul>\n\n<h4>0.8<\/h4>\n\n<ul>\n<li>Fixed issues where links showed too much space below and\/or above a link.<\/li>\n<\/ul>\n\n<h4>0.7<\/h4>\n\n<ul>\n<li>A Settings page has been added to set the most common default options.<\/li>\n<li>Translation support has been added for the Settings page.<\/li>\n<li>Stylesheet and layout have been improved to better display the links without the Facebook button.<\/li>\n<\/ul>\n\n<h4>0.6<\/h4>\n\n<ul>\n<li>The first stable release at the Wordpress.org plugin repository.<\/li>\n<\/ul>","raw_excerpt":"The plugin provides the shortcode &#039;links&#039;. This shortcode shows all links having specified characteristics, following a specified template.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/11241","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=11241"}],"author":[{"embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/maartenjs"}],"wp:attachment":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=11241"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=11241"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=11241"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=11241"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=11241"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=11241"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}