admin_tool1Add my vote for this tag linking1Add my vote for this tag navigation1Add my vote for this tag visualization1Add my vote for this tag create new tag
, view all tags


Find orphaned topics and topic reference counts


This plugin is used to help find orphaned topics. It can also be used to count the number of references to a particular topic.

Syntax Rules

  • Lists are generated with the following:
    • %TOPICREFERENCELIST{"(argument)" [web="webname"]}%

Argument Description
orphans Show all topics with a ref count of 0 (default if you used %TOPICREFERENCELIST{}%)
hasref Show all topics with references (excluded orphans)
all Show all topics for the web and their reference counts (e.g. number of times a topic is referenced from another topic)

Syntax Examples

  • List orphaned topics
    • %TOPICREFERENCELIST{"orphans"}%

  • List orphaned topics in a different web
    • %TOPICREFERENCELIST{"orphans" web="MyWeb"}%

  • List topics with references (non-zero)
    • %TOPICREFERENCELIST{"hasref"}%

  • List all topics and reference counts

Rendered Example, Orphans in the Main web

Plugin output (simulated):

Plugin output (if enabled):

%TOPICREFERENCELIST{"orphans" web="Main"}%

Used syntax:
%TOPICREFERENCELIST{"orphans" web="Main"}% 

Plugin Settings

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Find orphaned topics and topic reference counts

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.

  • Download the ZIP file from the plugin web (see below)
  • Unzip TopicReferencePlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/TopicReferencePlugin.txt Plugin topic
    lib/TWiki/Plugins/TopicReferencePlugin.pm Plugin Perl module
  • Configure the plugin:
    • Run the configure script to enable the plugin
    • Change the Plugin settings as needed
  • Test if the installation was successful (verify rendered example above)

Plugin Info

Plugin Author: TWiki:Main.JeffCrawford
Copyright: © 2006, TWiki:Main.JeffCrawford
© 2006-2010 TWiki:TWiki.TWikiContributor
License: GPL (GNU General Public License)
Plugin Version: 2010-11-09 (V1.002)
Change History:  
2010-11-09: TWikibug:Item6530: Doc improvements
2006-04-19: Changed name of plugin (formerly OrphanFindPlugin), modified for better speed and added default, added web option
2006-04-15: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.1
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
Benchmarks: GoodStyle 99%, FormattedSearch 99%, TopicReferencePlugin 58%
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/TopicReferencePlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/TopicReferencePluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/TopicReferencePluginAppraisal

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 TopicReferencePlugin.md5 r6 r5 r4 r3 r2 manage 0.2 K 2010-11-10 - 02:00 PeterThoeny  
Compressed Zip archivetgz TopicReferencePlugin.tgz r6 r5 r4 r3 r2 manage 4.8 K 2010-11-10 - 02:00 PeterThoeny  
Compressed Zip archivezip TopicReferencePlugin.zip r9 r8 r7 r6 r5 manage 6.2 K 2010-11-10 - 02:00 PeterThoeny  
Unknown file formatEXT TopicReferencePlugin_installer r2 r1 manage 3.4 K 2010-11-10 - 02:00 PeterThoeny  
Edit | Attach | Watch | Print version | History: r17 < r16 < r15 < r14 < r13 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r17 - 2013-10-16 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.