Free WordPress plugin · version 2.0.0

WordPress form builder plugin: Porsino forms, surveys and questionnaires on your site

The “Porsino Forms” plugin brings the forms, surveys and questionnaires you build in Porsino into WordPress posts and pages without code: with a shortcode, a Gutenberg block, an Elementor widget or the classic editor button, inline or in a popup. The form runs on Porsino’s server, so responses don’t load your site’s database, and Porsino’s conditional logic, Iranian fields, Online form builder and reports all stay in place.

WordPress plugin guide

  • Free and open source (GPL)
  • Persian and right-to-left
  • Gutenberg, Elementor and the classic editor
  • WooCommerce post-purchase survey

What does the Porsino Forms plugin do?

  • Shortcode, block and Elementor

    The [porsino] shortcode, the “Porsino form” block in Gutenberg, the “Porsino form” widget in Elementor and the “Add Porsino form” button in the classic editor.

  • Pick the form from a list

    After “Connect account” you pick the form from your form list with search, with no address to copy. The connection is read-only and never sees responses.

  • Inline or popup

    The form inline with automatic height (no inner scrollbar), or a button that opens the form in an accessible popup.

  • Floating button and automatic popup

    A floating button on every page or chosen pages, and a popup that opens after a few seconds, on scroll or when the visitor is leaving.

  • Data into hidden fields

    UTM parameters, the page address and title, the logged-in WordPress user’s name and email, or fixed values — only when you turn them on.

  • WooCommerce post-purchase survey

    A satisfaction form on the “Order received” page with that order’s number, so each customer’s answer is tied to their purchase.

  • Dashboard widget

    The account’s latest forms and each one’s response count in the WordPress dashboard, for the site’s authors and admins.

  • Quizzes in a new tab

    Quizzes open in a new tab with a “Start the quiz” button, so the server-side timer and anti-cheating work properly.

The plugin loads no outside scripts, has a full Persian translation (fa_IR) and works with your Porsino custom domain too, so the form can open on your own address, for example form.yoursite.com.

Install the WordPress form builder plugin in three steps

  1. Download and install

    Get the zip file from this page. In the WordPress dashboard go to “Plugins › Add New › Upload Plugin”, choose the file and click “Activate” after it installs.

  2. Connect your Porsino account

    In “Settings › Porsino” click “Connect account”, sign in to Porsino and click “Allow”. If you don’t have an account, signing up for free takes a minute.

  3. Put the form on a page

    Add the “Porsino form” block or the Elementor widget to a post or page and pick the form from the list, or copy the shortcode from the form’s “Share” page.

Connecting your account is optional: the shortcode works with the form’s address or short code without it. The connection only reads your forms’ titles, addresses, publishing status and response counts, and you can disconnect it any time from the plugin or from “Settings › API & integrations” in Porsino.

The [porsino] shortcode and its options

Each form’s shortcode is ready in Porsino on the “Share” tab, in the “WordPress plugin” card. You can give the form address in three ways: the link slug, the permanent short code (like 14050721-3) or the form link itself.

Examples

  • [porsino form="14050721-3"]The form inline with automatic height
  • [porsino form="14050721-3" mode="popup"]A button that opens the form in a popup
  • [porsino form="14050721-3" utm="1" page="1"]The page’s UTM parameters and address into the form’s hidden fields
  • [porsino form="14050721-3" params="source=blog"]A fixed value for a hidden field
  • [porsino form="14050721-5" type="quiz"]Quiz: a start button that opens a new tab
Shortcode attributes of the Porsino Forms plugin
FeatureValueWhat it does
formForm slug, short code or linkWhich form to show (required)
modeinline or popupInline, or a button and popup
heightA number in pixelsThe frame’s initial height; it adjusts to the content after loading
labelTextThe button text in popup mode or for a quiz
colorHex colorButton color
typeform or quizOpens a quiz in a new tab even without a connected account
utm1Sends the page’s utm_source to utm_content parameters to the form
page1Page address and title: wp_page and wp_title
user1Logged-in user’s name and email: wp_name and wp_email
paramskey=value&key2=value2Fixed values; up to 20 pairs, each value up to 200 characters
baseDomain addressYour Porsino custom domain for this form
You set the default mode, height, button text and button color once in “Settings › Porsino”.

Passing page and user details to the form

Want to know which page or campaign each response came from? The plugin adds these details to the form’s address and the form stores them in a “Hidden field”. A value is saved only if the form has a hidden field with the same name:

  • UTM: the page’s five parameters utm_source, utm_medium, utm_campaign, utm_term and utm_content; create a hidden field with the “UTM” source in the form.
  • Page: wp_page (the page address without parameters) and wp_title; a hidden field with the “URL parameter” source and these names.
  • User: wp_name and wp_email, only for someone logged in to WordPress; that page is marked “do not cache” for caching plugins.
  • Fixed value: any key and value you write, like source=blog.

