Docs

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

RequirementValue
WordPress5.8 or higher
PHP7.4 or higher
BuildersElementor, Gutenberg (block editor) and Divi Builder. None is required on its own.
  1. In WordPress go to Plugins, Add New and search for Rawnaq.
  2. Click Install Now, then Activate.
  3. Open Rawnaq, Dashboard to see which modules are enabled.
  4. 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

BuilderHow to add a module
ElementorOpen the Elementor editor, search for the module name in the widget panel and drag it onto the page. Settings appear in the left panel.
GutenbergClick the + inserter, search for the module name and insert the block. Settings appear in the block sidebar.
DiviOpen 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

SectionWhat you can set
Center CircleTitle, Subtitle, Center Icon, and a JSON Config Import/Export field to move a whole diagram between pages.
NodesTwo 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 & LayoutDiagram 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

SettingChoices
Layout Alignment FlowHorizontal (Top/Bottom Row), Vertical (Left/Right Column), Radial (360° Circular)
Connector Path GeometryOrthogonal Elbows, Organic Bezier Curves, Direct Straight Spokes
Card Shape StyleRectangle Box, Rounded Pill, Minimal Outline
Connector Line TypeSolid Line, Dashed Line, Dotted Line
Center Circle Ring StyleConic 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

SectionWhat you can set
Card ContentCard 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 FaceEnable Flip, Flip Trigger (Hover or Click / Tap), Back Title, Back Description, Back CTA Text and Back CTA Link.
Layout & MotionContent 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 & TypographyCard, 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

SectionWhat you can set
Timeline StepsEach 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.
QuerySet 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 & ThemeDesign 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 & ColorsLine, active line, gradient end, glow, bullet, card, glass and text colors, plus sizes and spacing.

Available choices

SettingChoices
Design SkinClassic Card, Glassmorphism, Minimal Editorial, Gradient Glow, Process / Roadmap
Node Indicator StyleStep Number, Icon Pointer, Pulse Dot (Minimal), Date / Year Pill
Connecting Line StyleSolid Line, Dual-Color Gradient, Dashed Blueprint
Layout ModeAlternating (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

SectionWhat you can set
Dock ItemsEach item has Name / Tooltip, Icon, Link, Badge and Icon Hover Color.
LayoutDock 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 VisibilityShow 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 EffectBackground, border, blur, radius, gap, padding, item size, badge colors, Enable Magnify and Max Scale.
WhatsApp Contact ModeTurn on Enable WhatsApp Mode to use the dock as a contact widget (see below).

Available choices

SettingChoices
Primary Floating ChannelWhatsApp Chat, Phone Call, FB Messenger
Off-hours BehaviorHide Dock Completely, Show with Offline Badge, Offline lead / email form, Redirect Clicks to URL
Desktop Chat ActionShow 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

SectionWhat you can set
LayoutLayout Mode, Direction, Node Shape, Connector Style, Zoom / Pan Controls and PNG / SVG Export.
NodesNodes 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 (%).
StyleAccent / Connector Highlight, Root Gradient From and To, Connector Color, plus avatar shape, size, spacing, background, border and shadow.

Available choices

SettingChoices
Layout ModeOrg (vertical tree), Process (flow + branches), Freeform (manual X/Y)
DirectionTop to bottom, Left to right, Right to left
Node ShapeRounded rectangle, Circle, Hexagon
Connector StyleCurved, 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

SectionWhat you can set
ProgressProgress Style, Bar Position, Progress based on (whole page, article area or a CSS selector), Progress CSS Selector and Show % in Ring.
Table of contentsTOC 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).
ExtrasHide 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.
StyleAccent Color, Active / Bar Color, Bar Thickness and Ring Size.

Available choices

SettingChoices
Progress StyleTop / Bottom bar, Circular ring, Bar + Ring, None
Progress based onWhole page, Article / content area, Custom CSS selector
TOC PositionSidebar sticky, Floating panel, Inline box, Hidden (progress only)
TOC SourceAuto-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_wpm filter.
  • 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

