Description
Rawnaq is a lightweight, speed-first modular library. It introduces highly interactive, beautiful, and customizable elements without bloating your WordPress site.
Key highlights:
* Zero jQuery Dependency: The frontend is powered by vanilla JavaScript for near-instant rendering.
* On-Demand Assets: CSS/JS files are only loaded on pages where the widgets/blocks actually exist.
* Modular Codebase: Fully ready for developers to extend with new components.
Included Modules
- Hub Diagram: Interactive Hub & Spoke workflow diagram (PNG/SVG export).
- 3D Tilt Card: Interactive tilt cards (kept ultra-light).
- Scroll Sync Timeline: CSS scroll-driven timeline with JS fallback.
- Floating Dock Menu: macOS dock + WhatsApp Contact Mode.
- Flow Chart: Org/process/freeform + WP Users org + PNG/SVG export.
- Scroll Progress + TOC: Reading progress + smart TOC.
- Bento Grid: Marketing bento with Elementor resize + Gutenberg InnerBlocks.
- Scroll Story Chapters: Scrollytelling with pinned media.
- Smart Form: Lead form with email + WhatsApp redirect, layouts, uploads, multi-step.
- Case-Study Grid: CPT/manual portfolio, multi-filter, gallery modal, link-out, load more.
External services
Rawnaq may call the following third-party services when you enable related features. No data is sent unless you configure the feature.
- Google reCAPTCHA v3 — Optional spam protection on Smart Form. Site/secret keys are set in plugin settings. Form tokens are verified via Google’s siteverify API. reCAPTCHA · Terms · Privacy Policy
- WhatsApp (wa.me) — Optional. Opens a WhatsApp chat URL with a prefilled message when Floating Dock or Smart Form WhatsApp delivery is enabled. WhatsApp · Terms · Privacy Policy
- Mailchimp — Optional. When Smart Form’s CRM delivery is set to Mailchimp, the submitted email address (and any mapped merge fields) is sent to Mailchimp’s API to subscribe the contact to the audience/list you configure. Requires your own Mailchimp API key. Mailchimp · Terms · Privacy Policy
- HubSpot — Optional. When Smart Form’s CRM delivery is set to HubSpot, the submitted form field values are sent to HubSpot’s Forms API using the portal ID and form GUID you configure. HubSpot · Terms · Privacy Policy
- Custom webhook / Slack incoming URL — Optional. Smart Form can POST submission JSON to a URL you provide (e.g. Slack Incoming Webhooks). Only the endpoint you configure is contacted.
Third-party libraries
- QRCode.js (davidshimjs) — MIT-compatible QR rendering for Floating Dock WhatsApp mode. Human-readable source:
assets/js/qrcode.js(also minified asqrcode.min.js). Upstream: https://github.com/davidshimjs/qrcodejs
Privacy
Rawnaq does not phone home. Any personal data stays in your WordPress site or goes only to services you explicitly configure.
- Smart Form submissions — When “Log submissions” is enabled, form entries (which may include name, email, phone, message, and uploaded files) are stored as private
rawnaq_sf_entryposts in your database. They are retained until you delete them under Rawnaq Form Submissions. - Data export / erase — Rawnaq registers exporter and eraser callbacks with WordPress core, so entries are included in Tools Export Personal Data and removed via Tools Erase Personal Data when requested by email.
- Delivery services — Email uses your site’s
wp_mail. Optional integrations only contact the endpoints you configure: WhatsApp (wa.me link in the visitor’s browser), Google reCAPTCHA (spam scoring), a webhook/Slack URL, or a CRM/ESP (Mailchimp / HubSpot) when you enable and configure it. - Floating Dock analytics — Optional click counts are stored locally in the
rawnaq_dock_clicksoption; no personal data is recorded.
Credits
Rawnaq is developed and maintained by itsmanzur. All code, design, and assets in this plugin are original work created specifically for Rawnaq.
Source code: https://github.com/itsmanzur/rawnaq
Blocks
This plugin provides 12 blocks.
- Hub Diagram (Rawnaq)
- 3D Tilt Card (Rawnaq)
- Scroll Sync Timeline (Rawnaq)
- Floating Dock Menu (Rawnaq)
- Flow Chart (Rawnaq)
- Scroll Progress + TOC (Rawnaq)
- Bento Cell (Rawnaq)
- Bento Grid (Rawnaq)
- Scroll Story Chapters (Rawnaq)
- Smart Form (Rawnaq)
- Case-Study Card
- Case-Study Grid (Rawnaq)
Installation
- Upload the entire
rawnaqfolder to the/wp-content/plugins/directory, or upload the ZIP file via WordPress Admin. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- Drop the widgets into Elementor or search for them in the Gutenberg block inserter.
FAQ
-
Does Rawnaq require Elementor?
-
No. Modules work with Elementor and/or Gutenberg. Enable only the modules you need in Rawnaq settings.
-
Does Smart Form send data to Rawnaq servers?
-
No. Email uses WordPress
wp_mail. Optional webhooks go only to the URL you configure. Optional reCAPTCHA talks to Google. WhatsApp opens wa.me in the visitor’s browser. -
Where is the QR code library source?
-
See
assets/js/qrcode.jsin the plugin (unminified). Minified build:assets/js/qrcode.min.js. -
How long are Smart Form submissions kept, and can users delete them?
-
Submissions saved by the optional “Log submissions” setting are stored as private entries in your own WordPress database and are kept until you delete them (Rawnaq Form Submissions). Rawnaq integrates with WordPress’ built-in Tools Export Personal Data and Tools Erase Personal Data, so a visitor’s stored entries can be exported or erased by email address.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Rawnaq” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Rawnaq” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial public release on WordPress.org.
- Modular Elementor + Gutenberg library: Hub Diagram, 3D Tilt Card, Scroll Sync Timeline, Floating Dock (WhatsApp mode), Flow Chart, Scroll Progress + TOC, Bento Grid, Scroll Story Chapters, Smart Form, Case-Study Grid.
- On-demand assets, vanilla JS frontend, Elements Manager, WPML config, and documented optional third-party services (Fonts, reCAPTCHA, WhatsApp, webhooks).
- Floating Dock: DST-aware IANA business timezones (legacy fixed UTC offsets still supported).
- Editor parity: Gutenberg now exposes Hub Diagram export toggle, Flow Chart zoom/pan toggle, Scroll Story pin offset, and Scroll Progress content-selector + hide-on-short-page controls to match Elementor.
- Accessibility: Case-Study modal focus trap, focus return, and aria-modal; arrow-key gallery navigation; Scroll Story progress dots support arrow/Home/End keys; safer link handling on Flow Chart nodes.
- Polish: corrected mis-encoded characters in Scroll Timeline presets and shared strings.
- 3D Tilt Card: optional flip / back-face with hover or click trigger, back title/description/CTA, and back styling.
- Flow Chart: per-node connector (edge) labels and swimlane bands, included in PNG/SVG export.
- Smart Form: branded HTML email receipts and CRM/ESP delivery — built-in Mailchimp subscribe plus a
rawnaq_smart_form_submissionhook for Zapier/HubSpot/custom. - Performance: every module’s CSS/JS now ships a minified
.minbuild alongside the readable source; production requests load the minified file automatically, falling back to the unminified source wheneverSCRIPT_DEBUGis enabled. - Privacy: Smart Form submissions are now wired into WordPress’s built-in Export/Erase Personal Data tools (
wp_privacy_personal_data_exporters/erasers). - Added a “Settings” quick link on the Plugins list page.
- Case-Study Grid: server-filtered AJAX pagination for the CPT source (sector/year/service + paging on the server).
- Scroll Story: rich-text chapters, per-chapter video, and #anchor deep-linking with active-chapter hash sync.
- SEO: JSON-LD schema pack — CreativeWork ItemList for CPT case studies, ItemList for query-based timelines, and auto Review/AggregateRating from Bento testimonial cells (all filterable).
- Smart Form: HubSpot CRM delivery (portal ID + per-form GUID) alongside Mailchimp and the generic hook.
- Flow Chart: true swimlanes in process mode — nodes are banded by lane on the cross axis.
- Case-Study: hardened AJAX pagination (server perPage aligned, no hidden-card conflict, empty-state message).
- Privacy: Smart Form entries now integrate with WordPress Export/Erase Personal Data tools; added a Privacy section to this readme.
- Admin: “Settings” link on the Plugins list row.