Ecosystem Bridges
Vexal products integrate through shared taxonomy, internal processing bridges, and optional ledger hooks. Each plugin runs standalone; bridges are opt-in and avoid hard dependencies on theme or builder rendering.
Integration map
Vexal Portfolio (galleries, projects, showcases, uploader intake)
↔ Vexal Media (optimize, categories, queue, video, Media Library columns)
↔ Vexal SmartBlocks (media readiness in ledger snapshots, engine credentials)Shared taxonomy
| Bridge | Owner | Consumers |
|---|---|---|
vexal_portfolio_category | Portfolio (registered); Media adds attachment terms | Portfolio, Media, Media Library filters |
_vxp_portfolio_item_id | Portfolio linkage meta | Media Library Vexal Gallery column |
_vxp_showcase_project_ids | Portfolio | Media Library Vexal Project column |
Portfolio ↔ Media processing bridge
- Uploader intake:
NADMP_Intake_Upload::stage_and_queue_files() - Workspace batches:
process_workspace_batch() - Media Linkage admin tool syncs attachment ↔ project/showcase/category
- Gallery modal category filter when both plugins active
Portfolio owns project relationships and intake UX. Vexal Media owns optimization, queue, and Media Library asset-management UI.
Media ↔ SmartBlocks ledger bridge
When SmartBlocks is active alongside Vexal Media:
- Ledger snapshots include
metadata.media_readiness - Apply fix events log as
media_readiness_fix_applied - Engine credentials can inherit from SmartBlocks Integrations settings
Vexal Media operates fully standalone without SmartBlocks.
Credential boundary (mandatory)
Do not configure external API keys in Portfolio Project Workspace. Processing credentials belong in Vexal Media → Settings / Integrations or SmartBlocks Integrations. Portfolio consumes internal bridge APIs only.
SearchAsist / Vexal Engine routing for vision metadata, alt text, and image generation follows the same rule.
Standalone behavior
| Plugin | Works without others? |
|---|---|
| SmartBlocks | Yes — full visibility platform on WordPress |
| Vexal Media | Yes — media optimization and readiness |
| Vexal Portfolio | Yes — showcases and galleries; uploader requires Media |
Future: Vexal Hub
Vexal Hub is planned for multi-site account management. SmartBlocks v1 does not ship Hub transport. REST structures exist for future wiring—do not expect Hub-driven workflows in production today.