SectionWhat you can set
Grid LayoutTheme Preset, Layout Preset, Columns, Row Height, Column Gap, Row Gap, Scroll Reveal and Hover Effect.
CellsEach 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 contentTag / 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 cellsPost 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 typographyCell radius, padding, background, border, hairline borders, overlay opacity, title and subtitle colors and sizes, gradients, stat color and CTA button colors.

Available choices

SettingChoices
Theme PresetModern Elevated (default), Minimal Glassmorphism, Dark Obsidian / Cyber, Editorial Spotlight
Layout Preset1 large + 4 small, 2×2 equal (4 cols), 1 wide + stacked (3 cols), Custom columns
Hover EffectLift, Zoom media, Tint, None
Content TypeIcon + 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

SectionWhat you can set
Story & ChaptersTheme 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 & ColorsAccent Color, Card Background, Text Color, Border Radius and Pin Offset.

Available choices

SettingChoices
Theme PresetModern Cards (Elevated), Minimal Editorial (Clean), Spotlight Glow
Pinned Media SideLeft, Right
Media Aspect RatioPortrait (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

SectionWhat you can set
Layout & ThemeTheme Preset and Preset (a starter form).
FieldsAdd fields one by one. See the field types and settings below.
DeliveryWhere the submission goes and what the visitor sees afterwards.
StyleButton background and text, accent / focus color, label, input background, border and text colors, Input size, Full-width button and Input radius.

Available choices

SettingChoices
Theme PresetModern Elevated (default), Minimal Glassmorphism, Dark Obsidian / Cyber, Editorial Spotlight
Starter presetsQuick 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 typesText, Email, Phone, Textarea, Select, Checkbox, Date, Number, URL, Choice Cards (visual radio), Range Slider, Digital Signature, Hidden, Rating, File upload
Field widthFull (100%), Three quarters (75%), Two thirds (66%), Half (50%), One third (33%), Quarter (25%)
After submitShow thank-you message, Redirect to URL, Open WhatsApp (visitor)
CRM / ESPNone, Mailchimp, HubSpot
Mailchimp subscriber statusPending (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-Signature header.
  • 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

SectionWhat you can set
SourceProjects 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.
ProjectsEach 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 & filterLayout 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.
StyleTheme Preset, Accent Color, Card Background, Card Border, Text Color and Card Radius.

Available choices

SettingChoices
Layout modeBento (asymmetric), Uniform grid, Masonry
SortCustom order, Year (newest first), Sector A to Z
Card click actionOpen detail modal, Go to project link, Open modal (with link CTA)
Discuss this projectAuto (Smart Form, then Dock WhatsApp), Smart Form only, Floating Dock WhatsApp, Hide CTA
Theme PresetModern 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.

SettingUsed by
Default WhatsApp NumberSmart Form and Floating Dock when a module has no number of its own
Google reCAPTCHA v3 Site Key and Secret KeySmart Form spam protection
Mailchimp API keySmart Form CRM delivery to a Mailchimp audience
HubSpot Portal IDSmart Form CRM delivery to a HubSpot form
Webhook signing secretSigns 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

ProblemWhat to check
A module is not in my builderMake sure it is enabled in Rawnaq, Dashboard, Elements Manager. For Divi, use the Visual Builder.
The table of contents is emptyCheck Heading Levels and Content Container. Headings inside the module itself are excluded on purpose.
Progress bar sits under the admin barUpdate to the latest version. Admin-bar offsets are handled in version 1.4.0 and later.
Form says the security token expiredThis happens on long-cached pages. Rawnaq refreshes the token automatically and retries once. Clear page cache if it persists.
Form emails do not arriveUse the Test email button, check Send email to, and use an SMTP plugin if your host blocks PHP mail.
WhatsApp button opens the wrong numberEnter digits only with the country code and no plus sign. Check the agent number and the global default.
Animations feel too strongRawnaq 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.