WP Manifestindependent plugin directory
manifest / social / wordpress-social-media-redirect-plugin

Social Float - Modern Floating Social Media Buttons

Modern, customizable floating social media buttons for WhatsApp, Telegram, Instagram, and more. Fully adjustable position, icons, colors from admin panel. Support single & multiple button modes.

by Sertan Özcan · github.com/sertanozcnn/wordpress-social-media-redirect-plugin · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/sertanozcnn/wordpress-social-media-redirect-plugin/archive/refs/heads/main.zip
Readme github.com/sertanozcnn/wordpress-social-media-redirect-plugin ↗

🔔 Social Float - Modern Floating Social Media Buttons

WordPress için Modern, Özelleştirilebilir Kayan Sosyal Medya Düğmeleri

WordPress PHP License Version

Features • Installation • Configuration • Usage • Screenshots • Troubleshooting

📷 Screenshots

🖼️ Frontend Preview

📌 Frontend preview screenshot will be added here

screenshots/frontend-preview.png

 ⚙️ Admin Panel

📌 Admin panel screenshot will be added here

screenshots/admin-panel.png

✨ Features

🎨 Design & Layout

  • Flexible Positioning - Top/Bottom, Left/Right placement
  • Custom Colors - Individual button color selection
  • Multiple Animations - Fade, Slide, Scale effects
  • Responsive Design - Perfect on all devices
  • Modern UI - Clean, user-friendly interface

⚡ Performance

  • Lightweight - Minimal resource usage
  • Pure Vanilla JS - No jQuery dependency
  • Optimized CSS - Fast loading styles
  • Clean Code - WordPress standards compliant

🔧 Customization

  • Drag & Drop - Easy button reordering
  • SVG Icons - Crisp icons at any size
  • Custom Images - Upload your own icons
  • Button Sizing - Adjustable button dimensions
  • Icon Sizing - Fine-tune icon appearance

🔐 Security & Features

  • XSS Protection - Secure input handling
  • CSRF Protection - Nonce verification
  • Multi-language - Translation ready (TR included)
  • Admin Controls - Full settings panel
  • Mobile Toggle - Separate mobile settings

📋 Requirements

Requirement Minimum Version Recommended
WordPress 5.0+ 6.4+
PHP 7.4+ 8.0+

🚀 Installation

Method 1: WordPress Admin Panel

1. Download the plugin ZIP file
2. Go to Plugins → Add New → Upload Plugin
3. Select the ZIP file and click Install Now
4. Activate the plugin

Method 2: FTP/SFTP Upload

1. Extract the ZIP file
2. Upload social-float folder to /wp-content/plugins/
3. Activate from WordPress Plugins menu

Method 3: Git Clone

cd /wp-content/plugins/
git clone https://github.com/sertanozcnn/wordpress-social-media-redirect-plugin.git social-float

⚙️ Configuration

Step 1️⃣ Activate the Plugin

  1. Navigate to Plugins in WordPress admin
  2. Find Social Float and click Activate
  3. Access settings via Social Float menu in sidebar

Step 2️⃣ Configure General Settings

1. Go to Social Float → General Settings
2. Enable/Disable the plugin globally
3. Set display mode (Single/Multiple buttons)
4. Choose position (vertical & horizontal)
5. Adjust offset values for fine positioning

Step 3️⃣ Add Social Buttons

  1. Navigate to Social Float → Social Buttons
  2. Click Add Button
  3. Select platform type:
    • WhatsApp, Telegram, Instagram
    • Facebook, Twitter, LinkedIn
    • YouTube, TikTok, Viber
    • Email, Custom URL
  4. Configure URL, label, icon, and color
  5. Drag to reorder buttons
  6. Click Save Settings

💡 Tip: Use the preview feature to see changes in real-time!

🎨 Usage

Adding WhatsApp Button

Setting Value
Platform WhatsApp
Label WhatsApp Destek
URL https://wa.me/905XXXXXXXXX
Icon WhatsApp (SVG)
Color #25d366

Adding Telegram Button

Setting Value
Platform Telegram
Label Telegram
URL https://t.me/+905XXXXXXXXX
Icon Telegram (SVG)
Color #0088cc

Adding Instagram Button

