Etchenet Reviews for Google Business -- WordPress 插件

开发者	etchenet
更新时间	2026年9月11日 07:36
捐献地址:	去捐款
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

Etchenet Reviews for Google Business shows your Google Business reviews in a modern carousel (Swiper), a floating badge, and a side panel. Ideal for building trust and social proof on your site. Internationalization

All translatable strings in the plugin use English (United States, en_US) as the message source, as required for community translation on WordPress.org.
On a site whose locale is en_US, WordPress typically uses those strings as-is from the plugin (no separate English file required).
Spanish (es_ES) and French (fr_FR) translation files are included under languages/. Other locales can use language packs from wordpress.org when available, or custom .mo / .l10n.php files.

Features

Carousel – Shortcode [etn_egr_reviews_carousel] with configurable columns, autoplay, arrows, dots
Floating badge – Shows rating and total reviews; click to open the side panel
Side panel – List of reviews in a slide-out panel (position and styles configurable)
Manual reviews – Add and manage your own reviews in the admin (same structure as Google)
CSV/Excel import – Bulk import from .csv or .xlsx with a header row such as Author, Text, Stars, Date, Photo URL (minimum: Author, Stars). Text is optional, including in headerless files. Spanish column names (e.g. Autor, Texto) are also recognized for compatibility.
Google API sync – One-click sync with Google Places API (API Key + Place ID); optional daily cron
Order – Sort by newest, oldest, best/worst rating, or drag-and-drop manual order in the admin list
Customizable – Colors, excerpt length, min stars, “Read more” modal, Rich Snippets (JSON-LD)
Translations – Text domain: etchenet-reviews-for-google-business; see Internationalization above

Requirements

WordPress 5.0+
PHP 7.4+
PHP ZIP, XMLReader and SimpleXML extensions for XLSX imports (CSV imports do not require them)
Google API Key and Place ID (for syncing from Google); optional for manual-only use

How reviews are loaded from the Google API The plugin uses the Google Places API (Place Details). It requests the reviews field for your place (using your API Key and Place ID). Google returns a limited number of reviews per request (typically 5) and does not support pagination for reviews. On each sync, the plugin fetches the current batch from Google, updates matching reviews while preserving their visibility, and adds new reviews to the stored list for the same Place ID. API failures are reported even when older reviews are available. If you change the Place ID, the previous place's reviews are not displayed under the new place; reset the stored Google reviews explicitly before syncing a different place. The API response is cached for 12 hours to avoid excessive requests. Stored review data and Google's limits Because the API returns only a small set per call (usually 5) and has no pagination:

Stored reviews. This version preserves the existing local Google review inventory and its optional daily synchronization. Google Places restricts the storage of reviews and profile photos; a 12-hour response cache does not establish permission to retain the stored inventory. Confirm the rights applicable to your use of Google data. This release does not introduce a new retention policy or a Google Business Profile integration.
Manual reviews and import. Add testimonials you have the right to use or import them from CSV/Excel. These reviews are identified separately from Google API reviews; mixed collections use a neutral review heading.

For full details, check the plugin settings and this readme file.

安装:

Upload the plugin folder to /wp-content/plugins/ or install via Plugins → Add New and upload the zip.
Activate Etchenet Reviews for Google Business in the Plugins screen.
Go to Etchenet Reviews in the admin menu.
Enter your Google API Key and Place ID (or use only manual reviews and/or CSV/Excel import).
Click Sync now (Connectivity tab) to fetch reviews, or add manual reviews / import from file.
Insert the shortcode [etn_egr_reviews_carousel] in any page or post where you want the carousel.
Optionally enable the floating badge and adjust layout, filters, and styles on the same settings page.

Optional: Translations The plugin ships with Spanish and French translation files in languages/. No extra plugin is required for those languages to work when the site locale matches.

To add or improve translations: use Loco Translate or Poedit with the template languages/etchenet-reviews-for-google-business.pot.
Place .po/.mo files in wp-content/plugins/etchenet-reviews-for-google-business/languages/ or in wp-content/languages/plugins/ (e.g. etchenet-reviews-for-google-business-es_ES.mo, etchenet-reviews-for-google-business-fr_FR.mo).

If you use Loco Translate (or pass the plugin to someone who does)

Install and activate Loco Translate in WordPress.
Go to Loco Translate → Plugins and open Etchenet Reviews for Google Business.
You will see the translation set etchenet-reviews-for-google-business.
Choose the language (e.g. Français, Español, English) and edit/save. Loco will save into the plugin’s languages/ folder by default, so translations travel with the plugin.
Use only files whose names start with etchenet-reviews-for-google-business- (e.g. etchenet-reviews-for-google-business-fr_FR.po).

常见问题:

更新日志:

7.0.14

Fixed hidden manual reviews reappearing when no visible reviews remain.
Fixed overlapping avatars after image optimizers wrap images in picture elements.
Fixed scroll locking for review dialogs and combined hover/focus autoplay pauses.
Fixed false synchronization success, stale review updates, and mixing different Place IDs.
Added support for inline XLSX strings and bounded malformed spreadsheet input.
Fixed CSV carriage-return escaping and preserved Google photo URLs in exports.
Distinguished manual testimonials from Google API reviews and completed the Swiper MIT notice.
Preserved the existing Google review history; documented its separate retention-policy limitation.

