Berlin is a unique, minimal and modular theme for WordPress 2.3 and higher that maximizes the homepage real estate by using AJAX. The main story section contains four of your latest posts layered on top of each other, accessible via navigation. Berlin can transform your tubular blog into a full news magazine website.


  1. Unzip the downloaded file
  2. Upload the entire “Berlin″ folder to your “/wp-content/themes/” folder
  3. Log in into your WordPress control panel
  4. Click the Presentation tab
  5. Select the “Berlin” screenshot


  1. GETTING STARTED: To get Berlin off and running, you will need a minimum of 9 categories to populate the homepage. The main section on this page is the latest article posted in category 1. The top right section is the three latest posts from category 8. The middle two sections are the latest three posts from categories 4 and 7. The bottom five section pulls the latest posts in categories 3, 4, 5, 6, 7. You will want to change these category number id’s to the categories you want to display, which is detailed below.
  2. YOUR CATEGORIES: In the “home.php” you will find a series of query_posts functions which refer to specific category ID numbers from my database.
    You will need to change the category numbers to reflect the ID numbers of the categories that you want to display on your homepage. Category numbers can be found in your control panel under Manage->Categories. There are a total of 9 spots in the home.php file to change to reflect the post categories that you want to display on the main page.
  3. YOUR PHOTOS: If you want your website to resemble that of the Berlin theme demo site, you will need one photo, cropped to two different sizes, for each blog post. Small photos should be cropped to 150px wide by 100px tall. Big photos should be cropped to 575px wide by 300px tall. Upload both images to the web and copy the URL to the photos. Within WordPress’ Write Post page, scroll down towards the bottom and click on the Custom Fields section. Add a key called “small_photo” and then paste the link to the small photo into the key value field. Next, add a key called “big_photo” and then paste the link to the big photo into the key value field. View a screenshot of the custom fields used for the Berlin theme for WordPress. Make sure your custom field values and keys match those in the screen shot above (but change the key value to the exact url to your images.) Custom fields are one of the most overlooked, yet powerful, tools in WordPress. Read more about using custom fields. Photos posted within each entry’s post body will not show on the homepage since the homepage only displays post excerpts and custom field content. Photos posted within each entry’s post body will display on each post’s individual entry page. These photos should not exceed 590 pixels wide, otherwise, the images will bleed out and make you site look icky.
  4. YOUR AUTHORS PAGE: Berlin comes packaged with an author archive (authors.php), which will display some author specific info pulled from the Users page in your WordPress installation. In order for the author’s image to show up, you’ll need to place a jpg of the author titled by the author’s last name in the wp-content/themes/gridline/images/authors/ folder. For instance, mine is named Allender.jpg and is sized at 75px X 75px.
  5. STYLES.CSS: Unlike most WordPress themes which plug all the css in one file called styles.css, Berlin utilizes the Blueprint CSS framework to help separate positioning, typography, forms and what I’ll refer to as custom or gridline specific styles. To edit all custom gridline specific styles, you’ll need to edit the style.css file located in your wp/wp-content/themes/gridline/ directory.
  6. BEST PRACTICES: It is best to keep your excerpt to one a one line description overview of your post. Having too much written in the excerpt field can bloat the homepage with text.
  7. COMMON PROBLEMS JQuery, the javascript framework used in Berlin, and Prototype, the javascript language that powers some WordPress plugins, don’t like each other. To create a pleasant user-experience, deactivate all plugins that use the Prototype javascript framework.

12 responses to “Berlin”

  1. FilOu Avatar

    Thanks for this new themes 😉

  2. MH Avatar

    By far your best theme yet!!!

  3. List Avatar

    Great theme – as I do understand the main 4 story pictures are not rotating, right? Would be a nice additional feature I think!

  4. admin Avatar

    @List: That is easy to do. Here are some options:

  5. sienna Avatar

    Great theme!
    But if enlargeing the web page by browser , the position of 4 feature pictures cannot be on the relative place.
    How to edit the css files to adjust it?

  6. Bethany Avatar

    Right, then… I registered here as a “freebie”, and even when the site indicates that I’m logged in I can’t figure out how to download a theme. Help?

    1. Bethany Avatar

      Ok, nevermind! I found it. -_-

  7. Megan @IrishJaunt Avatar

    We LOVE your theme and are using it for our new travel website. However, I can’t seem to find anywhere in the Read Me files about inserting advertising into the space. Can you give some feedback on that? I’d like to join your affiliate program and put your link in there.

  8. Loria Boughamer Avatar

    Hey, I found this post while searching for help with JavaScript. I’ve recently switched browsers from Chrome to Firefox 3.2. Now I seem to have a issue with loading JavaScript. Every time I browse page that requires Javascript, my browser does not load and I get a “runtime error javascript.JSException: Unknown name”. I cannot seem to find out how to fix it. Any aid is very appreciated! Thanks

  9. Jen Avatar

    Is the big_photo really supposed to be cropped to 575 x 300? The page source of the demo shows the image is 590 x 400… just want to be clear before editing all of my photo archives

    Thanks for the fantastic theme!

  10. snowlion Avatar

    Yes, I am also curious about the dimensions of the images — none of the sizes (575×300 and 150×100// 590×400 and 150×150) that I have found listed here or on the page source of the demo blog work. Any suggestions?

    1. Jen Avatar

      There is a more detailed discussion of image sizes in ‘instructions.html’ (found in the theme download package). With WP 2.9 and later you actually don’t need to create special thumbnails or crop your images to a certain size (575×300). Instead, you set default image sizes in the settings portion of your WP install, and the theme uses WP functions to get images of the proper size. Note, the information above re: photos conflicts with what is in ‘instructions.html’

Leave a Reply

Your email address will not be published. Required fields are marked *