wpm

rankology-seo-and-analytics-tool

plugin

2.7.0 • public • Published 7 days ago

Rankology SEO and Analytics Tool is a powerful, fast, and easy-to-use SEO plugin that helps WordPress sites rank higher in search engines.

analyticsgoogle search consoleschema markupspeed optimizationwordpress seo
Overview Versions Dependencies

Description

Rankology SEO and Analytics Tool is a comprehensive WordPress SEO plugin that helps sites rank higher in search engines. Features include:

Core SEO Features:
Meta titles & descriptions, focus keywords, canonical URLs, keyword density analysis, alt text optimization, internal linking detection, nofollow link management, last modified dates, and social media integration.

Advanced SEO:
Content analysis with overall SEO scoring, Google autocomplete keyword suggestions, schema markup (Article, FAQ, Review, Organization, Local Business), robots.txt & .htaccess management, XML sitemap generation, and image SEO automation.

Rankology LinkFlow:
Smart internal linking with suggestions from content, meta fields, and keywords. Includes analytics dashboards, broken/orphan link detection, engagement tracking, content keyword search, recommendations tables, interlinking graphs, and sitemap visualization.

Google Integration:
Connect Google Analytics (GA4) and Search Console via Rankology API. View real-time metrics (sessions, engagement, clicks, impressions) per URL, submit pages for indexing, and access insights directly in WordPress editor.

Speed Optimization:
HTML/CSS/JS minification, full-page caching, image compression & WebP conversion, server cache headers, GZIP/Brotli compression, and performance stats dashboard.

Web Performance & Core Web Vitals:
Modern PageSpeed Insights dashboard with Lighthouse-style analysis. Measure LCP, FCP, CLS, INP, TBT, TTI, and TTFB. Includes report caching, history tracking, comparison tools, shareable public reports, email sharing, and automatic mobile analysis.

Settings & Customization:
Global meta settings per content type, social sharing buttons, breadcrumb navigation, header/footer code injection, import/export functionality, and Cloudflare CDN integration.

Installation

  1. Upload the rankology-seo-and-analytics-tool folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Navigate to Rankology in your WordPress admin to configure settings
  4. Connect your Google Analytics and Search Console accounts for full functionality

Frequently Asked Questions

Can I customize the schema markup?

Yes! You can enable/disable automatic schema or manually add custom schema for articles, FAQs, reviews, organizations, and local businesses.

Does the plugin work with caching plugins?

Yes, Rankology is compatible with most caching plugins. For best results, clear your cache after making SEO changes.

How do I add breadcrumbs to my theme?

Use the shortcode [rankology_breadcrumb] anywhere in your theme templates or content.

How do I connect Google Analytics and Search Console?

Go to Rankology → Settings → Rankology API Key, enter your API key from rankology.io, and the plugin will automatically fetch your analytics data.

Changelog

2.7

  • Release Date: 2026-02-05
  • Introduced Web Performance & Core Web Vitals module with modern PageSpeed Insights dashboard
  • Added comprehensive Core Web Vitals analysis: LCP, FCP, CLS, INP, TBT, TTI, and TTFB metrics
  • Implemented report caching system with configurable duration (default 7 days) to reduce API calls
  • Added report history tracking with pagination and quick access to previous analyses
  • Introduced report comparison feature to track performance improvements over time
  • Added shareable public reports with secure token-based URLs (no admin authentication required)
  • Implemented email sharing functionality with HTML templates for performance reports
  • Added automatic mobile analysis trigger after successful desktop analysis
  • Integrated with Rankology Laravel API for PageSpeed Insights (no Google API key required)
  • Added force refresh option to bypass cache and fetch latest performance data
  • Implemented secure webhook system for plugin activation/deactivation with HMAC-SHA256 signatures
  • Added automatic API key provisioning upon plugin activation via webhook
  • Enhanced security with rate limiting, nonce validation, and SSL verification for webhooks
  • Improved code quality and WordPress coding standards compliance

