Slider Widget

Used with: [testimonials_slider], testimonials_slider()

Title
Validatation: wp_kses_post.
Usage: title="Testimonials"
Title Link
URL, path, or post ID to link widget title to. Ex: http://example.com/stuff, /testimonials, or 123
Validatation: wp_kses_data.
Usage: title_link="You decide…"
Adaptive Slider Height?
Dynamically adjust slider height based on each slide's height.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: adaptive_height="true"
Stop scroll on hover?
If checked, slider will not scroll when mouse hovers over the testimonial slide.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: scroll_on_hover="true"
Bottom Text
Common text or HTML for bottom of testimonials.
Validatation: wp_kses_post.
Usage: bottom_text="You decide…"
Character Limit
Number of characters to limit non-single testimonial views to.
Validatation: absint.
Usage: char_limit="10"
Keep Whitespace?
Keeps testimonials looking as entered than sans auto-formatting.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: keep_whitespace="false"
Rotation Speed
Number of seconds between testimonial rotations or 0 for no rotation at all refresh.
Validatation: absint.
Usage: refresh_interval="5"
Show Play/Pause?
Display start and stop buttons underneath the testimonial slider.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: show_start_stop="true"
Slide Width?
Width of each testimonial. Increase to thumbnail width or greater for improved looks. Requried for horizontal transitions.
Validatation: intval.
Usage: slide_width="10"
Transition Mode?
Type of transition between slides.
Options: fade, horizontal, vertical
Usage: transition_mode="fade"

General

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Default Reviewed Item?
Name of thing being referenced in testimonials.
Validatation: wp_kses_post.
Usage: item_reviewed="Sherry Phillips Swatek"
Default Reviewed Item URL?
URL of thing being referenced in testimonials.
Validatation: filter_var( $url, FILTER_VALIDATE_URL ).
Usage: item_reviewed_url="http://sherryphillipsswatek.com"
Disable built-in quotes?
Remove open and close quote span tags surrounding testimonial content.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: disable_quotes="false"
Disable "Testimonials Not Found"?
Remove "Testimonials Not Found" content when no testimonials are found to be displayed.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_not_found="false"
Enable Paging?
Show paging controls for `[testimonials]` listing.
Options: false, 1, before, after
Usage: paging="1"
Enable [shortcodes]?
If unchecked, shortcodes are stripped.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: do_shortcode="true"
Enable Video?
Only enable when displaying video content.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: enable_video="false"
Remove `.hentry` CSS?
Some themes use class `.hentry` in a manner that breaks Testimonials' CSS.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: remove_hentry="true"
URL Target
Add target to all URLs; leave blank if none.
Validatation: Word-only characters to make a single term. Regex #^\w+$#.
Usage: target="termname"
Use `<q>` tag?
Not HTML5 compliant.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: use_quote_tag="false"

Fields

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Hide Title Above Content?
Don't display testimonial title above testimonial content.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_source_title="true"
Hide Author?
Don't display testimonial title in cite.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_source="false"
Hide Company?
Don't display testimonial company in cite.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_company="false"
Hide Content?
Don't display testimonial content in a view.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_content="false"
Hide Email?
Don't display or link to testimonial email in cite.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_email="true"
Hide Gravatar?
Don't display Gravatar image with testimonial.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_gravatar="false"
Hide Image?
Don't display featured image with testimonial.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_image="false"
Hide Image in Single View?
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_image_single="false"
Hide Job Title?
Don't display testimonial job title in cite.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_title="false"
Hide Location?
Don't display testimonial location in cite.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_location="false"
Hide URL?
Don't display or link to testimonial URL in cite.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_url="false"

Selection

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Category Filter
Comma separated category names or IDs.
Validatation: Word-only characters including hyphens and spaces to make a multiple or single terms. Regex #^(([\w- ]+)(,\s?)?)+$#.
Usage: category="Category A, Another category, 123"
Exclude IDs Filter
Comma separated testimonial IDs.
Validatation: Digit-only characters to make a multiple or single entries. Regex #^\d+(,\s?\d+)*$#.
Usage: exclude="3,1,2"
Include IDs Filter
Comma separated testimonial IDs.
Validatation: Digit-only characters to make a multiple or single entries. Regex #^\d+(,\s?\d+)*$#.
Usage: ids="3,1,2"
Limit
Number of testimonials to select per instance.
Validatation: A non-zero intval.
Usage: limit="10"
Require All Tags?
Select only testimonials with all of the given tags.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: tags_all="false"
Tags Filter
Comma separated tag slugs or IDs.
Validatation: Word-only characters including hyphens and spaces to make a multiple or single terms. Regex #^(([\w- ]+)(,\s?)?)+$#.
Usage: tags="Tag A, Another tag, 123"

