Browser Bookmarklets and Mobile Sharing with Post Kinds Plugin for WordPress

The Post Kinds Plugin

I’ve been using David Shanske’s excellent WordPress plugin Post Kinds, which is conveniently bundled into the IndieWeb Plugin, for more than a year now. (Update: I’ve also written a fairly in-depth primer for it.)

Much like WordPress’s native post formats (standard, aside, image, quote, link, status, audio, etc.) which were introduced in v3.1, Post Kinds instead provides a better mapping of post types across a larger variety of social media types (article, bookmark, favorite, itinerary, jam, like, listen, note, photo, play, read, reply, repost, watch, and more). In addition to changing the visual layout and formatting of most posts, the plugin also importantly includes the correct microformat classes for each of these post types and this enables a lot of other fantastically important functionality for the open web.

Custom URLs for Post Kinds

One of the problems I had with using it initially was taking the extra time to cut and paste in the several pieces of additional data or fill in meta data to make a post. It was particularly painful in a mobile setting. I was thrilled when David mentioned that he’d built in some customized query parameters which could take URLs to import in much of the data as well as to set the correct post kind automatically. They came with the general format of

http://example.com/wp-admin/post-new.php?kind=bookmark&kindurl=@url

where one could replace @url with the target URL of the site to be bookmarked, for example. Replacing bookmark with the appropriate post kind name would allow one to set the flag for each post to the proper post kind automatically, and naturally one should replace example.com with the base URL for their site.

Putting this customized URL into a browser will create a new post in one’s website admin UI and Post Kinds will automatically set the URL and scrape its meta data. One can then modify any additional data or add a comment and then publish quickly and easily.

As a concrete example, I would put the following URL in my browser of choice to “like” the Post Kinds Plugin page:
http://www.boffosocko.com/wp-admin/post-new.php?kind=like&kindurl=https://wordpress.org/plugins/indieweb-post-kinds/

Browser Bookmarklets

I am a huge fan of browser bookmarklets, so for a while I’ve been meaning to create some for the post kinds I use to better automate my post process. After dragging my feet for ages, particularly because my JavaScript skills are nearly non-existent, I’ve finally gotten around to adapting the common WordPress “Press This” bookmarklet to work with Post Kinds.

Below is the modified code that can be put into a bookmarklet to allow for easily bookmarking a particular post:

javascript:(function(a,b,c,d){function e(a,c){if("undefined"!=typeof c){var d=b.createElement("input");d.name=a,d.value=c,d.type="hidden",p.appendChild(d)}}var f,g,h,i,j,k,l,m,n,o=a.encodeURIComponent,p=b.createElement("form"),q=b.getElementsByTagName("head")[0],r="_press_this_app",s=!0;if(d){if(!c.match(/^https?:/))return void(top.location.href=d);if(d+="&kindurl="+o(c),c.match(/^https:/)&&d.match(/^http:/)&&(s=!1),a.getSelection?h=a.getSelection()+"":b.getSelection?h=b.getSelection()+"":b.selection&&(h=b.selection.createRange().text||""),d+="&buster="+(new Date).getTime(),s||(b.title&&(d+="&t="+o(b.title.substr(0,256))),h&&(d+="&s="+o(h.substr(0,512)))),f=a.outerWidth||b.documentElement.clientWidth||600,g=a.outerHeight||b.documentElement.clientHeight||700,f=800>f||f>5e3?600:.7*f,g=800>g||g>3e3?700:.9*g,!s)return void a.open(d,r,"location,resizable,scrollbars,width="+f+",height="+g);(c.match(/\/\/(www|m)\.youtube\.com\/watch/)||c.match(/\/\/vimeo\.com\/(.+\/)?([\d]+)$/)||c.match(/\/\/(www\.)?dailymotion\.com\/video\/.+$/)||c.match(/\/\/soundcloud\.com\/.+$/)||c.match(/\/\/twitter\.com\/[^\/]+\/status\/[\d]+$/)||c.match(/\/\/vine\.co\/v\/[^\/]+/))&&e("_embeds[]",c),i=q.getElementsByTagName("meta")||[];for(var t=0;t<i.length&&!(t>200);t++){var u=i[t],v=u.getAttribute("name"),w=u.getAttribute("property"),x=u.getAttribute("content");x&&(v?e("_meta["+v+"]",x):w&&e("_meta["+w+"]",x))}j=q.getElementsByTagName("link")||[];for(var y=0;y<j.length&&!(y>=50);y++){var z=j[y],A=z.getAttribute("rel");("canonical"===A||"icon"===A||"shortlink"===A)&&e("_links["+A+"]",z.getAttribute("href"))}b.body.getElementsByClassName&&(k=b.body.getElementsByClassName("hfeed")[0]),k=b.getElementById("content")||k||b.body,l=k.getElementsByTagName("img")||[];for(var B=0;B<l.length&&!(B>=100);B++)n=l[B],n.src.indexOf("avatar")>-1||n.className.indexOf("avatar")>-1||n.width&&n.width<256||n.height&&n.height<128||e("_images[]",n.src);m=b.body.getElementsByTagName("iframe")||[];for(var C=0;C<m.length&&!(C>=50);C++)e("_embeds[]",m[C].src);b.title&&e("t",b.title),h&&e("s",h),p.setAttribute("method","POST"),p.setAttribute("action",d),p.setAttribute("target",r),p.setAttribute("style","display: none;"),a.open("about:blank",r,"location,resizable,scrollbars,width="+f+",height="+g),b.body.appendChild(p),p.submit()}})(window,document,top.location.href,"http:\/\/example.com\/wp-admin\/post-new.php?kind=bookmark");
Browser bookmarklets for Post Kinds

Other versions of the bookmarks can easily be made for all the other other Post Kinds by replacing the two red highlighted portions of the code sample appropriately for each one. Specifically one should exchange bookmark with the name of the kind desired (all of them should be in lowercase) and replace example.com with one’s own domain name.

For simplicity, I’m including a sample/template bookmarklet button below which can be dragged and dropped into most browser bars. Before using it, edit the JavaScript as described above and paste it into the URL box. I’m happy to help those who may have problems. I’ve included a screen capture of what all of them look like once they’re set up and configured with matching emoji added into the titles to assist in visual selection.

🔖 Bookmark

Perhaps I (or someone else enterprising) would contribute all this back into the plugin repository for Post Kinds so that these bookmarklets would be self-generated for plug and play usage within the admin interface for the plugin the way the bookmarklets are for the IndieWeb plugin’s PressThis bookmarklets, perhaps at /wp-admin/admin.php?page=kind_options.

A Post Kinds “Bookmarklet” for Mobile

For those who would like something similar to the above for use on mobile platforms (and particularly Android) I’ve written up some instructions below which allow one to use the Android app URL Forwarder to use the ubiquitous mobile “share” functionality from most pages and/or apps in a way similar to this bookmarklet functionality. (This is based in part on some work by Ryan Barrett and some work I’d written up for the Known CMS a while back.)

I’d suspect that there’s also a similar app for iOS, but I haven’t checked. If not available, URL Forwarder is open source on Github and could potentially be ported. There’s also a similar Android app called Bookmarklet Free which could be used instead of URL Forwarder.

Configuring URL Forwarder for Post Kinds

  1. Open URL Forwarder on your phone
  2. Click the “+” button to create a filter.
  3. Give the filter a name, “Bookmark” for the bookmark version. (See photo below.)
  4. Use the following entry for the “Filter URL” replacing example.com with your site’s domain name: http://EXAMPLE.com/wp-admin/post-new.php?kind=bookmark&kindurl=@url
  5. Leave the “Replaceable text” as “@url”
  6. Finish by clicking on the checkmark in the top right corner.
  7. Repeat the above for the other desired post types but replacing “bookmark” with the lower case names of those other types.

Simple right?

Creating a post via mobile

With the configuration above set up, do the following:

  1. On the mobile page one wants to bookmark, like, favorite, etc., click the ubiquitous “share this” mobile icon (or share via a pull down menu, depending on your mobile browser or other app.)
  2. Choose to share through URL Forwarder
  3. Click on the “bookmark” option just created above (or other option as necessary for the desired post type).
  4. Change/modify any meta data within your website administrative interface or add any additional thoughts and publish. (This part is the same as one would experience using the desktop bookmarklet.)

Happy posting!

Published by

Chris Aldrich

I'm a biomedical and electrical engineer with interests in information theory, complexity, evolution, genetics, signal processing, IndieWeb, theoretical mathematics, and big history. I'm also a talent manager-producer-publisher in the entertainment industry with expertise in representation, distribution, finance, production, content delivery, and new media.

