Improve instructions for use

Filed an Issue Automatically send mentions to IndieNews. (GitHub)
Contribute to pfefferle/wordpress-indienews development by creating an account on GitHub.

Some who come across the plugin who are relatively IndieWeb-aware don’t know how to use the plugin:
eg: https://islandinthenet.com/saturday-16-february-2019-1017am/ which has resulted in some unintended spam in the IndieNews feed.

What exactly are the triggers for syndicating to IndieWeb News and Indieweb.xyz? Is it just having a tag indienews, indieweb, or even indie* where * is a wildcard? Are there others I may be missing?

Can one target other subs within indieweb.xyz (examples: /en/longreads or /en/games/) or just the /language/indieweb/ sub with the plugin? How is differentiating them done from the user’s perspective? I do see a reference to the /hottubs/ sub in the code, but I’m not following all the logic there.

I suspect it would also be nice to have some details about the dashboard widget and news feeds as well as listing a requirement for the Webmention plugin which some might not know about.

I’m happy to modify the readme’s with better instructions if I can be a bit more clear on some of what the code is doing with regard to the above.

A few display quirks in the Syndication Links plugin

Filed an Issue Add and Display Syndication Links. (GitHub)
Contribute to dshanske/syndication-links development by creating an account on GitHub.

With the most recent update I’m noticing a few small edge case quirks that seem to have popped up:

For syndication to indieweb.xyz the displayed result (set for icon only) is giving a relatively interesting “info” icon,which is a reasonable proxy, but sadly the hover text is also “info” instead of a more useful or expected “indieweb.xyz”.

For syndications to reading.am (which I’m guessing still doesn’t have a service specific icon) instead of giving the old default image of a globe icon, it’s not displaying anything at all. I haven’t tested specifically, but are unmapped urls still given that old default icon?

I’m still seeing issues with my chrisaldrich.wordpress.com URL. Previously it displayed a blank space (presumably not able to understand the inpub), but the newer version is displaying the word “WordPress” even when I’m using icons only. (Example: https://boffosocko.com/2019/02/14/a-sketch-for-an-indieweb-bullet-journal/#Syndicated%20copies) My initial inclination is that the two instances of “WordPress” at https://github.com/dshanske/syndication-links/blob/057733d921b485cf8f0eb98b28b104ccb708bd21/includes/class-syn-meta.php#L333 are both CamelCase when all the other examples around/near that segment of code are all lower case.

Replied to a post by Khürt WilliamsKhürt Williams (islandinthenet.com)
I have just installed the IndieNews plugin but … I don’t understand how to use it.

Syndicating Your Posts

The IndieNews plugin allows you to automatically syndicate your posts to the IndieNews and IndieWeb.xyz sites using webmention. You’ll notice on your posts that in your tags, in addition to the indieweb tag you’ve added, the plugin has automatically added additional tags  which include and /en/indieweb which–instead of being wrapped with links to those tags on your website–are wrapped with links pointing to those websites along with the appropriate syndication markup. As a result, when you publish your posts and send webmentions, both of those services are posting to those services on your behalf.

I’d recommend care in syndicating to them using this plugin as this morning it might appear to some that you’re spamming those channels. I tag lots of things on my site as “IndieWeb” mostly for my own use, so I specifically don’t use the plugin for concern of overwhelming those other sites. Instead I typically cross-post to both services manually using their respective instructions: IndieWeb News and IndieWeb.xyz.

IndieNews Dashboard Widget

The other feature that the plugin does is add a small widget to your main /wp-admin/ dashboard page that also displays a feed of what appears on the IndieNews website for your convenience.

Example of what IndieNews widget looks like in your WordPress dashboard.

I’ll admit that the GitHub repo for the plugin doesn’t do as good a job of describing how to use it as it might. Perhaps we ought to file an issue to improve that?

📺 “Shtisel” Everybody Are Looking for Love | Netflix

Watched "Shtisel" Everybody Are Looking for Love from Netflix
Directed by Alon Zingman. With Doval'e Glickman, Michael Aloni, Ayelet Zurer, Neta Riskin.

Circling back to watch the opening episodes I missed originally. 

The meet cute here was just lovely.