WordPress.org
Get WordPress

Plugin Directory

Changeset 3496235


Ignore:
Timestamp:
04/01/2026 07:02:44 AM (12 hours ago)
Author:
tracksies
Message:

Add plugin assets, update readme, fix Appsero project ID

Location:
trustie
Files:
13 added
4 edited

Legend:

Unmodified
Added
Removed

  • trustie/tags/1.0.5/readme.txt

    r3496170 r3496235  
    11=== Trustie ===
    22Contributors: tracksies
    3 Tags: reviews, testimonials, google reviews, ratings, stars
     3Tags: reviews, testimonials, woocommerce reviews, google reviews, star ratings, product reviews, customer reviews, review plugin, social proof, schema markup
    44Requires at least: 6.0
    5 Tested up to: 6.9
     5Tested up to: 6.8
    66Requires PHP: 7.4
    77Stable tag: 1.0.5
    … …  
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Reviews, testimonials, and Google reviews for WordPress. Works with or without WooCommerce.
     11Reviews, testimonials, and Google Business reviews for WordPress & WooCommerce. Self-hosted. Free forever. Your data stays yours.
    1212
    1313== Description ==
    1414
    15 Trustie brings reviews, testimonials, and Google Business reviews to any WordPress site. Use it standalone for testimonials and Google reviews, or pair it with WooCommerce for product reviews, star ratings, and review request emails.
     15**Trustie brings reviews, testimonials, and Google Business reviews to any WordPress site.**
     16
     17Use it standalone for testimonials and Google reviews — no WooCommerce needed. Or pair it with WooCommerce for product reviews, star ratings, and automated review request emails. Everything stored in your database, on your server.
     18
     19Trustie is the free foundation of the [Tracksies](https://tracksies.com) plugin family — and it's a proper plugin, not a free-tier trap. No feature limits. No "upgrade to unlock." No monthly fees. Just reviews that work.
     20
     21**Switching from Judge.me?** Trustie is the self-hosted, flat-priced replacement. Your reviews, your database, your control. [Learn more about migrating](https://tracksies.com/migrate)
    1622
    1723= Works Without WooCommerce =
    1824
    19 * **Google Reviews** — Display your Google Business reviews with star ratings, author names, and a "View on Google" link. Outputs JSON-LD schema for search engine rich results.
    20 * **Testimonials** — Collect customer testimonials through a customizable form. Display them in grid, list, masonry, or slider layouts. Auto-approve above a rating threshold or moderate manually.
    21 * **Floating Widget** — A slide-out panel that shows your latest reviews from all sources on every page.
    22 * **Reviews Page** — A dedicated `/reviews/` page with tabs, filtering, and pagination. Works automatically — no WooCommerce needed.
    23 * **Visual Designer** — Customize colors, star styles, and branding from Trustie > Designer.
     25* **Google Reviews** — Display your Google Business reviews with star ratings, author names, and schema markup for rich results
     26* **Testimonials** — Collect testimonials through a customisable form. Display in grid, list, masonry, or slider layouts
     27* **Floating Widget** — A slide-out panel showing your latest reviews from all sources on every page
     28* **Reviews Page** — A dedicated /reviews/ page with tabs, filtering, and pagination. Works automatically
     29* **Visual Designer** — Customise colours, star styles, and branding from Trustie > Designer. Detects colours from your active theme
    2430
    2531= With WooCommerce =
    … …  
    2733Everything above, plus:
    2834
    29 * **Product Reviews** — Replace WooCommerce's default reviews with better-looking cards, star summaries, and rating breakdowns.
    30 * **Star Ratings** — Display average ratings anywhere with shortcodes. Lightweight loop stars for product archives.
    31 * **Review Request Emails** — Automatically email customers after purchase asking for a review.
    32 * **Convert Comments to Reviews** — Turn existing WordPress product comments into star-rated WooCommerce reviews with a configurable default rating.
    33 * **Sync Product Ratings** — Recalculate average ratings and review counts across all products.
     35* **Product Reviews** — Replace WooCommerce's default reviews with better-looking cards, star summaries, and rating breakdowns
     36* **Star Ratings** — Display average ratings anywhere with shortcodes. Lightweight loop stars for product archives
     37* **Review Request Emails** — Automatically email customers after purchase asking for a review
     38* **Convert Comments to Reviews** — Turn existing WordPress product comments into star-rated reviews
     39* **Sync Product Ratings** — Recalculate averages and counts across all products
    3440
    3541= Import Tools =
    3642
    37 * **Import Testimonials** — Automatically detects and imports testimonials from Strong Testimonials, Easy Testimonials, and Starter Templates. Originals can be kept or removed.
    38 * **Convert Product Comments** — If you have product comments from before WooCommerce reviews were enabled, convert them to proper reviews with star ratings in one click.
     43* **Import Testimonials** — Auto-detects and imports from Strong Testimonials, Easy Testimonials, and Starter Templates
     44* **Convert Product Comments** — One-click conversion from product comments to proper star-rated reviews
    3945
    4046= Accessibility =
    4147
    42 Trustie meets WCAG 2.1 AA standards: keyboard navigation, visible focus indicators, screen reader announcements for form submissions and content loading, and descriptive labels on all interactive controls.
     48Trustie is built with accessibility in mind: keyboard navigation, visible focus indicators, screen reader announcements for form submissions and content loading, and descriptive labels on interactive controls. We test against WCAG guidelines and actively work to improve accessibility with every update.
    4349
    4450= Shortcodes =
    4551
    46 **Google Reviews** (no WooCommerce needed)
    47 
    48 `[trustie_google_reviews]` — Display your Google Business reviews with aggregate rating and schema markup. Requires a Google API key and Place ID (Settings > Google Reviews).
    49 
    50 **Testimonials** (no WooCommerce needed)
    51 
    52 `[trustie_testimonials]` — Display testimonials in grid, list, or masonry layout.
    53 `[trustie_testimonial_form]` — Customer testimonial submission form.
    54 `[trustie_testimonial_slider]` — Auto-advancing testimonial carousel.
    55 `[trustie_testimonial_grid]` — Convenience grid layout wrapper.
    56 
    57 **Product Reviews** (WooCommerce required)
    58 
    59 `[trustie_reviews]` — Reviews for a specific product with optional form and summary.
    60 `[trustie_all_reviews]` — Reviews from all products in a grid.
    61 `[trustie_reviews_page]` — Full reviews page with pagination.
    62 `[trustie_review_form]` — Standalone review submission form.
    63 `[trustie_rating]` — Average star rating for a product.
    64 `[trustie_rating_badge]` — Compact rating badge (stars + count in one line).
    65 `[trustie_loop_stars]` — Lightweight stars optimized for product archives.
    66 
    67 Every shortcode accepts optional attributes for customization. See the [shortcode reference](https://doc.tracksies.com/docs/trustie-free/shortcode-reference/) for full details.
    68 
    69 = Premium Add-ons =
    70 
    71 * **Trustie Pro** — Photo reviews, custom review forms, advanced filtering, enhanced widget controls.
    72 * **Tracksies HQ** — Customer intelligence, order management, badges, email templates.
    73 
    74 Visit [tracksies.com](https://tracksies.com) to learn more.
     52**Google Reviews (no WooCommerce needed)**
     53
     54* `[trustie_google_reviews]` — Display your Google Business reviews with aggregate rating and schema markup
     55
     56**Testimonials (no WooCommerce needed)**
     57
     58* `[trustie_testimonials]` — Display testimonials in grid, list, or masonry layout
     59* `[trustie_testimonial_form]` — Customer testimonial submission form
     60* `[trustie_testimonial_slider]` — Auto-advancing testimonial carousel
     61* `[trustie_testimonial_grid]` — Grid layout wrapper
     62
     63**Product Reviews (WooCommerce required)**
     64
     65* `[trustie_reviews]` — Reviews for a specific product with optional form and summary
     66* `[trustie_all_reviews]` — Reviews from all products in a grid
     67* `[trustie_reviews_page]` — Full reviews page with pagination
     68* `[trustie_review_form]` — Standalone review submission form
     69* `[trustie_rating]` — Average star rating for a product
     70* `[trustie_rating_badge]` — Compact rating badge (stars + count)
     71* `[trustie_loop_stars]` — Lightweight stars for product archives
     72
     73Every shortcode accepts optional attributes for customisation. See the [shortcode reference](https://docs.tracksies.com/docs/trustie-free/using-trustie/shortcode-reference/) for full details.
     74
     75= Part of the Tracksies Family =
     76
     77Trustie is the free starting point. When you're ready for more, the rest of the family is here:
     78
     79* **Trustie Pro** — Photo reviews, Q&A, custom forms, multi-step email sequences, import from Judge.me/Yotpo/Stamped, Google Merchant feed
     80* **Tracksies HQ** — Customer intelligence, order management, priority rules, returns, branded emails and PDF invoices
     81* **Packsie** — Warehouse dashboard and staff management
     82* **Perkie** — Loyalty points, VIP tiers, referrals
     83* **Squizzie** — Analytics, Google integrations, branded PDF reports
     84* **Pipesie** — CRM and pipeline for service businesses
     85
     86Every Tracksie connects to every other Tracksie. Your review data flows into customer profiles, informs loyalty tiers, feeds analytics — automatically.
     87
     88Visit [tracksies.com](https://tracksies.com) to meet the family.
     89
     90= Documentation =
     91
     92Full documentation is available at [docs.tracksies.com](https://docs.tracksies.com/docs/trustie-free/).
    7593
    7694== Installation ==
    7795
    78 1. Upload the plugin files to `/wp-content/plugins/trustie/` or install through the WordPress plugin screen.
    79 2. Activate the plugin through the 'Plugins' screen in WordPress.
    80 3. For Google reviews: Go to Trustie > Settings > Google Reviews and enter your API key and Place ID.
    81 4. For testimonials: Add `[trustie_testimonials]` and `[trustie_testimonial_form]` to any page.
    82 5. For product reviews: Ensure WooCommerce is installed and activated.
    83 6. Customize colors and branding in Trustie > Designer.
     961. Upload the `trustie` folder to `/wp-content/plugins/` or install directly from the WordPress plugin directory
     972. Activate the plugin through the Plugins menu in WordPress
     983. Go to **Trustie > Settings** to configure your preferences
     994. For Google Reviews: add your API key and Place ID in **Settings > Google Reviews**
     1005. Use shortcodes to display reviews and testimonials on any page or post
     101
     102For detailed setup instructions, see the [installation guide](https://docs.tracksies.com/docs/trustie-free/getting-started/installation/).
    84103
    85104== Frequently Asked Questions ==
    … …  
    87106= Does this work without WooCommerce? =
    88107
    89 Yes. Google reviews, testimonials, the floating widget, and the reviews page all work without WooCommerce. Product review features (star ratings, review lists, review forms) require WooCommerce.
     108Yes. Trustie works on any WordPress site. You get testimonials, Google Reviews, the floating widget, the reviews page, and the visual designer — no WooCommerce required. WooCommerce adds product reviews, star ratings, and review request emails.
    90109
    91110= How do I show Google reviews? =
    92111
    93 1. Create a Google API key with the Places API enabled.
    94 2. Find your Google Place ID.
    95 3. Enter both in Trustie > Settings > Google Reviews.
    96 4. Add `[trustie_google_reviews]` to any page.
    97 
    98 Google's API returns up to 5 individual reviews, but the aggregate rating reflects all your Google reviews.
    99 
    100 = Can I customize the colors? =
    101 
    102 Yes. Go to Trustie > Designer to set colors for stars, buttons, cards, and accents. Colors are applied site-wide through CSS variables.
    103 
    104 = Does this create its own review system? =
    105 
    106 For product reviews: No. Trustie displays your existing WooCommerce reviews (stored in wp_comments). It does not create separate tables.
    107 
    108 For testimonials: Yes. Trustie creates a Testimonials custom post type to store customer testimonials separately from product reviews.
     112Add your Google API key and Place ID in Trustie > Settings > Google Reviews, then use the `[trustie_google_reviews]` shortcode on any page. Full setup guide: [Connecting Google Reviews](https://docs.tracksies.com/docs/trustie-free/using-trustie/google-reviews/)
     113
     114= Can I customise the colours and styling? =
     115
     116Yes — Trustie has a built-in visual Designer (Trustie > Designer) where you can set brand colours, star styles, border radius, shadows, and more. It detects colours from your active theme automatically. [Designer guide](https://docs.tracksies.com/docs/trustie-free/using-trustie/customization/)
     117
     118= Does this replace WooCommerce's built-in reviews? =
     119
     120Trustie enhances them. It uses WooCommerce's native review system but gives you better-looking review cards, star summaries, rating breakdowns, and display shortcodes. Your existing reviews keep working.
    109121
    110122= Can testimonials be auto-approved? =
    111123
    112 Yes. Set an auto-approve threshold in Trustie > Settings. Testimonials at or above your threshold are published automatically. Lower-rated testimonials are held for manual review.
     124Yes. Set a star rating threshold in settings — testimonials at or above that rating publish automatically. Below it, they go to moderation.
    113125
    114126= Does Trustie help with SEO? =
    115127
    116 Yes. Trustie outputs JSON-LD structured data (LocalBusiness, AggregateRating, Review schema) that Google uses for rich results in search. This is automatic — no configuration needed.
     128Yes. Google Reviews output JSON-LD LocalBusiness and AggregateRating schema automatically. Testimonials output Review schema. WooCommerce product reviews use standard WooCommerce schema. All of this helps search engines display rich results with star ratings.
    117129
    118130= Is the testimonial form spam-protected? =
    119131
    120 The form uses WordPress nonces for security. For additional spam protection, we recommend a CAPTCHA plugin like hCaptcha or reCAPTCHA.
     132Yes. Trustie includes honeypot spam protection on the testimonial submission form. You can also require a minimum star rating and moderate submissions manually.
    121133
    122134= Can I import testimonials from another plugin? =
    123135
    124 Yes. Trustie detects testimonials from Strong Testimonials, Easy Testimonials, and Starter Templates automatically. Go to Trustie > Settings > Testimonials (or the Import tab) and click Import. You can choose to keep or remove the originals.
     136Yes. Trustie auto-detects Strong Testimonials, Easy Testimonials, and Starter Templates and offers one-click import. You can keep or remove the originals. [Import tools guide](https://docs.tracksies.com/docs/trustie-free/using-trustie/import-tools/)
    125137
    126138= How do I convert product comments to reviews? =
    127139
    128 If you have WordPress comments on products from before WooCommerce reviews were enabled, go to Trustie > Settings > Product Reviews. The "Convert Comments to Reviews" section lets you assign a default star rating and convert them in one click. You can edit individual ratings afterwards.
     140Go to Trustie > Settings > Import. If you have existing WordPress comments on WooCommerce products, Trustie can convert them to proper star-rated reviews with a configurable default rating. One click.
    129141
    130142= How do review request emails work? =
    131143
    132 When WooCommerce is installed, Trustie can automatically email customers after a purchase asking them to leave a review. You can configure this in Trustie > Settings > Review Requests.
    133 
    134 **Timing:** Emails are scheduled when an order reaches "Processing" status. The delay (how many days after purchase) is configurable in settings.
    135 
    136 **Smart cancellation:** Review requests are automatically cancelled when:
    137 
    138 * The order is cancelled or refunded
    139 * The order payment fails
    140 * The customer initiates a return for the order
    141 * The customer submits a review (for any product on the order)
    142 * The customer clicks the unsubscribe link in the email
    143 
    144 This means customers will never receive a review request for an order that went wrong.
     144When a WooCommerce order is marked complete, Trustie can automatically send an email asking the customer to leave a review. You set the delay (days after order), customise the email content with placeholders, and Trustie handles the rest. [Email setup guide](https://docs.tracksies.com/docs/trustie-free/using-trustie/review-emails/)
    145145
    146146= What happens if I upgrade to Trustie Pro? =
    147147
    148 Pro adds features on top of Free. When you activate Pro, Free is automatically deactivated. All your settings, reviews, and testimonials carry over — nothing is lost.
     148All your existing settings, reviews, and testimonials stay exactly as they are. Pro adds features on top — photo reviews, Q&A, custom forms, multi-step email sequences, advanced moderation, and import from Judge.me, Yotpo, and Stamped. If you ever deactivate Pro, everything gracefully falls back to Free. [See what Pro adds](https://docs.tracksies.com/docs/trustie-free/upgrade/trustie-pro/)
     149
     150= Where is my data stored? =
     151
     152In your WordPress database. On your server. Trustie is fully self-hosted — no external servers, no API calls to our infrastructure, no data leaving your site. If you uninstall Trustie, your reviews and testimonials remain in your database.
     153
     154= Is Trustie accessible? =
     155
     156We've built Trustie with accessibility as a priority — keyboard navigation, visible focus indicators, screen reader announcements, and descriptive aria-labels throughout. We test against WCAG 2.1 AA guidelines and actively work to improve accessibility with every update. If you find something we've missed, please let us know.
    149157
    150158== Screenshots ==
    151159
    152 1. Google reviews display with aggregate rating
    153 2. Testimonial grid layout
    154 3. Testimonial submission form
    155 4. Floating reviews widget
    156 5. Product review cards with star ratings
    157 6. Visual Designer color customization
    158 
    159 == Privacy Policy ==
    160 
    161 Trustie uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.
    162 
    163 Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users.
    164 
    165 Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**
    166 
    167 Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).
    168 
    169 == External Services ==
    170 
    171 This plugin connects to the following external services:
    172 
    173 = Google Places API =
    174 
    175 Trustie uses the [Google Places API](https://developers.google.com/maps/documentation/places/web-service) to retrieve your Google Business reviews for display on your site.
    176 
    177 * **What data is sent:** Your Google API key and Place ID (both configured by you in plugin settings).
    178 * **When:** When a page containing the `[trustie_google_reviews]` shortcode is loaded, or when you test the connection from Settings > Google Reviews. Results are cached for 24 hours to minimize requests.
    179 * **No visitor data is sent to Google** — only your business credentials are used to fetch your own reviews.
    180 * [Google Terms of Service](https://cloud.google.com/maps-platform/terms)
    181 * [Google Privacy Policy](https://policies.google.com/privacy)
    182 
    183 = Appsero =
    184 
    185 Trustie uses the [Appsero](https://appsero.com) SDK for optional, opt-in diagnostic data collection. This helps us troubleshoot issues and improve the plugin.
    186 
    187 * **Tracking is disabled by default.** Data is only collected after you explicitly allow it via the admin notice shown on plugin activation.
    188 * **What data is sent (when opted in):** Site URL, admin email, WordPress version, PHP version, server environment details, active plugin/theme information, and plugin version.
    189 * **When:** Once per week via a scheduled event, only if you have opted in.
    190 * **You can opt out at any time** from the admin notice or plugin settings.
    191 * [Appsero Terms of Service](https://appsero.com/terms-conditions/)
    192 * [Appsero Privacy Policy](https://appsero.com/privacy-policy/)
    193 
    194 = icanhazip.com (Cloudflare) =
    195 
    196 When you opt in to Appsero diagnostic tracking (see above), Trustie uses [icanhazip.com](https://icanhazip.com/) to determine your server's public IP address for environment diagnostics. This service is operated by [Cloudflare, Inc.](https://www.cloudflare.com/).
    197 
    198 * **What data is sent:** A simple HTTP GET request with no payload.
    199 * **When:** Only when you have opted into Appsero tracking. Not called if tracking is disabled (the default).
    200 * **What is returned:** Your server's public IP address, which is included in the Appsero diagnostic data.
    201 * [Cloudflare Terms of Use](https://www.cloudflare.com/terms/)
    202 * [Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/)
     1601. Product reviews with aggregate star rating, rating breakdown, and review cards with verified purchase badges
     1612. Visual Designer — customise brand colours, star styles, and UI appearance with live preview
     1623. Floating review widget showing reviews from all sources with tabs for Products and Google
     1634. Review submission form with star rating selector and the floating widget alongside
     1645. Reviews page with tabs for All Reviews, Product Reviews, Testimonials, and Google Reviews
     1656. Settings page — testimonial configuration, form settings, shortcode reference sidebar
     1667. Feature toggles — enable or disable individual Trustie features from the Settings panel
     1678. Debug logging — built-in diagnostic log with colour-coded entries for troubleshooting
     1689. Product page star rating display on a WooCommerce product
    203169
    204170== Changelog ==
    … …  
    212178
    213179= 1.0.4 =
    214 * Fix: Reviews page performance — batch meta/product queries (800+ queries → ~10)
     180* Fix: Reviews page performance — batch meta/product queries (800+ queries to ~10)
    215181* Fix: Floating widget CSS/fonts not loading on non-product pages
    216182* New: Reviews page transient caching with 5-minute TTL, auto-invalidated on review changes
    … …  
    242208== Upgrade Notice ==
    243209
     210= 1.0.5 =
     211Security and compliance improvements. All output escaping and file operations updated to WordPress best practices.
     212
    244213= 1.0.0 =
    245 Initial release of Trustie.
     214Welcome to Trustie! Reviews, testimonials, and Google Business reviews for WordPress — free, self-hosted, and yours.
     215
     216== Privacy ==
     217
     218Trustie uses the Appsero SDK for optional, opt-in diagnostic data collection. This helps us troubleshoot issues and improve the plugin.
     219
     220* **Tracking is disabled by default.** Data is only collected after you explicitly allow it via the admin notice on activation.
     221* **What is collected (when opted in):** Active theme and PHP version.
     222* **When:** Once per week via a scheduled event, only if opted in.
     223* **You can opt out at any time** from the admin notice or plugin settings.
     224
     225[Appsero Terms of Service](https://appsero.com/terms) | [Appsero Privacy Policy](https://appsero.com/privacy)
     226
     227== External Services ==
     228
     229This plugin connects to the following external services:
     230
     231= Google Places API =
     232
     233Trustie uses the Google Places API to retrieve your Google Business reviews for display on your site.
     234
     235* **What data is sent:** Your Google API key and Place ID (both configured by you in plugin settings)
     236* **When:** When a page containing the `[trustie_google_reviews]` shortcode is loaded, or when you test the connection from Settings > Google Reviews. Results are cached for 24 hours to minimise requests
     237* **No visitor data is sent to Google** — only your business credentials are used to fetch your own reviews
     238
     239[Google Terms of Service](https://policies.google.com/terms) | [Google Privacy Policy](https://policies.google.com/privacy)
     240
     241= Appsero =
     242
     243Trustie uses the Appsero SDK for optional, opt-in diagnostic data collection.
     244
     245* **Tracking is disabled by default.** Data is only collected after you explicitly allow it via the admin notice shown on plugin activation
     246* **What data is sent (when opted in):** Site URL, admin email, WordPress version, PHP version, server environment details, active plugin/theme information, and plugin version
     247* **When:** Once per week via a scheduled event, only if you have opted in
     248* **You can opt out at any time** from the admin notice or plugin settings
     249
     250[Appsero Terms of Service](https://appsero.com/terms-conditions/) | [Appsero Privacy Policy](https://appsero.com/privacy-policy/)
     251
     252= icanhazip.com (Cloudflare) =
     253
     254When you opt in to Appsero diagnostic tracking (see above), Trustie uses [icanhazip.com](https://icanhazip.com/) to determine your server's public IP address for environment diagnostics. This service is operated by [Cloudflare, Inc.](https://www.cloudflare.com/).
     255
     256* **What data is sent:** A simple HTTP GET request with no payload
     257* **When:** Only when you have opted into Appsero tracking. Not called if tracking is disabled (the default)
     258* **What is returned:** Your server's public IP address, which is included in the Appsero diagnostic data
     259
     260[Cloudflare Terms of Use](https://www.cloudflare.com/terms/) | [Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/)

  • trustie/tags/1.0.5/trustie.php

    r3496170 r3496235  
    208208    }
    209209
    210     $client = new Trustie_Vendor\Appsero\Client( '66c3cc4e-bebb-49eb-a433-836f9f20a6ce', 'Trustie', __FILE__ );
     210    $client = new Trustie_Vendor\Appsero\Client( '0caaf649-5f48-45e4-bb70-7c28c4984aab', 'Trustie', __FILE__ );
    211211
    212212    // Deactivation reasons only — no diagnostic data collection for the free plugin.

  • trustie/trunk/readme.txt

    r3496170 r3496235  
    11=== Trustie ===
    22Contributors: tracksies
    3 Tags: reviews, testimonials, google reviews, ratings, stars
     3Tags: reviews, testimonials, woocommerce reviews, google reviews, star ratings, product reviews, customer reviews, review plugin, social proof, schema markup
    44Requires at least: 6.0
    5 Tested up to: 6.9
     5Tested up to: 6.8
    66Requires PHP: 7.4
    77Stable tag: 1.0.5
    … …  
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Reviews, testimonials, and Google reviews for WordPress. Works with or without WooCommerce.
     11Reviews, testimonials, and Google Business reviews for WordPress & WooCommerce. Self-hosted. Free forever. Your data stays yours.
    1212
    1313== Description ==
    1414
    15 Trustie brings reviews, testimonials, and Google Business reviews to any WordPress site. Use it standalone for testimonials and Google reviews, or pair it with WooCommerce for product reviews, star ratings, and review request emails.
     15**Trustie brings reviews, testimonials, and Google Business reviews to any WordPress site.**
     16
     17Use it standalone for testimonials and Google reviews — no WooCommerce needed. Or pair it with WooCommerce for product reviews, star ratings, and automated review request emails. Everything stored in your database, on your server.
     18
     19Trustie is the free foundation of the [Tracksies](https://tracksies.com) plugin family — and it's a proper plugin, not a free-tier trap. No feature limits. No "upgrade to unlock." No monthly fees. Just reviews that work.
     20
     21**Switching from Judge.me?** Trustie is the self-hosted, flat-priced replacement. Your reviews, your database, your control. [Learn more about migrating](https://tracksies.com/migrate)
    1622
    1723= Works Without WooCommerce =
    1824
    19 * **Google Reviews** — Display your Google Business reviews with star ratings, author names, and a "View on Google" link. Outputs JSON-LD schema for search engine rich results.
    20 * **Testimonials** — Collect customer testimonials through a customizable form. Display them in grid, list, masonry, or slider layouts. Auto-approve above a rating threshold or moderate manually.
    21 * **Floating Widget** — A slide-out panel that shows your latest reviews from all sources on every page.
    22 * **Reviews Page** — A dedicated `/reviews/` page with tabs, filtering, and pagination. Works automatically — no WooCommerce needed.
    23 * **Visual Designer** — Customize colors, star styles, and branding from Trustie > Designer.
     25* **Google Reviews** — Display your Google Business reviews with star ratings, author names, and schema markup for rich results
     26* **Testimonials** — Collect testimonials through a customisable form. Display in grid, list, masonry, or slider layouts
     27* **Floating Widget** — A slide-out panel showing your latest reviews from all sources on every page
     28* **Reviews Page** — A dedicated /reviews/ page with tabs, filtering, and pagination. Works automatically
     29* **Visual Designer** — Customise colours, star styles, and branding from Trustie > Designer. Detects colours from your active theme
    2430
    2531= With WooCommerce =
    … …  
    2733Everything above, plus:
    2834
    29 * **Product Reviews** — Replace WooCommerce's default reviews with better-looking cards, star summaries, and rating breakdowns.
    30 * **Star Ratings** — Display average ratings anywhere with shortcodes. Lightweight loop stars for product archives.
    31 * **Review Request Emails** — Automatically email customers after purchase asking for a review.
    32 * **Convert Comments to Reviews** — Turn existing WordPress product comments into star-rated WooCommerce reviews with a configurable default rating.
    33 * **Sync Product Ratings** — Recalculate average ratings and review counts across all products.
     35* **Product Reviews** — Replace WooCommerce's default reviews with better-looking cards, star summaries, and rating breakdowns
     36* **Star Ratings** — Display average ratings anywhere with shortcodes. Lightweight loop stars for product archives
     37* **Review Request Emails** — Automatically email customers after purchase asking for a review
     38* **Convert Comments to Reviews** — Turn existing WordPress product comments into star-rated reviews
     39* **Sync Product Ratings** — Recalculate averages and counts across all products
    3440
    3541= Import Tools =
    3642
    37 * **Import Testimonials** — Automatically detects and imports testimonials from Strong Testimonials, Easy Testimonials, and Starter Templates. Originals can be kept or removed.
    38 * **Convert Product Comments** — If you have product comments from before WooCommerce reviews were enabled, convert them to proper reviews with star ratings in one click.
     43* **Import Testimonials** — Auto-detects and imports from Strong Testimonials, Easy Testimonials, and Starter Templates
     44* **Convert Product Comments** — One-click conversion from product comments to proper star-rated reviews
    3945
    4046= Accessibility =
    4147
    42 Trustie meets WCAG 2.1 AA standards: keyboard navigation, visible focus indicators, screen reader announcements for form submissions and content loading, and descriptive labels on all interactive controls.
     48Trustie is built with accessibility in mind: keyboard navigation, visible focus indicators, screen reader announcements for form submissions and content loading, and descriptive labels on interactive controls. We test against WCAG guidelines and actively work to improve accessibility with every update.
    4349
    4450= Shortcodes =
    4551
    46 **Google Reviews** (no WooCommerce needed)
    47 
    48 `[trustie_google_reviews]` — Display your Google Business reviews with aggregate rating and schema markup. Requires a Google API key and Place ID (Settings > Google Reviews).
    49 
    50 **Testimonials** (no WooCommerce needed)
    51 
    52 `[trustie_testimonials]` — Display testimonials in grid, list, or masonry layout.
    53 `[trustie_testimonial_form]` — Customer testimonial submission form.
    54 `[trustie_testimonial_slider]` — Auto-advancing testimonial carousel.
    55 `[trustie_testimonial_grid]` — Convenience grid layout wrapper.
    56 
    57 **Product Reviews** (WooCommerce required)
    58 
    59 `[trustie_reviews]` — Reviews for a specific product with optional form and summary.
    60 `[trustie_all_reviews]` — Reviews from all products in a grid.
    61 `[trustie_reviews_page]` — Full reviews page with pagination.
    62 `[trustie_review_form]` — Standalone review submission form.
    63 `[trustie_rating]` — Average star rating for a product.
    64 `[trustie_rating_badge]` — Compact rating badge (stars + count in one line).
    65 `[trustie_loop_stars]` — Lightweight stars optimized for product archives.
    66 
    67 Every shortcode accepts optional attributes for customization. See the [shortcode reference](https://doc.tracksies.com/docs/trustie-free/shortcode-reference/) for full details.
    68 
    69 = Premium Add-ons =
    70 
    71 * **Trustie Pro** — Photo reviews, custom review forms, advanced filtering, enhanced widget controls.
    72 * **Tracksies HQ** — Customer intelligence, order management, badges, email templates.
    73 
    74 Visit [tracksies.com](https://tracksies.com) to learn more.
     52**Google Reviews (no WooCommerce needed)**
     53
     54* `[trustie_google_reviews]` — Display your Google Business reviews with aggregate rating and schema markup
     55
     56**Testimonials (no WooCommerce needed)**
     57
     58* `[trustie_testimonials]` — Display testimonials in grid, list, or masonry layout
     59* `[trustie_testimonial_form]` — Customer testimonial submission form
     60* `[trustie_testimonial_slider]` — Auto-advancing testimonial carousel
     61* `[trustie_testimonial_grid]` — Grid layout wrapper
     62
     63**Product Reviews (WooCommerce required)**
     64
     65* `[trustie_reviews]` — Reviews for a specific product with optional form and summary
     66* `[trustie_all_reviews]` — Reviews from all products in a grid
     67* `[trustie_reviews_page]` — Full reviews page with pagination
     68* `[trustie_review_form]` — Standalone review submission form
     69* `[trustie_rating]` — Average star rating for a product
     70* `[trustie_rating_badge]` — Compact rating badge (stars + count)
     71* `[trustie_loop_stars]` — Lightweight stars for product archives
     72
     73Every shortcode accepts optional attributes for customisation. See the [shortcode reference](https://docs.tracksies.com/docs/trustie-free/using-trustie/shortcode-reference/) for full details.
     74
     75= Part of the Tracksies Family =
     76
     77Trustie is the free starting point. When you're ready for more, the rest of the family is here:
     78
     79* **Trustie Pro** — Photo reviews, Q&A, custom forms, multi-step email sequences, import from Judge.me/Yotpo/Stamped, Google Merchant feed
     80* **Tracksies HQ** — Customer intelligence, order management, priority rules, returns, branded emails and PDF invoices
     81* **Packsie** — Warehouse dashboard and staff management
     82* **Perkie** — Loyalty points, VIP tiers, referrals
     83* **Squizzie** — Analytics, Google integrations, branded PDF reports
     84* **Pipesie** — CRM and pipeline for service businesses
     85
     86Every Tracksie connects to every other Tracksie. Your review data flows into customer profiles, informs loyalty tiers, feeds analytics — automatically.
     87
     88Visit [tracksies.com](https://tracksies.com) to meet the family.
     89
     90= Documentation =
     91
     92Full documentation is available at [docs.tracksies.com](https://docs.tracksies.com/docs/trustie-free/).
    7593
    7694== Installation ==
    7795
    78 1. Upload the plugin files to `/wp-content/plugins/trustie/` or install through the WordPress plugin screen.
    79 2. Activate the plugin through the 'Plugins' screen in WordPress.
    80 3. For Google reviews: Go to Trustie > Settings > Google Reviews and enter your API key and Place ID.
    81 4. For testimonials: Add `[trustie_testimonials]` and `[trustie_testimonial_form]` to any page.
    82 5. For product reviews: Ensure WooCommerce is installed and activated.
    83 6. Customize colors and branding in Trustie > Designer.
     961. Upload the `trustie` folder to `/wp-content/plugins/` or install directly from the WordPress plugin directory
     972. Activate the plugin through the Plugins menu in WordPress
     983. Go to **Trustie > Settings** to configure your preferences
     994. For Google Reviews: add your API key and Place ID in **Settings > Google Reviews**
     1005. Use shortcodes to display reviews and testimonials on any page or post
     101
     102For detailed setup instructions, see the [installation guide](https://docs.tracksies.com/docs/trustie-free/getting-started/installation/).
    84103
    85104== Frequently Asked Questions ==
    … …  
    87106= Does this work without WooCommerce? =
    88107
    89 Yes. Google reviews, testimonials, the floating widget, and the reviews page all work without WooCommerce. Product review features (star ratings, review lists, review forms) require WooCommerce.
     108Yes. Trustie works on any WordPress site. You get testimonials, Google Reviews, the floating widget, the reviews page, and the visual designer — no WooCommerce required. WooCommerce adds product reviews, star ratings, and review request emails.
    90109
    91110= How do I show Google reviews? =
    92111
    93 1. Create a Google API key with the Places API enabled.
    94 2. Find your Google Place ID.
    95 3. Enter both in Trustie > Settings > Google Reviews.
    96 4. Add `[trustie_google_reviews]` to any page.
    97 
    98 Google's API returns up to 5 individual reviews, but the aggregate rating reflects all your Google reviews.
    99 
    100 = Can I customize the colors? =
    101 
    102 Yes. Go to Trustie > Designer to set colors for stars, buttons, cards, and accents. Colors are applied site-wide through CSS variables.
    103 
    104 = Does this create its own review system? =
    105 
    106 For product reviews: No. Trustie displays your existing WooCommerce reviews (stored in wp_comments). It does not create separate tables.
    107 
    108 For testimonials: Yes. Trustie creates a Testimonials custom post type to store customer testimonials separately from product reviews.
     112Add your Google API key and Place ID in Trustie > Settings > Google Reviews, then use the `[trustie_google_reviews]` shortcode on any page. Full setup guide: [Connecting Google Reviews](https://docs.tracksies.com/docs/trustie-free/using-trustie/google-reviews/)
     113
     114= Can I customise the colours and styling? =
     115
     116Yes — Trustie has a built-in visual Designer (Trustie > Designer) where you can set brand colours, star styles, border radius, shadows, and more. It detects colours from your active theme automatically. [Designer guide](https://docs.tracksies.com/docs/trustie-free/using-trustie/customization/)
     117
     118= Does this replace WooCommerce's built-in reviews? =
     119
     120Trustie enhances them. It uses WooCommerce's native review system but gives you better-looking review cards, star summaries, rating breakdowns, and display shortcodes. Your existing reviews keep working.
    109121
    110122= Can testimonials be auto-approved? =
    111123
    112 Yes. Set an auto-approve threshold in Trustie > Settings. Testimonials at or above your threshold are published automatically. Lower-rated testimonials are held for manual review.
     124Yes. Set a star rating threshold in settings — testimonials at or above that rating publish automatically. Below it, they go to moderation.
    113125
    114126= Does Trustie help with SEO? =
    115127
    116 Yes. Trustie outputs JSON-LD structured data (LocalBusiness, AggregateRating, Review schema) that Google uses for rich results in search. This is automatic — no configuration needed.
     128Yes. Google Reviews output JSON-LD LocalBusiness and AggregateRating schema automatically. Testimonials output Review schema. WooCommerce product reviews use standard WooCommerce schema. All of this helps search engines display rich results with star ratings.
    117129
    118130= Is the testimonial form spam-protected? =
    119131
    120 The form uses WordPress nonces for security. For additional spam protection, we recommend a CAPTCHA plugin like hCaptcha or reCAPTCHA.
     132Yes. Trustie includes honeypot spam protection on the testimonial submission form. You can also require a minimum star rating and moderate submissions manually.
    121133
    122134= Can I import testimonials from another plugin? =
    123135
    124 Yes. Trustie detects testimonials from Strong Testimonials, Easy Testimonials, and Starter Templates automatically. Go to Trustie > Settings > Testimonials (or the Import tab) and click Import. You can choose to keep or remove the originals.
     136Yes. Trustie auto-detects Strong Testimonials, Easy Testimonials, and Starter Templates and offers one-click import. You can keep or remove the originals. [Import tools guide](https://docs.tracksies.com/docs/trustie-free/using-trustie/import-tools/)
    125137
    126138= How do I convert product comments to reviews? =
    127139
    128 If you have WordPress comments on products from before WooCommerce reviews were enabled, go to Trustie > Settings > Product Reviews. The "Convert Comments to Reviews" section lets you assign a default star rating and convert them in one click. You can edit individual ratings afterwards.
     140Go to Trustie > Settings > Import. If you have existing WordPress comments on WooCommerce products, Trustie can convert them to proper star-rated reviews with a configurable default rating. One click.
    129141
    130142= How do review request emails work? =
    131143
    132 When WooCommerce is installed, Trustie can automatically email customers after a purchase asking them to leave a review. You can configure this in Trustie > Settings > Review Requests.
    133 
    134 **Timing:** Emails are scheduled when an order reaches "Processing" status. The delay (how many days after purchase) is configurable in settings.
    135 
    136 **Smart cancellation:** Review requests are automatically cancelled when:
    137 
    138 * The order is cancelled or refunded
    139 * The order payment fails
    140 * The customer initiates a return for the order
    141 * The customer submits a review (for any product on the order)
    142 * The customer clicks the unsubscribe link in the email
    143 
    144 This means customers will never receive a review request for an order that went wrong.
     144When a WooCommerce order is marked complete, Trustie can automatically send an email asking the customer to leave a review. You set the delay (days after order), customise the email content with placeholders, and Trustie handles the rest. [Email setup guide](https://docs.tracksies.com/docs/trustie-free/using-trustie/review-emails/)
    145145
    146146= What happens if I upgrade to Trustie Pro? =
    147147
    148 Pro adds features on top of Free. When you activate Pro, Free is automatically deactivated. All your settings, reviews, and testimonials carry over — nothing is lost.
     148All your existing settings, reviews, and testimonials stay exactly as they are. Pro adds features on top — photo reviews, Q&A, custom forms, multi-step email sequences, advanced moderation, and import from Judge.me, Yotpo, and Stamped. If you ever deactivate Pro, everything gracefully falls back to Free. [See what Pro adds](https://docs.tracksies.com/docs/trustie-free/upgrade/trustie-pro/)
     149
     150= Where is my data stored? =
     151
     152In your WordPress database. On your server. Trustie is fully self-hosted — no external servers, no API calls to our infrastructure, no data leaving your site. If you uninstall Trustie, your reviews and testimonials remain in your database.
     153
     154= Is Trustie accessible? =
     155
     156We've built Trustie with accessibility as a priority — keyboard navigation, visible focus indicators, screen reader announcements, and descriptive aria-labels throughout. We test against WCAG 2.1 AA guidelines and actively work to improve accessibility with every update. If you find something we've missed, please let us know.
    149157
    150158== Screenshots ==
    151159
    152 1. Google reviews display with aggregate rating
    153 2. Testimonial grid layout
    154 3. Testimonial submission form
    155 4. Floating reviews widget
    156 5. Product review cards with star ratings
    157 6. Visual Designer color customization
    158 
    159 == Privacy Policy ==
    160 
    161 Trustie uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.
    162 
    163 Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users.
    164 
    165 Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**
    166 
    167 Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).
    168 
    169 == External Services ==
    170 
    171 This plugin connects to the following external services:
    172 
    173 = Google Places API =
    174 
    175 Trustie uses the [Google Places API](https://developers.google.com/maps/documentation/places/web-service) to retrieve your Google Business reviews for display on your site.
    176 
    177 * **What data is sent:** Your Google API key and Place ID (both configured by you in plugin settings).
    178 * **When:** When a page containing the `[trustie_google_reviews]` shortcode is loaded, or when you test the connection from Settings > Google Reviews. Results are cached for 24 hours to minimize requests.
    179 * **No visitor data is sent to Google** — only your business credentials are used to fetch your own reviews.
    180 * [Google Terms of Service](https://cloud.google.com/maps-platform/terms)
    181 * [Google Privacy Policy](https://policies.google.com/privacy)
    182 
    183 = Appsero =
    184 
    185 Trustie uses the [Appsero](https://appsero.com) SDK for optional, opt-in diagnostic data collection. This helps us troubleshoot issues and improve the plugin.
    186 
    187 * **Tracking is disabled by default.** Data is only collected after you explicitly allow it via the admin notice shown on plugin activation.
    188 * **What data is sent (when opted in):** Site URL, admin email, WordPress version, PHP version, server environment details, active plugin/theme information, and plugin version.
    189 * **When:** Once per week via a scheduled event, only if you have opted in.
    190 * **You can opt out at any time** from the admin notice or plugin settings.
    191 * [Appsero Terms of Service](https://appsero.com/terms-conditions/)
    192 * [Appsero Privacy Policy](https://appsero.com/privacy-policy/)
    193 
    194 = icanhazip.com (Cloudflare) =
    195 
    196 When you opt in to Appsero diagnostic tracking (see above), Trustie uses [icanhazip.com](https://icanhazip.com/) to determine your server's public IP address for environment diagnostics. This service is operated by [Cloudflare, Inc.](https://www.cloudflare.com/).
    197 
    198 * **What data is sent:** A simple HTTP GET request with no payload.
    199 * **When:** Only when you have opted into Appsero tracking. Not called if tracking is disabled (the default).
    200 * **What is returned:** Your server's public IP address, which is included in the Appsero diagnostic data.
    201 * [Cloudflare Terms of Use](https://www.cloudflare.com/terms/)
    202 * [Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/)
     1601. Product reviews with aggregate star rating, rating breakdown, and review cards with verified purchase badges
     1612. Visual Designer — customise brand colours, star styles, and UI appearance with live preview
     1623. Floating review widget showing reviews from all sources with tabs for Products and Google
     1634. Review submission form with star rating selector and the floating widget alongside
     1645. Reviews page with tabs for All Reviews, Product Reviews, Testimonials, and Google Reviews
     1656. Settings page — testimonial configuration, form settings, shortcode reference sidebar
     1667. Feature toggles — enable or disable individual Trustie features from the Settings panel
     1678. Debug logging — built-in diagnostic log with colour-coded entries for troubleshooting
     1689. Product page star rating display on a WooCommerce product
    203169
    204170== Changelog ==
    … …  
    212178
    213179= 1.0.4 =
    214 * Fix: Reviews page performance — batch meta/product queries (800+ queries → ~10)
     180* Fix: Reviews page performance — batch meta/product queries (800+ queries to ~10)
    215181* Fix: Floating widget CSS/fonts not loading on non-product pages
    216182* New: Reviews page transient caching with 5-minute TTL, auto-invalidated on review changes
    … …  
    242208== Upgrade Notice ==
    243209
     210= 1.0.5 =
     211Security and compliance improvements. All output escaping and file operations updated to WordPress best practices.
     212
    244213= 1.0.0 =
    245 Initial release of Trustie.
     214Welcome to Trustie! Reviews, testimonials, and Google Business reviews for WordPress — free, self-hosted, and yours.
     215
     216== Privacy ==
     217
     218Trustie uses the Appsero SDK for optional, opt-in diagnostic data collection. This helps us troubleshoot issues and improve the plugin.
     219
     220* **Tracking is disabled by default.** Data is only collected after you explicitly allow it via the admin notice on activation.
     221* **What is collected (when opted in):** Active theme and PHP version.
     222* **When:** Once per week via a scheduled event, only if opted in.
     223* **You can opt out at any time** from the admin notice or plugin settings.
     224
     225[Appsero Terms of Service](https://appsero.com/terms) | [Appsero Privacy Policy](https://appsero.com/privacy)
     226
     227== External Services ==
     228
     229This plugin connects to the following external services:
     230
     231= Google Places API =
     232
     233Trustie uses the Google Places API to retrieve your Google Business reviews for display on your site.
     234
     235* **What data is sent:** Your Google API key and Place ID (both configured by you in plugin settings)
     236* **When:** When a page containing the `[trustie_google_reviews]` shortcode is loaded, or when you test the connection from Settings > Google Reviews. Results are cached for 24 hours to minimise requests
     237* **No visitor data is sent to Google** — only your business credentials are used to fetch your own reviews
     238
     239[Google Terms of Service](https://policies.google.com/terms) | [Google Privacy Policy](https://policies.google.com/privacy)
     240
     241= Appsero =
     242
     243Trustie uses the Appsero SDK for optional, opt-in diagnostic data collection.
     244
     245* **Tracking is disabled by default.** Data is only collected after you explicitly allow it via the admin notice shown on plugin activation
     246* **What data is sent (when opted in):** Site URL, admin email, WordPress version, PHP version, server environment details, active plugin/theme information, and plugin version
     247* **When:** Once per week via a scheduled event, only if you have opted in
     248* **You can opt out at any time** from the admin notice or plugin settings
     249
     250[Appsero Terms of Service](https://appsero.com/terms-conditions/) | [Appsero Privacy Policy](https://appsero.com/privacy-policy/)
     251
     252= icanhazip.com (Cloudflare) =
     253
     254When you opt in to Appsero diagnostic tracking (see above), Trustie uses [icanhazip.com](https://icanhazip.com/) to determine your server's public IP address for environment diagnostics. This service is operated by [Cloudflare, Inc.](https://www.cloudflare.com/).
     255
     256* **What data is sent:** A simple HTTP GET request with no payload
     257* **When:** Only when you have opted into Appsero tracking. Not called if tracking is disabled (the default)
     258* **What is returned:** Your server's public IP address, which is included in the Appsero diagnostic data
     259
     260[Cloudflare Terms of Use](https://www.cloudflare.com/terms/) | [Cloudflare Privacy Policy](https://www.cloudflare.com/privacypolicy/)

  • trustie/trunk/trustie.php

    r3496170 r3496235  
    208208    }
    209209
    210     $client = new Trustie_Vendor\Appsero\Client( '66c3cc4e-bebb-49eb-a433-836f9f20a6ce', 'Trustie', __FILE__ );
     210    $client = new Trustie_Vendor\Appsero\Client( '0caaf649-5f48-45e4-bb70-7c28c4984aab', 'Trustie', __FILE__ );
    211211
    212212    // Deactivation reasons only — no diagnostic data collection for the free plugin.
Note: See TracChangeset for help on using the changeset viewer.