VertiMonial Documentation

Welcome to the VertiMonial plugin documentation! This guide explains how to use the plugin, its features, and the [vertim_testimonials_slider] shortcode to display a vertical testimonial slider on your WordPress site.

Getting Started

VertiMonial is a lightweight, responsive plugin for displaying vertical testimonial sliders. Follow these steps to set it up:

1. Install and activate the plugin via Plugins > Add New.
2. Go to VertiMonials in the WordPress dashboard to add testimonials.
3. Use the shortcode [vertim_testimonials_slider] in posts, pages, or widgets.
4. Customize settings under VertiMonials > Settings.

Adding Testimonials

Create new testimonials under VertiMonials > Add New. Each testimonial supports:

• Title: Client’s name (e.g., "John Doe").
• Content: The testimonial message.
• Featured Image: Client’s photo (optional).
• Role/Designation: Their role (e.g., "CEO").
• Company Name: Their company (e.g., "xAI").
• Rating: 1-5 stars for feedback quality.

Managing Categories

Organize testimonials into categories to display specific groups (e.g., "Clients", "Partners").

• Go to VertiMonials > Categories to add/edit categories.
• Assign categories to testimonials when editing them.
• Use the category attribute in the shortcode to filter by category slug (e.g., category="clients").

Customizing the Slider

Customize the slider globally via VertiMonials > Settings or per-instance using shortcode attributes.

Settings Page

Under VertiMonials > Settings, adjust the following:

• Animation Speed: Duration of scroll animation (1-60 seconds, default: 25).
• Background Color: Testimonial background color (default: #ffffff).
• Text Color: Testimonial text color (default: #000000).
• Column Width: Width of each column (default: 700px).
• Column Height: Height of each column (default: 500px).
• Gap Between Columns: Space between columns (default: 8px).
• Testimonial Padding: Inner padding of testimonials (default: 20px).
• Border Radius: Corner roundness of testimonials (default: 15px).
• Show Ratings: Display star ratings (default: enabled).
• Pause on Hover: Pause scrolling when hovering (default: enabled).
• Use Single Column: Display one column instead of two (default: disabled).

Shortcode Attributes

Use the [vertim_testimonials_slider] shortcode with these attributes to override settings:

• limit: Number of testimonials to show (-1 for all, e.g., limit="5").
• category: Filter by category slug (e.g., category="clients").
• speed: Animation duration in seconds (e.g., speed="15").
• bg_color: Background color (e.g., bg_color="#f0f0f0").
• text_color: Text color (e.g., text_color="#333333").
• column_width: Column width in pixels (e.g., column_width="500").
• column_height: Column height in pixels (e.g., column_height="400").
• gap: Gap between columns in pixels (e.g., gap="10").
• padding: Testimonial padding in pixels (e.g., padding="15").
• border_radius: Border radius in pixels (e.g., border_radius="10").
• show_rating: Show star ratings (1 for yes, 0 for no, e.g., show_rating="0").
• pause_hover: Pause on hover (1 for yes, 0 for no, e.g., pause_hover="0").
• single_column: Use single column (1 for yes, 0 for no, e.g., single_column="1").

Developer Hooks

Developers can extend VertiMonial using these hooks:

• vertim_before_testimonial: Action to add content before each testimonial. Example: add_action('vertim_before_testimonial', 'my_function');
• vertim_testimonial_query_args: Filter to modify the WP_Query args. Example: add_filter('vertim_testimonial_query_args', 'my_filter');

Troubleshooting

• Slider not showing? Ensure testimonials are published and the shortcode is correct.
• Category not filtering? Double-check the category slug in the shortcode.
• Need help? Contact haseebabidofficial@gmail.com.

Support

Visit the plugin page or email haseebabidofficial@gmail.com for support. Rate us ★★★★★ to support future updates!