Setting Value
Platform Instagram
Label Instagram
URL https://instagram.com/yourusername
Icon Instagram (SVG)
Color #E4405F

Display Modes

Mode Description
Single One main button that expands to show all buttons
Multiple All buttons visible at once in a stack

Position Settings

Option Description
Vertical Position Top or Bottom of viewport
Horizontal Position Left or Right of viewport
Vertical Offset Distance from top/bottom edge (px)
Horizontal Offset Distance from left/right edge (px)

Animation Types

Animation Effect
Fade Smooth opacity transition
Slide Buttons slide in from edge
Scale Buttons scale from small to normal
None No animation

🎯 Supported Platforms

Platform Icon Default Color
✅ WhatsApp SVG #25d366
✅ Telegram SVG #0088cc
✅ Instagram SVG #E4405F
✅ Facebook SVG #1877F2
✅ Twitter/X SVG #1DA1F2
✅ LinkedIn SVG #0A66C2
✅ YouTube SVG #FF0000
✅ TikTok SVG #000000
✅ Viber SVG #665CAC
✅ Email SVG #EA4335
✅ Custom Upload User choice

🔧 Troubleshooting

❌ Buttons not appearing
  • ✅ Verify plugin is activated
  • ✅ Check if plugin is enabled in General Settings
  • ✅ Ensure at least one button is enabled
  • ✅ Clear browser and site cache
  • ✅ Check for JavaScript errors in console
❌ Buttons in wrong position
  • ✅ Adjust position settings in Design & Position tab
  • ✅ Check for CSS conflicts with theme
  • ✅ Try different offset values
  • ✅ Verify z-index is not being overridden
❌ Icons not displaying
  • ✅ Check icon type selection (SVG/Custom)
  • ✅ If custom, verify image URL is accessible
  • ✅ Clear browser cache
  • ✅ Check for CORS issues with external images
❌ Settings not saving
  • ✅ Check user permissions (admin required)
  • ✅ Verify WordPress nonce is valid
  • ✅ Look for PHP errors in debug log
  • ✅ Disable conflicting plugins temporarily

📁 File Structure

social-float/
├── 📄 social-float.php              # Main plugin file
├── 📄 README.md                      # Documentation
│
├── 📂 includes/
│   ├── 📄 class-social-float-admin.php     # Admin class
│   ├── 📄 class-social-float-frontend.php  # Frontend class
│   ├── 📄 admin-page.php                   # Admin template
│   └── 📄 button-item-template.php         # Button template
│
├── 📂 assets/
│   ├── 📂 css/
│   │   ├── 📄 admin.css             # Admin styles
│   │   └── 📄 frontend.css          # Frontend styles
│   ├── 📂 js/
│   │   ├── 📄 admin.js              # Admin JavaScript
│   │   └── 📄 frontend.js           # Frontend JavaScript
│   └── 📂 icons/                    # SVG icons
│
└── 📂 languages/
    └── 📄 social-float-tr_TR.po     # Turkish translation

📝 Changelog

Version 1.0.0 (2026-02-06)

🎉 Initial Release

  • ✅ Modern floating social media buttons
  • ✅ Full admin panel with live preview
  • ✅ Drag & drop button reordering
  • ✅ Multiple platform support (10+ platforms)
  • ✅ Single and multiple display modes
  • ✅ Flexible positioning system
  • ✅ Custom colors for each button
  • ✅ SVG and custom image icons
  • ✅ Animation options (Fade, Slide, Scale)
  • ✅ Mobile responsive design
  • ✅ Turkish language support
  • ✅ Clean, optimized code

🗺️ Roadmap

  • [ ] Tooltip support on hover
  • [ ] Click analytics/tracking
  • [ ] Page-specific visibility rules
  • [ ] More animation effects
  • [ ] Button group support
  • [ ] Popup chat integration
  • [ ] Gutenberg block

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the GPL-2.0 License - see the LICENSE file for details.

👨‍💻 Developer

Sertan Özcan
Sertan Özcan

🆘 Support

Having issues? Check these resources:

⭐ If you find this plugin helpful, please star the repository! ⭐

Made with ❤️ for WordPress Community

© 2026 Sertan Özcan. All rights reserved.