The Piecemaker for WordPress – Documentation

Hello Friends,

Good news is now The Piecemaker is available for WordPress as well. What does it mean? Well, now you can add PIecemaker 3D flash image gallery by modular web with as little effort as possible. Following are the simple steps required to install and configure The Piecemaker WordPress plugin

First of all, download plugin from WordPress Extensions site and activate it.

You will see link for options page in Settings tab of wordpress admin area, as per following image.

The Piecemaker for wordpress options page

There are two kind of options are available,

General Options

1.       Select Category

If you select category here, following two options ( Image URL’s and Image Descriptions) will be irrelevant. Slideshow will be build by posts in this category. You have to add extra custom field in post named ‘the_piecemaker_image’ and url of image as value of that field. Make sure you use relative URL starting with root of your wordpress installation. Post excerpt will be used as the description of the image with ‘Read More’ link pointing to the article page. If you chose this option, don’t forget to rebuild cache each time you publish new post in category you choose here.

2.       Image URL’s

If you have selected to use manual configuration for slideshow, add relative URL of images, starting with root of your wordpress installation, each on new line. You can add as much image URLs as you want, there is no limitations.

3.       Image Descriptions

Add description for each image separated by line break here. There is limited support for HTML tags in this field. You can use following tags,

<a href="" target="_blank">hyperlinks</a>

Complete description for single image should be something like below, make sure you enter everything in single line that belongs to single image. Add empty line break if you don’t want to have description for image.

4.       Width

Set width of slideshow in PX, Set it to the width of image you are using for slideshow. Use all image of equal size for better presentation.

5.       Height

Set height of slideshow in PX, Set it to the height of image you are using for slideshow. Use all image of equal size for better presentation.

6.       Shadow

Select this is you want to display Shadow below slideshow.

Advanced Options

Each of them are self explanatory and have description at the bottom of field. I am just mentioning its name here; in bracket is its default value. Feel free play with it to see the effect. To set it back to default, just leave that field empty.

1.       Segments (7)

2.       Tween Time (1.2)

3.       Tween Delay (0.1)

4.       Tween Type (easeInOutBack)

5.       Z Distance (0)

6.       Expand (20)

7.       Inner Color (#111111)

8.       Text Background Color (#0064C8)

9.       Shadow Darkness (100)

10.   Text Distance (25)

11.   Auto Play (12)

At last there is option named ‘Rebuild Cache’ in red box. Each time you change any of above option, you have to check it to update options in configuration file of the plugin. Uncheck it once confirmed the changes are applied to improve performance.

The Piecemaker for wordpress rebuild cache

How to Display

To display The Piecemake slide show as per configured in options page, you can publish The Piecemake widget at suitable sidebar position of your theme.

If you can’t find suitable sidebar position available to display slideshow, copy and paste following php code in your templates file where you want to display the slideshow,

<?php if (function_exists(display_the_piecemaker())) display_the_piecemaker(); ?>

Tags: , , , , ,

59 Responses to “The Piecemaker for WordPress – Documentation”

  1. fila
    May 19, 2012 at 2:43 pm #

    hi i create a new post i add a new category which i called test then i add a custom field called the_piecemaker_image and the url of the image /wordpressv/wp-content/uploads/2012/04/shipping1.jpg. then i choose the category from the option panel and i saved it . it steel keeps loading the loading first image. what did i do wrong ?

    • Neerav
      May 19, 2012 at 5:31 pm #

      Hi Fila,

      Please use absolute url ( starting with http:// ) for image in custom field. I assume you have selected that category and check rebuild cache tickbox to get you changes reflected in The Piecemaker option. If not do that as well.

      Let me know if you still can’t get it working.


  2. Derrick
    May 15, 2012 at 5:03 pm #

    Nicely done. Saved my money buying an expensive Cu3er or other 3d license. Will donate for sure. Just keep up the development.

    Would like to maybe see some additional features in the future.

    Thanks again.

  3. Sefo
    March 14, 2012 at 5:39 pm #

    Have you modified piecemakerShadow.swf?
    I want to remove the LOADING FIRST IMAGE section, and if I replace with the original piecemaker.swf (changing the name to ..shadow), doesn’t work.

    • Neerav
      March 17, 2012 at 6:21 pm #

      Hi Sefo,

      yes, Its modified to work dynamically with XML file.


  4. 2en
    March 13, 2012 at 8:57 pm #

    how do you center the piecemaker, it seem to be align to the right

    • Neerav
      March 17, 2012 at 6:22 pm #

      Hi Michael,

      Its center aligned by default! If you still need to fix position, you may have to dig into the code.


  5. Rezo
    February 6, 2012 at 12:54 am #


    thank yu for great job.

    Question: how can i use cyrillc (Russian) in Info or Read More-Link???

    Thank you for answer

    • Neerav
      March 17, 2012 at 6:39 pm #

      Sorry Rezo,

      Cyrillic letters are not supported by this plugin.


Leave a Reply

You must be logged in to post a comment.