CINXE.COM

<!DOCTYPE html> <html lang="en" dir="ltr" class="no-js"> <head> <meta charset="utf-8" /> <title>plugin:linkback [DokuWiki]</title> <meta name="generator" content="DokuWiki"/> <meta name="theme-color" content="#008800"/> <meta name="robots" content="index,follow"/> <meta name="keywords" content="plugin,linkback"/> <link rel="search" type="application/opensearchdescription+xml" href="/lib/exe/opensearch.php" title="DokuWiki"/> <link rel="start" href="/"/> <link rel="contents" href="/plugin:linkback?do=index" title="Sitemap"/> <link rel="manifest" href="/lib/exe/manifest.php"/> <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/feed.php"/> <link rel="alternate" type="application/rss+xml" title="Current namespace" href="/feed.php?mode=list&ns=plugin"/> <link rel="edit" title="Edit this page" href="/plugin:linkback?do=edit"/> <link rel="alternate" type="text/html" title="Plain HTML" href="/_export/xhtml/plugin:linkback"/> <link rel="alternate" type="text/plain" title="Wiki Markup" href="/_export/raw/plugin:linkback"/> <link rel="canonical" href="https://www.dokuwiki.org/plugin:linkback"/> <link rel="stylesheet" href="/lib/exe/css.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e"/> <script >var NS='plugin';var JSINFO = {"plugins":{"edittable":{"default columnwidth":""}},"id":"plugin:linkback","namespace":"plugin","ACT":"show","useHeadingNavigation":0,"useHeadingContent":0};(function(H){H.className=H.className.replace(/\bno-js\b/,'js')})(document.documentElement);</script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.4/jquery.min.js" defer="defer"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.13.2/jquery-ui.min.js" defer="defer"></script> <script src="/lib/exe/js.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e&lang=en" defer="defer"></script> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="shortcut icon" href="/lib/tpl/dokuwiki/images/favicon.ico" /> <link rel="apple-touch-icon" href="/lib/tpl/dokuwiki/images/apple-touch-icon.png" /> <meta name="verify-v1" content="OVxl3gsCv2MhZqh1cBQyl0JytWXSwXMjyvwc+4w3WtA=" /> <meta name="google-site-verification" content="YhTVK69hW94ZXUtc2zSLPxTkZKbZIn0zK67mz5WQB-E" />  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-83791-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-83791-1', { 'anonymize_ip': true }); </script> </head> <body> <div id="dokuwiki__site"><div id="dokuwiki__top" class="site dokuwiki mode_show tpl_dokuwiki showSidebar hasSidebar">  <header id="dokuwiki__header"><div class="pad group"> <div class="headings group"> <ul class="a11y skip"> <li><a href="#dokuwiki__content">skip to content</a></li> </ul> <h1 class="logo"><a href="/start" accesskey="h" title="Home [h]"><img src="/lib/tpl/dokuwiki/images/logo.png" width="64" height="64" alt="" /><span>DokuWiki</span></a></h1> <p class="claim">It's better when it's simple</p> </div> <div class="tools group">  <div id="dokuwiki__usertools"> <h3 class="a11y">User Tools</h3> <ul> <li class="action login"><a href="/plugin:linkback?do=login&sectok=" title="Log In" rel="nofollow"><span>Log In</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10 17.25V14H3v-4h7V6.75L15.25 12 10 17.25M8 2h9a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2v-4h2v4h9V4H8v4H6V4a2 2 0 0 1 2-2z"/></svg></a></li> </ul> </div>  <div id="dokuwiki__sitetools"> <h3 class="a11y">Site Tools</h3> <form action="/start" method="get" role="search" class="search doku_form" id="dw__search" accept-charset="utf-8"><input type="hidden" name="do" value="search" /><input type="hidden" name="id" value="plugin:linkback" /><div class="no"><input name="q" type="text" class="edit" title="[F]" accesskey="f" placeholder="Search" autocomplete="on" id="qsearch__in" value="" /><button value="1" type="submit" title="Search">Search</button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form> <div class="mobileTools"> <form action="/doku.php" method="get" accept-charset="utf-8"><div class="no"><input type="hidden" name="id" value="plugin:linkback" /><select name="do" class="edit quickselect" title="Tools"><option value="">Tools</option><optgroup label="Page Tools"><option value="edit">Edit this page</option><option value="revisions">Old revisions</option><option value="backlink">Backlinks</option></optgroup><optgroup label="Site Tools"><option value="recent">Recent Changes</option><option value="media">Media Manager</option><option value="index">Sitemap</option></optgroup><optgroup label="User Tools"><option value="login">Log In</option></optgroup></select><button type="submit">></button></div></form> </div> <ul> <li class="action recent"><a href="/plugin:linkback?do=recent" title="Recent Changes [r]" rel="nofollow" accesskey="r">Recent Changes</a></li><li class="action media"><a href="/plugin:linkback?do=media&ns=plugin" title="Media Manager" rel="nofollow">Media Manager</a></li><li class="action index"><a href="/plugin:linkback?do=index" title="Sitemap [x]" rel="nofollow" accesskey="x">Sitemap</a></li> </ul> </div> </div>  <div class="breadcrumbs"> <div class="trace"><span class="bchead">Trace:</span> <span class="bcsep">•</span> <span class="curid"><bdi><a href="/plugin:linkback" class="breadcrumbs" title="plugin:linkback">linkback</a></bdi></span></div> </div> <hr class="a11y" /> </div></header> <div class="wrapper group">  <nav id="dokuwiki__aside" aria-label="Sidebar"><div class="pad aside include group"> <h3 class="toggle">Sidebar</h3> <div class="content"><div class="group"> <p> <strong>Learn about DokuWiki</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/features" class="wikilink1" title="features" data-wiki-id="features">Features</a> & <a href="/blogroll" class="wikilink1" title="blogroll" data-wiki-id="blogroll">reviews</a> </div> </li> <li class="level1"><div class="li"> <a href="/install" class="wikilink1" title="install" data-wiki-id="install">Installation guide</a></div> </li> <li class="level1"><div class="li"> <a href="/manual" class="wikilink1" title="manual" data-wiki-id="manual">User manual</a> & <a href="/wiki:syntax" class="wikilink1" title="wiki:syntax" data-wiki-id="wiki:syntax">syntax</a></div> </li> <li class="level1"><div class="li"> <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">Release notes</a></div> </li> <li class="level1"><div class="li"> <a href="/faq" class="wikilink1" title="faq" data-wiki-id="faq">FAQ</a></div> </li> </ul> <p> <strong>Advanced Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/extensions" class="wikilink1" title="extensions" data-wiki-id="extensions">Extensions</a></div> </li> <li class="level1"><div class="li"> <a href="/development" class="wikilink1" title="development" data-wiki-id="development">Development manual</a></div> </li> </ul> <p> <strong>Corporate Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/faq:support" class="wikilink1" title="faq:support" data-wiki-id="faq:support">Get support</a></div> </li> <li class="level1"><div class="li"> <a href="/donate" class="wikilink1" title="donate" data-wiki-id="donate">Donations</a></div> </li> </ul> <p> <strong>Our Community</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/teams:getting_involved" class="wikilink1" title="teams:getting_involved" data-wiki-id="teams:getting_involved">Get involved</a></div> </li> <li class="level1"><div class="li"> <a href="/dokuinstall" class="wikilink1" title="dokuinstall" data-wiki-id="dokuinstall">Users</a></div> </li> <li class="level1"><div class="li"> <a href="http://forum.dokuwiki.org" class="urlextern" title="http://forum.dokuwiki.org">User forum</a></div> </li> <li class="level1"><div class="li"> <a href="/mailinglist" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">Development mailinglist</a></div> </li> </ul> <hr /> <p> Follow us on <a href="https://phpc.social/@dokuwiki" class="urlextern" title="https://phpc.social/@dokuwiki">Mastodon</a> and other <a href="/social" class="wikilink1" title="social" data-wiki-id="social">social networks</a>. </p> <p> <a href="/privacy" class="wikilink1" title="privacy" data-wiki-id="privacy">Our Privacy Policy</a> </p> </div></div> </div></nav>  <main id="dokuwiki__content"><div class="pad group"> <div class="pageId"><span>plugin:linkback</span></div> <div class="page group">   <div id="dw__toc" class="dw__toc"> <h3 class="toggle">Table of Contents</h3> <div> <ul class="toc"> <li class="level1"><div class="li"><a href="#linkback_plugin">Linkback Plugin</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#description">Description</a></div></li> <li class="level2"><div class="li"><a href="#changes">Changes</a></div></li> <li class="level2"><div class="li"><a href="#usage">Usage</a></div></li> <li class="level2"><div class="li"><a href="#adding_new_spamfilters">Adding new spamfilters</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#events">Events</a></div></li> <li class="level3"><div class="li"><a href="#linkback_data">Linkback data</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#discussion">Discussion</a></div></li> </ul></li> </ul> </div> </div>  <h1 class="sectionedit1" id="linkback_plugin">Linkback Plugin</h1> <div class="level1"> <div class="pluginrepo_entry"><div class="usageInfo"><div class="compatibility"><p class="label">Compatible with DokuWiki</p><div class="versions"><ul><li class="">2024-02-06 "Kaos" <strong><span>unknown</span></strong></li><li class="">2023-04-04 "Jack Jackrum" <strong><span>unknown</span></strong></li><li class="yes">2022-07-31 "Igor" <strong><span>yes</span></strong></li><li class="yes">2020-07-29 "Hogfather" <strong><span>yes</span></strong></li></ul></div></div><ul class="actions"><li><a class="download" href="https://github.com/dokufreaks/plugin-linkback/tarball/master">Download</a></li><li><a class="bugs" href="https://github.com/dokufreaks/plugin-linkback/issues">Report bugs</a></li></ul><div class="clearer"></div></div><div class="mainInfo"><p class="description"><a class="media" href="/plugins"><img alt="plugin" class="medialeft" src="/lib/plugins/pluginrepo/images/dwplugin.png" width="60" height="60" /></a> Adds Trackback and Pingback support to DokuWiki</p></div><div class="metaInfo"><dl><dt>Last updated on</dt><dd>2023-12-30</dd><dt>Provides</dt><dd><a href="/plugins?plugintype=1#extension__table" class="wikilink1" title="List all Syntax plugins">Syntax</a>, <a href="/plugins?plugintype=2#extension__table" class="wikilink1" title="List all Admin plugins">Admin</a>, <a href="/plugins?plugintype=4#extension__table" class="wikilink1" title="List all Action plugins">Action</a></dd><dt>Repository</dt><dd><a class="urlextern" href="https://github.com/dokufreaks/plugin-linkback/">Source</a></dd><dt>Conflicts with</dt><dd><a href="/plugin:badbehaviour" class="wikilink1" title="plugin:badbehaviour" data-wiki-id="plugin:badbehaviour">badbehaviour</a></dd></dl></div><div class="moreInfo"><p class="tags">Tagged with <a href="/plugins?plugintag=blog#extension__table" class="wikilink1" title="List all plugins with this tag">blog</a>, <a href="/plugins?plugintag=pingback#extension__table" class="wikilink1" title="List all plugins with this tag">pingback</a>, <a href="/plugins?plugintag=trackback#extension__table" class="wikilink1" title="List all plugins with this tag">trackback</a></p></div><div class="authorInfo"><strong>By <a href="mailto:freaks%20%5Bat%5D%20dokuwiki%20%5Bdot%5D%20org" class="mail" title="freaks [at] dokuwiki [dot] org">Dokufreaks (previous authors: Michael Hamann, Gina Häußge)</a></strong><ul><li><a href="/plugin:tag" class="wikilink1" title="plugin:tag" data-wiki-id="plugin:tag">tag</a></li> <li><a href="/plugin:include" class="wikilink1" title="plugin:include" data-wiki-id="plugin:include">include</a></li> <li><a href="/plugin:cloud" class="wikilink1" title="plugin:cloud" data-wiki-id="plugin:cloud">cloud</a></li> <li><a href="/plugin:folded" class="wikilink1" title="plugin:folded" data-wiki-id="plugin:folded">folded</a></li> <li><a href="/plugin:task" class="wikilink1" title="plugin:task" data-wiki-id="plugin:task">task</a></li> <li><a href="/plugin:keyboard" class="wikilink1" title="plugin:keyboard" data-wiki-id="plugin:keyboard">keyboard</a></li> <li><a href="/plugin:var" class="wikilink1" title="plugin:var" data-wiki-id="plugin:var">var</a></li> <li><a href="/plugin:poll" class="wikilink1" title="plugin:poll" data-wiki-id="plugin:poll">poll</a></li> <li><a href="/plugin:feed" class="wikilink1" title="plugin:feed" data-wiki-id="plugin:feed">feed</a></li> <li><a href="/plugin:charter" class="wikilink1" title="plugin:charter" data-wiki-id="plugin:charter">charter</a></li> <li>and 13 more</li></ul></div></div> </div> <div class="secedit editbutton_section editbutton_1"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Linkback Plugin] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="linkback_plugin" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1-618" /><button type="submit" title="Linkback Plugin">Edit</button></div></form></div> <h2 class="sectionedit2" id="description">Description</h2> <div class="level2"> <p> The linkback plugin adds <a href="https://en.wikipedia.org/wiki/Trackback" class="interwiki iw_wp" title="https://en.wikipedia.org/wiki/Trackback">Trackback</a> and <a href="https://en.wikipedia.org/wiki/Pingback" class="interwiki iw_wp" title="https://en.wikipedia.org/wiki/Pingback">Pingback</a> support to DokuWiki. This includes autodiscovery of track- and pingback-URLs on websites linked via an external or internal link and then sending the actual linkback as well as receiving and displaying received linkbacks. An expandable spamfilter provides protection from trackback and pingback spam. Currently, this includes </p> <ul> <li class="level1"><div class="li"> a check whether the count of links in the excerpt exceeds a configurable amount,</div> </li> <li class="level1"><div class="li"> a check of the excerpt against the DokuWiki wordblock list,</div> </li> <li class="level1"><div class="li"> a check whether the ip of the linking page is equal to that of the submitter (moderation instead of instant deletion is enabled by default for this check, you should keep it like that),</div> </li> <li class="level1"><div class="li"> a check whether the linking page includes a link to the linked page in case of a trackback (where this check is not part of the protocol as compared to pingbacks) and</div> </li> <li class="level1"><div class="li"> support for using the <a href="http://www.akismet.com" class="urlextern" title="http://www.akismet.com">Akismet</a> webservice to check linkbacks for spam (disabled by default, you need an Akismet <abbr title="Application Programming Interface">API</abbr> key to use this feature. You can get one by registering for a blog at <a href="http://www.wordpress.com" class="urlextern" title="http://www.wordpress.com">Wordpress.com</a>).</div> </li> </ul> <p> It should be noted that the badbehaviour library which is incorporated into the <a href="/plugin:badbehaviour" class="wikilink1" title="plugin:badbehaviour" data-wiki-id="plugin:badbehaviour">badbehaviour</a> plugin does not seem to be very friendly to anything remotely resembling a trackback or a pingback<sup><a href="#fn__1" id="fnt__1" class="fn_top">1)</a></sup> and thus will probably lead to the linkback plugin not working as intended. I'll try to look into it though. </p> </div> <div class="secedit editbutton_section editbutton_2"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Description] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="description" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="619-2294" /><button type="submit" title="Description">Edit</button></div></form></div> <h2 class="sectionedit3" id="changes">Changes</h2> <div class="level2"> <ul class="rss"><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/bad4d343f49d80e6f0792838a3bd2fbbd0dff69e" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/bad4d343f49d80e6f0792838a3bd2fbbd0dff69e">Version upped</a> (2023-12-30 23:50)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/65cd48fdb76805d3b45084eb604cb1f681d989ac" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/65cd48fdb76805d3b45084eb604cb1f681d989ac">Merge pull request #18 from LouisOuellet/dev</a> (2023-12-30 09:25)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/2d1a287fbde65373aa07e0b8aab9469116118035" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/2d1a287fbde65373aa07e0b8aab9469116118035">Removing VERSION and Reverting CHANGELOG</a> (2023-12-30 02:32)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/106c7f4be968c46c5ec489d13df36734f63ebfea" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/106c7f4be968c46c5ec489d13df36734f63ebfea">Adding a check if $linkback was returned.</a> (2023-12-29 18:03)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/c6dd478110de3b1473c58efa6a4bd839aa2bde71" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/c6dd478110de3b1473c58efa6a4bd839aa2bde71">Added Diagnostic Data for Trying to access array offset on value of t…</a> (2023-12-29 17:53)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/d9d65883c9463d83e3e1e5ee263857bf04bb1fde" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/d9d65883c9463d83e3e1e5ee263857bf04bb1fde">Fixed: PHP Warning: Undefined array key "lid" in [WEBROOT]/lib/plugi…</a> (2023-12-29 04:54)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/855285871183cb9244b402bafc31dc144b10440b" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/855285871183cb9244b402bafc31dc144b10440b">Update plugin.info.txt</a> (2023-07-07 11:43)</div></li><li><div class="li"><a href="https://github.com/dokufreaks/plugin-linkback/commit/ebba3ee839ba5b2c36661d5c3390c60115e9e52d" class="urlextern" title="https://github.com/dokufreaks/plugin-linkback/commit/ebba3ee839ba5b2c36661d5c3390c60115e9e52d">mail_send() replaced, some renaming</a> (2022-08-03 20:51)</div></li></ul> </div> <div class="secedit editbutton_section editbutton_3"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Changes] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="changes" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2295-2395" /><button type="submit" title="Changes">Edit</button></div></form></div> <h2 class="sectionedit4" id="usage">Usage</h2> <div class="level2"> <p> In order to send linkbacks from a wiki node, activate the corresponding checkbox in the editform. </p> <p> The receiving and display of received linkbacks is handled by the syntax plugin. The following commands are recognized: </p> <ul> <li class="level1"><div class="li"> <strong><code>~~LINKBACK~~</code></strong>: Receive and display linkbacks.</div> </li> <li class="level1"><div class="li"> <strong><code>~~LINKBACK:closed~~</code></strong>: Display already received linkbacks but don't receive new ones.</div> </li> <li class="level1"><div class="li"> <strong><code>~~LINKBACK:off~~</code></strong>: Neither receive nor display linkbacks. Use this to disable linkback support in an already linkback-enabled wiki node.</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_4"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Usage] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="usage" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2396-2935" /><button type="submit" title="Usage">Edit</button></div></form></div> <h2 class="sectionedit5" id="adding_new_spamfilters">Adding new spamfilters</h2> <div class="level2"> </div> <div class="secedit editbutton_section editbutton_5"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Adding new spamfilters] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="adding_new_spamfilters" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2936-2971" /><button type="submit" title="Adding new spamfilters">Edit</button></div></form></div> <h3 class="sectionedit6" id="events">Events</h3> <div class="level3"> <p> The linkback plugin introduces three new events to allow for extension of its antispam-mechanisms by action plugins. These events are: </p> </div> <h4 id="action_linkback_received">ACTION_LINKBACK_RECEIVED</h4> <div class="level4"> <div class="table sectionedit7"><table class="inline"> <tr class="row0"> <th class="col0"> Name </th><td class="col1"> ACTION_LINKBACK_RECEIVED </td> </tr> <tr class="row1"> <th class="col0"> Data </th><td class="col1"> <pre class="code">$data['linkback'] -- The linkback data as documented below $data['page'] -- The html source as fetched from the pinging site $data['target'] -- The wiki page that got pinged $data['show'] -- Whether to show the linkback, defaults to true and can be set in action plugins to moderate the linkback $data['log'] -- An array of lines that make up the linkback log of the received linkback. Antispam plugins can add their own logging output by appending lines to this array.</pre> </td> </tr> <tr class="row2"> <th class="col0"> Action </th><td class="col1"> Sets the <code>show</code> property of the received linkback to the value defined in the event's <code>data</code><br/> and then saves the linkback. </td> </tr> <tr class="row3"> <th class="col0 leftalign"> Preventable </th><td class="col1"> yes </td> </tr> <tr class="row4"> <th class="col0"> Signalled </th><td class="col1"> by <code>exe/trackback.php</code> and <code>exe/pingback.php</code> before saving the new linkback </td> </tr> </table></div> <div class="secedit editbutton_table editbutton_7"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Table] " /><input type="hidden" name="target" value="table" /><input type="hidden" name="hid" value="table" /><input type="hidden" name="range" value="3160-4094" /><button type="submit" title="Table">Edit</button></div></form></div> <p> Action plugins can register for this event to filter incoming linkbacks using both the actual linkback data as well as the source of the pinging page. </p> </div> <h4 id="action_linkback_ham">ACTION_LINKBACK_HAM</h4> <div class="level4"> <div class="table sectionedit8"><table class="inline"> <tr class="row0"> <th class="col0"> Name </th><td class="col1"> ACTION_LINKBACK_HAM </td> </tr> <tr class="row1"> <th class="col0"> Data </th><td class="col1"> the linkback data </td> </tr> <tr class="row2"> <th class="col0"> Action </th><td class="col1"> none </td> </tr> <tr class="row3"> <th class="col0 leftalign"> Preventable </th><td class="col1"> no </td> </tr> <tr class="row4"> <th class="col0"> Signalled </th><td class="col1"> by the handler of the <code>Report as Ham</code> button of the linkback-listing (<code>action/display.php</code>) </td> </tr> </table></div> <div class="secedit editbutton_table editbutton_8"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Table] " /><input type="hidden" name="target" value="table" /><input type="hidden" name="hid" value="table1" /><input type="hidden" name="range" value="4277-4488" /><button type="submit" title="Table">Edit</button></div></form></div> <p> In order to report a linkback as ham (e.g. to antispam plugins using classifiers), action plugins can register for this event. </p> </div> <h4 id="action_linkback_spam">ACTION_LINKBACK_SPAM</h4> <div class="level4"> <div class="table sectionedit9"><table class="inline"> <tr class="row0"> <th class="col0"> Name </th><td class="col1"> ACTION_LINKBACK_SPAM </td> </tr> <tr class="row1"> <th class="col0"> Data </th><td class="col1"> the linkback data </td> </tr> <tr class="row2"> <th class="col0"> Action </th><td class="col1"> none </td> </tr> <tr class="row3"> <th class="col0 leftalign"> Preventable </th><td class="col1"> no </td> </tr> <tr class="row4"> <th class="col0"> Signalled </th><td class="col1"> by the handler of the <code>Report as Spam</code> button of the linkback-listing (<code>action/display.php</code>) </td> </tr> </table></div> <div class="secedit editbutton_table editbutton_9"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Table] " /><input type="hidden" name="target" value="table" /><input type="hidden" name="hid" value="table2" /><input type="hidden" name="range" value="4648-4861" /><button type="submit" title="Table">Edit</button></div></form></div> <p> In order to report a linkback as spam (e.g. to antispam plugins using classifiers), action plugins can register for this event. </p> </div> <div class="secedit editbutton_section editbutton_6"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Events] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="events" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2972-4990" /><button type="submit" title="Events">Edit</button></div></form></div> <h3 class="sectionedit10" id="linkback_data">Linkback data</h3> <div class="level3"> <p> Each linkback item is represented as a hash which stores the following properties: </p> <ul> <li class="level1"><div class="li"> <strong><code>lid</code></strong> – internal id of the linkback</div> </li> <li class="level1"><div class="li"> <strong><code>title</code></strong> – title</div> </li> <li class="level1"><div class="li"> <strong><code>url</code></strong> – url</div> </li> <li class="level1"><div class="li"> <strong><code>raw_excerpt</code></strong> – small excerpt of the linking page (exactly as received in the linkback)</div> </li> <li class="level1"><div class="li"> <strong><code>excerpt</code></strong> – small excerpt of the linking page (html tags stripped)</div> </li> <li class="level1"><div class="li"> <strong><code>blog_name</code></strong> – name of the linking page</div> </li> <li class="level1"><div class="li"> <strong><code>favicon</code></strong> – url of the linking page's <a href="https://en.wikipedia.org/wiki/Favicon" class="interwiki iw_wp" title="https://en.wikipedia.org/wiki/Favicon">favicon</a>, or false if none could be found</div> </li> <li class="level1"><div class="li"> <strong><code>received</code></strong> – timestamp of the date the linkback was received</div> </li> <li class="level1"><div class="li"> <strong><code>submitter_ip</code></strong> – ip of the submitter</div> </li> <li class="level1"><div class="li"> <strong><code>submitter_useragent</code></strong> – useragent of the submitter</div> </li> <li class="level1"><div class="li"> <strong><code>submitter_referer</code></strong> – referer of the submitter</div> </li> <li class="level1"><div class="li"> <strong><code>type</code></strong> – type of the linkback, can be either <code>trackback</code> or <code>pingback</code></div> </li> <li class="level1"><div class="li"> <strong><code>show</code></strong> – true if the linkback should be visible to everyone, false if it should be visible only to admins. Antispam plugins can set this to false in order to moderate a suspicious linkback.</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_10"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Linkback data] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="linkback_data" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="4991-6057" /><button type="submit" title="Linkback data">Edit</button></div></form></div> <h2 class="sectionedit11" id="discussion">Discussion</h2> <div class="level2"> <p> Please don't report any bugs or feature requests here but instead use the bug tracker! </p> </div> <div class="secedit editbutton_section editbutton_11"><form class="button btn_secedit" method="post" action="/plugin:linkback"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1703976617" /><input type="hidden" name="summary" value="[Discussion] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="discussion" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="6058-" /><button type="submit" title="Discussion">Edit</button></div></form></div><div class="footnotes"> <div class="fn"><sup><a href="#fnt__1" id="fn__1" class="fn_bot">1)</a></sup> <div class="content">HTTP Range headers for probing for ping URLs are prohibited/forced into omitting the first byte, most of the user agents used by blog software is prohibited, …</div></div> </div>  </div> <div class="docInfo"><bdi>plugin/linkback.txt</bdi> · Last modified: <time datetime="2023-12-30T23:50:17+0100">2023-12-30 23:50</time> by <bdi>andi</bdi></div> <hr class="a11y" /> </div></main>  <nav id="dokuwiki__pagetools" aria-labelledby="dokuwiki__pagetools__heading"> <h3 class="a11y" id="dokuwiki__pagetools__heading">Page Tools</h3> <div class="tools"> <ul> <li class="edit"><a href="/plugin:linkback?do=edit" title="Edit this page [e]" rel="nofollow" accesskey="e"><span>Edit this page</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg></a></li><li class="revs"><a href="/plugin:linkback?do=revisions" title="Old revisions [o]" rel="nofollow" accesskey="o"><span>Old revisions</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M11 7v5.11l4.71 2.79.79-1.28-4-2.37V7m0-5C8.97 2 5.91 3.92 4.27 6.77L2 4.5V11h6.5L5.75 8.25C6.96 5.73 9.5 4 12.5 4a7.5 7.5 0 0 1 7.5 7.5 7.5 7.5 0 0 1-7.5 7.5c-3.27 0-6.03-2.09-7.06-5h-2.1c1.1 4.03 4.77 7 9.16 7 5.24 0 9.5-4.25 9.5-9.5A9.5 9.5 0 0 0 12.5 2z"/></svg></a></li><li class="backlink"><a href="/plugin:linkback?do=backlink" title="Backlinks" rel="nofollow"><span>Backlinks</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10.59 13.41c.41.39.41 1.03 0 1.42-.39.39-1.03.39-1.42 0a5.003 5.003 0 0 1 0-7.07l3.54-3.54a5.003 5.003 0 0 1 7.07 0 5.003 5.003 0 0 1 0 7.07l-1.49 1.49c.01-.82-.12-1.64-.4-2.42l.47-.48a2.982 2.982 0 0 0 0-4.24 2.982 2.982 0 0 0-4.24 0l-3.53 3.53a2.982 2.982 0 0 0 0 4.24m2.82-4.24c.39-.39 1.03-.39 1.42 0a5.003 5.003 0 0 1 0 7.07l-3.54 3.54a5.003 5.003 0 0 1-7.07 0 5.003 5.003 0 0 1 0-7.07l1.49-1.49c-.01.82.12 1.64.4 2.43l-.47.47a2.982 2.982 0 0 0 0 4.24 2.982 2.982 0 0 0 4.24 0l3.53-3.53a2.982 2.982 0 0 0 0-4.24.973.973 0 0 1 0-1.42z"/></svg></a></li><li class="top"><a href="#dokuwiki__top" title="Back to top [t]" rel="nofollow" accesskey="t"><span>Back to top</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"/></svg></a></li> </ul> </div> </nav> </div>  <footer id="dokuwiki__footer"><div class="pad"> <div class="license">Except where otherwise noted, content on this wiki is licensed under the following license: <bdi><a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license" class="urlextern">CC Attribution-Share Alike 4.0 International</a></bdi></div> <div class="buttons"> <a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license"><img src="/lib/images/license/button/cc-by-sa.png" alt="CC Attribution-Share Alike 4.0 International" /></a> <a href="https://www.dokuwiki.org/donate" title="Donate" ><img src="/lib/tpl/dokuwiki/images/button-donate.gif" width="80" height="15" alt="Donate" /></a> <a href="https://php.net" title="Powered by PHP" ><img src="/lib/tpl/dokuwiki/images/button-php.gif" width="80" height="15" alt="Powered by PHP" /></a> <a href="//validator.w3.org/check/referer" title="Valid HTML5" ><img src="/lib/tpl/dokuwiki/images/button-html5.png" width="80" height="15" alt="Valid HTML5" /></a> <a href="//jigsaw.w3.org/css-validator/check/referer?profile=css3" title="Valid CSS" ><img src="/lib/tpl/dokuwiki/images/button-css.png" width="80" height="15" alt="Valid CSS" /></a> <a href="https://dokuwiki.org/" title="Driven by DokuWiki" ><img src="/lib/tpl/dokuwiki/images/button-dw.png" width="80" height="15" alt="Driven by DokuWiki" /></a> </div> <div style="margin-top: 2em; font-size:90%" class="dokuwiki"><div style="float:right"><a href="http://www.splitbrain.org/personal#imprint" style="float:right; text-decoration: none; color:#333">Imprint</a></div></div> <style type="text/css"> @media screen { body { padding-top: 30px; } #global__header { position: absolute; top: 0; left: 0; text-align: left; vertical-align: middle; line-height: 1.5; background-color: #333; box-shadow: 0 0 8px rgba(0,0,0,0.5); width: 100%; margin: 0; padding: 5px 20px; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; white-space: nowrap; overflow: hidden; } #global__header h2 { position: absolute; left: -99999em; top: 0; overflow: hidden; display: inline; } #global__header ul, #global__header li { margin: 0; padding: 0; list-style: none; display: inline; line-height: 1.5; } #global__header a { color: #bbb; text-decoration: none; margin-right: 20px; font-size: 14px; font-weight: normal; } #global__header a:hover, #global__header a:active, #global__header a:focus { color: #fff; text-decoration: underline; } #global__header form { float: right; margin: 0 0 0 20px; } #global__header input { background-color: #333; background-image: none; border: 1px solid #bbb; color: #fff; box-shadow: none; border-radius: 2px; margin: 0; line-height: normal; padding: 1px 0 1px 0; height: auto; } #global__header input.button { border: none; color: #bbb; } #global__header input.button:hover, #global__header input.button:active, #global__header input.button:focus { color: #fff; text-decoration: underline; } } /* /@media */ @media only screen and (min-width: 601px) { /* changes specific for www.dokuwiki.org */ #dokuwiki__header { padding-top: 3em; } #dokuwiki__usertools { top: 3em; } /* changes specific for bugs.dokuwiki.org */ div#container div#showtask { top: 40px; } } /* /@media */ @media only screen and (max-width: 600px) { body { padding-top: 0; } #global__header { position: static; white-space: normal; overflow: auto; } #global__header form { float: none; display: block; margin: 0 0 .4em; } } /* /@media */ @media print { #global__header { display: none; } } /* /@media */ </style> <div id="global__header"> <h2>Global DokuWiki Links</h2> <form method="get" action="https://search.dokuwiki.org/" target="_top"> <input type="text" name="q" title="Search all DokuWiki sites at once" class="input" /> <input type="submit" title="Search all DokuWiki sites at once" value="Search" class="button" /> </form> <ul> <li><a href="https://download.dokuwiki.org" title="Download the latest release" target="_top">Download</a></li> <li><a href="https://www.dokuwiki.org" title="Read the DokuWiki documentation" target="_top">Wiki</a></li> <li><a href="https://forum.dokuwiki.org" title="Ask questions in the DokuWiki forum" target="_top">Forum</a></li> <li><a href="https://irc.dokuwiki.org" title="Check IRC chat logs or join the chat" target="_top">IRC</a></li> <li><a href="https://github.com/splitbrain/dokuwiki/issues" title="Report and track bugs" target="_top">Bugs</a></li> <li><a href="https://translate.dokuwiki.org/" title="Help translating the DokuWiki interface" target="_top">Translate</a></li> <li><a href="https://github.com/splitbrain/dokuwiki" title="Access the most recent git commits" target="_top">Git</a></li> <li><a href="https://xref.dokuwiki.org/reference/dokuwiki/" title="Cross-Reference of the DokuWiki source code" target="_top">XRef</a></li> <li><a href="https://codesearch.dokuwiki.org/" title="Search through the sources of DokuWiki, plugins and templates" target="_top">Code Search</a></li> </ul> </div>  </div></footer> </div></div> <div class="no"><img src="/lib/exe/taskrunner.php?id=plugin%3Alinkback&1743181202" width="2" height="1" alt="" /></div> <div id="screen__mode" class="no"></div></body> </html>