Today we have an absolute monster of a WordPress theme, designed by Nuvio Templates, and ported into WordPress by me. There are 9 different color choices, optional Gravatar display on comments, WordPress tag support on single post pages, 4 widget-ready sidebars, and a very cool homepage layout. There are a few important things you need to know while using this theme, which will be gone over below.

Miniml screenshot
Live Demo | Download

And now on to the features in depth…

Config Page

This theme file is where you can configure a few settings:

  • Color scheme (aqua, red, green, orange, black, purple, yellow, blue, pink)
  • Featured category ID (displayed on homepage and default)
  • Tagline display (0 for off, 1 for on (default)
  • Gravatar display (0 for off (default), 1 for on

Miniml Config

Featured Image

To set a featured image for the top story on your homepage, use the topstory_image custom field key with the image name as the value. The image will have to be stored in the topstory-images subfolder in the theme directory.

Miniml Featured Image

Category Display

In order to configure which categories are displayed on the homepage, you’ll have to enter a comma separated list of category ID numbers in the home.php file. At the moment, the code looks like this:

<?php /* THIS IS WHERE YOU INPUT THE ARRAY OF CATEGORY IDs */
$cats = array(5,3,4,4,5,3);

You would need to change these numbers to match your WordPress blog’s categories.

FlickrRSS Support

If you have the FlickrRSS plugin installed and activated, a set of pictures will be displayed on your homepage. The demo is currently set up to display the 5 latest images in thumbnail form.

Category Images

You will notice included in the theme are a set of category images, which are displayed under the category name on the homepage. These are stored in the /cat-images/ directory in cat-ID.gif format, with “ID” as the category ID number. You will probably want to replace these with better looking images, or remove them from the loop.

Category Descriptions

You’ll also notice on the demo, next to the category images, a description of the category. This category description can be configured in your WordPress administration panel, in the Manage → Categories menu.

Miniml Category Description

Whatever you enter as your category description will be displayed on the homepage.

Conclusion

That should be pretty much everything. I know this theme may be hard for people to use who aren’t comfortable with editing code. If you’re confused about anything, don’t hesitate to let me know in the comments. I’ll also be available to answer questions in the forums. This is probably the most complicated theme I’ve ever done, so any feedback would be greatly appreciated.

Subscribe to RSS

By: Leland on Aug. 14

Bookmark and Share

97 Comments »

Comment by ThemeLib.com
2008-08-14 12:35:06

Excellent! It looks like a premium theme :)

 
Comment by Leland
2008-08-14 12:54:08

@ThemeLib.com: Thanks for the comment! Do you think it’s possible to port to Blogger? Maybe not the homepage, but the category layout here: http://demo.themelab.com/?cat=3

 
Comment by ThemeLib.com
2008-08-14 13:54:11

I guess I can. Hmmm … do you think it is too white, Leland ?

 
Comment by Leland
2008-08-14 15:31:37

@ThemeLib.com: Yes, it is a very light theme. Although it seems minimalistic themes like this are usually very open to customization through CSS. Thanks again for the comment.

 
Comment by Anto Subscribed to comments via email
2008-08-14 16:13:35

So it has finally been released! Thank good.

Such a simple and neat theme. Nice port Leland.

 
Comment by Pangeran Subscribed to comments via email
2008-08-15 02:34:24

So it is?
Wahahaha…
I’m downloading this… For use of next project…
Keep it up Leland…
You are my mark line…

 
Comment by Leland
2008-08-15 06:48:47

@Anto: Yup, finally! I’ve been working on this one for a while.

@Pangeran: Thanks, glad you like it.

 
Comment by saaiiaa
2008-08-15 11:37:11

To set a featured image for the top story on your homepage, use the topstory_image custom field key with the image name as the value. The image will have to be stored in the topstory-images subfolder in the theme directory.!!!!!!!

doesnt work,,,

help

 
Comment by Leland
2008-08-15 11:40:06

@saaiiaa: Can you be more specific please? Is there a broken image?

 
Comment by Amanda
2008-08-15 23:02:10

This theme is so fantastic and so easily customizable. For such a potentially complex theme, you’ve really put it together so thoughtfully. Very much appreciated!

 
Comment by Leland
2008-08-18 07:58:23

Thanks Amanda! I appreciate the feedback.

 
Comment by sdave
2008-08-18 12:50:21

Hey, great theme.

is it possible to add skyscraper ads on the side?
if so, how would one go about doing this?

thanks again

 
Comment by Leland
2008-08-18 13:04:00

@sdave: Sure you can. Are you talking about the subpages (i.e. not the homepage)? If so, you could either edit the sidebar.php file to place the ad code there, or use a text widget.

 
Comment by sdave
2008-08-18 17:09:50

Thanks that works!

one more question:
I don’t know if its a bug or not, but when you write a new post and you dont or break ( just keep writing)
when you publish it, it does not format it inside the post box correctly.
is it just my setup, or does anyone else get this?

 
Comment by Leland
2008-08-18 17:36:13

@sdave: Can I see a link to what you’re seeing? I’m not really sure what the problem is.

 
Comment by sdave
2008-08-18 18:00:12

sorry, its on my local box. dont have a hosting server till later on.

I guess you can do this.
Create a post, copy and paste a random sentence until it goes far enough (horizontally) that the slider appears at the bottom. when you publish it, it displays the text outside the box on the subpages.

(hope that makes sense)

 
Comment by Leland
2008-08-18 19:00:56

@sdave: Oh, I understand. Anyway, I see the problem…I’m not sure how to fix it though besides putting a space in the sentence you describe.

 
Comment by glu
2008-08-20 00:51:14

love the theme. looking to use it for a big tech news site. however i need to remove the category thumbnails and the featured post and have it function more like a regular blog.

 
Comment by Reza Subscribed to comments via email
2008-08-20 08:02:00

Hi there nice theme you made thanks altho I’m having some issues about it

In order to configure which categories are displayed on the homepage, you’ll have to enter a comma separated list of category ID numbers in the home.php file. At the moment, the code looks like this:

<?php /* THIS IS WHERE YOU INPUT THE ARRAY OF CATEGORY IDs */
$cats = array(5,3,4,4,5,3);

You would need to change these numbers to match your WordPress blog’s categories.

I can’t seem to find this code in the home.php file

 
Comment by Leland
2008-08-20 11:21:57

@glu: Sounds great! You’ll need to cut out some code from the home.php file. Basically everything in the top “box” div. You might as well remove the flickrrss code as well. To remove the category images, remove the following:

<img src="<?php bloginfo('template_url'); ?>/cat-images/cat-<?php echo $catz; ?>.gif" width="100" height="75" alt="" class="f-left" />

@Reza: The code is there, near the middle. Maybe try pressing CTRL+F to find the text?

 
Comment by Reza Subscribed to comments via email
2008-08-21 02:49:34

thanks I found the code now all’s left is to edit the sidebar and replace the header with the company logo

where are the codes for the header text and logo??

 
Comment by Eric Subscribed to comments via email
2008-08-22 16:35:58

I really like this template, but when I apply it to my Wordpress site hosted at Yahoo (running WP 2.04) all I get is my blog title at the top and a completely empty page. Do I need to upgrade the blog to use this theme?

 
Comment by Leland
2008-08-22 16:38:37

@Reza: Look in the header.php file.

@Eric: I don’t test my themes pre-2.3. The latest version of WordPress is now 2.6.1. So yes, you need to upgrade.

 
Comment by Adam C Subscribed to comments via email
2008-08-26 14:26:54

Seems there is a bug with the homepage template with IE6.

Haven’t worked out exactly what yet, but none of the main center content appears, so you only get the header, horizontal nav and footer.

Shame, as I was close to going live with this.

 
Comment by Adam C Subscribed to comments via email
2008-08-26 14:35:15

OK - a rough and ready fix. I’ve not validated the code, but it worked!

Remove or comment out these lines at the top of the home.php file:

They are duplicated in the header.php and seem to have accidentally been left in here.

 
Comment by Leland
2008-08-26 14:45:03

@Adam: Thanks, could you put the code in between <code> </code> so I could see what you mean?

 
Comment by Adam C Subscribed to comments via email
2008-08-26 14:52:51

Sure…


<div id="content" class="box">

<div class="box">

also changed this line from

<?php if ( get_post_meta($post->ID, 'topstory_image', true) ) { ?><p><img src="<?php bloginfo('template_url'); ?>/topstory-images/<?php echo get_post_meta($post->ID, "topstory_image", $single = true); ?>" width="200" height="150" alt="" class="f-left" /><?php } ?></p>
<?php the_excerpt(); ?>

to

<?php if ( get_post_meta($post->ID, 'topstory_image', true) ) { ?><p><img src="<?php bloginfo('template_url'); ?>/topstory-images/<?php echo get_post_meta($post->ID, "topstory_image", $single = true); ?>" width="200" height="150" alt="" class="f-left" /></p><?php } ?>
<?php the_excerpt(); ?>

subtle change to the closing paragraph tag.

Comment by fm100 Subscribed to comments via email
2008-10-06 11:35:56

Leland,
Can you put all of the HOME.PHP here? I still can’t solve the problem following Adam’s instruction.Many thanks!

 
 
Comment by Leland
2008-08-26 15:51:43

Oh wow, I don’t know how I missed those before releasing. I would’ve thought the XHTML validator would’ve picked that up.

Thanks very much for the comment, Adam. I’ll be releasing an updated home.php shortly, with those fixes.

Comment by fm100 Subscribed to comments via email
2008-10-06 11:49:20

Thank you leland. I solve my problem.

 
 
Comment by Nicola
2008-08-27 04:41:25

This theme is amazing, really thanks Leland!
And thanks to Adam for IE problem, it works well now.
I’m trying to customize it for my use, but i have some problem as i am a novice in wordpress!
I have one featured post that i want to show always, but not also with other post…in other word i don’t want to create a duplicate of the post in the home page. I tried the code from wordpress’ guide about “the loop” but i can’t. Can someone help me?
I also want to align the Featured Articles on the side bar at the same height of the upper violet border on the post title, how can i?

Thanks and sorry for my bad english.

you can see my blog clicking my name

Nicola

 
Comment by Nicola
2008-08-27 06:16:05

i also have some trouble with the footer, i don’t know what i changed…
any help will be appreciate!

Nicola

 
Comment by Nicola
2008-08-27 18:57:09

i’ve changed a lot and solved a lot of problem.
i don’t help anymore (i hope so).

 
Comment by Susan
2008-08-30 10:25:03

It’s a bit light - It would be great to have some background color.

 
Comment by bushuang
2008-08-31 04:58:24

It looks like a great theme. Could give a few pointers on how to render the theme interface into other languages? Is it supported anyway?

 
Comment by Leland
2008-09-01 08:24:52

@Nicola: Glad you got it working.

@Susan: Maybe with a few CSS edits the theme could have some background color? I may make some child themes of Miniml to accomodate this.

@bushuang: I’m not really sure. At the moment it is in English, but it is not “localized” right now. This post has some good tips: http://justintadlock.com/archives/2008/06/17/protecting-text-strings-from-theme-upgrades

 
Comment by bushuang
2008-09-01 09:52:36

@Susan@Leland,
Maybe what Susan meant is that a distinct background color embracing the index/home page contents. My guess.

 
Comment by liz
2008-09-07 14:20:58

Leland,

I really love this theme and find it perfect for my project. I am comfortable editing code, but am not an expert. I am having some issues…

First and foremost, none of my content is showing up on the front page. is this the problem with the duplicate code that adam c described? Perhaps it is related to my other problems with the categories…

my category titles and descriptions are not showing up. in fact, when i edit the categories, i’m not even sure which cat #s correspond with which category titles. where can i put that info in the code so that they will be shown on the home page?

your tutorial shows a screenshot of a menu under the “featured image” section. i’m using the latest wp version and cannot find that form. where can i access it?

finally, is it possible to get the images from the featured post to show up in the featured post box on the front page?

thanks for the help! this one looks great.

 
Comment by liz
2008-09-07 14:28:24

oh, also:

i’m not proficient in php, so its confusing me a little. how can i insert my logo at the top instead of the title of the blog?

thanks again!

-liz

 
Comment by Leland
2008-09-09 05:02:44

@liz: Sorry for the delay in responding.

The content on the front page is for single posts, not pages. To get the category ID you have to hover over the link in your WordPress admin panel and look at the number in the status bar. More info here.

To use the featured image is in the “custom fields” menu on the write post page. You may need to click it for it to become expanded.

To insert your logo you should just be able to use an tag wherever you want in your header.php file.

 
Comment by liz
2008-09-09 07:57:24

@leland,

thanks so much! much better.

-liz

 
Comment by Matthew Subscribed to comments via email
2008-09-10 01:45:29

Hello, great theme. I am using it on my site westburydiagnostics.com. I am having a problem also with the categories. Several questions: (1) In your example you use an array of 6 numbers, but only call the digits 3,4,5. Should I use the digits 1-6 for 6 categories? How do I control which digit corresponds to which category? I believe 1 refers to the ‘bas’ category which cannot be removed. (3) How do I control the order of the categories on the bottom , since I can’t seem to give any category a specific item number. Currently I have six categories, but only 5 are displaying, category 2 is displayed by only a box. I found that it is possible to display only 3 categories by calling on 3 digits in the array. Also, you can repeat categories by calling a number twicce. Thanks,
Matt

 
Comment by Matthew Subscribed to comments via email
2008-09-10 01:46:55

How do I remove meta from the sidebar?

 
Comment by Matthew Subscribed to comments via email
2008-09-10 09:53:23

I figured out the above problem. I just needed to include a picture called cat-1.gif where the number 1 corresponded to the .gif file for the category I was trying to display. I placed the .gif in the cat-images directory like you said.

New question: Can I add a different feautured image to each page? Thanks alot!
Matt

 
Comment by Marek Subscribed to comments via email
2008-09-25 05:02:25

Hi,
i think i have the same problem like liz. I see only a top_story image and nothnig alse on gray/black background…? :(

http://shrani.si/f/q/JH/31lvDgKH/marko-simpel-si.png

It’s not a browser problem, couse it doesn’t work in mozilla either in chrome.

Please help..

 
Comment by Marek Subscribed to comments via email
2008-09-25 10:36:52

I have solved the problem.
I replaced in home.php

have_posts()) : $my_query->the_post(); $do_not_duplicate = $post->ID; ?>

with

have_posts()) : $my_query->the_post(); $first_post = $post->ID; ?>

