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="Aihrus"
- Default Reviewed Item URL?
- URL of thing being referenced in testimonials.
- Validatation: filter_var( $url, FILTER_VALIDATE_URL ).
- Usage:
item_reviewed_url="http://aihr.us"
- 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 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"
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"
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, slides, download, edd_pup_email
- 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"
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"