GameQuery Server Lists

Description

GameQuery Server Lists is a free, open-source WordPress plugin released under GPL-2.0-or-later.
It is built for gaming blogs and community websites that want a fast, reliable way to promote game servers.

With this plugin, a site owner can add server addresses, select the game, and publish a server list in minutes.
Lists can be embedded anywhere with shortcodes and integrated in widget areas across pages.

WordPress admins can embed lists with:

  • [wpgs_list_123]
  • [wpgs_list id="123"]

Key features include:

  • One-click secure GameQuery account connection with API key selection.
  • Multi-game list support with templates and background refresh via WP-Cron.
  • Built-in analytics for views and clicks.
  • Campaign goal automation that can auto-hide a server list after owner-defined click/view limits are reached.

External services

This plugin connects to GameQuery services for account connection, server data fetching, and game catalog lookup.

  1. GameQuery API (https://api.gamequery.dev) is used to fetch server payload data and the games catalog.

    • Data sent on server fetch requests: configured game_id values, configured server IP:PORT values, API account email, API token, and selected API plan.
    • Data sent on games catalog requests: no user identifiers or personal data; only a GET request for available games.
    • Trigger: when list cache is refreshed (WP-Cron or cache miss) and when games catalog cache refreshes.
    • Terms of Service: https://gamequery.dev/terms-of-service
    • Privacy Policy: https://gamequery.dev/privacy-policy
  2. GameQuery account service (https://gamequery.dev) is used when an admin connects an account from plugin settings.

    • Data sent: site URL, admin URL, plugin version, PKCE/session metadata, and temporary authorization/session tokens during the connect flow.
    • Trigger: only after an admin clicks the connect button.
    • Terms of Service: https://gamequery.dev/terms-of-service
    • Privacy Policy: https://gamequery.dev/privacy-policy

Screenshots

Installation

  1. Upload plugin files to /wp-content/plugins/gamequery-servers-lists, or install through your deployment process.
  2. Activate the plugin through the “Plugins” screen in WordPress.
  3. In WPGS -> Settings, connect your account with the one-click GameQuery popup (or use manual credentials).
  4. Create lists in WPGS -> Lists.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“GameQuery Server Lists” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.1.6

  • Security: stop pre-filling the API token field in Settings; the stored value is no longer echoed into the HTML. A “(saved)” indicator and optional “Clear saved token” checkbox replace the old behavior.
  • Security: restrict the Account Base URL and API Base URL settings to gamequery.dev hosts by default and block loopback/private/link-local targets. Define WPGS_ALLOW_CUSTOM_API_URL in wp-config.php to opt-in to custom hosts for staging/dev setups.
  • Security: require https:// for the default GameQuery endpoints and reject URLs containing embedded credentials.

0.1.5

  • Remove per-list Custom CSS input and all frontend <style> injection paths.
  • Replace admin inline <script> blocks with wp_enqueue_script() + wp_add_inline_script().
  • Move admin menu to a lower position in the WordPress sidebar.
  • Escape stats progress bar output at render time with wp_kses().
  • Prefix shortcode names to wpgs_list and wpgs_list_{id}.
  • Add explicit external service disclosure with data usage plus Terms/Privacy links.

0.1.4

  • Replace browser datalist behavior with a dedicated searchable game selector in Server Groups.
  • Add manual Game ID override support while keeping automatic game-name to game-id mapping.
  • Store the games catalog in WordPress DB and refresh it every 7 days.
  • Update manual Game ID placeholder example to minecraft.

0.1.3

  • Add secure one-click GameQuery account connect flow with popup key selection.
  • Add plugin account base URL setting for the connect flow.
  • Harden connect security with ownership confirmation, endpoint rate limits, and connection alerts.
  • Lock plan field to auto-detected value and auto-correct stale plan settings during API fetch.
  • Improve Stats page with status filtering, search, and trash actions (single + bulk).

0.1.2

  • Add widget support and shortcode rendering improvements.
  • Add campaign goal controls and copy-IP display option.
  • Improve cache-busting for admin/frontend assets.

0.1.1

  • Improve cache-busting for admin/frontend assets.

0.1.0

  • Initial MVP release.