Skip to content

docs: rename plugin to comply with WordPress.org#57

Merged
guibranco merged 7 commits into
mainfrom
feature/rename-plugin
May 23, 2026
Merged

docs: rename plugin to comply with WordPress.org#57
guibranco merged 7 commits into
mainfrom
feature/rename-plugin

Conversation

@guibranco
Copy link
Copy Markdown
Owner

@guibranco guibranco commented May 22, 2026

📑 Description

Rename the plugin from "IpQuery" to "Stracini Visitor Analytics with IpQuery" following trademark compliance requirements from the WordPress.org Plugin Review Team. The plugin needed a clear distinction as a third-party integration with IpQuery.

  • Updated plugin name in README.md and documentation files.
  • Adjusted dashboard and settings navigation labels for clearer identification.
  • Added a notice in the README.md explaining the renaming and mentioning the unchanged internal components like class names and database tables.

✅ Checks

  • My pull request adheres to the code style of this project
  • My code requires changes to the documentation
  • I have updated the documentation as required
  • All the tests have passed

☢️ Does this introduce a breaking change?

  • Yes
  • No

Summary by Sourcery

Rename the WordPress plugin and documentation to use the new "Stracini Visitor Analytics with IpQuery" branding for WordPress.org compliance.

Documentation:

  • Update README and docs to use the new plugin name and clarify it is an independent integration not officially affiliated with IpQuery.
  • Adjust documentation references to the plugin’s admin menu entries (Dashboard, Settings, Visitors, Logs) to reflect the updated sidebar label "Visitor Analytics".

Summary by CodeRabbit

  • Documentation
    • Updated site and plugin branding to "Stracini Visitor Analytics with IpQuery."
    • Admin navigation entries and guidance updated to "Visitor Analytics" (Settings, Dashboard, Visitors, Logs).
    • Updated plugin metadata (tested up to, stable tag) and introductory descriptions.
    • Revised licensing/footer text and privacy/audit-log guidance to reflect new naming.

Review Change Stack

Rename the plugin from "IpQuery" to "Stracini Visitor Analytics with
IpQuery" following trademark compliance requirements from the
WordPress.org Plugin Review Team. The plugin needed a clear
distinction as a third-party integration with IpQuery.

- Updated plugin name in README.md and documentation files.
- Adjusted dashboard and settings navigation labels for clearer
  identification.
- Added a notice in the README.md explaining the renaming and
  mentioning the unchanged internal components like class names
  and database tables.
@sourcery-ai
Copy link
Copy Markdown

sourcery-ai Bot commented May 22, 2026

Reviewer's Guide

Renames the WordPress plugin to "Stracini Visitor Analytics with IpQuery" for WordPress.org trademark compliance and updates user-facing labels and documentation while leaving internal identifiers unchanged.

File-Level Changes

Change Details Files
Rename plugin branding across README and docs to the new compliant name.
  • Update main README title to the new plugin name and add an explanatory rename notice for WordPress.org compliance, clarifying that internal identifiers remain unchanged.
  • Replace references to the old plugin name in docs (installation, privacy, and index pages) with the new name in user-facing text and examples.
  • Clarify plugin activation instructions to use the new plugin name in the WordPress Plugins screen.
README.md
docs/installation.md
docs/privacy.md
docs/index.md
Update navigation and UI references from IpQuery to Visitor Analytics in documentation to match the admin menu label.
  • Change descriptions of the WordPress admin sidebar menu entry from "IpQuery" to "Visitor Analytics" across docs, including Dashboard, Settings, Visitors, and Logs locations.
  • Ensure all path references like "IpQuery → Settings/Dashboard/Visitors/Logs" are updated to "Visitor Analytics → ..." so docs match the UI.
README.md
docs/installation.md
docs/privacy.md
docs/visitors.md
docs/configuration.md
docs/dashboard.md
Adjust documentation site metadata to reflect the new plugin name and non-affiliation notice.
  • Update Jekyll docs site title to the new plugin name and expand description to explicitly state the plugin is not officially affiliated with IpQuery.
  • Change footer text to reference the new plugin name while keeping licensing and attribution links unchanged.
docs/_config.yml

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@guibranco guibranco enabled auto-merge (squash) May 22, 2026 10:49
@gstraccini gstraccini Bot added the ☑️ auto-merge Automatic merging of pull requests (gstraccini-bot) label May 22, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 22, 2026

Warning

Review limit reached

@guibranco, we couldn't start this review because you've used your available PR reviews for now.

Your plan currently allows 1 review/hour. Refill in 6 minutes and 59 seconds.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more review capacity refills, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than trial, open-source, and free plans. In all cases, review capacity refills continuously over time.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d89a1aa9-ba5d-4b18-8953-0bb9a55e0bb1

📥 Commits

Reviewing files that changed from the base of the PR and between 573828e and 1a9cee4.

📒 Files selected for processing (18)
  • .github/workflows/release.yml
  • .github/workflows/test.yml
  • admin/views/dashboard.php
  • admin/views/settings.php
  • admin/views/visitors.php
  • assets/css/admin.css
  • assets/js/sva-charts.js
  • assets/js/sva-maps.js
  • includes/class-sva-admin.php
  • includes/class-sva-db.php
  • includes/class-sva-tracker.php
  • ipquery.php
  • phpcs.xml
  • readme.txt
  • stracini-visitor-analytics.php
  • tests/bootstrap.php
  • tests/unit/DbTest.php
  • tests/unit/TrackerTest.php

Walkthrough

