=== Arewa Mobile Bottom Navigation Bar === Contributors: arewadev Tags: mobile bottom navigation, wordpress mobile menu, bottom navigation bar, mobile menu, mobile site navigation bar Requires at least: 5.0 Tested up to: 7.1 Stable tag: 1.4.2 Requires PHP: 7.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html A fully customizable floating bottom navigation bar for mobile-first WordPress sites with advanced visibility controls and WebView detection. == Description == **🚀 The Ultimate Mobile Navigation Bar Solution for WordPress** Arewa Mobile Bottom Navigation is a powerful, feature-rich WordPress plugin that adds a stunning floating bottom navigation bar to your website. Designed with mobile-first principles, this plugin transforms your site's navigation into a modern, app-like experience that users love. **✨ Why Choose Arewa Mobile Bottom Navigation?** * **📱 Mobile-First Design** - Built specifically for mobile devices with responsive design that adapts perfectly to all screen sizes * **🎨 Fully Customizable** - Complete control over colors, sizes, animations, and styling * **⚡ Lightning Fast** - Lightweight code that won't slow down your site * **🔧 Easy to Use** - Intuitive admin interface, no coding required * **🎯 Advanced Visibility Controls** - Show or hide navigation on specific pages, posts, categories, and more * **📱 WebView/App Detection** - NEW! Control navigation visibility within mobile apps using User-Agent detection * **🚀 Cache-Optimized** - Smart caching system prevents visibility issues and ensures consistent behavior * **💫 Smooth Animations** - Beautiful hover effects and pulse animations * **📋 Submenu Support** - Create nested menus for complex navigation structures * **🎭 Multiple Layout Styles** - Icon only, icon + text, or text on active button only **🌟 Key Features:** = Navigation Customization = * Choose between 2-6 navigation buttons * Three layout styles: Icon Only, Icon + Text, or Icon + Text on Active Button * Drag-and-drop button reordering * Custom SVG icons for each button * Individual color customization for icons, text, backgrounds, and active states = WebView & App Detection (NEW!) = * **User-Agent Detection** - Configure custom User-Agent strings to detect mobile apps and WebViews * **Flexible Visibility Modes** - Show only in apps, hide only in apps, or show everywhere * **Multiple App Support** - Support multiple apps with different User-Agent strings * **Cache-Safe Implementation** - Prevents caching issues that could cause inconsistent visibility = Submenu System = * Create unlimited submenu items for any button * Custom icons and colors for submenu items * Beautiful slide-in submenu overlay * Optional submenu header with logo and site title * Fully customizable submenu styling = Advanced Styling Options = * Custom background colors and opacity * Border radius control * Box shadow with customizable color * Button text and icon size controls * Hover effects toggle * Active button pulse animation * Submenu styling with full color control = Smart Visibility Controls = * Display on entire site or specific pages/posts * Category-based visibility * Custom post type support * Device-specific visibility (mobile, tablet, desktop) * Hide on login/register pages * Hide in admin dashboard * Combine multiple visibility rules = Professional Design = * Modern, clean interface * Smooth animations and transitions * Responsive design for all devices * WordPress admin integration * Easy-to-use settings panel **🎯 Perfect For:** * E-commerce websites * Business websites * Portfolio sites * Blog sites * News websites * Any WordPress site wanting modern mobile navigation **💡 Use Cases:** * Create an app-like navigation experience * Improve mobile user experience * Add quick access to important pages * Implement modern bottom navigation pattern * Enhance mobile site usability * Create custom mobile menu structures **🔒 Security & Performance:** * Follows WordPress coding standards * Secure data sanitization * Optimized for performance * No external dependencies (except Select2 for dropdowns) * Regular security updates **📚 Documentation:** Full documentation available at: https://arewa.dev/arewa-mobile-bottom-navigation-bar/ == Installation == = Automatic Installation = 1. Log in to your WordPress admin panel 2. Navigate to Plugins → Add New 3. Search for "Arewa Mobile Bottom Navigation" 4. Click "Install Now" and then "Activate" = Manual Installation = 1. Download the plugin zip file 2. Log in to your WordPress admin panel 3. Navigate to Plugins → Add New 4. Click "Upload Plugin" 5. Choose the zip file and click "Install Now" 6. Click "Activate Plugin" = After Installation = 1. Go to "Mobile Bottom" in your WordPress admin menu 2. Configure your navigation buttons 3. Customize colors and styling 4. Set visibility rules 5. Save and enjoy your new mobile navigation! == Frequently Asked Questions == = How many buttons can I add? = You can add between 2 and 6 navigation buttons. = Can I use custom icons? = Yes! You can paste SVG code directly for each button icon. = Does it work on desktop? = Yes, the navigation is responsive and works on all devices. You can also configure it to show only on mobile/tablet devices. = Can I hide the navigation on specific pages? = Absolutely! The plugin includes advanced visibility controls that let you show or hide navigation on specific pages, posts, categories, or post types. = Does it support submenus? = Yes! Each button can have its own submenu with unlimited items. = Will it slow down my site? = No, the plugin is lightweight and optimized for performance. It only loads on the frontend when enabled. = Can I customize the colors? = Yes, you have full control over all colors including background, text, icons, active states, and submenu colors. = Is it compatible with page builders? = Yes, the plugin works with all WordPress themes and page builders including Elementor, Gutenberg, and others. = Can I use it with WooCommerce? = Yes, the plugin is fully compatible with WooCommerce and all other WordPress plugins. = How do I get support? = Visit our documentation at https://arewa.dev/arewa-mobile-bottom-navigation-bar/ or contact us through the plugin page. == Screenshots == 1. **General Settings** – Main configuration panel for enabling the mobile navigation bar and global behavior. 2. **Button Configuration** – Button management with drag-and-drop reordering and individual button settings. 3. **Submenu Management** – Interface for creating and managing submenu items for navigation buttons. 4. **Advanced Styling Options** – Customize layout, sizes, borders, shadows, and visual appearance. 5. **Visibility Conditions** – Control where the navigation bar appears using multi-select conditions. 6. **WebView / App Conditions** – User-Agent detection to enable or disable the navigation bar in mobile apps and WebView environments. 7. **Mobile Navigation Preview** – Live preview of the bottom navigation bar on mobile devices. 8. **Submenu Overlay** – Fullscreen submenu overlay with header and smooth interactions. == Changelog == = 1.4.2 = * Confirmed full compatibility with WordPress 7.1 (tested up to 7.1) * Code review: verified no duplicate constant definitions * Stability and security improvements = 1.4.1 = * Fixed Android and WebView pull-to-refresh being triggered when swiping down at the top of an open submenu. * Added scroll-boundary containment and reliable background scroll locking while submenus are open. = 1.4.0 = * FIXED: Cache-safe client visibility prevents a cached browser response from hiding the navigation in apps. * FIXED: Exact and partial User-Agent matching for identifiers such as ArewaMoviesApp/1.2.0. * FIXED: X-User-Agent support now uses an uncached AJAX verification. * FIXED: User-Agent textarea rules preserve one pattern per line and support optional wildcards. * FIXED: Dynamic submenu item markup, removal, and drag-and-drop ordering. * NEW: Navigation and submenu gradients, glass blur, floating offsets, borders, width, and radius controls. * NEW: Button badges and configurable active backgrounds. * NEW: Submenu descriptions and per-item text/background colors. * NEW: Live style preview and User-Agent match tester in the admin. = 1.3.3 = * FIXED: Cache conflict causing mobile bottom navigation to disappear after a few hours * IMPROVED: Vary: User-Agent header now sent when device visibility is mobile/tablet (prevents wrong cached version) * IMPROVED: Full-page cache purge on settings update (LiteSpeed, WP Rocket, W3TC, and more) * IMPROVED: Visibility cache versioning for proper invalidation when settings change * Code: Refactored third-party cache hooks to comply with WordPress.org naming conventions = 1.3.1 = * Security: Improved sanitization, validation, and escaping to fully align with WordPress.org guidelines * Security: Proper nonce verification and capability checks added to all save handlers * Security: SVG output restricted via wp_kses; all dynamic output properly escaped * Code: Removed all phpcs:ignore directives and reviewed for WordPress Coding Standards compliance * Code: Moved new-button HTML template to PHP via wp_localize_script to resolve admin.js lint issues * Code: Updated Contributors list (arewadev) and adjusted visibility validation logic = 1.3.0 - 2026-02-09 = * IMPROVED: Better color picker initialization for dynamic fields * FIXED: Color picker compatibility issues with WordPress admin * FIXED: Critical error with duplicate wp_localize_script calls * FIXED: Color values not displaying correctly in admin panel * UPDATED: All color fields now use modern Pickr color picker * UPDATED: Color values stored as RGBA for better transparency support = 1.2.0 = * **NEW: WebView/App Detection** - Control navigation visibility within mobile apps using User-Agent detection * **NEW: Advanced Cache Management** - Smart caching system prevents visibility issues and ensures consistent behavior * **NEW: User-Agent Configuration** - Define custom User-Agent strings to detect specific apps or WebViews * **NEW: Flexible Visibility Modes** - Show only in apps, hide only in apps, or show everywhere * **NEW: Cache-Busting Headers** - Adds Vary: User-Agent header to prevent caching conflicts * **IMPROVED: Performance** - Optimized visibility checks with intelligent caching * **IMPROVED: Admin Interface** - Enhanced visibility conditions section with WebView settings * **FIXED: Cache Issues** - Resolved problems where visibility conditions weren't applied consistently * **FIXED: Settings Persistence** - Improved settings saving and validation * Security enhancements and code optimization = 1.1.1 = * Enhanced visibility controls with multi-select display modes * Improved dropdown selection interface with Select2 * Fixed settings save functionality for all select fields * Added documentation button in admin interface * Updated plugin metadata (Author, Plugin URI, Text Domain) * Improved default values (all options default to Enable) * Better error handling and validation * Performance optimizations = 1.1.0 = * Added submenu header with logo support * Enhanced visibility conditions * Improved admin interface * Better mobile responsiveness * Bug fixes and improvements = 1.0.0 = * Initial release * Basic navigation functionality * Button configuration * Styling options * Visibility controls == Upgrade Notice == = 1.3.3 = Fixes cache conflict where mobile navigation disappears after a few hours. Recommended for all users with caching enabled. = 1.3.1 = Security and coding standards update. Recommended for all users. = 1.3.0 = Major update Color values not displaying correctly in admin panel = 1.2.0 = Major update with WebView/App detection capabilities! Now you can control navigation visibility within mobile apps using User-Agent detection. Includes advanced cache management to prevent visibility issues. Highly recommended for all users, especially those with mobile apps. = 1.1.1 = This update includes major improvements to visibility controls, settings saving, and user interface. All settings now default to "Enable" for better user experience. = 1.1.0 = Major update with submenu header support and enhanced visibility controls. Update recommended for all users. == Support == For support, documentation, and updates, visit: https://arewa.dev/arewa-mobile-bottom-navigation-bar/ == Credits == Developed by A-Said Website: https://arewa.dev/ == Privacy == This plugin does not collect, store, or transmit any user data. All settings are stored locally in your WordPress database. == Development == * GitHub: Coming soon * Issues: Report via plugin support page * Contributions: Welcome! == Additional Information == **Performance:** * Lightweight and fast * No external API calls * Optimized CSS and JavaScript * Minimal database queries **Compatibility:** * WordPress 5.0+ * PHP 7.2+ * All modern browsers * Mobile and desktop devices * All WordPress themes * Major page builders (Elementor, Gutenberg, etc.) **Accessibility:** * Keyboard navigation support * Screen reader friendly * ARIA labels included * Semantic HTML structure **Translation Ready:** * Text Domain: arewa-mobile-bottom-navigation-for-wordpress * POT file included * Ready for translation == Technical Details == **File Structure:** * Main plugin file: arewa-mobile-bottom-navigation-for-wordpress.php * Admin settings: includes/admin-settings.php * Frontend rendering: templates/navigation.php * Visibility logic: includes/visibility-conditions.php **Hooks & Filters:** * `arewa_mbn_settings` - Filter settings before save * `arewa_mbn_should_display` - Filter visibility check * `arewa_mbn_button_html` - Filter button HTML output **Database:** * Options stored in: `arewa_mbn_settings`, `arewa_mbn_buttons`, `arewa_mbn_submenus` * No custom database tables * Easy to export/import settings == License == This plugin is licensed under the GPL v2 or later. == Author == **A-Said** * Website: https://arewa.dev/ * Plugin URI: https://arewa.dev/arewa-mobile-bottom-navigation-bar/ == Tags == mobile navigation, bottom navigation, mobile menu, responsive navigation, floating navigation, bottom bar, mobile-first, navigation bar, sticky navigation, app-like navigation, mobile bottom menu, WordPress mobile, mobile UX, bottom menu bar, mobile navigation plugin, WordPress navigation, mobile site navigation, bottom navigation bar, mobile menu plugin, responsive menu