1. If upgrading: disable the old version first!
2. Transfer the ‘wp-dtree-30’ folder to the /wp-content/plugins/ directory
3. Activate the plugin through the ‘Plugins’ menu in WordPress
4. Go to the ‘WP-dTree’ under ‘Settings’ to adjust your preferences
5. Go to ‘Presentation’ -> ‘Widgets’ and drag-n-drop the widgets to the relevant section of your sidebar(s)
6. Configure the active Widget to your liking
7. Styling is done through CSS

For developers

WP-dTree exposes the following template tag functions:

• wpdt_list_archives();
• wpdt_list_categories();
• wpdt_list_taxonomies(); //needs testing.
• wpdt_list_menu(); //needs testing
• wpdt_list_pages();
• wpdt_list_links();
• wpdt_list_bookmarks(); //alias for wpdt_list_links

They function a lot like WordPress own wp_list_* functions:

• They take an (optional) query-string or associative array with arguments
• They print by default, but if passed ‘echo=0’ they return the string of markup
• Most of them use the WordPress namesake for generating noscript-content

Here’s an example:

    <div class="dtree">
        <?php
            if(function_exists('wpdt_list_archives')){          
                wpdt_list_archives('type=yearly&useicons=1');
            }
        ?>
    </div>

I’ve tried to keep the same argument-lists as the WordPress “equivalents” but there are some discrepancies: style- and markup related arguments are not applicable to WP-dTree (but gets passed through for the noscript content).
There is also some inconsistency within WordPress, like some methods takes sortby while others takes sort_column. I’ve tried for WP-dTree to accept both but I’m sure I’ve missed a bunch of these cases.

So, to find out what arguments are definetly available grab the default $args:

• wpdt_get_archives_defaults();
• wpdt_get_categories_defaults();
• wpdt_get_taxonomies_defaults()
• wpdt_get_pages_defaults();
• wpdt_get_links_defaults();
• wpdt_get_menu_defaults();

They all return associative arrays whith all arguments defaulted.

(Older entries moved here to clear up the front page)

Changes in v4.4.4 (2019-03-24)

• Updated for PHP 7
• Fixed https support for links in the Links-widget
• Added support to always include parent page in hierarchy when selecting child ID’s.

Changes in v4.4.3.1 (2015-03-20)

• Added support for category-specific archives
• Added support to use description instead of name for taxonomy trees.
• Fixed the sort ordering of archives
• Fixed potential “duplicate entry”-mysql error
• Removed forgotten debug-call.

Changes in v4.4.2 (2015-01-03)

• Better sorting options for posts
• Archives now support Custom Post Types
• Support for Post Types Order (thank you, sydcode)
• Minor bug fixes

Changes in v4.4 (2014-12-22)

• Added support for WordPress’ Menus.
• Added multisite support. (thanks, John Pariseau)
• Added option to set navigation root to the current page or category.
• Fixed broken l10n.
• Fixed a XSS vulnerability. (thanks, Patrick Riggs)
• Replaced all deprecated functions.
• Fixed tons of PHP warnings and notices.

Changes in v4.3.1 (2012-01-11)

• Fixed fallbacks for uninitialized settings: never print wierd output.

Changes in v4.3 (2012-01-01)

• Added: support and widget for custom taxonomies. (needs testing, for sure…)
• Added: configurable open/close links for each tree
• Added: configurable open/close separator for each tree
• Fixed: various PHP errors and warnings.
• Fixed: feed links being wrong
• Fixed: initialization routines
• Fixed: excluding categories from the archive tree
• Fixed: excluding posts from category tree
• Fixed: open/close link separator behavior (only show when both open/close is shown)
• Fixed: link children are sorted correctly
• Fixed: Open to selection supports pagination
• Fixed: Open to selection supports categories again

Changes in v4.2 (2010-10-29)

• Fixed the uninstallation procedure.

Changes in v4.1 (2010-10-23)

• Improved installation to fix database error for some users
• Added: “limit posts” for categories and archives
• Added: error catching – dtree can’t blow up you other scripts
• Building archives is MUCH faster (2 queries total, from 1 per month)

Changes in v4.0 (2010-10-17)

