Daring Fireball-style Linked List Plugin

• Contributors: yjsoon
• Donate link: http://yjsoon.com/dfll-plugin
• Tags: links, rss, wordpress, linkblogs, linked-list
• Requires at least: 2.7
• Tested up to: 3.5.1
• Stable tag: 2.8.1

Make your RSS feed for linked-list posts behave like Daring Fireball's: item's RSS permalink goes to link, and other modifications.

Description

This plugin makes your RSS feed behave like Daring Fireball's linked list posts, and has some extra features to make posting linked lists easier.

Part One

Makes your RSS feed for linked-list posts (indicated using a custom field) behave like Daring Fireball.

To use, set the custom field "linked_list_url" to the desired location on a link post. In your RSS feed, the following will happen:

(i) the item's RSS permalink becomes the link destination; (ii) the actual permalink to your post is inserted as a star glyph at the end of your post; and (iii) a star glyph is added in front of your non-linked-list post titles. Behaviour is customisable in options.

All three parts are customizable, and you can use different glyphs or text if you'd like. For theme designers, the plugin also provides functions (get_the_permalink_glyph(), the_permalink_glyph(), get_the_linked_list_link(), the_linked_list_link(), get_glyph() and is_linked_list()) to customise your design by checking if the item is a linked list item, getting a permalink with glyph, etc.

Adapted from Jonathan Penn's Wordpress Linked List plugin.

Part Two

Add link from post content. This feature allows you to set the custom field "linked_list_url" from within the post content. This is especially handy for using with the 'Press This' bookmarklet.

When you activate this feature, the DFLL plugin will look at the first line of your post content for a link anchor, and it'll set that link as the linked_list_url for your post. For example, the following post content:

<a href='http://google.com'&gt;Google!!!&lt;/a>. This is a link post to Google.

... will have its first line removed, the URL http://google.com passed into the custom field linked_list_url, and will have its first line removed to just end up with the text 'This is a link post to Google'. The text in the anchor ('Google!!!') will be ignored.

It's very important to note three requirements: (i) the anchor tag must be in the first line of the post, (ii) the tag must be the only element on that line, and (iii) the line must end in a period. This is the syntax that the 'Press This' bookmarklet uses, so you can just hit 'Press This' and enter to go to the next line and stop typing.

Any text in the anchor will be ignored, and the entire first line will be discarded. This also means that if, for whatever, reason, you like posting link anchors that end in periods as the first line of your blog, you shouldn't activate this checkbox, or you'll end up with linked list posts by accident!

This was adapted from CF Setter by Justin Blanton.

Twitter Tools support

Twitter Tools support has been deprecated, given changes in the plugin. Sorry! If you had it, it should still work.

Questions or suggestions? Look me up on Twitter.

Installation

• Upload linked-list.php to the /wp-content/plugins/ directory

• Activate the plugin through the Plugins menu in WordPress

• Customise extra text in your link titles and body in Settings -> DF-Style Linked List.

• To customize the theme, use the child theme provided, or check out my theme customization instructions.

• Some basic instructions follow: Templates can be customised by using the provided functions to check whether your are rendering a linked list item or not. For example:

    <!--the top part of a template-->
  
    <?php if (have_posts()): ?>
        <?php while (have_posts()) : the_post(); ?>
            <?php if (is_linked_list()): ?>
  
                <!-- other HTML formatting -->
                <a href="<?php the_linked_list_link()">This is a linked list link</a>
                <!-- other HTML formatting -->
  
            <?php else: ?>
  
                <!-- other HTML formatting -->
                <a href="<?php the_link()">This is a normal post link</a>
                <!-- other HTML formatting -->
  
            <?php endif; ?>
        <?php endwhile; ?>
    <?php endif; ?>
  
    <!--the rest of the template-->
  

• Essentially, use the is_linked_list() function to check, then alter your template the way you wish to make it look or act differently.

• Other functions you can use are get_the_permalink_glyph(), the_permalink_glyph(), get_the_linked_list_link(), the_linked_list_link() and get_glyph().

• For more information about customizing wordpress templates, view the "Template Tags" document on the Wordpress Codex

Usage

• When adding a link, create a normal blog post, but add a custom field "linked_list_url" with the desired link URL. The RSS feed item will automatically point to that URL.
• When posting, to insert a link without setting the custom field manually, put your URL wrapped in an anchor tag in the first line, ending with a period. For example: <a href="http://yjsoon.com"> Doesn't matter what's in here </a>.

Frequently Asked Questions

Why doesn't my RSS feed change immediately?

The changes could take a while to show up. Google Reader took a day to register changes in my feed settings. If you want to test, add your RSS feed to My Yahoo and refresh it with the "options" pane -- this updated the most reliably for me while testing.

Why doesn't the new link posting work?

You have to enable it in the options page, and also make sure you insert an anchor tag link on the first line which ends in a period (dot).

This doesn't work! My blog looks the same!

You still have to customize your theme to make it look right. Please refer to this blog entry for more information.

Changelog

2.8.1

• Removed Twitter Tools support and plugin
• Removed Linkmarklet version, you can now use the original

2.8

• Cleanup of options (thanks alexrudy)
• Syntax cleanup (thanks jgwong)
• Added new twentyeleven theme (just in time for 2012, oops)

2.7.3

• Included child theme and instructions.

2.7

• Twitter Tools support.

2.6

• CDATA fix -- RSS should now validate. Thanks to @pyrmont for the fix.

2.5.4

• Critical stability update -- the previous version was causing some issues on certain installs. If you have any problems, please look for me on Twitter.
• Fixed permalink glyph not appearing.

2.5

• Added functionality to set the linked list URL custom field with an anchor tag link in the first line.
• Removed the ability to post a linked list URL with [ll] and [/ll]. If you'd like to do that, use Justin Blanton's CF Setter instead.

2.0

• Initial public release on WordPress plugins

Upgrade Notice

2.8.1

Removed Twitter Tools and some cleanup. Now supports Linkmarklet.

2.8

Some code cleanup and small fixes. Includes Twentyeleven child theme now (sorry, a bit late).

2.7.3

Includes child theme and instructions.

2.7

Twitter Tools support.

2.6

CDATA fix -- RSS should now validate. Thanks to @pyrmont for the fix.

2.5.3

Bugfix for permalink glyph not showing up at end of posts. Sorry about that.

2.5.2

Critical stability update -- the previous version was causing some issues on certain installs. If you have any problems, please look for me on Twitter.

2.5.1

This version adds a major new feature -- you can now set the linked_list_url field without going into WordPress's custom fields menu. See plugin homepage for details.

License

Copyright (c) 2010-2013 YJ Soon

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.