A simple way to link to copies of your cross-posted content in other social networks or websites. Now with posting UI.
It supports adding rel-syndication/u-syndication links to your WordPress posts, pages, and comments, indicating where a syndicated copy is, in the form of a text or icon link. You can do this
manually and some plugins support automatically adding their links as well. The plugin contains a generic UI for syndicating to other sites through your site or a Micropub Client.
This plugin stores syndication links, which can be attached to any post, page, or comment. They can be added to custom post types by filter.
For webmention initiated comments, this information will be added by parsing the source of the webmention.
It is assumed if you send a webmention, you consent to share this information if it is publicly shared on your page. Our recommendation
is that site owners should take down information on request.
For comments initiated on the site, there is built-in way to add these links. For posts, they are typically added by retrieving information stored by other plugins for display. It is assumed
that by installing this plugin, as its intent is to display these links, that you wish to display them.
Settings for the Syndication Links plugin can be found in the main WordPress “Settings” tab in the
admin dashboard, or if the Indieweb plugin is installed, under the Indieweb tab. The options provided allow for various ways of presenting the syndication links in posts. Syndication Links by default will add links to the content. You can remove this in your plugin if you wish to call the display function directly.
The settings include the following options as follows with either a set of buttons, a check box (with a check indicating that the feature is “on”) or an optional text field:
Note: The particular CSS of your theme may change the display and output of the text and some of the icons.
The plugin supports automatically pulling data from plugins that syndicate your content so you don’t need to do it manually. For anything not built in, integation is easy with a simple filter for potential use with any other plugin.
Using the optional Syndication feature(disabled by default) you can syndicate your posts to:
Will be looking to integrate with other plugins to add more options and invite developers to add support if they wish as the interface is simple.
The goal of the interface is not only can you syndicate via Micropub, but in the editor using a simple checkbox.
In no particular order…
Or install through the WordPress Plugin Directory.
You will have to add the following code to your theme add_filter( 'syndication_links_display', '__return_false' );
and then you can call get_syndication_links() directly in your theme. You should add
this to the init hook.
get_comment_syndication_links( $comment, $args ) - Returns the HTML for a comment.
** $args
***
style- Defaults to ul
***
text- Display text, defaults to settings option
***
icons- Display icons, defaults to settings option
***
container-css- Class to wrap entire syndication links in
***
single-css- Class to wrap a single link in
***
text-css` – Class to wrap the text before the links inIf you add ?original-of=
and the URL-encoded URL it will return the post that has that URL stored. As no two posts should have the same two syndication links it will by default only return the first.
If you want to do this with a form, there is a function you can add to your theme called get_original_of_form()
and a widget that calls this. Like the search form if you have a
originalofform.php in your theme folder the function will return it so you can customize the form.
syn_rewrite_secure( $domains )
– $domains is an array of domain names to rewrite to https if foundsyn_metabox_types( $screens )
– $screens would be an array of post types to add the Syndication Link metabox to.syn_network_strings( $strings )
– $strings is an array of descriptive text strings by domain namesyn_add_links( $urls, $post_ID )
– (Deprecated) $urls is an array of retrieved links from $post_IDget_post_syndication_links( $urls, $post_ID)
– Replaces syn_add_links.get_comment_syndication_links( $urls, $comment_ID
– Filters an array of retrieved comment syndication links.syn_links_display_defaults( $defaults )
– Filter the defaults for displaying Syndication Linkssyndication_link_checked( $checked, $uid, $post_ID )
– Will check a syndication provider($uid) when loaded. The post ID is passed through to allow more specific targeting.syndication_link_disabled( $disabled, $uid, $post_ID )
– Will disable the checkbox for a syndication provider($uid) when loaded. The post ID is passed through to allow more specific targeting.syn_link_title( $title, $name )
– Allows you to set the title string for Links. Example, pinboard => Pinboard.syn_link_mapping( $icon, $url )
– Allows you to override or set the mapping from URL to icon name.pre_syn_link_icon( $icon, $name )
– Allows you to provide a custom icon. Icons by default are SVG, not URL or filenames.syndication_links_display( true )
– Adds Syndication Links to content display. Set to false if the theme supports this.Development and bug reports on this plugin is on Github at https://github.com/dshanske/syndication-links
pre_syndication_links_webmention
hook to allow you to clear cache before sending webmention.syn_link_name
filter that allows you to set the name string.pre_syn_link_icon
filter to allow short circuiting the domain mapping and providing an SVG of your choice.get_original_of_form()
which creates a search for for the original of query which looks up posts by their syndication linkget_syndication_links function
into smaller pieces ( props @Ruxton )get_syndication_links_elements
which returns array of anchor tagsget_syndication_links_display_defaults
to return default optionsget_syndication_links_text_before
to return textbefore on it’s ownget_syndication_links
to allow for customized presentation?original-of=url
with url being the syndication URL will return the original entry.* Adjust close bracket
* Fix text display issue
* Remove icon fonts in favor of SVG * Remove rel-me support to move to implementation in Indieweb plugin * Remove h-card support to move to implementation in Indieweb plugin (it wasn't very good anyway) * Introduce new get_syndication_data function to abstract out storage
* Removed user meta code
* Minor Tweaks and Cleanup
* CSS fixes * Version number added to CSS import to avoid caching on update
* Misc. Bug Fixes * Bridgy Publish Support removed - new Bridgy plugin will handle that
* Rewritten to remove global scoping * Option to add URLs to the head of the home page for rel-me auth * Option to add URLs as a widget for rel-me auth
* Security Fix. Nothing new
* Refinements * Add support for pages and a filter to add additional content types
* Refinements * Addition of h-card widget. * Improvements to hooks * Addition of automatic information from SNAP and Social(courtesy WordPress Syndication). * Now supports second font choice and choice of color or black.
* Add hooks and functions to allow additional urls to be added
* Clean up the plugin for initial release to WordPress repository.
* Moved to simplified data structure. * Hidden migration function
* Rewriting using Grunt/SASS for more flexibility
* Customizable Networks finished. * Changed social icons CSS to automatically add only if the class for the list has social-icon in it.
* Settings Screen rewritten using WordPress Settings API. * Going to rewrite with customizable networks and thus option to disable sites you do not syndicate to. * Added social icons CSS to automatically add icons to anything in a <LI>
* Forked from the Semantic Comments plugin. Start of configurable options.