There can be no arguments about it, machine tags are cool and they solve problems. And now they work in WordPress with bSuite too (svn only, for the moment).

It’s not just because flickr popularized them that I like them, though it helps and you should definitely look at that stuff:

• The announcement
• Excitement from O’Reilly Radar, ProgrammableWeb, and Dan Catt (who championed the concept at flickr, I think).

Part of what I like about machine tags is that they bring some more structure (but not too much) to the folksonomic ecosystem. I’m not sure how many of the 292 named flickr mashups use machine tags, but there’s a lot of possibility in them.

For my part, I added machine tag support to bSuite because Scriblio needed it. And it was a message on the Scriblio mail list that kicked me into gear to make it work.

Work on bsuite3 is progressing well, thanks to help from Zach and Matt, who are collaborating with me on completely rearchitecting how stats are collected and reported. This, however, is not bs3. It’s a transitional release intended to fix some bugs in b2 and make upgrading easier. This upgrade is recommended for all current bsuite users and new users.

bsuite Features

• Tracks page loads (hits)
• Tracks search terms used by visitors ariving at your site via search engines
• Reports top-performing stories via a function that can be included in the sidebar
• Reports recent comments via a function that can be included in the sidebar
• Reports top search terms via a function that can be included in the sidebar
• Outputs a pulse graph of activity on your site or specific stories
• Lists related posts at the bottom of the current post’s content
• Suggests posts that closely match the search criteria for visitors who arrive via search engines
• Integrates bsuite_speedcache
• Does some stuff with tags

Fixed/Changed/Added

• As mentioned above, a huge-but-invisible feature here is that this version includes some pieces that will make it easy to transition to the new plugin.
• MySQL errors while creating the tables should now be fixed. It’s my shame that these have persisted so long.
• The plugin now “rebuilds the tags table” as soon as you activate it. This is a good thing, but if you’ve got a huge number of posts (or a really short max execution time) it might cause a problem (please leave a comment if it does).
• The related posts feature now works even if you aren’t tagging your posts. If there are no tags, the post’s title is used as a search string.
• This list is probably incomplete and in some other way inaccurate. It’s not intentional, I’m just sloppy. Please leave comments with bug reports or corrections, I’ll do what I can to fix them.
• Finally, I’m now hosting the download on a new server, so it won’t be subject to .Mac’s bandwidth consumption limits.

Installation

• Download and unzip bsuite.zip
• Place bsuite.php in you wp-content/plugins directory
• Place spacer.gif in your wp-content directory
• Log in to your WordPress admin panel and activate the plugin, then visit the new bsuite submenu of the options tab. This will allow bsuite to create its database tables.
• Stats collection will start automatically; you can see the results in the new bsuite Reports submenu of your Dashboard
• Once installed, be sure to enable the options and consider customizing the look by adding the bsuite CSS to your theme’s CSS (sample CSS here).
• In order to view the stats reports reports on your public pages, you’ll need to add the display functions to your pages.

Upgrading

• Upgrades from earlier versions of bsuite are easy, just replace the old bsuite.php file with the new one.
• Don’t forget to visit the bsuite submenu of the options tab so you can setup any new features.

Commands

The bsuite submenu of the options has a few command buttons:

• Clear bsuite_speedcache

  The cache improves performance, but can sometimes get stale before its time. This command clears it.

• Rebuild bsuite tag index

  bsuite maintains its tag index with every story edit. Use this command to bring old-content into the index or if you’ve edited the content in way WP doesn’t know about.

Options

The bstat submenu of the options tab has a few configurable settings:

• Minimum userlevel to view bsuite reports

  The options are restricted to administrators, but you can choose who can view the reports.

• Output default CSS

  Some of the bsuite functions require CSS styles not found in the average style sheet. This will output default styles.

• Default pulse graph style

  This sets how values are interpolated in drawing the pulse graph. Experiment with the options to see how they work.

• Suggest related entries in post

  This will insert a block of links at the tail of each (tagged) post’s content with links to related posts at your site.

• Tag input format

  Name your style: square brackets or angle brackets / <tags> or [tags].

• Highlight search words and offer search help

  The first part of this should be obvious, but the real trick here is using those search words to offer other related content from your site to visitors. It works (and looks) a lot like the option above, but the suggestions only appear when search words are detected.

• Filter incoming search terms using comment moderation and blacklist words

  Referrer spam is as much of a problem as trackback spam. There are a few tricks in bstat to prevent the problem, but here’s one you can configure. Selecting this option tells bstat to not display search terms that contain words in your moderation list or blacklist.

• Ignore hits from registered users at or above userlevel

  No author wants to skew their stats just by poking around their own site.

• Ignore hits from these IP numbers

  Sites with low traffic may find that activity by authors severely skews the stats tracking. Enter an IP address here to ignore it.

Tag Support

Until WordPress adopts a standardized way to manage tags, we’ll have to deal with things like this.

bsuite recognizes tags in three forms:

• Any link with a rel=“tag” attribute
• Any number of single tags like this: <tag>tag name</tag>
• A block of comma-delimited tags like this: <tags>WordPress, WordPress Plugin</tags>

This appears to make it compatible with a number of existing tag management strategies now in use — including those used by Ecto and SimpleTags.

