Descrizione
Couac is a visual feedback and review tool for agencies and their clients. This plugin embeds the Couac feedback widget on your WordPress site so visitors, clients or your QA team can leave feedback in one click, with a screenshot and the exact element they pointed at.
This is the official Couac plugin, built and maintained by G3W (https://gianito.com), the company that operates the Couac service at https://couac.app.
The plugin only decides where and to whom the widget appears. The widget’s look and feel (position, color, mascot, language, behaviour) stays managed in your Couac project, so a single source of truth drives every site.
Features
- Guided three-step setup right after activation: connect, choose who sees it, check it on the site.
- The key is checked with Couac as soon as you paste it, with the project name and whether this site is allowed.
- One honest status on the settings page: it tells you when the widget really loads, and how to fix it when it does not.
- Private review by default: only the roles you pick see the widget until you open it to the public.
- Audience targeting: a private review for chosen roles, every logged-in account, or the whole public site.
- Page targeting: all pages, only selected content types / IDs, or everywhere except selected ones.
- Optional loading inside the wp-admin dashboard.
- Advanced: load the widget from a dedicated Couac server address, tested before it is saved.
- No tracking added by the plugin, no database tables, lightweight.
You need a Couac account and a project to get a key. Create one at https://couac.app.
External services
This plugin loads the Couac feedback widget from Couac’s servers and embeds it on your pages.
- Service: Couac (https://couac.app), operated by G3W.
- What is sent: when a visitor opens the widget and submits feedback, the widget sends the feedback content, an optional screenshot, the page URL and basic technical metadata to Couac. The plugin itself sends only your public project key to identify your project.
- Checks from the settings page: when an administrator pastes a key or opens the plugin settings page, their browser asks Couac to confirm the key and checks that the widget script can be loaded. Only the public project key is sent. Couac answers with the project name and records that the widget is installed, so the Couac dashboard can show it. The WordPress server itself never contacts Couac.
- Terms of Service: https://couac.app/en/terms
- Privacy Policy: https://couac.app/en/privacy
By installing this plugin and adding your project key, you agree that the widget script is loaded from Couac on the pages you target.
Development
The plugin runs without any build step: the front-end injection is pure PHP and the admin script falls back to the unminified source when no compiled bundle is present.
The admin settings-page assets are built with webpack. The human-readable sources ship inside the plugin under assets/src/ (assets/src/js/admin.js, assets/src/scss/admin.scss); the compiled bundles live in assets/dist/. The build tooling (webpack.config.js, package.json) is included too.
To regenerate the compiled assets from source:
npm install && npm run build
Screenshot
Installazione
- Upload the plugin to
/wp-content/plugins/couac-feedback-widget, or install it from the Plugins screen. - Activate it through the Plugins menu in WordPress.
- The setup opens by itself (or go to Settings Couac Widget).
- Paste your project key (from your Couac project, Widget tab): it is checked right away.
- Choose who sees the widget, save, then open the site to see it live.
FAQ
-
Where do I find my project key?
-
In your Couac project, open the Widget tab. The key starts with
pk_. It is a public key, safe to ship in page source. -
Does the plugin store any personal data?
-
No. It stores only your plugin settings (the key and targeting rules). Feedback submitted through the widget is handled by Couac (see https://couac.app/en/privacy).
-
Can I restrict the widget to my team during a review?
-
Yes, and it is the default: “Private review” shows the widget only to the roles you pick (administrators and editors to start with). Visitors never see it until you choose “The whole public site”.
-
Where do I set up white label?
-
In your Couac project, White label tab: logo, color, sender name and hiding the Couac mention. The plugin does not need any change for it.
-
What is the “Couac server address” in Advanced?
-
Leave it empty in almost every case. Fill it only if Couac gave you a dedicated address already verified in your project. The plugin tests the address before saving it, and the settings page offers a one-click fix if the widget cannot load from it.
Recensioni
Non ci sono recensioni per questo plugin.
Contributi e sviluppo
“Couac – Visual Feedback & Client Reviews” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
Collaboratori
Traduci “Couac – Visual Feedback & Client Reviews” nella tua lingua.
Ti interessa lo sviluppo?
Esplora il codice segui il repository SVN, segui il log delle modifiche tramite RSS.
Changelog
0.3.1
- Automatic fix on update: a server address that pointed to your own domain (often entered as “white label”) is removed, so the widget loads from couac.app again. Administrators see a one-time notice.
- When Couac refuses a key, the settings page now says which fix applies: copy the key again (or check the project’s subscription), or add this site to the project’s allowed sites.
0.3.0
- New guided setup in three steps, opened right after activation.
- The key is checked as soon as it is pasted, with the project name and the site permission.
- The settings page shows one status based on real checks (widget script and key) instead of a green label that only checked the key format.
- A wrong server address in Advanced is now caught before saving, with a one-click fix and a pointer to white label settings in Couac.
- New installs start in private review (administrators and editors) instead of showing the widget to every visitor.
- Couac logo on the settings page.
0.2.0
- The settings page now confirms the saved key with Couac, shows the connected project name, and marks the widget as installed in the Couac dashboard without having to visit the site.
0.1.1
- Align the settings page title and heading with the menu label (“Couac Widget”).
0.1.0
- Initial release: key configuration, audience and page targeting, admin-area toggle, white-label custom domain.