Displaying Your Catalog In Posts

Your catalog can be inserted into any post or page on your blog with a WordPress shortcode. The CataBlog shortcode lets you put a simple, easy to read marker in your post content that tells the plugin where to put your catalogs. Simply type [catablog] in the post or page content to display your entire catalog. If you want to only show a section of your catalog and not the entire thing you may add a category option to the shortcode, like [catablog category="dogs"]. CataBlog now supports multiple categories and an operator option, you may read more about these options at Organizing Your Catalog with Categories.

Shortcode Options

The CataBlog shortcode has seven different options that you may choose to override. These options are: category, sort, order, limit, navigation, template and operator. These options let you control exactly how your catalog is rendered on a per shortcode basis.

Category: show specific items in your catalog
The category shortcode option lets you choose which catalog items to show. You may specify one category, multiple categories or even categories to not show.
Example: [catablog category="dogs,cats"]
Default: if omitted all categories will be displayed.

Sort: sort your catalog by a specific field
The sort option lets you set the order your catalog items will be displayed, particularly which field they will be sorted by. This value should be one of these four values: title, date, menu_order or rand. Currently non of the other catalog item values can be used to sort, this may change in a future version.
Example: [catablog sort="title"]
Default: if omitted your catalog will be sorted by the order value.
To sort your catalog randomly set the sort value to "rand", [catablog sort="rand"]

Order: choose which direction to sort your catalog
The order option lets you set the direction your catalog items will be sorted in. There are two acceptable values for this option are asc and desc, ascending and descending respectively.
Example: [catablog sort="date" order="desc"]
Default: if omitted your catalog will be ordered in an ascending manner.

Limit: how many catalog items to display
The limit option lets you control how many catalog items are displayed on a page. If the limit is less than the total number of catalog items to be displayed then some simple navigation controls will be rendered below your catalog.
Example: [catablog limit="10"]
Default: if omitted all catalog items will be displayed.

Navigation: choose to hide catalog navigation
You may decide to hide the simple navigation controls created by the limit option with the navigation option. Simple set the option to 'no' or 'disable'. This can be useful if you want to display a subset of random catalog items without any pagination.
Example: [catablog limit="7" navigation="disable" sort="rand"]
Default: if omitted navigation will be displayed when the limit is less than the total number of catalog items.

Template: choose which template to use while rendering your catalog
You may override the main template code with this shortcode option. It should be the name of a template file in the /plugins/catablog/templates/views/ folder, omitting the file extension.
Example: [catablog template="gallery"]
Default: if omitted your catalog will be rendered with the system template.

Operator: set how the categories filter your catalog
The operator option lets you control how the categories you set will be used to filter your catalog. There are three acceptable values: 'IN', 'NOT IN' and 'AND'.
Example: [catablog category="cats,dogs" operator="and"]
Default: if omitted the 'IN' operator will be used.

Theme Integration

CataBlog now has a Public option, which if turned on allows you to integrate your catalog into your site. Each catalog item and category will be given a permalink. To control how these pages are rendered you need to add two files into your WordPress Theme's directory. These file act similarly to the single.php and archive.php files found in most standard WordPress themes, but are specific to CataBlog items and categories.

  • Single CataBlog Item Page: single-catablog-items.php
  • CataBlog Category Archive: taxonomy-catablog-terms.php

Remember that CataBlog also has a few core PHP functions you may use directly in your theme files. These functions are good for rendering catalogs and catalog categories.

 * Template function to emulate the CataBlog Shortcode behavior.
 * This function will echo out your catalog.
 * @param string $category A list of CataBlog category names separated by commas
 * @param string $template A CataBlog template file name
 * @param string $sort The column to sort your catalog by, defaults to menu_order
 * @param string $order The order to sort your catalog by, default to ascending
 * @param string $operator The operator to apply to the categories passed in, defaults to IN
 * @param integer $limit The number of catalog items shown per page
 * @param boolean $navigation Wether to render the navigation controls for this catalog.
 * @return void
<?php catablog_show_items($category, $template, $sort, $order, $operator, $limit, $navigation); ?>

 * Template function for fetching a single catalog item by id
 * @param integer $id The id of a catalog item to fetch
 * @return CataBlogItem|NULL Returns a CataBlogItem object if a catalog item was found, otherwise NULL
<?php catablog_get_item($id); ?>

 * Template function for rendering a list of dropdown
 * menu of all CataBlog categories.
 * @param boolean $is_dropdown Render the list as a dropdown menu
 * @param boolean $show_count Render the number of items in each category
 * @return void
<?php catablog_show_categories($is_dropdown, $show_count); ?>
Inside either of the template files above would be a good time to use those functions. Also, if you simply want to access the CataBlog items data load up the post's meta data. Here is an example, the last two lines simply list the key-value pairs of the catablog meta data:

<?php $data = get_post_meta(get_the_ID(), 'catablog-post-meta', true) ?>
<?php var_dump($data) ?>
<?php var_dump($data['sub-images']) ?>

CSS Options

If you are savvy with html and css you can do some pretty amazing things when it comes to displaying your catalogs. CataBlog comes with a few built in CSS classes that anyone who feels confident in the styles.css file can override. These classes are:

  • .catablog-catalog: Every shortcode catalog will be wrapped in a div with this class.
  • .catablog-row: Each catalog item's wrapping element. Resize, border and float it all you want.
  • .catablog-images-column: A wrapping class for the main image and all sub images.
  • .catablog-image: All catalog images should have this class.
  • .catablog-subimage: All catalog subimages will have this class in addition to the catablog-image class.
  • .catablog-title: A catalog item's title, this is usually a <h4 /> or <span /> tag.
  • .catablog-description: A catalog item's description, this is usually a <div /> tag.
Keep in mind you will most likely want to add the !important override to what ever styles you create. This is to help ensure that your setting is used instead of any other settings. Keep in mind that you may add any custom classes you want to any of your templates, allowing you to displaying your catalog in new and different ways on your blog.