Tags are mapped to Technorati, but a future version will include an option to set other tag resolvers.

Using bsuite Functions

Function usage is unchanged from the last version. Among the things at the top of the list for bs3: widgets.

Known Bugs

None yet, but I’m sure I’m forgetting something. Report what you find in the comments below.

Money Grubbing

bsuite is GPL-licensed free software, but after some urging by friends, I’m opening the tip jar. If you use it and like it, let me know. And if you feel moved, leave a tip in the jar.

beta, blog pulse, bstat, bstats, bsuggestive, bsuite, bug, bug fix, bug fixes, bugs, fix, fixes, graph, plugin, pulse, recommendation system, recommendations, recommender, recommending, referrer, related content, search engine highlighting, search term, search term highlighting, sehl, stable, statistics, stats, stats tracking, tag, tag management, tag relationships, tags, usage, wordpress, wordpress plugin

I was honored to join the conversation yesterday for the latest Talis Library 2.0 Gang podcast, this one on folksonomies and tags. The MP3 is already posted and, as usual, it makes me wonder if I really sound like that. Still, listen to the other participants, they had some great things to say and made it a smart discussion.

I approached the conversation with the notion that what we were really talking about was whether libraries should give their patrons the opportunity to organize the resources they value in ways that make sense to them. For some time one of our patrons here has been telling us he wants all the books that he’s interested on one shelf, and for years the standard retort has been a chuckle. But, why, he might today ask, can’t our library systems make this possible in some virtual way now?

Tags — specifically user contributed tags — are a big element in this larger question. Though they bring up all manner of concerns from authority to vocabulary control, they’ve shown great value outside libraries and interest in them has been energized with the active discussions about how to re-imagine our library catalogs for today’s needs.

My big question is who “owns” those tags, and what motivates taggers. LibraryThing, has enjoyed some great success with tags, while Amazon has achieved little. Tim Spalding’s theory on the matter echos Josh Porter’s dissection of “The Del.icio.us Lesson,” where he notes that “personal value precedes network value.” That is, people tag for personal, perhaps even selfish reasons. People don’t tag to help the community, they tag because it helps the tagger.

I’ve been tagging my stories at MaisonBisson for some time now, and the effort has paid off by making my content more findable both internally and externally at services like Technorati. Flickr makes tagging even more valuable, as the tags are often the only searchable content for image. How else could I find my library-related photos if not from the tags?

On the other hand, my own experiment in user contributed tags seems to have fallen flat, as I’ve received very few useful tags despite the high number of readers who I’d expect to be familiar with tagging. Meanwhile, del.icio.us tells me that there are 133 tagged bookmarks to MaisonBisson in their database. This leaves me wondering if I should invest more effort in working on user contributed tag system that lives in my blog (or or a library catalog, or other discrete system), or should I instead focus on making those systems support outside tagging systems like del.icio.us? This is easy for my blog, where all the pages are already URL addressable, but bibliographic systems are a bigger challenge.

update: hey, Abby’s talking about this over at Thingology and her headline is way better than mine. Darn. Still, the point remains: we need to leverage our systems to make it easy for our patrons organize the things they like wherever and however they wish. Then, we should look for ways to find value in the aggregate. That’s the del.icio.us lesson.

folksonomies, folksonomy, interview, l2, lib20, libraries, library, library 2.0, library catalogs, library systems, opacs, podcast, tagging, tags, talis, talking with talis

Update: bugfix release b2v7 available.

It’s been a while since I released a new version of bsuite, my multi-purpose WordPress plugin. I’d been hoping to finish up a series of new features, but those have been delayed and this is mostly just a collection of bugfixes. This update is recommended for all bsuite users.

bsuite Features

• Tracks page loads (hits)
   
• Tracks search terms used by visitors ariving at your site via search engines
   
• Reports top-performing stories via a function that can be included in the sidebar
   
• Reports recent comments via a function that can be included in the sidebar
   
• Reports top search terms via a function that can be included in the sidebar
   
• Outputs a pulse graph of activity on your site or specific stories
   
• Highlights search words used by visitors ariving at your site via search engines
   
• Lists related posts at the bottom of the current post’s content
   
• Suggests posts that closely match the search criteria for visitors who arrive via search engines
   
• Integrates bsuite_speedcache
   
• Does some stuff with tags

Fixed/Changed/Added

• The bsuite report consolidates the two uselessly differentiated top stories lists and adds a top movers list.
   
• The report also includes a hugely updated Quick Stats section listing today’s current tally and a prediction of the day’s total along with other goodies.
   
• The table definitions have been updated and optimized for better performance. Zach contributed some optimizations to the bstat_hitit() function and underlying MySQL queries, and you’ll also find a number of small code optimizations scattered throughout.
   
• This version finally creates and configures it’s tables automatically upon activation. You no longer need to visit the plugin’s option screen for this to happen.
   
• A fix to address a MySQL error for users running MySQL 5 has been long overdue. It’s in here.
   
• Numbers in the reports are now formatted with commas or whatever local format you’ve set MySQL for, using MySQL’s FORMAT() function.
   
• As requested, I’ve added a function — bstat_hits() — return just the hit count for a story or for the whole blog.
   