and it works.
:P

 
Comment by james tombs Subscribed to comments via email
2008-09-26 13:22:02

Using your theme which is great by the way.

I have found a problem though.

On the homepage, the id, content comes up twice which stops the homepage from being W3C compliant.

To fix this you need to edit the home.php and take out the lines:

<div id="content" class="box">

Which is on line 2 and the closing:

</div> <!-- /content -->

on line 70 (or 69 once you have deleted line 2).

 
Comment by Louise
2008-09-29 07:06:00

i love this theme, it’s great. but is there anyway to have some sidebar options on the front page instead of previous images, like a list of categories?

thanks for the theme!

 
Comment by Roger
2008-09-30 09:40:23

Hi ! One of the best themes for Wordpress ! I would like to know how to include some ads in the home page. I would like to include an horitzontal banner between the the last featured post and the “more articles” section…

 
Comment by Roger
2008-09-30 09:55:56

Another question…I would like to change the black background for the last featured article, how I can do that ? Thanks !

 
Comment by sammy2001 Subscribed to comments via email
2008-10-05 10:13:59

Is there any way to update the top image alt tag in the backend. I.e. is there anyway the category description could mirror what goes in the alt tag?

* the page won’t validate without the alt tag

I know you could fix the alt tag in the php file - but if you updated the banner image you would have to keep updating the php file.

 
Comment by Roger
2008-10-08 12:21:56

