AS Docs -- Mayday! Mayday!

The MTStreamActionVar takes all sorts of input, and it all depends on the particular variables available for the stream and crashes out if you request a variable that isn't associated with the particular stream it is accessing!

If you look at this example, the second block of code contains an example of using MTStreamActionVar. I've had to put the call to MTSAV in an MT:if to top it from breaking. In that example steam uses a var called "description" but googlereader has an "annotation" field and not a "description" field. So asking for "description" on a googlereader action will cause a template error.

As far as collecting all your streams by type, a modification of this example should do that, or maybe Mark Pasc's Order plugin could do it (not used it yet myself).

Many thanks, Richard. But just to be clear: I should, therefore, have a look at the feeds from each of these services and see exactly what they're putting out? Is that the way you know whether to use "annotation" or "description"? I did see that very example, and tried that code. What I couldn't follow was when to use annotation and when to use description.

I also can't figure out why the ASAmazon plugin, installed as instructed, won't pull a damn thing from my wishlist. I may have enemies, but not that many ... :-)

But honestly I can't believe that something so incredibly useful doesn't have easily accessible documentation.

The documentation looks like it's getting there, but isn't it more fun to play and break stuff anyway? :)

The only way to know is to look in the perl for what fields it's extracting for each action. /plugins/ActionStreams/config.yaml contains most services, look from line 429 onwards and it's the last bit of code for each section that tells you the fields and field names that are being pulled out. e.g. goodreads:

        xpath:
            foreach: //item
            get:
                title: title/child::text()
                url: link/child::text()
                created_on: pubDate/child::text()
                modified_on: pubDate/child::text()
                by: author_name/child::text()

That means you can reference "title", "url", "createdon", "modifiedon" and "by" using MtStreamActionVar. I think "title" and "url" are the only ones you are guranteed to get in every stream.

I would guess that the Amazon one isn't working as Amazon have updated their HTML, look at the plugin and look at the source of your wishlist page and see if you can find what the plugin is looking for.

I've made a list of all the fields the default action stream plugin pulls out, let me know if it's any help!

Action Stream field list

Oh boy! Brilliant stuff!