• As requested, you can now manually clear the bsuite_speedcache.
   
• As prompted, prodded, and cajoled, I’ve finally made a change to report hits to the front page (and other pages without post IDs).
   
• I did a bunch of thinking about tags a while ago, and bsuite now keeps an index of tags in a separate table. I’ve got plans to use this for later features, but for now it’s just a curiosity that shouldn’t cause any problems.
   
• You can now switch between <tags> or [tags] for compatibility with other plugins (such as noted here) and with WP2’s WYSIWYG editor.
   
• The code now properly calls get_settings(’siteurl’) instead of get_settings(’home’) to build the URL for the spacer.gif that builds the pulse graph, fixing the problem where the graph wouldn’t display for some users.
   
• Not changed, but at least answered: Eddie commented to explain that ‘–disable-bcmath’ can cause the undefined function errors some people were getting. A later release may incorporate Pramudita’s fix.
   
• Also not in this version are the user-contributed tag features I’d gotten so excited about. These just aren’t ready for primetime, but people who want to hack about in alpha-ville will find all the supporting code in there.
   
• This list is probably incomplete and in some other way inaccurate. It’s not intentional, I’m just sloppy. Please leave comments with bug reports or corrections, I’ll do what I can to fix them.
   
• Finally, I’m now hosting the download on a new server, so it won’t be subject to .Mac’s bandwidth consumption limits.
   

Installation

Update: bugfix release b2v7 available.

• Download and unzip bsuite.zip
   
• Place bsuite.php in you wp-content/plugins directory
   
• Place spacer.gif in your wp-content directory
   
• Log in to your WordPress admin panel and activate the plugin, then visit the new bsuite submenu of the options tab. This will allow bsuite to create its database tables.

  Stats collection will start automatically; you can see the results in the new bsuite Reports submenu of your Dashboard
   

• Once installed, be sure to enable the options and consider customizing the look by adding the bsuite CSS to your theme’s CSS (sample CSS here).

In order to view the stats reports reports on your public pages, you’ll need to add the display functions to your pages.

Upgrading

Upgrades from earlier versions of bsuite are easy, just replace the old bsuite.php file with the new one.

If you’re upgrading from bstat (which is so old I was tempted to remove this part of the docs), be sure to delete or deactivate the old plugin before activating the new one. Don’t forget to visit the bsuite submenu of the options tab so you can setup all the new features.

Commands

The bstat submenu of the options has a few command buttons:

• Clear bsuite_speedcache

  The cache improves performance, but can sometimes get stale before its time. This command clears it.
   

• Rebuild bsuite tag index

  bsuite maintains its tag index with every story edit. Use this command to bring old-content into the index or if you’ve edited the content in way WP doesn’t know about.
   

Options

The bstat submenu of the options tab has a few configurable settings:

• Minimum userlevel to view bsuite reports

  The options are restricted to users at userlevel 8 or above, but you can choose who can view the reports.
   

• Output default CSS

  Some of the bsuite functions require CSS styles not found in the average style sheet. This will output default styles.
   

• Default pulse graph style

  This sets how values are interpolated in drawing the pulse graph. Experiment with the options to see how they work.
   

• Suggest related entries in post

  This will insert a block of links at the tail of each (tagged) post’s content with links to related posts at your site.
   

• Tag input format

  Name your style: square brackets or angle brackets / <tags> or [tags].
   

• Highlight search words and offer search help

  The first part of this should be obvious, but the real trick here is using those search words to offer other related content from your site to visitors. It works (and looks) a lot like the option above, but the suggestions only appear when search words are detected.
   

• Filter incoming search terms using comment moderation and blacklist words.

  Referrer spam is as much of a problem as trackback spam. There are a few tricks in bstat to prevent the problem, but here’s one you can configure. Selecting this option tells bstat to not display search terms that contain words in your moderation list or blacklist.

• Ignore hits from registered users at or above userlevel

  No author wants to skew their stats just by poking around their own site.
   

• Ignore hits from these IP numbers.

  Sites with low traffic may find that activity by authors severely skews the stats tracking. Enter an IP address here to ignore it.

Tag Support

Until WordPress adopts a standardized way to manage tags, we’ll have to deal with things like this.

bsuite recognizes tags in three forms:

• Any link with a rel=“tag” attribute
   
• Any number of single tags like this: <tag>tag name</tag>
   
• A block of comma-delimited tags like this: <tags>WordPress, WordPress Plugin</tags>
   

This appears to make it compatible with a number of existing tag management strategies now in use — including those used by Ecto and SimpleTags.

Tags in <tag> and <tags> tags are mapped to Technorati, but a future version will include an option to set other tag resolvers.

Using bsuite Functions

Though many bsuite features require no coding or modifications to theme files, there are a number of public functions available to display lists of top stories, recently commented stories, recent comments, recent incoming search terms, etc. Most of these functions take similar arguments and output their results in similar ways.

Today’s Stats

• bstat_todaypop

  displays top stories for today only.
   

• bstat_todayrefs

  displays top incoming search terms for today only.
   

The functions bstat_todaypop and bstat_todayrefs each take the same arguments.

Usage:
bstat_todaypop({count}, “{before}”, “{after}”);

