Instructions


Berlin is a minimalist magazine-style theme for WordPress. You need to have WordPress 2.9 or above installed on your server for this theme to work properly. Subscribe to Graph Paper Press' feed or follow us on the bleeding edge of development by following us on Twitter.

Here is a brief list of the major features:

Best Practices

If you want to make changes to how this theme looks and feels, than create a child theme. Never make changes to the original theme files. Why? Because when a new version of this theme is released, all of your changes will be lost when you update. Plus, making a child theme is incredibly easy. Here is how you do it.


  1. Installation

    1. Unzip the folder contained in the archive to your computer
    2. Upload the folder and its contents to the themes directory of your blog, located in "wp-content/themes" where WordPress is installed.
    3. Click on Appearance - Themes menu from the WP admin panel, then select the theme to activate.
    4. Click on View Site at the top of the page. Bam. Hot site!
  2. Initial setup

    Berlin is a 950px wide, two column theme. We need to set up your default image and thumbnail sizes to allow for easy posting and consistent design structure. Click Settings - Media and set your thumbnail size to 150px wide by 150px tall. Set your medium size images to 590px wide. Do not set a height. Set your large size images to 950px wide. Do not set a height. Post thumbnails are generated automatically by the functions contained in this theme. This theme uses the new Post Thumbnail feature available in WordPress 2.9. Read more about this new feature here. If you need additional instructions on uploading photos, inserting photo galleries and using the Wordpress interface, please view this screencast.

  3. Thumbnails

    By default, thumbnails are auto cropped by Wordpress. You can override these crops in WordPress 2.9. This is the order in which the theme attempts to grab an image to use as a post thumbnail:

    1. Looks for an image by custom field called "thumbnail".
    2. If no image is added by custom field, it checks for a post image (WordPresss 2.9+ feature).
    3. If no image is found, it grabs the latest image attached to your post using the Add Media icon.
    4. If no image is attached, it can extract an image from your post content (off by default).
    5. If no image is found at this point, it will defer to a default image.
  4. Homepage category configuration

    Berlin makes use of custom queries to pull in various posts from categories that you specify in code. To configure the categories you would like to have appear in each content region on the homepage, open up home.php in a text editor, like TextEdit, Coda, or NotePad, and locate lines 18, 38, 51, 67, & 96. Change the cat=1 to the specific category ID's of your choosing. Here is how you find your category id's.

  5. Navigation

    The navigation contains a link to your homepage, about page, archive page, and RSS feed. First, visit Settings -> Permalinks and change it to Day & Name. Second, create a page called "About." Third, create a page called "Archive" and assign it the Page Template "Archive." You can add or remove links be opening header.php and changing lines 54-58.

  6. Widgets

    There are a total of three widgetized areas on this theme, depending on which options you activate on the Theme Options panel. Three widgetized areas appear on the bottom and there is one sidebar widget. You can add and delete widgets by clicking Design - Widgets, from within your Wordpress admin panel.

  7. Advertising

    This theme has a built-in spot for advertising on the homepage. You can add your adversing code by editing line 85 on home.php. You can also add more advertisements using Widgets.

  8. New WordPress 2.9 Features

  9. Common problems

    This theme uses jQuery javascript to do lots of fancy stuff. If your theme looks broken, than you likely have a plugin that uses a conflicting javascript library. Deactivate your plugins, one-by-one, to determine which plugin is conflicting with jQuery.

    Still having trouble? Consider becoming a member of Graph Paper Press so you can get access to our private, well-groomed support forum, tutorials, and additional themes.

  10. Recommended plugins

    • Fancybox: The best lightbox plugin available, currently seen on Apple.com.
    • WP Super Cache: This plugin generates static html files from your dynamic WordPress blog. After a html file is generated your webserver will serve that file instead of processing the comparatively heavier and more expensive WordPress PHP scripts.
  11. Credits