WP Manifestindependent plugin directory
manifest / admin / wp-telepilot

WP Telepilot WP Registry grade B. Medium-severity findings · 1 findingWP RegistryMedium-severity findings · 1 findingOpen the reportB

Remote Administration for your WordPress site via Telegram

★ 1stars
12release downloads
v0.3.0latest · 2mo ago

Install

Download wp-telepilot-0.3.0.zip From the v0.3.0 release on GitHub, Jul 28, 2026

Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/alefsolutions/wp-telepilot/releases/download/v0.3.0/wp-telepilot-0.3.0.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

WP Telepilot Header

WP Telepilot is a Telegram-first WordPress operations plugin for site owners and administrators who want a secure way to review site activity and perform structured actions from chat.

It links an approved Telegram account to a WordPress user, shows capability-aware menus, and gives admins a practical command surface for day-to-day operations without trying to turn Telegram into a full replacement for wp-admin.

Highlights

  • Secure Telegram-to-WordPress account linking with short-lived one-time codes
  • Webhook mode with polling fallback for environments where direct Telegram delivery is unreliable
  • Role-aware menus and actions based on the linked WordPress user's actual capabilities
  • Command groups for posts, pages, comments, media, users, plugins, categories, tags, notifications, and site settings
  • Search, pagination, confirmations, and audit logging across the main management flows
  • Guided post creation with in-chat follow-up actions
  • Guided page creation with title-first flow and optional slug or status updates later
  • Inline post category selection so users do not have to memorize category IDs
  • Category-driven post creation, including creating a new draft directly from a chosen category
  • Secure browser handoff for long-form post editing when chat is not the right editing surface
  • Transport diagnostics for webhook health, polling health, queue activity, stale updates, and delivery failures
  • Privacy integrations for WordPress personal-data export and erasure workflows

What You Can Do

  • Link a Telegram user to a WordPress user and restrict access with an allowed chat list
  • Open /menu for a capability-aware Telegram command hub
  • Review site status with /site
  • Create, review, update, publish, draft, trash, restore, and browser-edit posts
  • Create, review, update, publish, draft, trash, restore, and preview pages
  • Review and manage comments, users, plugins, categories, and tags
  • Manage Telegram notification preferences from chat
  • Update selected site settings from Telegram with controlled validation
  • Inspect transport health and operational diagnostics from the WordPress admin panel

Installation

  1. Install and activate WP Telepilot in WordPress.
  2. Create a Telegram bot with BotFather.
  3. Open WordPress Admin -> WP Telepilot.
  4. Paste the Telegram bot token into the settings page.
  5. Choose Webhook or Polling Fallback.
  6. Save the settings so WP Telepilot can sync transport details.
  7. Generate a one-time link code from the user's WordPress profile.
  8. In a private chat with the bot, send /link CODE.
  9. Use /menu, /site, or /help to begin.

Core Telegram Flows

  • /start shows onboarding and current chat details
  • /menu opens the command hub
  • /help shows the available command surface
  • /chatid shows the current Telegram chat ID
  • /posts new starts a guided draft-creation flow
  • /pages new starts a guided draft page flow
  • /posts categories POST_ID opens the inline category picker for an existing post
  • /categories post TERM_ID starts a new post with that category preselected
  • /notifications list reviews Telegram alert preferences

For the full command surface, syntax, and examples, see COMMANDS.md.

Transport Modes

Webhook

Webhook mode is the preferred option for near-real-time Telegram replies. In this mode, Telegram sends updates directly to the WP Telepilot REST endpoint, and WP Telepilot validates the configured webhook secret before processing the request.

Polling Fallback

Polling fallback is available for sites where webhooks are blocked, delayed, challenged by infrastructure, or otherwise unreliable. In this mode, WP Telepilot checks Telegram for updates through scheduled jobs instead of waiting for inbound webhook delivery.

