Amoos Functionality Suite

Description

The Amoos Functionality Suite is a powerful WordPress plugin that consolidates multiple website functionalities into one easy-to-manage package. Each functionality can be activated or deactivated independently, giving you complete control over your website’s features.

Features

1. Ahrefs Analytics

• Purpose: Add Ahrefs Analytics tracking script to your website
• Features:
  • Asynchronous script loading
  • Customizable tracking key
  • Admin settings panel
  • Duplicate script detection

2. Password Protection

• Purpose: Add password protection to your entire website
• Features:
  • Domain-specific protection (optional)
  • Exclude specific pages from protection
  • Skip protection for logged-in users
  • Cookie-based authentication (cache-friendly)
  • Customizable password form design

3. Google Analytics

• Purpose: Add Google Analytics 4 tracking to your website
• Features:
  • Google Analytics 4 (gtag.js) integration
  • Customizable Measurement ID
  • Asynchronous script loading
  • Duplicate script detection

4. Custom CSS Classes

• Purpose: Add custom CSS classes meta box to pages
• Features:
  • Meta box in page editor
  • Comma-separated class input
  • Automatic body class addition
  • Easy CSS customization

5. Floating Icons

• Purpose: Add floating WhatsApp and phone icons to your website
• Features:
  • WhatsApp icon with direct messaging
  • Two phone icons with direct calling (different colors)
  • 4 position options (corners)
  • Responsive design
  • Inline SVG icons (no external dependencies)
  • Customizable contact numbers
  • Visual distinction between phone numbers

6. Contact Box

• Purpose: Insert contact information box into blog posts
• Features:
  • Automatic insertion in blog posts
  • Middle-of-content positioning
  • Clickable phone and email links
  • Customizable contact information
  • Modern styled design

7. Dynamic Cities

• Purpose: Create dynamic city pages with SEO optimization
• Features:
  • Dynamic URL rewriting
  • SEO-optimized titles and descriptions
  • Shortcode for city lists
  • Automatic city list insertion
  • Customizable SEO templates
  • Romanian cities included

Usage

Main Dashboard

• Access the main dashboard at Amoos Suite in your WordPress admin
• Toggle functionalities on/off using the switch controls
• Click “Configure” to access individual settings

Individual Functionality Settings

Ahrefs Analytics

1. Go to Amoos Suite > Ahrefs Analytics
2. Enable the functionality
3. Enter your Ahrefs Analytics tracking key
4. Save settings

Password Protection

1. Go to Amoos Suite > Password Protection
2. Enable the functionality
3. Set your protection password
4. Configure domain restrictions (optional)
5. Select pages to exclude from protection
6. Save settings

Google Analytics

1. Go to Amoos Suite > Google Analytics
2. Enable the functionality
3. Enter your Google Analytics Measurement ID
4. Save settings

Custom CSS Classes

1. Go to Amoos Suite > Custom CSS Classes
2. Enable the functionality
3. Edit any page to add custom CSS classes
4. Classes will be automatically added to the body tag

Floating Icons

1. Go to Amoos Suite > Floating Icons
2. Enable the functionality
3. Enter WhatsApp number
4. Enter first phone number (blue icon)
5. Enter second phone number (green icon)
6. Choose icon position
7. Save settings

Contact Box

1. Go to Amoos Suite > Contact Box
2. Enable the functionality
3. Configure contact information
4. Set box title and contact form link
5. Save settings

Dynamic Cities

1. Go to Amoos Suite > Dynamic Cities
2. Enable the functionality
3. Set base page slug
4. Configure SEO templates
5. Save settings
6. Flush rewrite rules (go to Settings > Permalinks)

Shortcodes

City List Shortcode

Use [orase_optimizare_seo] to display a list of Romanian cities with links to their respective pages.

Hooks and Filters

Actions

• amoos_functionality_suite_init – Fired when the plugin initializes
• amoos_ahrefs_analytics_script – Fired before Ahrefs script output
• amoos_google_analytics_script – Fired before Google Analytics script output

Filters

