====== mediamanager.php ======

===== Introduction =====

The media manager's functionality has changed drastically since the last major release of DokuWiki; however, the code in the background is only slightly different, and requires that you use CSS or table based layout.

===== Minimum Requirements =====

==== Functionality ====

For minimum functionality, you'll need to use a tag with an id of **%%media__manager%%** encapsulating an empty **div** tag pair with an id of **%%media__opts%%**.

Finally, you'll need to call **tpl_mediaTree()** in order to display the tree, and **tpl_mediaContent()** to display the files to select from.

==== Look and Feel ====

Luckily all style information for media manager is in the standard location for stylesheets, with the prefix of "**%%media__%%**"; copy those into your own stylesheets and you should be fine.

Of course for customization purposes you may wish to modify the default styles.

===== Sample Code =====

Here is sample code used in the [[:template:monobook#monobook|Monobook template]]; it uses a table instead of pure stylesheets layout approach as the latter uses absolute positioning, which doesn't fare so well in a non-default template.

So if you use this method, it may be best to disable absolute positioning in the CSS portions.

<code php>
<div id="media__manager" class="dokuwiki"><br/>
<table border=0 width=100% cellpadding=0 cellspacing=0><tr><td align="left" valign="top" id="media__left">
	<h1><?php echo hsc($lang['mediaselect'])?></h1>

	<?php /* keep the id! additional elements are inserted via JS here */?>
	<div id="media__opts"></div>

	<?php tpl_mediaTree() ?>
</td><td align="left" valign="top">
	<div id="media__right"><?php tpl_mediaContent() ?></div>
</td></tr></table>
</div>
</code>

Alternatively, you may also use div tags, but you may find that it positions incorrectly if you wish to "theme" the media manager.

//Initial Version// --- //[[tjgrant@tatewake.com|Terence J. Grant]] 2006-12-02 11:18//