I’ve been doing this for several years now and it gives me a lot more control over how much meta data I can add, change, or modify as I see fit. Let me know if I can help you do something similar.
Tag: bookmark posts
Any other ideas #IndieWeb (aka #ActiveWeb)?
👓 12 days of microblogging: linkblogging | Manton Reece
For the 7th post in our 12 days of microblogging series, I want to talk about linkblogging. Micro.blog users have a variety of approaches to posting links on their blog. Some people read an interesting article and type in a summary of it, pasting in the URL to the full article, and some people prefe...
👓 Words I wrote in 2018 | Adactio: Journal
I wrote just shy of a hundred blog posts in 2018. That’s an increase from 2017. I’m happy about that. Here are some posts that turned out okay…
👓 Chris Aldrich’s Year In Pocket
See how much I read in Pocket this year!
The most popular things I apparently saved this year:
-
-
The 100 best nonfiction books of all time: the full list by Robert McCrum • theguardian.com
-
Is Your Child Lying to You? That’s Good by Alex Stone • nytimes.com
-
How Actual Smart People Talk About Themselves by JAMES FALLOWS • theatlantic.com
-
The Fall of Travis Kalanick Was a Lot Weirder and Darker Than You Thought by Eric Newcomer, Brad Stone • bloomberg.com
-
The female price of male pleasure by Lili Loofbourow • theweek.com
-
I’ll have to work at getting better to create my own end-of-year statistics since my own website has a better accounting of what I’ve actually read (it isn’t all public) and bookmarked. I do like that their service does some aggregate comparison of my data versus all the other user data (anonymized from my perspective).
Pocket also does a relatively good job of doing discovery of good things to read based on aggregate user data in terms of categories like “Best of” and “Popular”. They also give me weekly email updates of things I’ve bookmarked there as reminders to go back and read them, which I find a useful functionality which they haven’t over-gamified. Presently my own closest functionality to this is to be subscribed to the RSS feed of my own public bookmarks in a feed reader (which I find generally useful) as well as regularly checking on my private bookmarks on my websites’s back end (something as easy as clicking on a browser bookmark) and even looking at my “on this day” functionality to review over things from years past.
I’ll note that I currently rely more on Nuzzle for real-time discovery on a daily basis however.
Greg McVerry might appreciate that they’re gamifying reading by presenting me with a badge.
As an aside while I’m thinking of it, it might be a cool thing if the IndieWeb wiki received webmentions, so that self-documentation I do on my own website automatically appeared on the appropriate linked pages either in a webmention section or perhaps the “See Also” section. If wikis did this generally, it would be a cool means of potentially building communities and fuelling discovery on the broader web. Imagine if adding to a wiki via Webmention were as easy as syndicating content to a site like IndieNews or IndieWeb.XYZ? It could also function as a useful method of archiving web content from original pages to places like the Internet Archive in a simple way, much like how I currently auto-archive my individual pages automatically on the day they’re published.
👓 The web finally feels new again. | i.webthings
The web was amazing before Web 2.0 and the advent of so-called social networks. Many people had their own sites and blogs from which they shared ideas and interacted with others in the community at large. It seemed to me like meeting others in their own homes back then and there was a widespread enthusiasm for blogging and personal expression. Then came the big social networks. With time, many personal sites and blogs disappeared from the web as people flocked to the big silos where their content became a heavily monitized commodity. To me, the web had lost much of its soul as people gathered in just a few, huge noise chambers.
👓 The Web Finally Feels New Again | KicksCondor
(Joe’s full article is here.)
Yes, here we are again—I think what you’re saying is that even a single-line annotation of a link, even just a few words of human curation do wonders when you’re out discovering the world. (Perhaps even more than book recommendations—where we know that at leas...
Highlights, Quotes, Annotations, & Marginalia
it made me feel like we were trying to send some kind of concentrated transmission to the author—linking as a greeting, links as an invitation. ❧
December 19, 2018 at 04:14PM
I do find that Webmentions are really enhancing linking—by offering a type of bidirectional hyperlink. I think if they could see widespread use, we’d see a Renaissance of blogging on the Web. ❧
December 19, 2018 at 04:17PM
I’m really not sure if linking, in general, has changed over the years. I’ve been doing it the same since day one. But that’s just me. ❧
December 19, 2018 at 04:22PM
👓 Save web pages straight to Inoreader | Inoreader blog
Hopefully, by now you’ve recognized Inoreader as your go-to place for regular content consumption. But we know there are many more ways to come across great new content – and we want to help you with that, too. Now you can save pages from all over the web with our new feature, Saved web pages …
👓 The Fans Are All Right | Pinboard Blog
I've had a couple of emails and tweets asking somewhat cautiously why the popular page has filled with slash fiction. That's because the fans are coming!
I learned a lot about fandom couple of years ago in conversations with my friend Britta, who was working at the time as community manager for Delicious. She taught me that fans were among the heaviest users of the bookmarking site, and had constructed an edifice of incredibly elaborate tagging conventions, plugins, and scripts to organize their output along a bewildering number of dimensions. If you wanted to read a 3000 word fic where Picard forces Gandalf into sexual bondage, and it seems unconsensual but secretly both want it, and it's R-explicit but not NC-17 explicit, all you had to do was search along the appropriate combination of tags (and if you couldn't find it, someone would probably write it for you). By 2008 a whole suite of theoretical ideas about folksonomy, crowdsourcing, faceted infomation retrieval, collaborative editing and emergent ontology had been implemented by a bunch of friendly people so that they could read about Kirk drilling Spock.
🔖 Hypothesis User: kael
Joined: September 9, 2018
Location: Paris
Link: del.icio.us/kael
I’m curious if the Hypothes.is team has considered making such additional functionalities more explicit within their user interface?
Social bookmarking does seem like a useful and worthwhile functionality that would dovetail well with many of their other functionalities as well as their basic audience of users. Perhaps some small visual UI clues and the ability to search for them as a subset would complete the cycle?
🎙 The IndieWeb and Academic Research and Publishing
Running time: 0h 12m 59s | Download (13.9 MB) | Subscribe by RSS | Huffduff
Overview Workflow
Posting
Researcher posts research work to their own website (as bookmarks, reads, likes, favorites, annotations, etc.), they can post their data for others to review, they can post their ultimate publication to their own website.
Discovery/Subscription methods
The researcher’s post can webmention an aggregating website similar to the way they would pre-print their research on a server like arXiv.org. The aggregating website can then parse the original and display the title, author(s), publication date, revision date(s), abstract, and even the full paper itself. This aggregator can act as a subscription hub (with WebSub technology) to which other researchers can use to find, discover, and read the original research.
Peer-review
Readers of the original research can then write about, highlight, annotate, and even reply to it on their own websites to effectuate peer-review which then gets sent to the original by way of Webmention technology as well. The work of the peer-reviewers stands in the public as potential work which could be used for possible evaluation for promotion and tenure.
Feedback mechanisms
Readers of original research can post metadata relating to it on their own website including bookmarks, reads, likes, replies, annotations, etc. and send webmentions not only to the original but to the aggregation sites which could aggregate these responses which could also be given point values based on interaction/engagement levels (i.e. bookmarking something as “want to read” is 1 point where as indicating one has read something is 2 points, or that one has replied to something is 4 points and other publications which officially cite it provide 5 points. Such a scoring system could be used to provide a better citation measure of the overall value of of a research article in a networked world. In general, Webmention could be used to provide a two way audit-able trail for citations in general and the citation trail can be used in combination with something like the Vouch protocol to prevent gaming the system with spam.
Archiving
Government institutions (like Library of Congress), universities, academic institutions, libraries, and non-profits (like the Internet Archive) can also create and maintain an archival copy of digital and/or printed copies of research for future generations. This would be necessary to guard against the death of researchers and their sites disappearing from the internet so as to provide better longevity.
Show notes
Resources mentioned in the microcast
IndieWeb for Education
IndieWeb for Journalism
Academic samizdat
arXiv.org (an example pre-print server)
Webmention
A Domain of One’s Own
Article on A List Apart: Webmentions: Enabling Better Communication on the Internet
Synidicating to Discovery sites
Examples of similar currently operating sites:
IndieNews (sorts posts by language)
IndieWeb.xyz (sorts posts by category or tag)
👓 Three examples of annotations, bookmarking, & sharing in my digital commonplace book | W. Ian O’Byrne
I’ve been experimenting with some IndieWeb philosophies and tools on this site, but more importantly on my breadcrumbs website. My breadcrumbs website is my digital commonplace book. This is inspired by the website philosophy & structure developed by Chris Aldrich. My purpose is to switch up my relationship with others and social media networks while doing more to own my content online. To that end, one major purpose (for now) on my breadcrumbs site is to be more intentional in the materials that I share with others as I read and explore online.
👓 Design of my website | Cathie LeBlanc
I discovered the IndieWeb about six weeks ago and wrote then about why I think it’s an important movement and community. Since that time, I’ve made a concerted effort to update my web site so that it looks like I want it to look. Although I’m not yet done, I’ve made good progress. I recently...
One of the things I do a lot on Twitter, for example, is retweet stories that I find interesting in order to come back to them later.
interesting retweeting as a bookmarking behavior
Manually adding a new post kind to the Post Kinds Plugin for WordPress
I’ve documented and written about it quite a bit in the past and am obviously a big fan. In addition to most of the default post types (notes, favorites, likes, bookmarks, reads, listens, etc.), my personal site also supports follows, eat, drink, wishes, acquisitions, exercise, and chickens! Wait a second… CHICKENS?!?
Yes, that’s chickens, not checkins, which I also support.
One of the nice benefits of the plugin is that it’s fantastically modular and extensible. As an exercise a few months back I thought I would take a shot at adding chicken post support to my website. Several years ago in the IndieWeb, partly as an educational exercise and partly for fun, several people thought it would be nice to add a post type of “chicken” to their sites. What would it look like? What would it entail? How might it evolve? Since then interest in chicken related posts has naturally waned, but it does bring up some interesting ideas about potential new pieces of functionality that one might want to have on their personal websites.
While I currently support many post types, I’ve discovered recently that I have a variety of notes and checkins that relate to items I’ve purchased or acquired. I thought it might be worthwhile to better keep track on my own website of things I acquired in a more explicit way to make posting them and searching for them a lot easier. But how could I do this myself and potentially contribute it back to a broader base of other users? I started with a bit of research on how others have done this in the past and tried to document a lot of it on the Indieweb wiki. I eventually asked David Shanske to reserve the idea of acquisitions within the Post Kinds plugin, which he did, but I wondered how I might have done some of that work myself.
So below, as an example, I thought I’d write up how I’ve managed to add Chicken posts to my website. To a great extent, I’m using data fields and pieces already built into the main plugin, but in doing this and experimenting around a bit I thought I could continue to refine chicken posts until they did what I wanted, after which, I could do a pull request to the main plugin and add support for others who might want it. Hopefully the code below will give people a better idea about how the internals of the plugin work so that if they want to add their own pieces to their sites or contribute back to the plugin, things might be a tad easier.
Pieces for a new Post Kind in WordPress
Adding a new Post Kind primarily consists of three broad pieces which I’ll address below. The modularity of the plugin makes adding most of the internals for a new kind far simpler than one might imagine.
Adding Taxonomy Support
New kinds in general will require a small handful of properties which include:
- a name (as well as its singular, plural, and verb forms);
- a microformats 2 property;
- a format, so that the plugin can map the new post kind to a particular Post Format type within WordPress core so that themes which use these can be properly set when needed. Format options include: aside, image, video, quote, link, gallery, status, audio, and chat. Some post kinds may not have an obvious mapping, in which case the value can be left as empty;
- a generic description for display within the admin user interface as well as for the archive pages for the type which are auto-generated;
- a description-url, typically this is a link to the IndieWeb wiki that has examples and details for the particular post kind. If there isn’t one, you could easily create it and self-document your new use case. It could even be empty if necessary;
- A show setting with a value of true or false to tell the plugin to default to showing the kind in the Post Kinds “Kinds” metabox so that the new kind will show up and be choose-able from within the interface when creating new posts.
Code to include these pieces of data will need to be added to the /includes/class-kind-taxonomy.php folder/file path within the plugin so that the plugin knows where it needs to be found.
As an example, here’s what the code looks like for the bookmark kind:
'bookmark' => array( 'singular_name' => __( 'Bookmark', 'indieweb-post-kinds' ), // Name for one instance of the kind 'name' => __( 'Bookmarks', 'indieweb-post-kinds' ), // General name for the kind plural 'verb' => __( 'Bookmarked', 'indieweb-post-kinds' ), // The string for the verb or action (liked this) 'property' => 'bookmark-of', // microformats 2 property 'format' => 'link', // Post Format that maps to this 'description' => __( 'storing a link/bookmark for personal use or sharing with others', 'indieweb-post-kinds' ), 'description-url' => 'http://indieweb.org/bookmark', 'show' => true, // Show in Settings ),
For direct comparison, and as an explicit example for my chicken post kind, here’s the block of code I inserted within the class-kind-taxonomy.php
file immediately below the section for the acquisition type:
'chicken' => array( 'singular_name' => __( 'Chicken', 'indieweb-post-kinds' ), // Name for one instance of the kind 'name' => __( 'Chickens', 'indieweb-post-kinds' ), // General name for the kind plural 'verb' => __( 'Chickened', 'indieweb-post-kinds' ), // The string for the verb or action (liked this) 'property' => 'chicken-of', // microformats 2 property 'format' => 'image', // Post Format that maps to this 'description' => __( 'Owning all the chickens. Welcome to my chicken feed.', 'indieweb-post-kinds' ), 'description-url' => 'https://indieweb.org/chicken', 'show' => true, // Show in Settings ),
You’ll probably notice that beyond the simple cut and paste, I haven’t really changed much. Syntax aside, most of these pieces are relatively obvious and very straightforward, but I’ll add some commentary about a few parts and what they do which may not be as obvious to the beginner. When creating your own you can copy and paste this same block into the code at the bottom of the list of other types, but you’ll want to change only the data that appears within the single quotes on each of the nine lines for the various settings.
For those not familiar with microformats you may be asking yourself what snippet to add for the property
setting. The best bet is to take a look at the microformats wiki or look for possible examples of people doing the same type of post you’re doing and copy their recommended microformat. For extremely new and likely experimental edge cases, chances are that you’ll need to choose your own experimental microformat name. In these instances you can use prior microformats as examples and potentially follow the format. In my case I knew about the bookmark-of
, like-of
, favorite-of
, and the experimental read-of
, listen-of
, and watch-of
microformats, so I followed the pattern and chose chicken-of
for my experimental chicken posts. One could also potentially ask for recommendations within either the microformats IRC/chat channel or the IndieWeb chat. If you create a new and experimental one, take a few moments to document your use case in the IndieWeb and/or Microformats wikis for others who come after you. Keep in mind that if you change the property name at a later date you will need to go into your database and change the wp_postmeta
database meta_key
field from mf2_property1
to mft_property2
so that WordPress will know where the appropriate data is stored to be able to display it.
The show
setting is fairly straightforward, but may not be as obvious to some. It has either a value of true or false. If the value is false
, the new post kind won’t be displayed in the radio button options within the admin UI for creating new posts. If the value is true
, then it will be available. The Post Kinds plugin has a number of reserved post kinds which aren’t displayed by default on most sites–primarily because they do not have appropriate views or data fields defined–but they could be enabled by changing the show
flag from false to true. Most often we recommend you only show those kinds that you’re actively using.
Additional examples of the dozen or more standard post kinds can be found within the code to provide some additional potential clarity on what types of data each of them are expecting.
I debated a while on making the verb ‘chickened out’ instead of ‘chickened,’ but I chickened out thinking that it would make my posts something wholly different. Obviously you can now make your own choice.
With this chunk of code saved into the plugin, it is now generally aware of the new post kind and can save the appropriate data for this new kind of post.
Template/View Support
Now you’ll want to add some code to the plugin to tell the plugin how it should display the data it’s saving for your posts. The easiest way to do this is to copy and paste the code from one of the many default views already in the plugin and just change a few small pieces of data to match your post kind. This code can be created as a new file with your new matching post kind name (the one at the top of your code snippet above that appears on line 1 before the word ‘array’) in one of two places. If you put it in the views folder in the plugin, you may need to re-add it later on if the plugin updates. Otherwise you can add the code into a file which can be placed into a folder named kind_views
in either the folder for your theme (or your child theme, if you have one.) We recommend placing it in your child theme, so if the parent theme updates, your code won’t accidentally be lost.
There are a variety of views for many post kinds available to stand as examples, so you can look at any of these and tweak them as you wish to get the output you desire. For more complicated output displays it might certainly help to have some PHP coding skills. For my chicken post kind I simply copied and pasted the code for the bookmark kind view and pasted it into a file named kind-chicken.php
following the naming convention of the other files.
Below is a copy of the code I added for the chicken post kind which is nearly identical to the bookmark view with exception of changing the name of the template, adding u-chicken-of
and changing the get_before_kind
to chicken
instead of bookmark
. Note that because the chicken-of
microformat is wrapped on a URL, it has the u-
prefix, otherwise if it were on plain text it would have been p-chicken-of
using the standard microformat h-
, u-
, p-
, and e-
syntax.
I also put both the u-chicken-of
and the u-bookmark-of
microformats in the view so that sites using the post type discovery algorithm that don’t recognize the chicken-of
microformat won’t choke on the proverbial chicken bone, but will default back to thinking this post is of the bookmark type. I suspect that I could also have left the u-bookmark-of
off and many would have defaulted to thinking this post was a simple note as well. You can make your own choice as to which you prefer as a default.
<?php /* * Chicken Template * */ $mf2_post = new MF2_Post( get_the_ID() ); $cite = $mf2_post->fetch(); if ( ! $cite ) { return; } $author = Kind_View::get_hcard( ifset( $cite['author'] ) ); $url = ifset( $cite['url'] ); $embed = self::get_embed( $url ); ?> <section class="response u-chicken-of h-cite"> <header> <?php echo Kind_Taxonomy::get_before_kind( 'chicken' ); if ( ! $embed ) { if ( ! array_key_exists( 'name', $cite ) ) { $cite['name'] = self::get_post_type_string( $url ); } if ( isset( $url ) ) { echo sprintf( '<a href="%1s" class="p-name u-url">%2s</a>', $url, $cite['name'] ); } else { echo sprintf( '<span class="p-name">%1s</span>', $cite['name'] ); } if ( $author ) { echo ' ' . __( 'by', 'indieweb-post-kinds' ) . ' ' . $author; } if ( array_key_exists( 'publication', $cite ) ) { echo sprintf( ' <em>(<span class="p-publication">%1s</span>)</em>', $cite['publication'] ); } } ?> </header> <?php if ( $cite ) { if ( $embed ) { echo sprintf( '<blockquote class="e-summary">%1s</blockquote>', $embed ); } elseif ( array_key_exists( 'summary', $cite ) ) { echo sprintf( '<blockquote class="e-summary">%1s</blockquote>', $cite['summary'] ); } } // Close Response ?> </section> <?php
Icon Support
Finally, you’ll want to include the appropriate svg icon within the plugin so that it will display on the post (if the appropriate settings are chosen within the plugin’s settings interface: either “icon” or “icon and text”), and within the Kinds metabox in the post editor.
You’ll want to have one icon named kindname.svg
in the svgs folder and another named kinds.svg
in the plugin’s root folder. The kinds.svg
is a special ‘master’ svg of all of the kinds icons bundled together. If it helps in matching the icon set, all of the current kind icons are made with Font Awesome icons which have the appropriate licensing for distribution.
In my chicken example, I opted for the feather icon since Font Awesome didn’t have an actual chicken available.
When you’re done
Thanks to the rest of the plugin’s functionality, you should now automatically be able able to make and display individual chicken posts, display a chicken feed (pun intended), and allow people to subscribe to the RSS feed of your chicken posts.
Creating a plugin for new kinds
Naturally some people may want to display particular exotic kinds which might not extend to the broader public. A chicken post type certainly falls under this umbrella as I wouldn’t expect that other than for novelty, obsessive IndieWeb post kinds completeness, or for a very small handful of specialized farming, juggling, or comedy websites that anyone else in their right mind would really want to be doing a lot of posting about chickens on their site.
David Shanske, the plugin’s creator, has made it possible to create a sub-plugin of sorts so that one can add one-off support to these types using a variety of filters and functions. This could be useful so that updates to the plugin don’t overwrite one’s work and require adding the pieces outlined above back in again. Sadly, this is a tad beyond my present abilities, so I won’t address it further at the moment other than to say that it’s possible and perhaps someone might document it for others to use a similar template in the future.
Try it yourself
Now that you’ve got the basics, it should be relatively easy to add many of your own new post kinds.
Exercise One
If you want a simple exercise, you should be able to go into the code and manually change the show
flags for the eat
and drink
kinds from their default false to true to enable posting food to create a food diary on your website. (These have a reasonable default view and icons already built in.)
Exercise Two
With slightly more work you can change the show
flag on the follow
kind and copy a view based on the bookmark view to make a follow view to make follow posts. (Here’s a link to my version.) Similarly other hidden kinds like wishes and acquisitions can be enabled easily as well. These also have default icons already built in, but just need a view defined to show their data.
Exercise Three
If you want a slightly larger challenge that uses all of the above, why not attempt adding the appropriate machinery to create a want post?
Exercise Four
Though David has often said before that he wouldn’t build in support for multi-kinds, some people may still want them or think they need them. If you’re exceptionally clever, you might be able to create your own explicit multi-kind by mixing up the details above and creating a kind that mixes a variety of the details and creates a view that would allow the specific multi-kind you desire. Caveat emptor on this approach if you should take it.
Share your ideas
Now that you’ve got the general method, what kinds are you going to deploy in the future? What have you already created? Feel free to reply with your ideas and thoughts below in the comment section or send us a webmention from your own site with what you’ve done. Maybe consider doing a pull request on the plugin itself to add the functionality for others?
👓 LogMeIn to shut down Xmarks on May 1, 2018 | gHacks Tech News
LogMeIn, parent company of LastPass, announced today that it will shut down the cross-browser bookmark synchronization service Xmarks on May 1, 2018.