Related Links gives you the possibility to manually link other posts to your current post. But you can also link pages, media or any custom post-type. And in addition you can use custom urls to link to external files. The plugin adds a Metabox to the writing page with a list of all available content.<\/p>\n\n
Features:<\/p>\n\n
related_links()<\/code><\/li>\n- Works with custom post-types<\/li>\n
- Settings to enable the post-types that should be shown in the Metabox<\/li>\n<\/ul>\n\n\n
\n- Upload the
related-links<\/code> folder to the \/wp-content\/plugins\/<\/code> directory.<\/li>\n- Activate the plugin through the
Plugins<\/code> menu in WordPress.<\/li>\n- Set in the link types in
Related Links<\/code> under the Settings<\/code> menu in WordPress.<\/li>\n- Place
<?php related_links(); ?><\/code> in your templates.<\/li>\n<\/ol>\n\n\n\n- How do I show the links in my theme?<\/dt>\n
Use the Related Links<\/code> widget to show a list of the related links.<\/p><\/dd>\n- How do I show the links in a specific template?<\/dt>\n
Use the related_links()<\/code> function directly in your template files. This will return an unordered list with an <ul><\/code> wrapper. Use this code for example in your `content.php' template:<\/p>\n\n<?php related_links(); ?>\n<\/code><\/pre><\/dd>\n- How can I modify the output of the link list?<\/dt>\n
You need to use the get_related_links()<\/code> function. A simple example that shows a list with all link names and the type of link:<\/p>\n\n<?php $related_links = get_related_links(); ?>\n<ul>\n <?php foreach ($related_links as $link): ?>\n <li><a href=\"<?php echo $link['url']; ?>\"><?php echo $link['type']; ?>: <?php echo $link['title']; ?><\/a><\/li>\n <?php endforeach; ?>\n<\/ul>\n<\/code><\/pre><\/dd>\n- What are the properties returned by the `get_related_links()` function?<\/dt>\n
The get_related_links()<\/code> returns an array containing every related link. when you loop through this array every link consists of another array with the following keys:<\/p>\n\n\n- key
id<\/code>: equals to $post->ID<\/code> or null<\/code> for custom links<\/li>\n- key
url<\/code>: equals to get_permalink()<\/code> or the manually entered url of a custom link<\/li>\n- key
title<\/code>: equals to $post->post_title<\/code> or the manually entered title of a custom link<\/li>\n- key
type<\/code>: the $post->post_type<\/code> or null<\/code> for custom links<\/li>\n<\/ul><\/dd>\n- How do I only show the links for a certain post_type in my theme?<\/dt>\n
Set the $post_type<\/code> in get_related_links($post_type)<\/code> to 'post'<\/code>, 'page'<\/code> or any custom post-type. A simple example that show a list of links:<\/p>\n\n<?php $related_links = get_related_links('page'); ?>\n<ul>\n <?php foreach ($related_links as $link): ?>\n <li><a href=\"<?php echo $link['url']; ?>\"><?php echo $link['type']; ?>: <?php echo $link['title']; ?><\/a><\/li>\n <?php endforeach; ?>\n<\/ul>\n<\/code><\/pre><\/dd>\n- How do I show the related links of another post (not the current one)?<\/dt>\n
Set the $post_id<\/code> in get_related_links(null, $post_id)<\/code> to the id of the post. A simple example that show a list of links:<\/p>\n\n<?php $related_links = get_related_links(null, 1); ?>\n<ul>\n <?php foreach ($related_links as $link): ?>\n <li><a href=\"<?php echo $link['url']; ?>\"><?php echo $link['type']; ?>: <?php echo $link['title']; ?><\/a><\/li>\n <?php endforeach; ?>\n<\/ul>\n<\/code><\/pre><\/dd>\n- How do I link directly to a media file?<\/dt>\n
You need to check the 'type'<\/code> and then get with wp_get_attachment_url()<\/code> the attachment url from the 'id'<\/code>.<\/p>\n\n<?php $related_links = get_related_links(null, 1); ?>\n<ul>\n<?php foreach ($related_links as $link): ?>\n <?php if ($link['type'] == 'attachment') :\n $url = wp_get_attachment_url($link['id']);\n else :\n $url = $link['url'];\n endif; ?>\n <li><a href=\"<?php echo $url; ?>\"><?php echo $link['title']; ?><\/a><\/li>\n<?php endforeach; ?>\n<\/ul>\n<\/code><\/pre><\/dd>\n- How do show the type of a media file?<\/dt>\n
You need to check the 'type'<\/code> and then get with wp_get_attachment_url()<\/code> the attachment url from the 'id'<\/code>.<\/p>\n\n<?php $related_links = get_related_links(null, 1); ?>\n<ul>\n<?php foreach ($related_links as $link): ?>\n <?php \n if ($link['type'] == 'attachment') :\n $url = wp_get_attachment_url($link['id']);\n $mime = explode('\/', get_post_mime_type($link['id']));\n $mime = $mime[sizeof($mime) - 1]; \n else :\n $url = $link['url'];\n $mime = null;\n endif; \n ?>\n <li><a href=\"<?php echo $url; ?>\"><?php echo $link['title']; ?><?php echo isset($mime) ? ' (' . $mime . ')' : ''; ?><\/a><\/li>\n<?php endforeach; ?>\n<\/ul>\n<\/code><\/pre><\/dd>\n- How to prevent a PHP error when the plugin is not activated?<\/dt>\n
Put the get_related_links()<\/code> function or your whole code into an if<\/code> clause. Like this your theme will still work even if the plugin is deactivated.<\/p>\n\n<?php if(function_exists('get_related_links')) : ?>\n <?php $related_links = get_related_links(); ?>\n <ul>\n <?php foreach ($related_links as $link): ?>\n <li><a href=\"<?php echo $link['url']; ?>\"><?php echo $link['type']; ?>: <?php echo $link['title']; ?><\/a><\/li>\n <?php endforeach; ?>\n <\/ul>\n<?php endif; ?>\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n\n1.7.1<\/h4>\n\n\n- Removed an obsolete console log that may cause problems on Internet Explorer 7 and 8.<\/li>\n<\/ul>\n\n
1.7<\/h4>\n\n\n- Added a Widget to show the related links in your widgetized theme areas.<\/li>\n
- Fixed a JavaScript error when adding custom links.<\/li>\n
- Settings aren't reset after plugin reactivation.<\/li>\n<\/ul>\n\n
1.6<\/h4>\n\n\n- Metabox loads new list items while scrolling. Leads to a better load and search performance when a blog contains many hundred posts. <\/li>\n
- Use placeholder attribute for input fields.<\/li>\n
- Use plugins_url() to load stylesheets and javascript.<\/li>\n
- Enqueue jQuery UI correctly.<\/li>\n<\/ul>\n\n
1.5.7<\/h4>\n\n\n- Added related_links() function to echo an unordered list of links<\/li>\n
- Added media post-type to link to media files (thanks jhned)<\/li>\n<\/ul>\n\n
1.5.6<\/h4>\n\n\n- Fixed a problem where empty post data could lead to a php error<\/li>\n<\/ul>\n\n
1.5.5<\/h4>\n\n\n- Fixed the marking of already selected links in the list (thanks robert_k for the fix)<\/li>\n<\/ul>\n\n
1.5.4<\/h4>\n\n\n- Fixed a bug where get_related_links() always returned custom links when the post_type parameter was set<\/li>\n<\/ul>\n\n
1.5.3<\/h4>\n\n\n- Updated CSS for WordPress 3.3 <\/li>\n<\/ul>\n\n
1.5.2<\/h4>\n\n\n- Updated the way how settings are saved to be compatible with future WordPress versions<\/li>\n<\/ul>\n\n
1.5.1<\/h4>\n\n\n- Fixed a bug where the plugin was also loaded on the taxonomy admin pages<\/li>\n<\/ul>\n\n
1.5<\/h4>\n\n\n- Links order can be changed with drag and drop<\/li>\n
- Search field to quickly find a link by name<\/li>\n
- External URLs can be added<\/li>\n
- Added an
id<\/code> property to the get_related_links() function<\/li>\n- New meta data structure but legacy support for older plugin versions is added<\/li>\n
- Checking if the post really exists before it is added to the output<\/li>\n
- Better list loading through ajax<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- The meta box content list is now scrollable<\/li>\n<\/ul>\n\n
1.0<\/h4>\n\n
Initial release<\/p>","raw_excerpt":"Manually link to existing content or a custom url through a meta box on the writing page.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/12775","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=12775"}],"author":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/chabis"}],"wp:attachment":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=12775"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=12775"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=12775"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=12775"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=12775"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=12775"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}