None of these is on by default. If you send the user’s name and email, say so in your site’s privacy policy; the plugin adds suggested text to WordPress’s privacy policy guide.

Post-purchase survey in WooCommerce

In “Settings › Porsino” choose a satisfaction form for WooCommerce’s “Order received” page. The form gets the order number (order_id) and, if you want, the order total and the customer’s name and email, so each customer’s answer is tied to their own purchase. The plugin shows the form only when that order’s key is in the address — the same check WooCommerce itself makes. To build the form itself, the Online survey templates such as customer satisfaction (CSAT) and NPS are ready.

Floating button and automatic popup across the site

  • A floating button in the page corner that opens the form in a popup; for example “Your feedback” or “Request a consultation”.
  • An automatic popup with three triggers: after a few seconds, after scrolling part of the page, or when the visitor is about to leave.
  • How often: every time, once per visit, or once every few days; the decision is made in the browser, so page caching isn’t broken.
  • Targeting: all pages, the home page, posts, pages or chosen IDs, with an exclusion list.

The Porsino plugin or a form builder inside WordPress?

Both are valid; the difference is where the form runs and where responses are stored. This table compares them fairly:

Comparing the Porsino Forms plugin with a form builder plugin inside WordPress
SubjectForm builder inside WordPressPorsino Forms plugin
Where responses are storedYour site’s databasePorsino’s dedicated server; you view and export them in the Porsino panel
Load on your site’s serverEvery response and file on that serverNone; the form loads from Porsino in a frame
Iranian fields and the Persian calendarDepends on the plugin and add-onsNational ID, mobile, IBAN (Sheba), province and city, and the Persian calendar built into the form builder
Reports and analysisUsually a list of responses117 ready-made reports, Excel and SPSS export
The same form outside your siteOnly on that siteThe same form also goes out by short link, QR code and messengers
PrerequisiteWordPress onlyWordPress + a free Porsino account

Requirements

  • WordPress 5.8 or newer and PHP 7.4 or newer.
  • A Porsino account; building forms and putting them on your site works on the free account too, and the plugin has no separate lock.
  • For “Connect account” the site must use https (plain http only for a test site on localhost, 127.0.0.1 or .test and .local addresses).
  • Elementor and WooCommerce are optional; if they’re installed, the widget and the post-purchase survey appear on their own.

Frequently asked questions about the WordPress plugin

Is the Porsino Forms plugin free?

Yes. The plugin itself is free and open source under the GPL and has no locks. Forms are built in your Porsino account; building forms and collecting responses are in the free account too, and only Porsino’s more advanced features need a separate plan.

Where are form responses stored?

On Porsino’s dedicated server, not in the WordPress database. You view responses, get reports and export to Excel in the Porsino panel. Even after you connect your account, the plugin has no access to the responses themselves.

Does it work for surveys and questionnaires too?

Yes; any form, survey or questionnaire you build in Porsino goes into WordPress with the same shortcode or block, with Porsino’s Likert scales, matrices, NPS, conditional logic and analytical reports.

Does it work with Elementor?

Yes. If Elementor is installed, the “Porsino form” widget appears in its widget list. Gutenberg has the “Porsino form” block and the classic editor has the “Add Porsino form” button.

What access does connecting the account give the plugin?

Only reading the form list: each form’s title, address, publishing status and response count. Not the responses themselves, not creating or editing forms, and not account settings. The connection key is made for that site only and is disconnected from the plugin or from “Settings › API & integrations” in Porsino.

Can I put a quiz on WordPress too?

Yes, but a quiz doesn’t run inside the site’s page: the plugin adds a “Start the quiz” button that opens the quiz in a new tab, so the server-side timer, full screen and anti-cheating work properly.

Will it slow down my site?

The plugin loads only its own small script and stylesheet on pages that have a form, and the form comes from Porsino in a frame, so responses and files don’t load your site’s server. No script from another domain is loaded on your site’s pages.

Does it work with page caching plugins?

Yes. Decisions about each visitor (UTM parameters, how often the popup shows) are made in the browser, so cached pages stay correct. Only if you send the logged-in user’s name and email does that page get marked “do not cache”.

Will the form open on my own domain?

If you have connected a Porsino custom domain, yes: give its address once in “Settings › Porsino”, or for one form with the base attribute.

Technical guides

All posts

Build your site’s next form in Porsino

Install the plugin, connect your free Porsino account and pick the form from the list; a few minutes to the first response.