Title: Share Target
Author: Felix Arntz
Published: <strong>6 Ibrir 2021</strong>
Last modified: 6 Ibrir 2021

---

Search plugins

![](https://ps.w.org/share-target/assets/banner-772x250.png?rev=2509752)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/share-target/assets/icon-256x256.png?rev=2509752)

# Share Target

 By [Felix Arntz](https://profiles.wordpress.org/flixos90/)

[Download](https://downloads.wordpress.org/plugin/share-target.1.0.0-beta.1.zip)

 * [Details](https://kab.wordpress.org/plugins/share-target/#description)
 * [Reviews](https://kab.wordpress.org/plugins/share-target/#reviews)
 *  [Installation](https://kab.wordpress.org/plugins/share-target/#installation)
 * [Development](https://kab.wordpress.org/plugins/share-target/#developers)

 [Support](https://wordpress.org/support/plugin/share-target/)

## Description

By using this plugin, you can share content like images, media, URLs and text directly
to your WordPress site from a [capable device and browser](https://caniuse.com/web-app-manifest).
For example, you can share a photo that you just took on your phone to your WordPress
site in the same way that you would otherwise share it with your friends in a native
messaging app.

When you share content to your WordPress site using this plugin, it will automatically
start a new block editor draft post with it; you can then just add anything else
you like, or immediately publish it as is. For certain use-cases, e.g. an image 
blog, creating a post with the shared image might be everything that’s needed before
publishing right away!

To name a few other examples of what you can share to your WordPress site using 
this plugin, think about audio and video files, short text notes, Spotify playlists–
basically anything that you can share from an app on your phone you can now also
share directly to your WordPress site.

#### Requirements

In order to use this plugin, you will also need to install and activate the [PWA plugin](https://wordpress.org/plugins/pwa/),
which provides the basic infrastructure for your site to become a PWA.

#### Usage

With both plugins active, once you visit your site on a [capable device and browser](https://caniuse.com/web-app-manifest),
you should see a prompt (via the PWA plugin’s functionality) to add the plugin to
your home screen (e.g. similar to an app on your phone).

Once you have added your website to the home screen of your device, it should be
available as a target when sharing any content from that device, e.g. a photo or
a URL.

When you share something to your WordPress site, the installed PWA of your website
should open. You should then (potentially after logging in) land directly on a new
post in the block editor where the shared content has already been added. If you
are sharing a media file (e.g. an image or video file), it will be automatically
added to your site’s media library.

#### Background information

This plugin is powered by the Web Share Target API. The [Web Share Target API](https://web.dev/web-share-target/)
is a modern browser API which allows sharing images, media, URLs and basic text 
content directly to your website, relying on the regular sharing UI that is for 
example integrated in your phone. [See here for more technical background information about the Web Share Target API.](https://w3c.github.io/web-share-target/)

#### Third-party developer API

The Share Target plugin allows other plugins to integrate with it. You can customize
what should happen with incoming shared content when it arrives in the block editor,
conditionally overriding the default behavior of the plugin.

In PHP, enqueue your custom JavaScript file. Make sure to include the `share-target`
script in its dependencies. For example:

    ```
    wp_enqueue_script(
      'my-share-target-handler',
      '/assets/js/my-share-target-handler.js',
      array( 'share-target' )
    );
    ```

In your JavaScript file you can then add your custom share handler using the following
function:

**`wp.shareTarget.registerShareHandler( options )`**

Registers a new share handler for incoming shared data.

Parameters:

 * `options`: _(Object) (required)_ Handler options.
 * `options.handle`: _(Function) (required)_ Share handler function. Must be asynchronous
   and accept an object with properties `title`, `description`, `link` (each strings),
   and `attachment` (object). Any of these may be undefined. Depending on the data,
   the function should decide whether to handle it and if so run the necessary logic
   and return true, to stop following handlers from being called. Otherwise, it 
   should return false.
 * `options.priority`: _(number) (optional)_ Priority for the handler. A lower number
   means higher priority, like for WordPress hooks. Default is 10.

The following example handles any shared Spotify content and embeds it into the 
post:

    ```
    // Matches a shared Spotify URL.
    const spotifyRegex = /^https:\/\/open\.spotify\.com/;

    wp.shareTarget.registerShareHandler( {
      handle: async ( { link, attachment } ) => {
        // Do not handle if a media file is being shared.
        if ( attachment ) {
          return false;
        }

        // If a shared Spotify URL, embed it.
        if ( link && link.match( spotifyRegex ) ) {
          wp.data.dispatch( 'core/block-editor' ).insertBlocks( [
            wp.blocks.createBlock( 'core/embed', {
              url: link,
              type: 'rich',
              providerNameSlug: 'spotify',
              responsive: true,
            } ),
          ] );
          return true;
        }

        // Otherwise fall back to other handlers.
        return false;
      },
      priority: 5,
    } );
    ```

## Screenshots

 * [[
 * Sharing media and text from a notes app on the phone directly into a WordPress
   site about cocktails
 * [[
 * The shared content from the other screenshot as initially displayed in the block
   editor, with only one click left to publish

## Installation

**Make sure you have the [PWA plugin](https://wordpress.org/plugins/pwa/) installed
before using the Share Target plugin.**

 1. Upload the entire `share-target` folder to the `/wp-content/plugins/` directory
    or download it through the WordPress backend.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress.

## FAQ

### Why does my website not show up as a target for shared content?

In order for your website to show up in your device’s integrated sharing UI, you
need to install your website as a PWA on your device. Make sure to use a [browser and OS that supports adding your website as a PWA to your homescreen](https://caniuse.com/web-app-manifest).

### Where should I submit my support request?

For regular support requests, please use the [wordpress.org support forums](https://wordpress.org/support/plugin/share-target).
If you have a technical issue with the plugin where you already have more insight
on how to fix it, you can also [open an issue on Github instead](https://github.com/felix-arntz/wp-share-target/issues).

### How can I contribute to the plugin?

If you have some ideas to improve the plugin or to solve a bug, feel free to raise
an issue or submit a pull request in the [Github repository for the plugin](https://github.com/felix-arntz/wp-share-target).
Please stick to the [contributing guidelines](https://github.com/felix-arntz/wp-share-target/blob/main/CONTRIBUTING.md).

You can also contribute to the plugin by translating it. Simply visit [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/share-target)
to get started.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Share Target” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ Felix Arntz ](https://profiles.wordpress.org/flixos90/)

[Translate “Share Target” into your language.](https://translate.wordpress.org/projects/wp-plugins/share-target)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/share-target/), check
out the [SVN repository](https://plugins.svn.wordpress.org/share-target/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/share-target/) by
[RSS](https://plugins.trac.wordpress.org/log/share-target/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0-beta.1

 * Initial beta release

## Meta

 *  Version **1.0.0-beta.1**
 *  Last updated **5 n iseggasen ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.2 or higher **
 *  Tested up to **5.7.15**
 *  PHP version ** 7.0 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/share-target/)
 * Tags
 * [image](https://kab.wordpress.org/plugins/tags/image/)[media](https://kab.wordpress.org/plugins/tags/media/)
   [sharing](https://kab.wordpress.org/plugins/tags/sharing/)[web](https://kab.wordpress.org/plugins/tags/web/)
 *  [Advanced View](https://kab.wordpress.org/plugins/share-target/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/share-target/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/share-target/reviews/)

## Contributors

 *   [ Felix Arntz ](https://profiles.wordpress.org/flixos90/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/share-target/)