{"id":391026,"date":"2026-11-18T03:13:52","date_gmt":"2026-11-18T03:13:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/miris\/"},"modified":"2026-11-18T03:13:28","modified_gmt":"2026-11-18T03:13:28","slug":"miris","status":"publish","type":"plugin","link":"https:\/\/lin.wordpress.org\/plugins\/miris\/","author":23590733,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.0","stable_tag":"0.1.0","tested":"7.1.5","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"Miris","header_author":"Miris","header_description":"Stream Miris 3D assets in WordPress.","last_updated":"2026-11-18 03:13:28","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/miris.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":57,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.0":{"tag":"0.1.0","author":"miris","date":"2026-11-18 03:13:28","revision":3808496}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3808496,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3808496,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3808496,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3808496,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"miris\/group":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"miris\/group","version":"0.1.0","title":"Miris Group","category":"media","description":"Moves, rotates and scales the streams inside it together.","textdomain":"miris","ancestor":["miris\/scene"],"allowedBlocks":["miris\/stream","miris\/group"],"attributes":{"position":{"type":"array","default":[0,0,0]},"rotation":{"type":"array","default":[0,0,0]},"scale":{"type":"array","default":[1,1,1]}},"supports":{"html":false,"reusable":false,"className":false,"customClassName":false,"__experimentalToolbar":false},"editorScript":"file:.\/index.js","render":"file:.\/render.php"},"miris\/stream":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"miris\/stream","version":"0.1.0","title":"Miris Stream","category":"media","description":"Streams a Miris asset in a scene.","textdomain":"miris","ancestor":["miris\/scene"],"attributes":{"assetId":{"type":"string","default":""},"assetName":{"type":"string","default":""},"position":{"type":"array","default":[0,0,0]},"rotation":{"type":"array","default":[0,0,0]},"scale":{"type":"array","default":[1,1,1]}},"supports":{"html":false,"reusable":false,"className":false,"customClassName":false,"__experimentalToolbar":false},"editorScript":"file:.\/index.js","render":"file:.\/render.php"},"miris\/scene":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"miris\/scene","version":"0.1.0","title":"Miris Scene","category":"media","description":"Stream Miris 3D assets.","keywords":["3d"],"textdomain":"miris","allowedBlocks":["miris\/stream","miris\/group"],"attributes":{"cameraPosition":{"type":"array"},"cameraRotation":{"type":"array"},"controls":{"type":"boolean","default":true},"style":{"type":"object","default":{"dimensions":{"aspectRatio":"16\/9"}}}},"supports":{"align":["wide","full"],"dimensions":{"aspectRatio":true,"minHeight":true},"html":false},"editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","render":"file:.\/render.php"}},"tagged_versions":["0.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[783,15680,1220,582,291429],"plugin_category":[50],"plugin_contributors":[293528],"plugin_business_model":[],"class_list":["post-391026","plugin","type-plugin","status-publish","hentry","plugin_tags-3d","plugin_tags-3d-viewer","plugin_tags-block","plugin_tags-streaming","plugin_tags-webgpu","plugin_category-media","plugin_contributors-miris","plugin_committers-miris"],"banners":{"banner":"https:\/\/ps.w.org\/miris\/assets\/banner-772x250.png?rev=3808496","banner_2x":"https:\/\/ps.w.org\/miris\/assets\/banner-1544x500.png?rev=3808496","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/miris\/assets\/icon-128x128.png?rev=3808496","icon_2x":"https:\/\/ps.w.org\/miris\/assets\/icon-256x256.png?rev=3808496","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Miris streams 3D assets to the browser. This plugin puts them in your WordPress site: pick assets from your Miris account, arrange them in a scene, set up the camera, and publish.<\/p>\n\n<p><strong>Blocks<\/strong><\/p>\n\n<ul>\n<li><strong>Miris Scene<\/strong> holds the scene. It sets the camera and its size, using WordPress's own aspect ratio and minimum height controls.<\/li>\n<li><strong>Miris Stream<\/strong> streams one asset. Search your account's assets by name, then position, rotate and scale it.<\/li>\n<li><strong>Miris Group<\/strong> moves, rotates and scales the streams inside it together.<\/li>\n<\/ul>\n\n<p>The editor shows a live preview of the scene. Move the camera there, then click <strong>Use current view<\/strong> in the block toolbar to save that view.<\/p>\n\n<p><strong>Shortcodes<\/strong><\/p>\n\n<p>For the classic editor, page builders and anywhere else shortcodes work:<\/p>\n\n<pre><code>[miris_scene aspect_ratio=\"16\/9\"]\n[miris_camera controls position=\"0 1.5 6\"]\n[miris_stream uuid=\"ASSET_ID\"]\n[miris_stream uuid=\"ASSET_ID\" position=\"3 0 0\" rotation=\"0 90deg 0\" scale=\"1.5\"]\n[miris_group position=\"-3 0 0\"]\n[miris_stream uuid=\"ASSET_ID\"]\n[\/miris_group]\n[\/miris_scene]\n<\/code><\/pre>\n\n<ul>\n<li><code>[miris_scene]<\/code> takes <code>aspect_ratio<\/code> (default <code>16\/9<\/code>), or <code>min_height<\/code> (a CSS length such as <code>400px<\/code> or <code>60vh<\/code>), and <code>class<\/code>.<\/li>\n<li><code>[miris_camera]<\/code> is optional. <code>controls<\/code> lets visitors move the camera. <code>position<\/code> and <code>rotation<\/code> set the starting view; leave them out to use the asset's default view. Without a <code>[miris_camera]<\/code>, controls are on.<\/li>\n<li><code>[miris_stream]<\/code> takes the asset's <code>uuid<\/code>, plus <code>position<\/code>, <code>rotation<\/code> and <code>scale<\/code>. <code>scale<\/code> can be one number for all three axes.<\/li>\n<li><code>[miris_group]<\/code> takes <code>position<\/code>, <code>rotation<\/code> and <code>scale<\/code>. Groups can't contain other groups.<\/li>\n<\/ul>\n\n<p>Positions and scales are three numbers, x y z. Rotations are three angles in radians, as in the Miris web SDK, or with a CSS angle unit: <code>deg<\/code>, <code>grad<\/code>, <code>rad<\/code> or <code>turn<\/code>.<\/p>\n\n<p>People who can edit a page see a list of any mistakes in its shortcodes, such as an invalid asset ID. Visitors only see the parts that are valid.<\/p>\n\n<p><strong>Requirements<\/strong><\/p>\n\n<ul>\n<li>A Miris account and API key.<\/li>\n<li>A browser with WebGPU, such as current versions of Chrome and Edge.<\/li>\n<li>A site served over HTTPS. Browsers only allow WebGPU on secure pages, so scenes don't display on plain-http sites. The plugin warns you in Site Health, on Settings \u2192 Miris and in the Scene block.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin relies on Miris, a 3D streaming service run by Miris, Inc., and so connects to Miris's servers.<\/p>\n\n<p><strong>Miris API (app.miris.com)<\/strong><\/p>\n\n<ul>\n<li>When you save an API key in Settings \u2192 Miris, your site's server sends the API key to the Miris API to find or create the \"WordPress\" viewer key.<\/li>\n<li>When you search for assets in the block editor, your site's server sends the viewer key and the search text to the Miris API. Asset thumbnails are then loaded by your browser from Miris's content servers.<\/li>\n<li>When a page with a scene is viewed, the visitor's browser sends the viewer key and the scene's asset IDs to the Miris API, and downloads the assets from Miris's content servers. As with any web request, Miris receives the visitor's IP address and browser details.<\/li>\n<\/ul>\n\n<p><strong>Miris web components (cdn.miris.com)<\/strong><\/p>\n\n<ul>\n<li>Scenes are played by the Miris web components, a script and WebAssembly files that the plugin loads from Miris's CDN instead of bundling. Visitors' browsers download them when a page has a scene, and editors' browsers when the block editor opens. Miris receives the visitor's IP address and browser details.<\/li>\n<\/ul>\n\n<p>Miris <a href=\"https:\/\/www.miris.com\/terms-of-use\">terms of use<\/a> and <a href=\"https:\/\/www.miris.com\/privacy-policy\">privacy policy<\/a>.<\/p>\n\n<h3>Source code<\/h3>\n\n<p>The block editor scripts in <code>build<\/code> are compiled with <code>@wordpress\/scripts<\/code> from the source in the plugin's <code>src<\/code> folder.<\/p>\n\n<p>The scene player, the Miris web components, isn't part of the plugin; it's loaded from Miris's CDN as described under External services. It's published as <a href=\"https:\/\/www.npmjs.com\/package\/@miris-inc\/components\">@miris-inc\/components<\/a> on npm. Developers can load another copy with the <code>miris_components_url<\/code> filter.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Go to Settings \u2192 Miris and paste your Miris API key. The plugin creates a viewer key named \"WordPress\" on your Miris account for showing scenes to visitors.<\/li>\n<li>Add a Miris Scene block to a post or page, then pick an asset for its stream in the Streams panel.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"why%20don%27t%20scenes%20show%20up%3F\"><h3>Why don't scenes show up?<\/h3><\/dt>\n<dd><p>Check that your site address starts with https (Settings \u2192 General), and that you're using a browser with WebGPU. Tools \u2192 Site Health reports whether the site is set up for scenes.<\/p><\/dd>\n<dt id=\"is%20my%20api%20key%20shown%20to%20visitors%3F\"><h3>Is my API key shown to visitors?<\/h3><\/dt>\n<dd><p>No. The API key stays on your server; Settings \u2192 Miris only shows its first six characters. Pages show the viewer key, which only allows streaming assets.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20the%20viewer%20key%20if%20i%20change%20the%20api%20key%3F\"><h3>What happens to the viewer key if I change the API key?<\/h3><\/dt>\n<dd><p>If the new API key's account can still use the stored viewer key, the plugin keeps it. Otherwise it creates a new \"WordPress\" viewer key on that account. The old key isn't revoked; you can revoke it in the Miris portal.<\/p><\/dd>\n<dt id=\"can%20i%20use%20the%20plugin%20on%20a%20site%20without%20the%20block%20editor%3F\"><h3>Can I use the plugin on a site without the block editor?<\/h3><\/dt>\n<dd><p>Yes. Use the shortcodes.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Settings \u2192 Miris for the API key and the \"WordPress\" viewer key.<\/li>\n<li>Miris Scene, Miris Stream and Miris Group blocks, with a live editor preview and an asset picker.<\/li>\n<li><code>[miris_scene]<\/code>, <code>[miris_camera]<\/code>, <code>[miris_stream]<\/code> and <code>[miris_group]<\/code> shortcodes.<\/li>\n<li>HTTPS warnings in Site Health, Settings \u2192 Miris and the Scene block.<\/li>\n<li>Loads the Miris web components from Miris's CDN.<\/li>\n<\/ul>","raw_excerpt":"Stream 3D assets from your Miris account into posts and pages, with blocks or shortcodes.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/391026","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=391026"}],"author":[{"embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/miris"}],"wp:attachment":[{"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=391026"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=391026"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=391026"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=391026"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=391026"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/lin.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=391026"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}