7.0.13

Compact badge: moved the rating above the stars to reduce its horizontal footprint on mobile and floating placements.

7.0.12

Fixed the mobile carousel width when navigation arrows are disabled, preventing unnecessary text wrapping and overly tall default cards.
Reduced mobile-only card padding slightly when arrows are disabled, without changing configured desktop or tablet styling.

7.0.11

Fixed the settings save-state indicator so it is shown only after a real settings change and returns to the saved state when changes are reverted.

7.0.10

Added an optional compact floating-badge format and mobile-only compact mode.
Added independent badge controls for the Google logo and review count.
Added an accessible Spanish label for the Google write-review button.

7.0.9

Side-panel close-button hover colors now apply only during a real pointer hover; automatic focus on panel opening keeps the configured normal colors.
Keyboard focus retains an independent :focus-visible accessibility outline without reusing the hover background, icon, or border colors.

7.0.8

Carousel card background and border settings now remain authoritative when a theme applies competing important shorthands to the shared card class.
Carousel-card, side-panel, and side-panel-card shadow presets now control their complete preset state, including activation, when resolved on the frontend.

7.0.7

Side-panel Read-more styling now uses explicit, component-scoped background, border, radius, and logical padding properties so every saved panel setting is applied independently of carousel, theme, and Elementor links.
Hover border width continues to inherit the normal panel border width when its optional setting is left empty; keyboard focus keeps its independent accessibility outline.

7.0.6

Side-panel Read-more borders: hover now uses the configured border color and an optional hover-only width that inherits the normal width when left empty.
Accessibility: removed the mouse-hover currentColor outline from the side-panel Read-more link; an independent outline is reserved for :focus-visible keyboard navigation.

7.0.5

Read-more borders: hover now uses the configured border color and an optional hover-only width that inherits the normal width when left empty.
Accessibility: removed the mouse-hover currentColor outline from the carousel read-more link; an independent outline is now reserved for :focus-visible keyboard navigation.

7.0.4

Carousel actions: deployed the saved read-more spacing value to the public stylesheet and retained strict component scoping for the slider link.
Responsive safety: cards preserve their selected aspect ratio while content fits, then expand only when large translated or administrator-styled header/footer controls would otherwise be clipped.
Read-more sizing: padding and borders now stay inside the card content width, with centered wrapping for deliberately large values on narrow screens.
French translation: aligned the public read-more action with the established “Lire la suite” terminology; Spanish remains “Leer más”.

7.0.3

Carousel container: added separately saved inner and outer spacing controls for top, right, bottom, and left, with an accessible linked/unlinked editing mode.
Rendering: the frontend and live preview now use scoped carousel-container spacing variables, responsive effective horizontal values, and protected internal navigation clearance so margins and padding cannot overflow their shortcode parent or clip arrows, pagination, or card shadows.
Fix: the carousel "Read more" spacing setting now applies to the public component; live-preview badge and side-panel card radii now use the same 0–80 px bounds as saved frontend values; modal padding and maximum width now honour the full ranges accepted by the settings screen.
Upgrade: existing configurations receive zero-valued spacing keys automatically without overwriting any saved carousel settings.

7.0.2

Reviews administration: restored one complete inventory for stored Google and manual reviews. Hidden reviews remain manageable in the administration screen and are not removed from storage.
Review management: added search, source/rating/status filters, total counters, page sizes (10, 20, 50, 100, or all), and accessible pagination.
Manual order: restored a dedicated unpaginated Reorder reviews mode with a global drag-and-drop list covering both Google and manual reviews. Saving validates a complete unique sequence before it is stored and selects Manual order for public components.
Data integrity: added an idempotent upgrade migration that retains legacy 6.x order keys and completes the saved sequence with stored reviews. Deleting a manual review now removes only its obsolete order key.
Review status: restored the visible/hidden control for both review sources. CSV export now includes all stored reviews, including hidden ones.
Carousel container: added an independent 0–200 px container-radius setting with a live preview. It applies only to the carousel container and does not clip its arrows, pagination, or shadows.

7.0.1

Floating badge states: separated normal, hover, and keyboard-focus border colors, widths, and styles. Hover and keyboard-focus widths or styles can inherit the normal badge border when left empty.
Accessibility: removed the non-configurable currentColor outline from the badge container and from mouse-focus states. Keyboard focus now uses configurable :focus-visible outlines only on the actual badge and write-review controls.
Preview: the real-time administration preview now mirrors the frontend badge border and keyboard-focus logic, including hover borders when the normal border width is zero.
Migration: existing 7.0 settings receive the new focus-state fields automatically without overwriting saved badge, hover, or write-review settings.

7.0.0