• amoos_contact_box_content – Filter contact box HTML content
• amoos_dynamic_cities_list – Filter the list of cities
• amoos_floating_icons_position – Filter floating icons position

Security Features

• All inputs are sanitized and validated
• Nonce verification for all forms
• Capability checks for admin functions
• XSS protection for output
• SQL injection prevention

Performance Features

• Asynchronous script loading
• Conditional loading (only when enabled)
• Optimized database queries
• Minimal resource usage

Compatibility

• WordPress: 5.0 or higher
• PHP: 7.4 or higher
• MySQL: 5.6 or higher
• Tested up to: WordPress 6.4

Browser Support

• Chrome 80+
• Firefox 75+
• Safari 13+
• Edge 80+

Troubleshooting

Common Issues

1. Scripts not loading

   • Check if functionality is enabled
   • Verify script keys/IDs are correct
   • Check for JavaScript errors in browser console

2. Rewrite rules not working (Dynamic Cities)

   • Go to Settings > Permalinks
   • Click “Save Changes” to flush rewrite rules

3. Password protection not working

   • Check domain settings
   • Verify password is correct
   • Clear browser cache and cookies

4. Floating icons not appearing

   • Check if functionality is enabled
   • Verify phone numbers are correctly formatted
   • Check for CSS conflicts

Debug Mode

Enable WordPress debug mode to see detailed error messages:
php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

External Services

This plugin connects to third-party external services when certain functionalities are enabled. This section documents what data is sent, when it’s sent, and where it goes.

Google Analytics

What it is: Google Analytics is a web analytics service provided by Google LLC that tracks and reports website traffic and user behavior.

What it’s used for: This plugin integrates Google Analytics 4 (GA4) to track website visitors, page views, user interactions, and other analytics data when the Google Analytics functionality is enabled.

What data is sent and when:
– The plugin loads the Google Analytics tracking script from googletagmanager.com on every page load when the functionality is enabled
– Google Analytics automatically collects visitor data including: IP address, page URLs, referrer information, browser and device information, geographic location (derived from IP), and user interactions (clicks, scrolls, form submissions, etc.)
– Data is sent to Google’s servers each time a page is viewed by a visitor
– The data collection is controlled by Google Analytics and follows Google’s data collection practices

Service provider: Google LLC
– Terms of Service: https://marketingplatform.google.com/about/analytics/terms/
– Privacy Policy: https://policies.google.com/privacy

Note: This functionality is optional and only active when explicitly enabled in the plugin settings. You can disable it at any time through the plugin’s admin interface.

Ahrefs Analytics

What it is: Ahrefs Analytics is a web analytics service provided by Ahrefs Pte. Ltd. that tracks and reports website traffic and user behavior.

What it’s used for: This plugin integrates Ahrefs Analytics to track website visitors, page views, and other analytics data when the Ahrefs Analytics functionality is enabled.

What data is sent and when:
– The plugin loads the Ahrefs Analytics tracking script from analytics.ahrefs.com on every page load when the functionality is enabled
– Ahrefs Analytics automatically collects visitor data including: IP address, page URLs, referrer information, browser and device information, and user interactions
– Data is sent to Ahrefs’ servers each time a page is viewed by a visitor
– The data collection is controlled by Ahrefs Analytics and follows Ahrefs’ data collection practices

Service provider: Ahrefs Pte. Ltd.
– Terms of Service: https://ahrefs.com/terms
– Privacy Policy: https://ahrefs.com/privacy

Note: This functionality is optional and only active when explicitly enabled in the plugin settings. You can disable it at any time through the plugin’s admin interface.

Support

For support, feature requests, or bug reports, please contact:
– Email: support@amoos.ro
– Website: https://amoos.ro

License

This plugin is licensed under the GPL v2 or later.

Credits

• Font Awesome icons by Fonticons, Inc.
• WordPress hooks and filters
• jQuery for admin interface enhancements

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

Roadmap

• [ ] Additional analytics providers
• [ ] More floating icon options
• [ ] Advanced SEO features
• [ ] Performance monitoring
• [ ] Multi-language support
• [ ] Import/Export settings
• [ ] White-label options

Made with ❤️ by Amoos