2.6

  • Release Date: 2026-01-26
  • Added full-page caching with preload support and manual controls to keep content instantly available
  • Introduced configurable JavaScript defer and delay options to improve rendering without blocking critical scripts
  • Added cache exclusions, WordPress heartbeat control, and a cache status indicator for better monitoring and fine-tuning of cache behavior

2.5

  • Release Date: 2025-01-15

  • Fixed Plugin URI accessibility issue to ensure the declared URL is valid and reachable.

  • Aligned "Requires at least" value in both plugin headers and readme.txt to reflect the lowest tested stable major WordPress version.

  • Removed non-permitted and development-only files from the plugin package (vendor binaries, CLI tools, .bat files).

  • Updated and verified all third-party libraries to their latest stable versions:

    • DataTables: Updated from 1.13.6 to 2.3.6 (local files and CDN references)
    • Chart.js: Updated from 4.5.0 to 4.5.1
    • Font Awesome: Updated from 6.4.0 to 6.7.2
    • Select2: Updated from 4.1.0-rc.0 to 4.1.0 (stable)
    • spatie/image-optimizer: Updated and verified at version 1.8.1

  • Removed all shell command execution usage for improved security and hosting compatibility.

  • Added human-readable source code and/or public source references for all minified and compiled JS/CSS assets.

  • Documented build tools and source locations in the readme to comply with WordPress human-readable code guidelines.

  • Added a dedicated "External Services" section to the readme explaining all third-party APIs used, including:

    • Purpose of each service
    • Data sent and usage conditions
    • Links to relevant Terms of Service and Privacy Policies

  • Improved internationalization (i18n) compliance:

    • Replaced dynamic variables in translation strings with placeholders
    • Ensured all translation calls use static strings
    • Unified text domain to match the plugin slug: rankology-seo-and-analytics-tool

  • Scoped and refactored global filters to prevent unintended global behavior changes.

  • Hardened security by sanitizing, validating, and escaping all input/output data:

    • Improved nonce verification handling
    • Sanitized POST, GET, REQUEST, FILE, and decoded JSON inputs
    • Escaped all rendered output appropriately

  • Refactored function names, class names, AJAX actions, options, and JavaScript globals to use unique, consistent prefixes and avoid conflicts.

  • Improved overall code quality, stability, and compliance with WordPress.org Plugin Review Guidelines.

2.4

  • Release Date: 2025-12-24
  • Cloudflare: new integrated control center for cache + security with zone validation and dual auth (email+key or token)
  • Cache: manual purge all/URLs plus auto-purge on content, comments, theme switches, and plugin/theme updates
  • Tuning: cache-level presets and browser cache TTL presets to balance speed and freshness
  • Security: Development Mode toggle, security level selector, and WordPress-safe page rules from the dashboard
  • UX: inline status, guided modal/PDF, and clearer Cloudflare layout for faster decisions

2.3

  • Release Date: 2025-12-17
  • Fixed minor UI glitches and layout issues in Rankology Settings and Speed Booster screens
  • Improved overall design consistency (colors, spacing, and typography) across dashboards and tables
  • Polished buttons, icons, and cards for a cleaner, more modern appearance
  • Resolved a few minor stability issues and code warnings for smoother performance

2.2

  • Release Date: 2025-12-12
  • Speed Booster UI & Workflow improvements
  • New "Optimization Settings" main tab with subtabs
  • Master Enable Cache now auto-enables HTML/CSS/JS toggles
  • Toast-style notifications for all cache actions
  • One-click Purge All Caches tab
  • Stability improvements and PHP warning fixes
  • Enhanced Image Optimization with multiple compression methods
  • Automatic WebP conversion and lazy loading
  • Bulk image optimization with progress tracking

2.1

  • Release Date: 2025-11-20
  • Introduced Rankology Speed Booster module
  • Added HTML, CSS, and JavaScript minification
  • Server cache headers and GZIP/Brotli compression
  • Object Cache support for database optimization
  • Performance Stats dashboard with cache metrics
  • Modern card-based UI for speed optimization features

