{"id":360882,"date":"2026-09-14T06:23:48","date_gmt":"2026-09-14T06:23:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/submitrelay\/"},"modified":"2026-09-14T07:09:43","modified_gmt":"2026-09-14T07:09:43","slug":"submitrelay","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/submitrelay\/","author":23344176,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.6","stable_tag":"1.1.6","tested":"7.1","requires":"5.0","requires_php":"7.2","requires_plugins":null,"header_name":"SubmitRelay","header_author":"Muzaffer Ahmad Pakhtoon","header_description":"Floating pop-up and shortcode contact form for WordPress. Sends email notifications, stores form submissions, and optionally redirects users to WhatsApp. IP address storage is opt-in.","assets_banners_color":"c5dbfa","last_updated":"2026-09-14 07:09:43","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/wp.apharwat.net\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":41,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.6":{"tag":"1.1.6","author":"muzaffarpakhtoon","date":"2026-09-14 07:09:43","revision":3694634}},"upgrade_notice":{"1.1.6":"<p>Updated floating button positioning with a simpler Bottom Offset control from 0\u2013200 pixels.<\/p>","1.0.9":"<p>Removed arbitrary custom CSS input while keeping the built-in design and color controls.<\/p>","1.0.8":"<p>Improved WordPress.org compatibility and naming isolation while preserving the existing popup, standalone form, email, SMTP, GDPR, scheduling, submissions, and optional WhatsApp behavior.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3694551,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3694551,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3694551,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3694551,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.6"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3694551,"resolution":"1","location":"assets","locale":"","width":1910,"height":2826},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3694551,"resolution":"10","location":"assets","locale":"","width":1910,"height":1492},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3694551,"resolution":"11","location":"assets","locale":"","width":1910,"height":1168},"screenshot-12.png":{"filename":"screenshot-12.png","revision":3694551,"resolution":"12","location":"assets","locale":"","width":1910,"height":943},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3694551,"resolution":"2","location":"assets","locale":"","width":1910,"height":3831},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3694551,"resolution":"3","location":"assets","locale":"","width":1910,"height":1597},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3694551,"resolution":"4","location":"assets","locale":"","width":1910,"height":1012},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3694551,"resolution":"5","location":"assets","locale":"","width":1910,"height":1282},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3694551,"resolution":"6","location":"assets","locale":"","width":1910,"height":995},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3694551,"resolution":"7","location":"assets","locale":"","width":1910,"height":1057},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3694551,"resolution":"8","location":"assets","locale":"","width":1910,"height":1035},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3694551,"resolution":"9","location":"assets","locale":"","width":1910,"height":943}},"screenshots":{"1":"SubmitRelay floating popup contact form.","2":"SubmitRelay form and floating button settings.","3":"SubmitRelay WhatsApp message template settings.","4":"SubmitRelay saved submissions management.","5":"SubmitRelay email and SMTP settings."}},"plugin_section":[],"plugin_tags":[358,267,491,80,3160],"plugin_category":[41,43],"plugin_contributors":[280587],"plugin_business_model":[],"class_list":["post-360882","plugin","type-plugin","status-publish","hentry","plugin_tags-contact-form","plugin_tags-email","plugin_tags-popup","plugin_tags-shortcode","plugin_tags-whatsapp","plugin_category-communication","plugin_category-customization","plugin_contributors-muzaffarpakhtoon","plugin_committers-muzaffarpakhtoon"],"banners":{"banner":"https:\/\/ps.w.org\/submitrelay\/assets\/banner-772x250.png?rev=3694551","banner_2x":"https:\/\/ps.w.org\/submitrelay\/assets\/banner-1544x500.png?rev=3694551","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/submitrelay\/assets\/icon-128x128.png?rev=3694551","icon_2x":"https:\/\/ps.w.org\/submitrelay\/assets\/icon-256x256.png?rev=3694551","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-1.png?rev=3694551","caption":"SubmitRelay floating popup contact form."},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-2.png?rev=3694551","caption":"SubmitRelay form and floating button settings."},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-3.png?rev=3694551","caption":"SubmitRelay WhatsApp message template settings."},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-4.png?rev=3694551","caption":"SubmitRelay saved submissions management."},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-5.png?rev=3694551","caption":"SubmitRelay email and SMTP settings."},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-6.png?rev=3694551","caption":""},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-7.png?rev=3694551","caption":""},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-8.png?rev=3694551","caption":""},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-9.png?rev=3694551","caption":""},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-10.png?rev=3694551","caption":""},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-11.png?rev=3694551","caption":""},{"src":"https:\/\/ps.w.org\/submitrelay\/assets\/screenshot-12.png?rev=3694551","caption":""}],"raw_content":"<!--section=description-->\n<p><strong>SubmitRelay<\/strong> is a WordPress contact form plugin for collecting customer enquiries, saving submissions in WordPress, sending email notifications, and optionally continuing conversations through WhatsApp.<\/p>\n\n<p>Create a contact form that works as a <strong>floating popup<\/strong> or as a standalone form using the <code>[submitrelay_form]<\/code> shortcode.<\/p>\n\n<p>SubmitRelay is useful for hotels, houseboats, travel businesses, tours, booking enquiries, local services, agencies, freelancers, support requests, quotation forms, and small businesses.<\/p>\n\n<h3>Contact Form + WhatsApp<\/h3>\n\n<p>Connect your WordPress contact form with WhatsApp using a customizable message template.<\/p>\n\n<p>After a successful form submission, SubmitRelay can open WhatsApp with a <strong>pre-filled message containing information submitted by the visitor<\/strong>.<\/p>\n\n<p>Use built-in placeholders such as:<\/p>\n\n<ul>\n<li><code>{name}<\/code> \u2014 Customer name<\/li>\n<li><code>{email}<\/code> \u2014 Customer email<\/li>\n<li><code>{phone}<\/code> \u2014 Customer phone number<\/li>\n<li><code>{message}<\/code> \u2014 Customer message<\/li>\n<li><code>{page_url}<\/code> \u2014 Page where the form was submitted<\/li>\n<li><code>{site_title}<\/code> \u2014 Website title<\/li>\n<li><code>{site_url}<\/code> \u2014 Website URL<\/li>\n<\/ul>\n\n<p>Custom form fields can also be used as WhatsApp placeholders. For example, if a custom field has the ID <code>travel_date<\/code>, you can use <code>{travel_date}<\/code> in the WhatsApp message template.<\/p>\n\n<p>This lets site owners create messages tailored to their business, such as booking dates, guest details, travel requirements, service requests, or other custom enquiry information.<\/p>\n\n<h3>Save Customer Enquiries<\/h3>\n\n<p>SubmitRelay can save form submissions directly inside WordPress.<\/p>\n\n<p>Administrators can view, search, export, and delete saved submissions. Stored information can include:<\/p>\n\n<ul>\n<li>Name<\/li>\n<li>Email<\/li>\n<li>Phone number<\/li>\n<li>Message<\/li>\n<li>Custom form fields<\/li>\n<li>Submission date and time<\/li>\n<li>IP address when IP storage is explicitly enabled<\/li>\n<\/ul>\n\n<h3>Email Notifications and SMTP<\/h3>\n\n<p>SubmitRelay sends email notifications using WordPress <code>wp_mail()<\/code> by default.<\/p>\n\n<p>For websites that require SMTP delivery, SubmitRelay also provides optional SMTP configuration using WordPress's bundled PHPMailer.<\/p>\n\n<h3>Floating Popup or Shortcode Form<\/h3>\n\n<p>Display your form as:<\/p>\n\n<ul>\n<li>A floating popup<\/li>\n<li>A standalone form using <code>[submitrelay_form]<\/code><\/li>\n<\/ul>\n\n<p>The shortcode can be used on pages, posts, widgets, and supported theme template locations.<\/p>\n\n<h3>Key Features<\/h3>\n\n<ul>\n<li>Floating popup contact form with configurable position, animation, visibility, and schedule.<\/li>\n<li>Standalone <code>[submitrelay_form]<\/code> shortcode.<\/li>\n<li>Configurable Name, Email, Phone\/WhatsApp, Message, and custom fields.<\/li>\n<li>Customizable pre-filled WhatsApp message templates.<\/li>\n<li>Built-in placeholders for submitted form information.<\/li>\n<li>Custom form field placeholders for WhatsApp messages.<\/li>\n<li>Email notifications through WordPress <code>wp_mail()<\/code>.<\/li>\n<li>Optional SMTP configuration.<\/li>\n<li>Optional WhatsApp redirect after successful submission.<\/li>\n<li>Submission storage inside WordPress.<\/li>\n<li>Administrator screen for viewing, searching, exporting, and deleting submissions.<\/li>\n<li>WordPress personal-data exporter and eraser integration.<\/li>\n<li>Optional GDPR consent checkbox and configurable privacy-policy URL.<\/li>\n<li>IP address storage disabled by default.<\/li>\n<li>Settings export\/import with SMTP passwords excluded from exports.<\/li>\n<li>Basic anti-spam honeypot and short-term request rate limiting.<\/li>\n<li>Unified Floating Button appearance controls.<\/li>\n<li>No advertising, analytics, telemetry, or remote tracking.<\/li>\n<\/ul>\n\n<h3>Why SubmitRelay?<\/h3>\n\n<p>SubmitRelay combines several common customer-contact requirements in one WordPress plugin:<\/p>\n\n<p><strong>Contact Form \u2192 Save Enquiry \u2192 Email Notification \u2192 Pre-filled WhatsApp<\/strong><\/p>\n\n<p>Instead of relying on separate tools for every part of the enquiry process, site owners can collect customer information, keep a record of submissions, receive email notifications, and optionally start a WhatsApp conversation using a prepared message.<\/p>\n\n<h3>Live Demo<\/h3>\n\n<p>See SubmitRelay in action on a live travel and booking website:<\/p>\n\n<p>https:\/\/www.houseboatsinsrinagar.com\/<\/p>\n\n<p>The live site demonstrates SubmitRelay in a real travel and booking environment.<\/p>\n\n<h3>Privacy and Data Collection<\/h3>\n\n<p>When a visitor submits the form, SubmitRelay can store the form fields configured by the site administrator, including name, email, phone number, message, custom fields, and submission date\/time.<\/p>\n\n<p>IP address storage is an administrator-controlled option and is disabled by default. When enabled, the visitor IP address is stored with the submission and may also appear in notification emails and CSV exports.<\/p>\n\n<p>The plugin provides WordPress privacy exporter and eraser integrations for stored submissions associated with an email address.<\/p>\n\n<p>Site administrators are responsible for configuring the plugin in accordance with their applicable privacy, data-protection, retention, and consent requirements. Enabling the GDPR checkbox does not by itself make a site compliant with any particular law.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>SubmitRelay can optionally interact with the following external services, only when the corresponding feature is used or configured:<\/p>\n\n<ul>\n<li>WhatsApp: when WhatsApp redirect is enabled, the browser is redirected to a <code>wa.me<\/code> URL containing the configured WhatsApp number and the generated message content based on the site's configured message template. WhatsApp's own terms and privacy practices apply.<\/li>\n<li>SMTP provider: when SMTP is enabled, email content and recipient information are sent through the SMTP server configured by the site administrator. The provider's terms and privacy practices apply.<\/li>\n<\/ul>\n\n<p>The plugin does not make background tracking or telemetry requests to these services.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>submitrelay<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install the plugin ZIP from <strong>Plugins &gt; Add New Plugin &gt; Upload Plugin<\/strong>.<\/li>\n<li>Activate <strong>SubmitRelay<\/strong> from the Plugins screen.<\/li>\n<li>Open the SubmitRelay settings page and configure the form, popup, email, privacy, and optional WhatsApp\/SMTP settings.<\/li>\n<li>The floating popup can be enabled from the plugin settings.<\/li>\n<li>To display a standalone form, add <code>[submitrelay_form]<\/code> to a page, post, widget, or supported template location.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20submitrelay%20require%20an%20external%20service%3F\"><h3>Does SubmitRelay require an external service?<\/h3><\/dt>\n<dd><p>No. Email delivery uses WordPress <code>wp_mail()<\/code> by default. SMTP and WhatsApp are optional.<\/p><\/dd>\n<dt id=\"can%20i%20use%20submitrelay%20without%20whatsapp%3F\"><h3>Can I use SubmitRelay without WhatsApp?<\/h3><\/dt>\n<dd><p>Yes. WhatsApp integration is optional and can be enabled or disabled from the plugin settings.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20whatsapp%20message%3F\"><h3>Can I customize the WhatsApp message?<\/h3><\/dt>\n<dd><p>Yes. You can configure a WhatsApp message template and use supported placeholders to insert submitted information.<\/p><\/dd>\n<dt id=\"can%20custom%20form%20fields%20be%20included%20in%20the%20whatsapp%20message%3F\"><h3>Can custom form fields be included in the WhatsApp message?<\/h3><\/dt>\n<dd><p>Yes. Custom form fields can be referenced using their field IDs as placeholders in the WhatsApp message template.<\/p>\n\n<p>For example, a custom field with the ID <code>travel_date<\/code> can be inserted using:<\/p>\n\n<pre><code>{travel_date}\n<\/code><\/pre><\/dd>\n<dt id=\"does%20submitrelay%20save%20form%20submissions%3F\"><h3>Does SubmitRelay save form submissions?<\/h3><\/dt>\n<dd><p>Yes. When submission storage is enabled, submissions can be viewed, searched, exported, and deleted from the WordPress administration area.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20store%20ip%20addresses%3F\"><h3>Does the plugin store IP addresses?<\/h3><\/dt>\n<dd><p>Not by default. IP address storage is disabled by default and can be enabled in the GDPR\/privacy settings. A visitor IP may still be used temporarily for rate limiting, but it is not stored unless IP storage is enabled.<\/p><\/dd>\n<dt id=\"how%20does%20whatsapp%20redirect%20work%20on%20mobile%3F\"><h3>How does WhatsApp redirect work on mobile?<\/h3><\/dt>\n<dd><p>After a successful form submission, SubmitRelay shows the success\/redirect message briefly and then opens the configured <code>wa.me<\/code> link. On phones and tablets, it uses the current page so supported devices can hand the link off to the installed WhatsApp app instead of opening a new browser tab. On desktop, the New Tab option keeps the website open.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20send%20data%20to%20whatsapp%3F\"><h3>Does the plugin send data to WhatsApp?<\/h3><\/dt>\n<dd><p>Only when the site administrator enables the WhatsApp redirect feature. The browser is redirected to WhatsApp with the configured message content after submission.<\/p><\/dd>\n<dt id=\"are%20smtp%20passwords%20included%20in%20settings%20exports%3F\"><h3>Are SMTP passwords included in settings exports?<\/h3><\/dt>\n<dd><p>No. SMTP passwords are deliberately excluded from exported settings.<\/p><\/dd>\n<dt id=\"how%20are%20stored%20submissions%20removed%3F\"><h3>How are stored submissions removed?<\/h3><\/dt>\n<dd><p>Administrators can delete submissions from the SubmitRelay submissions screen. WordPress's Privacy Tools can also use the plugin's personal-data eraser integration.<\/p><\/dd>\n<dt id=\"does%20submitrelay%20include%20analytics%20or%20tracking%3F\"><h3>Does SubmitRelay include analytics or tracking?<\/h3><\/dt>\n<dd><p>No. The plugin does not include advertising, analytics, telemetry, or background tracking requests.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.6<\/h4>\n\n<ul>\n<li>Changed Floating Button vertical control to a simple non-negative Bottom Offset (0\u2013200 px).<\/li>\n<li>Positive values move bottom-positioned floating buttons higher; negative values are no longer supported.<\/li>\n<\/ul>\n\n<h4>1.1.5<\/h4>\n\n<ul>\n<li>Hardened settings sanitization and runtime validation for all user-configurable values.<\/li>\n<li>Removed HTML handling from the floating button icon setting; icons are stored as text\/emoji.<\/li>\n<li>Added strict bounds and allowlists for numeric, color, position, date\/time, URL, and other settings used in generated output.<\/li>\n<li>Ensured settings are normalized before generating CSS, JavaScript, and HTML.<\/li>\n<li>No arbitrary custom CSS, JavaScript, or PHP insertion is supported.<\/li>\n<\/ul>\n\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Added a controlled Vertical Offset setting for the floating button.<\/li>\n<li>Allows site owners to move the floating button up or down within a safe 200-pixel range.<\/li>\n<li>The adjustment is implemented as a sanitized numeric setting and generated by the plugin; no arbitrary CSS is accepted.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Added strict phone-number validation on both the browser and server.<\/li>\n<li>Phone fields accept 7-15 digits with common formatting characters (spaces, +, -, parentheses and periods) and reject letters or arbitrary text.<\/li>\n<li>Added <code>inputmode=tel<\/code>, a length limit, and a validation pattern to phone inputs.<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Unified the floating button appearance settings into one Floating Button section.<\/li>\n<li>Renamed Button Color to Floating Button Color.<\/li>\n<li>Floating Button Color now controls both the floating button and submit button backgrounds.<\/li>\n<li>Text\/Icon Color now controls floating button text\/icon, submit button text, and the popup close icon.<\/li>\n<li>The popup close button is always available when the popup is open.<\/li>\n<li>Added strict phone-number validation to reject arbitrary text and accept common phone formatting characters.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Removed unrestricted custom CSS input and unrestricted CSS design-value fields.<\/li>\n<li>Fixed popup and button sizing, padding, border radius, and close-button size to controlled plugin defaults.<\/li>\n<li>Removed legacy storage of unrestricted CSS design values from active settings.<\/li>\n<\/ul>\n\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>Removed the arbitrary Additional CSS setting to comply with WordPress.org plugin review requirements.<\/li>\n<li>Preserved controlled design options such as popup, button, field, placeholder, overlay, and mobile button colors\/positions.<\/li>\n<li>Updated the settings export version to 1.0.9.<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Improved WordPress.org compatibility by using WordPress enqueue APIs for JavaScript and CSS output.<\/li>\n<li>Prefixed plugin runtime hooks, storage identifiers, and names to reduce collisions.<\/li>\n<li>Preserved existing settings, submissions, popup, standalone form, email, SMTP, GDPR, scheduling, and WhatsApp behavior.<\/li>\n<\/ul>","raw_excerpt":"WordPress contact form with floating popup, shortcode, email, SMTP, enquiry storage, and customizable pre-filled WhatsApp messages.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/360882","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=360882"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/muzaffarpakhtoon"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=360882"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=360882"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=360882"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=360882"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=360882"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=360882"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}