WordPress.org

Advanced Installation

1. Use the database cache. Go into the Darkroom settings and turn on both "Use Database Cache" and "Create/Recreate Database Table". If you only turn on the first option, it will automatically turn-off because there is no database table to use.

2. Use a sidebar. Turn-on the Darkroom setting for Use Sidebar for Navigation. Then, put the following code in your sidebar.php file in your theme: <?php darkroom_sidebar(); ?>.

   There are several parameters available for this function: darkroom_sidebar($include_timestamps = TRUE, $head_name = ëPicture Galleriesí, $is_item = TRUE, $title_before = ë<h2><em>í, $title_after = ë</em></h2>í, $list_class = ëcategoriesí)

   1. $include_timestamps - whether to include the timestamp for each collection in the list in the sidebar. This doesnít work well with all themes.
   2. $head_name - the title of the sidebar menu.
   3. $is_item - whether the sidebar entries should be surrounded in a
   4. tag. This varies from theme to theme.
   5. $title_before - this is what to put before the sidebar heading/title.
   6. $title_after - this is what to put after the sidebar heading/title.
   7. $list_class - this is the class to make the sidebar list, which may vary from theme to theme.

   Once you get the sidebar working, you may want to supress some of the other sidebar content. Also see ìCustomize Your Theme,î below, for the functions you can use to do this.

3. Enable the footer. First, put the following code in your footer.php file in your theme: <?php darkroom_footer(); ?>.

   There are two parameters available for this function: darkroom_footer($before=î, $after=í<br />í).

   1. $before - this is what to put before the footer text.
   2. $after - this is what to put after the footer text.

4. Customize your theme. There are two approaches:

   1. Use the WordPress is_page() function. For example, my page is called pictures so I could write test against is_page(ípicturesí).
   2. Use the Darkroom function is_darkroom(). This function does not take any variables.

   For example, most themes include the page name at the top of the page. This just messes up the flow of Darkroom. You could change a line in your themeís page.php to read something like this: <?php if (!is_darkroom()) { ?><h2> <?php the_title(); ?></h2><?php } ?>