Documentation: Floating Contact Button for WordPress
System Requirements
Plugin Installation
- Log in to your CMS WordPress site control panel.
- On the left side of the administrative menu, click on "Plugins".
- On the page that opens, at the top click on "Add new".
- This will open a page with the addition of plugins to the site from the official WordPress catalog. You need to click on the "Upload Plugin" button.
- After clicking on the page, a block with the download of the plugin archive will appear. Click on the "Choose file" button, select the archive with the plugin obtained by purchasing from IWS.BY and click on the "Install Now" button.
- Once the plugin is installed, the page will refresh and you will be prompted to activate the plugin. Click the "Activate plugin" button.
- After successful activation, you will be shown a window notifying you that the plugin has been successfully activated.
Plugin settings
To access the plugin settings, navigate through the admin panel menu to IWS.BY FCB → Settings.
The plugin settings page will open with all available options.
License Key
Enter the license key you received after placing your order on IWS.BY. Without a valid license key, the plugin will not receive updates and may not function properly.
Enable Button?
When set to "Yes," a floating button will be displayed on your website using the configuration options below.
Icon on button
This option selects the icon to be displayed on the button. Six icon options are available.
Button Size
This field sets the size of the button on your website. The value applies to both the width and height of the button. Specify a numeric value in pixels.
Button Color
This option sets the background color of the button. Enter a HEX color code.
Icon Color
This option sets the color of the icon on the button. Enter a HEX color code.
Button location
This option determines which side of the screen the button will appear on for website visitors. The button is displayed at the bottom of the screen, aligned to the side selected in this option.
Right indent
Specify the distance from the right edge of the screen to the button. Enter a numeric value in pixels. This value is applied only when "Right side" is selected in the Button Position option.
Left indent
Specify the distance from the left edge of the screen to the button. Enter a numeric value in pixels. This value is applied only when "Left side" is selected in the Button Position option.
Bottom indent
Specify the distance from the bottom edge of the screen to the button. Enter a numeric value in pixels.
Layer level (Z-INDEX)
This field sets the stacking order of the button layer. This corresponds to the CSS z-index property.
Enable Border?
When set to "Yes," a border will be added to the button using the settings below.
Border Width
This field sets the width of the button border. Enter a numeric value in pixels. This corresponds to the CSS border-width property.
Border Style
This option sets the style of the button border. Available styles include solid, double, dotted, and dashed. This corresponds to the CSS border-style property.
Border Color
This option sets the color of the button border. Enter a HEX color code. This corresponds to the CSS border-color property.
Enable Animation?
When set to "Yes," the selected animation will be applied to the button.
Animation Type
This option sets the type of animation applied to the button. Four animation types are available: pulse, bounce, shake, and icon spin.
Widget Design
This option sets the design of the contact widget window. Three design options are available: Light, Dark, and Custom. The Custom design will unlock additional fields, allowing you to tailor the widget's appearance to match your website's design.
Widget Title
Enter the text title that should be displayed in the header of the contact widget.
Widget Description
Enter the text description that should be displayed in the header of the contact widget.
Type of icons
This option determines how the icons are displayed in the contact widget. Two display options are available: plain icons and icons enclosed in a circle.
The following fields control the color of the contact icons.
Phone Icon
This option sets the color for all phone contact icons in the contact widget. Enter a HEX color code.
Email Icon
This option sets the color for all email contact icons in the contact widget. Enter a HEX color code.
WhatsApp Icon
This option sets the color for all WhatsApp contact icons in the contact widget. Enter a HEX color code.
Telegram Icon
This option sets the color for all Telegram contact icons in the contact widget. Enter a HEX color code.
Viber Icon
This option sets the color for all Viber contact icons in the contact widget. Enter a HEX color code.
Adding Contacts
Adding contacts to the widget is simple. In the site menu, navigate to add a new contact: IWS.BY FCB → Add Contact.
The page for adding a new contact to the contact widget will open.
Contact Type
This option sets the type of contact being added. Available types are: Phone Call, Email, WhatsApp, Telegram, and Viber.
Icon
This option sets the icon applied to the added contact. The module offers a total of 11 icons, which are available based on the selected contact type.
Contact
Enter the contact phone number, email address, or Telegram username in this field. The phone number must be in international format without the "+" sign. The email address should be in a standard email format. For Telegram contacts, use the username.
Phone example for Call, WhatsApp, and Viber: 375441111111 Email example: noreply@iws.by Telegram login example: telegramLogin
Important! If the contact data format is not strictly followed, the contact will not work properly.
Contact Title
Enter the text name for the contact. It is displayed at the top right relative to the contact icon.
Contact Description
Enter the text description for the contact. It is displayed at the bottom right relative to the contact icon.
Order
This field determines the display order of the contact in the widget.
Custom Design Settings
Custom design settings become available after selecting "Custom" in the "Widget Design" field.
Header Background
This option sets the background color of the top part of the contact widget, where the title, description, and close button are displayed. Enter a HEX color code.
Header title
This option sets the text color of the widget title located in the top part of the widget. Enter a HEX color code.
Header description
This option sets the text color of the widget description located in the top part of the widget. Enter a HEX color code.
Header close button
This option sets the color of the close icon located in the top part of the widget. Enter a HEX color code.
Content Background
This option sets the background color of the central part of the widget, where the contacts are listed. Enter a HEX color code.
Content title
This option sets the text color of the contact name for each contact in the central part of the widget. Enter a HEX color code.
Content description
This option sets the text color of the contact description for each contact in the central part of the widget. Enter a HEX color code.
Item background when hovering
This option sets the background color of a contact item when hovered over with the mouse cursor. Enter a HEX color code.
Color icon inside circle
This option sets the color of the icons when "In a circle" is selected in the "Icon Style" field. Enter a HEX color code.
Plugin update error
If you have an error when updating a plugin in the WordPress control panel, then this section of the instructions is necessary for you. Usually the error when updating looks like this:
This error appears in several cases, they are all related to the plugin's license key.
1) You do not have the license key filled in in the plugin settings.
Go to the plugin settings and check if the field "License key" is filled in. Without a license key update is not possible to download. There are times when you add a license key, but CMS WordPress did not save it correctly, for this plugin settings after entering the license key, click "Save".
2) Your plugin version cannot be updated automatically.
There are versions of plugins that cannot update automatically. To do this, go to the IWS.BY website at the link https://iws.by/en/my-account/downloads/. In the list of available downloads, find your plugin and download by clicking on the button on the right. Go to the administrative part of your site, to the plugin section, and download the new version using the WordPress plugin installer. Due to security updates to the update server, some plugin versions need to be updated manually. To check the list of such plugins for your version of the plugin, go to the following link: List of versions of WordPress plugins that can be updated manually.
3) Your license key has expired.
To check the expiration date of your license key, follow this link https://iws.by/en/my-account/view-license-keys/. In the list of license keys, find your plug-in key and in the column "Valid until" check its relevance. If the license key has expired, it is not possible to get updates. To solve this issue: make a new order and get the current license key.
3) The license key is not valid on your current site.
Our update system is designed so that the first time you access the update server, the license key is assigned to the requesting site. If you try to use a license key on more than one site, updates will only be available for one site. If you need updates for multiple sites, make a purchase of multiple license keys on the site. Sites without license keys will not be able to receive updates.
Attention! If you have changed the address of the site and can not download updates, write to us at support@iws.by with the new address of the site, we will update the data on our update server and within 24 hours you will be able to receive updates.
Support
IWS.BY support service for questions regarding our products is available via email: support@iws.by.
All available support options are available on the Support page: Go to.