Ordering

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

ORDER BY
Used when "Random Order" is disabled.
Validatation: Word-only characters to make a single term. Regex #^\w+$#.
Options: ID, author, date, menu_order, title, none
Usage: orderby="ID"
ORDER BY meta_key
Used when "Random Order" is disabled and sorting by a testimonials meta key is needed. Overrides ORDER BY.
Validatation: Word-only characters including a hyphen to make a single term. Regex #^[\w-]+$#.
Options: false, testimonials-widget-title, testimonials-widget-email, testimonials-widget-location, testimonials-widget-company, testimonials-widget-url
Usage: meta_key="Pick an option"
ORDER BY Order
Validatation: SQL ordering "ASC" or "DESC". Regex #^desc|asc$#i.
Options: DESC, ASC
Usage: order="DESC"
Random Order?
If checked, ignores ORDER BY, ORDER BY meta_key, and ORDER BY Order. Widgets are random by default automatically.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: random="false"

Premium Fields

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Hide Excerpt?
Don't display testimonial excerpt in a view.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_excerpt="false"
Hide Ratings?
Don't display testimonial ratings in a view.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_ratings="false"
Hide "Read more" Links?
Don't display testimonial's read more link in a view.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_read_more="false"
Hide "Read more" Links On Excerpts Only?
Don't display testimonial's read more link in a view when there's only an excerpt.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hide_read_more_no_content="false"

Premium General

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Add `nofollow` to "Read more" Links?
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: nofollow_read_more="false"
Default Rating?
Default new testimonial rating.
Options: 1, 2, 3, 4, 5
Usage: default_rating="5"
Force "Read more" Links?
Overrides Hide "Read more" Links.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: force_read_more="false"
Link Image?
If checked, wraps image in link to testimonial.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: link_image="true"
Show Content as Excerpt?
On Testimonials edit page listing, show truncated post content if no excerpt.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: show_content_excerpt="true"
Enable Sticky Testimonials?
For listing and sliding testimonials, sticky entries will be displayed on first.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: enable_sticky_testimonials="false"

Premium Selection

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Maximum Length
Maximum number of allowed characters in testimonial.
Validatation: An intval greater than zero.
Usage: maximum_length="5"
Minimum Length
Minimum number of characters required in testimonial.
Validatation: An intval greater than zero.
Usage: minimum_length="5"
Require Excerpt?
Don't display any testimonials without excerpts.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: require_excerpt="false"
Require Image?
Don't display any testimonials without featured images.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: require_image="false"
Require Ratings?
Minimum rating required before selecting testimonials to display.
Validatation: intval.
Options: false, 1, 2, 3, 4, 5
Usage: require_ratings="Pick an option"
Strict Ratings?
Show only testimonials matching the Require Ratings selection.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: strict_rating="false"

Post Type

Premium Post Type

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Alternate Testimonial Post Type?
Set this to use Posts, Posts or another custom post type for testimonials.
Options: testimonials-widget, post, page
Usage: post_type="testimonials-widget"

Premium

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Caching

Used with: [testimonials_slider], testimonials_slider(), [testimonials], testimonials(), [testimonials_links], testimonials_links(), [testimonials_count], testimonials_count()

Cache Per Page?
This is useful when you use custom testimonial instances per page.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: cache_per_page="false"
Disable Cache?
If you want to prevent duplicates, caching must be enabled.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: no_cache="false"
Prevent Duplicates?
Helpful to prevent showing duplicates when displaying multiple testimonial instances on a single page.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: unique="false"

Premium Slider Widget

Used with: [testimonials_slider], testimonials_slider()

Auto-Rotate Page-to-Page?
Automatically change to the next testimonial, per the sort order, whenever a user navigates to another page.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: rotate_per_page="true"
Carousel Count?
The number of testimonials to be shown at a time. "1" means no carousel. Shown number of testimonials will be reduced if carousel width becomes smaller than the original size. Requires Transition Mode "Horizontal" or "Vertical".
Validatation: intval.
Usage: carousel_count="1"
Show Next/Prev Controls?
Display a next or previous button controller when using `testimonials_slider` or the testimonials widget.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: show_controls="true"
Show Pager?
Display a slide pager when using `testimonials_slider` or the testimonials widget.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: show_pager="false"
Slide Margin?
Margin between each testimonial. Increase to thumbnail height or greater for vertical transitions. Used with Carousel Count.
Validatation: intval.
Usage: slide_margin="10"
bxSlider Speed
Slide transition duration (in ms).
Validatation: An intval greater than zero.
Usage: bxslider_speed="500"
bxSlider Adaptive Height Speed
Slide height transition duration (in ms). Note: only used if `adaptiveHeight: true`
Validatation: An intval greater than zero.
Usage: bxslider_adaptiveHeightSpeed="500"