count is the total number of results to output
before is a string to output before each result
after is a string to output after each result

Example:

<h2>Today's Most Popular</h2>
<ul><?php bstat_todaypop(15, “<li>”, “</li>\n”); ?></ul>

Recent Stats

• bstat_recentpop

  displays top stories for the past x days. This function reveals more useful data on sites with low traffic, but is somewhat slower than bstat_todaypop.
   

• bstat_recentrefs

  displays top incoming search terms for the past x days. This function reveals more useful data on sites with low traffic, but is somewhat slower than bstat_todayrefs.
   

The functions bstat_recentpop and bstat_recentrefs each take the same arguments.

Usage:
bstat_recentrefs({count}, “{days}”, “{before}”, “{after}”);

count is the total number of results to output
days is the number of days back to look
before is a string to output before each result
after is a string to output after each result

Example:

<h2>Incoming Search Terms This Week</h2>
<ul><?php bstat_recentrefs(15, 7, “<li>”, “</li>\n”); ?></ul>

Recent Discussion

• bstat_discussionbypost

  displays recently commented posts. Each post will appear only once.
   

• bstat_discussionbycomment

  displays recent comments (and commenter). Better on sites with lots of community interaction.
   

The functions bstat_discussionbypost and bstat_discussionbycomment each take the same arguments.

Usage:
bstat_discussionbypost({count}, “{before}”, “{after}”);

count is the total number of results to output
before is a string to output before each result
after is a string to output after each result

Example:

<h2>Incoming Search Terms This Week</h2>
<ul><?php bstat_discussionbypost(15, “<li>”, “</li>\n”); ?></ul>

Special Functions

• bstat_hits

  displays the current and average daily page loads.
   

Usage:
bstat_hits([{template}, [{post_id}, [{today_only}]]]);

template will be filled in with the appropriate values for %%hits%% and/or %%avg%%. If left blank, the default template is %%hits%% hits, about %%avg%% daily
post_id over-rides the detected post ID. Common values for this may include “0” to show stats for index pages, or “-1” to show stats for the entire blog (note that %%avg%% reports inaccurately with a “-1” value here)
today_only returns the count for today (note that %%avg%% doesn’t make much sense here)

Example:

<?php bstat_hits('%%hits%% hits, about %%avg%% daily') ?>

prints something like “791 hits, about 10 daily”

<?php bstat_hits('%%hits%% page loads today', -1, 1) ?>

prints something like “5,950 page loads today”

• bstat_pulse

  displays the “pulse” graph of hits over time.
   

Usage:
bstat_pulse([{post_id}, [{max_width}, [{display_text}, [{display_credit}, [{graph_accurate}]]]]]);

post_id is the post_id for the story, usually provided by a WP variable
max_width is the maximum width the graph maw run
display_text (acceptable values: 0 or 1), switch to display stats for total views and average views per day
display_credit (acceptable values: 0 or 1), switch to display “powered by bstat” credit
graph_accurate (acceptable values: 0 or 1), make smooth, accurate graphs or fuzzy (but not inaccurate) graphs

Example:

<h3>Story pulse</h3><?php bstat_pulse($id, 525, 1, 1, 1); ?>

• bstat_hitit

  The hamster on a wheel that makes it all work. It records hits for each page load, and hits for each incoming search term.
   

This function is no longer necessary, as it is executed automatically via a plugin hook that runs every time the footer is called. Still, it’s around if you have content that you want to track outside that scope.

Example:

<?php // this is how it used to work, but it's automated now...
	global $id;
    if (!is_single() && !is_page()) $id = 0;
	bstat_hitit($id, “read”);
	?>

note: (be careful of any “curly quotes” that might have been accidentally/automagically inserted in code samples)

Known Bugs

None yet, but I’m sure I’m forgetting something. Report what you find in the comments below.

recommendation system, pulse, plugin, graph, fixes, fix, bugs, bug fixes, bug fix, bug, bsuite, bsuggestive, bstats, bstat, blog pulse, beta, recommendations, recommender, recommending, referrer, related content, search engine highlighting, search term, search term highlighting, sehl, statistics, stats, stats tracking, tag, tag management, tag relationships, tags, usage, wordpress, wordpress plugin

Ross Singer gets the prize for submitting the first reader contributed tag, the latest feature in bsuite.

There are arguments about whether user-contributed tags are useful or even valid, or whether they should be stored in my site or aggregated at places like del.ici.ous. But who’s to worry about such questions? Who’s to worry when you can put together the work already done to support author’s tags with WordPress’s pretty good comment system and get user contributed tag support with just a few extra lines of code? Who’s to worry when we can try it and see what comes of it?

It’s all managed using the same tools we use to approve, moderate, and edit comments, which also means the spam filtering that works for comments works for contributed tags too. And because bsuite is already part of WPopac, that means it gains the new tagging features too (well, it will soon).

bsuite, collabulary, folksonomy, tag, tagging, tags, user contributed, wisdom of the crowd, wpopac

Flickr does tags better than any other, so far as I can tell.

We love tag folksonomies for way they allow us all to organize our world, for the way they allow patterns to emerge from chaos, and for their easy flexibility. But that flexibility, if poorly implemented in our software, can interrupt the very patterns we hope to find in our tag networks.

