ThemeLab's Blog

Stay up to date with our newest WordPress themes, WordPress plugins, WordPress tutorials, and other announcements.

Miniml – Free WordPress Theme

Last Updated on by

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.

  • http://themelib.com ThemeLib.com

    Excellent! It looks like a premium theme :)

  • Leland

    @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

  • http://themelib.com ThemeLib.com

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

  • Leland

    @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.

  • http://imanto.com Anto

    So it has finally been released! Thank good.

    Such a simple and neat theme. Nice port Leland.

  • http://pangeran.org/ Pangeran

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

  • Leland

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

    @Pangeran: Thanks, glad you like it.

  • Pingback: WordPress Themes - The Best Of The Best! » Blog Archive » Advanced WordPress Theme - Miniml

  • Pingback: [Vote 4 Me] Blog Vibrations

  • http://saaiiaa.com saaiiaa

    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

  • Leland

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

  • http://www.amander.com Amanda

    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!

  • Leland

    Thanks Amanda! I appreciate the feedback.

  • sdave

    Hey, great theme.

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

    thanks again

  • Leland

    @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.

  • sdave

    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?

  • Leland

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

  • sdave

    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)

  • Leland

    @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.

  • glu

    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.

  • Reza

    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

  • Leland

    @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?

  • Reza

    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??

  • Eric

    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?

  • Leland

    @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.

  • Pingback: 30 Free High Quality Wordpress Themes | Developer's Toolbox | Smashing Magazine

  • Pingback: 30 Free High Quality Wordpress Themes | The Creative Children

  • Pingback: 30 Free High Quality Wordpress Themes | aboutCREATION

  • http://www.adamcrawford.co.uk Adam C

    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.

  • http://www.adamcrawford.co.uk Adam C

    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.

  • Leland

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

  • http://www.adamcrawford.co.uk Adam C

    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.

    • http://news.myshantou.net fm100

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

  • Leland

    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.

    • http://news.myshantou.net fm100

      Thank you leland. I solve my problem.

  • Pingback: 30 Free High Quality Wordpress Themes

  • http://blog.notmyworld.com Nicola

    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

  • http://blog.notmyworld.com Nicola

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

    Nicola

  • Pingback: 33 Free High Quality Wordpress Themes | CooOne.com

  • http://blog.notmyworld.com Nicola

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

  • Pingback: 30 Free High Quality Wordpress Themes | ???? - ???????? - Best Articles of the Day

  • http://eforeclosurepedia.com Susan

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

  • http://bushuang.thinkweird.info bushuang

    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?

  • Pingback: WordPress???? 08/08/31 | ????????

  • Pingback: 27 Free High Quality Wordpress Themes

  • Pingback: 30 New and professioanl wordpress theme « About seo and wordpress

  • Leland

    @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

  • http://bushuang.thinkweird.info bushuang

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

  • Pingback: 20 Wordpress Themes You Must Try! | Belive Blog

  • http://truthrecruit.org/blog/ liz

    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.

  • http://truthrecruit.org/blog/ liz

    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

  • Leland

    @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.

  • http://truthrecruit.org/blog/ liz

    @leland,

    thanks so much! much better.

    -liz

  • Matthew

    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

  • Matthew

    How do I remove meta from the sidebar?

  • Matthew

    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

  • Pingback: Free High Quality Wordpress Templates | Dobeweb

  • Pingback: WP Thème Magazine Miniml en français ! [11/24] | Weezonaute, le blogueur masqué

  • Pingback: Ein Magazine-Theme für Minimalisten - Beitrag - Schweizer WordPress Magazin

  • Pingback: Marek: “Blogiram!” » Blog Archive » Na drobno

  • Marek

    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..

  • Marek

    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

  • Pingback: ???45+32?Wordpress?? | ????????

  • http://jamestombs.co.uk james tombs

    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).

  • Pingback: Miniml | Free blog templates @ freeblogtemplates.net

  • Pingback: 30+?????Wordpress Themes?? | ????

  • Louise

    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!

  • Roger

    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…

  • Roger

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

  • Pingback: 59 - Latest Oct 08 Wordpress Magazine Themes - Massive Collection-Tech Stroke

  • sammy2001

    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.

  • Roger

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

  • Dan K.

    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….

  • Pingback: netztreiben » Blog Archive » 100+ free Wordpress Magazine Themes

  • Leland

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

    • Dan K.

      Thank you! It worked perfectly….

  • http://www.dbdclan.se Nexus

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

  • Dan K.

    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…

  • http://www.matthewaengel.com Matthew

    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.

    • http://www.matthewaengel.com Matthew

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

  • Pingback: WordPress???? | WordPress theme,joomla theme,PSD TO HTML,theme??,theme????,??

  • http://cn.thinkweird.info thinkweird

    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.

  • http://www.zlimp.com Zlimp

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

  • http://www.gultekinhali.com.tr hal?

    nice theme. thanks.

  • Gino

    Hey, great template.

    Is there anyway to add a video link from youtube?

    Cheers

  • Pingback: Best Themes

  • http://www.blogdesignjournal.com Kathleen Gresham

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

  • Pingback: Geeth - I have valid reasons for | Laout.in - Weblog of gEETH

  • Brian

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

  • Tony

    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.

  • Pingback: 32???wordpress???? « Lizus - PSD to xHTML & css,wordpress??,????

  • http://www.notedabove.com/ Joe

    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

  • http://pedapa.com nananias

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

  • Pingback: Wordpress Staff - director.romportal.ro

  • http://www.gogochina.cn china

    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

    • http://www.voronezhskieokna.ru/ ksbomj

      Thank’s for good theme! But I have some problem with this theme. I turn SEF URL in my blog. After I having error in main page.

      Catchable fatal error: Object of class WP_Error could not be converted to string in /home/www/z108890/htdocs/wp-includes/category-template.php on line 105

      Help me please!

  • Pingback: Free 10 Wordpress Theme Download | Free Download Blog

  • http://businessmess.com/ Business Mess

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

  • http://www.bmwtuner.net daveb

    Love this theme… so clean, so easily managed and extended! I’ve got it running on my site and had it set up in a matter of an hour or so.

    The one thing I’m not quite sure how to figure out yet is to have the Featured Image/topstory_image custom field pull from images stored in NextGen gallery instead of some random subdirectory.

    Also, how can I make the elipses at the end of the top story blurb link to the actual story?

  • Pingback: 30 WordPress Themes - Indexu.de

  • Ana

    I’m having the same problem:
    Catchable fatal error: Object of class WP_Error could not be converted to string in C:\Inetpub\vhosts\anaaceves.com\httpdocs\wp-includes\category-template.php on line 71

    Any ideas?

    Many thanks, Ana

  • Pingback: GreatCreativeLinks.com — 10 Free Wordpress Themes that Rock

  • starseed

    I love this theme! But I am also experiencing the same issue with this message:

    Catchable fatal error: Object of class WP_Error could not be converted to string in /home/content/m/y/o/********/html/wp-includes/category-template.php on line 71

    Please help! Also, could it be an incompatibility issue with WPMU?

  • Joao

    Hi, I would like to do some changes to this template. Any freelancer?

  • http://matthewaengel.com/blog Matt

    Sure, I have used this template extensively. Feel free to contact me at matthewaengel@gmail.com You can check out the site at westburydiagnostics.com