Qaiyo Testimonials provides a flexible custom post type with categorisation and six built-in frontend layouts, each fully configurable through a visual Display Builder, shortcode attributes and a settings page.
Free layouts
- V1 — One or two rows, horizontal scroll, optional alternating direction, fading edges.
- V2 — Two or three vertical columns scrolling up/down, optional alternating direction per column.
- V3 — Single-row carousel with a circular customer avatar on top of each card.
- V4 — Bento grid layout that adapts to the testimonial count, with per-item highlight box & custom color.
- V5 — Avatar grid (max 29) where clicking a face reveals the matching testimonial below; auto-rotates.
- V6 — Photo hero card: large image on top, dark content section with a quote marker below.
More layouts with Pro
Six additional layouts (V7–V12) — pastel tilted cards, split-panel hero, masonry wall, featured + grid, spotlight + list, and an editorial big-quote — are previewed inside the admin and unlocked by the optional
Qaiyo Testimonials Pro add-on, which also adds star ratings, a front-end submission form, video testimonials and more.
Per-testimonial fields
Customer name (title), photo (JPG/PNG/WebP, max 1 MB), position, company, optional heading, quote/description, plus card-color controls (used by V4 highlight and V7 background).
Shortcode
[qaiyo_testimonials version="v1" category="clients" speed="40"]
See the Settings page for every available attribute.
Multilingual
Ships with translations for English, Hungarian, German, French, Spanish, Japanese, Portuguese (Brazil and Portugal), Italian, Russian, Turkish and Polish, with locale variant fallback (e.g. de_AT → de_DE). Compatible with Polylang, WPML, TranslatePress and Loco Translate.
1.1.0
Quality, performance and standards pass (WP Health Kit audit remediation).
- Performance: fixed an N+1 query in the shortcode render loop — testimonial meta is now primed in a single query instead of one query per item. Added
no_found_rows (the shortcode never paginates) and skipped the term-cache prime on the render query.
- Performance: the admin testimonial pickers (V8/V10 featured, Display list) are now bounded instead of loading every post with
posts_per_page => -1.
- Theme compatibility: admin CSS no longer uses a bare
input[type="color"] selector or !important on layout properties; both are now scoped to the plugin's own UI.
- Coding standards: roughly forty inline
style="" attributes in admin output were moved to enqueued CSS utility classes; the Display Builder visibility toggles now switch a class instead of relying on jQuery show/hide.
- Type safety: resolved all PHPStan level 5 argument-type warnings (integers are cast to string before
esc_attr() / esc_html()).
- Housekeeping: canonical
GPLv2 or later license header, added the Tested up to header, and aligned internal version constants with the plugin header.
1.0.0
First public release.
Six built-in layouts
- V1 — Horizontal rows: 1 or 2 rows scrolling left/right, optional alternating direction, fading edges.
- V2 — Vertical columns: 2 or 3 columns scrolling up/down, optional alternating direction per column, fading edges.
- V3 — Photo carousel: single row with circular avatars and a handwritten name signature.
- V4 — Bento grid: asymmetric static grid with a per-testimonial highlight box (custom background + text color).
- V5 — Avatar switcher: clickable photo grid (max 29), auto-rotating featured quote panel.
- V6 — Photo hero card: large image on top, dark content section with a quote-circle marker. 1-4 columns.
Six more layouts (V7-V12: pastel tilted, split-panel hero, masonry wall, featured + grid, spotlight + list, editorial big quote) are previewed in the admin and unlocked by the optional Qaiyo Testimonials Pro add-on.
Content & data
- Custom post type with categories.
- Photo upload via WordPress Media Library (JPG/PNG/WebP, max 1 MB) with MIME validation.
- Per-testimonial fields: name, photo, position, company, optional heading, quote/description, card-color controls.
- Uninstall data choice: on plugin deletion you decide whether to keep your testimonials in the database or erase everything.
Display Builder
- Visual wizard for assembling reusable display configurations.
- Version picker with high-fidelity SVG wireframes for all twelve layouts (V7-V12 shown as locked Pro previews).
- 4 quote-mark styles (teardrop / bold block / calligraphic comma / speech-bubble outline).
- Category selector, per-version options (rows/columns/direction/speed/fade), per-display design overrides.
- Generates a stable [qaiyo_testimonials display="ID"] shortcode.
Block editor
- Gutenberg block ("Qaiyo Testimonials") — drop into any post/page, pick a saved Display from a dropdown or configure layout/category/limit manually, with a live ServerSideRender preview inside the editor.
SEO & accessibility
- Schema.org Review microdata + JSON-LD ItemList for Google Rich Results and AI search engines.
- Semantic HTML (figure / blockquote / figcaption) with proper itemprop attributes.
- Responsive on every layout; prefers-reduced-motion respected.
Internationalization
- Bundled translations: English, Hungarian, German, French, Spanish, Japanese, Portuguese (Brazil + Portugal), Italian, Russian, Turkish, Polish — with locale-variant fallback.
- Polylang, WPML, TranslatePress and Loco Translate compatible.
Developer API
- Stable hook/filter surface (qaiyte_shortcode_atts, qaiyte_query_args, qaiyte_item_data, qaiyte_card_html, qaiyte_render_html, qaiyte_schema_jsonld, qaiyte_supported_versions, qaiyte_unlocked_versions, qaiyte_after_save_testimonial, and more) so add-ons can extend the plugin without touching core.