Readmore JS

Used with: [testimonials], testimonials(), [testimonials_slider], testimonials_slider()

Use Readmore JS?
Doesn't work well with testimonials slider. Overrides "Read More" page links, by collapsing and expanding long blocks of text with “Read more” and “Close” jQuery based links.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: use_readmore_js="false"
Speed
in milliseconds.
Validatation: An intval greater than zero.
Usage: readmore_speed="100"
Maximum Height
in pixels. Maximum height of collasped content.
Validatation: An intval greater than zero.
Usage: readmore_max_height="200"
Height Margin
in pixels. Avoids collapsing blocks that are only slightly larger than Maximum Height.
Validatation: An intval greater than zero.
Usage: readmore_height_margin="16"
More Link
Validatation: wp_kses_post.
Usage: readmore_more_link="<a href="#">Read more</a>"
Close Link
Validatation: wp_kses_post.
Usage: readmore_less_link="<a href="#">Close</a>"
Embed CSS?
Insert required CSS dynamically, uncheck this if you include the necessary CSS in a stylesheet.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: readmore_embed_css="true"
Section CSS
Sets the styling of the blocks.
Validatation: wp_kses_post.
Usage: readmore_section_css="display: block; width: 100%;"
Start Open?
Do not immediately truncate, start in the fully opened position.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: readmore_start_open="false"

Testimonials Archives

Used with: [testimonials_archives], testimonials_archives()

Title
Validatation: wp_kses_post.
Usage: title="Testimonials Archives"
Title Link
URL, path, or post ID to link widget title to. Ex: http://example.com/stuff, /testimonials, or 123
Validatation: wp_kses_data.
Usage: title_link="You decide…"
Display as dropdown
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: dropdown="false"
Show post counts
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: count="false"

Testimonials Categories

Used with: [testimonials_categories], testimonials_categories()

Title
Validatation: wp_kses_post.
Usage: title="Testimonials Categories"
Title Link
URL, path, or post ID to link widget title to. Ex: http://example.com/stuff, /testimonials, or 123
Validatation: wp_kses_data.
Usage: title_link="You decide…"
Display as dropdown
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: dropdown="false"
Show post counts
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: count="false"
Show hierarchy
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: hierarchical="false"

Recent Testimonials

Used with: [testimonials_recent], testimonials_recent()

Title
Validatation: wp_kses_post.
Usage: title="Recent Testimonials"
Title Link
URL, path, or post ID to link widget title to. Ex: http://example.com/stuff, /testimonials, or 123
Validatation: wp_kses_data.
Usage: title_link="You decide…"
Number of testimonials to show
Validatation: intval.
Usage: number="5"
Display testimonial date?
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: show_date="false"

Testimonials Tag Cloud

Used with: [testimonials_tag_cloud], testimonials_tag_cloud()

Title
Validatation: wp_kses_post.
Usage: title="Testimonials Tag Cloud"
Title Link
URL, path, or post ID to link widget title to. Ex: http://example.com/stuff, /testimonials, or 123
Validatation: wp_kses_data.
Usage: title_link="You decide…"
Taxonomy
Options: category, post_tag
Usage: taxonomy="post_tag"

 

Shortcode Examples - Testimonials Widget Premium

[testimonials] - Testimonials listing with paging

  • List of testimonials only 200 characters long with only author shown in credit box - [testimonialswidget_list char_limit=200 hide_title=true hide_email=true hide_url=true hide_location=true hide_company=true]
  • List testimonials by post title - [testimonials order=ASC orderby=title]
  • Select testimonials tagged with either "test" or "fun", in random order, but ignore those of the excluded ids - [testimonials tags="test,fun" random=true exclude="2,22,333"]
  • Show 15 testimonials, in company order - [testimonials meta_key=testimonials-widget-company order=asc limit=15]
  • Show 3 full-length testimonials, with opening and closing quote marks removed - [testimonials char_limit=0 target=_new limit=3 disable_quotes=true]
  • Show 5 full-length testimonials, with paging - [testimonials limit=5 paging=true char_limit=0]
  • Show all testimonials on one page - [testimonials char_limit=0 limit=-1]
  • Show one random testimonial - [testimonials limit=1 no_cache=true random=true]
  • Show only these 3 testimonials - [testimonials ids="1,11,111" paging=false]
  • Show testimonial list with author and urls hidden - [testimonials hide_source=true hide_url=true]
  • Show the single testimonial of ID 123 on a page - [testimonials ids="123" paging=false]
  • Testimonial list by category - [testimonials category="category-name"]
  • Testimonial list by category and hide "No testimonials found" message - [testimonials category=product hide_not_found=true]
  • Testimonial list by category ID 123 - [testimonials category=123]
  • Testimonial list by tag, showing 5 at most - [testimonials category=product tags=widget limit=5]
  • Testimonial list using Readmore JS with 100 pixel collasped height - [testimonials use_readmore_js=true readmore_max_height=100]

