https://github.com/razuna/razuna-wordpress
This is the new Razuna Wordpress plugin to integrate your files into Wordpress with one click
https://github.com/razuna/razuna-wordpress
cms dam file-management file-sharing media razuna wordpress-plugin
Last synced: 25 days ago
JSON representation
This is the new Razuna Wordpress plugin to integrate your files into Wordpress with one click
- Host: GitHub
- URL: https://github.com/razuna/razuna-wordpress
- Owner: razuna
- License: gpl-2.0
- Created: 2026-06-04T04:01:18.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-05T02:50:21.000Z (about 1 month ago)
- Last Synced: 2026-06-05T04:15:40.096Z (about 1 month ago)
- Topics: cms, dam, file-management, file-sharing, media, razuna, wordpress-plugin
- Language: PHP
- Homepage: https://razuna.com/wordpress/
- Size: 47.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Razuna DAM for WordPress
Browse, search, and embed your [Razuna](https://razuna.com) digital assets
directly from WordPress. Connects to Razuna over **OAuth 2.0**; published images
are served from Razuna via **durable direct links** — assets stay in Razuna as
the single source of truth, with no duplication into the WordPress media library.
## How it works
Two planes, kept separate by design:
- **Auth / management plane — OAuth.** The plugin registers itself as an OAuth
client (dynamic client registration), runs the authorization-code + PKCE flow,
and stores an encrypted access/refresh token. All Razuna API calls happen
**server-side**; the token never reaches the browser. The editor's asset
picker talks only to a same-origin WordPress REST proxy (`wp-json/razuna/v1/*`).
- **Content / delivery plane — direct links.** When you insert an asset, the
plugin embeds a Razuna **direct link** — a 365-day signed `/file/remote` URL
that is public and durable. Published content renders for anonymous visitors
independently of the OAuth session (which expires every ~10 minutes).
## Editor integrations
- **Razuna Asset block** (block editor) — browse/search and embed an image.
- **"Add from Razuna"** button (classic editor) — same picker, inserts an `![]()
`.
## Plugin structure
```
razuna.php Plugin header + bootstrap
includes/
class-plugin.php Orchestrator (hooks, asset registration)
class-settings.php Region/server config + encrypted token storage + admin page
class-oauth.php OAuth client: DCR, PKCE S256, callback, refresh
class-api.php Server-side Razuna REST client (Bearer JWT, auto-refresh)
class-rest.php Same-origin REST proxy (wp-json/razuna/v1/*)
class-block.php "Razuna Asset" dynamic block (register + server render)
class-crypto.php At-rest encryption for stored tokens
views/settings-page.php Settings UI
assets/js/picker.js Shared, build-free asset picker (vanilla JS)
assets/js/block.js Block editor UI (wp.element, no JSX/build)
assets/js/media-modal.js Classic-editor "Add from Razuna" + modal
assets/css/admin.css Picker / modal / block styles
uninstall.php Removes options + stored tokens
docker/ Local WordPress test harness (see docker/README.md)
```
No build step: the JS uses plain ES5 / `wp.element.createElement`, so the plugin
runs straight from a checkout (handy for the bind-mounted Docker harness).
## Requirements
- WordPress 6.0+, PHP 7.4+
- A Razuna account (US, EU, or a custom/dedicated server)
## Local development & testing
See [`docker/README.md`](docker/README.md) for a one-command WordPress harness
and the full connect → browse → insert → public-render walkthrough.