Parent Pages Refactor Add-On

Refactor the structure of your pages in a given wiki web using a draggable/droppable interface. Easy-to-use and fast wapper of TWiki:Plugins/TreePlugin.

Why should I use it?

When the number of pages increases the maintenance os pages become really hard. Changing parents can be painfull yet necessary. Together with TreePlugin this plugin may be useful when organizing the structure.

What stage of development?

Pretty start, but already functional - I mean... starting... everything is working standalone (as the following video), but not yet integrated as a proper plugin or addon. Using ajax, can change parent nodes of a wiki page without problems.

Development

• Using JQuery library and UI package
• Wrapping TreePlugin to attach droppable/draggable functionalities

Demo

Code

The core code can be shown within a few code lines:

• parentRefactorAddon.txt: Copy and Paste this file's content to enable the addon

What needs to be done / risks

• defining setup
• pack as a TWikiAddOn
  • embeded javascript
  • load JQuery library

• although the TWiki access works pretty fine, may be a problem if you have a lot admins with the possibility to keep changing parent nodes
• : changing parent nodes for TWiki related pages may cause problems ?? (WebHome, WebPreferences, etc) (need to be confirmed)

Future Improvements

• Integrate with TWiki:Plugins/TreeBrowserPlugin
• Add more options (create newtopic, rename, move topic)

Credit

• Marcio Marchini - had the idea of integrating drag/drop feature to TreeBrowserPlugin
• Audaces Automação - supported with conceding the working time of VictorHugoGermano to create it
• TWiki:Main/VictorHugoGermano - developer

Add-On Installation Instructions

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

• Download the TXT file from the Add-on Home (see below)
• parentRefactorAddon.txt: Copy and Paste this file's content on a wikipage to enable the addon

• Test if the installation was successful:
  • You will be able to see a navigable tree
  • Tree nodes can be dragged
  • once dropped, the node's parent will be updated using ajax call

Add-On Info

• Set SHORTDESCRIPTION = Add-on to TreePlugin to change parent nodes with drag & drop

Add-on Author:	TWiki:Main.VictorHugoGermano
Copyright:	© 2006, TWiki:Main.VictorHugoGermano
License:	GPL (GNU General Public License)
Add-on Version:	2009-11-18 (V1.000)
Change History:
2009-11-18:	Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.1 (TWiki 4.0)
CPAN Dependencies:	none
Other Dependencies:	TWiki:Plugins/TreePlugin
Perl Version:	5.005
Add-on Home:	http://TWiki.org/cgi-bin/view/Plugins/ParentRefactorAddOn
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/ParentRefactorAddOnDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/ParentRefactorAddOnAppraisal

Related Topic: TWikiAddOns TreePlugin

-- TWiki:Main/VictorHugoGermano - 2009-11-18