=== Alirahimpoor Contact & Social Panel ===
Contributors:      alirahimpoor
Tags:               contact, floating button, social media, click to call, rtl
Requires at least: 5.8
Tested up to:      7.0
Requires PHP:      7.4
Stable tag:        1.0.2
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A beautiful, animated floating button that displays phone contacts and social media icons in a sleek panel.

== Description ==

**Alirahimpoor Contact & Social Panel** adds a beautiful, animated floating action button (FAB) to your WordPress site. Clicking it opens a sleek, dark panel showing your phone contacts and social media links — great for lead generation and customer support.

= Key Features =

* **Phone contacts** — Add unlimited contacts with a name, phone number, and avatar image. Visitors can call directly with one tap.
* **Social media links** — Display up to 6 social icons in two rows. Works with any platform using a custom icon image URL.
* **Full color control** — Every element (button, panel, text, icons, borders) can be styled individually with a color picker.
* **Custom panel font** — Set a custom `font-family` for the panel (title, contact names, labels) to match your site's typography — great for Persian/Farsi font stacks like Vazirmatn or IRANSans.
* **Flexible positioning** — Place the button on the left or right side, with a custom distance from the bottom and edge of the screen.
* **Media library picker** — Choose avatar and social icon images directly from your WordPress media library, or paste a URL.
* **Social display modes** — Show all 6 icons, only the first row of 3, or hide the social section entirely (useful for clients who only want a phone button).
* **Smooth animations** — Ring pulse effect, icon swap on open/close, and a spring-based panel transition.
* **Accessible** — ARIA labels, keyboard navigation (close with Escape), and focus management.
* **Responsive** — Fully optimized for mobile devices.
* **Lightweight** — No jQuery on the frontend, no external dependencies, no tracking.
* **RTL-ready** — Works well on right-to-left sites; the frontend markup adapts to your site's text direction.
* **Persian (Farsi) translation included** — The admin panel and frontend labels are fully translated out of the box.

= Social Display Modes =

On the **General** tab you can choose one of three modes:

1. **All 6 icons (2 rows)** — show both rows of social icons
2. **First 3 icons only (1 row)** — only the first row is shown
3. **Hide social networks** — only phone contacts are shown in the panel

This makes the plugin suitable both for businesses that want a full social media presence and for clients who just need a simple call button.

= Who is this plugin for? =

* Small businesses that need a professional contact widget
* Web design agencies building sites for different clients (use the "hide social networks" mode for clients who only want a call button)
* Anyone looking for a modern, animated alternative to plain contact info in the footer

= Developer =

Designed and developed by [Ali Rahimpoor](https://alirahimpoor.ir).

== Installation ==

1. Upload the `alirahimpoor-contact-social-panel` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Contact Panel** in the WordPress admin menu.
4. Configure your contacts, colors, and social media links.
5. Save — the button appears on your site immediately.

= From the WordPress dashboard =

1. Go to **Plugins → Add New**.
2. Search for "Alirahimpoor Contact & Social Panel".
3. Click **Install**, then **Activate**.

== Frequently Asked Questions ==

= Can I add more than 6 social media icons? =

The plugin currently supports exactly 6 social media slots (2 rows of 3). This limit is intentional to keep the panel clean and readable on mobile.

= How do I add social media icons? =

Go to **Contact Panel → Social Networks**. For each slot, enter a label, link, and icon image — you can choose the image directly from the WordPress media library or paste a URL.

= Can I hide the social media section entirely? =

Yes! On the **General** tab, under **Social Networks Display**, choose **Hide social networks**. Only phone contacts will be shown.

= Is it compatible with page builders? =

Yes, the plugin injects the button through `wp_footer` and is compatible with Elementor, Divi, WPBakery, Gutenberg, and any other page builder.

= Is it mobile friendly? =

Yes. The button and panel are fully responsive and optimized for touch.

= Does it slow down my site? =

No. The frontend JavaScript is a small file with no dependencies. CSS uses custom properties efficiently and there are no external network requests.

= Is it suitable for right-to-left (RTL) sites? =

Yes. The plugin was originally built with Persian and RTL sites in mind and works well in an RTL layout.

= Does the plugin support Persian (Farsi)? =

Yes. A complete Persian translation is bundled with the plugin as of version 1.0.1. If your WordPress site's language is set to Persian (فارسی), the admin panel and frontend labels will switch automatically — no extra setup required.

= Can I change the font used in the panel? =

Yes. Go to **Contact Panel → General → Typography** and enter a `font-family` value (e.g. `Vazirmatn, Tahoma, sans-serif`). This applies to the panel's title, contact names, and labels. Note that the plugin only sets which font to use — the font itself must already be loaded on your site by your theme or another plugin.

== Screenshots ==

1. The open panel showing phone contacts and social media icons
2. General settings tab — button position and social display mode
3. Social Networks tab — configure the icons for each row

== Changelog ==

= 1.0.2 =
* Fixed: main button and close button could inherit broken styles (size, border-radius, background, uppercase text, box-shadow) from theme button skins such as WoodMart
* Hardened frontend CSS with higher-specificity selectors and a dedicated reset for `<button>`/`<a>` elements inside the widget
* Assets now enqueue at a later priority so the widget's styles load after most theme/page-builder styles

= 1.0.1 =
* Added a complete Persian (Farsi) translation, bundled with the plugin
* Loaded translations explicitly via `load_plugin_textdomain()` for compatibility with manual installs
* Added a custom panel font-family setting (General tab → Typography), with strict validation against unsafe values

= 1.0.0 =
* First public release
* Floating button with an animated panel for phone contacts and social media
* Three social display modes: all, first row only, or hidden
* Full settings panel with 21 color controls and a live preview
* Avatar and icon image selection from the WordPress media library
* Full accessibility support (ARIA, keyboard, focus management)
* Smooth spring-physics animations and overlay background
* Fully responsive layout for mobile
* RTL-friendly frontend and admin panel
* Automatic settings cleanup on uninstall
