blockparty-post-sharing/readme.txt at develop · BeAPI/blockparty-post-sharing · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
=== Blockparty Post Sharing ===
Contributors:      beapi
Tags:              block, share, social, gutenberg, clipboard
Requires at least: 6.8
Tested up to:      6.8
Requires PHP:      8.1
Stable tag:        1.1.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Add a Gutenberg block to copy and share the current post URL in one click.

== Description ==

Blockparty Post Sharing lets editors add sharing actions to posts via the block editor. Visitors can copy the article link to the clipboard or open the native share sheet of their device when supported.

When the Web Share API is unavailable, the Share button opens a fallback menu with Facebook, X, Bluesky, LinkedIn, and WhatsApp. Themes and plugins can customize that list with the `blockparty_post_sharing_networks` filter.

= Features =

* Native Gutenberg block
* Copy link with visual and screen reader feedback
* Native share via the Web Share API when available
* Social fallback menu when the Web Share API is unavailable
* Editable button labels
* Configurable copied-state label
* Icons via CSS custom properties
* Responsive display settings for desktop and mobile
* Multilingual support

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/blockparty-post-sharing` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Open a post in the block editor and add the **Post Sharing Button** block.

== Frequently Asked Questions ==

= Does the Share button work on every browser? =

When the browser supports the Web Share API, the native share sheet is used. Otherwise, a fallback menu with social networks is shown.

= Can I change the social networks in the fallback menu? =

Yes. Use the `blockparty_post_sharing_networks` filter. See the plugin README for examples.

= Can I customize icons and menu styles? =

Yes. CSS custom properties on `.wp-block-blockparty-post-sharing-button` let you override icons, colors, paddings, and borders.

== Changelog ==

= 1.1.0 =
* Add a social share fallback menu when the Web Share API is unavailable (Facebook, X, Bluesky, LinkedIn, WhatsApp).
* Make share networks filterable via `blockparty_post_sharing_networks`.
* Style the fallback menu with CSS custom properties and network icons.
* Load plugin classes without Composer for manual installs.

= 1.0.0 =
* Initial release with copy and share buttons, editable labels, icons, responsive display settings, and WordPress Playground blueprint.