=== Shortcode Popup Forms ===
Contributors: thaxam
Donate link: https://paypal.me/thaxam
Tags: contact, form, email, shortcode, popup, thaxam
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires PHP: 7.4
WC HPOS compatible: yes

A lightweight plugin to create a clean, targeted contact form for a specific person using a simple shortcode. Ideal for quick, precise communication.

== Description ==

The Shortcode Popup Forms plugin allows you to easily add contact forms to your WordPress pages using a simple shortcode. When users click the contact button, a modern contact form appears with fields for name, title, email, and message. The plugin supports custom SMTP settings for reliable email delivery and offers multiple button design options.

### Features

- Add a contact form anywhere using a simple shortcode
- Assign the message recipient (person/department) per shortcode
- Minimal, fast, and fully responsive
- No bloat — only essential fields
- GDPR-friendly (no tracking, no cookies)
- Works with any theme
- Supports custom success messages

### Shortcode Example

```
[thaxam-contact name="John Doe" email="john@example.com"]
```

== Installation ==

1. Upload the `shortcode-popup-forms` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure SMTP settings in Tools > Shortcode Popup Forms (optional)
4. Customize button design in Tools > Shortcode Popup Forms > Button Design tab

== Settings Page ==

The plugin settings page can be accessed from your WordPress admin dashboard:

1. Go to **Tools > Shortcode Popup Forms**
2. Configure SMTP settings for custom email delivery
3. Customize button designs and default recipient information

The settings page includes three tabs:
- **SMTP Settings**: Configure custom SMTP server details for reliable email delivery
- **Default Recipient**: Set default contact name and email for forms when not specified in shortcode
- **Button Design**: Customize button appearance, colors, and behavior with multiple design options

== Usage ==

Add the contact form to any page or post using the shortcode:

[thaxam-contact name="John Doe" email="johndoe@email.com"]

### Shortcode Parameters

- `name` (required): The name of the person to contact
- `email` (required): The email address to send the message to
- `design` (optional): Override the default button design (default, modern, gradient, outline, neumorphism, glassmorphism)

### Examples

[thaxam-contact name="John Doe" email="johndoe@email.com"]

This will create a "Send Email" button with the default design that reveals a contact form when clicked.

[thaxam-contact name="Jane Smith" email="jane@email.com" design="modern"]

This will create a "Send Email" button with the modern design style.

== SMTP Configuration ==

If the default WordPress email settings don't work, you can configure custom SMTP settings:

1. Go to **Tools > Shortcode Popup Forms** in your WordPress admin
2. Enter your SMTP server details:
   - **SMTP Host**: Your email server hostname (e.g., smtp.gmail.com)
   - **SMTP Port**: Usually 587 for TLS or 465 for SSL
   - **SMTP Encryption**: TLS, SSL, or None
   - **SMTP Username**: Your email username
   - **SMTP Password**: Your email password
3. Save the settings

### Gmail Configuration Example

For Gmail:
- SMTP Host: smtp.gmail.com
- SMTP Port: 587
- SMTP Encryption: TLS
- SMTP Username: your-gmail@gmail.com
- SMTP Password: Your Gmail app password (not your regular password)

**Note**: You may need to enable "Less secure app access" or generate an app password for Gmail.

== Button Design Customization ==

The plugin offers extensive button customization options:

1. Go to **Tools > Thaxam Contact Form > Button Design** tab
2. Choose from 6 different design styles
3. Customize colors using color pickers:
   - Background Color
   - Text Color
   - Hover Background Color
4. Adjust styling properties:
   - Border Radius
   - Padding
   - Font Size

== Form Fields ==

The contact form includes the following fields:

- **Your Name** (required): Sender's full name
- **Title**: Optional title or subject
- **Your Email** (required): Sender's email address
- **Message** (required): The message content

== Security Features ==

- All form inputs are properly sanitized
- Nonce verification for AJAX requests
- Email validation
- XSS protection through proper escaping

== Frequently Asked Questions ==

= Can I customize the form styling? =

Yes, you can override the CSS by adding custom styles to your theme's stylesheet.

= Does this plugin store form submissions? =

No, form submissions are sent directly via email and not stored in the database.

= Can I use this with any email service? =

Yes, as long as it supports SMTP. Popular services like Gmail, Outlook, SendGrid, etc., are supported.

== Screenshots ==

1. Settings page with SMTP configuration
2. Button design customization options
3. Example contact form in action

== Changelog ==

= 1.2.2 =
- Version bump to 1.2.2.

= 1.2.1 =
- Changed shortcode from 'contact' to 'thaxam-contact'.
- Updated readme files and file headers.

= 1.2.0 =
- Updated plugin slug to shortcode-popup-forms
- Changed shortcode name to Shortcode_popup

= 1.1.0 =
- Added multiple button design options (Default, Modern, Gradient, Outline, Neumorphism, Glassmorphism)
- Added comprehensive button customization controls (colors, padding, border radius, font size)
- Redesigned settings page with tabbed interface
- Changed from modal popup to inline form display
- Updated button text to "Send Email"
- Added optional design parameter to shortcode

= 1.0.0 =
- Initial release
- Shortcode functionality
- Popup modal with contact form
- Custom SMTP settings
- AJAX form submission
- Responsive design

== Upgrade Notice ==

= 1.1.0 =
This version introduces major UI changes: the contact form now displays inline instead of in a modal popup, and the button text has changed to "Send Email". Button design customization options have been significantly expanded.

== Support ==

For support or feature requests, please contact Thaxam.

== License ==

This plugin is licensed under the GPL v2 or later.

== Credits ==

Made by Thaxam