Take “road trip” as an example. What one tagger thinks is two words might be just “roadtrip” to another. This is where Flickr’s tag indexing does it right: we still have to pick the right words (and spelling), but we don’t have to worry about spaces or punctuation.

So, when I tag a photo “Mt. Moosilauke,” Flickr stores the both text I enter as well as a version in all lower-case, without spaces or punctuation: “mtmoosilauke.” And when you search for “Mt. Moosilauke,” you get the same results as your neighbor searching for “mt moosilauke.”

Well, that’s how I think tags should work, anyway. And you’ll notice it’s how they’re working here now. The text of the tags at the bottom of this post and all others here displays as I entered it, but they resolve to a tag URL without spaces or punctuation, just as Flickr’s do.

Um…update: okay, Matty and I agree and disagree about a few things, but he just re-wrote the core-tagging function in bsuite, so I’ve gotta give him his way on a thing or two for a moment. So…tags are back to the broken Technorati standards. That is, somebody searching for “roadtrip” won’t find posts tagged “road trip,” but we’ll fix that in time.

folksonomy, folksonomies, tag, tags, Flickr, tagging, doing it right, Best Practice

Ignore the politics for a moment. MoveOn’s CTO, Patrick Michael Kane, remarked that the organization’s membership to Flickr, the photo sharing site, has paid off: “Flickr has got to be the best $24.95 we’ve ever spent.”

Why?

Micah Sifry explains in a story at AlterNet that MoveOn had been soliciting photos of events from members for some time, but their ability to move those photos through the process and make them available to the public was limited. The irony, for an organization built on grass roots participation, is that they couldn’t deal with the photos people were submitting from events and actions. So they started looking at Flickr, which now hosts over 80 million photos.

The group started using the service in April 2005, and now hosts almost 9000 photos at Flickr. MoveOn allows members to submit photos via email, then then uses a review application based on the Flickr API that allows other members to vote for photos to be posted on the public site. Those reviewers can also push some photos to the top of the pile by tagging them “great”.

As it turns out, tags (folksonomies) are among the most valuable features for MoveOn. Kane explains: “one of our campaigners wanted a slideshow of photos from a recent action and was able to put it together himself, just by selecting the tags he was interested in and using the Flickr slideshow app.”

Again, ignore the politics. Look at this carefully and tell me if there’s any better application to meet their needs. Now tell me how social software can better meet your organizations needs.

Need help? Here’s Sifry’s conclusion:

The larger lesson for other organizations is this: As social networking sites like Flickr, del.icio.us (also just bought by Yahoo!), and MySpace attract millions of users, it may make sense to go where the people already are and start playing with the same tools, not only because those tools may offer all kinds of benefits to the organization, but also to see what unexpected benefits may engage people. What MoveOn is doing with Flickr is just a beginning.

social software, flickr, moveon, social applications, tags, tag, tagging, social software for politics, leveraging social software

I’ve fixed another bug in bsuite b2, my multi-purpose plugin. This update is recommended for all bsuite users.

Fixed

• Previous versions would throw errors at the bottom of the page when the http referrer info included search words from a recognized search engine.
   

Installation

Follow the directions for the bsuite b2 release. The download link there will always fetch the current version.

Upgrades from earlier versions of bsuite are easy, just replace the old bsuite.php file with the new one. Upgrades from bstat follow the same directions as before.

bsuite Features

• Tracks page loads (hits)
   
• Tracks search terms used by visitors ariving at your site via search engines
   
• Reports top-performing stories via a function that can be included in the sidebar
   
• Reports recent comments via a function that can be included in the sidebar
   
• Reports top search terms via a function that can be included in the sidebar
   
• Outputs a pulse graph of activity on your site or specific stories
   
• Highlights search words used by visitors ariving at your site via search engines NEW!
   
• Lists related posts at the bottom of the current post’s content NEW!
   
• Suggests posts that closely match the search criteria for visitors who arrive via search engines NEW!
   
• Integrates bsuite_speedcache NEW!
   
• Does some stuff with tags NEW!

search term highlighting, search engine highlighting, sehl, bsuggestive, recommendations, recommender, recommending, recommendation system, related content, tag, tags, tag management, tag relationships, beta, blog pulse, bsuite, bstat, bstats, graph, plugin, pulse, referrer, search term, statistics, stats, stats tracking, usage, wordpress, wordpress plugin, bug fix, fix, fixes, bug, bugs, beta, bug fixes

I’ve fixed a couple bugs in bsuite b2, released last week.

Fixes

• A bug with search word highlighting that caused it to litter the display in some cases.
   
• A silly mistake of mine that cause a mysql error for some users.

Installation

Follow the directions for the bsuite b2 release. The download link there will always fetch the current version.

Upgrades from bsuite b2 are easy, just replace the old bsuite.php file with the new one. Upgrades from bstat follow the same directions as before.

bsuite Features

• Tracks page loads (hits)
   
• Tracks search terms used by visitors ariving at your site via search engines
   
• Reports top-performing stories via a function that can be included in the sidebar
   
• Reports recent comments via a function that can be included in the sidebar
   
• Reports top search terms via a function that can be included in the sidebar
   