how i can eliminate the border under the linked images ? adding a “a img border:none” is not working. thanks !

 
Comment by Dan K.
2008-10-15 02:33:32

Hello - first, great theme! Thank you….

Is there a way to customize or set one featured post to stay static in the featured box on the homepage? Thank you….

 
Comment by Leland
2008-10-16 12:03:30

@Dan K: You can use the WP Sticky plugin to pin a post to the top.

Comment by Dan K.
2008-10-20 03:43:25

Thank you! It worked perfectly….

 
 
Comment by Nexus
2008-10-19 14:16:26

I’m grabbing this one for my clans new website. Nice work and thanks!

 
Comment by Dan K.
2008-10-20 04:05:31

Another question/request - If you select multiple categories on a post, is there a way for the post to appear under each selected category on the homepage? An example, using your demo has a reference:

If I select “test” and “featured” categories for one post I would like it to appear under both “Previous Articles” and “Featured”?

Thank you…

 
Comment by Matthew Subscribed to comments via email
2008-10-20 17:38:18

Yes, when you publish any post, you can have it published in multiple categories simultaneously. Just select which categories you want the post to appear in under the writing input box, under ‘tags’. I just used WP sticky as well, it is a useful tool.

My last post was published under the default category, and a second category using this theme. Therefore it appears under ‘featured articles’ and my second category of choice.

