yuiami.jp Media Link Cards

Description

This plugin adds a custom block that lets you search the Apple ecosystem (App Store, Apple Books, Apple Music/iTunes) and embed a rich card with title, artwork, author/artist, preview button, and a store button.

• Supports iPhone/iPad/Mac apps, Apple Books, music tracks, albums, and music videos
• Compatible with Apple affiliate links (PHG token)
• Country and language selection for search
• Adjustable number of search results
• Simple settings page for defaults
• Link check: finds cards whose items are no longer available and shows them without links

External service

This plugin relies on the iTunes Search API, a third-party service provided by Apple, to search the Apple ecosystem, to retrieve the title, artwork, artist and store URL of the item you pick, and to check whether the items you have already embedded are still available. The plugin cannot provide these features without it.

When a request is made. Only in two situations, both started by a logged-in user of your site:

1. In the block editor, when a user with the edit_posts capability types a search term and presses Enter.
2. On the settings page, when an administrator (manage_options capability) clicks “Start scan” under “Link check”. The plugin then looks up the items embedded on your site to find the ones that are no longer available.

Your site’s front end never contacts the service: published posts render from data already stored in your database, so the plugin makes no request to Apple for your visitors. The card artwork is loaded from Apple’s CDN by the visitor’s browser, as with any externally hosted image.

What is sent. For a search: the search term you typed, the content type (app, book, podcast, music, and so on), the store country, the display language, the number of results, and — only if you have entered one yourself — your affiliate token. For a link check: the Apple item IDs stored in your cards (public identifiers assigned by Apple) and the store country. No personal data, and no information about your site or its visitors, is sent.

Caching. Search responses are stored in your own database as transients for 12 hours to reduce the number of requests. Link check results are stored as options until the next scan.

• Search endpoint: https://itunes.apple.com/search
• Lookup endpoint: https://itunes.apple.com/lookup
• About the API: https://performance-partners.apple.com/search-api
• Apple Media Services Terms and Conditions: https://www.apple.com/legal/internet-services/itunes/
• Apple Privacy Policy: https://www.apple.com/legal/privacy/

Affiliate links

This plugin adds no affiliate parameter by default. The PHG token setting is empty after installation, and no token is sent unless you enter your own.

If you join the Apple Services Performance Partner program and enter your own token on the settings page, that token is appended as the at parameter to the store links the block outputs, and to the search requests described above. Only the token you enter is ever used — the plugin never falls back to a token belonging to the author or anyone else. Clearing the field stops the parameter from being added.

• Apple Services Performance Partner program: https://performance-partners.apple.com/

Disclaimer

This plugin is an independent project. It is not affiliated with, endorsed by, or sponsored by Apple Inc.

Apple, App Store, Mac App Store, Apple Books, Apple Music, Apple Podcasts and iTunes are trademarks of Apple Inc., registered in the U.S. and other countries. These names are used here only to describe the services the plugin can link to.