• Completely recoded from the ground up for a much needed code overhaul.
• All previous settings will be lost! Write them down before upgrading.
• Added: support for multiple tree instances
• Added: support for per-tree configurations
• Added: template tags for theme developers
• Added: (optional) noscript for JS-disabled visitors
• Added: uses category descriptions for link titles
• Added: translation support
• Added: optional JS-escape (XHTML, HTML or none) to ease validation
• Added: caching is optional (per instance, to boot)
• Fixed: should properly encode quotes and HTML-entities
• Replaced Scriptacolous with jQuery
• Made truncation optional
• Removed support for WP <2.3
• Removed all CSS-options from admin area
• Removed all non-essential CSS-rules
• Only load jQuery if animation is on
• Minified JS and CSS (9KB vs. 16KB!)
• Cache is created on site visit (faster admin, less server load)

Known issues in 4.0:

• This is a true .0 release – please explore and play with all the settings. Let me know when something breaks (provide links!).
• Only tested in Chrome
• opentoselection doesn’t handle paging

Changes in v3.5 (2008-11-26)

• New option: “shut down unused trees” (performance!)
• New option: “force open to”
• New option: per-tree truncation setting
• New option: custom sort order for archives
• New option: custom sort order for posts in categories
• New option: exclude posts from category tree
• New option: more CSS options avaliable from the admin
• Added: widget preview in the admin area
• Added: link target attributes in link tree
• Added: path defines to support non-standard WP-installations
• Added: uninstall.php for nice WP 2.7 plugin cleanup.
• Fixed: include sub-categories when counting posts
• Fixed: “close same level”
• Fixed: Quotes “” in titles breaks alt-texts
• Fixed: Nestled cats get excluded if parent is empty
• Fixed: RSS-icons don’t show in IE
• Fixed: Unwanted spacing in IE
• Misc: improved admin screen feng-shui.
• Misc: Moved config screen to “settings”-section of admin
• Misc: CSS should be a bit more robust now

Changes in v3.4.2 (2008-10-19)

• Bug: incorrect WP version detection. (thanks: StMD)

Changes in v3.4.1 (2008-07-20)

• Validates: both CSS and XHTML 1.0 Transitional (thanks: ar-jar)

Changes in v3.4 (2008-07-12)

• Added support for link trees. (needs testing!)
• Fixed breakage in WP 2.5, 2.6
• Fixed invalid XHTML output. (props: jberghem)
• Fixed a CSS-issue. (props: wenzlerm)
• Renamed the dTree script to avoid collisions with plugins using an unmodified version.

Changes in v3.3.2 (2007-11-26)

• Fixed bug with excluding multiple categories.

Changes in v3.3.1 (2007-11-02)

• Removed redundant li-tags from widgets. (props: Alexey Zamulla)
• Support for non-ascii characters. (props: michuw)
• Properly encoded ampersands (&) in javascript URLs.

Changes in v3.3 (2007-10-26)

• Optimized the dtree script, up to 40% less data required to feed the script. Using dTree now generates less markup than normal HTML.
• New option: Show RSS icon for archives
• New option: Show post count for archives
• Fix: Open to requested node
• Fix: images URL not working on some servers (props: Zarquod)
• Fix: somewhat more IE compatible…

Known issues: RSS icons wont show in IE if post count is on.

Changes in v3.2 (2007-10-15)

• Support for WP’s bundled scriptacolous library! (turn effects on in the WP-dTree options page)
• New cache structure reduces cache size with ~33% compared to previous implementations.
• New option: Show RSS icon for categories
• New option: Show post count for categories
• New option: Effect duration

Regressions: open to selection is broken again. It’ll be back in the next version, but if it’s vital for you, stay with 3.1

Changes in v3.1: (2007-10-06)

• Updated to comply with WordPress 2.3’s new taxonomy tables for categories.
• Widgetized! You no longer need to edit your sidebar manually.
• Fixed “Open To Selection”-option.

Changes in v3.0: (2007-08-17)

• Forked from the dead WP-dTree 2.0
• Added caching. The plugin creates the trees (only) when blog content changes, instead of creating them on every visit. Displaying the front page on the dev site went from 411 queries to 18. 🙂