WebPing

A simple WordPress plugin that provides a web-accessible ping endpoint. Visitors submit an auth code and phone number; if the code matches the admin-configured value, an email notification is sent.

---

✨ Features

• Public form at /webping — no login required
• GET request support — trigger a ping via URL parameters, perfect for bookmarks or automated calls
• Admin settings page — configure the auth code and notification email under Settings → WebPing
• Silent validation — always shows "Submission received" regardless of whether the auth code matched
• Auto-creates page on activation, cleans up on deactivation

---

📦 Installation

1. Copy the webping folder into your WordPress wp-content/plugins directory, or upload the ZIP via Plugins → Add New → Upload Plugin.
2. Activate WebPing under Plugins → Installed Plugins.
3. Go to Settings → WebPing and configure your auth code and notification email.

---

🚀 Usage

Admin Configuration

Navigate to Settings → WebPing and set:

Field	Description
Auth Code	The secret code a visitor must submit to trigger a ping
Notification Email	The email address that receives ping notifications

Public Form

Visit /webping on your site. The form has two fields:

• Auth Code — the visitor enters a code
• Phone Number — the visitor enters their phone number

On submission, the visitor always sees "Submission received."

Behind the scenes, if the submitted auth code matches the admin-configured code, an email is sent to the configured address:

• Subject: webping
• Body: <phone number> accessed your webping

GET Request

You can also trigger a ping via URL parameters — no form needed:

https://your-site.com/webping/?authcode=YOUR_CODE&phone=5551234567

This makes it easy to create bookmarklets, shortcuts, or automated calls.

---

🔧 Developer Notes

• Shortcode — the plugin uses [webping] which is placed on the auto-created /webping page. You can move the shortcode to any page if needed.
• Email delivery — uses WordPress wp_mail(), so delivery depends on your site's mail configuration (SMTP plugin recommended for production).
• No database tables — settings are stored in the WordPress options table (webping_authcode and webping_email).

---

📬 Support

Questions or ideas? Email dan@fishdan.com.

---

📝 License

MIT.