MuRu AI for SP Page Builder
A Joomla plugin that adds a Generate AI Page button to the SP Page Builder editor. Describe a page, a Dynamic Content collection or a collection item, and it builds native SP Page Builder layouts, records and pages using the AI model you already set up in SP Page Builder.
Review a preview before anything is written, and every overwrite is saved to Version History first.
New Lyzerslab accounts get full access free for three months · you bring your own OpenAI or Gemini key.
Already have an account? Sign in

Prompt → Page
Preview, then apply
Joomla 4·5·6
PHP 8.1 – 8.4
OpenAI + Gemini
Your existing key
One-click Undo
Via Version History
Overview
Every SP Page Builder project has the same repetitive work: blank pages that need full layouts, Dynamic Content collections that need a schema, sample records, an index page and a detail page, items with a dozen empty fields, images to source, copy to write in a consistent voice and translations to duplicate by hand.
MuRu AI for SP Page Builder is a Joomla system plugin (plg_system_muruai) that turns that work into a prompt plus a review. Everything it writes goes through SP Page Builder's own services, so the result is always a native page, collection or item you can keep editing by hand.
It does not add a new AI subscription or a new key to manage: it calls whichever model — OpenAI or Google Gemini — is already configured under SP Page Builder's own Editor → Settings → Generative AI screen.
Part of the MuRu family alongside MuRu Compliance Auditor and MuRu Guard Security Scanner.
Why It Needed Its Own Plugin
Pointing a general-purpose model at "write me some SP Page Builder JSON" does not reliably work. SP Page Builder's layout format is exact and easy to get subtly wrong: colour fields that must be a bare hex string versus a structured gradient object, responsive values that need all five breakpoints, and column widths and addon settings that must be shaped exactly right or the editor panel will not open. A model guessing at it produces JSON that looks fine and then silently breaks the page.
This plugin is built on a from-source reference of SP Page Builder's real section / column / addon data model and feeds a distilled version of it to the model on every request. Before anything is applied, the raw response is checked and repaired against the failure modes that reference turned up. That is why this exists as a dedicated plugin rather than a prompt you paste into ChatGPT yourself.
How It Works
- 1
Open a page in the SP Page Builder editor
The Generate AI Page button sits in the page-settings row, next to SP Page Builder's own Frontend Editor button.
- 2
Describe the page
Start from one of 10 built-in templates or your own saved ones, e.g. "A SaaS landing page: hero with two buttons, 3-feature row, pricing, FAQ, contact CTA." Pick a tone and Replace or Append.
- 3
The plugin calls your configured model
Your prompt, your tone and brand kit, and the SP Page Builder layout rules are sent through the OpenAI or Gemini key already in SP Page Builder's settings.
- 4
Review the staged preview
The response is repaired and validated, then shown as section titles, block lists, counts and quality notes. Nothing touches your page yet.
- 5
Apply, edit or undo
Click Apply to page (or Discard). The current page is snapshotted to Version History first, then the new layout is written and the editor reloads. Tune it with SP Page Builder's normal tools, or restore the snapshot.
What You Get
Prompt-to-page in the editor
- Generate AI Page button next to Frontend Editor
- 10 built-in templates plus your own saved templates
- Last 10 prompts kept per user in Recent prompts
- Prompt-pack import/export to share templates between sites
- Tone: Professional, Friendly, Bold, Playful or Formal
Review before anything is written
- Staged preview with section titles and block lists
- Advisory quality notes: missing or duplicate headings, empty sections, very large pages
- Apply to page or Discard
- Replace the page or Append a new section at the end
Fix and lift existing pages
- Improve this page: responsive gaps, mobile typography, thin carousels, raw_html swapped for native addons
- Regenerate one section in its exact position
- Optional focus hint, e.g. "tighten the pricing section"
- Outline of the open page and a token size estimate in the window
Dynamic Content, end to end
- New Collection with AI: schema, sample records, index and detail pages
- Generate directly on collection index and detail pages
- Fill item with AI on existing items and the create form
- Validated against the real field definitions
Images and SEO
- Every page image setting: paste a path, pick from Media Manager, or Generate
- DALL-E 3 images saved to images/muruai/ (needs an OpenAI key)
- Title, description and Open Graph text written on apply
- Apply images snapshots to Version History first
Translate this page
- Duplicates the page into another language
- Same sections, columns, blocks and ids; only text translated
- Structural check rejects drifted translations
- Title, styling and SEO text travel with the copy
On-brand and store-aware
- Brand kit: colours, fonts and button radius as hard constraints
- Empty slots auto-detected from your template; manual values win
- EasyStore-aware on Single, Collection and storefront layouts
Professional workflows
- Generation activity log (prompt text is never logged)
- CLI: muruai:generate with preview-first safety
- Create a Joomla article with an SP Page Builder layout
- Optional frontend editor support (off by default)
Uses SP Page Builder's own AI settings
- No separate API key to manage
- OpenAI gpt-* and Google Gemini gemini-* models
- Warns when a weak model is configured
Bundled SP Page Builder knowledge
- Section / column / addon data model
- Real addon field keys and verified style-field shapes
- Addons with real content: carousels, tabs, accordions, tables, forms and more
- Addons needing external accounts left at safe defaults
What It Can Build
The generator emits SP Page Builder content-column JSON — the same structure the editor produces — so the result is fully editable afterwards. It is guided to reach for purpose-built addons rather than stacking bare text blocks.
Layout primitives
Sections with 12 / 6,6 / 4,4,4 / 3,9 column splits, responsive widths and mobile padding.
Content addons
heading, text_block, button, image, icon, feature, divider, animated_number, progress_bar.
Rich addons
accordion, tab, pricing, testimonial and carousels, gallery, countdown, timeline, forms and tables, filled with real content.
Cards & sub-layouts
div flex / grid cards and chip rows built from real addons, not hand-written HTML.
Hero & CTA bands
Background image with colour overlay, headline, sub-text and button groups.
Full pages
Landing, about, services, pricing, contact, FAQ, portfolio, team, testimonials and coming-soon pages from one description.
Style presets on addons like Person and the carousels are chosen deliberately to fit the request. EasyStore / commerce addons are used when your prompt asks for a store or product listing, or when you generate on an EasyStore layout.
Dynamic Content Collections
A Dynamic Content collection normally means designing a schema field by field, creating records one by one, then building and binding an index page and a detail page. MuRu AI handles that flow from one prompt and then helps with each record.
- 1
New Collection with AI
Describe the collection or start from a preset: blog, portfolio, team, products, testimonials, FAQ or events. The plugin designs the schema and creates the collection with SP Page Builder's own collection system.
- 2
Sample records
Choose none, 3, 5 or 8 records. Location fields get real coordinates and image fields get real stock photos. The chosen tone flows into the records.
- 3
Index and detail pages
The index gets a Collection block with grid or list layout and pagination; the detail page gets Dynamic Text and Dynamic Media blocks bound to the real fields. Existing pages are reused, not duplicated.
- 4
Fill item with AI
Open any item, or the blank create form, and fill its empty text fields from the collection name, the item title and your hint. Existing values are never overwritten; media, relationship, alias and layout fields are skipped and reported.
SP Page Builder itself requires a menu item pointing at the collection so detail links resolve; the in-app instructions explain that one manual step.
Safety & Undo
Preview before write
Page generation is staged. Nothing touches the page until you click Apply to page.
Snapshot before overwrite
The page's current content, CSS and metadata are written to SP Page Builder's version table before any overwrite, and stale compiled CSS is purged.
Response never trusted as-is
The model output is parsed, structurally validated and repaired key by key before it is allowed near your page.
No partial writes
If the response cannot become a valid layout, or a translation drifts structurally, nothing is saved and you see why.
Never overwrites item data
Fill item with AI only fills empty text fields and validates against the real field definitions.
Permission checked twice
The caller must pass Joomla's CSRF token and hold edit rights on com_sppagebuilder for that page.
Editor can't be bricked
The asset-injection hook is fully guarded. If anything goes wrong the button simply doesn't appear; the editor still loads.
Activity log
Who generated what, on which page, with which model and how many sections. Prompt text is never logged.
Models & Cost
The plugin does not sell tokens or proxy anything. It calls the provider whose key you entered in SP Page Builder → Editor → Settings → Generative AI, and you are billed by that provider for each generation.
Recommended
GPT-4o, GPT-4.1 or Gemini 2.5 Pro: enough context for the layout guide and reliable JSON.
Works, lower quality
Other mid-size gpt-* / gemini-* models; expect more retries and simpler pages.
Not recommended
gpt-3.5-turbo and similar: too little context; the plugin flags it in the Generate window.
Cost visibility
The Generate window shows a rough prompt-token estimate next to the model name, compared with your configured max output tokens.
AI images
Image generation uses DALL-E 3 through your OpenAI key. Gemini-configured sites get a clear message instead of a broken button.
Settings
All settings are optional apart from your licence key; the defaults are sensible.
| Setting | Default | Purpose |
|---|---|---|
| Licence key | — | Activates the plugin; verified against your Lyzerslab account. |
| Max output tokens | 16000 | Upper bound on the layout JSON the model may return. |
| Temperature | 0.3 | Lower values give steadier, more valid JSON. |
| Request timeout | 150s | How long to wait for the model before failing. |
| Default tone | — | Preselects the tone in the Generate window. |
| Brand kit | Auto-detect | Primary, secondary and accent colours, heading and body fonts and button radius, sent to the model as hard constraints. |
| Frontend editor | Off | Also injects the Generate button into SP Page Builder's frontend editor, with the same login, token, edit-rights and licence checks. |
| Debug | Off | Include the raw model output in the response for troubleshooting. |
The plugin settings also show the recent generation activity log, read-only.
Installation
- 1
Install the plugin
Upload plg_system_muruai from System → Install → Extensions.
- 2
Enable it
System → Plugins → enable “System - MuRu AI for SP Page Builder”.
- 3
Set an AI key and model in SP Page Builder
SP Page Builder editor → Settings → Generative AI: paste an OpenAI or Google Gemini key and pick a capable model (GPT-4o / GPT-4.1 / Gemini 2.5 Pro).
- 4
Register and activate your licence
Create a Lyzerslab account to start the three-month free trial, then paste your licence key in the plugin settings.
- 5
Set your brand kit and tone (optional)
Add your colours, fonts, button radius and a default tone so every generation matches your site.
- 6
Open a page and generate
Edit any SP Page Builder page, click Generate AI Page, describe the page, review the preview and Apply. Updates arrive through Joomla's native updater.
Requirements
Joomla
Joomla 4, 5 or 6.
PHP
PHP 8.1 to 8.4 with curl and json.
SP Page Builder
SP Page Builder 6 with its React editor (Free or Pro).
AI provider
An OpenAI or Google Gemini API key and model set in SP Page Builder's Generative AI settings.
Network
Outbound HTTPS from the server to the AI provider.
Licence
A Lyzerslab account to activate a licence (3 months free on registration).
Privacy & Security Model
Your key, your provider
Requests go only to the model provider you configured. Nothing is sent for training or telemetry.
Content disclosure
Normal generation sends only your prompt and the layout rules. Improve, Regenerate section, Translate and Fill item also send the page, section or item content they work on.
Image generation
AI images send only your image description to OpenAI's Images API.
No key of its own
The plugin reads SP Page Builder's stored API key at request time and never writes or copies it.
Permission-aware endpoints
Every generation route requires Joomla's CSRF token, a logged-in user, edit rights on the target and a valid licence. Nothing is injected for guests.
Safe writes
Writes use Joomla's query builder and SP Page Builder's own services; generated JSON is validated before storage.
Nothing on the public site
No overlay and no runtime script on your public pages. The plugin only touches editor and Dynamic Content screens.
Version History
New
- Staged preview with Apply to page / Discard and quality notes
- Tone dropdown, default tone setting and brand kit
- Improve this page and Regenerate one section
- Fill item with AI on existing items and the create form
- AI-generated page images and Media Manager picker
- Translate this page, with a structural safety check
- SEO title, description and Open Graph text from the same generation
- Custom templates, prompt history and prompt-pack import/export
- EasyStore-aware generation
- Activity log, CLI generation and optional frontend editor support
- New-collection window redesign with presets, tone and sample-record count
Fixed & changed
- Improve and Regenerate section no longer crash the editor on repeatable settings
- Licence check follows the shared MuRu contract and recognises version-scoped keys
- Generate window is full width with a scrollable body and a two-column Options rail
New
- Deeper design knowledge base: sliders, carousels, tabs, accordions, galleries, forms and tables filled with real content
- Style presets chosen deliberately instead of the plainest default
- Addons needing external accounts are left at safe defaults
- 10 built-in templates rewritten as full content briefs
- Realistic sample data: real coordinates and stock photos
Fixed
- Location and video fields now bind to the correct addons on collection pages
- Item cards on generated index pages link to their own detail pages
- Removed an invalid "Color" field type from collection design
Foundations
- 1.0: Generate AI Page with automatic Version History snapshots and quality checking
- 1.1: Append mode and 10 ready-made prompts
- 1.2: Dynamic Content index and detail pages bound to real fields
- 1.3: Build a whole collection, index and detail set from one prompt
- 1.4: Generate a Joomla article as an SP Page Builder layout
Licensing & updates
- Licence verification against your Lyzerslab account
- Native Joomla updates through the Extension Manager
- A brief network blip no longer switches Pro off
Frequently Asked Questions
Built on a verified SP Page Builder reference. SP Page Builder is a product of JoomShaper; this plugin is an independent Lyzerslab extension and is not affiliated with or endorsed by JoomShaper.
