Foliopress Wordpress Testimonials Plugin Users Guide

This guide will show how to embed Foliopress Testimonials into a page/post and into template.

Posts:

To embed Foliopress Testimonials you need to insert special text into the text of the page: Testimonials: {option}]

{option} can be one of the following:

• all - This will output all approved testimonials in the order specified in menu
• {number}F - Will output featured, approved testimonials. Number can specify how many testimonials will be outputed. (examples: 5F - 5 featured, F - all featured, 1F - only first featured)
• {number}C - Will output approved testimonials which are in category specified by number.

These were options which cannot be combined together. Now options that can be combined together:

• -f - Featured.
• -c {number} - How many testimonials to output.
• -i {coma separated IDs of testimonials} - Will include these testimonials as well.
• -e {coma separated IDs of testimonials} - Will exclude these testimonials from output.
• -img {(small,medium,large)} - Will specify the image size.

Options that are available only in PRO version:

• -e first {number} - Will exclude first 'number' of testimonials
• -cat {coma separated IDs of categories} - Will output only testimonials from specified categories

Other very useful feature of PRO version are templates. Putting
'-t {number}' will specify the output to be in certain template.

Examples for combined options:

Testimonials: -f -c 5 -i 42 -img large]

This will output first 5 featured testimonials, and if Testimonial with ID 42 is in first five results, it will be outputted as well. The image outputted will be large.

Testimonials: -e 15,22]

This will output all testimonials except for testimonials with IDs 15 and 22.

Theme template:

Sticking testimonials into template can be done with php function fpt_get_testimonials which takes 0-4 parameters. This function is only available in PRO version of Foliopress Testimonials.

Parameters:

1. Array of options key => meaning:
   • 'where' => {array of key and value} where key is for column and value is the expected value. The array may also be "structured where array"
   • 'order' => {array of key and value} where key is for column and value can be ASC or DESC
   • 'limit' => {value} where the value can specify count or offset, count, just like in MySQL syntax. Actually it has to be written in MySQL syntax
2. Boolean that specifies if the output should be echoed (true) or returned (false) as a string.
3. Integer for template ID
4. String for size of the image (possible values: 'thumb', 'small' ,'medium', 'large')