WordPress.org

For developers

WP-dTree exposes the following template tag functions:

• wpdt_list_archives();
• wpdt_list_categories();
• wpdt_list_taxonomies(); //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')){

             <pre><code>wpdt_list_archives('type=yearly&amp;useicons=1');</code></pre><pre><code>}</code></pre><pre><code>?&gt;</code></pre>                   <pre><code>&lt;/div&gt;</code></pre>

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();

They all return associative arrays whith all arguments defaulted.

Other Notes

The original 'WP-dTree' was created by Christopher Hwang in ~2005. By 2007 Mr. Hwang seemed to have dropped of the internet for good so Ulf Benjaminsson forked the plugin in and named it 'WP-dTree 3.0' (note to self: having a release number in the title is stupid).

Ulf's fork was focused on performance improvements - mainly caching - but soon expanded to add a lot of new features and modernizations; compatibility with WP 2.7 through WP 3.3, widgets, out-of-the-box Scriptaculous support, link trees, feed icons and more.

For version 4.0 the entire plugin has been rewritten from scratch by Ulf, bringing it in line with the much matured WP 3.x API and generally being less of a hack. :P

*WP-dTree (3.0 and up) is Copyright (C) 2007-2012 Ulf Benjaminsson (email: first name at ulfben dot com)

*WP-dTree (3.x and lower) Copyright (C) 2006 Christopher Hwang (email: chris at silpstream dot com).

*dTree-JavaScript is Copyright (c) 2002-2003 Geir Landr�

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA