Amoos Functionality Suite

Àpèjúwe

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Ìtumọ̀ Yorùbá: ’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 Ìtumọ̀ Yorùbá: – Fired when the plugin initializes
  • amoos_ahrefs_analytics_script Ìtumọ̀ Yorùbá: – Fired before Ahrefs script output
  • amoos_google_analytics_script Ìtumọ̀ Yorùbá: – Fired before Google Analytics script output

Filters

  • amoos_contact_box_content Ìtumọ̀ Yorùbá: – Filter contact box HTML content
  • amoos_dynamic_cities_list Ìtumọ̀ Yorùbá: – Filter the list of cities
  • amoos_floating_icons_position Ìtumọ̀ Yorùbá: – 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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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:
Ìtumọ̀ Yorùbá: – The plugin loads the Google Analytics tracking script from googletagmanager.com on every page load when the functionality is enabled
Ìtumọ̀ Yorùbá: – 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.)
Ìtumọ̀ Yorùbá: – Data is sent to GoogleÌtumọ̀ Yorùbá: ’s servers each time a page is viewed by a visitor
Ìtumọ̀ Yorùbá: – The data collection is controlled by Google Analytics and follows GoogleÌtumọ̀ Yorùbá: ’s data collection practices

Service provider: Google LLC
Ìtumọ̀ Yorùbá: – Terms of Service: https://marketingplatform.google.com/about/analytics/terms/
Ìtumọ̀ Yorùbá: – 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Ìtumọ̀ Yorùbá: ’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Ìtumọ̀ Yorùbá: ’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:
Ìtumọ̀ Yorùbá: – The plugin loads the Ahrefs Analytics tracking script from analytics.ahrefs.com on every page load when the functionality is enabled
Ìtumọ̀ Yorùbá: – Ahrefs Analytics automatically collects visitor data including: IP address, page URLs, referrer information, browser and device information, and user interactions
Ìtumọ̀ Yorùbá: – Data is sent to Ahrefs’ servers each time a page is viewed by a visitor
Ìtumọ̀ Yorùbá: – The data collection is controlled by Ahrefs Analytics and follows Ahrefs’ data collection practices

Service provider: Ahrefs Pte. Ltd.
Ìtumọ̀ Yorùbá: – Terms of Service: https://ahrefs.com/terms
Ìtumọ̀ Yorùbá: – 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Ìtumọ̀ Yorùbá: ’s admin interface.

Support

For support, feature requests, or bug reports, please contact:
Ìtumọ̀ Yorùbá: – Email: support@amoos.ro
Ìtumọ̀ Yorùbá: – 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

Àwọn àwòrán ìbòjú

  • Main Dashboard Ìtumọ̀ Yorùbá: – Centralized control panel for all functionalities organized into SEO and Other Functionalities sections
  • Ahrefs Analytics Settings Ìtumọ̀ Yorùbá: – Configure your Ahrefs Analytics tracking key
  • Password Protection Settings Ìtumọ̀ Yorùbá: – Set up website protection with domain restrictions and page exclusions
  • Google Analytics Settings Ìtumọ̀ Yorùbá: – Add your Google Analytics 4 Measurement ID
  • Custom CSS Classes Settings Ìtumọ̀ Yorùbá: – Add custom CSS classes meta box to pages
  • Floating Icons Settings Ìtumọ̀ Yorùbá: – Configure WhatsApp and phone icons with position options
  • Contact Box Settings Ìtumọ̀ Yorùbá: – Customize contact information display for blog posts 8.Dynamic Cities Settings Ìtumọ̀ Yorùbá: – Set up SEO-optimized city pages with customizable templates
  • About Dynamic Cities Settings
  • About Dynamic Cities Settings
  • Maintenance Mode Settings Ìtumọ̀ Yorùbá: – Configure maintenance page with custom message and image
  • Portfolio Showcase Settings Ìtumọ̀ Yorùbá: – Manage portfolio items and display options
  • Shortcode Usage Ìtumọ̀ Yorùbá: – Portfolio shortcode configuration and usage examples
  • Notification Bar Settings Ìtumọ̀ Yorùbá: – Customize notification bar with colors and content

Ìgbéwọlẹ̀

  1. Upload the plugin files to /wp-content/plugins/amoos-functionality-suite/ directory
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Navigate to ‘Amoos Suite’ in your WordPress admin menu
  4. Configure each functionality as needed

FAQ

Can I use multiple functionalities at the same time?

Yes! All functionalities can be enabled simultaneously. Each feature works independently and can be toggled on or off individually from the main dashboard.

Will this plugin slow down my website?

No. The plugin is designed with performance in mind. Scripts load asynchronously, and functionalities only load when enabled. The plugin uses minimal resources and optimized database queries.

Do I need coding knowledge to use this plugin?

No. All functionalities are managed through an intuitive WordPress admin interface. Simply enable the features you need and configure them through the settings panels.

Can I exclude certain pages from password protection?

Yes. The password protection feature allows you to exclude specific pages from protection. You can select which pages to exclude directly from the settings panel.

How do I add custom CSS classes to pages?

Once the Custom CSS Classes functionality is enabled, a meta box will appear in the page editor. Simply enter your CSS classes (comma-separated) and they will be automatically added to the body tag.

Can I customize the floating icons position?

Yes. The floating icons can be positioned in any of the four corners of your website. You can choose the position from the Floating Icons settings page.

What happens if I disable a functionality?

When you disable a functionality, it immediately stops working on your website. Your settings are preserved, so you can re-enable it later without losing your configuration.

Is this plugin compatible with caching plugins?

Yes. The plugin is designed to work with popular caching plugins. The password protection feature uses cookie-based authentication which is cache-friendly.

Do I need separate accounts for Google Analytics and Ahrefs Analytics?

Yes. You need valid accounts and tracking keys/IDs from both services to use their respective functionalities. The plugin only integrates with these services; it doesnÌtumọ̀ Yorùbá: ’t provide the analytics accounts themselves.

Can I use the Dynamic Cities feature for cities outside Romania?

The plugin comes with Romanian cities pre-configured, but you can filter the city list using the amoos_dynamic_cities_list filter hook to add or modify cities for your specific needs.

Àwọn àgbéyẹ̀wò

Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.

Àwọn Olùkópa & Olùgbéejáde

“Amoos Functionality Suite” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.

Àwọn Olùkópa

Túmọ̀ “Amoos Functionality Suite” sí èdè rẹ.

Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.

Àkọsílẹ̀ àwọn àyípadà

Version 1.1.0

  • NEW: Added support for two phone numbers in floating icons
  • ENHANCED: Floating icons now support two distinct phone numbers with different colors
  • IMPROVED: Better visual distinction between phone numbers (blue and green)
  • UPDATED: Admin interface now includes separate fields for Phone Number 1 and Phone Number 2
  • FIXED: Updated plugin activation to include new phone number options

Version 1.0.0

  • Initial release
  • Ahrefs Analytics integration
  • Password protection system
  • Google Analytics integration
  • Custom CSS classes meta box
  • Floating icons functionality
  • Contact box insertion
  • Dynamic cities with SEO optimization