Compatible with DokuWiki
The linkback plugin adds Trackback and Pingback 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
It should be noted that the badbehaviour library which is incorporated into the badbehaviour plugin does not seem to be very friendly to anything remotely resembling a trackback or a pingback1) and thus will probably lead to the linkback plugin not working as intended. I'll try to look into it though.
In order to send linkbacks from a wiki node, activate the corresponding checkbox in the editform.
The receiving and display of received linkbacks is handled by the syntax plugin. The following commands are recognized:
~~LINKBACK~~
: Receive and display linkbacks.~~LINKBACK:closed~~
: Display already received linkbacks but don't receive new ones.~~LINKBACK:off~~
: Neither receive nor display linkbacks. Use this to disable linkback support in an already linkback-enabled wiki node.The linkback plugin introduces three new events to allow for extension of its antispam-mechanisms by action plugins. These events are:
Name | ACTION_LINKBACK_RECEIVED |
---|---|
Data | $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. |
Action | Sets the show property of the received linkback to the value defined in the event's data and then saves the linkback. |
Preventable | yes |
Signalled | by exe/trackback.php and exe/pingback.php before saving the new linkback |
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.
Name | ACTION_LINKBACK_HAM |
---|---|
Data | the linkback data |
Action | none |
Preventable | no |
Signalled | by the handler of the Report as Ham button of the linkback-listing (action/display.php ) |
In order to report a linkback as ham (e.g. to antispam plugins using classifiers), action plugins can register for this event.
Name | ACTION_LINKBACK_SPAM |
---|---|
Data | the linkback data |
Action | none |
Preventable | no |
Signalled | by the handler of the Report as Spam button of the linkback-listing (action/display.php ) |
In order to report a linkback as spam (e.g. to antispam plugins using classifiers), action plugins can register for this event.
Each linkback item is represented as a hash which stores the following properties:
lid
– internal id of the linkbacktitle
– titleurl
– urlraw_excerpt
– small excerpt of the linking page (exactly as received in the linkback)excerpt
– small excerpt of the linking page (html tags stripped)blog_name
– name of the linking pagefavicon
– url of the linking page's favicon, or false if none could be foundreceived
– timestamp of the date the linkback was receivedsubmitter_ip
– ip of the submittersubmitter_useragent
– useragent of the submittersubmitter_referer
– referer of the submittertype
– type of the linkback, can be either trackback
or pingback
show
– 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.Please don't report any bugs or feature requests here but instead use the bug tracker!