• Outputs a “pulse” graph of activity on your site or specific stories
   
• Highlights search words used by visitors ariving at your site via search engines NEW!
   
• Lists related posts at the bottom of the current post’s content NEW!
   
• Suggests posts that closely match the search criteria for visitors who arrive via search engines NEW!
   
• Integrates bsuite_speedcache NEW!
   
• Does some stuff with tags NEW!

search term highlighting, search engine highlighting, sehl, bsuggestive, recommendations, recommender, recommending, recommendation system, related content, tag, tags, tag management, tag relationships, beta, blog pulse, bsuite, bstat, bstats, graph, plugin, pulse, referrer, search term, statistics, stats, stats tracking, usage, wordpress, wordpress plugin, bug fix, fix, fixes, bug, bugs, beta, bug fixes

bsuite highlights the search words used to find blog posts in Google and other search engines, and uses those search terms to recommend other related posts at your WordPress site.

— – —

bsuite uses the tags of one post to recommend related posts in your WordPress blog.

— – —

bsuite includes an easy to use statistics engine that tracks the daily hits to every post and page.

beta, blog pulse, bstat, bstats, bsuggestive, bsuite, graph, plugin, pulse, recommendation system, recommendations, recommender, recommending, referrer, related content, search engine highlighting, search term, sehl, statistics, stats, stats tracking, tag, tag management, tag relationships, tags, usage, wordpress, wordpress plugin, search term highlighting

The first thing we all have to agree on is that bsuite is the replacement for bstat. The name change reflects that fact that the plugin is doing a lot more than simply track page loads. The most exciting new feature is a module I can’t help but call bsuggestive. It uses the tags of the current post to suggest related posts to your readers. And when readers arrive at your site via a search engine, it not only highlights the search words they used, but offers a list of other posts matching their search criteria.

Why “b2″? I released b1 privately a while ago, and I’ve been running it here at MaisonBisson since September.

bsuite Features

• Tracks page loads (hits)
   
• Tracks search terms used by visitors ariving at your site via search engines
   
• Reports top-performing stories via a function that can be included in the sidebar
   
• Reports recent comments via a function that can be included in the sidebar
   
• Reports top search terms via a function that can be included in the sidebar
   
• Outputs a “pulse” graph of activity on your site or specific stories
   
• Highlights search words used by visitors ariving at your site via search engines NEW!
   
• Lists related posts at the bottom of the current post’s content NEW!
   
• Suggests posts that closely match the search criteria for visitors who arrive via search engines NEW!
   
• Integrates bsuite_speedcache NEW!
   
• Does some stuff with tags NEW!
   

Changes

This documentation supersedes any previous documentation.

I need to be honest, it’s been too long since the last public release for me to remember all the details. I haven’t really been keeping records on all this, so if you’ve been running the previous version and you discover a problem, please tell me about it.

The first change is that the plugin is now in a file named “bsuite.php”. As you install it you’ll need to deactivate the previous “bstat.php” version to avoid conflicts.

Another big change is that bsuite will now start tracking page loads as soon as it’s activated. You no longer need to put any code in your theme. But if you’re upgrading from a version where you already have that code in your theme, it also includes code to prevent it from double-counting any page loads.

The other functions from bstat b4 are all there, and I don’t believe there are any changes to the way they’re called.

The options submenu is almost entirely redesigned. It should be pretty self explanatory, but there’s documentation below.

Installation

Update: bugfix release b2v7 available.

• Download and unzip bsuite.zip
   
• Place bsuite.php in you wp-content/plugins directory
   
• Place spacer.gif in your wp-content directory
   
• Log in to your WordPress admin panel and activate the plugin, then visit the new bsuite submenu of the options tab. This will allow bsuite to create its database tables.

  Stats collection will start automatically; you can see the results in the new bsuite Reports submenu of your Dashboard
   

• Once installed, be sure to enable the options and consider customizing the look by adding the bsuite CSS to your theme’s CSS (sample CSS here).

In order to view the stats reports reports on your public pages, you’ll need to add the display functions to your pages.

Upgrading

If you’re upgrading from bstat, be sure to delete or deactivate the old plugin before activating the new one. And don’t forget to visit the bsuite submenu of the options tab so that it can create its new db tables.

Options

The bstat submenu of the options tab has three configurable settings:

• Minimum userlevel to view bsuite reports

  The options are restricted to users at userlevel 8 or above, but you can choose who can view the reports.
   

• Output default CSS

  Some of the bsuite functions require CSS styles not found in the average style sheet. This will output default styles.
   

• Default pulse graph style

  This sets how values are interpolated in drawing the pulse graph. Experiment with the options to see how they work.
   

• Suggest related entries in post

  This will insert a block of links at the tail of each (tagged) post’s content with links to related posts at your site.
   

• Highlight search words and offer search help

  The first part of this should be obvious, but the real trick here is using those search words to offer other related content from your site to visitors. It works (and looks) a lot like the option above, but the suggestions only appear when search words are detected.
   

• Filter incoming search terms using comment moderation and blacklist words.

  Referrer spam is as much of a problem as trackback spam. There are a few tricks in bstat to prevent the problem, but here’s one you can configure. Selecting this option tells bstat to not display search terms that contain words in your moderation list or blacklist.

