Title: Comnoira 3D Viewer
Author: comnoira
Published: <strong>2026 年 9 月 4 日</strong>
Last modified: 2026 年 9 月 4 日

---

搜索插件

![](https://s.w.org/plugins/geopattern-icon/comnoira-3d-viewer.svg)

# Comnoira 3D Viewer

 作者：[comnoira](https://profiles.wordpress.org/comnoira/)

[下载](https://downloads.wordpress.org/plugin/comnoira-3d-viewer.0.5.2.zip)

 * [详情](https://cn.wordpress.org/plugins/comnoira-3d-viewer/#description)
 * [评价](https://cn.wordpress.org/plugins/comnoira-3d-viewer/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/comnoira-3d-viewer/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/comnoira-3d-viewer/#developers)

 [支持](https://wordpress.org/support/plugin/comnoira-3d-viewer/)

## 描述

Comnoira 3D Viewer connects your site to your Comnoira account and lets
 you place
a working, interactive 3D Showcase on any page using a Gutenberg block — no code,
no hand-written snippet.

#### Requires a Comnoira account

This plugin is a client for [Comnoira](https://comnoira.com)‘s own 3D
 viewing service.
You’ll need a Comnoira account with at least one published Comnoira Asset to showcase.
The plugin does not bundle any 3D viewer code itself — it loads the viewer from 
Comnoira’s CDN at runtime and communicates with Comnoira’s API using a License Key
you generate from your own Comnoira dashboard.

#### What this plugin does

 * Securely stores your Comnoira License Key on your own server (encrypted
    at rest)—
   it is never sent to a visitor’s browser.
 * Lets you register one or more Showcases under Comnoira  Showcases, each one
    
   referencing a specific Comnoira Asset.
 * Adds a “Comnoira Showcase” Gutenberg block so you can place a registered
    Showcase
   on any page or post, with basic display options (width, height, auto-rotate).
 * Lets you test whether a Showcase’s credentials actually work, right from
    the
   WordPress admin, before you ever load the real page.

#### What this plugin does not do

 * It does not host or process 3D models itself — that happens entirely on
    Comnoira’s
   platform.
 * It does not do anything useful without a Comnoira account and at least
    one Showcase
   registered on your Comnoira dashboard first.

### External services

This plugin is a client for Comnoira (https://comnoira.com), the 3D
 hosting and
viewing service your registered Showcases’ assets live on. It does not work without
a Comnoira account, and every network request it makes is to Comnoira’s own API 
and viewer, at your explicit action — there is no third-party analytics, ad, or 
tracking service involved.

 * Registering a Showcase or clicking “Test Connection” in the admin sends
    your
   stored License Key and the Showcase’s Embed ID / Public Key to Comnoira’s API(
   https://api.comnoira.com), to verify they’re valid.
 * When a visitor loads a page containing a Comnoira Showcase block, your
    WordPress
   server sends that Showcase’s Embed ID and Public Key (plus your License Key, 
   never sent to the visitor) to Comnoira’s API to mint a short-lived viewer session
   for that page load.
 * The visitor’s browser then exchanges that short-lived session token —
    never 
   the License Key itself — directly with Comnoira’s viewer service (https://viewer.
   comnoira.com) to load and display the 3D model.

No visitor personal data (name, email, IP address) is collected or sent
 by this
plugin itself.

This service is provided by Comnoira: [Terms of Service](https://comnoira.com/terms),

[Privacy Policy](https://comnoira.com/privacy).

## 屏幕截图

[⌊The Comnoira → Connection screen, showing the setup checklist and
connection status.⌉⌊
The Comnoira → Connection screen, showing the setup checklist and
connection status
.⌉[

The Comnoira  Connection screen, showing the setup checklist and connection status.

[⌊Registering a Showcase under Comnoira → Showcases, with the Test Connection
button.⌉⌊
Registering a Showcase under Comnoira → Showcases, with the Test Connection
button
.⌉[

Registering a Showcase under Comnoira  Showcases, with the Test Connection button.

[⌊The Comnoira Showcase block in the block editor, with the Showcase picker in
the
sidebar.⌉⌊The Comnoira Showcase block in the block editor, with the Showcase picker
in
the sidebar.⌉[

The Comnoira Showcase block in the block editor, with the Showcase picker in the
sidebar.

[⌊A live Showcase rendered on a published page.⌉⌊A live Showcase rendered on a published
page.⌉[

A live Showcase rendered on a published page.

## 区块

该插件提供了 1 个区块.

 *   Comnoira Showcase Show an interactive Comnoira Showcase on this page.

## 安装

 1. Install and activate the plugin.
 2. Go to **Comnoira  Connection** and paste the License Key from your Comnoira dashboard.
 3. Go to **Comnoira  Showcases** and register at least one Showcase — you’ll need 
    the Embed ID and Public Key from your Comnoira dashboard’s Showcase detail page.
    Use the “Test Connection” button to confirm it’s working before moving on.
 4. Edit any page or post, add the **Comnoira Showcase** block, and pick your registered
    Showcase from the block’s sidebar.

## 常见问题

### Do I need a Comnoira account?

Yes. This plugin is a WordPress client for Comnoira’s own service — it has
 nothing
to display until you connect a real Comnoira account with at least one published
asset.

### Is my License Key ever sent to a visitor’s browser?

No. The License Key is stored encrypted on your own server and used only
 in server-
to-server requests this plugin makes on your behalf. A visitor’s browser only ever
receives a short-lived session token, never the License Key itself.

### Why do I have to register each Showcase manually instead of it showing up automatically?

Comnoira’s API doesn’t currently expose a way to list all of a shop’s
 Showcases
using just a License Key, so this plugin keeps its own local registry — you copy
the Embed ID and Public Key from your Comnoira dashboard once per Showcase, and 
the plugin remembers it from then on.

### Does this work with any WordPress theme?

The Gutenberg block renders a plain container sized to the width/height
 you set—
it doesn’t depend on theme-specific styling, so it should work with any block-editor-
compatible theme.

### Where can I find the source code for the Gutenberg block?

The uncompiled JavaScript source is included in this plugin’s `blocks/`
 directory.
The `build/` directory holds the compiled, minified version that WordPress actually
loads — `build/` is generated from `blocks/` via npm run build (`@wordpress/scripts`).

## 评价

此插件暂无评价。

## 贡献者及开发者

「Comnoira 3D Viewer」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ comnoira ](https://profiles.wordpress.org/comnoira/)

[帮助将「Comnoira 3D Viewer」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/comnoira-3d-viewer)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/comnoira-3d-viewer/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/comnoira-3d-viewer/)，或通过[RSS](https://plugins.trac.wordpress.org/log/comnoira-3d-viewer/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/comnoira-3d-viewer/)。

## 更新日志

#### 0.5.2

 * Fixed session creation failing after Comnoira’s backend renamed its API
    field
   for identifying a Showcase. No changes needed on your part.

#### 0.5.1

 * First public release. Connect a Comnoira account, register Showcases, test
    them
   from the admin, and place a live 3D Showcase on any page with a Gutenberg block.

## 额外信息

 *  版本 **0.5.2**
 *  最后更新：**4 天前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.4 或更高版本 **
 *  已测试的最高版本为 **7.1**
 *  PHP 版本 ** 8.1 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/comnoira-3d-viewer/)
 * 标签
 * [3d](https://cn.wordpress.org/plugins/tags/3d/)[embed](https://cn.wordpress.org/plugins/tags/embed/)
   [gutenberg](https://cn.wordpress.org/plugins/tags/gutenberg/)[showcase](https://cn.wordpress.org/plugins/tags/showcase/)
   [viewer](https://cn.wordpress.org/plugins/tags/viewer/)
 *  [高级视图](https://cn.wordpress.org/plugins/comnoira-3d-viewer/advanced/)

## 评级

尚未提交反馈。

[您的评价](https://wordpress.org/support/plugin/comnoira-3d-viewer/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/comnoira-3d-viewer/reviews/)

## 贡献者

 *   [ comnoira ](https://profiles.wordpress.org/comnoira/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/comnoira-3d-viewer/)