Comment by Matthew Subscribed to comments via email
2008-10-20 17:39:40

I meant select which categories you want the post filed under ‘categories’ which is underneath the ‘tags’ selection.

 
 
Comment by thinkweird
2008-12-03 19:59:04

How to add a favicon.ico to this theme?

I generated a icon file and put it into /images, and modified the header.php, but still can’t see it.

 
Comment by Zlimp
2009-02-01 22:47:13

Lovely stuff… ill try this out… it doesnt have a sidebar right?

 
Comment by hal?
2009-02-27 18:45:37

nice theme. thanks.

 
Comment by Gino
2009-03-09 08:09:00

Hey, great template.

Is there anyway to add a video link from youtube?

Cheers

 
Comment by Kathleen Gresham
2009-03-17 20:35:25

What a great-looking, premium theme! I’m looking forward to trying it out. Love the flexibility! Thanks!

 
Comment by Brian
2009-04-19 01:00:55

I love it. I have been looking for a theme like this. Thank you.

 
Comment by Tony Subscribed to comments via email
2009-04-19 23:30:03

Is there any way to have the intro text for posts show on the front page? I would like to have a 2-3 posts from each category show the first part of the post with a “read more” type link.

 
Comment by Joe Subscribed to comments via email
2009-05-04 22:26:15