• Ignore hits from registered users at or above userlevel

  No author wants to skew their stats just by poking around their own site.
   

• Ignore hits from these IP numbers.

  Sites with low traffic may find that activity by authors severely skews the stats tracking. Enter an IP address here to ignore it.

Tag Support

Until WordPress adopts a standardized way to manage tags, we’ll have to deal with things like this.

bsuite recognizes tags in three forms:

• Any link with a rel=”tag” attribute
   
• Any number of single tags like this: <tag>tag name</tag>
   
• A block of comma-delimited tags like this: <tags>WordPress, WordPress Plugin</tags>
   

This appears to make it compatible with a number of existing tag management strategies now in use — including those used by Ecto and SimpleTags.

Tags in <tag> and <tags> tags are mapped to Technorati, but a future version will include an option to set other tag resolvers.

Using bsuite Functions

Though many bsuite features require no coding or modifications to theme files, there are a number of public functions available to display lists of top stories, recently commented stories, recent comments, recent incoming search terms, etc. Most of these functions take similar arguments and output their results in similar ways.

Today’s Stats

• bstat_todaypop

  displays top stories for today only.
   

• bstat_todayrefs

  displays top incoming search terms for today only.
   

The functions bstat_todaypop and bstat_todayrefs each take the same arguments.

Usage:
bstat_todaypop({count}, "{before}", "{after}");

count is the total number of results to output
before is a string to output before each result
after is a string to output after each result

Example:

<h2>Today's Most Popular</h2>
<ul><?php bstat_todaypop(15, "<li>", "</li>\n"); ?></ul>

Recent Stats

• bstat_recentpop

  displays top stories for the past x days. This function reveals more useful data on sites with low traffic, but is somewhat slower than bstat_todaypop.
   

• bstat_recentrefs

  displays top incoming search terms for the past x days. This function reveals more useful data on sites with low traffic, but is somewhat slower than bstat_todayrefs.
   

The functions bstat_recentpop and bstat_recentrefs each take the same arguments.

Usage:
bstat_recentrefs({count}, "{days}", "{before}", "{after}");

count is the total number of results to output
days is the number of days back to look
before is a string to output before each result
after is a string to output after each result

Example:

<h2>Incoming Search Terms This Week</h2>
<ul><?php bstat_recentrefs(15, 7, "<li>", "</li>\n"); ?></ul>

Recent Discussion

• bstat_discussionbypost

  displays recently commented posts. Each post will appear only once.
   

• bstat_discussionbycomment

  displays recent comments (and commenter). Better on sites with lots of community interaction.
   

The functions bstat_discussionbypost and bstat_discussionbycomment each take the same arguments.

Usage:
bstat_discussionbypost({count}, "{before}", "{after}");

count is the total number of results to output
before is a string to output before each result
after is a string to output after each result

Example:

<h2>Incoming Search Terms This Week</h2>
<ul><?php bstat_discussionbypost(15, "<li>", "</li>\n"); ?></ul>

Special Functions

• bstat_pulse

  displays the "pulse" graph of hits over time.
   

Usage:
bstat_pulse([{post_id}, [{max_width}, [{display_text}, [{display_credit}, [{graph_accurate}]]]]]);

post_id is the post_id for the story, usually provided by a WP variable
max_width is the maximum width the graph maw run
display_text (acceptable values: 0 or 1), switch to display stats for total views and average views per day
display_credit (acceptable values: 0 or 1), switch to display “powered by bstat” credit
graph_accurate (acceptable values: 0 or 1), make smooth, accurate graphs or fuzzy (but not inaccurate) graphs

Example:

<h3>Story pulse</h3><?php bstat_pulse($id, 525, 1, 1, 1); ?>

• bstat_hitit

  The hamster on a wheel that makes it all work. It records hits for each page load, and hits for each incoming search term.
   

This function is no longer necessary, as it is executed automatically via a plugin hook that runs every time the footer is called. Still, it’s around if you have content that you want to track outside that scope.

Example:

<?php // this is how it used to work, but it's automated now...
	global $id;
    if (!is_single() && !is_page()) $id = 0;
	bstat_hitit($id, "read");
	?>

note: (be careful of any "curly quotes" that might have been accidentally/automagically inserted in code samples)

Known Bugs

The search word highlighting routine seems to still be buggy. Expect it to mis-recognize referrers, and one tester reported that it caused content not to display. Go ahead and enable it to see how cool it will be in b3, when it works, but I suggest disabling it for the moment.

Ryan Eby reminded me that I use a whole bunch of short PHP open tags (”<?” where I should have used “<?php”).

Zach pointed out that I’ve been sort of sloppy about using double-quotes where I should use single quotes and not single-quoting my array indices. All of this can add up to an unnecessary performance hit for high traffic sites (30,000 + daily page loads).

beta, blog pulse, bstat, bstats, bsuggestive, bsuite, graph, plugin, pulse, recommendation system, recommendations, recommender, recommending, referrer, related content, search engine highlighting, search term, search term highlighting, sehl, statistics, stats, stats tracking, tag, tag management, tag relationships, tags, usage, wordpress, wordpress plugin

