Installation
Q - I've activated Post-Thumb, need I do anything now?
A - Yes, you need to go to the options screen and set-up options. You need to do it in order for Post-Thumb to work properly. First thing to check here is your server confiuration. Post-Thumb requires GD library version 2 installed on server.
Q - There are others things in the "System check" section...
A - To be able to use remote files, you will need php higher than 4.3.0 and init_fopen_url set to true.
Q - I'm on the option screen and get an error message.
A - First thing you need to setup is "Base path" and "Full domain name". This is done in the "Location settings" section.
Basic Usage
Q - How can I show a thumbnail for each post on my blog page?
A - Ah! There, you will have to modify your theme template. A typical (aka default aka kubrick) index.php file shows the Loop like this:
Just insert:
were you want it to appear.
In order to be consistent with a thumbnail presentation, you will also have to change the display of the post content.
For this, use the_excerpt. This way:
Q - Duh! I've put the_thumb in my loop, but the result is awful.
A - Ah, yes, you've just inserted the thumbnail. Formatting display is another thing.
Post-Thumb has several way for you to adjust display the way you want:
1. The most straightforward: use the post display class and adapt CSS. Example with kubrick theme: .entry img & .entry a img
2. You can wrap the_thumb() with whatever html tag you want and adapt CSS.
3. You can add a specific class to the thumb like this:
and adapt CSS.
4. If you don't want to go into CSS, you can also use the ALIGN parameter:
. However, be aware that this syntax is not xhtml compliant.
Sidebar Usage
Q - How can I display the most recent posts in the sidebar?
A - If your theme is widget ready, you can use the pt-recent widget.
If not, just insert:
were you want it to appear.
Q - I've added
in my sidebar, but it's far from what I expected.
A - Okay, you've done the most difficult, don't give up now!
Now go to your option screen and read carefully each option in order to adjust the display to whatever you want.
Q - I've changed the
option on the option screen, but nothing has changed.
A - Well, each time you refresh a page, Post-Thumb automatically calculates the thumbnails of the page and check if they exist. If they do, it doesn't create them but retrieves them from the server. This is a way to save resources by not loading images and calling graphic routines each time.
So, if you change a display option, you need to delete the existing thumbnails (and then, your browser cache) to see the changes.
Q - I've deleted the old thumbnails, but they still appear!
A - Have you cleared your browser cache?
Q - So you say I need to delete the thumbnails. Isn't that risky?
A - Not at all. They were created by Post-Thumb. And what it has created once, it can create it again and again. It will just slow down your page first time it's refreshed, but no other consequences.
Q - I've set-up everything. It works fine except that it's a real mess!
A - Well, we have a CSS issue there. It's not really possible to have a unique code to insert in a blog because there are so many different themes and different CSS. Formatting has several ways to go.
The function call can use some parameters like this:
Tag1 will be inserted before each thumb, tag2 after each thumb, tag3 before the whole display, tag4 after the whole display.
Example:
', '', ''); ?>
In addition to this, you can use MYCLASSHREF and MYCLASSIMG parameters which add a class to resp. the href link and the img src.
Q - How not to use highslide effects?
A - Uncheck "Use highslide" in "Highslide settings" on Options screen.
Q - How to have square thumbnail?
A - Uncheck "keep ratio" in "Image settings" on Options screen. Use same width and height in "Resize width x height" option.
Q - How to display a list of random thumbnails in the sidebar?
A - insert this code:
.
Advanced Usage
Q - I'm using the recent widget (or get_recent_thumb) in my sidebar, but I get a vertical list of thumbnails.
A - You need to add some CSS in your theme's style.css file like .wid_recent li { float: left; } or else.