Major refactor: rebuilt the administration experience around eight task-focused tabs and a shared real-time preview that uses the public component markup.
Settings architecture: slider, floating badge, side panel, review window, and their actions now have component-scoped options so that a setting cannot leak into another component.
Visual system: added component-specific colors with opacity, typography controls, borders, spacing, and independent structured shadows for the badge, panel, review cards, carousel, modal, and supported controls.
Component improvements: refreshed the floating badge, side panel, and full-review modal with isolated layers, accessible close controls, responsive behavior, and styles protected from theme or Elementor resets.
Display controls: added independent slider pagination, native SVG arrows, structured shadows, a configurable Google write-review button, and shared displayed review-count and rating controls for the badge and side panel. A component-scoped Swiper compatibility fix preserves the left/right direction of previous and next arrows without affecting other sliders.
Critical carousel stability: the slider now uses a private, explicit Swiper runtime with reliable script dependencies, hidden-container recovery, ResizeObserver updates, and no fallback to Elementor or theme Swiper globals.
Card layout: restored a dedicated card-aspect-ratio control (automatic, 16:9, 3:2, 4:3, or custom width / height) alongside independent height behaviour (automatic, equal, minimum, or fixed). The ratio applies only to the inner carousel card; Swiper slide widths and the side panel remain unaffected.
Card content: ratio and fixed-height cards keep their header and footer visible while the review text truncates cleanly when space is limited. Existing 6.x ratios and early 7.0 ratio-as-height values migrate automatically without overwriting saved choices.
Preview parity: the administration preview now runs the same real Swiper lifecycle and card markup as the frontend, including pagination and navigation.
Preview usability: the administration preview always inspects one complete review card, independently of the public carousel columns. New Desktop, Tablet, and Mobile controls change only the simulated preview width.
Arrow borders: added separate normal, hover, and keyboard-focus border colors, plus independent border thickness and style controls for this plugin’s carousel arrows.
Floating badge controls: added independent normal, hover, and keyboard-focus border colors, border style, width, and transition. The Google write-review button can now appear to the left, right, or compactly inside the badge with its own visual, hover, and focus controls.
Badge compatibility: configurations from 6.x retain the historic integrated + button when that layout can be identified safely; saved left/right configurations are preserved unchanged.
Manual reviews: reviews created with an author and stars only remain visible in the carousel, floating badge, and side panel even when the optional empty-text filter is enabled.
Translation safety: upgrades preserve administrator-managed legacy translation files; the settings migration never deletes locale customizations.
Migration: existing configurations are migrated automatically on upgrade. The migration is idempotent, preserves legacy and unknown values, and never overwrites a saved configuration.

6.1.7

Display: the configurable review count is now the single source of truth for every public review-count label, including the floating Google badge and both side-panel header layouts.
Admin: the badge and side-panel previews now update together in real time when this value changes.
Data integrity: review filtering, the average rating, review cards, operational admin totals, and structured-data counts continue to use real review data.

6.1.6

Full-review modal: added separate color controls for the modal, its close button, and the “Read more” link, including hover and keyboard-focus states.
Display: the modal is now a shared footer component with its own overlay. It opens above the side panel and works when the floating badge is used without a carousel shortcode.
Compatibility: isolated modal and “Read more” styles from theme-level button and link resets, including Hello Elementor.
Security: protected the manual Google-review sync with an administrator capability check and nonce, hardened remote avatar caching, and neutralized spreadsheet formulas in CSV exports.
Import: headerless files can now omit the optional review text (for example: Author, Stars, Date, Photo URL).
Dependencies: updated Swiper to 12.1.2 and replaced the broken alpha color-picker bundle with its readable GPL-2.0-or-later source.

6.1.5

Badge: added an optional setting to override only the review count displayed on the floating Google badge; leave it empty to keep the real filtered count.
Manual reviews: author name and a whole-star rating are now the only required fields. Review text and profile image are optional in add, edit, and CSV/Excel import workflows.
Display: manual reviews without text remain visible in the carousel, badge, and side panel without an empty-text gap; Google empty-text filtering is unchanged.

6.1.4

Internationalization: finalized English source strings in the active trunk code for WordPress.org translation workflows
Admin/UI consistency: aligned remaining visible labels and export headers with the English source baseline
Release prep: version bump and readme metadata updated for the 6.1.4 tag

6.1.3

Internationalization: user-facing strings use English (en_US) as the translation source (WordPress.org / Polyglots guidelines)
Readme: aligned with admin labels; clarified default locale, CSV headers, and Google API language parameter
Regenerated translation template and refreshed bundled es_ES / fr_FR / en_US catalogs

6.1.2

Fix: admin color pickers (Esthetica tab) now update the live preview in real time
Fix: card header layout — author name and stars are centered on the full card width while the avatar stays pinned left
Fix: sidebar panel review cards no longer inherit slider-only CSS (avatar sizing, star alignment)

6.1.0

Carousel, badge, and side panel with manual reviews and Google API sync
CSV/Excel import; drag-and-drop order; translation-ready (EN, ES, FR)
Rich Snippets (JSON-LD), configurable styles and filters

Etchenet Reviews for Google Business

标签

下载

详情介绍:

安装:

升级注意事项:

常见问题:

更新日志: