Message Bridge for Contact Form 7 and VK

Message Bridge for Contact Form 7 and VK sends Contact Form 7 submissions to VKontakte users through a connected VK community. The number of VK recipients is not limited by the plugin: users subscribe to messages from the connected community, and the community acts as the notification bridge. To set up delivery:

1. Create a VK community that will send the notifications.
2. In the VK community settings, open Community management > Messages and enable community messages.
3. Open Advanced > API usage, go to the LongPoll API tab, enable LongPoll API, and select API version 5.199 from the dropdown.
4. Switch to Event types and enable Incoming messages.
5. Open the Access keys tab and create a community access token with permission to use community messages.
6. Open the Callback API tab and copy the group_id value.
7. In the plugin interface, click Create Bot.
8. Enter the Group ID, save the access token, or use the Copy PHP const controls to keep these values in PHP constants. Then wait for the bot status to become online. Configured and working bots are shown in blue.
9. Ask each VK recipient to open the community messages and send start to the community.
10. Approve or reject each subscription request in the plugin interface.
11. Create a channel in the plugin interface to connect specific Contact Form 7 forms with the VK bot/community that should send their notifications.

Hooks Filter cf7vk_skip_delivery Return a truthy value to stop delivery for the current Contact Form 7 submission before channels and messages are resolved. Arguments: $skip (bool), $contact_form (WPCF7_ContactForm), $submission (WPCF7_Submission). Filter cf7vk_unfiltered_message Filters the Contact Form 7 mail body after mail-tag replacement and before VK-specific formatting. Arguments: $message (string), $submission (WPCF7_Submission). Filter cf7vk_prepared_message Filters the formatted VK notification text before it is passed to the linked delivery channels. Arguments: $prepared_message (string), $submission (WPCF7_Submission), $contact_form (WPCF7_ContactForm), $mail (array). Action cf7vk_channel_sendout Fires when a channel starts processing a prepared outgoing message, before bot and chat availability checks. Arguments: $channel (iTRON\cf7Vk\Channel), $message (string), $context (array). Action cf7vk_delivery_exception Fires when delivery relation lookup, chat status lookup, or VK transport delivery fails. The $chat argument can be null for relation lookup errors. Arguments: $exception (Throwable), $channel (iTRON\cf7Vk\Channel), $chat (?iTRON\cf7Vk\Chat), $context (array).

1.0.0

• Added stability hardening for plugin lifecycle, activation, deactivation, uninstall cleanup, relation repair, log retention, and migration recovery.
• Added a VK gateway contract with fake transport coverage, sanitized diagnostics, transactional credential validation, safer Long Poll cursor handling, and per-recipient delivery results.
• Improved Contact Form 7 delivery continuity so one failed VK recipient does not stop later eligible recipients.
• Hardened the React admin interface with typed REST errors, paginated resource loading, retry-only failed resources, safer mutation sequencing, error boundaries, and page-scoped styles.
• Migrated the admin asset build to WordPress Scripts with generated asset metadata for dependency and cache-busting accuracy.
• Added release verification gates for deterministic ZIP builds, dependency audits, Plugin Check, WordPress lifecycle/support matrix, real REST/admin smoke, authenticated browser smoke, and fake VK form delivery E2E.
• Updated the release workflow so GitHub release publication verifies the ZIP first; prereleases update plugin-dist, while stable releases deploy the verified build to WordPress.org and then update stable.

0.1.4

• Added PHP constant support and admin copy helpers for VK access tokens and group IDs.
• Expanded VK community setup documentation and corrected the documented delivery hooks.
• Added a WordPress Playground blueprint for installing Contact Form 7 and the latest stable plugin build.

0.1.3

• Clarified the WP Data Logger integration hook and aligned the localized admin script object with the plugin prefix.

0.1.2

• Updated bundled dependencies and REST endpoint permissions for WordPress.org review.

0.1.1

• Updated plugin metadata, naming, external service disclosures, and release packaging for WordPress.org review.

0.1.0

• Bootstrap plugin shell created from the reference architecture.
• React admin shell, CPTs, relations, settings page, and migration scaffolding added.
• VK API wrapper, bot ping endpoint, Long Poll bootstrap sync, and outbound send primitive added.
• Manual Long Poll dialog discovery, VK chat model sync, and CF7 plain-text formatter added.
• Delivery is restricted to active dialogs, and the admin UI now exposes copyable auth commands and channel title editing.