[testimonials_archives] - A monthly archive of your site's testimonials

  • Testimonial's archive as dropdown with monthly count - [testimonials_archives dropdown=true count=true]

[testimonials_categories] - A list or dropdown of testimonials' categories

  • Testimonial's categories as hierarchical with monthly count - [testimonials_categories count=true hierarchical=true]

[testimonials_recent] - Your site's most recent testimonials

  • The 3 most recent testimonials with dates - [testimonials_recent number=3 show_date=true]

[testimonials_count] - Count of testimonials

  • Display count of posts - [testimonials_count post_type=post]
  • Display count of testimonials of category wordpress - [testimonials_count category=wordpress]
  • Display count of testimonials of category wordpress and tagged with support - [testimonials_count category=wordpress tags=support]
  • Display count of testimonials tagged with support - [testimonials_count tags=support]
  • Display the number of "Product A" category testimonials - [testimonials_count category=product-a]

[testimonials_form] - Testimonials entry form

  • Automatically assign "30 Day Lift" and tag "osa" to the user submitted testimonial - [testimonials_form meta_item="30 Day Lift" tags_input="osa"]
  • Automatically assign "my product" and hide that field for the user submitted testimonial - [testimonials_form meta_item="my product" hide_meta_item=true]
  • Display a testimonial input form on the front-end sans email, but enables tags entry - [testimonials_form hide_meta_email=true hide_tags_input=false]
  • Display a testimonial input form on the front-end that submits to the "Services" category with ID 123 - [testimonials_form post_category=123] or [testimonials_form post_category="Services"]
  • Hide most fields and assign testimonials to category 41 - [testimonials_form hide_post_excerpt=true hide_meta_title=true hide_meta_location=false hide_meta_email=false hide_meta_company=true hide_meta_url=true hide_featured_image_url=true post_category=41]
  • Simple form submission - [testimonials_form hide_post_excerpt=true hide_meta_title=true hide_meta_location=true hide_meta_email=true hide_meta_company=true hide_featured_image=true hide_meta_read_more_link=true hide_meta_item_url=true]
  • Very simple testimonial submission form - [testimonials_form hide_post_excerpt=true hide_meta_title=true hide_meta_location=true hide_meta_email=true hide_meta_company=true hide_meta_url=true hide_featured_image=true]

[testimonials_links] - List of testimonial author and title linking to full entry

  • Display a list of all testimonials without content or company details - [testimonials_links hide_company=true]

[testimonials_slider] - Displays rotating testimonials or statically

  • Automatically rotate testimonials page to page, even if next testimonial is clicked - [testimonials_slider category=quote rotate_per_page=true show_controls=true]
  • Display only short testimonials - [testimonials_slider maximum_length=100]
  • Display only testimonials with excerpts and featured images. Great for lead-ins - [testimonials_slider require_image=true require_excerpt=true]
  • Display posts instead of testimonials - [testimonials_slider post_type=post]
  • Display rotating testimonials with link to next testimonial - [testimonials_slider show_controls=true]
  • Ignore short testimonials for display - [testimonials_slider minimum_length=250]
  • Prevent showing previously selected testimonials on a page - [testimonials_slider unique=true]
  • Show "liposuction" testimonials in oldest first sorting - [testimonials_slider category=liposculpture order=asc]
  • Show a horizontal carousel with 3 rated testimonials - [testimonials_slider carousel_count=3 transition_mode=horizontal slide_width=250 slide_margin=25 require_ratings=1]
  • Show a slider of testimonials with excerpts, don't show ratings or the play and pause buttons - [testimonials_slider show_controls=false show_ratings=false require_excerpt=true]
  • Show random "dreamweaver" testimonials. Enable play and pause buttons - [testimonials_slider category="dreamweaver" random="true" show_controls="true"]
  • Show rotating testimonials, of the product category, lowest post ids first - [testimonials_slider category=product order=asc]
  • Show rotating, random testimonials having tag "sometag" - [testimonials_slider tags=sometag random=true]
  • Show testimonials having at least 4 stars and a featured image, but don't show the excerpt - [testimonials_slider limit=3 show_controls=true require_ratings=4 require_image=true hide_excerpt=true]
  • Show vertical carousel with 2 testimonials - [testimonials_slider carousel_count=2 transition_mode=vertical slide_margin=50 rotate_per_page=false]

[testimonials_tag_cloud] - A cloud of your most used testimonials' tags

  • Show testimonials post tag cloud - [testimonials_tag_cloud]