Appearance

Testimonials Module ​

The Testimonials module allows you to collect, manage, and display customer testimonials on your website. This guide covers all testimonial management features.

Table of Contents ​

  1. Overview
  2. Accessing Testimonials
  3. Creating a Testimonial
  4. Managing Testimonials
  5. Testimonial Display
  6. Frontend Integration
  7. Best Practices

Overview ​

Features ​

  • ✅ Create and manage testimonials
  • ✅ Client information management
  • ✅ Rating system (1-5 stars)
  • ✅ Testimonial categories
  • ✅ Featured testimonials
  • ✅ Image uploads (client photos)
  • ✅ Frontend display widgets
  • ✅ Bulk operations

Admin Routes ​

  • Testimonial List: /admin/testimonials
  • Create Testimonial: /admin/testimonials/create
  • Edit Testimonial: /admin/testimonials/{id}/edit

Frontend Routes ​

  • Testimonials Page: /testimonials
  • API Endpoint: /api/testimonials

Accessing Testimonials ​

From Admin Panel ​

  1. Log in to admin panel
  2. Navigate to Content Management → Testimonials
  3. Or go directly to: /admin/testimonials

Permissions Required ​

  • View Testimonials: view testimonials permission
  • Create Testimonials: create testimonials permission
  • Edit Testimonials: edit testimonials permission
  • Delete Testimonials: delete testimonials permission

Creating a Testimonial ​

Step 1: Access Create Page ​

  1. Go to Testimonials → Create New Testimonial
  2. Or navigate to: /admin/testimonials/create

Step 2: Client Information ​

Client Name ​

  • Full name of the client
  • Required field
  • Example: John Smith

Client Title/Position ​

  • Job title or position
  • Optional but recommended
  • Example: CEO, Tech Company Inc.

Company Name ​

  • Client's company
  • Optional
  • Example: Tech Company Inc.

Client Email ​

  • Client's email address
  • Optional
  • Used for verification (if enabled)

Client Website ​

  • Company website URL
  • Optional
  • Example: https://techcompany.com

Step 3: Testimonial Content ​

Testimonial Text ​

  • The actual testimonial content
  • Required field
  • Use rich text editor
  • Recommended: 50-300 words

Best Practices:

  • Use authentic language
  • Include specific details
  • Highlight key benefits
  • Keep it concise

Rating ​

Star Rating:

  • Select rating (1-5 stars)
  • Optional but recommended
  • Visual representation
  • Used in display

Rating Options:

  • ⭐⭐⭐⭐⭐ (5 stars) - Excellent
  • ⭐⭐⭐⭐ (4 stars) - Very Good
  • ⭐⭐⭐ (3 stars) - Good
  • ⭐⭐ (2 stars) - Fair
  • ⭐ (1 star) - Poor

Step 4: Media ​

Client Photo ​

  1. Click Upload Photo
  2. Select client photo
  3. Recommended: Square image (400x400px)
  4. Used in testimonial display

Photo Guidelines:

  • Professional headshot preferred
  • High quality
  • Good lighting
  • Appropriate size
  1. Click Upload Logo
  2. Select company logo
  3. Recommended: Transparent PNG
  4. Displayed with testimonial

Step 5: Additional Settings ​

  • Toggle: Mark as featured
  • Featured testimonials highlighted
  • Shown prominently on frontend
  • Use for best testimonials

Status ​

  • Published: Visible on website
  • Draft: Saved but not published
  • Archived: Hidden from display

Display Order ​

  • Set order for display
  • Lower numbers appear first
  • Used for sorting

Step 6: Save Testimonial ​

  • Save Draft: Save without publishing
  • Publish: Make testimonial live
  • Save & Add Another: Create multiple quickly

Managing Testimonials ​

Testimonial List View ​

Access at: /admin/testimonials

List Features ​

Search:

  • Search by client name
  • Search by company
  • Search by testimonial content

Filters:

  • Status: Published/Draft/Archived
  • Featured: Featured/Not Featured
  • Rating: Filter by star rating

