=== Discko === Contributors: discko Tags: forms, integration, modal, iframe, appointment Requires at least: 5.8 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Integrate Discko.io forms into WordPress with customizable floating button or iframe embed options. == Description == Discko allows you to seamlessly integrate your Discko.io forms into your WordPress website. Choose between two display modes: **Floating Button Mode** Display a customizable floating button that opens your Discko form in a beautiful modal overlay. Perfect for keeping your form accessible on every page without taking up valuable screen space. **Iframe Mode** Embed your Discko form directly on any page using a shortcode or Elementor widget. Ideal for dedicated contact or appointment pages. = Features = * **Two Display Modes**: Choose between floating button or iframe embed * **Fully Customizable Button**: Adjust size, position, colors, and animations * **Hover Tooltip**: Show custom messages when users hover over the button * **Custom Icon Upload**: Use your own brand icon for the floating button * **Page Exclusions**: Control where the button appears by page type or specific page IDs * **Modal Customization**: Configure mobile modal dimensions * **Elementor Integration**: Drag-and-drop widget for Elementor page builder * **Shortcode Support**: Simple shortcode for use in any page or post * **Responsive Design**: Works perfectly on desktop, tablet, and mobile devices * **Translation Ready**: Fully translatable with .pot file included * **French Translation**: Complete French translation included = Display Modes = **Floating Button** * Customizable size (40-100px) * Adjustable position from bottom and right edges * Custom icon support (PNG, WebP, SVG) * Hover bubble with custom text * Color customization * 4 animation styles: Pulse, Scale, Bounce, or None * Opens form in responsive modal overlay **Iframe Embed** * Use shortcode: `[discko_iframe]` * Customize height: `[discko_iframe height="800"]` * Elementor widget with visual controls * Adjustable borders and shadows in Elementor * Responsive design = Page Exclusions (Button Mode) = Control where the floating button appears: * Exclude by page type: 404 pages, archives, search results, attachments, single posts, or pages * Exclude specific pages by ID * Perfect for checkout pages, thank you pages, or any page where you don't want the button = Use Cases = * Appointment booking forms * Contact forms * Lead generation * Customer support * Consultation requests * Quote requests * Event registration * Service requests = Requirements = * WordPress 5.8 or higher * PHP 7.4 or higher * Active Discko.io account with form URL * For Elementor integration: Elementor plugin installed == Installation == = Automatic Installation = 1. Go to WordPress admin > Plugins > Add New 2. Search for "Discko" 3. Click "Install Now" 4. Activate the plugin = Manual Installation = 1. Download the plugin ZIP file 2. Go to WordPress admin > Plugins > Add New > Upload Plugin 3. Choose the ZIP file and click "Install Now" 4. Activate the plugin = Configuration = 1. Go to Settings > Discko in WordPress admin 2. **Section 1**: Choose your display mode (Button or Iframe) 3. **Section 2**: Enter your Discko form URL from your Discko.io account 4. **Section 3**: Customize settings for your chosen mode 5. Click "Save Settings" = Getting Your Discko Form URL = 1. Log in to [app.discko.io](https://app.discko.io) 2. Navigate to your integration page (format: `https://app.discko.io/.../integrations`) 3. Copy the form URL (format: `https://app.discko.io/form/.../new`) 4. Paste it in the plugin settings == Frequently Asked Questions == = Where do I get my Discko form URL? = Log in to your Discko.io account at [app.discko.io](https://app.discko.io) and copy your form URL. It typically looks like: `https://app.discko.io/form/xxx.../new` = How do I customize the button appearance? = Go to Settings > Discko, select "Floating Button" mode, and you'll find options to customize size, position, colors, icon, hover text, and animations. = Can I exclude the button from specific pages? = Yes! In the Button Settings section, you can exclude pages by ID (e.g., "12, 45, 78") or by page type (404, archives, search, etc.). = Does this work with Elementor? = Yes! When using Iframe mode, you can use the "Discko Form" widget in Elementor with full visual customization options. = How do I use the shortcode? = Simply add `[discko_iframe]` to any page or post. You can customize the height with `[discko_iframe height="800"]`. = Is the plugin translation ready? = Yes! The plugin is fully translation ready and includes complete English & French translations. = Can I use a custom icon for the button? = Yes! In Button Settings, click "Choose an Icon" to upload your own PNG, WebP, or SVG icon. Recommended size is 256x256px with transparent background. = Does this work on mobile devices? = Yes! The plugin is fully responsive and works on all devices. You can even customize the modal dimensions specifically for mobile devices. = Will this slow down my website? = No. The plugin only loads minimal CSS and JavaScript on pages where it's active, and assets are versioned for optimal caching. == Screenshots == == Changelog == = 1.0.0 (2024-12-15) = * Initial release * Dual display modes: Floating Button and Iframe embed * Floating button with drag and drop positioning * Modal with iframe integration * Iframe shortcode `[discko_iframe]` * Elementor widget integration * localStorage position persistence * 4 hover animation styles * Page exclusion options (by ID or type) * Custom icon upload support * Hover bubble with customizable text and color * Mobile-responsive modal dimensions * Complete French translations * Modern admin UI with Discko design system == Upgrade Notice == = 1.0.0 = Initial release of Discko plugin. == Additional Information == = Support = For support, please visit [discko.io/support](https://discko.io/support) or contact us through our website at [discko.io](https://discko.io). = Documentation = Full documentation is available at [docs.discko.io](https://docs.discko.io). = Privacy Policy = This plugin does not collect, store, or transmit any user data. All form submissions are handled directly by Discko.io according to their privacy policy. = Third-Party Service = This plugin integrates with Discko.io, a third-party service for form creation and appointment booking. By using this plugin, you are embedding forms from Discko.io on your website. * Service: Discko.io * Website: https://discko.io * Privacy Policy: https://discko.io/privacy * Terms of Service: https://discko.io/terms The plugin loads form content via iframe from Discko.io servers. No data is sent to Discko.io by this plugin itself - all form interactions happen directly between your website visitors and Discko.io.