bsuite, the follow-up to bstat, now includes a module called “bsuggestive” that recommends related posts based on the current post’s tags or alternate posts based on your search words when you arrive from a recognized search engine.

That is, bsuggestive does two neat things:

First, visitors will see a section in each post with links to other posts on your site that have similar content. The “similarity” is judged by comparing the current posts tags against the content and titles of all other posts in the database. This requires tags, and I’ll explain that later.

Second: visitors who arrive at your site from a search engine will see a list of other posts that closely match the original search words used at that search engine. This is especially helpful when people arrive at your front page or an archive page that may include a number of posts not related to the search query.
The big downside to all of this is that it (at least part of it) requires tags, and there’s no standardized support for tags in WordPress.

What to do? Easy: bsuite automatically recognizes any links with a rel=“tag” attribute as a tag. A little iffy: bsuite has adopted the simpletags approach to tagging. This is “iffy” because you should disable the simpletags plugin if you’re already using it (running both will needlessly increase CPU usage, but won’t do anything “bad”).

tags: bstat, bsuite, content tagging, plugin, related content, tag, tag management, tagging, tags, wordpress, wordpress plugin

David Weinberger at Many-to-Many pointed me to Tom Coates’ post about different schools of thought regarding tags. Coates has been thinking about tags as keywords, annotations. Thats how I’ve been using and thinking about tags too, but some people have different ideas.

…At the end of the argument I said to Joshua that it was almost like he was treating tags as folders. And he replied, exasperated, that this was exactly what they were.

Exasperation aside, Coates is pretty sure that Joshua’s view is loosing currency and the keywords view is growing.

Wienberger offers this explanation: we use tags as folders to organize things for ourselves, but we use tags as keywords as a way to contribute to the social understanding of things. That’s what Yahoo’s Social Search is trying to leverage.

Related: Google’s War On Hierarchy.

tags: annotating, annotations, culture war, david weinberger, folders, folksonomy, keywords, schools of thought, search, social search, tag, tag cloud, tagging, tags, taxonomy, tom coates, yahoo social search

Who doesn’t love tagging? No, tagging as in annotating, not graffiti. Anyway, Rixome is the latest among a bunch of plans/projects to enable tagging of geographic spaces/real-life environments.

The good people at We Make Money Not Art had this in their post:

rixome is a network and a tool that turns mobile screens into windows that show the virtual and public dimensions of our point of view.

A walker (a rixome user) can see on his/her mobile phone/PDA/laptop screen the virtual interventions that have been added to the location where s/he now stands. For example, a spoken message can be left on a given location for other “walkers” to hear through headphones whenever they pass by. The message can also be written, or it can be a 3D animation or image, a photography, a drawing, a video.

Remote rixome users can also check vía Internet the traces left by others but s/he won’t be able to add an intervention similar to those published in situ.

Developed by gelo for his at Master of Art and New Technologlies at the Universidad Europea de Madrid.

(Engadget is onto this story too)

This idea isn’t new (see Twenty Years From Now: Urban tagging and New Media Knowledge – GeoTagging The City) But time, technology, and a forward thinking art student make Rixome look more plausible than the others.

Related: previously at MaisonBisson: Geolocating The News, When You Don’t Have A GPS, and anything else about geolocation. Interesting websites: Urban Tapestries | Social Tapestries and Gelo.tv. Books: The Wisdom of Crowds and Smart Mobs.

art student, folksonomy, forward thinking, geography, geolocation, geotag, geotagging, laptop screen, mobile, mobile phone, new media, pda, public dimensions, social environments, spoken message, tag, tagged environments, tagging, tags, urban environments

WordPress’s XML-RPC support looks pretty good. Heck, it supports a half dozen APIs and works well with ecto … except for tag support, which is my only complaint with it so far.

The Movable Type API supports a “keywords” field that I’m thinking can be hijacked as a “tags” field instead, but while ecto sends the goods — I can see them in the XML-RPC data that gets sent out, WordPress seems to ignore them upon receipt. So I’m looking around the Wordpress plugin API docs for a solution, but all I can find is an undocumented mention of xmlrpc_methods in Skippy’s list of plugin hooks.

Technorati Tags: api, codex, ecto, plugin, tag, tags, xml, xml-rpc

I thought I was real smart when I modified the tags plugin to support integration with Technorati. The code was simple, just look in the tags.php plugin file for the foreach statements that run through the tags names and turn them into links on the page and change the $tags[] = statement to look something like this:

$tags[] = “<a href=\”“.get_tag_link($row->tag_name).”\“ target=\”$target\“ rel=\”tag\“ title=\”More “.$row->tag_name.” at {site name}\“ >”.$row->tag_name.“</a> <a href=\”http://technorati.com/tag/“.$row->tag_name.”\“ target=\”$target\“ rel=\”tag\“ title=\”Find “.$row->tag_name.” at Technorati\“ ><img src=\”http://{path/to}/technorati-bubble.gif\“ /></a>”;

But thinking you’re smart isn’t enough. Example: I fixed the tags to Technorati integration only to find that modifying the post in Ecto would delete all the tags and geolocation information I’d worked so hard to enter. Yeah, I’m working on that.

Technorati Tags: php, plugin, integration, tag, tags, technorati, wordpress