2.0

  • Release Date: 2025-11-05
  • Added Rankology API Key integration
  • Google Analytics & Search Console insights
  • One-click URL submission to Google Search Console
  • Enhanced data-driven SEO decision-making
  • UI refinements and performance optimizations

1.9

  • Release Date: 2025-10-29
  • Revamped plugin color scheme for modern look
  • Enhanced dashboard and analytics graph styling
  • Improved spacing, typography, and contrast
  • Updated button styles and hover effects
  • Optimized layout alignment across all tabs

1.8

  • Release Date: 2025-10-16
  • Improved overall plugin design for better UI/UX
  • Enhanced Linkflow tabs layout and readability
  • Minor CSS and visual consistency updates

1.7

  • Release Date: 2025-10-10
  • Comprehensive LinkFlow Analytics with card view
  • Content Keyword Search and Recommendations tables
  • Broken Links and Orphan Links tracking
  • Multi-Page Recommendations management
  • Engagement Tracking and Interlinking graph
  • Pages Sitemap graph for visual site structure
  • Improved designs for enhanced analytics

1.6

  • Release Date: 2025-10-03
  • Introduced Rankology LinkFlow for internal linking
  • Smart link suggestions in post/page edit screens
  • LinkFlow Velocity and Improvement tables
  • Header & Footer Code insertion with targeting options
  • Device-specific code targeting (Desktop/Mobile/Both)

1.3

  • Release Date: 2025-09-11
  • Crawling Options for search engine control
  • Disable link crawling and image indexing options
  • Exclude paginated archives and attachment pages
  • Enable/Disable SEO alerts and warnings

1.2

  • Release Date: 2025-09-09
  • Separate global meta fields for different content types
  • Social Sharing improvements with default images
  • Dynamic Organization and Local Business schema
  • FAQ Schema and Review Page Schema toggles
  • Breadcrumb settings with shortcode support
  • Import/Export functionality for settings and data
  • Redesigned Settings UI with responsive card layout

1.1

  • Release Date: 2025-08-25
  • Auto-generated XML sitemap with exclusion options
  • Robots.txt customization with manual and automatic entries
  • .htaccess custom rules editor (Apache only)
  • Additional Schema options (FAQ, Review)
  • Image SEO settings for automatic alt text and filename cleaning

1.0

  • Release Date: 2025-06-30
  • Initial plugin release with core SEO features

Breadcrumb Navigation

• Enable customizable breadcrumbs per content type and embed them via a [rankology_breadcrumb] shortcode so visitors and search engines enjoy clear site structure.

Cloudflare Integration

• Connect your Cloudflare account to purge cache, adjust security/performance rules, and view zone-level confirmation directly from the Rankology dashboard.

Server Settings:
• Add custom rules to the .htaccess file (for Apache servers only, not Nginx) via a manual input field.

Robots.txt Settings:
• Admins can manually add custom entries.
• Automatically append entries from the robots options table.

Sitemap Settings:
• Auto-generate XML sitemap.
• Exclude specific pages & posts from sitemap.
• Automatic sitemap updates on new content.
• Direct submission to Google & Bing.

Image SEO Settings:
• Automatically use the image filename as alt text on upload.
• Use the uploaded file’s name as the image title by default.
• Option to set the post title using the uploaded file’s alt text and title.
• Automatically clean uploaded media filenames for SEO and compatibility.

Crawling Options:
• Control site visibility in search results.
• Disable link crawling site-wide.
• Disable image indexing for the site.
• Disable descriptions for all pages in Google.
• Exclude paginated archive pages from indexing.
• Exclude attachment pages from indexing.

Enable/Disable Alert & Warnings:
• Enable Notice on Discourage search engines from indexing this site.
• Enable Robots Notice.
• Enable Robots Sitemap.

Rankology Speed Booster

Boost your site's loading speed using advanced optimization tools designed to enhance performance and Core Web Vitals. Organized in 5 intuitive tabs for complete control.