.catablog-row {
  border: 1px #333 solid !important;
  float: left;
  width: 200px !important;
  padding: 10px !important;
.catablog-row .catablog-image {
  float: none;
.catablog-row .catablog-subimage {
  width: 50% !important;
  float: left;
.catablog-row .catablog-title {
  font-family: helvetica, sans-serif !important;
  font-size: 22px !important;
  color: #f1f1f1 !important;
.catablog-row .catablog-description {
  display: none !important;

389 Responses to Displaying Your Catalog In Posts

  1. Jodie Pait says:

    Can you please explain where exactly I put this? [catablog category='Red Sea']

    I’ve created a category called “Red Sea” and want to display those pictures on the Family Photos page, but I’m not sure where to put the [ ] code. Please advise. Thanks!

    • Zach says:

      Hi Jodie,

      You should put the [] code, also known as a shortcode, in your page content where you would like the catalog to be shown, just like you would insert a photo or paragraph of text. By page content, I mean go to the WordPress admin and click pages, then click edit on the Family Photos page and then put the shortcode in the “content” or main section of the page (under title). The shortcode also works in posts. Good luck, and if you haven’t already, please rate catablog at wordpress.org and like catablog on Facebook.

  2. Maria says:

    My catagories will not seperate even though I only have 1 catagory selected.

  3. Maria says:

    Solved it, it helps if I am using the correct version of WP

  4. Keith says:

    Love the way this plug-in is looking!

    I was trying to put a gallery of work up at http://downstairsup.com/gallery/ but I must be overlooking something somewhere.

    How do I get the title into the rollover of the image rather than posting on the page next to the thumbnail?

    Thanks in advance!

  5. I’m using catablog on http://www.lookitupforme.com/. So far I have created a few products. For each product, I have given the category as ‘iosapps’ and ‘glossaries’; or ‘androidapps’ and ‘glossaries’.

    Although I have called catablog in this manner [catablog category='iosapps'], it shows *all* the products. Same for android apps.

    You can see them immediately on the http://www.lookitupforme.com/ home page. There is nothing else. Why is the category not filtering. I installed the latest wordpress there only two days back.

    Thanks in advance

    • Zach says:

      Why the glossaries category? Are you sure that you are setting the category name exactly the same as the one you are using in the shortcode? Unfortunately I am unable to help with category filtering problems from the link you sent me because I can’t tell anything from the frontend. What version of CataBlog are you using? 1.2.6? Could you try using quotes instead of apostrophes in your shortcode? example

      [catablog category="iosapps"]

      Also can you please double check the spelling of your category and the name you place in the shortcode.

      Thanks and hope you figure out your problem, let me know how it goes.

      • Rodrigo Torrens says:

        Same problem.
        I’d double checked de category names, short code, version of WP. I tested inserting the short code into pages or posts. The same results: All items in trhe catalogs are shown, regardless of their assigned category.

        Any hint?

        Thanks in advance

        • Zach says:

          I assume that the category filter is working in the Admin Library? Most times the custom taxonomy query fails it is due to an improperly passed in parameter.

          If you want to try and debug the code on your server you may try dumping the post query params before they are executed.

          Place this code in CataBlogItems.class.php:


          Place the above code in the CataBlogItems.class.php file found in the /plugins/catablog/lib/ folder. Right above line 186, which should be:

          $posts = get_posts($params);

          All the query parameters should now be visible when you view the frontend page that is suppose to render the catalog. You may email me those params or post them here, and maybe that will shed a little light on the subject and help us understand what is going on here.

          Hint: search the page source for post_type to find a well formatted list of all the query parameters.

    • Buddy says:

      Try it without quotes. I found it did not work properly with quotes.

      • Zach says:

        Buddy, are you saying removing the quotes from the Shortcode fixed this problem for you? hmmm…very interesting.

        Are you entering the Shortcode while in the Visual Editor mode perhaps using “smart” quotes? If you look at the HTML view are the quotes actually an HTML escaped value, such as &quot;?

    • bu11frogg says:

      I know this is a couple years too late, but…I had the same issue. What solved my problem was double-checking all my Categories (CataBlog Categories, from the list of Categories in the CataBlog Entry Editor).

      Example: One of my Category Names was “Folk Art / Primitive” but the auto-generated slug was “folk-art-primitive-2”. I should’ve known better than to use slashes, so I took the / out of the name and I took the inexplicable “2” out of the slug name. Still…it didn’t work.

      Then I renamed all my Categories so the Name matches the Slug. This may have been unnecessary, but since it is working 100% reliably — and no users will ever see the Category Names anyway — I’m perfectly happy with this solution.

  6. Sal Cameli says:

    Hi Zach!,

    Thanks for making this plugin. Been looking for one and haven’t found the right yet until I found yours.

    Just one problem with mine, I want to display the images like you do with Theo’s images. I want to be able to click an image and have it pop up and then the website viewer can click through the images.

    Right now on mine it just opens each photo individually.
    What am I doing wrong?

    The code I am using is: [catablog template="gallery"]

    You can see it here on my site: http://streetstrider.co/media/


    Sal Cameli

    • Zach says:

      Please make sure that the LightBox is enabled in the CataBlog Options Admin Panel. There is a LightBox tab, make sure that the Enable LightBox checkbox is checked and save your changes. If it checked please make sure to try disabling other plugins or try the twentyten theme to check for JavaScript errors.

      • Brian Naya says:

        I’m having issues locating the twentyten theme could help me locate it?

        • Zach says:

          It is possible to uninstall or remove the TwentyTen theme. If you cannot see it in your Admin Appearance Themes Panel then click the install tab at the top of that admin panel and type twentyten in the search field and follow directions to install the theme. Good luck 🙂

  7. Sal Cameli says:

    That was it!!! Thanks so much!


  8. Micki says:


    I recently installed your plug-in and playing around i am not able to get any of the sub images to show up, only the main photo. I have 3 sub images added. Any ideas? thanks, really hoping that this works, needing something to have multiple images on a page.

    • Zach says:

      Have you tried reloading the default template? Sub images are not used in the gallery template. Also, the %SUB-IMAGES% token is not a URL and should not be wrapped in an anchor tag. The token will instead generate multiple image tags, wrapped in anchor tag setup to be used by the LightBox automatically.

      • Micki says:

        Oops, didn’t see your reply. yes, I tried reloading the template and now I am totally confused. I was assuming that the sub images would be added to the gallery. Is this designed more for ftp upload of multiple gallery images versus uploading through the program? As when I upload through your program, there is only one spot for a main image. Can you give me an example of a shortcode to use to get the sub images to show as a part of a named gallery? Does this make any sense :)? Thanks

        • Zach says:

          CataBlog is designed to create lists or “galleries” of images inside an already created WordPress page. Each catalog item has a main picture, secondary pictures, title, description, link, price, etc. You may show different collections of items by putting library items into categories and then filtering your catalog by category.

          please excuse any duplication of information, I just want to make sure people see this answer in regards to your question.

        • Zach says:

          in other words, categories let you group library items together into galleries.

  9. Heru says:

    I’ve already succes to post my photo, but how to display it grid view?

    Please help me… SOS..

    • Zach says:

      If using the shortcode method add the template option in the brackets like so:

      [catablog template="gallery"]

      • Micki says:

        I am using this shortcut, I also tried to use the shortcut like [catablog category='dog']. I only have one gallery in the library. And while I have you, when I am loading images I do not see where I am able to place titles on the sub images (even if I can’t see them in the post yet). Am I missing something? Thanks

        • Zach says:

          Hi Micki,

          First off, I want to be clear that the code you enter into your post or page content is called a shortcode, not shortcut. It seems you are using it in the correct manner, if you want to show all library items in the dog category.

          I am unsure what you mean when you say you have only one gallery in the library? Currently CataBlog does not have a gallery feature, do you mean catalog item?

          A catalog item is not a gallery. It’s a single item in your catalog. If you want a separate title for each image, make more catalog items in your library. A sub image is meant to be supplementary to the main image and shares the title, description and other attributes with the main image.

          Hope that makes sense and good luck.

  10. Micki says:

    ok, you are quick, thanks! and our messages are crossing. yes, i meant shortcode… sorry, it is early over here. i think that you just answered much of my question. so basically i need to create a “catalog” item for each image if I want them displayed in a “gallery” fashion. Secondly, and i just asked this in a prior post, how do i call the sub images?

    i have a client who wants to create item (catalog) pages with images and text details. some of the items will have more than one image. she also wants a thumbnail layout of all items (50+) that then link to the pages with the details, so i am looking for something that can do this.

    i appreciate your quick response, thanks for your help as a bumble through this…

    • Zach says:

      So right now CataBlog is meant to be used within already created pages. It does not make “catalog item pages”, it makes lists to be inserted into an already created page or post. In a future version (possibly the next, wink wink) CataBlog might be able to make each catalog item publicly visible, meaning it will have its own page. If that were to happen, you would most likely need to create a theme file (single-catablog-term.php) for the catalog item pages in your current theme, just like your theme may have files like single.php and page.php. This is because a catalog items has values that don’t directly correspond to a regular posts values, such as sub images.

      As far as sub images are concerned, they are basically suppose to be supporting images for the main image, meaning if your catalog item was a can of soup, perhaps the sub images would be picture of the soup in a bowl steaming hot and the back of the packaging with nutrition info. In the default template, these sub images are displayed at half size under the main image, in a list of all the catalog items your shortcode fetched. The mario catalog item in the demo page is a good example of how they are displayed.

      You could use the current version of CataBlog for your thumbnail listings page, and then create individual pages for each catalog item, just regular WordPress pages, and have the catalog items link to those pages, just a thought.

      • jenniev says:

        Hi Zach, I am working to the idea you mention above. (using catablog for thumbnail listings page and then create individual pages for each catalogue item). This is working for the thumbnail part and I have set up the link to another page (so when you click through from thumbnail you go to product page). However the only way i can get the product page to work is if there is something in the title field and then this ends up on the navigation which i don’t want as there will be loads of product pages. If you can help I would really appreciate it. Thanks so much.

        • Zach says:

          I am not exactly sure what you are asking. Still let me try and answer your question.

          Every item must have a title, it is a requirement, but the title doesn’t have to be shown in the thumbnail listings page, simply remove the %TITLE% token from the CataBlog template.

          Let me know if that answers your question.

  11. Jim Nielson says:

    Thanks very much for this very useful plugin.

    However … I am trying to use it for the gallery page on this site, and the sort order isn’t working:

    This is the code I’ve used in the page (it’s a page, not a post):
    [catablog template="gallery" sort="order"]

    The site is in WordPress 3.1.1, though I’ve somewhat hacked and simplified the theme php files (could that affect the Catablog sort order functions?).

    The page is sorting the images in the order they were uploaded, as far as I can tell. I tried changing the datestamp on an image, but it didn’t move – so it’s as though it is sorting them on the original upload date, regardless of what I put in the sort= parameter.

    Any ideas? (And thanks again – and in advance)


    • Zach says:

      Are you positive that you are editing the date stamp in the correct format and it is being accepted?

      You should read displaying your catalog in pages in the documentation to make sure you are using each parameter correctly.

      The admin section can be a good place to test ordering. Simply click the title of the order or date column to order by it’s value. You may click the column title again to flip it’s order, go from ascending to descending.

      Hope that helped…

      • Jim Nielson says:

        Thanks for the speedy response!

        The ordering works fine in the admin panel. The datestamp and the order both changed. But nothing changes in the page the gallery is being displayed in. It’s always the same order there. ?!

        Maybe I’ll try reinstalling or something. I seem to be the only person having this problem…. Thanks again for replying so quickly.


        • Zach says:

          could you also tell me the exact Shortcode you are using? Since it does not seem to be a problem with the edit item form or the actual data.

      • Jim Nielson says:

        Hi again

        I did some snooping around in the code and found what was causing the problem for me.

        At line 130 in CataBlogItem.class.php there’s this.

        if ($categories !== false) {

        $tax_query_array = array(
        ‘taxonomy’ => $cata->getCustomTaxName(),
        ‘field’ => ‘slug’,
        ‘terms’ => $categories,
        ‘operator’ => $operator // ‘LIKE’, ‘NOT LIKE’, ‘IN’, ‘NOT IN’, ‘BETWEEN’, ‘NOT BETWEEN’
        $params[‘tax_query’] = $tax_query_array;

        I needed to change if ($categories !== false) to if ($categories != false).

        Thanks again!

        • Zach says:

          This is really strange to me, why would that fix your problem….
          I am really curious now how you implemented the Shortcode. Because the conditional check you modified is related to the category filter and has nothing to do with the order of appearance. Perhaps what you are doing is setting the category to empty in the Shortcode, when you should be omitting it completely?

          • Jim Nielson says:

            Isn’t “!==” in your if clause a typo for “!=” ?

            I assumed that was the problem and the code was crapping out before the params were properly set …

            The shortcode I’m using is [catablog template="glr" sort="order"]

            I take it that sort=”order” is actually unnecessary, since that’s the default, but when it wasn’t working I put it in there.
            My glr template is ultra-simple, but in any case I had the same sorting problem with any template I used. I assumed it’s that if clause at line 130 that was the culprit.


          • Zach says:

            != does a comparison, but !== does a strict comparison, meaning it makes sure that the value and type of the two values are the same, not just the values. This is particularly important when checking against a value like false because many different value equate to false, such as the number zero.

  12. Micki says:

    thanks for the detailed reply. yes, i understand that i need to make pages in which to put the shortcodes to show the images. I am still confused as to how to get the sub images to show up on a page where the shortcode is to display the “catalog item(s)” as per your soup example :). Non of mine are showing.

    And just for clarification, at this time I can not get a ‘gallery look” (looking like your gallery example) pulled from numerous categories with how your plugin works, correct?

    thanks again!

    • Zach says:

      Perhaps you are implementing the gallery incorrectly. It should look like this:

      [catablog category="dog" template="gallery"]

      This will show all library item’s in the dog category, only the main image of each library item will be shown.

      • Grimpond says:


        I was looking for this sort of implementation.. [template and category] , but I did not find it in the main documentation – it might be worth adding..

        Thanks for what looks like a great plugin…


  13. Micki says:

    hey thanks, i did look around and wondered if i should be adding the shortcode this way…but if i am understanding you correctly, only the main image of each library item would show, and not the sub images? i actually used one of the modified templates off of one of the posts and it worked showing the sub images… thanks for your replies 🙂

  14. Chris says:

    I’d like to know how to include other detail in a catalogue, for example item price and product code. There is provision for this in the database. (The website listed here is a test website only.)

    • Zach says:

      There are many tokens available for usage in the CataBlog template system, just go to the Admin CataBlog Options Panel, select the Template tab and add any token you want into the HTML code. A list of all the tokens is available at the Making Custom Templates documentation page.

  15. carlos says:

    First of all, congratulations for this great plugin! My question: I want a gallery for my artworks exactelly like your demo ( Theo ), but when I click a thumbnail, a large static image just open in other page. The lightbox don´t work, even checking in Catablog/Options/Lightbox. What´s wrong?

    Thanks in advance.

  16. carlos says:

    Hi again,
    In your “The Lightbox” documentation I found the answer for my question.

    Thanks again.

  17. Laurence says:

    Hello Zach…

    I have used your catablog but the images are not appearing when I use the short code. Instead, the short code appears as the text written.

    I have used catablog on other websites where I have used a free template and it has worked perfectly. However, this particular then is one I designed and had someone develop for me. Could this be where the problem has come from? As when I click on widgets in the appearance panel it simply says:

    “no side bars defined
    The theme you are currently using isn’t widget-aware, meaning that it has no sidebars that you are able to change.”

    Is it possible that this is the problem?

    Thanks in advance…


    • Zach says:

      I cannot know or figure out why your custom theme does not render Shortcodes correctly without looking directly at your theme’s code. Some questions:

      Are you sure you are entering the Shortcode in the post or page’s content and not directly into the theme’s PHP files?

      Are you using get_the_content() instead of the_content() template tag?

      Are you sure your theme is not editing or disabling any built in WordPress hooks?

      Are you sure you theme does not have a syntax error that is stopping rendering of the page?

      No sidebars defined should not affect CataBlog or how it renders. I would recommend hiring someone who is a professional WordPress theme developer to perhaps take a look at your theme and fix it for you. Good luck 🙂

  18. Justin says:

    does catablog items have a subpages?

    If no, how I can take one item from catablog category? For example [catablog item="item_id"]


    • Zach says:


      CataBlog items do not have subpages and they probably never will. You might want to consider placing a single item into a category and using that category as a filter. Currently there is no way to fetch a catalog entry by id, but you can always use the built in WordPress function get_post().

      What is it that you are trying to achieve? Sounds to me like you want a page generated for each catalog entry, but I can’t really tell from your question. Could you please try and be more specific, thanks.

    • Zach says:

      Justin, you should read Comment 2811, it has a simple PHP example showing how to load and render a single catalog item.

  19. Michael says:

    Hi Zach,

    I’m using Catablog to show some photos in a gallery and I’m really happy with it – great work!

    Is it possible to show just a single item in a post?

    For example: [catablog item='3'] or [catablog ID='3']

    Unfortunately, I was not able to realize that yet. I’ve used separate categories to show some single photos but that is not a good solution cause on the long run I’ll have a lot of categories…


  20. Michael says:

    Oh sorry Zach – just saw that Justin asked the same question like me. I have a similar problem and need a solution to show a single id from Catablog in a post. Regards, Michael

    • Zach says:

      If you are using CataBlog 1.2.9 or better it is possible to use the PHP function catablog_get_item() to get a CataBlogItem object and then pass that into the rendering function. Here is a simple example.

      <?php global wp_plugin_catablog_class; ?>
      <?php $catalog_item = catablog_get_item($id); ?>
      <?php $wp_plugin_catablog_class->frontend_render_catalog_row($catalog_item); ?>

      • elyd says:

        Hi Where do I insert this code at in the catablog.php so I can then use the catalog item variable? ie. catablog item=’3′]

        • Zach says:

          You would insert this code somewhere inside your theme’s PHP files, perhaps single.php or loop.php. You will need to set $id before calling this code, perhaps you could use a get parameter of some sort to set it.

          If you are looking for a Shortcode to load a single item, please be patient. Currently I am waiting to confirm the multiple file upload is working and stable before adding any new features.

          You may help speed up the process by testing the latest version yourself on as many browsers and WordPress installations as you feel comfortable doing.


  21. elyd says:

    Hi im liking the plugin just want to ask that on the examples liek http://archi-arts.com/wordpress/?page_id=90

    the way the page has a custom menu with ligthning was that using its own template on the catablog?

    • Zach says:

      The icon menu is not catablog, perhaps it’s another plugin, perhaps it’s the theme. I am unsure as I did not create the web site.

  22. Adrian says:

    Hi, love your plugin but im having a small problem. I would like to have the subimages as smaller thumbnails below the main image but cant seem to get it to work via css. I cant seem to override the height etc and reposition the subimages. Any help? thanks

  23. Tim says:

    Love the plugin, I just have a quick question? Im not wavy with css, but would like to use some of the formatting options that you show on this page. Can you give a sample of where to put that in the styles.css file and is there anything else I would have to do to get it to display with a border like the one on your demo page?

    • Zach says:

      For a border please add the below CSS classes anywhere within your styles.css file, I would make the CataBlog classes their own separate block of code…perhaps separating the code you create for CataBlog with a couple hard returns or a comment. The other option is to create your own catablog.css file in your theme’s folder, with all the CataBlog customizing CSS classes you want.

      .catablog-row {
        border: 1px #333 solid;
        background-color: #efefef;
        color: #333;

    • Zach says:

      I would also recommend reading the CSS material at w3schools.com. It is quite informative…

      Also download Firebug and learn how to use it, it’s an amazing development tool. If you do not want to use Firefox than I would recommend learning about the Google Chrome Developer Tools or Safari Web Inspector. All 3 are amazing tools when it comes to learning CSS.

  24. Michael says:

    Hi Zach,

    how can I use the “alt-tag” in my gallery? At the moment it is not active.

    <div class="catablog-row catablog-gallery">
      <a href="%LINK%" class="catablog-image" %LINK-TARGET% %LINK-REL%>
        <img src="%IMAGE-THUMBNAIL%" alt="" />
        <strong class="catablog-title">%TITLE%</strong>
      <div class="catablog-description">%DESCRIPTION%</div>

    It would be great if the information I’ve entered as description would be used als “alt-tag”. Is that possible?

    I’m looking also forward to be able to add single items via shortcode into posts and pages. That would be a really cool and usefull function.



    • Zach says:

      I am replying to the original comment and will remove the other comments in our thread soon. If you want the description of the catalog item to be the alt tag, simply put the title token in between the alt tags quotes. example

      <div class="catablog-row catablog-gallery">
        <a href="%LINK%" class="catablog-image" %LINK-TARGET% %LINK-REL%>
          <img src="%IMAGE-THUMBNAIL%" alt="%DESCRIPTION%" />
          <strong class="catablog-title">%TITLE%</strong>
        <div class="catablog-description">%DESCRIPTION%</div>

      I would suggest not putting HTML or even a hard return into your description if you want to use it as an alt tag.

  25. Boniface says:

    Wow, it is so easy to use! I spent about two hours trying to get some image slider work to no avail. The short tag, without having to add other code in the template files makes this stand tall.

  26. mp says:

    Really liking the potential that this plugin offers. Struggled a bit to set it up, had issues with lightbox working erratically, but now this seems to have fixed itself (reinstalled catablog). For some reason the catalog began displaying as a listing instead of as thumbnails (with title of item sliding up on mouse-over: photo and name of person in our case). This happened before the re-install, by the way. It was perfect when the thumbnails were displaying, how can I get this back? (Thanks for any assistance you may offer.)

  27. mp says:

    dangit. gremlins.
    ok, now when I loaded the template it worked.
    Don’t know if this is something with the plug-in or with some problem with my other wp files (I did have to deactivate all plugins earlier today because of an update failure)
    But earlier when I selected to enable lightbox, the same thing happened (nothing) like it didn’t “take”. weird.
    great plugin.

    • Zach says:

      Thank you for your input, I have not experienced problems like you are reporting, and it could be caused by many different variables, but every little report is valuable. I cannot check your current WP install, or its “health”, but my guess is that if you had problems updating and installing plugins that your problem could very well be with your server configuration.

  28. Nelson says:

    How can I enable my catalog item description to show in the page where I am locating it? I can only see the title of it? What is the shortcode?

    • Zach says:

      Wether the description is displayed or not is dependent on the template code you use to render your catalog items. While you may set which template to use in the Shortcode, you cannot edit the template itself. To do that check CataBlog Options > template tab.

      Good luck and read the documentation page about editing templates for more information.

  29. Merrick says:


    Thanks for providing a great plug-ins. I am probably missing something obvious but I can’t seem to work out how to get the title and description to appear under the image in my Lightbox like they do in your demo. When I inspect the the Lightbox in Firebug I can see the following HTML under the image in the Lightbox.

    So it looks like it is ready to receive the title and description but they are not being sent to the Lightbox. How do I get the title or description into these tags??


  30. Laura says:

    I am having trouble with the order of my images being viewed in the correct order. I have five main images with four sub-images under each. When the user clicks on the first main image they can then view all the images; but they are not in the order that I have them in the library. Can you let me know how I can fix this problem and get the images to be viewed in ordered? Thank you very much.

  31. Jason says:

    Does CataBlog support pagination? I am using a modified category list plugin right now, but it’s nearly impossible to implement pagination. We are getting to the point when you click on “All Recipes” where we really need pagination. Thanks!

  32. Paul Overton says:

    Hey Zach,

    I l-o-v-e catablog, but I’m having what seems like a simple problem that I can’t fix. On this page: http://durhamukuleleorchestra.com/shop you’ll see that I have a single catalog item for sale. The title, description, and buy now button all appear to the right of the image. I would like to have them appear below. The main template is set to “default” with the paypal template loaded under the “store” option. Ideas?

  33. Baris says:

    I like the idea of your plugin, but I can’t make it work to show more than 5 items. My page looks like this:


    It doesn’t matter if I show gallery template or default. What do yo think is the problem? I have 35 items in the library.

    Best regards

  34. George says:

    hi there, I try displaying some items, which should be able to buy later on with the paypal button.
    started with a very simple page called sales and put in the code [catablog]. made 2 items in the catablog option-backend.

    When I preview the post the products are there (no text is displayed tough)…. but if I publish it, there is only the title of the product left and no image..

    means, something on my page is “hiding” the pictures..

    just a bit helpless right now. maybe you have an idea?

  35. Jack Aubrey says:

    Hi Zach –

    I’m sorry to pester you about this but I’ve been working on this all day and can’t seem to get the display customized properly. I don’t think it’s a terribly difficult but I’m clearly missing something. The long and short is that I’m trying to get the display for this page:


    to look like this page:


    For some reason I can’t get the product title or description to sit under the image properly (I was also hoping to add the %price% tag in as well to maybe style that).

    I’m sorry again to pester you with something so basics html/css but I can’t for the life of me get this!


    • Jack Aubrey says:

      Woops, well I managed figuring it out. I had to start from scratch by deleting my old customizations and once I did that it worked out okay (with plenty of ” !important ” to make it stick). Anyway, you can kindly disregard the above question and thanks for a great plugin!


  36. Alisdair says:

    I understand how to show items from specific categories on a page – i.e. using [catablog category="books"] – and that I could use several pages to display different categories on each. However, I really want just one page with a pop-up ‘categories’ menu so that when you pick a specific category, the list is filtered accordingly. An additional ‘sort by’ pop-up menu would be useful too.

    Is this possible? I presume it can be done using PHP, but I don’t know quite where to start…..

    Help please!

  37. Derek Gomez says:

    Is there a way to link to and display an individual catablog item?

  38. Matt Barnes says:

    Hey Zach and others, I am using the catablog plugin and have installed it correctly and it is working. I would like to incorporate it into a flash gallery. That gallery currently uses a static xml file with all the image names and descriptions for gallery items. Anyway I really like your admin section for uploading and wp integration. How can I query the db to get all of category “rings” so I can then loop through and dynamically generate xml for the flash to read. I will be using php to create the xml . Do I need to do this as a theme template page? Give me your thoughts.

    php code xml generation script:

      //$result = CataBlogItem::getItems();
      $result = CataBlogItem::getItems();
      echo &#039;';
      echo '';
      echo 'getImage() . '" large="'. $result->getImage() . '" >';
      echo '<![CDATA['. $result->getTitle().''. $result->getDescription().']]>';
          foreach ($result->getSubImages() as $image):
              echo '';
      echo '';
      echo '';

  39. Gary says:

    Thank you for Catablog it looks great and is doing what I, a total newbie, wants and is easy to use.

    Although using the gallery template I’m only able to put a maximum of four thumbnails on the page at any one time and I want to put more on it that . . . What am I doing wrong?

    Thanks for your help.

    • Zach says:

      Is your blog set to only display four items at a time, or perhaps your theme? Are you using the Shortcode or the Public feature, I am guessing the public feature…if you use the Shortcode your theme or blog’s settings will not affect how many catalog items are shown.

  40. Shonari says:

    For some reason the tag doesn’t center the gallery and there is space to the right of the gallery. Any idea as to why?


    Great plugin. Thank you

    • Zach says:

      Yes, instead of using a center tag, you need to wrap your catalog in a div that has the width set to the exact width of your five column catalog, then give it a left and right margin of auto so it will center itself. This is simple CSS code, look into centering block level elements if you need more help. Cheers

  41. JoeMD says:

    This plugin is brilliant, I love how easy it is to use. The ONLY think I’ve found thus far is that there seems to be no way to create subcategories for items/products. I was hoping to use this as a comic database on my site but without being able to use subcategories it’s simply impossible.

    Will subcategories ever be added to Catablog?

  42. Carrie says:

    I am in serious need of help. I thought I had catablog working and displayed in posts correctly. However, I added several new images to catablog, catagorized them, and yet the new images do not show in the post. Just the old ones?

    I tried the shortcode mentioned above of: [catablog category="dog" template="gallery"]

    but, then none of the images for that catagory display. (obvisouly I did not place ‘dog’ as the catagory).
    What am I doing wrong? I am new to css/html/blogs. So, if you are able to help, please dumb it down for me. 😉


  43. Adam says:

    Hi, Zach,

    First, thanks for the good work on this great little plugin.

    I was wondering if you were considering an end-user interface to allow, well, any authorized user the ability to upload images through the site and not just the admin?

    I’m assuming that this wasn’t necessarily the intent of the plugin, but believe it would expand its functionality greatly.

    • Greg says:

      Having different roles able to access the Library would be a great thing! It seems like with the version I’m using Administrator and Editor can access/use the CataBlog.

      But I have an Author on one site (assigned as such for other role-based reasons) that can create posts but can’t edit/create CataBlog Galleries, for example.

      Is CataBlog using custom post types? Can I reassign roles for it? Anybody got any pointers on that?


      • Greg says:

        Answered my own question!

        In lib/CataBlog.class.php, on line 37, I changed
        private $user_level = 'edit_pages';
        private $user_level = 'publish_posts';

        I really like this plugin!

  44. Kelly Johnson says:

    Is there any way to display a partial description on the catalog page and a more detailed description on the Permalink page?

  45. Benny says:

    rif http://www.crocierando.org/wpcrociere/?page_id=1910
    Hi Zac
    thanks for the plugin is really good.
    we have a small problem, if you look at the link to see the photo of the ship covers part of the writing.
    How can we do to solve this problem.
    Thank you for your help.

    • Zach says:

      The display bug you are seeing on your site is most likely due to you having conflicting or overwriting CSS classes. Use a tool like Firebug to sort out which class is causing the error.

  46. Carrie says:

    Ok, I have been playing around with the shortcode in efforts to get it to appear the way I want. Weird, but when I placed a comma after the category to display it sorta worked. It was then displayed as a gallery, but not limited to the category specified.

    [catablog category="Monday Linky Parties", template="gallery"]

    I would love it if you could tell me what I am doing wrong. When template is not specified, I get the correct category, but only 5 of the images.

    Thanks in advance for any help provided,
    WP version 3.2.1, Theme Feather 1.4
    Page: http://www.projectpossessed.com/i-heart-linky-parties/
    Catablog version:

    • Zach says:

      Place the commas, without spaces, inside the category attribute’s quotes. Do not place a comma in-between the attributes, outside of the quotes.

      [catablog category="red,green,blue" template="gallery"]

      • Carrie says:

        Ok, I’m starting to feel really stupid (don’t worry, that’s normal for me!). I entered in the code exactly like you posted:

        [catablog category="Monday,Linky,Parties" template="gallery"]

        Now, nothing appears from that gallery. Thought, just so I’m on the same page – Monday Linky Parties is the title of one single category. I knew that in other previous posts that the commas are used to separate categories if using more than one…

        I must say, that my experience with WordPress has been Baptism by fire. I have also found that when seeking assistance in trouble shooting there is a 50/50 chance of receiving any. With that said, I want to thank you for the fantastic support you provide here. It’s apparently rare to find, and you are obviously proud of your ‘baby’ (catablog).

        I do plan to rate, like, and donate once I get catablog fully operating on my site. I figure it’s like buying a house. The understanding agreement is there, just waiting for the final ‘inspection’ to know what you’re getting into.

        Thanks in advance,

        • Zach says:

          So I am unsure but there could be a bug / issue with your category name and that may be the problem…

          Have you tried this shortcode:

          [catablog category="Monday Linky Parties" template="gallery"]

          Also, can you switch your editor to HTML view and see if your shortcode is being corrupted with HTML escape characters. It should look just like the above Shortcode in HTML view and you can easily type the Shortcode while in HTML mode to stop this from happening (most times it is due to copy and paste). Some people have had this problem in the past.

          Otherwise I’m kind of at a lose, let me know if either of those solutions help.

          • Carrie says:


            Thanks for the prompt response. Yes, I had already tried the code that you suggested:

            [catablog category="Monday Linky Parties" template="gallery"]

            So, I checked the HTML format and it displayed as:

            [catablog category="Monday Linky Parties" template="gallery"]

            I removed the text align, saved and viewed, and nothing.

            Checking back, the short code was sandwiched between and , which I deleted so the shortcode appeared in HTML exactly as written. Still only shows the first 5 images of the specified category.

            It’s almost like there is something blocking anything after the first row from being visible within a category. I have several categories created, and it’s the same result with all. But, it will show all categories when coded a certain way (when playing around with the short code to get it to work, I don’t remember specifics at this moment) even though a category is specified. So weird.

            Well, poop. That sucks. The theme I am using is by WP Elegant Themes. I don’t know if that’s part of the problem, or if its a plugin. I’ll fidget with some of the plugins to see if they are the problem – which I just had a bug through them, so I had disabled the majority of them anyways….

            If you randomly think of anything, let me know. I truly think catablog rocks, if only I could get it to work like it should.


          • Zach says:

            A few things to try:

            1 under reading setting try adjusting the posts per page setting

            2 switch to twenty ten theme just to test if that fixes your problem

            3 try a different category name that is completely unique and different from any category in your blog, including post categories.

            Good luck and let me know what you find out.

  47. Carrie says:


    Thank you so much for the reply! I truly do appreciate it. Last night I tried out a few other gallery display plugins (cincopa and nextgen), thinking I could use them on larger gallery displays. Well, forget that. I followed directions as written, but personally I don’t find them to be user friendly. Perhaps I would feel differently if I were well versed in ‘computer speak’, but HTML, CSS, blogs all of it really are all super new to me. The layout to find information regarding installation and use of plugin was difficult to even find.

    I aborted those persuits, and continued the relentless effort to get catablog to work. Honestly, I have not tried your suggestions from your last reply (yet). But, I did ‘jimmy rig’ a way for it to work – a bit more effort, but far less than finding/learning/using another plugin (which don’t compare to yours anyways!). Here is the (very strange) solution that worked:

    I pulled up each category (for example: Saturday Linky Parties), and divided it into smaller sub groups of five since my problem was only being able to display 5 at a time. (For example: SLP1, SLP2, SLP3…..SLP6).

    On the page the gallery is displayed on I used the short code [catablog category='SLP1']
    Then, in order for the rest of the sub catagories to work I have to copy and paste shortcode changing the number to correspond to the number on the catablog subcategory. This is what the final HTML looks like:

    [catablog category='SLP1']
    <code>[catablog category='SLP2']
    <code><code>[catablog category='SLP3']

    I know it seems like this shouldn’t work according to instructions you’ve provided to display gallery in posts. But, here is what I tried before doing what I displayed above:

    [catablog category="SLP1"]

    [catablog category='SLP 2'] = I don’t even know words to describe what this did. It displayed some of the images, but in no order. There appears to be no rhyme or reason as to the images that code displayed.
    [catablog category="SLP2"] = Same result as code with single quotation marks.
    [catablog category='SLP1,SLP2,SLP3'] =Nothing appears.
    [catablog category="SLP1,SLP2,SLP3"] = Nothing appears (” instead of ‘ used in code).

    Entered as (individually typing codes in instead of copy and paste, same with just single ‘ too):
    [catablog category="SLP1"]
    [catablog category="SLP 2"]
    [catablog category="SLP3"]

    The first and last categories show, but SLP2 displays nothing.

    But, when I cut and paste, and change the text in the category, each category is visable. This works with both ” and ‘. (Don’t ask why I started using ‘, but it was something that I discovered worked to accomplish something in previous troubleshooting attempts.)

    I will look into your newest suggestions over this weekend to see if they have anything to do with it. For the most part, I don’t care how it displays as long as it does somehow. 😉


    • Zach says:

      So you know, both single and double quotation marks are allowed with a WordPress Shortcode and it should make no difference. I did notice that some of your SLP2 in your comment had a space in-between the P and the 2, that would make a huge difference for which categories will be shown. Do you have an example page with the 5 items showing using just one category. (not showing all the results, your original problem)

      One issue with the brunt force method you are using is that your web server will have a much harder time rendering a page with multiple Shortcodes. You should use as few Shortcodes as you can on each page to reduce load time.

  48. zilant says:

    Hi Zach.

    How do i use the shortcode in my theme’s template if i want to display a category name A, with template B and randomly display 3 of the items in the category?

    • Zach says:

      Shortcodes are only for use inside a WordPress page or post’s content. There is a PHP function for use in your theme’s code. You may search the blog for more info on using the PHP function or ask me again for more info.

  49. Robert says:


    Why is it that you used category=’dog’ and not category=”dogs” in your post?
    Also how come only the first eight to ten images come out instead of all in that category when I put the shortcode in? Sample study page at: http://actmind.net/artdatabase/showcase/

    • Zach says:

      Hi Robert,

      Wether you use single or double quotes is not important with the Shortcode syntax, I would recommend to pick which ever you like, and stick to it. As far as pluralizing the label ‘dog’ to ‘dogs’, it doesn’t matter as long as you make sure your Shortcode matches your category name exactly.

      I am unsure why all your images are not being shown. When you use the category filter in the Admin side of CataBlog do you see all your images, or just the eight or so? Hope to help you more if necessary, cheers.

  50. zilant says:

    sorry. What i mean is how to use the php function inside my theme’s template given that i wan to display a category name A, with template B and randomly display 3 of the items in the category?

    I only know how to display category a with template b which will be

    would it be possible to include it randomly display 3 of the items in the category instead of all? thanks

    • zilant says:

      here is the code:
      catablog_show_items(“a”, “b”)

      how do i display the codes out in the reply with the php tags? sorry im a new programmer, learning codes for my school work.

    • Zach says:

      So I looked into it, and currently CataBlog does not have a limit option to limit the number or catalog item’s that are shown. I believe this was to be included in part with the pagination function in a future version. That being said you may use the PHP function with these parameters.

      <?php catablog_show_items("a", "b", "random"); ?>

  51. debby says:

    I got nothin. I made a couple of sample items, and then i added the shortcode [catablog] to a page (in the HTML view). Nothing happened. But any ideas? i am not a web designer, even though I am comfortable cutting and pasting scripts or CSS or whatnot 🙂 thanks in advance for any help — i will leave the page up for at least a day since i doubt anyone is going to see it! http://www.debbyflorence.com/?page_id=146

  52. debby says:

    ohhhh!!!! It works and you didnt even have to help me! I just checked for updates and yep had to update Catablog. Thanks!

  53. JoeMD says:

    Hello Zach,

    I’m wondering if it’s possible to limit the number of items shown. I’m planning on using two widgets as Latest Releases and Newest Additions columns on my front page. For Newest Additions, I’m simply using the [catablog order="aesc"] short code. However, I’d like to limit the number of items shown to 4.

    If this is possible, what code would I need to do it?

    Thanks in advance.

  54. Gui says:

    I can’t find a solution to my problem.
    I would like to display only ONE thumbnail for a gallery, and when you clik on it, it launches the usual Lightbox thing with a possibility to go to the next photos. It would be a bit like in your Mario page…

    Do I hate to edit the gallery.htm page or some css page ?
    Thank you 🙂

    • Zach says:

      You could easily make different categories for each collection of images you want to work with the LightBox and then use the CSS to hide all the thumbnails and then use the CSS pseudo class ‘:first-child’ to show the first item’s thumbnail inside your CataBlog category.

      Wrap ShortCodes wrap a div around each shortcode

      <div class="catablog-category">[catablog category="a"]</div>

      CSS Code to add to your style.css

      .catablog-category .catablog-row {
        display: none !important;
      .catablog-category .catablog-row:first-child {
        display: block !important;

      Let me know if that helps, you may also use the secondary images feature, but the LightBox will let users scroll through the entire category, not stopping at each item like you might expect it to.

  55. Phil says:

    Hi there. After researching a number of similar plugins for the site yours fit the bill really well. Thanks for creating it. My one issue, may not be the plugin at all but thought I’d ask, is that when I switched to ‘gallery view’ I couldn’t get it back to ‘list view’ I had to wipe the information from the plugin, delete and reinstall.
    It seems to be working now but I’m going to do a little tinkering with the CSS to get it lining up right.


    thanks again.

  56. Steve Young says:

    Hi Zach!

    We are setting up another website using catablog, it has had outstanding results for us on two other websites.

    This time we would like to use the gallery option showing only thumbnails of the images. They are a rainbow of colors and we think this would have a nice look to it. We would also like to include a second image, but that image would not be seen in the gallery. It would be seen in the lightbox is the idea.

    We have a workaround, that would be to not include the second image, then set the “link” in catablog to a page about the product with the other image on it.

    Thanks in advance for your help. The two sites we have running are http://OnTheStep.com and http://SidewalkFlyer.com if you would like to share those with others as samples of what catablog can do.

  57. Domi says:

    I’ve added the category shortcode to a page, but the description of each item is proving to cause problems. Every new line of text creates an empty line in between when I check the page in the frontend. How can I get rid of this?

  58. Naveen says:

    Hi Zach!,

    hope its an simple question like, how will show all categories in my page with links in them.


    <a href='category link which should display all products that belongs to' rel="nofollow">Cat 1</a>
    <a href='category link which should display all products that belongs to' rel="nofollow">Cat 2</a>
    <a href='category link which should display all products that belongs to' rel="nofollow">Cat 3</a>
    <a href='category link which should display all products that belongs to' rel="nofollow">Cat 4</a>


    • Zach says:

      You may put a ShortCode for each category in any WordPress page you have manually. Another option would be to use the WordPress Menu System and make a drop down menu with each category in it.

  59. Rob Yardman says:

    I love your plugin. My suggestion is making the item description to be standard WordPress WYSIWYG.

    Is this something that’s possible? I build websites for clients and this would help them maintain their product listings.

  60. justin says:

    I have images displayed in the gallery mode. When I click on a thumb it opens light box.

    I want it so when the thumb is clicked a larger image will open up in a new page with the thumbs underneath it. Also on the right side of that page I want to display the title, description, price and buy it now.

    Then, on the large image that is located above the thumb, when a user clicks it the lightbox is displayed.

    Probably a lot to ask but I will appreciate any help.

    • Zach says:

      I would start by turning on the public feature and creating a catablog-item-single.php file to control how your individual catalog item pages are rendered. The CataBlog specific data such as primary and secondary images are stored in meta data. If you need more help fetching them let me know. Then you can modify the gallery mode template so that the image is linked with the %PERMALINK% token instead of the larger image file.

  61. John says:

    Been using this plugin a while now, works great.

    Hoping this is a simple question. I would like to display the thunbnails in the order that the last new one added dislays at the top, i.e. totally reverse the didplay order. So that image number 1 displays at the bottom?

  62. John says:


    I should read all the above first.

    I used sort=”date” order=”desc”

    All ok now, thanks again for this plugin.

  63. Error says:

    CataBlog gallery is incompatible with Elegant Themes in number of thumbnails. Conflicted param is “Number of Posts displayed on Archive pages” (Number of Posts displayed on Archive pages = visible thumbnails, http://img72.imageshack.us/img72/8307/configs.jpg – template configuration page). It only affect when you are using param category=”something”.

    • Zach says:

      Thanks for the input, could you be more precise with exactly what the problem is. Is it a variable name? Do pages crash with a PHP error or just look poor?

      Also I assume the archive view is for a CataBlog Categories, true?

    • Zach says:

      What a minute…forget the last message.

      So are you saying the number of items (thumbnails) set for archive pages doesn’t affect CataBlog Category pages? That is expected because an archive page is different from a CataBlog archive page. WordPress has many “listing” pages and CataBlog makes its own which may be altered (including number of items displayed per page) with a specific template file. Read more at New Individual Catalog Item Page

  64. Laura says:

    hello – i’m using catablog for posts on this site i’m building. http://gotitgirl.com/gtig. it’s working fin on the post page http://gotoitgirl.com/gtig/217/, but for some reason the thumbnails are not active on the home page feed. can you advise what i might do to troubleshoot this issue? where to start? or is this a known issue? please let me know thanks!!

    ps, love the plugin! such a lifesaver!

  65. Laura says:

    actually please nevermind. sorry to bother, it’s clearly something on my end.

  66. AiLin says:

    I’m using the shortcode
    [catablog category="cats" template="gallery"]
    but it shows only 5 photos instead of all the 22 images of the category..

    • Zach says:

      Please try switching the WordPress editor to the HTML view and check if your ShortCode has any html tags or weird symbols or characters that sometimes occur if the ShortCode is copy and pasted.

      Other questions that might help solve the problem:
      – Is your WordPress version above 3.1?
      – Is there a typo or possible misspelling?
      – Do you have a cats category in Post Categories and CataBlog Categories?

      • AiLin says:

        the html editor is
        [catablog category="cats" template="gallery"]

        and yes, the cats category is setted in the catablog library ad there is no misspelling
        I’m using WordPress 3.3.1.

        The strange thing is that if I write
        [catablog template="gallery"]
        it shows a nice grid with all my images

        If I add the category, it shows only one line with only 5 images. It’s the same for all the category I have, even if they have more than 5 images

        • Zach says:

          I would love to see a link to the page exhibiting this behavior. Can you send me one?

          Also, have you checked your source code to see if all catalog items are their but not visible for some reason?

          Also, have you tried switching your theme to twenty ten or eleven and disabling all plugins except CataBlog? If this fixes your problem enable your theme and plugins one at a time until you find the conflict.

          • AiLin says:

            you can go to www dot miskaterriers dot it section ‘riproduttori’ and then choose the dog ‘milo’

            I really can’t figure out what’s happening

            The photos are all there and visible, in fact if I remove the “category” option in the shortcode
            [catablog template="gallery"]
            all the 80+ photos pops up in a beautiful grid.
            When I add the category, leaving all the other things unaltered, only 5 photos come up in line.

            Also, when I write
            [catablog category="cats"]
            it only shows 5 photo and this time not in line but one below the other

          • Zach says:

            Very strange indeed. I don’t see anything out of the ordinary besides that their is a <code /> tag wrapping the photo and title in the CataBlog Gallery Template. Did you do this, or is something else like your theme doing this?

            My thought are now that it is most likely the theme or another plugin. Did you try switching themes to twenty-ten or twenty-eleven? How about disabling all other plugins for the time being? Let me know if you tried these steps.

            Also, wanted to note that it doesn’t matter what order you put the Shortcode properties in.

        • AiLin says:

          a new problem popped out: sometimes it seems that all categories go mad and everytime, instead of the images of a single category, it shows off ALL images of ALL categories.

          This seems to happen when a “publisher” logs in to add a new article…

  67. AiLin says:

    what do you mean with “Did you try switching themes to twenty-ten or twenty-eleven?”
    the only plugin installed are the ones by default in wp

    • Zach says:

      So your WordPress theme is called Sky, and it is a paid theme that you or someone probably bought and installed on your installation of WordPress. You may verify this under appearance in the admin interface if you have admin privileges. I want to rule out the theme being the problem by switching themes and seeing if your problem still exists.

      To switch themes login to the admin panels and go to theme under appearance. The default themes are usually twenty-eleven or twenty-ten. Try switching to one of those themes and see if you still only get 5 results per category.

      • AiLin says:

        Mmmh, it seems to work with other templates…

        Now let’s see if the template guys will help me!

        • Zach says:

          The theme may have a hard set cap on how many posts are returned from a database call, or it could be something completely different.

          If you get any advice from them on how I could patch CataBlog to work with their theme I am more then willing to look into and consider a patch to fix this.

          • AiLin says:

            the guys of the template seems to have fixed it…

            I would have been happy id they came in contact with U..

  68. lee says:

    Hi Zach

    First of all I would like to thank you for such a great plugin, after days of looking I finally found the plugin I needed. *a paypal donation will be coming your way for such great work*

    One little problem I’ve run into. I have set catablog to run in Private mode(think its the name you give it ?) so my products generate there own pages I can link to. BTW lovely feature 😀

    One problem im running into his my single page product posts generated by catablog use my themes single-posts.php layout. ie I can see comments are turned off above all the catablog products , and a autor,data and time stamp etc etc

    I see in your notes you can create two files. that will generate a basic custom catablog layout.
    I have taken the code from the top of the page but when i put two files on my server the product page link catblog generates, now all I can see when i go to the product through the browser is a white page with a bullet point that contains the name of my category…

    If i then delete the two php files. The hyperlinks works again and I can see the product 🙁

    Any ideas what im doing wrong ? is it the two files I’m making is the code im putting on wrong or would it be where im putting the two files you say to create in the documentation..


    • Zach says:

      It is the code you are putting into the files. You should start your CataBlog PHP files with the exact same code that your single and archive PHP files have. You will need the wp_head(), the loop, the sidebar, the wp_footer() and any other standard WordPress theme parts your theme uses in your CataBlog PHP files. You may then modify the code to meet your needs by using the CataBlog PHP function or the catablog-post-meta data array. Good luck!

      • lee says:

        Thank you Zach, so basically i need to take my single php files (open them in my fav text editor) and add in those 3 basics functions..Anywhere in the file ?? then save them as

        single-catablog-items.php and taxonomy-catablog-terms.php

        put these files back onto my server and all should work as expected ??
        If so thank you very much Zach.

        PHP isnt my forte so forgive my ignorance.

    • Michael says:

      TY, i was having the same problem :O)

  69. Andy says:

    Hi Zach

    I’ve installed and started playing with your plugin, so i setup a category and added some photos to it then renamed it. Thing is, non of the images show rather i get a red cross in the box where the thumbnail should display. I dumped the shortcode into a page anyway to see if it worked and the code does work, but i get a load of small boxes with a red X in them and if i click on any of them i get a 403 forbidden error message.

    I may have installed another gallery plugin but this doesn’t seem to show in my plugin page so not sure on that one and if it was removed correctly or not?

    Any help would be great.

    • Zach says:


      I am not sure that the other gallery plugin is the problem. But, if you go to the WordPress Admin Panels and open the Plugins panel you can disable the plugin. This is all that is required to disable the plugin. If you want to remove any data that the other plugin is storing on your server I would recommend enabling the plugin and searching through its settings for a way to reset or remove the plugin data. If it doesn’t exist you may be out of luck, look online or contact the other plugin’s developer.

      The Forbidden file error message is due to your server’s permissions settings. I am unsure exactly how you connect to your server and what permissions you have but you might want to try loosening the permissions for the WordPress uploads folder and the catablog folder inside it, wp-content/uploads/catablog.

  70. Andy says:

    Ok, just FTP’d in and in the plugin folder i have a folder called ‘gallery-plugin’

    I can only assume this is causing some issue but unsure as to how i can remove this and any trace of it’s installation – can i just delete the folder?

  71. Andy says:

    Hi Zach, see the plugin i was thinking it was conflicting with isn’t showing in the installed plugin area but if i try to install that plugin again it stops and says it’s already installed. So i can’t disable it as Workpress doesn’t think it’s installed but i can’t reinstall because the plugin folder still exists. I was thinking i could delete the folder then reinstall it then disable it?

    But if you don’t think this is causing the problem do you know how i can relax the permissions on the folder. I will have a play around and see what i can change. It is the folder itself i should be trying to amend the settings on or something within the WordPress admin login?

    • Zach says:

      If the other plugin is, shall we say, half installed or busted then the best thing to do would be to use FTP to delete the folder. Just like you original thought.

      Relaxing permissions is a little trickier to explain, and it depends on your server’s operating system and the level of access you have to it. If you have a windows based server I would recommend getting in touch with your hosting company or IT department, because I can’t help you. If you have a *nix based server (linux, unix, osx) try these steps:

      The first thing I would check is the permission level of your wp-content folder and the uploads folder inside that. They should both be writable by your server’s Apache/PHP user. Sometimes this user is _www, sometimes its apache, sometimes its something completely different. Your hosting company or the apache configuration file can tell you what user account Apache/PHP is run under. If you cannot figure out the user account stuff, try setting user and group to have read/write/execute permissions on both folders, while leaving world read and execute access (octal 775).

      After that I would delete the CataBlog folder inside of uploads and then go to the CataBlog Admin Panel, you should receive a message about CataBlog being installed successfully. If you do not get this message, do you get an error message or any other unexpected outcome? Now try uploading your images again. If you still get the broken image icon go back to your server files and inspect the permission levels for the catablog folder and its content? Is the Apache/PHP user able to read and execute these files and folders? If not you may have to reconfigure your server or get in touch with your hosting company.

      One more important thing to understand and consider. If Apache/PHP does not have permission to execute folders then the files inside those folder will not be readable, even if they have permission to read the files. To reiterate, for Apache/PHP to serve a image file it must have permission to read the file and the containing folder must also be executable.

  72. Andy says:

    I thought i had replied but it doesn’t seem as though i have. Just a quick thank you as changing the permissions of the folders fixed the problem. 🙂

    Thanks Zach

  73. Erica says:

    Love the software. I am trying to use the the gallery template with a specific category. what is the correct shortcode?

    When I use this:
    [catablog template="gallery"][catablog category="quilt"]

    I see the linear catalog below the gallery. http://035311a.netsolhost.com/wordpress1/fundraising-activies/cyberquilt/gone-but-not-forgotten-quilt/

  74. Erica says:

    Hey Zach,
    I kept reading and found the answer!

  75. kean says:

    Hi Zach,

    i want to create a short description, but there’s no token for short description so that i can limit the characters in my template page. and what is the purpose of getDescriptionSummary() in CataBlogItem.class.php.

    hope to your reply


  76. Ozi says:


    I am showing images for a catalog. There are 43 images in the category but although I am not limiting anything, in the post there are only 10 images. How can I show all the images thumbs on the post?
    My shortcode is: [catablog template="gallery" category="Blake Lively Stili"]
    The page I am using it is: http://kadinsalmevzular.com/2012/02/blake-lively-stili/

    Thank you,

  77. Category dropdown is only shown on search result pages. I’m using 1.4.2. Public is switched on.
    What should I change?

    Is it possible to create a template only for photo window (when Ligbox opens the photo) I want different information under the photo that it was displayed on the list.

    • Zach says:

      Are you using the sidebar widget or the Shortcode? If you are using the sidebar widget are you sure you placed it in your theme’s appropriate sidebar? Perhaps you theme has a sidebar specific to search results.

      There is no template for the LightBox, the LightBox is JavaScript not PHP, so it is very disconnected from the data stored in CataBlog Templates. Sounds like you would need two description fields anyways, if you want the info to be different in the LightBox view than in the catalog view. I guess you could use the “product code” for a very brief description and the “description” for a more in depth description.

  78. Jahanzeb says:

    this is a good plugin so far it has solved most of my requirements but i want to know one thing
    Is it possible to show one single catablog item on a page by its id. i have to show the description and images related to a single item when user clicks its link to view more details.

    • Zach says:

      You may turn on the ‘Public’ feature in CataBlog Options to create individual pages for each catalog item. You may then create your own theme files for single and archive CataBlog pages. Read more about it on this page at Theme Integration.

  79. Hi Zach. First of all, I think it is amazing what you have created and that you keep up with your users.

    I wanted to suggest incorporating a sort by rating system. Maybe simply allowing CataBlog to integrate one of the rating plug-ins , and then allowing to sort by highest or lowest. Now, if such an option exists, I would appreciate to be pointed in that direction.


    • Zach says:

      Sorry I didn’t respond to your request sooner, I will have to look into this. Seems like a good feature for a cataloging system (of course) 😉

      One question, do you know of any rating systems that work with WordPress Shortcodes? I ask because you can enable Shortcodes in your catalog descriptions, perhaps solving this problem.

    • Zach says:

      Also, very inspiring web site, love the little square opacity transitions when I move my mouse over the image.

      • I got a rating system going for individual pages!

        I use Tweet, Like, PlusOne plug-in, which has the ability for shortcodes: http://letusbuzz.com/tweet-share-like-plusone/

        I just put the shortcode into the description. “[social4i size=”large” align=”float-right”]”

        Then of course, I checked Options > Description > Enable WordPress Filters. I did have to uncheck “Render Line Breaks” because it was looking wonky.

  80. Aman says:

    Hello Zach,
    I love your plugin, great work!
    I wanted to know if there is a way we can show a single product on a page, for example I wanna show a product with idc”27″ I could use the shortcode as [catablog id="27"]

    Any help from anyone would be greatly appreciated!


    • Zach says:

      Just curious, but why do you want to load just one catalog item per page? The Public feature will make a page for every catalog option automatically. Other people are asking for this feature as well and I am curious why?

  81. Wendy says:

    Hi Zach, I really love your plug in!

    I’m can’t get this:
    CataBlog now has a Public option, which if turned on allows you to integrate your catalog into your site. Each catalog item and category will be given a permalink.
    to work.

    I want to be able to click the item title and then show that item on it’s own page.

    And I also don’t know how or where to implement the excerpt function.

    Your help would be greatly appreciated.

    • Zach says:

      Wendy, the options you want are in the CataBlog Options Admin Panel under the CataBlog section. There you may go to the Public Tab and enable the “Public” feature, which makes a unique page for each catalog item and an archive page for each catalog category. You will have the option to change how the URLs are build with the two slug options. You may change these if you want, make sure they are not the same value though. Make sure to click save.

      Once you have enabled the Public option the default template title link will need to be changed, you should go to the CataBlog Templates Admin Panel, again under the CataBlog section. There you may edit how CataBlog renders you catalogs. Either make a new template or edit the Default template to use the below code instead of the %TITLE-LINK% token.

      <a href="%PERMALINK%" %LINK-TARGET% %LINK-REL%>%TITLE%</a>

  82. Graham says:

    I am trying to integrate catablog with the Suffusion theme. Is there some guidance / sample of the code required in the two files single-catablog-items.php and taxonomy-catablog-terms.php so that on a Page I get a listing of all the items in a category which has links to the individual posts with one item on each Post.

    On the Post I want to be able to control which fields appear.

    I have the “Enable Individual Pages and Category Archives” checked.


    • Zach says:

      Check out the Theme Integration section if you haven’t already. I don’t have any specific example files to give you, but I can tell you how to fetch the array of CataBlog values for the post. Once you have that its pretty each to just echo out the value where you need it.

      <?php $data = get_post_meta(get_the_ID(), ‘catablog-post-meta’, true) ?>
      <?php var_dump($data) ?>

      The standard WordPress tags for title, date, content, permalink, etc… will work with in your CataBlog template files.

  83. Hey Zack, I was wondering if there was a way to display a random item from a category. There is a “Featured Pest” on the homepage and it’d be nice to have a library of 10 or so that shows one of the ten randomly.

  84. [catablog limit="1" navigation="disable" category="Featured Pest"]

    This is the shortcode I’m using but the catalog is still showing more than one item. Any idea why?

    • Also I figured out the random portion as well, just the limit giving us problems

      • Zach says:

        Weird, have you tried different values for limit besides 1, just to see if they work or not? Also, if one item isn’t being displayed, how many items are being displayed? What reordering the Shortcode attributes? Try something like this:

        [catablog category="Featured Pest" limit="1" navigation="disable"]

  85. Carl says:

    When I use random sort along with a limit, each page gets randomly resorted so the same items show up more than once. Is there a way for the original search to be random, but not reshuffled for each page? Here is the code I’m using: [catablog template="gallery_cs1" category="Winter Sports" catablog limit="12" catablog sort="rand"]

    I tried putting the sort function before the limit, but I have the same problem either way.

    • Zach says:

      Carl, thanks for the heads up on the bug, will definitely have to try and figure something out for this problem. The issue is that each time the browser loads a page all the catalog items are fetched, randomly reordering the items on each page load. This is the desired affect in most situations, but when you change catalog pages with the limit feature you also reload the page, thus resorting all the items again. I am not sure there is an easy and simple solution to this bug, perhaps disabling the navigation feature on randomly sorted catalogs or using AJAX and Javascript to load the different catalog pages without reloading the main page and somehow remembering the first randomly sorted order of catalog items. Either way it would require freezing the random order on specific pages and unfreezing the random order on others, not trivial.

  86. S Adams says:

    Hi there. GREAT plugin btw. Thanks.

    im a little new to code, and im struggling to make a page that displays single items. the idea being that once i display a category, and it list lets say 5 items,… i want to be able to click on each item, and it display just that single item in page on its own.

    if so, could u try to step by stept instruct me as best as possible.
    thanks in advance.

    Keep up the good work

  87. Hey,

    I really love the plugin. The only thing I can’t figure out, though I’m sure it is absurdly easy, is how to make the catalog show up in two columns, not one long one.


  88. judy volkening says:

    I am new to Catablog. I know some HTML and CSS. But I cannot figure out how to show 3 images horizontally in one row instead of only one image per row. I tried some code but the first image showed up three times in the first row; the second image showed up three times in the second row; the third image showed up three times in third row; etc. How can I get the first three images to show in the first horizontal row; then the next 3 images in the catablog in the next horizontal rows, etc. How do I fix this problem?

    I did figure out how to show an affiliate link in the one catalog item per horizontal row; but I cannot figure out to show three items per row and go the next row with 3 more new items.
    Catablog seems to be a nice tool.

    • Zach says:

      First, make sure to reset your template back to what it was originally. The remove all data option can help with recovering the original template.

      Once the template is recovered, add the following CSS code into either your theme’s style.css file or make a file named catablog.css in your theme’s folder. You can use a FTP program to edit or add files to the appropriate directory.

      /* file: wordpress/wp-content/themes/current-theme/catablog.css */
      html body .catablog-catalog .catablog-row {
        float: left;
        width: 33%;
        padding: 0;
        margin: 0;
        border: 0 none;

      You can also read the Multiple Column Tutorial to get step by step instructions.

      • judy says:

        Thanks so much for all of your documentation. I am find a lot of information in it; however, I am missing something. I am not sure what.

        I created a catablog.css file and loaded it into my WP Suffusion theme.
        Here’s what I see in WYSIWYG editor for catablog.css:

        .catablog-catalog .catablog-row { font-family: ‘arial’; font-weight: bold; color: #101010; } { float: left; width: 200px; padding: 5px; margin: 5px; border: 1px color: #101010 solid; }

        .catablog-row {
        border: 1px #101010 solid !important;
        float: left;
        width: 200px !important;
        padding: 10px !important;
        margin: 10px; !important;
        .catablog-row .catablog-image {
        float: none;
        .catablog-row .catablog-subimage {
        width: 50% !important;
        float: left;
        .catablog-row .catablog-title {
        font-family: arial, verdana !important;
        font-size: 22px !important;
        color: #101010 !important;
        .catablog-row .catablog-description {
        display: none !important;
        I believe the above will create 2 images per row.
        Now how do I reference the above in a catablog-template?

        I am experimenting with the creation of a catablog-template to use the overrides. Here is the content of the catablog template I was creating to use the above overrides found in the catablog.css file.

        <div style="text-align:center;

        What am I misunderstanding?
        Thanks for helping me to put the pieces together.
        This is very new to me.

        • Zach says:

          The CSS Code and the CataBlog Template are different things, as I think you all ready know, that need to be used together in unison to customize your catalog.

          The Template is used to control exactly what content is displayed and how it is “marked up”, what html tags are used. You may edit the template in the CataBlog Templates Admin Panel, underneath the Library and Add New sections of CataBlog. There you will see a tab for each template you have, simply make new templates or modify the existing ones to modify what content should be displayed.

          The CSS part of the equation is for controlling how that content is displayed. CSS should not be used to add another image or remove the description, but instead use it to decorate the content you have. This means borders, fonts, colors, backgrounds, things of that nature.

          I hope my explanation was helpful and good luck.

  89. Agus says:

    Hi Zach….
    I want to use catablog the my jcarousel….
    So I need to remove the wrapper div(ecatablog-catalog) in order to make this carousel works
    I’ve used jquery dom(remove and unwrap) but it doesn’t seem work
    Can you tell me what should I change to remove all the wrapper div…

    • Zach says:

      Funny, originally I didn’t have a wrapper div for this exact reason. But eventually the wrapper div worked its way in, and well, that is that. Why not implement jcarousel like this?


      • Agus says:

        Thanks for the advice
        I’ve already tried it…..
        But it doesn’t work
        I think that the jcarousel only works with the ul tag….

        • Zach says:

          I guess that means currently you will have to hack the plugin, looking through the code base for class='catablog-catalog and manually changing those tags.

          Eventually it would like to add an option to let admins configure exactly what kind of wrapper tag is used to render catalogs.

        • Zach says:

          You could try this Javascript before you run jcarousel to convert the CataBlog divs into an unordered list.

          $('div.catablog-class').each(function() {
            $(this).children().each(function() {
              if ($(this).hasClass('catablog-row')) {
                $(this).replaceWith($('<li class="catablog-row">' . this.innerHTML . '</li>'));
            if ($(this).hasClass('catablog-class')) {
              $(this).replaceWith($('<ul class="catablog-catalog" skin="jcarousel-skin-name">' . this.innerHTML . '</ul>'));

  90. David says:

    Hi Zach

    Great plugin! I’m going to use it to display a discography and have set categories such as CD and 7 inch single and song title. I’ve set the ‘Public’ feature so that each item in the discography generates its own page – and placed the Permalink in the Link Field so an image in the gallery links to the permalink.

    My question is embarrassingly simple – how do I get comments for each of the pages generated? I have comments for each of my other pages but they don’t appear for any of the others.

    Looking forward to your help!

    • Zach says:

      This has been talked about before, and currently, you will have to hack the plugin. But it is possible with some effort. How comfortable are you with PHP? If you want I can try and compile a guide in a blog post with some basic instructions. Ideally this will be a configurable feature in the future.

      • David says:

        Thanks Zach – I’m glad it wasn’t me overlooking something obvious! Unfortunately I’m not comfortable with PHP at all. It looks like I might have to wait until you incorporate this as a standard feature before I publish my discography as the whole point of having the discography is to get people commenting!

        Keep up the great work!

      • David says:

        I’m still loving the plugin – thanks so much!

        On the subject of enabling comments on Catablog generated pages, I use the WordPress plugin Wordbooker to post from my WordPress blog to Facebook and to post comments backwards and forwards between them. If a Catablog generated page appears in Facebook, Wordbooker will post any comments back to WordPress and the comments appear – it’s just that you can’t enter them or reply to them in WordPress itself.

        I’m feeling more comfortable with PHP now, so if you wanted to give me that guide it would be very much appreciated 🙂

  91. Love your plug-in! I am a novice at this so please forgive me for asking a trivial question. I am building a catalog and want to use the “store” template. How do I change from the default to the store template? What code and where to place it? I have tried many ways with no luck.
    My short code on my catalog page is this [catablog_gallery id="193"]. Can that be altered to switch to the store template? I am using this plugin on WordPress.

    • Zach says:


      First make sure you give your catalog item’s a price value, if their price is zero than the buy now button will not be rendered. The default template should render buy now buttons if your catalog item’s have a price above zero. Also, make sure to modify the store template, where it says %PAYPAL-EMAIL%, replace that token with your paypal account’s email address. Good luck.

      • Thanks Zach.
        I put the price in the library table along with the product code, but when I go to the catalog page on the site neither will show up there. The instructions say that I have to use the store template, but I don’t know know how to tie the template to the catalog page. I am not getting buy now buttons, I get “add to cart”. What am I missing?

        • Zach says:

          Ok, good to know you added a price. If you do not specify a template in your Shortcode, the default template will be used. You may edit the default template in the CataBlog Templates Admin Panel. You should go and check that the default template has the %BUY-NOW-BUTTON% somewhere in its code. If it does not add it in.

          The store template is right underneath the default template and it should have a PayPal button in it by default. You need to set your PayPal account email address here.

          Can you give me a link to an example page? Makes everything a lot easier. Also, did you change the email address in the store template?

  92. Thanks Zack. Will give it a try tomorrow.

  93. Just after I replied I remembered that the catalog is not showing my prices and product code that I had listed in the library. I thought I needed the store template to get those to items added to the catalog.

    • Zach says:

      For those simply go to the “default” template and add either of these tokens into the HTML, %PRODUCT-CODE% or %PRICE%. So your default template would look something like this.

      <div class='catablog-row %CATEGORY-SLUGS%'>
        <div class="catablog-images-column">
        <h3 class='catablog-title'>%TITLE-LINK%</h3>
        <div class="catablog-description">
          <p>$%PRICE% - %PRODUCT-CODE%</p>

    • Zach says:

      The store template is always enabled, so need to enable it. The store template is solely for the purpose of rendering the ‘Add to Cart’ button and can be thought of as a template inside a template. The store template is used by the default template to render the paypal button.

  94. I had a problem adding the info to the store code and lost it.. Is there a way I can get the default store code back?

    • Zach says:

      Here is the default, please note the tokens, such as %PRICE%, %PRODUCT-CODE% and %TITLE-TEXT%

      <form method='post' action='https://www.paypal.com/cgi-bin/webscr' target='paypal'>
        <input type='hidden' name='cmd' value='_cart'>
        <input type='hidden' name='business' value='YOUR EMAIL HERE'>
        <input type='hidden' name='item_name' value='%TITLE-TEXT%'>
        <input type='hidden' name='item_number' value='%PRODUCT-CODE%'>
        <input type='hidden' name='amount' value='%PRICE%'>
        <input type='hidden' name='shipping' value='0.00'>
        <input type='hidden' name='currency_code' value='USD'>
        <input type='hidden' name='return' value=''>
        <input type='hidden' name='quantity' value='1'>
        <input type='hidden' name='add' value='1'>
        <input type='image' src='http://images.paypal.com/en_US/i/btn/x-click-but22.gif' border='0' name='submit' width='87' height='23' alt='Add to Cart'>

  95. Let me tell you what I did. Paypal generated code for me to place on my site to generate the pay now button. I removed the code in the store template and replaced it with the paypal code. The catalog comes up ok and has the palpal button. The problem is that when it goes to paypal it does not pick up my product info like the name, and price. I thought that perhaps I should not have deleted the original code in the store template. Can I get it back?

    • Zach says:

      So what you need to do is modify your existing paypal button code to use the CataBlog tokens, the most important tokens for your button are: %PRICE%, %PRODUCT-CODE% and %TITLE-TEXT%. I posted the original store template above, it can also be found in the plugin code base at /wp-content/plugins/catablog/templates/views/store.htm

  96. Kirk Hall says:

    Hi. I am using catablog plugin and it was a badly needed one so thanks. However I’m struggling with the “limit” shortcode function and can’t seem to get it to work. On this page, http://wp.karlsbridal.com/?page_id=25, I have 7 items set up using the category Mori Lee Bridal and I am using the shortcode on the page as [catablog category="Mori Lee Bridal" catablog limit="2"] and as you can see each page shows the same items. I have tried the twenty ten theme and twenty eleven theme and I get the same result. What am I missing?

    • Kirk Hall says:

      actually it is not that every page shows the same item but that the page doesn’t change when you click the page numbers. I just noticed that.

    • Zach says:

      So the problem that you are having is that while you have more than one page in your catalog, you can’t leave the first page.

      My first thoughts are that your Shortcode has a syntax error and should be corrected to look like this:

      [catablog category="Mori Lee Bridal" limit="2"]

      If removing catablog before the limit attribute doesn’t fix your problem you could try setting up pretty permalinks with post names, that might help the catalog leave the first page.

      • Kirk Hall says:

        The permalink / post name thing did the trick. Who would of thunk it? Thanks.
        But, there’s always a but isn’t there? If you check the page now I changed the limit to 5 and it does change pages, which is nice but the word “Previous” is showing on page one instead of “Next” like you would expect and on page 2 the work “Next” shows instead of “Previous” which is all that should be there as I type this as there is no page 3. Ideas to fix that or am I not understanding how the Previous/Next thing works?

        • Zach says:

          Did you remove the second occurrence of catablog from your Shortcode? That very well could be your problem.

          • Kirk Hall says:

            Yes. The shortcode on that page is [catablog category="Mori Lee Bridal" limit="5"]
            I see that I can just remove the words in the Navigation options of catablog so that will do if I have to go that route. Might be a conflicting plug in but I disabled some of them and it did not make any difference. Nope, that isn’t it, it’s the theme. I enabled twenty ten and the previous/next worked as it should. Dang, it’s always something.

          • Kirk Hall says:

            A little nugget for others. When using Catablog the plugin “Widget Context” does not work correctly, use plugin “Display widgets” which does the same and it works fine.

  97. Brad Waller says:


    Just updated to the latest version and now I’m having display issues. I call an image, then catablog. It used to show the image, then the series of thumbnails under the image. Now, I see two thumbnails on top of the image, then the rest of the thumbnails from catablog under the image.

    When viewing the code, everything is in the catablog div tag (code snipped below) even though they are not called this way. The image in the tag is the one that should be before all the catablog images.





    Any idea how to fix this so it displays properly with the large image on top and catablog thumbnails underneath?

  98. Brad Waller says:

    Sorry, Missed the note about the pre tags…

    Just updated to the latest version and now I’m having display issues. I call an image, then catablog. It used to show the image, then the series of thumbnails under the image. Now, I see two thumbnails on top of the image, then the rest of the thumbnails from catablog under the image.

    When viewing the code, everything is in the catablog div tag (code snipped below) even though they are not called this way. The image in the tag is the one that should be before all the catablog images.

    <div class="catablog-catalog">
      <div class="catablog-row catablog-gallery">
      <a href="link" class="catablog-image">
        <img src="jpg" alt="">
        <strong class="catablog-title">Title</strong>  
      <div class="catablog-description"></div>
      <div class="catablog-row catablog-gallery">
      <a href="link" class="catablog-image">
        <img src="jpg" alt="">
        <strong class="catablog-title">Title</strong>  
      <div class="catablog-description"></div>
      <p><img class="alignnone size-full wp-image-1519" title="Title" src="jpg" alt="" width="546" height="296"></p>
      <div class="catablog-row catablog-gallery">
      <a href="link" class="catablog-image">
        <img src="pg" alt="">
        <strong class="catablog-title">Title</strong>  
      <div class="catablog-description"></div>

    Any idea how to fix this so it displays properly with the large image on top and catablog thumbnails underneath?

    • Brad Waller says:

      The “code” on the WP page is:

      <img class="alignnone size-full wp-image-1519" title="Title" src="jpg" alt="" width="546" height="296" />
      [catablog category="herbie" template="gallery" navigation="disable"]

    • Brad Waller says:

      One more update. I was using WP Online Store, and when I disabled that plugin, display went back to expected.

  99. Kirk Hall says:

    Is there a way to push the thumb nails down?
    All my girls heads are cut off. heh! I realize they are selling dresses and not the girls but I was just wondering if there is a way.

  100. Hi Zack,

    Is there a way to add descriptions below each image in the gallery template?

    I looked through the documentation but don’t know what i’m looking for…the description i read about was when you assign a direct link to the image from the gallery in a post.

    I would really rather then create a new post for each image have a short description below each image in the gallery…

    Thank you,

  101. lydia says:

    hi zach,
    i read through your docs about sort orders. i see that our current choices are sorting by title, date, menu order, and random. it looks like the default ‘order’ does fine with using the order from the input csv, so that’s all fine. what we actually want is to sort by item SKU, which we can do by ordering the csv. the question is, do we then have any way to insert a new item anywhere other than at the bottom of the list? the workflow he’s trying to duplicate here is that he adds new items gradually on the site, but doesn’t need to rerun his import until he does ~quarterly price updates. is it possible to do that here, or are we going to need him to reimport his whole catalog each time he adds an item, in order to preserve the item-number sort order?


    • lydia says:

      …we could build some kind of hack using the date field, i suppose. write a formula in excel that autoincrements by some amount that leaves room to create a new item later in between. is there a better way?

    • Zach says:

      CataBlog does it’s best trying to be a silver bullet that excels in all situations. Unfortunately WordPress has to play a balancing act between cheap hosts with few resources and dedicated servers with tons of memory.

      This is why CataBlog does all it’s database manipulation with core WP functions, meaning any “column” you want to sort by must be its own metadata database row. I fear if I make every CataBlog column sortable then it will slowly clog some blogs with unnecessary data rows. While there are obvious solutions (mark which columns should be sortable) they require significant development time, time I don’t currently have.

      I would use date for ordering, since it is less abstract then an integer. You can also pad your order number in your CSV file (100,200,300,400… Instead of 1,2,3,4…)

      Regardless, thanks for the interest in CataBlog and good luck figuring out a solution.

      • lydia says:

        constraints understood, just wanting to make sure i’m getting our options.

        but what you say raises a different question: the behavior i’m getting is that the import completely ignores our “order” column, imports in the order of lines presented in the CSV, and then its default sort by “order” sorts by the order of the lines in the CSV. if we actually _did_ control the sort using the “order” column, that would of course solve the whole thing. is that what’s supposed to happen?

  102. Jose Guillen says:

    Is there any way to show just a list of the Categories???

  103. pierre says:

    Hi zack, i have try to customize the navigation in the catablog.css file.

    And it work!… Except for the current page.

    This is what i put in the css file…

    html body .catablog-navigation .page-numbers .current {
      padding:0px 2px 4px 2px;
      border: 2px solid #000000;
      color: #000000;
      font-weight: bold;

    But it don’t work… Can i fix it?

  104. pierre says:

    Hi zack
    how can i delete catablog-items in my permalinks?


  105. AiLin says:

    a new problem popped out: sometimes it seems that all categories go mad and everytime, instead of the images of a single category, it shows off ALL images of ALL categories.

    This seems to happen when a “publisher” logs in to add a new article…

  106. Hi,
    I’m using your plugin for a t shirt website (currently under pwd entry) and tried posting a category in a page with a “limit” paramater. The naviation for a PG2 appears in the page but doesn’t click to the destination. How can i fix?


  107. Zach,
    I recently installed CataBlog, was very impressed with its features and functionality, and built it into a website I maintain for a client for an online catalog. Just display items, no e-commerce or anything like that. All was going well, and I was uploading entries at a rate of about 100 per week, when suddenly, without me making any admin changes other than adding library entries, the post with the shortcode just stopped displaying anything but the title. I am totally befuddled. I am using the latest versions of WordPress and CataBlog. Any advice you could give me would be greatly appreciated.

  108. Manu says:

    Hi Zach,
    I found a bug with fr_FR internatz :

    Error : SyntaxError: missing ) after argument list
    Line : 650, Col : 27
    Source Code : alert(‘Veuillez tout d’abord sélectionner au moins un objet dans le catalogue.’);

    To fix it I replace the com

  109. Manu says:

    Hi Zach,
    I found a tiny bug with fr_FR internatz :

    Error : SyntaxError: missing ) after argument list
    Line : 650, Col : 27
    Source Code : alert(‘Veuillez tout d’abord sélectionner au moins un objet dans le catalogue.’);

    To fix it I replace single quote with double in the js alert:

    alert("<?php _e("Please select a bulk action to...

    lines 276 & 283 in

    Regards, thank you for the plugin !!

  110. After much experimentation, it seems as though I’ve hit a “ceiling” as to how many images I can have in the library. I’m at roughly 430 images, and adding one more simply makes the post disappear; same short code. Has anyone else experienced this? Is there a workaround?

  111. How can I sort by price when displaying in a post or page

  112. José Amador says:

    Hi Zack great plugin! I LOVE IT. It make the work in a very simple way. I´m not understand anything about CSS or HTML. Im also ask you forgive my english can be pretty rusty (I´m from Venezuela). I dont know how change the CSS or the HTML and every time I tried to do it in the past it´s been a hell for me. I can´t tell you how many time I have lost uninstalling and installing the theme because I change something I should not change in the CSS (following confusing tutorials and my english it’s very basic so tech english it’s a nightmare). Here it’s the thing I’m already know how to display my gallery. That’s fine. But it only show 3 rows (i’m guessing this is default) and let a awful space in the right side of the post. I think it’s enough space there for another thumbnail. I don’t know how add it. I tried to do the Multiple Columns tutorial but as I told before I don´t understand tech english. This it’s my site: http://uniformesgalenos.com/linea-quirurgica-damas/#
    I´m really thank you if you can help me.
    Great work Zack!
    (I´m guessing other users will laugh of my post)

  113. Tarun says:


    Let me start by saying that I love the plugin. I have a simple question. I want to place a ‘View All’ link in the sidebar after I show the image gallery. I am using the gallery plugin. Can you please tell me where I need to place this link?


    • Zach says:

      I would make a separate page that shows the entire catalog and then add a view all link (which goes to the page you just made) in the page that shows a paginated version of the gallery. Make sense?

  114. Cédric says:

    first, thanks for this amazing plugin !
    I’m french, maybe it’s one of the reason i don’t understand everything on tutorials !

    I try to use the public function in catalog but i can’t.
    Maybe i forget something.

    I duplicate the single.php file of my theme and rename it single-catablog-items.php
    (also tryied with page.php)

    what i don’t understand is how the page is generated, when a new item is created ?
    anyway, nothing happen for me

    sorry, i think it looks pretty stupid no ?

    thanks for help


    • Zach says:

      Make sure you go to Catablog Options and enable the public option, also make sure you go to permalink settings and use something besides the default (page ids). The page is not generated, it is the catalog item, so you make the page when you make a catalog item.

  115. TaniaW says:

    Hi there,

    Fantastic plugin Zach – thanks!
    I am trying to change the Thumbnails Height and Width but as soon as I type anything into that field, it disables the “Save Changes” button. I have 4 items in there already – could that be causing it?

    Any tips would be greatly appreciated. I am using WordPress 3.4.2 and Catablog 1.6.3



  116. Laura says:

    Hi Zach
    I want to use CataBlog for one of my projects. There is one thing I seem to be getting stack with and this is to resize the thumbnail image displayed in categories. I have tried changing the thumbnails size but the ‘save as’ bottom turns grey – is there any other settings I need to change in order to make it work? This is the link: http://bitesofdesign.com/?page_id=35

    I have figured something out but the photo is pixeleted so I think I am missing some points:
    .catablog-row {
    border: px #333 solid !important;
    float: none;
    padding-top: 30px !important;
    margin-bottom: 10px;
    .catablog-row .catablog-image {

    .catablog-row .catablog-subimage {
    float: left;
    .catablog-row .catablog-title {
    font-family: helvetica, sans-serif !important;
    font-size: 22px !important;
    color: #dddddd!important;
    padding-left: 110px !important;

    .catablog-row .catablog-description {
    padding-left: 110px;

    }.catablog-image img {
    max-width: none !important;
    float: none;
    height: 200px !important;

    Looking forward to hearing your comments.
    Thank you

    • Manuel says:

      Hello Laura, I have tested the resizing of the images under the plugin settings and it works for me. There must be a plugin that is conflicting with your Catablog plugin and that is the reason why your button turns grey. You could try and disabling your plugins and enable one by one to see which one is the culprit. Also what version of WordPress are you running?

      Kind regards

  117. Dirty Bird says:

    I’m new to WP but not to PHP programming, and am having one issue so far with your plug in. I am able to create products and link them to a gallery. Using the ‘shortcode’ I’m able to run that in my loop for the index page. Where I’m having issues is getting each thumbnail image, when clicked to spawn it’s own page with the details about the product. Right now it just links to the image, or a hardcoded url if i put one in when uploading the product. Would appreciate any help, and no worries, ill do the whole review/like thing once i get this working. thx!

    • Manuel says:

      Hi Dirty Bird, have you tried to enter a unique URL on each product? I did a test and I entered a link to an image “product” and added the shortcode to my page. When you click on the image it takes you to the URL. I know that this might be the long way to achieve this goal but it does work.

      • Dirty Bird says:

        Thanks for the reply Manuel. Is there not a way with the public option to create a single page for each item somehow using the “single-catablog-item.php” file? I just cannot get it to work! I could create a template for individual pages, and create a static page for each and link to that, but that kind of defeats the purpose of using a plug in. I would greatly appreciate any help.

        • Manuel says:

          Hello Dirty Bird, the way to achieve this is to put a unique link name in your item link field.

          For example:
          Your item name is pear, add the word pear in your link field and that creates a unique link for that item. So when you view your item in your website you will notice that the name pair has a link. Clicking on that link will take you to a single URL for that item.

          Let me know if this helps you.

  118. Max says:

    Hi, Zach
    Great plugin.
    I use the plugin in a project, but I have a problem with it
    I use the short code limit, it did limit the items that show in the page.
    However, when I click the next button, it stays on the same page and shows the same items. Can anyone help me to solve the problem. Thx.

    <div class="catablog-navigation">
    <span class="catablog-navigation-link catablog-first-page-link catablog-disabled">Previous</span>
    <span class="page-numbers current">1</span>
    <a class="page-numbers" href="http://localhost:8888/wordpress/?page_id=4">2</a>
    <a class="page-numbers" href="http://localhost:8888/wordpress/?page_id=4">3</a>
    <a class="page-numbers" href="http://localhost:8888/wordpress/?page_id=4">4</a>
    <a class="next page-numbers" href="http://localhost:8888/wordpress/?page_id=4">Next</a>

  119. Wilhelm says:

    Hi, thank you for this plugin.
    I have a little problem that i need your help with. so far everything is working well.

    My problem is that I dont like how the navigation looks. it lists the pages in a vertical order with each page on a new line, and i would rather it did it horizontally. I thot that it was a quick css fix but i realized that you actually have tags doing this. how can I fix this?

    thank you

  120. hy there,

    i hope someone will read this for a quick solution.

    to display a archive page and a singe product page u have to insert the shortcode

    [catablog template=archive] to your page where you want to show your product archive’s

    go to wp-admin -> catablog -> options -> public-> and Enable Individual Pages and Category Archives:

    and then you create single-catablog-items.php and add it to your template folers ( wp-content/theme/yourtheme)

    inside the single-catablog-items.php page you past the wordpress loop :

    now your catablog page will show the archive and when u click the permalink you will be taken to the product details page.

  121. Beth says:

    Hi Zack,

    Great plugin thanks! Is there any way to sort by product code? I’m wanting to be able to display a category of products by their title on one page and by their product code on another without having to duplicate the items (over 900) as individual products.


    • Manuel says:

      Hello Beth could you give me an example of what you are trying to achieve please.

      Kind regards

      • Beth says:

        Hi Manual,

        Say I have:
        Main Category X:
        Product Title 1 – Product code A
        Product Title 2 – Product code B
        Product Title 3 – Product code C
        I want to be able to call it by short code by category on two pages:
        Page 1 – Category X – sort by title
        Page 2 – Category X – sort by Product code


  122. Manuel says:

    Hi Beth, I see what you are trying to achieve. Have you tried the following short code for sorting by title?

    [catablog sort="title"]
    [catablog sort="title" category="x"]

    In regards to sorting by ID, there is a short code at the present for sorting by ID. There is a short code for ascending and descending but I am not sure if that would help you.

    [catablog sort="date" order="desc"]

    These are the only values at the present that can be used for sorting; title, date, menu_order or rand.

    I hope this helps you. If you have more questions please let me know.

    Kind regards

    • Manuel says:

      Sorry I wanted to say there is NO short code at the present for sorting by ID that I am aware off.

      Kind regards

      • Beth says:

        Thanks Manuel,

        That’s what I thought, but wanted to check before I duplicated all of the items using their ID as the title so that I can sort that way. There are over 900 items so it doubles to over 1800. Do you think they’ll be a sort by ID added any time? Would this be a hard hack?

        Thanks for your time,

        • Manuel says:

          Hi Beth, in regards to your question you would have to ask Zach the plugin developer.

          However have you thought of organising your products by categories? You could you categories and then sort by title……..I am sure this would help you eliminate the duplication you mention above.

          Kind regards

  123. Beth says:

    Hi Manuel,
    All products are in categories and I do use them to sort by title. The problem is I need the user to be able to find the product by two means, first by popular name (title) and second by ingredient (product ID). Here’s a crude example:
    Product Title: Windex
    Product ID: Ammonia
    I need to be able to sort it by both alpha, so I see no other way than to duplicate, using the ingredient as the title and putting it in it’s own category.

    You guys are great. I really appreciate the support.

    • Manuel says:

      Hi Beth I see what you are trying to achieve. When you say the Product ID are you referring to the Product Code?
      Could you post here your URL so that I can check.

      Kind regards

  124. Matt says:

    First of all, great plugin it’s exactly what my client needed for his site. I am running into some kind of bug however.

    I have separate pages set up for each category on the site and when I try to add in sorting in the shortcode it doesn’t display the correct products. On some products it doesn’t show the thumbnails either. When I remove the sort parameter it displays fine.

    This is the shortcode I was using: [catablog category="backhoes" sort="title" limit="10"]

    I’ve had to remove the sort and the limit parameters for it to display all of the products, but why would either of those in there cause this to happen?

  125. The pagination dosent work!!!!!….. and i dont know what im doing wrong…………. i have 2 galleries and both in diferents categorys……. so i want to show all my items in the category “bags” and thats easy… i want to make it with a template and thats easy too…. i put the limit atributte and it works, but when i clik in next or on the number 2….. it dosent work… it shows the same product page…. it dosen go to the second page…..

    • Zach says:

      Did you try changing your permalinks setting to anything but the default setting? Pagination doesn’t work when permalinks are set to default.

  126. Kernel says:

    Thanks for offering catablog. My only need, specific to the type of blog i’m using is a way of having a second thumbnail size. How would i achieve a seperate thumbnail size for a gallery that uses a wide format, i.e.:


    When most thumbnails for a standard comic are properly displayed, i.e.:


    Any ideas of achieving this, without having to re-edit (.php) when catablog is updated? Preferably with a custom template option.


  127. projecet.developer says:

    down vote
    I am using catablog plugin in wordpress. My site has at least three languages so i want to change texts on lightbox which are “Prev” and “Next”. Therefore, I start to study on this issue and i found this file in plugin directory: \catablog.1.6.3\catablog\js\catablog.lightbox.js

    Although, I changed texts inside the function of calculateMeta, nothing is changed on my web site. Any suggestions?

    the code is : function calculateMeta(row) { var row = jQuery(row);

    if ((typeof js_i18n) == ‘undefined’) {
    var prev_tip = ‘bbbbbb’;
    var next_tip = ‘aaaaaaa’;
    var close_tip = “Close LightBox Now”;
    var prev_label = “PRiV”;
    var next_label = “NEXT”;
    var close_label = “CLOSE”;


  128. Zach,

    So I just got all of my food posts set up into various galleries according to type (main course, dessert, etc.). It’s awesome you’ve created something that finally makes it so easy for me to do this and the galleries are categorizing everything perfectly, but I’m having a few issues with how they’re displaying. You can see everything here: http://www.domestiphobia.net/recipes/?preview=true&preview_id=8978&preview_nonce=dc9f7acdf0

    1. I didn’t care for the tiny 100x100px thumbnails in my gallery display, so I used the “thumbnails” tab under your plugin options to change the size to 200x200px. But now they’re all pixilated! I know the images are high enough quality that they should not look pixilated at 200×200, so do you know what’s wrong?

    2. Every time you hover over an image in any column except the far right column, all of the images shift. You just have to do it to see what I’m talking about. How do I fix this?

    3. Is there a simple way for me to get rid of the text that says “previous” below each gallery? As far as I can tell it’s not a link, so I’m not sure why it’s even there…

    I’m a complete neophyte when it comes to this website stuff, so thank you so much for creating something that allowed me to get even this far with relative ease. I would one day love to understand how CSS and the rest of that works so I can customize the look of my galleries even more, but for now this is perfect! (Or, at least it will be once I can get these 3 issues fixed.) Thanks again!!


    • Oh crap that link was a preview page. Sorry! Here’s the real deal: http://www.domestiphobia.net/recipes/

      • Okay, please ignore #3. I see you already answered it in the post, which for some reason I missed the first time through. The other questions still apply, though. 🙂

        • Manuel says:

          Hello Katie, here is my reply to your questions.

          1) You are using 100 x 100 images and increasing them to 200 x 200 that will cause the pixelated effect you are experiencing.

          2) Can you post here how are you adding the chortcodes to the recipe page? Also have you set in place the correct settings for the lightbox?

          Let me know how you go.

          Kind regards

          • Manuel says:

            sorry type error

            chortcodes = shortcodes……..

            My apologies….

          • Thanks for responding, Manuel!

            1. I’m not using 100x100px images. When I first added each catablog item, I uploaded web-sized images. Actually, I think they’re a full 300dpi so they’re even larger than web size… The thumbnails in catablog were originally set to 100×100, so does that mean catablog automatically shrunk all of my images down and in order to get 200×200 I’d have to re-upload them all with the setting already at 200×200??

            2. This is how I’m posting the short codes: [catablog_gallery id="8732" navigation="disable" template="gallery"]
            (with a header above each one describing the gallery category)

            Thanks again!

          • I’m not sure what the correct settings for lightbox are… I don’t know much about lightbox, but when you click each of my images, it’s supposed to take you to a post. So I don’t think I even want to use lightbox!

          • Zach says:

            To correct the pixelation please run the regenerate images function in the CataBlog option’s system tab. It is a long process for large libraries, so I may not automatically do it anymore. When you change thumbnail size I think there is a note in the message explaining…perhaps it needs to be larger or more prominent.

          • Thanks, Zach! I ran the “regenerate images” function but am not seeing an improvement. (Thanks, I did not notice that note when I changed thumbnail size.) Maybe it needs more time to show the changes…?

            And I’m still having that same issue with images shifting when I hover over them. Did I do the shortcode correctly? [catablog_gallery id="8732" navigation="disable" template="gallery"]

          • Zach says:

            I’ll have to look at the page in question about layout, don’t have the time right now to do that.

            About the images, please try emptying your browsers cache or holding the shift key while clicking refresh on your browser a few times. Hope that works, if it doesn’t I’m not sure…

          • Zach says:

            You did the Shortcode correctly, it is a CSS issue. You theme is adding a small border to the bottom of every anchor tag that is hovered over, this small border is what wrecks the flow of the catalog items. This CSS should fix it, removing the bottom border on hover for the catalog items:

            .catablog-gallery.catablog-row .catablog-image:hover {
                border-bottom: 0 none;

          • Zach says:

            Also, I checked, and your images are indeed 100×100 pixels, still. Can you double check that the catablog options are correct? Also, when you ran the regenerate function, did you let the progress bar finish completely? Depending on how many images you have this could take some time. Good luck 🙂

          • Your CSS solution worked PERFECTLY. Thank you!!

            I definitely let the regenerate thing run through completely – a couple of times! I only have 90 items so it didn’t take too long. What options am I supposed to have set in order to enlarge the thumbnails? All I changed was the thumbnail size setting under “thumbnails” in CataBlog options. Reading Manuel’s comment from earlier, I recently enabled LightBox (I hadn’t previously because I thought that was simply used to view thumbnails full-size when clicked, and I’m using my thumbnails as links), but that didn’t work either. I also re-loaded one of my fullsize images into a CataBlog item just to see if I was going to have to manually re-upload all of them, but that didn’t work either. Still pixillated.

            Is there some other setting I’m supposed to change? Or maybe my theme is causing another issue? You know, when I load some smaller images (like a link to UrbanSpoon), I have to put the code class=”no-responsive” into the html tag to keep it from enlarging due to the theme. Is there another CSS setting I should try to see if these thumbnails are being affected by my theme?

            Thanks so much for your patience with me. I seriously do love this plugin and can’t wait to use it to organize my entire site!

          • Zach says:

            Hmmm, I’ll have to think about it and try and figure out if it is even possible for a theme to mess up the thumbnail rendering. You are correct in your assumption that the LightBox is only used to view the full size image, and has nothing to do with the thumbnail. I agree that you do not want LightBox enabled for your current setup.

          • Zach says:

            So I believe the problem with your thumbnail resolution is due to your site using the Photon plugin and service. Ideally CataBlog would detect and fix your problem automatically, but for now you will have to fix it manually. Photon is WordPress.com’s CDN and you are using it for your site’s images. The CDN allows people to download imagery from your site faster, but requires specific parameters in the image’s url if you want a certain size. There is more documentation on Photon at http://developer.wordpress.com/docs/photon/.

            The solution is to edit your CataBlog Template to specify the resolution you want by adding ?w=200&h=200 after the %IMAGE-THUMBNAIL% token, like this:

            <div class="catablog-row catablog-gallery">
              <a href="%LINK%" class="catablog-image" %LINK-TARGET% %LINK-REL%>
                <img src="%IMAGE-THUMBNAIL%?w=200&h=200" alt="" />
                <strong class="catablog-title">%TITLE%</strong>  
              <div class="catablog-description">%DESCRIPTION%</div>

          • Manuel says:

            Hello Katie, when you upload a full size image are you making sure that you are using the recent uploaded full size image? Are you making sure that you have deleted the previous pixelated image? Do you have a cache plugin installed? Make sure that the image you deleted is completely removed from your server. Then clear the cache on your browser and any where else that you might use cache.

            I also agree and sorry for asking to implement lightbox. Zach and you are both correct in not setting up the lightbox in accordance to your settings. Sorry about that 😉

          • I fixed the template code and still no dice. 🙁 I asked the theme developer (who isn’t usually very helpful anyway), and all he could say is that it looks like I’m using 100x100px images initially, which I’m not…

            You did get me thinking about my various plugins, though, and I noticed the one I installed called WP Super Cache when I was having all kinds of problems with page load time. I deactivated that, loaded a new photo, and it works! (Though I’m not sure whether due to the combination of your code and deactivating the cache or just the cache alone.) Unfortunately, simply deactivating Super Cache and then regenerating the images doesn’t fix the pixillation for all of them, so it looks like I’ll have to individually re-upload each one and remember to deactivate super cache if I ever want to change the size again…? BUMMER.

            I’m not sure whether that makes any sense at all, but it’s the best I can come up with. 🙂 Thanks SO much again for your help!! I’m not looking forward to re-uploading everything, but it’s definitely awesome I can still have the thumbnails the size I want. Thanks!!

          • Ugh, maybe not. Now the couple of new ones I’ve added still aren’t showing up… even after I regenerate. Maybe it’s still some kind of cache problem. I don’t know. Time to walk away for now… 🙂

          • Manuel says:

            I am glad you were able to resolve most of your issues. In relation to your images not been generated I am almost 100% sure that it is a WP Super Cache.

            What I mean to say is that WP Super Cache works well but but sometimes you need to regenerate all cache and of course don’t forget to delete your browser cache as well.

            If we can be of more assistant let us know.

            Kind regards

          • Thanks, guys. I really appreciate the help (and sorry this thread is so long!). Just FYI, I have been getting an error when I regenerate, though for some reason I’ve been ignoring it thinking it’s had nothing to do with my problem: SyntaxError: JSON Parse error: Unrecognized token ‘<'

            If you think that might be an issue, please let me know! Thanks so much again – still love the plugin. 🙂

          • Manuel says:

            Hello Katie, that error is coming from the following Unrecognized token ‘<' character. Somewhere in your code you have ‘<' which is causing the error message. It might not even have anything to do with catablog.

            When did this error begin to appear?

          • It just appears every time I regenerate. Always has. Doesn’t really bother me since everything else seems to be working…

          • Manuel says:

            Hello Katie, I understand what you mean however as a rule of thumb when ever you see errors popping up it is best practice to address them even if everything else works.

            The reason that I am saying this is that one error can generate another error in the future. However some errors are just warnings more than errors. Only when you are satisfied with your analysis and research and know that it will not cause any more issues you allow it to exist.

            Here is a link that might help you in the future http://validator.w3.org/. Remember there many websites that can also assist you.

            Kind regards

  129. benvds says:

    I can’t seem to find how to apply the options to the auto generated pages (“Enable Individual Pages and Category Archives”). I’d like to sort them by title, is this possible?

    Many thanks in advance!

    • Zach says:

      Yes, but it is controlled by your theme, not CataBlog. You should modify your theme to sort category archive pages by title. If you only want to affect CataBlog category archives, use a conditional check of the category type in your code.

  130. Michele says:

    Hi I installed your catablog plugini, and is absolutely perfect I would like to know if it is possible to generate a PDF and then print the catalog

    • Manuel says:

      Hello Michele, unfortunately not at the present as far as I can tell. Unless you install a plugin that prints or generates pdf files. The only option you have at the moment is exporting it as an xml file.

      Kind regards

  131. M&M says:

    Hey Zach,

    I have one gallery, named ‘paintings’. I put several images in this gallery and gave them a different order. I also made a single item page, so the paintings can be viewed separately. This works perfectly fine.

    Now I’m trying to get a ‘next’ and ‘previous’ link in the single item page, which follows the order of the gallery order. But now it seems to take the order of the library, instead of the gallery. Changing the order in the library isn’t an easy task, so is there another way of achieving a gallery order for the single item page?

    Thanks in advance!

  132. Niklas says:

    Hi. The plugin looks great. Is it possible to add or delete fields? Say, I want to add a field for an authors namn and also another field for text?

  133. Hi, I installed qTranslate on my site since i want it to be bilingual. qTranslate added a Spanish tab on the Post Editing Panel so i could type my posts’ description in Englsih and Spanish as well. Apparently Catablog looks like a blog but didn’t let qTranslate apply this feature. My question is: How can i display my catablog items using a specific template when they are viewing the site in ENGLISH and use another template when they are viewing the SPANISH version.

    When i add the catablog shortcode to my page with the purpose of displaying my items, it’s easy because i just type the template i want inside of the shortcode; But i don’t how to do this in the SINGLE VIEW which is when customers are seing a specific 1 item.

    Please help!

  134. Holly says:

    Hi Zach,
    very nice plugin! I appreciate your hard work and don’t want to disturb you, but have a problem with image order. Whatever i do ( different themes, different browsers, different templates..) images stay at the default order – can’t sort them by title, date; can’t make them descending. In my admin panel i can change the order, but not in public page. Use this shortcode [catablog_gallery id="661" order="desc" limit="48" template="gallery"]. The limit function is Ok.
    Use WP 3.5.1, pressbiz theme 1.0

    Any ideas?

  135. Igor says:

    BUT I have some problems with PAGINATION.
    I don’t know why, but it doesn’t work. In fact it apears when number of items is more then the limit, but it doesn’t work:(
    when pressing on “NEXT” or “2” or “3” links – the page just reloads itself and doesn’t show next items:(
    please HELP!

  136. Tamara says:

    Im trying to style my catablog, for some reason the paypal button is generating a bunch of hidden p tags and other code thats causing the paypal button to be way off and not aligned with the rest of the product information. I deleted all the code and started from scratch and that doesnt seem to be fixing it. Not sure what to do. I dont want to go into the PHP and delete it because i dont want the button to not function properly. Help please.

  137. Xencored says:

    Howdy, I am very confused about the single page per image.

    I’ll tell you want I am trying to do and if you could tell me if I have the right idea via using your great addon

    I have a page called gallery on this page ive added [catablog_gallery id="2222" template="gallery" limit="40"]

    The page shows 40 thumbs perfect but when one is clicked it takes me to the raw image file .png etc… I want to take me to a page where people can comment on the image.

    Can this be done or do I have the wrong about about this plugin.

    (P.S I want the rest of wordpress to run as normal so am using your addon as a gallery only (No buying or selling etc…))


    • Zach says:

      The single page per image feature allow you to create a “page” with its own permalink and its own comment thread. Although, you will not be happy to hear that having comments on the single “CataBlog Item” page may be a bit harder than it should be…

      The first thing you need to do is go to the CataBlog Options panel in the WordPress Admin. Once there, switch to the public tab and check the enable individual pages and category checkbox. Now click save. You can modify the permalink path in this panel too.

      Next you should go to the CataBlog Templates panel in the WordPress Admin. There you should click the “new+” button to add a custom template. Name your new template something like “my-gallery” and click create template. Now we want to copy the gallery code into our new template and replace the anchor tag’s href attribute, which is %LINK%, with %PERMALINK%. Here is the modified code you should be saving in my-gallery:

      <div class="catablog-row catablog-gallery">
        <a href="%PERMALINK%" class="catablog-image" %LINK-TARGET% %LINK-REL%>
          <img src="%IMAGE-THUMBNAIL%" alt="" />
          <strong class="catablog-title">%TITLE%</strong>  
        <div class="catablog-description">%DESCRIPTION%</div>

      After pasting make sure to save 😉

      You can view a page with all the supported template tokens at: Making Custom Templates

      Now goto your “gallery page”, the one you put the Shortcode in, and modify the Shortcode to use your new template, could look something like this:

      [catablog_gallery id="2222" template="my-gallery" limit="40"]

      Save and view the page, if you click on an image it should go to a single “CataBlog Item” page…this page will most likely not look perfect. You will need to create a file in your theme’s folder to customize the rendering of single CataBlog Items.

      Go to your webserver, and copy the single.php file inside your active wordpress theme’s directory, the new copied version of the file should be named single-catablog-items.php. Now you may modify this file to change exactly how the CataBlog data is rendered on that page. The trick to accessing the CataBlog data is using php to fetch the WP Post Meta. This is an example from CataBlog Theme Integration that will help explain how to fetch and than use the specific CataBlog data:

      /* get special catablog item data */
      $data = get_post_meta(get_the_ID(), 'catablog-post-meta', true) 
      /* renders the data array in text */
      /* renders just the sub-images data array in text */
      /* the path to the main image */
      echo $data['image']; 
      /* the item's title */
      /* the item's content */
      /* the item's product code */
      echo $data['product-code'];
      /* render an html image tag for the main image */
      echo "<img src='.$data['image'].' />"

      Hopefully that helps. As far as getting comments to work on that single page, it should work if you have support for comments in your theme’s single.php file. If it does not, you may want to try modifying the wp custom object declaration in CataBlog.class.php.

  138. Zach Donovan says:

    Thanks again for making this extension Zach. I had a quick question for you: For some reason, I’m unable to show more than 5 items on a page regardless of how I form my short tags. Currently,

    [catablog category="category" limit="10"]
    is the way that the catablogs are being called but it will only show a maximum of five items.
    Settings > Reading > “Blog pages show at most” is set to 10
    Any thoughts as to what I should try next?

    • Zach says:

      I would check your theme or other plugins, one of them might be overriding the query limit somewhere. Best way to check is to temporarily disable other plugins and use the twenty-twelve theme. Good luck and let me know what you find.

  139. Gonzalo says:

    Hi Zach, thanks for the plugin. One question, is there a way to list the categories showing one image from a product inside the category??

  140. sonia says:

    Hi Zach,

    I have a litte issue with catablog. Actually i’ve installed the french version and as you can see here: http://www.cocoonallure.com/diy-inspiration/ , the image is not displaying well so I would to know how to fix it. Thank you

  141. Val Vesa says:

    Hi Zach,

    great plugin man and thanks for the super job.

    One question: currently the plugin is listing the items in ONE column, going DOWN vertically.
    Can I make it so that it lists the items HORIZONTALLY, within the theme’s page width, from left to right, just as a normal enumeration, as it can be seen in the following example I drew : http://oi42.tinypic.com/v8mq68.jpg


  142. Jeff S. says:

    On my -products- page, I want to show multiple catablog galleries, each with a different title. It appears that I can’t get a Catablog to start on a new line. Admittedly I’m novice, but is there a way to put multiple gallery view catablogs on a single page, and have then display one underneath the other? Might this be being caused by the Theme I’m using? Is this against the grain of the conceptual recommendation of Catablog?

  143. Gavin says:

    i’m utilizing the link feature for each picture in my catablog gallery, but i’d like the link to open in a new window instead of redirecting visitors from my site. How do I change this? I’m assuming in the gallery template code, but unsure exactly what to include.
    I explored the wordpress plugin support page for a resolution to this, and was directed to this post. I’ve skimmed most of it and have not found an answer.


  144. Rebeca says:

    Love the plug in till it stopped working! Not sure what happened, but it was working for over a week and then for no reason I started getting an error across the top of all my page and the only to remove it was to deactive the plug in. Here is the error:

    Notice: Undefined index: QUERY_STRING in /hermes/bosoraweb092/b2084/ipg.rebecaklinewdcom/creativedominican/wp-content/plugins/catablog/lib/CataBlog.class.php on line 221

    Any ideas? I even deleted and reinstalled it several times and still having problems.


  145. Chris says:

    Hi Zach,

    I can’t for the life of me figure out how to center the gallery. I read through and tried this;

    “instead of using a center tag, you need to wrap your catalog in a div that has the width set to the exact width of your five column catalog, then give it a left and right margin of auto so it will center itself. This is simple CSS code, look into centering block level elements if you need more help.”

    Could you please kindly tell me how I can achieve this? I tried what I thought was the right thing to do to no avail.

    Thanks in advance,


  146. Charisse says:


    How do I activate the archive pages for catablog? I already enabled the Public option and created the two extra files, however the products for the respective category are still not being displayed. Could it be a incompatibility issue? I’m using the twenty thirteen theme and another plugin for a different section of my site.

  147. bu11frogg says:

    Hi Zach,

    You are a patient man! Thank you for helping so many of us out. I’ve addressed 95% of my issues and concerns just by searching your comments here!

    The one thing I cannot figure out — and I’ve got custom CSS, heavily customized templates, etc. so I know enough to get around HTML and CSS reasonably OK — is the PHP stuff. No matter what I try, I can’t get CataBlog items to show up as posts. I really like the Lightbox implementation, but I would love to take advantage of the ability to show items as posts.

    I’ve made copies of the existing PHP files, renamed the copies to the file names you’ve suggested, and copied & pasted the code you provided into the PHP files in various places that looked like they might work. But…I’m guessing your suggestions were based on the premise that the user had some relative intelligence regarding PHP and, sadly, all I know about PHP is how to spell it.

    Can you provide an example — perhaps using the the twenty-ten (or some other simple, common) theme’s PHP files as examples?

    Thanks for your time on this, I really appreciate it!


  148. Halconio says:

    Hello Zach,
    This is a very nice plugin, thanks!!!

    I´m trying to create a gallery in my site and Catablog is perfect!! just a question, I don´t want to store large images in my wordpress content file, so what I´m doing is just uploading thumbnails (small size images) and then writing down the external link for each one (linked to my Flickr site where images will be shown in very large size), but it is possible that external link also works when you click on the thumbnail and not only when you click on the title?

    By the other hand, when I click on the thumbnail, the image appears turn-sided, Is there any option to change it to its normal side?

    Here’s my site, where you can see what I’m trying to explain

    Thank you very much

  149. Benny says:

    Mobile / Responsive help!!!

    Hi, thanks for e great plugin!!!
    I’m struggling with the layout for [catablog] in a public page.
    My main issue is to make every item post responsive an mobile friendly. I’m not a html/CSS ninja… Is there a easy way to solve this problem?
    What I want to achieve is that each item (image, title and description) are left aligned with no text wrap around the image, and that each item is separated by a devider. Ideally, in a responsive way.

    Please help, I’m stuck…

    PS. I’m also having trouble with showing [catablog template="gallery"] on mobile (iPhone iOS 7 Safari) – clicking a image will not open lightbox (nothing happens?) – works fine on desktop.

  150. Riccardo says:

    Hi Zach,
    on my homepage I added:

    [catablog category="Amici a 4 zampe" template="gallery-perm" navigation="disable" limit="1" sort="rand"]

    Now I would like to refresh every X seconds this 1-pic gallery. How can I do?


  151. Hi Zach,
    I’ve been searching for a gallery plugin that will allow me to create a recipe index using pictures rather than just links. So far I have a few galleries set up, but I really don’t want the title to appear to the right of the image. I would prefer to be able to have five columns with the title below the image. I’ve scanned through the forums and tried different things, but I’m very new at this and getting frustrated to the point of giving up and going somewhere else. Will you help me?

  152. Guillermo says:

    Hi Zach!
    I am developing my first site with wordpress and find your catablog plugin very useful. I am following this tutorial and the displaying-your-catalog-in-posts tutorial, to customize the public category pages of my catalog. To summarize, I have included a taxonomy-catablog-terms.php file in my theme directory, which includes a call to the function

    <?php catablog_show_items($term->name, 'my_template', 'menu_order', 'asc', 'IN', 12, true); ?> 

    The template my_template’ is a custom template, similar to the gallery template. Eveything works fine, except for pagination. As an example, if the public category page is http://akebartesania.es/catablog-terms/category1/, the next-page button links to http://akebartesania.es/catablog-items/item12/?catablog-page=2, instead of
    http://akebartesania.es/catablog-terms/category1/?catablog-page=2 as it should.

    I think this is due to get_permalink function not working as one may expect for archive pages (or anywhere outside ‘the loop’). I solved this issue by changing the lib/Catablog.class.php file in the plugin, concretely line 2501 in function frontend_build_navigation. Instead of using


    to construct the base url for navigation, I use the current url:
    home_url( $wp->request )

    (variation of this tip to get the current url).

    I am pretty new to php and wordpress, and maybe my understanding of how the catablog plugin should be used is wrong, but I wanted to post in case this is useful to you or someone. I am unsure if this change would break some other use cases, though.

    Best regards!


  153. Hi Zack, I’m trying to add a product list for a particular category in my sidebar (embedded in the theme php). My client wants a way to show a “quick list” of items in the category being viewed so they don’t have to page down in order to get to a particular product. Right now, the catablog_show_items() function shows the images and I only want the link or title to show.

    Here’s the code I have:

    <?php if ( is_page ( 'poly-playsystems' )) { ?>
      <h3>Poly Playsystem Listing</h3>
      <?php echo "Poly listing goes here"; } ?>
      <?php catablog_show_items( 'Poly Playsystems' ) ?>

    Also, here is the link to my test site if you want to see what I’m trying to accomplish.

    Thanks for your plugin and your help.


  154. I just noticed that my catablog pages are not working anymore. They just show the code and say “Could not find a CataBlog Gallery with id ”1268″ ” on my page now. How do I fix this? It was working as of a couple days ago.

    • Zach says:

      Hi Rachel, can you give me any more information? Does the admin section still work? Can you delete the old gallery and remake a new one?

      I would remove the [catablog_gallery] shortcode from your page to fix that, and then remake another gallery and try using the new gallery. I’m unsure what happened that would mix up your gallery ids, do you have any ideas? Was the WordPress 4.0 upgrade a possible culprit in your situation?

      Thanks for the help and sorry for the late response.

  155. vince says:

    I would like to keep the catablog plugin BUT…

    is this supported or abandoned?
    can we make this mobile friendly?


    • Zach says:

      CataBlog is actively supported, but not in development. That means I am not working on new features, but I will fix breakage with new versions of WordPress. Currently CataBlog works fine in WP 4.1.x.

      What part do you want mobile friendly? The admin side or the front-end? If all you are concerned about is the front-end, it is rather trivial to roll your own stylesheet that will make CataBlog mobile friendly.

      Thanks again for your interest in CataBlog and have a wonderful day.

  156. Michele says:

    Hi mate, thanks for your awesome plugin! 🙂 I’m trying to customize it to fix a problem on mobile version of my site. See there: https://s31.postimg.org/vsp4xq0rv/Screenshot_2016_07_30_12_53_50.png

    I see all the description text vertically but i want to put some text under the thumbnail image to fill all the post. Is it possible?


  157. Fathermck says:

    how can i enable comments in a single catablog page (Item) ?
    Comment are enabled in all my blog.
    Comments are working fine everywhere.
    But they are not working in my single-catablog-items.php.
    I’ve tried to insert this code everywhere inside single-catablog-items.php but it always gives : “Comments are closed”:

      $withcomments = true;
    <?php comments_popup_link('Aucun Commentaire &#187;', '1 Commentaire &#187;', '% Commentaires &#187;'); ?>

    Can you help me please ?
    Thanks & Regards.

  158. Ana says:


    Your plugin is great. Thank you. But I wanted to put the Categories drop down list in my page. I’ve used the shortcode [catablog category=" "], but it has just filtered the products, but didn’t display the dropdown box. Could you tell me how can I do this?


Leave a Reply

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

Please wrap any HTML markup or code with the pre-formatted tag: <pre> </pre>