Security And Reliability

  • Link codes are short-lived and stored server-side
  • Sensitive actions are restricted to private chats
  • Webhook requests validate the Telegram secret header
  • Duplicate Telegram updates are ignored
  • Stale Telegram updates are dropped
  • Background queue processing is used for slower operations
  • Polling uses a lock to prevent overlapping workers
  • Destructive actions require confirmation
  • Audit records are written for linking, moderation, content actions, and delivery events

Admin Panel

From the WP Telepilot settings page, administrators can:

  • configure the bot token
  • choose webhook or polling transport
  • manage the webhook secret
  • restrict allowed chat IDs
  • enable or disable user linking to Telegram
  • review webhook and worker diagnostics
  • inspect queue, cron, schema, and database readiness
  • refresh webhook status
  • poll Telegram manually when polling mode is enabled
  • process queued jobs
  • flush pending Telegram updates
  • select one or many types of notifications or alerts they want to receive via Telegram.

Privacy And External Services

WP Telepilot connects to the Telegram Bot API only after an administrator configures a bot token.

When enabled, the plugin may send:

  • the configured bot token as part of authenticated Bot API requests
  • Telegram user and chat identifiers required to route responses
  • webhook registration details in webhook mode
  • response payloads generated from WordPress data that an authorized linked user explicitly requested

WordPress privacy-policy helper text, exporter callbacks, and eraser callbacks are included for linked Telegram data.

Telegram is a third-party service:

Requirements

  • WordPress 6.6 or newer
  • PHP 8.0 or newer
  • HTTPS for webhook mode
  • Current plugin line: 0.3.0

Project Status

WP Telepilot is currently in the 0.3.0 stable release line. The focus now is operational reliability, clear Telegram workflows, and incremental refinement toward the next feature cycle.

Product Direction

WP Telepilot is designed around a simple principle:

Telegram is for awareness, decisions, and short actions. WordPress remains the place for long-form editing, visual design, and complex configuration.

License

WP Telepilot is licensed under the GNU General Public License, version 2 or later, the same license used by WordPress.

Releases

7 releases. Each count is every asset in that release; expand a row for the breakdown.

Tag
Published
Assets
Downloads
v0.3.0 latest
Jul 28, 2026 2mo ago
wp-telepilot-0.3.0.zip
6
Jul 28, 2026 2mo ago
wp-telepilot-0.3.0-beta.5.zip
0
Jul 17, 2026 3mo ago
wp-telepilot-0.3.0-beta.4.zip
1
Jul 15, 2026 3mo ago
wp-telepilot-0.3.0-beta.3.zip
3
Jul 15, 2026 3mo ago
wp-telepilot-0.3.0-beta.2.zip
1
Jul 14, 2026 3mo ago
wp-telepilot-0.3.0-beta.1.zip
1
Jul 13, 2026 3mo ago
wp-telepilot-0.2.2.zip
0
B grade

Security

WP Telepilot 0.3.0 · audited by WP Registry

Medium-severity findings.

1 medium
Audited release
0.3.0
Findings
1
Worst severity
medium
Content hash
f7c590e1464e49eeecf44de7…

Findings

  • medium Webhook REST skips authentication when webhook_secret is empty

    missing_auth

    handle_webhook uses permission_callback __return_true and only rejects when secret is non-empty and mismatches: `if ( '' !== $secret && ! hash_equals( $secret, $header ) )`. If telepilot_settings['webhook_secret'] is an empty string at request time (misconfiguration, failed migration, or option wiped), any unauthenticated client can POST Telegram-shaped updates into queue_or_process_update, causing job/queue noise and probing linked-user command flows. Worker endpoint correctly requires a non-empty secret.

    includes/class-rest-webhook-controller.php:35-84

    Recommendation

    Fail closed: if webhook mode is active and secret is empty, return 403. Prefer permission_callback that validates the Telegram secret header before entering the handler.

WP Registry hashes the installable build and reports on that exact bytes-for-bytes copy. Embargoed findings are withheld until they are disclosed, so a clean verdict means nothing public is outstanding. WP Manifest does not audit code itself.