Feature Control Tab:
• Master toggle to enable/disable all caching features at once.
• Individual switches for HTML, CSS, and JavaScript minification.
• Quick overview of active optimization features with status indicators.

Cache Generation Tab:
• HTML Minification: Automatically compress HTML output by removing whitespace and comments.
• CSS Minification: Generate optimized lightweight CSS files without affecting originals.
• JavaScript Minification: Minify and optimize JS files with automatic AJAX-based cache rebuilding.
• One-click cache clearing for all minified assets without page reload.

Image Optimization Tab:
• Advanced image compression using multiple methods (Spatie, Imagick, GD, binary tools).
• Automatic WebP conversion for all uploaded images with smart browser detection.
• Lazy loading implementation to load images only when visible in viewport.
• Bulk optimization with chunk-based processing for entire media library.
• Real-time performance stats showing total images, optimized count, space saved, and WebP files created.
• Separate sub-tabs for settings and results/bulk actions.
• Support for all WordPress image sizes and thumbnails.

Server Configuration Tab:
• Server Cache Headers: Add Cache-Control, Expires, and Pragma headers for improved browser caching.
• GZIP/Brotli Compression: Auto-configure compression rules for Apache/LiteSpeed servers (.htaccess).
• Htaccess Header Cache: Enable .htaccess-based caching for static files.
• Object Cache: Enable object cache headers for faster server processing and database query optimization.
• Real-time compression detection showing GZIP/Brotli status on your server.

Performance Stats Tab:
• Visual dashboard displaying cache performance metrics.
• Hit rate statistics for optimized vs. non-optimized requests.
• Overall site performance score and optimization recommendations.
• Real-time insights into your speed optimization effectiveness.

Web Performance & Core Web Vitals Tab:
• Modern PageSpeed Insights dashboard with Lighthouse-style analysis.
• Core Web Vitals Analysis: Measure and visualize LCP (Largest Contentful Paint), FCP (First Contentful Paint), CLS (Cumulative Layout Shift), INP (Interaction to Next Paint), TBT (Total Blocking Time), TTI (Time to Interactive), and TTFB (Time to First Byte).
• Performance Score: Get detailed performance metrics with overall performance score (0-100) and grade ratings (A-F).
• Optimization Recommendations: View actionable optimization opportunities with potential savings, resource details, and improvement suggestions.
• Report Caching: Configurable cache duration (default 7 days) to reduce API calls and improve response times. Cached reports are stored in database with automatic expiration.
• Report History: View and manage all previous PageSpeed analyses with pagination, filtering, and quick access to historical reports.
• Report Comparison: Compare two PageSpeed reports side-by-side to track performance improvements over time, with detailed metric comparisons and opportunity analysis.
• Shareable Reports: Generate secure, token-based public URLs for sharing performance reports with stakeholders, clients, or team members without requiring WordPress admin access.
• Email Sharing: Send performance reports via email with custom HTML templates and public share links.
• Automatic Mobile Analysis: After successful desktop analysis, automatically trigger mobile analysis in the background for comprehensive performance insights.
• Force Refresh Option: Bypass cache and fetch latest data from API when needed for real-time analysis.
• Device Strategy Selection: Analyze performance for both desktop and mobile devices with separate reports and metrics.
• Public Report Access: Public reports render the full dashboard UI with all metrics, charts, and optimization recommendations accessible via clean URLs (no admin authentication required).
• Integration with Rankology API: Seamlessly connects to Rankology Laravel API for PageSpeed Insights data, eliminating the need for Google API keys.

Complete Seo Analysis

• Analyze every post and page for keyword use, title structure, meta descriptions, and content scoring so you can continuously tune optimization efforts with precise feedback.

External Services

This plugin connects to the following external services:

  1. Rankology API Services

