Daring Fireball-style Linked List Plugin

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. Also supports Twitter Tools.

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’>Google!!!</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

If you’re using Twitter Tools, you can customise your tweets to have your custom glyph or text appear before either your “regular” or linked-list posts.

Questions or suggestions? Look me up on Twitter.

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>.

License

Copyright (c) 2010-2011 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.