=== SceneSat Embeds ===
Tags: video, live streaming, embed, chat, demoscene
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed SceneSat live streams, connected chat and archived videos by pasting a link. Responsive players, no settings or API keys.

== Description ==

Paste a supported SceneSat link into an empty paragraph, an Embed block, or the SceneSat block in the block inserter. The Classic Editor also accepts a link on its own line.

* Live video with responsive sizing and aspect ratios.
* Chat beside or below a live video, or chat on its own.
* Published video recordings from scenesat.com/video-recordings and legacy videoarchive links.
* Tools > SceneSat Embeds provides instructions inside WordPress.

Live links come from https://control.scenesat.com/player.html. Copy a recording's page URL from https://scenesat.com/video-recordings for archived video. The live picker lets you choose dimensions, playback options and chat layout. Chat posting follows the visitor's signed-in session and conversation permissions; Open chat is available when the browser cannot use the session in an iframe.

Recorded audio shows, including guest shows, are not supported by this version. Their links will be supported when SceneSat provides their public embed players. No placeholder blocks or inactive settings are installed.

=== External services ===

This plugin registers SceneSat as an oEmbed provider. When an author inserts a supported link, WordPress sends that URL and preferred dimensions to https://control.scenesat.com/api/oembed (live video/chat) or https://scenesat.com/api/oembed (archived video). WordPress caches the returned embed markup. Visitors' browsers then load the player and, if selected, chat from SceneSat's services. SceneSat receives the normal web requests needed to serve these features, including the visitor's IP address and browser information. Signing in and posting are handled by SceneSat, not by this plugin.

The plugin adds no analytics and stores no credentials or plugin settings.
Service: https://scenesat.com/
Terms: https://scenesat.com/terms
Privacy: https://scenesat.com/privacy

== Installation ==

1. Download scenesat-embeds.zip from https://cosmodrome.scenesat.com/wordpress. Keep it zipped.
2. In WordPress, open Plugins > Add New > Upload Plugin.
3. Select the ZIP, click Install Now, then Activate Plugin.
4. Paste a supported SceneSat link into your post or page.

You need permission to install plugins. On managed hosting, ask the site administrator if Upload Plugin is unavailable. No SceneSat account is required to install the plugin or show public recordings.

For a manual installation, copy the scenesat-embeds folder into wp-content/plugins and activate SceneSat Embeds. If you previously installed scenesat-embeds.php in mu-plugins, activate this plugin first and then remove the old helper. Existing embed URLs keep working.

To update a Cosmodrome installation, upload the newer ZIP through Upload Plugin and choose Replace current with uploaded. The plugin does not run its own update service. It has not yet been published in the WordPress.org directory.

== Frequently Asked Questions ==

= Do I need to configure anything? =
No. Activation enables supported links. Find the instructions under Tools > SceneSat Embeds.

= Why does an existing link still say it cannot be embedded? =
WordPress caches unsuccessful lookups too. Delete the old embed and paste the link again. The stream or recording must be public and available.

= Can I use iframe code instead? =
Yes, in a Custom HTML block where your WordPress permissions allow it. This plugin makes ordinary link embeds work without copying HTML.

= Will it work on every WordPress host? =
The site must allow plugin installation and external embeds. A hosting plan or administrator may restrict these features.

== Changelog ==

= 1.1.0 =
Installable ZIP, SceneSat block variation, in-dashboard help and archived-video providers.

= 1.0.0 =
Initial live-stream and chat oEmbed helper.
