Options – Testimonials Widget Premium

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"
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="Axelerant Store"
Default Reviewed Item URL?
URL of thing being referenced in testimonials.
Validatation: filter_var( $url, FILTER_VALIDATE_URL ).
Usage: item_reviewed_url="https://store.axelerant.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 Review Schema?
Adds HTML tag markup per the Review schema to testimonials. Search engines including Bing, Google, Yahoo! and Yandex rely on this markup to improve the display of search results.
Validatation: Values like true, 'true', 1, 'on', and 'yes' are true; otherwise false.
Usage: enable_schema="true"
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, download
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"