=== Pushlab Social Widgets for VK ===
Contributors: pushlab
Tags: vkontakte, social, comments, like, share
Requires at least: 5.6
Tested up to: 7.0
Stable tag: 1.4.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds VKontakte widgets to your website: comments, like, and share buttons.

== Description ==

**Pushlab Social Widgets for VK** is a simple and convenient way to integrate VKontakte widgets into your WordPress website.

= Widgets =

* **VKontakte Comments** - Full-featured comment block with support for graffiti, photos, videos, audio, and links.
* **Like Button** - Allows users to like your posts.
* **Share Button** - Helps distribute content on the VKontakte social network.

= Key Features =

* Automatic replacement of standard WordPress comments with VKontakte comments.
* Replacement of WooCommerce reviews with VKontakte comments (optional).
* Automatic insertion of Like and Share buttons before or after post content.
* Flexible settings for each widget (comment count, sizes, button text, design).
* Shortcode support: [pswv_comments], [pswv_like], [pswv_share] for placement anywhere.
* Ability to create a custom Share button with customizable colors, text, and padding.
* Full multisite compatibility.

= Requirements =

* VK ID application ID (obtained from VK ID Business)
* PHP 7.4 or higher

= External services =

This plugin connects to external services provided by VKontakte (VK.com) to display widgets:

1. **VK OpenAPI** (`https://vk.com/js/api/openapi.js?169`)
   - Used for: Initializing VK widgets (comments and like buttons)
   - Data sent: No personal data is sent. The API loads the VK widget code and requires only the application ID for initialization.
   - When: Every time a page with VK widgets is loaded.
   - Service provider: VKontakte (VK.com)
   - Terms of Service: https://vk.com/terms
   - Privacy Policy: https://vk.com/privacy

2. **VK Share API** (`https://vk.com/js/api/share.js?95`)
   - Used for: Displaying the share button
   - Data sent: No personal data is sent. The script loads the share button interface.
   - When: Every time a page with the share widget is loaded.
   - Service provider: VKontakte (VK.com)
   - Terms of Service: https://vk.com/terms
   - Privacy Policy: https://vk.com/privacy

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ or install via WordPress admin.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to the Widgets for VK menu section in the admin panel.
4. Enter your VK ID application ID.
5. Enable the desired widgets and configure their parameters.
6. Save the settings.

To replace standard WordPress comments or WooCommerce reviews, enable the corresponding option in the Comments widget settings.

Shortcodes can be used in any posts, pages, or widgets through the editor.

== Frequently Asked Questions ==

= Where can I get the VK ID application ID? =

1. Go to https://id.vk.com/about/business/go/
2. Create a new application or select an existing one.
3. Copy the numeric application ID.

= Why aren't the widgets displaying? =

Check that:
* The correct application ID is entered.
* At least one widget is enabled in the settings.
* For comments - if using replacement, the replacement option is enabled in the widget settings.
* The page is allowed to display (for posts, "Display in posts" should be enabled).

= Can I use the plugin without an application ID? =

No, all VKontakte widgets require an application ID.

= Is it compatible with caching plugins? =

Yes, the plugin works correctly with most caching plugins (WP Rocket, W3 Total Cache, etc.). However, when using comment replacement, make sure the page with comments is not fully cached, or use dynamic caching.

= Does the plugin support multisite? =

Yes, the plugin is fully compatible with WordPress Multisite. Settings are stored separately for each site in the network, and when the plugin is deleted, all options are removed from all blogs.

== Screenshots ==

1. Plugin main settings page.
2. Comments widget settings.
3. Like widget settings.
4. Share widget settings with custom button options.

== Changelog ==

= 1.4.0 =
* Plugin renamed to "Pushlab Social Widgets for VK" to comply with trademark guidelines.
* Improved code security and standards.
* Added external services documentation.
* Fixed enqueuing of JavaScript files.

= 1.3.6 =
* Fixed security of custom Share button output.
* Improved compatibility with WordPress 7.0.

== Upgrade Notice ==

= 1.4.0 =
Important update with renamed plugin name and improved security. Please update to continue receiving support.