Sorting:

  • By Date (Newest/Oldest)
  • By Client Name (A-Z)
  • By Rating (Highest/Lowest)
  • By Display Order

Displayed Information ​

  • Client Name: Who gave testimonial
  • Company: Company name
  • Rating: Star rating
  • Status: Published/Draft
  • Featured: Featured badge
  • Date: Creation date

Editing Testimonials ​

  1. Click Edit on testimonial
  2. Make changes
  3. Click Update
  4. Changes saved

Deleting Testimonials ​

  1. Click Delete on testimonial
  2. Confirm deletion
  3. Warning: Cannot be undone
  4. Testimonial removed

Bulk Operations ​

Bulk Delete ​

  1. Select multiple testimonials
  2. Click Bulk Actions → Delete
  3. Confirm deletion
  4. All selected removed

Bulk Status Change ​

  1. Select testimonials
  2. Click Bulk Actions → Change Status
  3. Select new status
  4. All updated

Testimonial Display ​

Display Options ​

Grid Layout ​

  • Multiple testimonials in grid
  • Responsive columns
  • Card-based design
  • Image, rating, text visible
  • Rotating testimonials
  • Auto-play option
  • Navigation arrows
  • Dots indicator

List Layout ​

  • Vertical list of testimonials
  • Full content visible
  • Easy to scan
  • Good for many testimonials
  • One prominent testimonial
  • Large display
  • Full content
  • Best for homepage

Display Elements ​

Included:

  • Client photo
  • Client name
  • Company name
  • Rating (stars)
  • Testimonial text
  • Company logo (optional)

Styling:

  • Customizable colors
  • Font options
  • Spacing controls
  • Border and shadow

Frontend Integration ​

Testimonials Page ​

URL: /testimonials

Features:

  • All published testimonials
  • Filtering options
  • Search functionality
  • Pagination
  • Responsive design

API Endpoint ​

URL: /api/testimonials

Usage:

  • Fetch testimonials via API
  • Custom integrations
  • Third-party displays
  • AJAX loading

Response Format:

json
{
  "data": [
    {
      "id": 1,
      "client_name": "John Smith",
      "company": "Tech Company",
      "rating": 5,
      "testimonial": "Great service...",
      "photo": "url",
      "featured": true
    }
  ]
}

Widget/Shortcode ​

Usage:

  • Add to pages
  • Display in sidebar
  • Include in emails
  • Embed anywhere

Example:

[testimonials count="3" featured="true"]

Best Practices ​

Collecting Testimonials ​

  1. Ask Promptly:

    • Request after positive interaction
    • While experience is fresh
    • Easy to remember details

  2. Make It Easy:

    • Simple submission form
    • Clear instructions
    • Quick process

  3. Follow Up:

    • Send reminder if needed
    • Offer assistance
    • Thank for submission

Writing Testimonials ​

  1. Be Authentic:

    • Use real client words
    • Don't over-edit
    • Maintain voice

  2. Include Details:

    • Specific benefits
    • Real results
    • Concrete examples

  3. Keep It Concise:

    • 50-300 words ideal
    • Easy to read
    • Scannable

Displaying Testimonials ​

  1. Showcase Best:

    • Feature top testimonials
    • Highlight high ratings
    • Use on homepage

  2. Variety:

    • Different industries
    • Various use cases
    • Diverse clients

  3. Update Regularly:

    • Add new testimonials
    • Refresh display
    • Keep content current

Troubleshooting ​

Testimonial Not Displaying ​

Solutions:

  1. Check status (must be Published)
  2. Verify frontend settings
  3. Clear cache
  4. Check display filters

Images Not Showing ​

Solutions:

  1. Verify image uploaded
  2. Check file permissions
  3. Clear browser cache
  4. Check image URLs

Rating Not Displaying ​

Solutions:

  1. Verify rating is set
  2. Check display settings
  3. Clear cache
  4. Verify template support

Last Updated: [Date will be updated during final review]

Released under the MIT License.

Copyright © 2024 OmniSuite CMS