Semantic-Linkbacks

Description

Generates richer WordPress comments from linkbacks such as Webmention or classic linkback protocols like Trackback or Pingback.

The limited display for trackbacks and linkbacks is replaced by a clean full sentence, such as “Bob mentioned this article on bob.com.” If Bob’s site uses markup that the plugin can interpret, it may add his profile picture or other parts of his page to display as a full comment. It will optionally show collections of profile pictures, known as Facepiles, instead of the full setences.

Semantic Linkbacks uses Microformats 2 to get information about the linked post and it is highly extensible to also add support for other forms of markup.

Thanks to

Installation

  1. Upload the webmention-folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. …and that’s it 🙂

FAQ

Installation Instructions
  1. Upload the webmention-folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. …and that’s it 🙂
Do I need to mark up my site?

Most modern WordPress themes support the older Microformats standard, which means the plugin should be able to get basic information from
to enhance linkbacks. The plugin is most useful with webmention support(separate plugin) and sites/themes that support Microformats 2.

Why Webmentions?

Webmention is a modern reimplementation of Pingback and is now a W3C Recommendation.

What about the semantic “comment” types?

The IndieWeb community defines several types of feedback:

How do I extend this plugin?

See Extensions

How do I add this into my plugin?

The plugin will automatically enhance webmentions, trackbacks, and pingbacks with an avatar and additional context. It will also automatically add a facepile instead of individual
comments, but this feature can either be turned off by an aware theme or under Discussion in your Settings.

Why do some [emoji reactions](https://indieweb.org/reacji) not show up?

Some emoji characters in webmentions you might receive, e.g. Facebook reactions from Bridgy, take more than two bytes to encode. (In technical terms, these Unicode characters are above the Basic Multilingual Plane.) To handle them, you need MySQL 5.5.3 or higher, and your database and tables need to use the utf8mb4 charset. Usually WordPress does this automatically, but not always.

First, follow these instructions to switch your MySQL database to utf8mb4. Then, make sure DB_CHARSET and DB_COLLATE in your wp-config.php are either unset, set to the blank string, or set to these values:

define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', 'utf8mb4_general_ci');
Who made the logos?

The Webmention and Pingback logos are made by Aaron Parecki and the Microformats logo is made by Dan Cederholm

Contributors & Developers

“Semantic-Linkbacks” is open source software. The following people have contributed to this plugin.

Contributors

“Semantic-Linkbacks” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Semantic-Linkbacks” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

Project actively developed on Github at pfefferle/wordpress-semantic-linkbacks. Please file support issues there.

3.7.2

  • Bugfix: “Normal comments” hidden in comment-section (https://github.com/pfefferle/wordpress-semantic-linkbacks/issues/140)

3.7.1

  • Fixed reacjis and facepiles

3.7.0

  • Add settings to enable each type independently in the Facepile
  • Optionally render mentions as normal comments again
  • Support Reacji…aka single-emoji reactions
  • Bump minimum PHP to 5.4 due emoji detector library dependency issues
  • Overlay emoji on individual avatars in reactions facepile
  • Offer mf2 compatible template for comments
  • Fix semantic_linkbacks_cite filter as was previously filtering the entire comment text
  • Switch semantic_links_cite filter to filtering the format for the citation instead of the prepared citation
  • Count correct text length for unicode characters
  • Facepile Template improvements
  • Allow new comment template to be overridden by filter or theme declaring microformats2 support
  • Code standards compliance changes
  • Improved testing for PHP versions 5.4 and up to ensure compatibility
  • Remove direct calls to comment meta in favor of helper functions to ensure future proofing

3.6.0

  • Only show the first 8 avatars in a facepile by default. If there are more, include a clickable ellipsis to show the rest. Customizable via the FACEPILE_FOLD_LIMIT constant.
  • Link facepile avatars to user profile/home page, not response post
  • Always show avatar images with correct aspect ratio

3.5.1

  • Bugfix release

3.5.0

  • Add Facepile code
  • Add setting to disable automatic facepile include
  • Add filter to allow themes to disable the setting and the feature if they facepile themselves
  • Add PHP requirement to readme file

3.4.1

  • Abstract out linkback retrieval functions to allow for easier changes in future
  • Fix retrieval issue
  • Remove merge and compatibility function creating double slashing due update in 4.7.1
  • Replace blacklist for properties with whitelist for select properties
  • Update avatar function to not override if user_id is set on assumption local overrides remote

3.4.0

  • Fix Tests and Error in Authorship
  • Update Parser
  • Switch to looser restrictions if WP_DEBUG is enabled and stricter ones otherwise
  • Enhance Author Properties to allow for retrieving remote h-card
  • Store mf2 properties
  • Store location in WordPress Geodata
  • Use rel-syndication if not u-syndication
  • Support new webmention source meta key

3.3.1

  • fixed https://github.com/pfefferle/wordpress-semantic-linkbacks/issues/68

3.3.0

  • Due to changes in WordPress 4.4 through 4.7 and version 3.0.0 of the Webmentions plugin this plugin can act on the retrieved remote source
    rather than rerequesting this information.
  • Major enhancement work is done in preprocessing now rather than post-processing
  • Refactoring
  • Render full mention content if short enough. Introduce MAX_INLINE_MENTION_LENGTH which defaults to 300 characters to implement same.
  • Fix text domain

3.2.1

  • updated hooks/filters

3.2.0

  • changed hook from <linkback>_post to comment_post (thanks to @dshanske)
  • used the WordPress Coding Standard
  • small code improvements

3.1.0

  • I18n support
  • German translation
  • some small changes and bugfixes

3.0.5

  • quick fix to prevent crash if Mf2 lib is used by a second plugin

3.0.4

  • added counter functions for comments by type (props to David Shanske)
  • some bugfixes

3.0.3

  • some small tweaks
  • added custom comment classes based on the linkback-type (props to David Shanske for the idea)

3.0.2

  • added support for threaded comments

3.0.1

  • fixed bug in comments section

3.0.0

  • nicer integration with trackbacks, linkbacks and webmentions
  • cleanup

2.0.1

  • “via” links for indieweb “reply”s (thanks to @snarfed for the idea)
  • simplified output for all other indieweb “comment” types
  • better parser (thanks to voxpelly for his test-pinger)
  • now ready to use in a bundle

2.0.0

  • initial release