=== Form 4 Me ===
Contributors: yewaung
Tags: form, contact form, booking, payment, form builder
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 0.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Forms built in the block editor, with entries, emails and file uploads.

== Description ==

Build a form like a page: add fields as blocks (name, email, phone with
country code, address, dropdown, radio buttons, checkboxes, consent box, short
and long text, number, date, time, file upload), drag them into place, and
type the labels right on the fields. Text, headings, links (for example your
terms) and images (for example a payment QR code) can go anywhere, also below
the send button. Spacing, colours and sizes of each field and of the button
are set in the block sidebar.

For each form choose a layout (Simple, Two columns, Card, Compact), what
happens after sending (a message, or another page) and the emails that go out
(to, from, reply-to, subject and message with [tags], formatted or plain text,
uploaded files attached).

Entries are kept under Forms > Entries with a status, a note, private file
downloads and a CSV export.

Put a form on a page with the "Form" block, the Elementor "Form" widget, or
[form4me id="12"].

Spam protection without CAPTCHA: a hidden trap field, a signed time stamp, a
limit per visitor per hour and per day for the site, and Spam 4 Me's checks
when that plugin is active.

== Frequently Asked Questions ==

= Where are uploaded files kept? =

In wp-content/uploads/form4me-private/ under random names, with deny rules for
Apache and IIS. On nginx add a rule that denies that folder. Files are
downloaded from the entry by logged-in staff only.

== Installation ==

1. Upload the `form4me` folder to `/wp-content/plugins/`, or install the ZIP in Plugins > Add New > Upload.
2. Activate the plugin. An example "Contact us" form is made.
3. Open Forms in the dashboard menu, change the form, and put it on a page with the Form block or [form4me id="12"].

== External services ==

None. Forms, entries and files stay on your site; emails are sent with your site's normal mail (wp_mail). Card payments (Stripe) are not part of this version.

== Screenshots ==

1. Build a form in the block editor: drag fields in and type the labels right on them.
2. Below the form: layout, what happens after sending, payment, where the form is used, and emails.
3. The form on a listing page, with the listing filled in for the visitor.
4. Entries with status and payment status, filters and CSV export.

== Changelog ==


= 0.2.0 =
* Changed: all code names now start with form4me_ instead of the short f4m_, so they cannot clash with other plugins (WordPress.org asks for this). Your settings move to the new names on their own; forms and entries are unchanged.
= 0.1.0 =
* Paid forms: amount fixed or the price of the doctor, listing or event the form is about; how to pay (text and a QR picture); payment slip (required, optional or not asked). Entries get a payment status (Unpaid, Slip received, Paid, Refunded) with a column, filter and CSV columns; [amount] and [payment-status] tags.
* "Where this form is used": tick listings and events right on the form.
* "Choose from your content" field (for example a listing; filled in on that listing's page), dates "from today on".
* First version: forms in the block editor, 17 field types, 4 layouts, message or redirect after sending, emails with tags, entries with status and CSV export, private file uploads, spam limits, Form block, shortcode and Elementor widget.

== Upgrade Notice ==


= 0.2.0 =
Code names now use the full form4me_ prefix. Settings move automatically.
= 0.1.0 =
Part of the 4 Me family by TheStickPress. See the changelog for what is new.