This PR updates all public-facing documentation and branding to reflect the plugin's WordPress.org-compliant directory name "Stracini Visitor Analytics with IpQuery" while preserving all internal code identifiers. Navigation paths are consistently redirected from "IpQuery" menu entries to "Visitor Analytics" throughout user-facing documentation.

Changes

Documentation Branding and Navigation Updates

Layer / File(s) Summary
Brand identity and site metadata
README.md, docs/_config.yml, docs/index.md, readme.txt
Primary heading and site metadata updated from "IpQuery" to "Stracini Visitor Analytics with IpQuery". README includes a note confirming the rename reflects WordPress.org directory naming while internal identifiers remain unchanged.
Installation and setup guidance
docs/installation.md, docs/configuration.md, README.md
Plugin activation name in installation steps and admin settings path both updated to use "Visitor Analytics" prefix. Dashboard and settings navigation paths redirected accordingly.
Feature documentation and audit logs
docs/dashboard.md, docs/visitors.md, docs/privacy.md, readme.txt
Feature pages and privacy policy documentation updated to reference "Visitor Analytics → [Feature]" menu paths instead of "IpQuery → [Feature]". GDPR audit log locations and deletion transparency clauses point to the new "Visitor Analytics → Logs" path. Database table name in readme.txt corrected to wp_stracini_visitor_analytics_visitors.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

  • gstraccini

🐰 A name so shiny, brand new and bright,
From IpQuery's old glow to Visitor Analytics light,
The docs all aligned in tidy refrain,
WordPress-approved heading, no code to restrain! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: updating documentation to reflect the plugin rename to comply with WordPress.org requirements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/rename-plugin

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've left some high level feedback:

  • The docs now refer to the plugin by both the full name (“Stracini Visitor Analytics with IpQuery”) and the shorter admin menu label (“Visitor Analytics”); it may be worth explicitly clarifying this distinction once (e.g., in README or docs/index.md) so users understand why the plugin name and sidebar label don’t exactly match.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- The docs now refer to the plugin by both the full name (“Stracini Visitor Analytics with IpQuery”) and the shorter admin menu label (“Visitor Analytics”); it may be worth explicitly clarifying this distinction once (e.g., in README or docs/index.md) so users understand why the plugin name and sidebar label don’t exactly match.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

🔍 WordPress Plugin Check Report

⚠️ Status: Passed with warnings

📊 Report

🎯 Total Issues ❌ Errors ⚠️ Warnings
2 0 2

⚠️ Warnings (2)

📁 readme.txt (1 warning)
📍 Line 🔖 Check 💬 Message
0 readme_parser_warnings_trimmed_short_description The "Short Description" section is too long and was truncated. A maximum of 150 characters is supported.
📁 includes/class-sva-db.php (1 warning)
📍 Line 🔖 Check 💬 Message
399 PluginCheck.Security.DirectDB.UnescapedDBParameter Unescaped parameter $sql used in $wpdb->get_results()\n$sql assigned unsafely at line 394.

🤖 Generated by WordPress Plugin Check Action • Learn more about Plugin Check

Update the 'Tested up to' WordPress version to 7.0 to reflect
compatibility with the latest release. Bump the stable tag from
1.2.0 to 1.3.0 to denote that the plugin has been updated and
tested with the new WordPress version. These changes ensure
users are informed about the plugin's current compatibility
and stability status.
docs: update plugin name and data storage details

Update the plugin name from "IpQuery" to "Stracini Visitor
Analytics with IpQuery" for consistency with branding. Modify
the description to include the full plugin name instead of just
"IpQuery". Change the database storage table reference from
`wp_ipquery_visitors` to `wp_stracini_visitor_analytics_visitors`
to reflect the updated plugin name. These changes improve the
clarity and coherence of the documentation.
Rename all class, file, and variable references from IpQuery to SVA
to better reflect the Stracini Visitor Analytics branding. This includes
renaming database tables, AJAX actions, and other identifiers.

These changes ensure consistent naming following the rebranding, and maintain
compatibility across references in code and configurations.
Refactor code to transition from 'IpQuery' branding to 'SVA'
(Stracini Visitor Analytics). Update file names, variables, CSS
selectors, HTML classes, and function names throughout the codebase.
This change aligns the code with the plugin's new name and branding,
providing a consistent experience for users and improving maintainability.
Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

New security issues found

Comment thread admin/views/visitors.php
Comment thread admin/views/visitors.php
Comment thread admin/views/visitors.php
Comment thread admin/views/visitors.php
Comment thread admin/views/visitors.php
Comment thread admin/views/visitors.php
Comment thread admin/views/visitors.php
Revert stable version tag in `readme.txt` from 1.3.0 to 1.2.0 to match
the current plugin version. Correct the spelling of "analyze" in both
`readme.txt` and `stracini-visitor-analytics.php` for consistency with
American English. These changes ensure clarity and consistency across
documentation and versioning.
Update phpcs.xml to reflect the renaming of the plugin from
IpQuery to Stracini Visitor Analytics with IpQuery. Change
the ruleset name, description, main file reference, and text
domain to align with the new plugin identity. These changes
ensure consistency across the configuration following the
plugin's rebranding.
@sonarqubecloud
Copy link
Copy Markdown

Quality Gate Failed Quality Gate failed

Failed conditions
1 Security Hotspot
8.5% Duplication on New Code (required ≤ 3%)
B Reliability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

@guibranco guibranco merged commit c06b5e6 into main May 23, 2026
15 of 16 checks passed
@guibranco guibranco deleted the feature/rename-plugin branch May 23, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

☑️ auto-merge Automatic merging of pull requests (gstraccini-bot)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants