Everything you need to install, configure and get the most from Rawnaq. This guide follows the plugin’s own settings, so the names you read here are the names you will see in the editor.
Contents
- Getting started
- Adding a module
- Hub Diagram
- 3D Tilt Card
- Scroll Sync Timeline
- Floating Dock
- Flow Chart
- Scroll Progress + TOC
- Bento Grid
- Scroll Story
- Smart Form
- Case-Study Grid
- Global settings and API keys
- Troubleshooting
Getting started
| Requirement | Value |
|---|---|
| WordPress | 5.8 or higher |
| PHP | 7.4 or higher |
| Builders | Elementor, Gutenberg (block editor) and Divi Builder. None is required on its own. |
- In WordPress go to Plugins, Add New and search for Rawnaq.
- Click Install Now, then Activate.
- Open Rawnaq, Dashboard to see which modules are enabled.
- Edit a page in your builder and search for the module name.
Rawnaq loads each module’s CSS and JavaScript only on pages where that module is placed, and uses plain JavaScript with no jQuery on the frontend.
Turning modules on and off
Open Rawnaq, Dashboard and use the Elements Manager tab. Disabled modules are not registered and load nothing. If a module is missing from your builder, check it is enabled here.
Adding a module
| Builder | How to add a module |
|---|---|
| Elementor | Open the Elementor editor, search for the module name in the widget panel and drag it onto the page. Settings appear in the left panel. |
| Gutenberg | Click the + inserter, search for the module name and insert the block. Settings appear in the block sidebar. |
| Divi | Open the Divi Visual Builder, click + to add a module and search for the module name. |
Tip: Setting names in this guide follow the Elementor panel. Gutenberg and Divi expose the same options under matching names.
1. Hub Diagram
A radial or row/column workflow diagram with a central hub and connected cards. Visitors can export it as PNG or SVG.
Where to find it: Elementor: Hub Diagram. Gutenberg: block rawnaq/hub-diagram. Divi: Rawnaq Hub Diagram.
Settings
| Section | What you can set |
|---|---|
| Center Circle | Title, Subtitle, Center Icon, and a JSON Config Import/Export field to move a whole diagram between pages. |
| Nodes | Two node lists: Top Row / Left Col and Bottom Row / Right Col. Each node has Label, Description / Subtitle, Step / Badge Text, Accent Color, Card Background, Card Text Color, Icon, Redirect URL and Link Target (Same Window or New Tab). |
| Style & Layout | Diagram Height, Layout Alignment Flow, Connector Path Geometry, Card Shape Style, Connector Line Type, Animated Glow Flow Lines, Center Ripple Wave Pulse, Show Step Badges, PNG / SVG Export, Center Circle Ring Style and colors. |
Available choices
| Setting | Choices |
|---|---|
| Layout Alignment Flow | Horizontal (Top/Bottom Row), Vertical (Left/Right Column), Radial (360° Circular) |
| Connector Path Geometry | Orthogonal Elbows, Organic Bezier Curves, Direct Straight Spokes |
| Card Shape Style | Rectangle Box, Rounded Pill, Minimal Outline |
| Connector Line Type | Solid Line, Dashed Line, Dotted Line |
| Center Circle Ring Style | Conic Color Ring, Solid Flat Ring |
Tips
- Use the JSON Config Import/Export field to duplicate a diagram instead of rebuilding it.
- Turn on Show Step Badges for numbered processes.
2. 3D Tilt Card
A showcase card that tilts in perspective with the cursor, with light glare and an optional flip to a back face.
Where to find it: Elementor: 3D Tilt Card. Gutenberg: rawnaq/tilt-card. Divi: Rawnaq 3D Tilt Card.
Settings
| Section | What you can set |
|---|---|
| Card Content | Card Image (with Image Fit and Image Position), Badge / Eyebrow, Title, Description, Icon, CTA Button Text, CTA Link and Card Link (makes the whole card clickable). |
| Flip / Back Face | Enable Flip, Flip Trigger (Hover or Click / Tap), Back Title, Back Description, Back CTA Text and Back CTA Link. |
| Layout & Motion | Content Vertical Align (Top, Center, Bottom), Max Tilt Intensity, Hover Scale, Glare Intensity, Image Overlay Strength, Card Height, Border Radius, Spotlight Border Glow, Holographic Foil Sheen and Mobile Gyroscope 3D Motion. |
| Colors & Typography | Card, badge, title, description, icon, CTA button and back-face colors. |
Tips
- On touch devices use Click / Tap as the flip trigger.
- Keep Max Tilt Intensity modest (around 10 to 15) for text-heavy cards.
3. Scroll Sync Timeline
A vertical or horizontal timeline whose line and nodes fill in as the reader scrolls. Steps can be written by hand or pulled from posts.
Where to find it: Elementor: Scroll Sync Timeline. Gutenberg: rawnaq/scroll-timeline. Divi: Rawnaq Scroll Timeline.
Settings
| Section | What you can set |
|---|---|
| Timeline Steps | Each step has Date / Label, Step Title, Description, Status / Pill Tag, Icon, Video URL, Image, CTA Text and CTA Link. An Agency Preset fills in a ready-made timeline: Company Story, Changelog or Case Study Journey. |
| Query | Set Steps Source to *Posts / CPT query* to build steps from content: Post Type, Posts Per Page, Order By (Date, Title, Menu order, Modified, Random, ID), Order, Taxonomy, Term Slugs, Include IDs and Exclude IDs. |
| Layout & Theme | Design Skin, Node Indicator Style, Connecting Line Style, Layout Mode, Active Node Pulse Glow, Card Hover Elevation, Named Timeline ID, Show Step Numbers, Initial Visible Steps and Load More. |
| Style & Colors | Line, active line, gradient end, glow, bullet, card, glass and text colors, plus sizes and spacing. |
Available choices
| Setting | Choices |
|---|---|
| Design Skin | Classic Card, Glassmorphism, Minimal Editorial, Gradient Glow, Process / Roadmap |
| Node Indicator Style | Step Number, Icon Pointer, Pulse Dot (Minimal), Date / Year Pill |
| Connecting Line Style | Solid Line, Dual-Color Gradient, Dashed Blueprint |
| Layout Mode | Alternating (Left / Right), All Left, All Right, Horizontal |
Tips
- Give the timeline a Named Timeline ID to link it with Scroll Progress + TOC and the Bento Grid.
- For long histories use Initial Visible Steps with Load More.
4. Floating Dock
A macOS-style floating menu with proximity magnification, and an optional WhatsApp contact mode with agents, QR code and business hours.
Where to find it: Elementor: Floating Dock Menu. Gutenberg: rawnaq/floating-dock. Divi: Rawnaq Floating Dock.
Settings
| Section | What you can set |
|---|---|
| Dock Items | Each item has Name / Tooltip, Icon, Link, Badge and Icon Hover Color. |
| Layout | Dock Position, Edge Offset, Hide on Mobile, Show Labels on Mobile, Hide on Desktop and an Extra Bottom Offset so the dock clears cookie bars or banners. |
| Page Visibility | Show Dock On: Entire site, Only selected pages, or Everywhere except selected. Add Selected Pages / Posts, include the Front Page or WooCommerce Products, and toggle Track Clicks. |
| Dock Style and Magnify Effect | Background, border, blur, radius, gap, padding, item size, badge colors, Enable Magnify and Max Scale. |
| WhatsApp Contact Mode | Turn on Enable WhatsApp Mode to use the dock as a contact widget (see below). |
Available choices
| Setting | Choices |
|---|---|
| Primary Floating Channel | WhatsApp Chat, Phone Call, FB Messenger |
| Off-hours Behavior | Hide Dock Completely, Show with Offline Badge, Offline lead / email form, Redirect Clicks to URL |
| Desktop Chat Action | Show options (Web + QR), Open WhatsApp Web directly, QR first (Web still available) |
WhatsApp mode settings
- WhatsApp Agents: Agent / Department Name, Role Label, WhatsApp Number (digits with country code, no
+), Avatar Photo and a Prefilled Message. - Default Prefilled Message: supports tokens such as
{pageTitle}and{url}. - Secondary channels: Phone Number, Messenger user, Email address and Telegram user.
- Business hours: Business Timezone (IANA names such as
Asia/Dhaka, daylight-saving aware) and a Business Weekly Schedule. - Triggers: Trigger Delay (seconds), Trigger Scroll (%) and a Greeting Bubble Message.
Tips
- Set the schedule so visitors outside business hours see an offline badge or a lead form instead of a dead chat.
5. Flow Chart
Process trees, decision maps and organization charts with swimlanes, connector labels, zoom and pan, and PNG / SVG export.
Where to find it: Elementor: Flow Chart. Gutenberg: rawnaq/flow-chart. Divi: Rawnaq Flow Chart.
Settings
| Section | What you can set |
|---|---|
| Layout | Layout Mode, Direction, Node Shape, Connector Style, Zoom / Pan Controls and PNG / SVG Export. |
| Nodes | Nodes Source is *Manual nodes* or *WordPress users (org chart)* with Filter by Role and Max Users. Each manual node has Node ID, Parent Node, Title, Subtitle / Role, Connector Label, Swimlane, Icon, Image, Detail (popover), Link, Decision / Branch Node and, in Freeform mode, X and Y position (%). |
| Style | Accent / Connector Highlight, Root Gradient From and To, Connector Color, plus avatar shape, size, spacing, background, border and shadow. |
Available choices
| Setting | Choices |
|---|---|
| Layout Mode | Org (vertical tree), Process (flow + branches), Freeform (manual X/Y) |
| Direction | Top to bottom, Left to right, Right to left |
| Node Shape | Rounded rectangle, Circle, Hexagon |
| Connector Style | Curved, Elbow (90°), Straight, Dashed flow |
Tips
- Use Process mode with Decision / Branch Node for yes/no flows, and give the branches Connector Labels.
- Swimlane bands and connector labels are included in the exported PNG / SVG.
6. Scroll Progress + TOC
A reading progress indicator and an automatic table of contents with scroll-spy. The TOC is rendered on the server, so it does not shift the layout.
Where to find it: Elementor: Scroll Progress + TOC. Gutenberg: rawnaq/scroll-progress-toc. Divi: Rawnaq Scroll Progress & TOC.
Settings
| Section | What you can set |
|---|---|
| Progress | Progress Style, Bar Position, Progress based on (whole page, article area or a CSS selector), Progress CSS Selector and Show % in Ring. |
| Table of contents | TOC Position, TOC Title, TOC Source (auto-detect or manual entries), Heading Levels, Manual TOC Items, Collapse Sub-headings, Smooth Scroll, Scroll Offset and Content Container (CSS selector). |
| Extras | Hide on Short Pages, Show Reading Time, TOC Search Filter, Mobile FAB for TOC, Click Ring for Back to Top, Collapsible Header Accordion, Sync URL Hash on Scroll, Per-Section Time Badges and Sync Timeline ID. |
| Style | Accent Color, Active / Bar Color, Bar Thickness and Ring Size. |
Available choices
| Setting | Choices |
|---|---|
| Progress Style | Top / Bottom bar, Circular ring, Bar + Ring, None |
| Progress based on | Whole page, Article / content area, Custom CSS selector |
| TOC Position | Sidebar sticky, Floating panel, Inline box, Hidden (progress only) |
| TOC Source | Auto-detect headings, Manual entries |
Tips
- Only one page-level progress bar or ring is shown per page.
- Reading speed defaults to 200 words per minute. Developers can change it with the
rawnaq_spt_wpmfilter. - Headings in Bengali, Arabic and other scripts get clean, Unicode-safe anchors.
7. Bento Grid
Asymmetric, Apple-style card grids that combine features, stats, images, video, testimonials and posts. Four theme presets.
Where to find it: Elementor: Bento Grid. Gutenberg: blocks rawnaq/bento-grid and rawnaq/bento-cell. Divi: Rawnaq Bento Grid.
Settings
| Section | What you can set |
|---|---|
| Grid Layout | Theme Preset, Layout Preset, Columns, Row Height, Column Gap, Row Gap, Scroll Reveal and Hover Effect. |
| Cells | Each cell has a Content Type, Column Span, Row Span, Content Align, Order (Desktop), and Tablet (up to 900px) and Mobile (up to 640px) overrides for span and order. |
| Cell content | Tag / Eyebrow, Title, Subtitle, Icon, Image, Video URL, Stat Value with Prefix and Suffix, testimonial Author, Role and Star Rating, Cell Link, and a CTA button. |
| WordPress Post cells | Post Source (*Dynamic Latest Post* or *Specific Post*), Post Offset, Filter by Category, Display Style, Show Featured Image, Category as Badge, Post Date, Post Author, Excerpt Length and Read More text. |
| Surface and typography | Cell radius, padding, background, border, hairline borders, overlay opacity, title and subtitle colors and sizes, gradients, stat color and CTA button colors. |
Available choices
| Setting | Choices |
|---|---|
| Theme Preset | Modern Elevated (default), Minimal Glassmorphism, Dark Obsidian / Cyber, Editorial Spotlight |
| Layout Preset | 1 large + 4 small, 2×2 equal (4 cols), 1 wide + stacked (3 cols), Custom columns |
| Hover Effect | Lift, Zoom media, Tint, None |
| Content Type | Icon + Text, Featured (accent), Image, Stat Counter, Video, Testimonial, WordPress Post |
Tips
- Start from a Layout Preset, then adjust spans per cell.
- Use the tablet and mobile overrides to stop large cells from crowding small screens.
8. Scroll Story
Scrollytelling: a sticky media panel stays in view while narrative chapters scroll beside it and change the media.
Where to find it: Elementor: Scroll Story Chapters. Gutenberg: rawnaq/scroll-story. Divi: Rawnaq Scroll Storytelling.
Settings
| Section | What you can set |
|---|---|
| Story & Chapters | Theme Preset, Pinned Media Side, Media Aspect Ratio, Show Progress Counter and Show Progress Bar. Each chapter has Kicker Tag / Phase, Title, Body, Pinned Image, Pinned Video (MP4), Anchor / Deep-link ID, Media Caption, CTA Text and CTA Link, and can sync with a Case Study project. |
| Style & Colors | Accent Color, Card Background, Text Color, Border Radius and Pin Offset. |
Available choices
| Setting | Choices |
|---|---|
| Theme Preset | Modern Cards (Elevated), Minimal Editorial (Clean), Spotlight Glow |
| Pinned Media Side | Left, Right |
| Media Aspect Ratio | Portrait (4:5), Landscape (16:10), Square (1:1) |
Tips
- Set Pin Offset to the height of your sticky header so the media is not hidden under it.
- Use Anchor / Deep-link ID to link straight to a chapter.
9. Smart Form
Single or multi-step lead forms with conditional logic, file upload, signature, price estimation, and delivery by email, WhatsApp, webhook, Mailchimp or HubSpot.
Where to find it: Elementor: Smart Form. Gutenberg: rawnaq/smart-form. Divi: Rawnaq Smart Form.
Settings
| Section | What you can set |
|---|---|
| Layout & Theme | Theme Preset and Preset (a starter form). |
| Fields | Add fields one by one. See the field types and settings below. |
| Delivery | Where the submission goes and what the visitor sees afterwards. |
| Style | Button background and text, accent / focus color, label, input background, border and text colors, Input size, Full-width button and Input radius. |
Available choices
| Setting | Choices |
|---|---|
| Theme Preset | Modern Elevated (default), Minimal Glassmorphism, Dark Obsidian / Cyber, Editorial Spotlight |
| Starter presets | Quick Contact; Compact Lead (hero / landing); B2B Request for Proposal / Quote (with file upload); Multi-Step Project Discovery Planner (3 steps); Customer Feedback & Star Rating; Job Application & Career Inquiry (with resume upload) |
| Field types | Text, Email, Phone, Textarea, Select, Checkbox, Date, Number, URL, Choice Cards (visual radio), Range Slider, Digital Signature, Hidden, Rating, File upload |
| Field width | Full (100%), Three quarters (75%), Two thirds (66%), Half (50%), One third (33%), Quarter (25%) |
| After submit | Show thank-you message, Redirect to URL, Open WhatsApp (visitor) |
| CRM / ESP | None, Mailchimp, HubSpot |
| Mailchimp subscriber status | Pending (double opt-in), Subscribed (single opt-in) |
Field settings
- Basics: Field ID, Type, Label, Placeholder, Help text, Required, Field width, Default / hidden value.
- Choices: Options for Select, Checkbox and Choice Cards.
- Multi-step: set Step (multi-step) on each field to split the form into steps. The progress list announces steps to screen readers.
- Conditional logic: Show if field ID with Equals value.
- Range Slider: Min value, Max value, Step, Value prefix (for example
$) and Value suffix (for example/mo). - Phone: Country flag & code picker, Minimum and Maximum phone digits.
- File upload: Max file size (MB) and Accepted types.
- Rating: Max rating, with arrow-key support.
- Newsletter opt-in (Mailchimp): a checkbox that controls whether the address is sent to Mailchimp.
Delivery settings
- Email: Send email to, Email subject, Branded HTML email.
- Confirmation email to the visitor: subject, message and From Name. Tokens:
{name},{first_name},{last_name},{email},{site_title}. - WhatsApp: WhatsApp number and message template. Tokens include
{name},{phone},{email},{message},{pageTitle}and{url}. - Messages: Submit button text, Success message, Error message, Consent checkbox and Consent text.
- Extras: Log submissions in WP admin, Confetti Celebration Effect, Allow URL Prefill, Price Estimator with Estimator Label and Currency Symbol.
- Spam protection: reCAPTCHA v3 toggle (keys are in the global settings).
- Webhook / Slack notify: Webhook URL. Requests are signed with an
X-Rawnaq-Signatureheader. - CRM: Mailchimp Audience ID and subscriber status, or HubSpot Form GUID.
Security built in
- Signed HMAC timestamp tokens (valid 7 days) to block replay and bot floods on cached pages.
- Rate limits: 5 submissions per 10 minutes per form and 30 per hour site-wide, plus a 60-second duplicate guard.
- Uploads go to a protected, non-executable folder with random file names. SVG, HTML, PHP and other executable types are always blocked.
- Signatures are validated and saved as PNG files, not raw base64 text.
- Outgoing webhooks are signed and protected against private-IP (SSRF) targets.
Viewing and exporting submissions
- Go to Rawnaq, Form Submissions to filter by form, read status and date, search field values and open a submission to see fields, files and signatures, delivery log, UTM attribution and the consent record.
- Export a filtered list to CSV. Spreadsheet formula injection is sanitized.
- WordPress Tools, Export Personal Data and Erase Personal Data include submissions by email address.
Tips
- Start from a Preset and edit it, instead of building every field by hand.
- Use the Test email and Test webhook buttons in Global Integrations after you enter credentials.
- WhatsApp numbers: digits only, with country code, no plus sign.
10. Case-Study Grid
A filterable portfolio of projects with a detail modal, sector / year / service filters, NDA-safe fields and a link into your quote or WhatsApp flow.
Where to find it: Elementor: Case-Study Grid. Gutenberg: blocks rawnaq/case-study-grid and rawnaq/case-study-card. Divi: Rawnaq Case Study Grid. Projects can also live in Rawnaq, Case Studies (with Sectors).
Settings
| Section | What you can set |
|---|---|
| Source | Projects source: *Manual list (repeater)* or *Case Study posts (query)* with Number of posts, Order by (Date, Title, Menu order, Last modified, Random), Order and an optional Sector slug. |
| Projects | Each project has Cover image, Gallery images, Project link, Title, Sector / category, Size / scope, Budget range, Year completed, Client, Services (comma-separated), Card excerpt, Detail (modal text), Featured (larger in the bento layout) and Bento column / row span. Project ID or slug can be synced with other modules. |
| Layout & filter | Layout mode, Columns, Sector / Year / Service filter bars, Sort, NDA: hide budget, NDA: hide client, Card click action, Discuss this project, Initially visible cards and Load more chunk size. |
| Style | Theme Preset, Accent Color, Card Background, Card Border, Text Color and Card Radius. |
Available choices
| Setting | Choices |
|---|---|
| Layout mode | Bento (asymmetric), Uniform grid, Masonry |
| Sort | Custom order, Year (newest first), Sector A to Z |
| Card click action | Open detail modal, Go to project link, Open modal (with link CTA) |
| Discuss this project | Auto (Smart Form, then Dock WhatsApp), Smart Form only, Floating Dock WhatsApp, Hide CTA |
| Theme Preset | Modern Elevated (default), Minimal Glassmorphism, Editorial Spotlight |
Tips
- The detail modal is keyboard accessible: it traps focus, returns focus on close and supports arrow keys in the gallery.
- Use the NDA switches for projects where budget or client name must stay private.
Global settings and API keys
Site-wide credentials are kept in one place: Rawnaq, Dashboard, then Global Integrations & API Keys.
| Setting | Used by |
|---|---|
| Default WhatsApp Number | Smart Form and Floating Dock when a module has no number of its own |
| Google reCAPTCHA v3 Site Key and Secret Key | Smart Form spam protection |
| Mailchimp API key | Smart Form CRM delivery to a Mailchimp audience |
| HubSpot Portal ID | Smart Form CRM delivery to a HubSpot form |
| Webhook signing secret | Signs outgoing Smart Form webhooks (X-Rawnaq-Signature) |
Secrets are masked after saving. Use Change to replace one. Buttons on the same screen let you send a test email, test the webhook and test Mailchimp.
External services
No data is sent anywhere unless you enable a feature. Optional services are Google reCAPTCHA v3, WhatsApp (wa.me links), Mailchimp, HubSpot and a webhook or Slack URL that you provide. Form submissions never go to Rawnaq servers.
Troubleshooting
| Problem | What to check |
|---|---|
| A module is not in my builder | Make sure it is enabled in Rawnaq, Dashboard, Elements Manager. For Divi, use the Visual Builder. |
| The table of contents is empty | Check Heading Levels and Content Container. Headings inside the module itself are excluded on purpose. |
| Progress bar sits under the admin bar | Update to the latest version. Admin-bar offsets are handled in version 1.4.0 and later. |
| Form says the security token expired | This happens on long-cached pages. Rawnaq refreshes the token automatically and retries once. Clear page cache if it persists. |
| Form emails do not arrive | Use the Test email button, check Send email to, and use an SMTP plugin if your host blocks PHP mail. |
| WhatsApp button opens the wrong number | Enter digits only with the country code and no plus sign. Check the agent number and the global default. |
| Animations feel too strong | Rawnaq respects the visitor’s reduced motion setting. Lower tilt, glare and scale values in the module. |
Still stuck? See Support for the support forum and issue tracker, and the Changelog for recent fixes.