Magnolia WordPress Plugin

Current Version: 1.4

This plugin makes it easy to output a list of your Ma.gnolia bookmarks anywhere on your site. You can set it to only pull bookmarks with a specific tag, which is great for listing sites related to a specific category or post. You don’t even need WordPress!

Please download the plugin and provide me your feedback in the comments of this page. I’ll do my damnedest to fix any bugs you report and look forward to expanding it to be even more useful!

Magnolia WordPress Plugin 1.4

Make sure to join the Plugin group on Ma.gnolia to add your site to the list if you are using this plugin!

Install

WordPress

Drop the entire plugin folder into wp-content/plugins/ - the final paths will be:
- wp-content/plugins/magnolia/last_rss.php
- wp-content/plugins/magnolia/magnolia.php
Activate the plugin in the admin area of your wordpress install

Any Site Running PHP 4+, Without WordPress

Drop the magnolia folder into a directory of your site
Open magnolia.php and edit line 31, changing $rss->cache_dir = ABSPATH . 'wp-content' to point to a directory on your server. Use a fully qualified path in place of ABSPATH . 'wp-content'. For example, you may need to use $rss->cache_dir = /user/mysite/public_html/cache'.
Add an include or require statement at the top of the pages that will display the links
Use the same PHP snippets as you would for WordPress, see the examples page to see some in action.

To Use

This plugin is pretty straightforward, so all it takes once you’ve installed the plugin is a single line of PHP, inserted wherever you want the list of links to appear. You can display several lists on a page without any issues as well. You can pass the following variables to the plugin:

Configuration Option	Setting
Collection	is the Ma.gnolia account to use if you want to pull from a person’s bookmarks, or the short name of the group if you want to display bookmarks from a group.
Number of Bookmarks	sets the amount of links you want the tag to output, this defaults to 10.
Show Descriptions	tells the plugin whether or not it should include descriptions in the output. This defaults to “Do Not Show”.
Show Publication Dates	tells the plugin whether or not it should output the date the URL was bookmarked in Ma.gnolia. This defaults to “Do Not Show”.
Use Ma.gnolia’s links?	determines whether the links should point directly to the bookmarked URL, or the bookmark’s page on Ma.gnolia. This defaults to the Bookmark’s actual URL.
Tag	allows you to pass in a tag to narrow down the list of results. Only bookmarks matching that tag will be output. This is empty by default, so it pulls all bookmarks regardless of their tags. Use a plus sign (+) to separate multi-word tags. For example “web+design”.
Collection Type	determines whether you are pulling bookmarks from an individual (’people’) or a group (’groups’). This works in conjunction with $collection.
View collection link	controls whether a link to view more links from the collection is output.
Feed Type	determines how much information will be output with each link: lite (default) will output a description, mimicking the behavior of version 1.3 full will output the bookmark thumbnail image, the description and the tags associated with the bookmark

The output consists of an unordered list, each link contained in a separate list item tag.

Example of Usage

Check out these examples to see the code in action! Each example include the snippet of PHP used to create it and an explanation of each option.

Behind the Scenes

Barry Price built the first version of this plugin, maintaining it through v 1.2 and what you see here is a a modified version of his work and the Last RSS Parser, which does much of the heavy lifting. At this point, I (BaldTechnologist on Ma.gnolia) have picked up the project and will be adding features as suggestions come in and time allows. If you have an idea, please contact me and I’ll see what I can do!

Contribute, for Free!

It’s easy to support this free plugin, and it won’t cost you a thing! Here are a few simple ways:

When you plan to buy something from Amazon, follow this link (Amazon.com). It won’t cost you anything, but it will add a small amount of your purchase to my account.
Write about the Ma.gnolia for WordPress plugin on your site
Add a link back to my site (www.silverspider.com) from yours
Drop me a line to say hi and let me know where you are running the plugin.

Changes Made

Version 1.4

Added the ability to pull bookmarks from group collections as well as those of individual people. Tags can be used with either, so you can pull bookmarks from the Web Design group that have been tagged with ‘css’.
Added ability to pull the Full feed from Ma.gnolia, which includes:
- Thumbnails of each bookmark
- The tags applied to each bookmark
Please note, this is all or nothing, so you cannot just pull the image, or the image and description without the tags. Sorry, but that’s how it’s coming through and I spent too much time trying to find a way around it with a couple of different RSS parsers.
Changed the variable $username to $collection to fit the new model of pulling from groups or individuals.
Added configuration option to enable/disable the link to view more Ma.gnolia bookmarks

Version 1.3

I’ve made some changes, both major and minor to the plugin, including:

Changed quote usage from single quotes to double quotes to improve parsing efficiency.
Improved comments within the script
Moved the feed parser class (Last RSS) to a separate file for ease of maintenance.
Various code, formatting and commenting changes

Upcoming Changes

These are not currently prioritized, but I want to add these features/implement these revisions:

Add CRON abilities to pre-cache feeds instead of waiting for a request
Add ability to search multiple tags (AND & OR)
Add functionailty to add each day’s links into WordPress as a post
…(this is where your suggestions come in)