OrphansWanted Plugin

Compatible with DokuWiki

  • 2012-01-25 "Angua" yes
  • 2011-05-25 "Rincewind" yes
  • 2010-11-07 "Anteater" yes

plugin Find Orphan pages, Wanted pages with reference counts. Also shows reference counts for linked pages (previous authors: Doug Edmunds)

Last updated on
2010-04-11
Provides
Syntax
Repository
Source

Similar to unusedmedias

Tagged with links, listing, orphan, search

Originally by Doug Edmunds, now maintained by Andy Webber.

Description

Use this plugin to find orphan pages and wanted pages.

OrphansWanted show which pages are:

  • Orphans (the page exists, but it has no links to it)
  • Wanted (the page does not exist, but there are link(s) to it elsewhere on the site)
  • Valid (the page exists, and it can be reached through a link)

Each table shows the reference count and a link to backlinks.

Usage

Basic usage is to place the one of the following four lines into the page markup:

 
 ~~ORPHANSWANTED:orphans~~
 ~~ORPHANSWANTED:wanted~~
 ~~ORPHANSWANTED:valid~~    
 ~~ORPHANSWANTED:all~~      << makes all three tables 

Anything other than these 4 words will generate a syntax error message.

Enhanced usage adds optional namespaces, each prefixed with an exclamation point '!' (think 'not')

 
 ~~ORPHANSWANTED:orphans|wanted|valid|all[!namespace!another!one:with:subspaces]~~

Example -- exclude one namespace:

 ~~ORPHANSWANTED:wanted!wiki~~   Shows wanted pages, but none that are under the wiki: namespace

Example -- exclude multiple namespaces:

 ~~ORPHANSWANTED:orphans!wiki!sys:personal~~  Shows orphan pages, but none in the wiki: or in the sys:personal: namespaces  

Version/Requirements

:!: Please check GitHub for most recent version; and please comment on the GitHub version using GitHub 'issues' mechanism. Comments and issues below apply to the code included on the page below.

Changes

Notes

  • I strongly suggest you put ~~NOCACHE~~ on the page where this plugin is used. This helps assure that ACL permissions get applied. Otherwise some other user, with lesser ACL permissions, may see a cached copy of the results.
  • ACL settings are applied first, before any exclusions. Only pages you have permission to view can be listed. To be sure to see everything, login as superuser.
  • Reference counts (number of links) may include pages that cannot be viewed due to ACL settings.
  • It is fast enough for a site with 200+ short pages.
  • If you see something that you think must have a link, check your spelling. If you typed the pagename wrong on the other page, you created a “wanted” page instead of a link to an existing page.
  • Try fixing bad links one by one after you figure out what is wrong. Do this until your orphan/wanted lists are as clean as you need.

Discussion

Please raise bugs and requests for enhancements in GitHub. This page is not routinely monitored, so comments here may languish forever.

Bug

I have Angua RC. I have a lot of php errors:

[phpBB Debug] PHP Notice: in file (...)/public_html/wiki/lib/plugins/plugin/classes/ap_info.class.php on line 21: Undefined offset: 1
[phpBB Debug] PHP Warning: in file (...)/public_html/wiki/inc/actions.php on line 180: Cannot modify header information - headers already sent by (output started at /includes/functions.php:3765)

>Where do you get this? I tried ~~ORPHANSWANTED:all~~ with the current devel version. No warning appears. What are these phpBB prefixes? — M. S.M. S.
lupo49

DE / NRW / Sauerland
2011/12/26 19:25

Simply i turn on this plugin and:
[phpBB Debug] PHP Notice: in file .../public_html/wiki/inc/parser/handler.php on line 1493: Undefined property: Doku_Handler_Block::$inParagraph
[phpBB Debug] PHP Notice: in file .../public_html/wiki/inc/parser/metadata.php on line 321: Undefined offset: 1
[phpBB Debug] PHP Notice: in file .../public_html/wiki/lib/plugins/plugin/admin.php on line 82: Undefined index: fn
[phpBB Debug] PHP Warning: in file .../public_html/wiki/inc/actions.php on line 180: Cannot modify header information - headers already sent by (output started at /includes/functions.php:3826)

I have integrate_with_phpbb3 mod.

The warning message doesn't indicate to an error caused by the plugin. Do you have any other plugins loaded and activated?
Create a bug report for your issue on github to prevent clutter on this page. — M. S.M. S.
lupo49

DE / NRW / Sauerland
2011/12/27 15:17
When i turn off all plugins this bug is still present.
Why ”>” isn't converted in ”>Where do you get this?” above?
plugin/orphanswanted.txt · Last modified: 2011/12/28 02:19 by 83.6.13.61
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 3.0 Unported
Imprint Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
WikiForumIRCBugsGitXRefTranslate