Below, you’ll find a detailed guide on how to add the Testimonials Widget Shortcodes to your WordPress website, including their parameters, examples, and PHP function code. Additionally, we’ll assist you with common issues that might cause the Testimonials Widget Plugin shortcodes not to show or not to work correctly.
Before starting, here is an overview of the Testimonials Widget Plugin and the shortcodes it provides:
"Testimonials Widget is a powerful WordPress plugin that allows you to easily display and manage customer testimonials on your website, enhancing credibility and trust."
- [testimonialswidgetpremium_form]
- [testimonialswidgetpremium_count]
- [testimonialswidgetpremium_link_list]
- [testimonials]
- [testimonialswidget_widget]
- [testimonials_archives]
- [testimonials_categories]
- [testimonials_examples]
- [testimonials_options]
- [testimonials_recent]
- [testimonials_tag_cloud]
Testimonials Widget [testimonialswidgetpremium_form] Shortcode
The Testimonials Widget Premium shortcode is used to generate a form for gathering user testimonials. It handles form submission, validation, and response. This shortcode initiates the testimonials form, sets headers to prevent caching, and validates the form inputs. It also handles file attachments and featured images. If the form submission is valid, it saves the input and redirects to a thank-you page. If not, it generates an error message and provides debugging help for website managers.
Shortcode: [testimonialswidgetpremium_form]
Parameters
Here is a list of all possible testimonialswidgetpremium_form shortcode parameters and attributes:
Based on the given code, it appears that there are no shortcode parameters directly associated with the ‘testimonialswidgetpremium_form’ shortcode. So, we will use the specified text:
NO_PARAMS
Examples and Usage
Basic example – Displaying a testimonials form using the shortcode without any additional parameters.
[testimonialswidgetpremium_form]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonialswidgetpremium_form] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonialswidgetpremium_form', array( $this, 'testimonials_form' ) );Shortcode PHP function:
function testimonials_form( $atts ) {
nocache_headers();
$instance = self::set_instance();
if ( empty( self::$form_options ) ) {
self::form_options();
}
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Settings::validate_settings( $atts );
$atts['type'] = self::ID;
$content = null;
$validated = null;
$valid_submit = true;
if ( ! empty( $_POST[ self::$form_base ] ) && wp_verify_nonce( $_POST[ __CLASS__ ], 'add' ) ) {
$hide_are_you_human = tw_get_option( 'hide_are_you_human' );
$input = $_POST[ self::$form_base ];
$input = wp_parse_args( $input, $atts );
if ( ! empty( $input['attach_id'] ) ) {
$input['featured_image'] = $input['attach_id'];
}
if ( ! empty( $_FILES ) ) {
$file_arr = $_FILES[ self::$form_base ];
if ( ! empty( $file_arr['name']['featured_image'] ) ) {
$file = $file_arr['name']['featured_image'];
$input['featured_image'] = $file;
}
} elseif ( ! empty( $input['featured_image_url'] ) ) {
$input['featured_image'] = $input['featured_image_url'];
}
$validated = Axl_Testimonials_Widget_Settings::validate_settings( $input, self::$form_options, true );
$twp_as = new Axl_Testimonials_Widget_Premium_Antispam( $validated['input'] );
$valid_submit = $twp_as->is_valid();
if ( ! $valid_submit && empty( $validated['errors'] ) ) {
$msg_as = Axl_Testimonials_Widget_Premium::get_template_part( 'testimonial', 'form-thank-you' );
if ( ! $hide_are_you_human ) {
$msg_as .= Axl_Testimonials_Widget_Premium::get_template_part( 'testimonial', 'form-anti-spam' );
}
$content = $msg_as;
if ( current_user_can( 'manage_options' ) ) {
$text = '<h2>';
$text .= esc_html__( 'Antispam Debug Help Text', 'testimonials-widget-premium' );
$text .= '</h2>';
$text .= '<h4>';
$text .= esc_html__( 'This section is shown only to website managers', 'testimonials-widget-premium' );
$text .= '</h4>';
$text .= '<p>';
$text .= self::text_debug_antispam();
$text .= '</p>';
$content .= $text;
}
} else {
$validated['input']['hpsc_session'] = self::get_hpsc_session( true );
}
if ( $valid_submit && empty( $validated['errors'] ) ) {
$validated['input'] = self::save_form( $validated['input'] );
$thank_you_page = tw_get_option( 'thank_you_page' );
if ( ! empty( $thank_you_page ) ) {
$thank_you_link = $thank_you_page;
if ( preg_match( '#^\d+$#', $thank_you_link ) ) {
$link = get_permalink( $thank_you_link );
} else {
$do_http = true;
if ( 0 === strpos( $thank_you_link, '/' ) ) {
$do_http = false;
}
if ( $do_http && 0 === preg_match( '#https?://#', $thank_you_link ) ) {
$thank_you_link = 'http://' . $thank_you_link;
}
$link = $thank_you_link;
}
$validated['input']['thank_you_page_link'] = $link;
}
}
if ( ! $hide_are_you_human ) {
unset( $validated['input']['are_you_human'] );
}
}
if ( empty( $content ) ) {
$content = self::show_form( $atts, $validated );
}
Axl_Testimonials_Widget::call_scripts_styles( array(), $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget-premium-form.phpTestimonials Widget [testimonialswidgetpremium_count] Shortcode
The Testimonials Widget Premium shortcode is used to count the total number of testimonials. The shortcode retrieves all testimonials, counts them, and returns the total. It uses the WP_Query class to fetch testimonials and applies filters for caching, enhancing performance.
Shortcode: [testimonialswidgetpremium_count]
Examples and Usage
Basic example – Display the total count of testimonials in the database.
[testimonialswidgetpremium_count]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonialswidgetpremium_count] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonialswidgetpremium_count', array( __CLASS__, 'testimonials_count' ) );Shortcode PHP function:
function testimonials_count( $atts ) {
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Settings::validate_settings( $atts );
$atts['limit'] = -1;
$atts['type'] = 'testimonials_count';
$instance = Axl_Testimonials_Widget::add_instance();
$atts['widget_number'] = $instance;
$atts['fields'] = 'ids';
$testimonials = array();
$count = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $count ) {
$args = Axl_Testimonials_Widget::get_query_args( $atts );
$testimonials = new WP_Query( $args );
$count = $testimonials->post_count;
$count = apply_filters( 'tw_cache_set', $count, $atts );
}
Axl_Testimonials_Widget::call_scripts_styles( $testimonials, $atts, $instance );
return $count;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget-premium.phpTestimonials Widget [testimonialswidgetpremium_link_list] Shortcode
The Testimonials Widget Premium shortcode facilitates the display of testimonial links on your webpage. The shortcode fetches testimonial links based on specified attributes. It checks for pagination and sets the ‘type’ to ‘testimonials_links’. It then generates an instance, retrieves testimonials, and applies necessary filters. The final content is returned for display.
Shortcode: [testimonialswidgetpremium_link_list]
Parameters
Here is a list of all possible testimonialswidgetpremium_link_list shortcode parameters and attributes:
paged– Determines the page number for pagination.type– Defines the type of testimonial, set as ‘testimonials_links’.widget_number– The unique number for the widget instance.
Examples and Usage
Basic example – The basic usage of the testimonials shortcode. This will display the testimonials as per the default settings.
[testimonialswidgetpremium_link_list /]Advanced examples
Displaying testimonials with a specified page number. This will show the testimonials on the specified page number, in this case, page 2.
[testimonialswidgetpremium_link_list paged=2 /]Displaying testimonials of a specific type. This will show only the testimonials that have been categorized under the ‘premium’ type.
[testimonialswidgetpremium_link_list type='premium' /]Combining different parameters. This example displays the testimonials categorized under ‘premium’ type from page 2.
[testimonialswidgetpremium_link_list type='premium' paged=2 /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonialswidgetpremium_link_list] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonialswidgetpremium_link_list', array( __CLASS__, 'testimonials_links' ) );Shortcode PHP function:
function testimonials_links( $atts ) {
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Settings::validate_settings( $atts );
if ( get_query_var( 'paged' ) ) {
$atts['paged'] = get_query_var( 'paged' );
} elseif ( get_query_var( 'page' ) ) {
$atts['paged'] = get_query_var( 'page' );
} else {
$atts['paged'] = 1;
}
$atts['type'] = 'testimonials_links';
$instance = Axl_Testimonials_Widget::add_instance();
$atts['widget_number'] = $instance;
$testimonials = array();
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$testimonials = Axl_Testimonials_Widget::get_testimonials( $atts );
$content = self::get_testimonials_html_links( $testimonials, $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
Axl_Testimonials_Widget::call_scripts_styles( $testimonials, $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget-premium.phpTestimonials Widget [testimonials] Shortcode
The Testimonials-Widget shortcode is designed to display testimonials on your WordPress site. It retrieves the testimonials from the database, applies filters to the content, and returns the final output. This shortcode takes page number as an attribute and fetches the corresponding testimonials. It also includes caching to improve performance. The shortcode also triggers necessary scripts and styles.
Shortcode: [testimonials]
Parameters
Here is a list of all possible testimonials shortcode parameters and attributes:
atts– array of attributes used to customize the testimonials display.paged– determines the page number for pagination.type– specifies the type of content, in this case, ‘testimonials’.widget_number– unique identifier of the instance of the widget.
Examples and Usage
Basic example – Showcases a simple usage of the ‘testimonials’ shortcode without any additional parameters.
[testimonials /]Advanced examples
Utilize the shortcode to display testimonials on a specific page. The page will load testimonials based on the ‘paged’ parameter value.
[testimonials paged=2 /]Display testimonials using the shortcode with multiple parameters. This example illustrates how to use the ‘paged’ and ‘type’ parameters to display testimonials from a specific page and type.
[testimonials paged=2 type='client' /]Using the shortcode to display testimonials with a specific widget number. The testimonials will be loaded according to the ‘widget_number’ parameter.
[testimonials widget_number=3 /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials', array( __CLASS__, 'testimonials' ) );Shortcode PHP function:
function testimonials( $atts ) {
$atts = wp_parse_args( $atts, self::get_defaults() );
$atts = Axl_Testimonials_Widget_Settings::validate_settings( $atts );
if ( get_query_var( 'paged' ) ) {
$atts['paged'] = get_query_var( 'paged' );
} elseif ( get_query_var( 'page' ) ) {
$atts['paged'] = get_query_var( 'page' );
} else {
$atts['paged'] = 1;
}
$atts['type'] = 'testimonials';
$instance = self::add_instance();
$atts['widget_number'] = $instance;
$testimonials = array();
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$testimonials = self::get_testimonials( $atts );
$content = self::get_testimonials_html( $testimonials, $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( $testimonials, $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonialswidget_widget] Shortcode
The Testimonials Widget shortcode is a PHP function that displays a testimonials slider on a WordPress site. It parses arguments, validates settings, and retrieves testimonials.
Shortcode: [testimonialswidget_widget]
Parameters
Here is a list of all possible testimonialswidget_widget shortcode parameters and attributes:
random– If set, testimonials will be displayed in a random order.paging– This parameter is always false, meaning pagination is not used in the testimonials slider.type– Identifies the type of widget, in this case, it’s a testimonials slider.widget_number– Unique identifier of the testimonials slider widget.
Examples and Usage
Basic Example – A simple usage of the testimonials-widget plugin shortcode to display testimonials in a slider format.
[testimonialswidget_widget /]Advanced Examples
Displaying the testimonials in a slider format with random order. If the ‘random’ attribute is not set, it will be set to 1 by default. This shortcode will randomize the testimonials that are displayed.
[testimonialswidget_widget random=1 /]Setting a specific widget number. If the ‘widget_number’ attribute is not set, it will be incremented by 1 each time. This shortcode will display the testimonials slider with a specific widget number.
[testimonialswidget_widget widget_number=5 /]Combining multiple attributes. This shortcode will display the testimonials in a slider format, with a specific widget number and in a random order.
[testimonialswidget_widget random=1 widget_number=5 /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonialswidget_widget] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonialswidget_widget', array( __CLASS__, 'testimonials_slider' ) );Shortcode PHP function:
function testimonials_slider( $atts, $widget_number = null ) {
if ( is_null( $atts ) || ! is_array( $atts ) ) {
$atts = array();
}
if ( empty( $widget_number ) ) {
$widget_number = self::$widget_number++;
if ( ! isset( $atts['random'] ) ) {
$atts['random'] = 1;
}
}
$atts = wp_parse_args( $atts, self::get_defaults() );
$atts = Axl_Testimonials_Widget_Settings::validate_settings( $atts );
$atts['paging'] = false;
$atts['type'] = 'testimonials_slider';
self::set_instance( $widget_number );
$atts['widget_number'] = $widget_number;
$testimonials = array();
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$testimonials = self::get_testimonials( $atts );
$content = self::get_testimonials_html( $testimonials, $atts, false, $widget_number );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( $testimonials, $atts, $widget_number );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonials_archives] Shortcode
The Testimonials-widget shortcode is designed to archive testimonials. It parses arguments, validates settings, and sets the type to ‘testimonials_archives’. It generates an instance, retrieves cached content, and if not available, gets archive HTML. It then applies cache filters and calls scripts/styles.
Shortcode: [testimonials_archives]
Examples and Usage
Basic example – The following shortcode will display the testimonials archives with default settings.
[testimonials_archives /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials_archives] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials_archives', array( __CLASS__, 'testimonials_archives' ) );Shortcode PHP function:
function testimonials_archives( $atts, $widget_number = null ) {
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget_Archives_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Archives_Widget::validate_settings( $atts );
$atts['type'] = 'testimonials_archives';
$instance = ! empty( $widget_number ) ? $widget_number : self::add_instance();
$atts['widget_number'] = $instance;
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$content = self::get_archives_html( $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( array(), $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonials_categories] Shortcode
The Testimonials-Widget plugin shortcode is used to display categories of testimonials on your website. It validates settings, retrieves category data, and generates HTML content for display.
Shortcode: [testimonials_categories]
Examples and Usage
Basic example – The following shortcode will display the testimonials categories without any additional parameters.
[testimonials_categories /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials_categories] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials_categories', array( __CLASS__, 'testimonials_categories' ) );Shortcode PHP function:
function testimonials_categories( $atts, $widget_number = null ) {
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget_Categories_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Categories_Widget::validate_settings( $atts );
$atts['type'] = 'testimonials_categories';
$instance = ! empty( $widget_number ) ? $widget_number : self::add_instance();
$atts['widget_number'] = $instance;
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$content = self::get_categories_html( $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( array(), $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonials_examples] Shortcode
The Testimonials-Widget shortcode is a tool that displays specific testimonials on your website. It utilizes the ‘testimonials_examples’ function to parse arguments and apply filters for content customization.
Shortcode: [testimonials_examples]
Examples and Usage
Basic example – Displaying testimonials with the default settings.
[testimonials_examples /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials_examples] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials_examples', array( __CLASS__, 'testimonials_examples' ) );Shortcode PHP function:
function testimonials_examples( $atts = null ) {
$atts = wp_parse_args( $atts, self::get_defaults() );
$atts['type'] = 'testimonials_examples';
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$content = self::get_testimonials_examples( $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( array(), $atts );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonials_options] Shortcode
The Testimonials-Widget shortcode is a powerful tool for displaying testimonials. It parses attributes, caches content, and calls necessary scripts/styles.
Shortcode: [testimonials_options]
Examples and Usage
Basic example – This shortcode displays the default options for the testimonials widget.
[testimonials_options /]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials_options] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials_options', array( __CLASS__, 'testimonials_options' ) );Shortcode PHP function:
function testimonials_options( $atts = null ) {
$atts = wp_parse_args( $atts, self::get_defaults() );
$atts['type'] = 'testimonials_options';
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$content = self::get_testimonials_options( $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( array(), $atts );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonials_recent] Shortcode
The Testimonials-Widget plugin shortcode is designed to display recent testimonials. It utilizes the ‘testimonials_recent’ function to retrieve and validate the settings. The shortcode then sets the type and widget number. If no content is cached, it generates HTML for recent testimonials and applies any filters. Finally, it calls the necessary scripts and styles before returning the content.
Shortcode: [testimonials_recent]
Parameters
Here is a list of all possible testimonials_recent shortcode parameters and attributes:
$atts– An array of attributes, settings, or options for the recent testimonials widget.$widget_number– Number of the widget instance, used to differentiate multiple instances.
Examples and Usage
Basic example – Display the most recent testimonials using the ‘testimonials_recent’ shortcode.
[testimonials_recent]Advanced examples
Display the most recent testimonials but limit the number displayed to 5. This is useful when you want to keep your page neat and uncluttered.
[testimonials_recent number=5]Display the most recent testimonials and include testimonials from a specific category. Replace ‘category_name’ with the name of your category. This can help you showcase testimonials from a specific group or product line.
[testimonials_recent category='category_name']Display the most recent testimonials and order them by the testimonial date, in descending order. This helps in showing the most recent testimonials at the top.
[testimonials_recent orderby='date' order='DESC']Display the most recent testimonials and exclude testimonials from a specific category. Replace ‘category_name’ with the name of your category. This can be useful if you want to exclude certain testimonials from being displayed.
[testimonials_recent exclude_category='category_name']Please note that these examples are based on the assumption that the ‘testimonials_recent’ shortcode accepts these parameters. The actual parameters may vary based on the implementation of the ‘testimonials_recent’ function in your WordPress setup.
PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials_recent] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials_recent', array( __CLASS__, 'testimonials_recent' ) );Shortcode PHP function:
function testimonials_recent( $atts, $widget_number = null ) {
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget_Recent_Testimonials_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Recent_Testimonials_Widget::validate_settings( $atts );
$atts['type'] = 'testimonials_recent';
$instance = ! empty( $widget_number ) ? $widget_number : self::add_instance();
$atts['widget_number'] = $instance;
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$content = self::get_recent_html( $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( array(), $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpTestimonials Widget [testimonials_tag_cloud] Shortcode
The Testimonials-Widget plugin shortcode is a tool that generates a tag cloud of testimonials. It uses the ‘testimonials_tag_cloud’ function to parse and validate the settings, create the tag cloud HTML, and apply caching filters. .
Shortcode: [testimonials_tag_cloud]
Examples and Usage
Basic example – Showcases a basic usage of the testimonial tag cloud shortcode without any additional parameters.
[testimonials_tag_cloud]PHP Function Code
In case you have difficulties debugging what causing issues with [testimonials_tag_cloud] shortcode, check below the related PHP functions code.
Shortcode line:
add_shortcode( 'testimonials_tag_cloud', array( __CLASS__, 'testimonials_tag_cloud' ) );Shortcode PHP function:
function testimonials_tag_cloud( $atts, $widget_number = null ) {
$atts = wp_parse_args( $atts, Axl_Testimonials_Widget_Tag_Cloud_Widget::get_defaults() );
$atts = Axl_Testimonials_Widget_Tag_Cloud_Widget::validate_settings( $atts );
$atts['type'] = 'testimonials_tag_cloud';
$instance = ! empty( $widget_number ) ? $widget_number : self::add_instance();
$atts['widget_number'] = $instance;
$content = apply_filters( 'tw_cache_get', false, $atts );
if ( false === $content ) {
$content = self::get_tag_cloud_html( $atts );
$content = apply_filters( 'tw_cache_set', $content, $atts );
}
self::call_scripts_styles( array(), $atts, $instance );
return $content;
}
Code file location:
testimonials-widget/testimonials-widget/includes/class-testimonials-widget.phpConclusion
Now that you’ve learned how to embed the Testimonials Widget Plugin shortcodes, understood the parameters, and seen code examples, it’s easy to use and debug any issue that might cause it to ‘not work’. If you still have difficulties with it, don’t hesitate to leave a comment below.
Leave a Reply