MuRu AI for SP Page Builder
A Joomla plugin that adds one button to the SP Page Builder editor: Generate AI Page. Describe the page you want, and it builds a full SP Page Builder layout — sections, columns and addons — using the AI model you already set up in SP Page Builder, then drops it straight onto the page you are editing.
Your previous page is saved to Version History first — every generation is one click from undo.
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
One button in the editor
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 page still starts the same way: an empty canvas. You pick a section layout, drag columns into it, search the addon panel for the right block, then style each one by hand — before you have written a single word of real content. That gap between "I need a landing page" and a first editable draft is what this plugin closes.
MuRu AI for SP Page Builder is a Joomla system plugin (plg_system_muruai) that adds one button, Generate AI Page, to the SP Page Builder editor. You describe the page in a sentence or two, and it hands back a complete, already-editable section / column / addon layout — the same structure SP Page Builder itself would save — sitting on the page you were just editing.
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, the exact settings SP Page Builder ships for its in-editor text and image tools. This plugin is the missing piece that points that same configuration at a whole page instead of one field at a time.
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 ones that must be a structured gradient object, responsive values that need all five breakpoints, column widths and addon settings that have to be shaped exactly right or the editor panel simply will not open. None of that is obvious from the outside, and a model guessing at it produces JSON that looks fine and then silently breaks the page, or crashes the editor the moment you click into an addon.
This plugin is built on a from-source, reverse-engineered reference of that schema — the real section / column / addon data model, the field keys for every addon, and the exact shape of every structured setting — and feeds a distilled version of it to the model as a system prompt on every request. Then, before anything touches your page, the raw response is checked and repaired against the failure modes that reference turned up: missing column widths, malformed settings objects, a heading the model duplicated into a text block. That is the actual reason 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
e.g. "A SaaS landing page: hero with headline, subtext and two buttons; a 3-feature row; a 3-plan pricing section; an FAQ accordion; a contact CTA."
- 3
The plugin calls your configured model
Your prompt is sent with a ~25,000-token SP Page Builder layout guide as the system prompt, through the OpenAI or Gemini key already in SP Page Builder's settings.
- 4
The response is repaired, then applied
Column widths, responsive objects and addon settings are normalised to shapes the editor expects; the current page is saved to Version History; the new layout is written and the editor reloads.
- 5
Edit or undo
Tune the generated page with SP Page Builder's normal tools, or restore the Before AI generation snapshot from Version History.
What You Get
Prompt-to-page in the editor
- One Generate AI Page button, next to Frontend Editor
- Prompt modal with an overwrite notice
- Editor reloads onto the finished layout
- Reads the open page id from the editor route
Uses SP Page Builder's own AI settings
- No separate API key to manage
- OpenAI gpt-* (Chat Completions)
- Google Gemini gemini-* (generateContent)
- Warns when a weak model is configured
Output repaired before it is saved
- Column settings.width forced to {xl,lg,md,sm,xs}
- Section / addon settings coerced to valid objects
- Nameless addons dropped
- Heading duplicated into a text block removed
Reversible by design
- Current page snapshotted to Version History first
- "Before AI generation" restore point
- Stale compiled page CSS cleared on save
- Nothing touched outside the page you are editing
Bundled SP Page Builder knowledge
- Section / column / addon data model
- 69-addon catalog and real field keys
- Verified style-field shapes and gates
- Known-good skeleton layouts
Back end only
- Administrator editor screen only
- Joomla authentication, ACL and CSRF token
- Nothing rendered on the public site
- No front-end editor integration
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 the 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, mobile padding.
Content addons
heading, text_block, button, image, icon, feature, divider, animated_number, progress_bar.
Rich addons
accordion, tab, pricing, testimonial / testimonial_carousel, gallery, countdown, timeline.
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 pages, about pages, service pages, FAQ pages, contact sections — from one description.
EasyStore / commerce addons are only used when your prompt clearly asks for a store or product listing.
Safety & Undo
Snapshot before overwrite
The page's current content, CSS and metadata are written to SP Page Builder's version table before the new layout is saved.
Response never trusted as-is
The model output is parsed, unwrapped from markdown if needed, structurally validated, and repaired key by key before it is allowed near your page.
No partial writes
If the response cannot be turned into a valid section array, the page is left untouched and the modal shows why.
Scoped to one page
Only the row you are editing is updated. Other pages, modules, settings and the AI configuration are never modified.
Permission checked twice
The caller must pass Joomla's CSRF token and hold edit rights on com_sppagebuilder for that specific 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.
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 prompt modal.
Rough cost
One page ≈ the system prompt (~25k tokens) plus a few thousand output tokens — cents per generation on current models.
Settings
The plugin has four parameters, all optional — the defaults are sensible.
| Parameter | Default | Purpose |
|---|---|---|
| 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. |
| Debug | Off | Include the raw model output in the response for troubleshooting. |
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 / 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 when the trial ends.
- 5
Open a page and generate
Edit any SP Page Builder page, click Generate AI Page in the page-settings row, describe the page, and press Generate.
Requirements
Privacy & Security Model
One outbound destination
Only your prompt and the bundled SP Page Builder layout guide are sent, and only to the model provider you configured. Nothing else leaves the server.
No key of its own
The plugin reads SP Page Builder's stored API key at request time and never writes or copies it.
Admin-only endpoint
The generation route requires Joomla's CSRF token, a logged-in user and edit rights on the target page.
Parameterised writes
The page update uses Joomla's query builder; the generated JSON is validated before storage.
No overlay, no runtime script
Nothing is injected into your public site. The plugin only touches the administrator editor screen.
GPL-2.0-or-later
Standard Joomla extension licensing; source is readable and auditable.
Roadmap
PlannedIdeas under consideration — not in the current release:
- Generate from a screenshot or a reference URL
- Brand style presets (colours, fonts, spacing) applied to every generation
- Append a generated section instead of replacing the page
- "Regenerate this section" from inside the editor
- Optional bring-your-own Anthropic Claude key
- Saved prompt library per site
Version History
New
- Generate AI Page — a full page from one written description
- Works with the AI you already have (OpenAI or Gemini) — no new key to buy
- Guided by a purpose-built SP Page Builder knowledge base
- Automatic Version History snapshot before every generation
- Automatic quality checking of every generated layout
Reliability & Privacy
- Administrator-only — nothing added to your public site
- Only your prompt and a layout reference reach the AI provider
- Uses Joomla's own permission checks — nothing extra to configure
Future releases and their notes will be listed here as they ship.
Frequently Asked Questions
FAQs
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.