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.
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/sertanozcnn/wordpress-social-media-redirect-plugin/archive/refs/heads/main.zip🔔 Social Float - Modern Floating Social Media Buttons
WordPress için Modern, Özelleştirilebilir Kayan Sosyal Medya Düğmeleri
Features • Installation • Configuration • Usage • Screenshots • Troubleshooting
📷 Screenshots
|
🖼️ Frontend Preview 📌 Frontend preview screenshot will be added here
|
⚙️ Admin Panel 📌 Admin panel screenshot will be added here
|
✨ Features
🎨 Design & Layout
|
⚡ Performance
|
🔧 Customization
|
🔐 Security & Features
|
📋 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
- Navigate to Plugins in WordPress admin
- Find Social Float and click Activate
- 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
- Navigate to Social Float → Social Buttons
- Click Add Button
- Select platform type:
- WhatsApp, Telegram, Instagram
- Facebook, Twitter, LinkedIn
- YouTube, TikTok, Viber
- Email, Custom URL
- Configure URL, label, icon, and color
- Drag to reorder buttons
- Click Save Settings
💡 Tip: Use the preview feature to see changes in real-time!
🎨 Usage
Adding WhatsApp Button
| Setting | Value |
|---|---|
| Platform | |
| 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 | |
| Label | |
| 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 |
|---|---|---|
| SVG | #25d366 |
|
| ✅ Telegram | SVG | #0088cc |
| SVG | #E4405F |
|
| SVG | #1877F2 |
|
| ✅ Twitter/X | SVG | #1DA1F2 |
| SVG | #0A66C2 |
|
| ✅ YouTube | SVG | #FF0000 |
| ✅ TikTok | SVG | #000000 |
| ✅ Viber | SVG | #665CAC |
| 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
- ✅ Adjust position settings in Design & Position tab
- ✅ Check for CSS conflicts with theme
- ✅ Try different offset values
- ✅ Verify z-index is not being overridden
- ✅ Check icon type selection (SVG/Custom)
- ✅ If custom, verify image URL is accessible
- ✅ Clear browser cache
- ✅ Check for CORS issues with external images
- ✅ 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.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📄 License
This project is licensed under the GPL-2.0 License - see the LICENSE file for details.
👨💻 Developer
![]() Sertan Özcan |
🆘 Support
Having issues? Check these resources:
- 📖 Documentation
- 🐛 Report a Bug
- 💡 Request a Feature
- 📧 Contact the developer
⭐ If you find this plugin helpful, please star the repository! ⭐
Made with ❤️ for WordPress Community
© 2026 Sertan Özcan. All rights reserved.
