=== StarLine Combo Popup ===
Contributors: starlinewebsolu
Tags: popup, offer, discount, marketing
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.txt

Display attractive combo offer popups to first-time visitors with customizable content and scheduling.

== Description ==

StarLine Combo Popup is a lightweight WordPress plugin that helps you display eye-catching combo offer popups to first-time visitors on your website. Perfect for e-commerce stores, service providers, and businesses looking to boost conversions with limited-time offers.

= Features =

* **First-Time Visitor Detection** - Shows popup only to new visitors
* **Enable/Disable Control** - Toggle popup on/off from admin settings
* **Date Scheduling** - Set start and end dates for time-limited offers
* **Customizable Content** - Edit title, description, button text, and URL
* **Image Upload** - Upload custom offer images via media library
* **Discount Badge** - Automatic percentage badge display
* **Live Preview** - See changes in real-time on settings page
* **Mobile Responsive** - Works perfectly on all devices
* **Cookie-Based** - Popup won't reappear after dismissal for 24 hours
* **Lightweight** - No jQuery dependency, optimized for performance
* **Admin-Friendly** - Settings available under Settings > StarLine Combo

= How It Works =

1. Install and activate the plugin
2. Go to Settings > StarLine Combo
3. Configure your offer details (title, content, image, dates)
4. Enable the popup and save settings
5. The popup will automatically appear for first-time visitors

= Default Settings =

On activation, the plugin sets up default content:
* Title: "Special Combo Offer!"
* Content: "Get any 3 items and get 10% Flat discount. Hurry, limited time offer!"
* Default offer image included (SVG format)

= Privacy =

This plugin uses a single cookie (`sl_cop_popup_dismissed`) to track if a visitor has dismissed the popup. This cookie expires after 24 hours. No personal data is collected or stored.

== Installation ==

1. Upload the `starline-combo-popup` folder to `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > StarLine Combo to configure your popup
4. Customize title, content, image, and schedule as needed
5. Enable the popup and save your settings

== Frequently Asked Questions ==

= Can I customize the popup design? =

Yes, you can customize the title, content, image, button text, and button URL from the admin settings. For advanced styling, you can override the CSS in your theme.

= How do I disable the popup? =

Go to Settings > StarLine Combo and uncheck the "Enable Popup" option. Save your changes.

= Can I schedule the popup for specific dates? =

Yes, set the Start Date and End Date fields in the Schedule Settings section. Leave them empty if you want the popup to always be active (when enabled).

= Does it work on mobile devices? =

Yes, the popup is fully responsive and works on all screen sizes.

= Will the popup show to logged-in admins? =

No, the popup is hidden for logged-in administrators so you can manage your site without interruptions.

= How often does the popup show to the same visitor? =

Once a visitor dismisses the popup, it won't show again for 24 hours (controlled by cookie).

== Screenshots ==

1. Admin settings page with all configuration options
2. Live preview of popup on settings page
3. Frontend popup display on website
4. Mobile responsive view

== Changelog ==

= 1.0.0 =
* Initial release
* First-time visitor popup functionality
* Admin settings with enable/disable control
* Date scheduling (start/end dates)
* Customizable title, content, and image
* Live preview on settings page
* Cookie-based dismissal tracking
* Responsive design for all devices
* Default content on activation

== Upgrade Notice ==

= 1.0.0 =
Initial release of StarLine Combo Popup plugin.

== License ==

This plugin is licensed under the GPLv2 or later.

== Credits ==

* Developed by StarLine Web Solutions
* Default offer image created using SVG (no external dependencies)
