Àpèjúwe
The Clixx CRM plugin connects your WordPress site to your Clixx CRM account so you can insert lead capture forms from your campaigns into any page or post using:
- Shortcode:
[clixxcrm_formulario hash="..."] - Gutenberg block: “Clixx CRM Form”
- Standalone HTML embed snippet (with built-in style customizer)
The connection is established by entering the email of your Clixx CRM account and the API token generated inside the CRM. The token is validated server-side against the company associated with it; if the email does not belong to that company, or the company does not have an active subscription, the connection is refused.
Submissions are sent directly from the visitorÌtumọ̀ Yorùbá: ’s browser to your Clixx CRM. The plugin does not store any visitor data on your WordPress site.
External services
This plugin connects to the Clixx CRM SaaS (https://app.clixx.com.br), which is the service the plugin exists to integrate with. The connection happens in three situations:
-
Connecting your account (admin only). When you submit your email and API token on the “Clixx CRM > Connection” screen, the plugin sends a POST request from your server to
https://app.clixx.com.br/api/auth/verifycontaining your email and the API token. This is required to validate the token, identify your company in the CRM and confirm the subscription is active. -
Listing your forms (admin only). When you open the “Clixx CRM > Forms” screen, the plugin sends a GET request from your server to
https://app.clixx.com.br/api/anunciosusing your API token. The response (list of your campaigns / forms) is cached for 5 minutes in a WordPress transient. No visitor data is involved. -
Form submissions from visitors (front-end). The shortcode
[clixxcrm_formulario]renders an iframe pointing tohttps://app.clixx.com.br/inscricao/{hash}, and the standalone “Embed HTML” snippet contains JavaScript that, on submit, sends the visitor-typed form fields (name, e-mail, phone, plus any custom fields you configured in the CRM, and any UTM parameters present in the URL) viafetch()directly from the visitorÌtumọ̀ Yorùbá: ’s browser tohttps://app.clixx.com.br/api/webhook/inscricao/{hash}. The plugin does NOT store this data on your WordPress site.
The service is provided by Clixx CRM. See its terms of use at https://app.clixx.com.br/terms-of-use.html and its privacy policy at https://app.clixx.com.br/privacy-policy.html.
Àwọn ìdí
Plugin yìí pèsè 1 ìdí.
- Formulário Clixx CRM Insere um formulário de anúncio do Clixx CRM nesta página.
Ìgbéwọlẹ̀
- Upload the
clixxcrmfolder to/wp-content/plugins/, or install the plugin through the WordPress plugins screen. - Activate the plugin from the Plugins screen.
- Go to “Clixx CRM” in the admin menu and enter your email and API token.
- After connecting, open “Clixx CRM > Forms” to copy the shortcode, iframe code or standalone HTML embed of each form.
FAQ
-
Where do I get the API token?
-
Inside Clixx CRM, go to Settings > API and generate a token.
-
Does the plugin store visitor data on my WordPress database?
-
No. Form submissions are sent directly from the visitorÌtumọ̀ Yorùbá: ’s browser to your Clixx CRM via the public webhook endpoint.
-
Can I customize the look of the embedded form?
-
Yes. The “Embed HTML” tab in each form has a built-in customizer with controls for button text, colors, spacing and typography, plus a live preview. The generated HTML is fully self-contained and can be pasted into any site (WordPress or not).
-
Is the plugin compatible with the block editor?
-
Yes. The “Clixx CRM Form” block lets you pick a form from a dropdown and adjust the iframe height in the inspector panel.
Àwọn àgbéyẹ̀wò
Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.
Àwọn Olùkópa & Olùgbéejáde
“Clixx CRM Ìtumọ̀ Yorùbá: – Formulários para Captação de Leads” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.
Àwọn OlùkópaTúmọ̀ “Clixx CRM Ìtumọ̀ Yorùbá: – Formulários para Captação de Leads” sí èdè rẹ.
Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?
Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.
Àkọsílẹ̀ àwọn àyípadà
1.5.1
- Plugin review compliance: (1) the admin menu icon CSS is no longer injected via
admin_head— it is now registered viawp_register_style/wp_enqueue_styleandwp_add_inline_style, attached to a dedicatedclixxcrm-menu-iconhandle that loads on every admin page; (2) added== External services ==section to the readme documenting the connection toapp.clixx.com.br(/api/auth/verify,/api/anuncios,/api/webhook/inscricao/{hash}), what data is sent and when, plus links to the Clixx CRM Terms of Use and Privacy Policy; (3) the inline<style>/<script>tags inside the standalone Embed HTML snippet (which is meant to be COPY-PASTED into any external page, not enqueued by WordPress) are now assembled via concatenation and explicitly commented so they are not mistaken for WordPress front-end output.
1.5.0
- Bug fix: o customizador JS (admin/js/admin.js) ignorava os campos personalizados e regenerava o embed só com nome/email/celular, sobrescrevendo o HTML gerado pelo PHP. Agora o JS lê os campos via
data-campos-extrasno container e injeta os campos extras no preview ao vivo e no código copiado. Cores/sliders preservam os campos.
1.4.9
- Nome do plugin renomeado para “Clixx CRM Ìtumọ̀ Yorùbá: – Formulários para Captação de Leads” (mais descritivo no diretório do WordPress.org). Menu interno e marca seguem como “Clixx CRM”.
1.4.8
- Embed HTML do anúncio agora inclui os campos personalizados configurados no CRM (Cidade, Data de Nascimento, etc.). Suporta tipos: text, email, phone, cpf, cnpj, cep, number, date, textarea, select e checkbox. Requer CRM atualizado para retornar
campos_personalizadosem/api/anuncios(já incluso). Limpe o cache do plugin (transientclixxcrm_anuncios) para puxar os campos novos.
1.4.7
- Text domain renamed from
clixxcrmtoclixx-crmto match the plugin slug on WordPress.org. All__(),_e(),esc_html__(),esc_attr_e(), etc. calls and theText Domain:header + block.jsontextdomainwere updated. Internal slugs (menu URL, option keys, postMessage protocol) kept asclixxcrm.
1.4.6
- Removed
Plugin URIfrom the plugin header (it pointed to the same URL asAuthor URI, which the WordPress.org submission validator rejects). Once the plugin is published, the canonical plugin page iswordpress.org/plugins/clixxcrm/.
1.4.5
- Cleaned up the diagnostic instrumentation from 1.4.3/1.4.4: yellow debug bar removed from the live preview, console marker on script load removed, try/catch wrapper around
renderPreviewremoved. The cache-busting fix from 1.4.4 stays.
1.4.4
- Fixed a bug in the build script where the
CLIXXCRM_VERSIONPHP constant was never being updated past1.0.0because of a too-strict regex (it required')with no whitespace between, but the source file had' )). Result: every release since 1.0.1 was shipped with the constant stuck at 1.0.0, which causedwp_enqueue_script(..., CLIXXCRM_VERSION)to always emit?ver=1.0.0, so browsers reused the cachedadmin.jsfrom the very first install. All previous “preview not updating” reports were caused by browsers serving the old admin.js.
1.4.3
- Added a visible build marker in the live preview (yellow bar with render counter and timestamp) and a console.log on script load. This is purely diagnostic for users who report the preview not updating — if the bar is missing, the browser/WordPress is serving a cached old
admin.js. - Wrapped
renderPreviewin try/catch withconsole.errorto surface any silent failures.
1.4.2
- Live preview rebuilt with a third strategy: each preview container gets a unique ID, and every
.clx2-formselector in the embed CSS is rewritten to#unique-id .clx2-formbefore being injected. This gives the embed rules a specificity of(1,2,1)+, beating any WordPress admin rule. No iframe, no Shadow DOM, no CSP edge cases — just plain DOM with rewritten selectors.
1.4.1
- Live preview rebuilt on top of Shadow DOM. The previous iframe srcdoc approach failed silently in some hosting / CSP setups; Shadow DOM is native browser CSS isolation with no iframe and no timing dependency, so the preview now updates instantly when colors, sliders or font are changed.
1.4.0
- Plugin Check / WordPress.org compliance pass: readme rewritten in English, “Tested up to” bumped to 6.9, output escaping audited (
esc_attron every echo),$_POSTinputs run through sanitization helpers, view variables prefixed withclixxcrm_, heredoc strings replaced with concatenation,load_plugin_textdomain()removed (auto-loaded by core since 4.6). - Preview now uses
iframe.srcdocinstead ofdocument.write()for reliability across security plugins / CSP setups.
1.3.2
- Preview rendered inside an
<iframe>to isolate the embedded form from WordPress admin global CSS rules. Without isolation, admin rules oninput,form,buttonwere overriding the embedÌtumọ̀ Yorùbá: ’s own styles, so only text changes were visible. - Sidebar menu icon now loads as URL (not data URI) so the original Clixx logo colors are preserved instead of WordPress applying its default
opacity: 0.6overlay.
1.3.1
- Live preview event listeners moved to document-level delegation. They are now reliable even when the customizer markup is inside collapsed panels or inactive tabs.
- Automatic re-render when expanding the codes panel or switching to the Embed HTML tab.
1.3.0
- Embed HTML tab gained a full visual customizer (button text, colors, spacing, typography) with live preview and auto-generated code, identical to the one available inside the CRM.
- Tab labels rendered with
mb_strtoupperso accented characters such asÃ/Áare uppercased correctly.
1.2.0
- Full visual rewrite: header with logo, pill-style tabs (Connection / Forms / About) and a clean content card with rows.
- Fixed CSS parsing bug from 1.1.0 caused by an inline SVG data URI in a CSS rule.
- New About tab with version, license and feature summary.
1.1.0
- Modern indigo palette across the connect and forms screens.
- Sidebar menu icon uses the official Clixx logo.
- Forms screen lists each campaign with Shortcode, Iframe and Embed HTML tabs and a copy button.
1.0.1
- The Clixx CRM URL is fixed to
https://app.clixx.com.br. Override at development time viadefine('CLIXXCRM_API_URL', '...')inwp-config.php.
1.0.0
- Initial release: connection by email + API token,
[clixxcrm_formulario]shortcode and Gutenberg block.