1a. Rankology Webhook System (Plugin Lifecycle)

  • Purpose: Secure communication with Rankology servers for plugin activation and deactivation events
  • Data Sent:
    • On Activation: Site URL, site name, WordPress version, PHP version, plugin version, timestamp, nonce, and HMAC-SHA256 signature (if webhook secret exists)
    • On Deactivation: All activation data plus stored API key (if available)
  • When:
    • Plugin Activation: Sends blocking request to receive webhook secret and API key from server
    • Plugin Deactivation: Sends non-blocking request to notify server of deactivation
  • Security Features:
    • HMAC-SHA256 signature verification for request authenticity
    • Nonce generation for request validation
    • Rate limiting (5-second cooldown between requests)
    • SSL certificate verification
    • Secure storage of webhook secret and API key in WordPress options
  • Endpoints:
  • Data Storage: Webhook secret and API key are stored securely in WordPress options table and only sent to Rankology API endpoints
  • Note: The webhook system ensures seamless integration with Rankology services and automatic API key provisioning upon plugin activation
  • Rankology Privacy Policy
  • Rankology Terms of Service

  1. Cloudflare API

    • Purpose: Manage CDN cache, security settings, performance rules, and analytics data
    • Data Sent:
      • API credentials (API key/token and optionally email address for Global API Key authentication)
      • Zone ID (identifier for your Cloudflare zone/domain)
      • Cache management commands (purge all cache, purge specific URLs)
      • Security settings (WAF status, security level, bot fight mode, browser integrity check)
      • Performance settings (cache level, browser cache TTL, auto minify settings, rocket loader, polish, WebP)
      • Page rule configurations (URL patterns, cache rules, security rules)
      • Analytics queries (time range parameters for performance and security analytics)
    • When:
      • When testing Cloudflare connection (sends zone ID to verify credentials)
      • When purging cache (manually or automatically after content updates)
      • When updating security settings (WAF, security level, bot protection)
      • When updating performance settings (cache level, minification, optimization)
      • When creating or deleting page rules
      • When fetching analytics data (performance metrics, security events, top statistics)
      • When toggling development mode
    • Endpoints:
    • Note: All API credentials are stored securely in WordPress options and only sent to Cloudflare API endpoints. No user data or website content is sent to Cloudflare.
    • Cloudflare Privacy Policy
    • Cloudflare Terms of Service

  2. Google Autocomplete API

Full-Page Cache & Control

• Built-in full-page cache plus cache exclusions, Heartbeat throttling, and a cache status indicator give you complete visibility into what’s stored and how quickly visitors see the page.

Google Integration

• Directly surface Google Analytics (GA4) and Search Console metrics per URL, submit pages for indexing, and monitor clicks, impressions, and engagement inside WordPress for faster data-driven decisions.

Header/Footer Code

• Inject custom HTML, CSS, or JavaScript before or after key page segments, restrict it to devices or templates, and toggle the feature without editing theme files.

Image Optimization

• Compress uploads, convert to WebP, and clean filenames automatically while preserving alt text hygiene so every media asset contributes to faster loads and better image SEO.

Internal Linking

• Smart linking suggestions, LinkFlow analytics, and engagement tables guide you to add relevant anchors, track orphan pages, and grow the internal link network without leaving the editor.

Performance Optimization

• Minify HTML, CSS, and JavaScript with real-time cache rebuilding plus loader controls (defer/delay) so scripts don’t block rendering while your best content stays compliant with Core Web Vitals.

Schema Markup

• Automatically generate schema for articles, FAQs, reviews, organizations, or local businesses and switch to manual configuration when you need full control over the structured data output.

Social Media Optimization

• Manage Open Graph metadata, share buttons, and default sharing images to ensure every post displays perfectly on Facebook, X, LinkedIn, Reddit, and Pinterest.

Source Code

This plugin includes minified JavaScript and CSS files for performance. The source code and build process are available at:

Note: Some JavaScript files (vis-network.min.js, cytoscape.min.js) are minified for performance. The source code is available at the GitHub links above. The plugin uses build tools (npm/composer) to generate production files. To build from source, clone the repository and run the build commands as documented in the repository.

Technical Seo

• Edit robots.txt, .htaccess, redirects, canonical tags, noindex/nofollow rules, and crawling options to maintain a clean, secure technical foundation for search engines.