33 thoughts on “Browser Bookmarklets and Mobile Sharing with Post Kinds Plugin for WordPress”

  1. A reflection on using my own blog to reclaim my bookmarks and then syndicate them to other sites, such as Twitter and Diigo.

    My one word this year is intent. For me this means many things, one of which is to consider my digital presence. In a post reflecting on Mark Zuckerberg’s attempts to fix Facebook, Doc Searls says that one of the lessons learnt is that we all live digital lives now:

    So let’s at least try to look below what big companies, Trump and other dancing figures in the digital world are doing, and try to look at the floor they’re dancing on—and the ground under it. That ground is new and unlike anything that precedes it in human experience. Nothing matters more than at least trying to understand it.

    For me, a part of ‘understanding it’ is in reclaiming some of the processes that have been outsourced to third-party platforms. This does not always mean leaving silos completely, but rather not being dependent on them so that if the door shuts or the terms of use change, there is no concern in having to leave. See for example the recent announcement that Storify is shutting down. One recent attempt I have been tinkering with is an effort to reclaim my bookmarks.

    Capturing the Web with Radio3
    I have been using Diigo for quite a few years. My workflow has gone through a number of iterations, such as emailing links to batch processing favourited sites. This has largely been dependent on my mobile operating system. For example, I have found the Android Diigo app a lot easier to share to than iOS. (Things may have since changed though). My frustration though was that I was completing a number of steps separately.
    After exploring the features and affordances of Google+, I came upon Dave Winer’s Radio3 Linkblog, which allows you to push links out to various platforms, whilst also maintaining your own RSS. It involves selecting a site or quote and clicking on the bookmarklet to generate the short post. The creation of a separate feed provides the means to automate processes with IFTTT. This includes saving links to Diigo.
    The problem I have with this process is that although I have an archive of my tweets and links via Diigo, I am dependent on these platforms for maintaining an archive of my linkblog. I trialed using an IFTTT recipe to create a weekly digest as well as the built in option to Diigo, however I was not satisfied with any of these solutions. One problem I faced was the inconsistency of the RSS feed produced by Radio3.
    I have found that if I save a link with the bookmarklet without selecting any text, there would be no title included in the feed, even if I added or adjusted the description included in the textbox. Whereas, if I highlighted a chunk of text, the title is added. I guess the workaround would be to select the heading if there is nothing specific I wish to highlight? This seems a strange thing to complain about in regards to one of the forefathers to RSS and probably shows a lack of awareness on my behalf for how Radio3 works.
    Another frustration with using Radio3 to send links to Diigo is that I really like capturing quotes when I save links. This is something that I have done for a while and one of the reasons that I like Radio3. I could not figure out how to bring these into the description in Diigo consistently, let alone as annotations. I even took to annotating the quotes with the Diigo browser extension. I wonder if Zapier would do a better job, but until I fork out the money for a paid subscription I am not going to know.
    In the end, I could probably make Radio3 work for me. Probably deploying a script to collect everything, as Tom Woodward does with Pinboard, but I feel that I am almost doing that manually with the creation of my newsletter. I just feel apprehensive moving forward depending upon something held together by Dave Winer’s very good will. If it were open sourced, this may be different, but it is not.

    Collecting Bookmarks
    The next step then in my bookmarking journey has been to test out the idea of saving links on my own site and then syndicating them elsewhere. I have been exploring various post kinds lately, however yet to tinker with bookmarks.
    One of the inital challenges was how to syndicate. Like most, I had installed –Jetpack and used that to publicise to various social media sites. This is a relatively easy process where you activate the various connections by giving permissions. However, Jetpack is limited in what sites it supports. There is no option to connect with Diigo.
    I therefore installed the Social Network Austo-Poster (SNAP) plugin. Although I could generate a custom feed based on my bookmarks and use this with IFTTT, I would prefer to do something within my own site. One of the differences between SNAP and Jetpack is that rather than just give access you need to go through the process of generating API keys. This to me is closer to Searls’ call to understand our digital reality. Although this might seem daunting for some, the plugin provides thorough documentation to support users.
    What I like about SNAP is that you can set a default structure for auto-posts, combining a number of predefined ingredients, but you can also quickly customise these when needs be. So if you want to share with a specific user or hashtag on Twitter, but not on Diigo, then you can adjust the Twitter description.
    The last thing to consider with using my own site is developing a clear process for saving bookmarks. My first step was to create a bookmarklet using Chris Aldrich’s Post Kinds template. Also, I setup a process for sharing via Mobile using URL Forwarder app. This was a part of the puzzle missing with Radio3.

    What Next?
    I like the idea of collecting my bookmarks on my site. However, it has forced me to reflect on a number of things. One is the ability to properly syndicate to Diigo and Twitter. With Radio3, the publicised links connect to the corresponding site, whereas when I bookmark using my site, it shares the link to my post rather than the original site. This has me rethinking why I bookmark and POSSE. Maybe I do not need to share links to the original source, especially when my bookmarks have secondary information.
    Another interesting feature to using my blog has been the ability to link to other sources within my descriptions. This is something that I do with my newsletter. On the other hand, I wonder if every link needs this level of detail. An answer to this maybe to utilise some other response post kinds, such as Likes and/or Favourite to support my blog as a resource.
    This also leads me to wonder about the place of my Wikity blog. I really like the concept of constructing knowledge and ideas over time, however, I do not connect with other Wikity sites, one of the features Mike Caulfield built into the theme. I therefore wonder if these posts could be added as Notes or Articles, as I like having a title and in some themes the title of notes is chopped off.
    Maybe rather than using Likes or combining my Wikity posts I maintain these other spaces, such as Radio3 and use them for specific purposes. Or maybe I need to dive into Known again, even if it seems that people are leaving? I think for now I might continue bookmarking with my site and see where it all goes.

    So what about you? What process do you use to bookmark links for later? Has it changed over time? As always, comments welcome, especially if you have any tips or tricks that might help me on my way.


    Also posted on IndieNews

    If you enjoy what you read here, feel free to sign up for my monthly newsletter to catch up on all things learning, edtech and storytelling.Share this:EmailRedditTwitterPocketTumblrLinkedInLike this:Like Loading…

    Reclaiming My Bookmarks by Aaron Davis is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

    Syndicated copies:

  2. This is a collection of code that I often turn to when working with WordPress

    Every time that I feel comfortable with my level of knowledge associated with WordPress, there is a problem that leads me to discover a particular attribute that I don’t know how I lived without. This time it is the code seemingly obfuscated beyond the WYSIWIG editor and the dashboard.
    For some this code is about command line, while others it is about the bashing out the building blocks. My interest here is the everyday code, the little snippets that find there way in here or there while I work with WordPress, many of which have come from wandering through Chris Aldrich’s commonplace blog:
    Webmentions
    Webmentions are the building block for conversations across the web. However, with WordPress, they often get caught in moderation and/or flagged as spam by Akismet and other spam filter plugins. To prevent this, you can add this PHP snippet to your theme’s functions.php file:
    function unspam_webmentions($approved, $commentdata) { return $commentdata['comment_type'] == 'webmention' ? 1 : $approved; } add_filter('pre_comment_approved', 'unspam_webmentions', '99', 2);

    Alan Levine has documented the process of creating a child theme, which is useful when customising the code, while Gregor Morrill has developed code to approve webmentions from domains previously approved.
    Microformats
    Microformats is a data format built upon adopted standards and prior developments. There are a number of specifications, which can be manually added within the existing HTML. It provides the foundation for software to automatically process information. People like David Shanske and Matthias Pfefferle have developed plugins and themes to mark-up content in the backend. You can also use this site to check the microformats on your site, while for a more extensive introduction, listen to Tantek Çelik on the future of web apps.
    Two microformats I have worked with are comments and rel=me.
    Comment
    Although the appropriate microformats are usually built into the Webmentions plugin. The plugin for theaded comments can be a bit more tempremental. Chris Aldrich recommends manually adding the reply class and URL just to make sure:
    <a class="u-in-reply-to" href="http://www.example.com"></a>

    I have come to do this out of habit for replies now.
    Rel-me
    Another microformat incorperated into many Indieweb sites is Rel-me. It is used to consolidate identity, as well as domain sign in.
    <ul> <li><a href="https://twitter.com/aaronpk" rel="me">@aaronpk on Twitter</a></li> <li><a href="https://github.com/aaronpk" rel="me">Github</a></li> <li><a href="https://google.com/+aaronpk" rel="me">Google</a></li> <li><a href="mailto:me@example.com" rel="me">me@example.com</a></li></ul>

    Chris Aldrich has taken rel-me to its extremes by creating a page in which he records all his accounts. I have also started my own. For more on rel-me, watch Ryan Barrett’s keynote at IndieWeb Summit 2017.
    Page Bookmarks
    I remember coming across in plugin in Edublogs that allowed you to add a table of contents. This reminded me of the functionality in Google Docs and one of the things I noticed in both was the presence of a hashtag at the end of the URL. (Interestingly, now every heading in Google Docs has a unique identifier automatically created.) In Docs, this is something that can be added using the Bookmark feature, I wondered if the same could be done in WordPress. I discovered that within the tags, you insert ‘name=”unique-name”‘:
    <a name="unique-name">Target Text</a>

    This can then be used to guide readers to a specific point in your text.
    Custom URLs for Post Kinds
    Using the Post Kinds plugin provides a list a unique urls associated with the kinds of posts on the site. Chris Aldrich provides some guides in how to use these to create custom urls to generate a specific post screen. This can then be used to create a bookmarklet:
    http://example.com/wp-admin/post-new.php?kind=bookmark&kindurl=@url

    Dariusz Kuśnierek provides some other examples of custom URLs, which help in U deratamding the way urls work in general.
    RSS Feeds
    RSS provides a means of following a site without checking in all of the time. To access a feed to follow in WordPress, you simply add ‘/feed/’ to the end:
    http://www.example.com/feed

    As some feeds can contain a range of content, it is possible to hone down to particular categories by adding ‘?cat=[category id]’ to the end.
    http://www.example.com/feed?cat=[category id]

    This can be useful if you only want to follow a specific subject or area.
    Taking this a step further, you can also produce an RSS based on Post Kinds. Although not all blogs use these, for those that do it can be a useful demarcation. Similar to categories, you add ‘?kind=type’ to the end of the feed.
    http://www.example.com/feed/?kind=bookmark

    For more on RSS feeds, see this post from Chris Aldrich.
    OPML
    Where as RSS is used for a single feed, OPML allows a user to aggregate. I have written about them before. It is possible to store an OPML in WordPress. To access this you add the append ‘/wp-links-opml.php’ to the end.
    http://www.example.com/wp-links-opml.php

    In addition to this, Chris Aldrich has documented how to split a file into categories:
    ?link_cat=[category id]

    I have yet to categorise my links, however Aldrich provides an extensive example.

    So what about you? What little bits of code do you use? As always, comments welcome.

    If you enjoy what you read here, feel free to sign up for my monthly newsletter to catch up on all things learning, edtech and storytelling.Share this:EmailRedditTwitterPocketTumblrLinkedInLike this:Like Loading…

    Hidden in the Code by Aaron Davis is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

    Syndicated copies:

  3. After a relatively quiet quiet writing hour where I worked on acquisition posts a bit, people began arriving just before the 6:30 pm official start time.
    I kicked off the meeting with a quick overview of IndieWeb’s concepts and principles for newcomers. As a mini-case study I talked a bit about some of my work and conversations earlier today about thinking about adding acquisition posts to my website and the way in which I’m approaching the problem.
    Asher Silberman was glad to be back at a meeting. He has recently been working on more content over functionality.
    Micah Cambre showed off a gorgeous development version of the new theme he’s building for his site which is a super clean and pared down theme based on the Sage platform using WordPress. He’s hoping to finish it shortly so he can relaunch his personal site at http://asuh.com. He spent some time talking about the process of using David Shanske’s IndieWebified version of the Twenty Sixteen theme as a template for adding microformats and functionality to the Sage set up.
    Richard Hopp, a gen2/gen3 user who is completely new to the community and interested in learning, has a personal domain at http://www.ricahardhopp.com/ on which he’s installed WordPress. He’s currently considering whether he’d like to begin blogging soon and what other functionality he’d like to have on his site. He’s relatively new to Facebook, having only joined about six months ago. On the professional side, he does some governmental related work and has some large collections of documents that he’s also doing some research for in consideration of how to best put them on the web for ease of search and use.
    I wrapped up the demo portion with a quick showing of how I leveraged the power of the Post Kinds Plugin to facetiously add chicken posts to my site as a prelude to doing a tad more work to begin adding explicit follow posts.
    We took a short break to take a photo of the group.
    In the end of the evening we talked over a handful of broad ideas including user interface, webactions, and Twitter interactions.
    We wrapped things up with a demo of how I use the URL Forwarder app on Android to post to my website via mobile. We then used some of this documentation to try to help Asher fix his previously broken browser bookmarklets to hopefully work better with the Post Kinds Plugin. I spent a few minutes to create a similar bookmarklet to add the ability to more easily add follow posts to my website since I hadn’t done it after adding them last week.
    Syndicated copies to:




    Author: Chris Aldrich

    I'm a biomedical and electrical engineer with interests in information theory, complexity, evolution, genetics, signal processing, theoretical mathematics, and big history.

    I’m also a talent manager-producer-publisher in the entertainment industry with expertise in representation, distribution, finance, production, content delivery, and new media.
    View all posts by Chris Aldrich

    Syndicated copies:

  4. Eli Mellen makes some excellent points here. I’ve been slowly chipping away at going full Indieweb for about a year. Only this weekend did I really get all the way there, and it took a lot of advice from Chris Aldrich, some assistance from David Shanske in the IndieWeb chat, and the judicious use of Chrome developer tools (especially the web inspector) and Google to get to where I am today, which is pretty much where I want to be.
    I have WordPress and I installed all the appropriate plug-ins. I followed all of the directions in the Getting Started with WordPress parts of the Wiki. But these were the pieces that were missing that only recently did I get together:

    Sharing links in a POSSE way and having them actually look good
    Posting notes to Facebook and Twitter without weird link previews or my Gravatar popping up
    Sharing on mobile

    I wouldn’t ask your average social media user to do all the things I had to do to make this happen. As Eli says,

    …the IndieWeb is at an exciting inflection point.

    I’m immensely grateful for all the help I’ve received getting started, but I do hope that over time people won’t have to be as dev-headed as me to jump in. I am a far cry from any sort of developer, but I do have a lot more knowledge of how the web works than I think most people do. If it was tricky and took me a year to get it to do what I wanted, I can’t imagine what a challenge it will be for them.

  5. Replied to Browser Bookmarklets and Mobile Sharing with Post Kinds Plugin for WordPress by Chris Aldrich Chris Aldrich (Chris Aldrich | BoffoSocko) Making it easier to post to WordPress on desktop and mobile. …I’d suspect that there’s also a similar app for iOS, but I haven’t checked. If not available, URL Forwarder is open source on Github and could potentially be ported. There’s also a similar Android app called Bookmarklet Free which could be used instead of URL Forwarder.
    One possible way of doing this on iOS is to use the Workflow app.
    You can find the workflow here.
    https://www.supine-owl.com/wp-content/uploads/2018/05/img_3947.jpg

  6. Replied to Browser Bookmarklets and Mobile Sharing with Post Kinds Plugin for WordPress by Chris Aldrich Chris Aldrich (Chris Aldrich | BoffoSocko) Making it easier to post to WordPress on desktop and mobile. …I’d suspect that there’s also a similar app for iOS, but I haven’t checked. If not available, URL Forwarder is open source on Github and could potentially be ported. There’s also a similar Android app called Bookmarklet Free which could be used instead of URL Forwarder.
    One possible way of doing this on iOS is to use the Workflow app.
    You can find the workflow here.
    https://www.serenawho.com/wp-content/uploads/2018/05/img_3947.jpg

  7. I cant get this to work 🙁 the editor opens empty, the correct post kind was selected. Anything that might have changed since you posted this?

  8. I’m making a few notes to myself here to document my process for keeping a public research notebook. They might be of interest to you, too.
    First, I’m talking here mostly about keeping up with the literature. There are (in my opinion obvious) ethical implications of actually sharing your data on your website. I’ll explore them as I write my proposal, but right now, all I’ve got is other people’s research that I’m reading and writing about, and then I’ll probably have some memos on my own process of preparing for comps and selecting my dissertation topic. Nothing wild.
    So, what am I doing? Well, inspired by some writing by Kris Shaffer and Chris Aldrich, and by the fact that I gave a keynote last weekend on Connected Learning and the IndieWeb, I want to share my reading notes on some of the readings I’m doing for comps. It will help me keep track of my most important notes, and maybe it’ll be useful for other people researching similar topics. I tend to pick fairly under-researched areas, and I know it can be frustrating to have to dig up the literature on those, so this is one way I can maybe make it easier for colleagues.
    Raul Pacheco-Vega is another inspiration, as he both shares reading notes and has heavily influenced my literature review workflow.
    What’s the workflow?

    I find the source, as described through one of the various techniques in my literature review workflow, and pull it into Paperpile. If Paperpile can’t find a PDF on its own, then I track a PDF down or, if it’s only available physically, track down a physical copy.
    If it’s a PDF, I read it on my Android tablet with Xodo, making highlights and annotations using my Musemee Notier stylus. If it’s a physical text, I take notes on a dedicated COMPS spread in my Bullet Journal (I use a Moleskine large dotted black notebook and a Pilot G2 07).
    I create a new Google Doc.
    From Paperpile, I copy the citation and paste it into the Google Doc. I name the Google Doc Author Year Article Title. (These are all in a folder called “Synthetic Notes,” nested in a folder named after the literature area.)
    I type up a quick synthetic note based on my highlights and annotations.
    I use Paperpile to find a link to the source of the original.
    Then, I use a bookmarklet with the WordPress Post Kinds plugin to create a new bookmark on my website. (I use the bookmark post kind instead of a read, because I’m only doing an Abstract-Introduction-Conclusion extraction, not a full read of the piece.)
    I paste the abstract into the Summary box in the Response Properties box.
    I paste the contents of my Google Doc into the WordPress editor and use the “Clear formatting” button to clean up messy GDocs code.
    I give the post a tag related to the literature area (e.g., connected-learning) and select the category “Research Notebook,” then publish!

    You may have noticed that this workflow leaves out Hypothes.is entirely. This is for a few reasons, but mostly just that right now, Hypothes.is would add several extra steps as I read on my tablet rather than on my laptop. I’d have to open up the PDF on my laptop, re-highlight and annotate using Hypothes.is tools, then use the Hypothes.is aggregator plugin to bring over those to my website. So for now, I’m doing it all manually on my site and not sharing anything there.

  9. In deze serie blogposts wil ik je helpen hoe je met een WordPress site gebruik kunt maken van de diverse IndieWeb plugins. Zoals het kunnen inloggen op andere sites met je eigen domeinnaam en nieuwe artikelen plaatsen met andere applicaties.

    Aan de hand van dit artikel laat ik je zien hoe je verschillende soorten posts kunt maken in WordPress. Van bookmarks tot notities, gelezen boeken of locatie checkins. Welkom in de wereld van de Post Kinds.

    Wat is Post Kind?

    De Post Kind plugin is een WordPress plugin die het mogelijk maakt om allerhande nieuwe social media-achtige posts te maken op je eigen site. Zo zie je op mijn site zo nu en dan bookmark-posts voorbij komen of kortere notities.

    WordPress komt standaard met een aantal Post Formats, zoals artikel, status, aside, gallery, link, image etcetera. Hier zijn ze mee gestart toen met name Tumblr met een blogplatform kwam waar deze post types goed werden ondersteund.

    Veel WordPress theme ontwikkelaars zijn de Post Formats gaan ondersteunen. Dit betekent in de praktijk dat in het thema door middel van opmaak en weergave de post een bepaalde stijl krijgt. Zo krijgt een Status post geen titel en is het een korte update.

    Waarom is dat belangrijk?

    Er is geen onherroepelijk bewijs voor, maar het lijkt dat de Post Formats steeds minder worden ondersteund en gebruikt in WordPress themes. De Post Kind plugins pakt de handschoen op van de Post Formats en moderniseert de manier waarop de verschillende soorten posts worden weergegeven én biedt een platform om nieuwe post formaten zelf toe te voegen.

    Hoe installeer je de Post Kind plugin?

    De installatie van de Post Kind plugin is relatief eenvoudig. Als je de Indieweb plugin hebt geïnstalleerd kun je hem vinden via Indieweb > Extensions in je beheer. Of je gaat via de officiële WordPress Plugin repository en zoekt op Post Kind.

    Let op, de Post Kinds plugin werkt niet met de nieuwe Gutenberg editor van WordPress.

    Wat stel je vervolgens in?

    De configuratie vind je onder Indieweb > Post Kinds tab in je beheer. Hier zie je direct een groot aantal mogelijkheden om posts te maken. Je kunt zelf instellen welke soort posts je wilt maken op je site. Een aantal zijn al vooraf geselecteerd voor je. Ik kan je adviseren om niet direct alles aan te zetten, omdat het je administratie-scherm erg vol maakt. Zet die Post Kinds aan die je zeker gaat gebruiken. Als je later besluit om bepaalde Post Kinds niet meer te gebruiken, kun je ze altijd weer uitzetten, of juist andere types toevoegen.

    Een andere optie die je kiest is de Default Kind for new posts. Het ligt er aan hoe je je site wilt gebruiken. Is het een standaardblog? Zet hem dan op Article. Wil je een linkblog maken? Gebruik Bookmark.

    Beschikbare Post Kinds

    Na installatie vind je in de configuratie de soorten Post Kinds die je direct kunt gebruiken en een bepaalde vormgeving hebben voor je thema. Dit zijn de volgende Kinds:

    Niet-interactieve Kinds

    Article – De traditionele blogpost met titel.
    Note – Een statusupdate, een tweet-achtige notitie.
    Photo – Een post met een afbeelding als focus. Dit kan de featured image zijn van je post of een van de andere toegevoegde afbeeldingen. Dit is afhankelijk van je theme.
    Video – Een post met een embedded video als focus.
    Audio – Een post met een embedded audiobestand als focus.

    Interactie Kinds

    Deze lijst met Post Kinds zijn bedoeld om interactie met andere sites mogelijk te maken. Denk aan een reactie op een bepaalde post, een bookmark of een like. Voor een betere weergave en meer mogelijkheden is het aan te raden om de Post Kinds plugin te gebruiken samen met de Webmentions en Semantic Linkbacks plugin. Deze zal ik in een vervolgartikel bespreken. Hiermee is het mogelijk om de eigenaar van het artikel waar je op reageert automatisch een notificatie te sturen en om je eigen site veel meer je eigen hub te maken van je antwoorden en interacties.

    Reply – Een antwoord publiceren op een post van iemand anders
    Repost – Een volledige repost van iemand anders content
    Like – Complimenten aan de originele auteur van een artikel
    Favorite – Bepaalde content die speciaal voor je is
    Bookmark – Een link of bookmark opslaan.
    Quote – Een quote publiceren
    RSVP – Via je eigen site laten weten of je bij een bepaald evenement aanwezig bent.

    Passieve Kinds

    De passieve Kinds zijn vooral om duidelijk te maken dat je iets hebt gedaan. Je kunt het vergelijken met het “scrobblen” op Last FM, dat automatisch voor je bijhoudt waar je naar luistert. In de plugin kunnen dit zijn:

    Listen – Luisteren naar en audio post
    Jam – Luisteren naar een muziekstuk wat speciaal voor je is.
    Watch – Een video bekijken
    Play – Een spel spelen
    Read – Iets lezen.
    Eat – Wat ben je aan het eten
    Drink – Wat drink je
    Checkin – Laten weten dat je op een specifieke locatie bent.

    Je merkt in bovenstaande lijsten al dat de keuze voor de Post Kinds en de uitleg van de plugin ontwikkelaar best arbitrair is. Wanneer is iets een Like en wanneer een Favorite? Maakt het iets uit voor je? Kies hier vooral wat je zelf wilt en laat je niet teveel leiden door de omschrijvingen.

    Hoe gebruik je de plugin?

    Ik begin met een simpel voorbeeld, het posten van een bookmark. Ik wil op mijn testsite meer bookmarks plaatsen rondom het Indieweb en ik begin met een bookmark van het artikel Een eigen huis op het IndieWeb op deze site. Ik klik in het WordPress beheer op Posts > Add New en in het vervolgscherm kies ik in de metabox voor Bookmark. Let op, voor je begint, klik nog op Screen Options en zet de het veld Response Properties aan. Deze zou standaard aan moeten staan, maar je weet maar nooit.

    Je ziet bij je standaard editor een extra box waar je een URL kunt invoeren. Ik zet hier de URL van de bookmark. Op de achtergrond gaat de plugin informatie ophalen van de URL en laat deze zien als je op Details klikt. Het is afhankelijk van de site die je wilt bookmarken welke informatie je krijgt. Mis je iets, zoals een auteur of een ondertitel, dan kun je dit handmatig toevoegen.

    Als je de contextuele informatie van je bookmark hebt toegevoegd, kun je nog eigen tekst toevoegen alsof het een normale blogpost betreft. Geef eventueel extra metadata zoals categorie, tags en datum en klik op publiceren.

    Zoals je ziet voegt Post Kinds standaard extra informatie toe aan je blogpost. De contextuele informatie die we in het beheer hebben geplaatst, wordt boven je eigen post geplaatst. In de configuratie van de plugin kun je deze ook onder je eigen post plaatsen, het is maar net wat je voorkeur heeft.

    Probeer de verschillende Post Kinds eens, voeg likes en favorites toe of een reply op een blogpost. Hou er wel rekening mee dat jouw antwoord op een blogpost nog niet automatisch zichtbaar is bij de originele site. Hier is de Webmention plugin voor nodig, die we in een volgend artikel in detail bespreken.

    Post Kind en Micropub

    Veel diensten als Pocket en Instapaper hebben eenvoudige one-click manieren om snel een bookmark toe te voegen aan hun dienst. Dat is logisch, je wilt zo min mogelijk frictie om iets te publiceren en mogelijk te delen. Bovenstaande stappen om een bookmark of een like via de WordPress admin te publiceren zijn er te veel. Als je steeds naar de editor moet, dat gaat te snel vervelen en doe je dat niet meer. Dus is het zaak om het jezelf zo makkelijk mogelijk te maken.

    Gelukkig is daar de Micropub plugin die we al eerder hebben geïnstalleerd. In combinatie met de Post Kind plugin kun je behoorlijk snel posts maken én ze in de juiste vorm tonen op je site. Zoals je nog weet is de Quill app een handige dienst om iets te posten op je site via Micropub. De bookmark-functie heeft een zogenaamde bookmarklet. Een klein stukje code die je als knop in je browser-balk kunt plaatsen. Hetzelfde geldt voor de Favorite-functie. Samen met de Post Kinds plugin worden bookmarks en favorites direct in de juiste vorm weergegeven, een mooie combinatie dus! Als je liever direct in de WordPress omgeving schrijft met een bookmarklet, dan kan ik je deze uitleg van Chris Aldrich aanbevelen. Tevens als je op zoek bent naar mobiele oplossingen.

    Hoe nu verder?

    Met deze post heb ik vooral de basics van de Post Kind plugin willen uitleggen. Er is veel mogelijk met deze plugin, zelfs je eigen Post Kind type maken. Je kunt de vormgeving van de individuele Post Kinds aanpassen door middel van eigen templates, maar dat vereist wel wat programmeerwerk.

    De Post Kinds plugin hangt heel nauw samen met de Micropub plugin en de Webmentions plugin, vooral om echt goed gebruik te maken van de interactieve kinds die ik hier boven beschrijf. Ik kan je dan ook aanraden om naast Post Kinds de Webmention plugin te installeren en verder te gaan met je Indieweb avontuur!

    Credits

    Veel dank aan Chris Aldrich en zijn Engelstalige uitleg van deze plugin en de vele updates en aanvullingen op zijn blog!

  10. I have been interested in using bookmarklets to post to my WordPress site. This Chris Aldrich article interested me enough that I was willing to do something about it. First, I had to figure out what was the correct “Press This” plugin from WordPress (it is here) and install that. Next, I decided to also install the Indieweb Press This plugin (found here). After installing both of those, I went to the Tools menu from my WordPress dashboard, then selected the Available Tools menu. I then saw entries for PressThis and IndieWeb Press This.

    I then dragged the Press This bookmarklet into my browser bookmarks bar and was able to create this post.
    Next, I used the bookmarklet from the Chris Aldrich article above. I edited the example bookmarklet code to replace example.com with my website name, then dragged his sample  bookmarklet to the browser bookmarks bar, then edited the bookmark and pasted my modified code, then was able to create this post.
    Next steps – try to get this working on mobile!

  11. Today I tried to set up the Post Kinds bookmarklet from Chris Aldrich’s great overview post on this topic. I decided to use the Brave web browser on my laptop, and it worked just fine, I then tried to set up Sync on the laptop with Brave on my phone. The steps on the instructions appeared to work, but syncing only seemed to work from mobile to laptop. I found a long support post about problems with Brave Sync, so decided to try something else (I may still try to create the bookmarklet on my phone at some point).
    In the Chris Aldrich post, he referred to a helper app called URL Forwarder (for Android). I installed that and followed the setup from Chris’s post for creating a bookmark post with PostKinds, and that worked! I was able to share a URL with the app, which then brought up a new tab to post that bookmark on my WordPress site. Nice! Now I can clear all those open tabs on my mobile browser and not lose the links…
     

  12. Some of my favorite and often used edtech tools:
    Hypothesis – a service that allows me to quickly highlight and annotate content on almost any web page or .pdf file
    IFTTT.com – a service which I use in combination with other services, most often to get data from those sites back to my own. For example:

    Recipe to get Hypothesis annotations from Hypothesis to my site
    Recipe to syndicate Goodreads posts of books I’m reading to my website

    Huffduffer.com – a service I with audio related content I find online. I use its bookmarklet to save audio from web pages. Huffduffer then creates a custom RSS feed that I can subscribe to in any podcatcher for catching up on podcasts while I’m on the go.
    Post Kinds Plugin for WordPress – since many in the class are also using it, I’ll mention that I love using its bookmarklet functionality to quickly bookmark, favorite, or reply to other posts on the web.
    URL Forwarder – This is an Android-based app that I’ve configured to dovetail with the Post Kinds Plugin and my website for posting to my site more quickly via mobile.
    Jon Udell’s media clipper – I use this audio/video tool for finding and tagging the start and stop points of media so that I can highlight specific portions for others

  13. Don’t know if you’re experiencing the same thing, but recently, the bookmarklets have stopped working. I click on it, a pop-up window would show up (as expected), but it would ask me to log in and then won’t proceed further.

  14. The original Press This spun itself off as a stand-alone plugin, so look there first to recreate its functionality. If that doesn’t suit, try David Shanske’s Post Kinds plugin which incorporates a lot of Press This functionality and extends it quite a bit. You can create bookmarklets with it that work well (including mobile).
    Another option is Tom Critchlow and Toby Shorin’s Quotebacks which you might leverage though they won’t necessarily create new posts on your behalf.
    If you’ve got some programming experience, you might be able to do something interesting with a set of bookmarklets I just made too.
    I think I’ve also shared most of my documented workflow for using Hypothes.is for some of this too, though that may require some work on your behalf.
    Another good option is to add Micropub functionality and use some clients like Quill, Omnibear, or others in conjunction with the Post Kinds plugin. I think Quill may also have some useful bookmarklets you can use with it as well.

Bookmarks

Mentions

Likes

Reposts

Leave a Reply

Your email address will not be published. Required fields are marked *

To respond to a post on this site using your own website, create your post making sure to include the (target) URL/permalink for my post in your response. Then enter the URL/permalink of your response in the (source) box and click the 'Ping me' button. Your response will appear (possibly after moderation) on my page. Want to update or remove your response? Update or delete your post and re-enter your post's URL again. (Learn More)