RVG Form WA — Documentation v2.4.9

Overview

RVG Form WA is a WordPress plugin designed to capture leads via form submission, store data in the database, and optionally hand off to WhatsApp. It includes shortcode rendering, floating button overlay, REST API endpoints, and an admin dashboard for analytics and exports.

Main Features

Form submission with optional WhatsApp redirect or modal mode.
Server-side lead storage in wp_rvg_form_leads.
Admin pages: WA Form Leads, Shortcodes, and Analytics/Event Log.
REST endpoints for lead logging and interaction tracking.
Customizable Floating Button with color, label, position, and behavior options.

Installation

Upload rvg-form-wa-2.4.9.zip to Plugins → Add New → Upload Plugin.
Activate the plugin. It will automatically create the database table.
Ensure your permalinks are not set to “Plain” to enable REST routes.

Shortcode Example

Generated example (as seen in your admin panel):

[rvg_form key="sewa_timbangan" admin_wa="628123456789" display="modal" button_text="Open Sewa Timbangan Form Form" modal_width="640" modal_height="86" color_primary="#25D366" color_hover="#1ebe57"]

Available Attributes:

Attribute	Description
`key`	Form identifier (used for grouping leads).
`admin_wa`	WhatsApp number to receive messages.
`display`	Use `modal` or `inline`.
`button_text`	Button label (for modal only).
`modal_width`, `modal_height`	Modal dimensions (px/vh).
`color_primary`, `color_hover`	Primary and hover button colors (HEX).
`forms_src`	Optional CDN source for external form layout.

Admin Panel

WA Form Leads — list of captured submissions, exportable to CSV.
Shortcodes — generator UI to create embed-ready shortcode.
Analytics/Event Log — shows recorded interactions.

REST API

Namespace: rvgfw/v1

POST /wp-json/rvgfw/v1/log → Save form submission POST /wp-json/rvgfw/v1/event → Log interaction (e.g. open_modal, wa_click)

Database Table

Automatically created at activation:

wp_rvg_form_leads (id, created_at, form_key, page_id, ip_address, geo_city, geo_region, geo_country, user_agent, nama, email, telepon, pesan, meta)

created_at is stored in UTC for consistency.

Floating Button

The floating button (FAB) is rendered via RVGFW_Floating and can either open a modal form or redirect directly to WhatsApp, depending on settings.

Timezone

All timestamps are stored in UTC but can be displayed in your WordPress local timezone using:

$dt = (new DateTime($row->created_at, new DateTimeZone('UTC')))->setTimezone(wp_timezone());

Changelog v2.4.9

Improved submission flow (DB first, then WA handoff).
Better FAB fallback rendering (wp_body_open and wp_head hooks).
Refined admin export & shortcode generator.
Documentation now matches production version.

RVG Form WA v2.4.9