February 20, 2013
Thank you for purchasing my theme!
This documentation will teach you how to use the Darkwhite WordPress Theme.
I provide pretty extensive help in this file, but this doesn’t mean the theme is hard to use. I just want to cover every question that might occur. I also guide you from the installation process through theme specific functions to filling your pages with content.
If questions occur that are not covered by this help file, feel free to ask your question in the comment section of this item.
Have fun with your new theme!
If you are new to WordPress and haven't installed it yet, I recommend to read the official WordPress installation instructions.
If you should have trouble with the theme installation, I recommend to read the official WordPress Theme installation instructions.
Now we can start to fill your site with content and then set up some options for the theme.
Notice: If you plan to have a portfolio page and want demo content inserted for it as well, please install the plugin Ruven Toolkit before you import the demo content.
In the unzipped folder of the file you've got from ThemeForest, you'll find another folder called Demo Content. In there you'll find the file demo-content.xml. Here are the steps to import this file into WordPress, so you can have an easier start:
Notice: If you've never worked with the Menu Manager before, I recommend reading the WordPress Codex Page about Menus.
I highly recommend to create a custom menu for the main navigation, because else, WordPress will automatically add every new page that you create to the main navigation and it can easily "overflow".
To create a custom menu, do the following steps:
As you might have noticed, there is one more location in the panel Theme Locations called Footer. By clicking the + tab you can add more custom menus and add one of them to this location.
Posts, Pages, and Portfolio Items (can be added with the plugin Ruven Toolkit) almost work the same way, but there are some exceptions that I want to point out.
By default all portfolio items are in the Standard format.
This means a post will display a title, meta information (date, author, etc.), a featured image (if set), the posts content, and a comment/pingback section on a selected post.
The other here described Post Formats differ in appearance.
After you select the Gallery format, you'll see the panel Gallery Settings popping up below the content editor. The images added to the gallery will appear in a slider instead of the featured image.
Do the following to add gallery images:
Now, when you open the post on your website, you'll be able to click through all the uploaded images in a slider.
After you select the Video format, you'll see the panel Video Settings popping up below the content editor.
To add a self-hosted video, you need a M4V file and an OGV file.
Paste the URL to these files into the matching fields.
You can also use the Upload File button to upload the videos to your WordPress installation, but note that there is a certain file size limit that you first have to raise in your server settings. The best method is to use an FTP client to upload them.
Please add a featured image to use it as poster for the self-hosted video.
To add an embedded video (e.g. from YouTube or Vimeo), you don't need to fill out the M4V and OGV URL fields. Just paste the "Embed Code" into the Embed Code field.
After you select the Audio format, you'll see the panel Audio Settings popping up below the content editor.
To add a self hosted audio file, you need an MP3 file and an OGA/OGG file. Paste the URL to these files into the matching fields or upload them to your media library by clicking the Upload File button.
Add a featured image to use it as poster for the audio player.
The Aside post format is similar to a Facebook note update. Only your text will be displayed. No featured image, title or meta infos.
When you write a post in the Quote post format, you'll see a panel pop up that let's you enter the quote itself and an optional source.
When you write a post in the Link post format, you'll see a panel pop up that let's you enter the links URL. The posts title will be used as link title.
The Image post format will display only your featured image in the blog overview. That's perfect for posting a photo.
For each page you can set an individual page header with a description text. You'll find the panel to do this below the content editor when you edit a page. If you set no page header, the default text, which can be defined in the Theme Customizer, will kick in.
Category archives will use the category description as text, Tag archives the tag description, and Author archives the user bio.
To disable comments for all new posts and pages, go to Settings → Discussion and uncheck the box Allow people to post comments on new articles.
Please note that this only disables comments for new posts and pages.
The ones you already have need to be disabled manually.
To do this, please follow these steps:
I created the plugin Ruven Toolkit to extend the functionality of my themes. The plugin adds a Portfolio post type, custom widgets, and shortcodes which are editable via shortcode editor.
If you need a contact form on your website, I recommend the free plugin Contact Form 7.
After installing and activating the plugin, go to Contact in your admin panel and create or pick a form to edit it. If you want the form to look like in the themes demo, insert this markup.
To edit the theme settings you have to enter the Theme Customizer. You'll find it linked in Appearance → Themes below the item description of the activated theme or in the admin bar, when you're looking at your site, and hover over the site title.
The customizer offers many layout settings, the option to change the default site headlines, an uploader for an image logo and a favicon, and many more things.
Over are the dark days where you had to modify a themes code directly to make some changes, but then weren't able to update it anymore.
Darkwhite is a robust parent theme, so if you want to change functions, classes or template files, all you have to do is to create a child theme and overwrite the already existing function. This way the original theme stays untouched and you can perform updates without worrying that your code gets lost. I also created a child theme skeleton to make the process even easier for you:
Just upload the ZIP file that is in the theme package folder Child Theme Skeleton the same way as it is stated in the section
Notice: If you've never worked with child themes before, I recommend reading the WordPress Codex page about child themes. Turst me, it's easy to learn and well worth the effort :)
Darkwhite is completely translation ready. In the theme files you'll find a folder called languages. This is where your translation files go. German is already included, but by default the theme speaks english.
Here are the steps to create a translation file for another language:
If you're not sure what country code to use, you can also check it in the file wp-config.php in the WordPress root directory.
Just open the file and search for the line
define('WPLANG', ''); (should be around line 72).
By default (if nothing is set) the country code is en_US, but you can also set it manually, e.g. to
This would, of course invoke the file de_DE.po.
If you have WordPress already installed in the language you've translated your theme to, the translation should kick right in. If it doesn't, make sure to install WordPress in the right language or change the WordPress language manually (as described in the notice box above).
There are two ways to update the theme. You can either the use the Envato WordPress Toolkit plugin and update Darkwhite (and all other ThemeForest themes) through WordPress' admin panel, or you can do it manually by using an FTP client.
Here I describe both ways:
A manual update requires you to re-download and re-install the theme on your WordPress installation. But don't worry. None of your theme settings will get lost (they are stored in the database and not in the theme files).
To get notified about updates, you should add me on your social networks:
Please follow these steps to update the theme:
Notice: If you have ever modified any theme files directly, I assume you have a local copy of them on your computer. If you don't, please login to your WordPress installation via FTP and backup the old theme files, before you remove them from the server. Please note that these modifications will be lost after the update. Child Themes are the right choice to modify theme files without losing the code after an update (you can read about them here).
The theme resizes images by itself when you upload them into the Media Library. Just make sure that the images you upload are at least 728 pixel wide.
To support HiDPI/Retina displays, I recommend to use the WP Retina 2x plugin.
Here is how you use it:
Notice: All images you upload need to have at least the double amount of pixels that is described in the Default Image Sizes section. You can check if the images are big enough by going to Media → Retina 2x. The columns content, portfolio-small, portfolio-big, portfolio-small-cropped and portfolio-big-cropped need to show a green check mark.
If you have any further questions, please use the comment section of this item on ThemeForest. This way other users can benefit from the solution as well. I will try my best to answer every question.
If you're satisfied with the theme and want to show it, you are welcome to log in to your ThemeForest account and rate the theme. You can do this under My Account → Downloads. Just hover over the 5th star and click ;p
Again, thank you very much for purchasing this theme! I wish you all the best for the website that will grow out of it. If you want, you can post the URL of your final website in the comment section of this item on ThemeForest. I would really like to see how this theme takes its place in the world wide web :)