Hi Leland,

First off, I think this a great theme - thank you for your hard work on building this!

Secondly, I am having an issue with an error that I think is related to the permalink setup, which is set to *Month and Name*. The error is: Catchable fatal error: Object of class WP_Error could not be converted to string in /wp-includes/category-template.php on line 105

Any thoughts?

Joe

 
Comment by nananias
2009-05-05 06:01:25

how do i replace the category images with my own images? thank you.

 
Comment by china
2009-05-12 22:43:48

Hi Leland,

First off, I think this a great theme - thank you for your hard work on building this!

Secondly, I am having an issue with an error that I think is related to the permalink setup, which is set to *Month and Name*. The error is: Catchable fatal error: Object of class WP_Error could not be converted to string in /wp-includes/category-template.php on line 105

 
Comment by Business Mess
2009-06-05 10:29:32

Thanks for this great theme.
I’m going to use it for my news blog.

 
Name (required)
E-mail (required - never shown publicly)
URI
Subscribe to comments via email
Your Comment (smaller size | larger size)
You may use <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> in your comment.

Trackback responses to this post

Recent Comments

  • Leland: @axelk: As in picture uploads? Not sure about that, although you could set up the form to allow users to send...
  • axelk: thank you for the reply. can Contact 7 be used to submit pictures as well?
  • Leland: @axelk: I think that’s what the Contact Form 7 is for. Although if you wanted to allow users to submit...
  • Chronic: I think coming up with a haiku would be more difficult thant developing a great theme or plugin. Excellent...
  • Jeffro: Better late than never, happy birthday to you and the blog man :)

About The Author

Welcome to Theme Lab. My name is Leland, and I run the place. I write all the tutorials and code all the themes you see here on the site.

For more information about me, feel free to read the about page. If you want to drop me a message, feel free to contact me.

Interested in advertising on Theme Lab? We have advertising available at very reasonable rates. Head on over to the advertising page for further details.

Please read our Privacy Policy and Terms of Service in regards to theme usage.

© 2009 - Theme Lab - Powered by WordPress