KnowPromo Slider

KnowSlider Promo turns a list of features into a polished, full-screen slider: an intro slide, a run of two-column feature slides, and a closing call to action.

Sliders can be built three ways:

1. By hand in the admin UI.
2. From a prompt — add an OpenAI or Claude API key and describe what you want; the plugin drafts the whole slider.
3. From your editor — connect any MCP client (Cursor, Claude Desktop, etc.) to the built-in MCP server and create, edit, colour and preview sliders by chatting.

Key features

• Intro / feature / outro slide structure with image-left, image-right and centered layouts.
• Global default primary/secondary colours, with per-slider and per-intro/per-outro overrides.
• Admin-set branding logo: optional fade-in splash before the slider, plus a persistent logo on every slide (top-left, top-centre, top-right, bottom-left or bottom-right).
• AI slider generation using OpenAI or Claude.
• Built-in MCP server with per-user bearer tokens. Tools: list_sliders, get_slider, create_slider, update_slider, delete_slider, set_colors, upload_image, create_preview_link.
• Preview links minted only via MCP — one-hour expiry (a real 404 afterwards) with optional auto-password when the administrator enables it globally.
• `[knowslider id="..."]` shortcode that renders inside an isolated iframe.
• Role- and email-based access control. Administrators manage everything; granted users manage only their own sliders and keys.

CSS isolation

Preview links and the shortcode's iframe target are complete standalone HTML documents — no theme stylesheet is ever loaded on them. The slider stylesheet starts with a hard reset on a `ksp-`-prefixed root, and the shortcode embeds through an iframe. Host-theme CSS cannot bleed in, and the slider cannot bleed out.

How do I display a slider on a page?

Use the shortcode `[knowslider id="123"]` (the ID is shown in the Sliders list). It renders inside an isolated iframe so the host theme cannot affect it.

Do I need an API key?

No. An OpenAI or Claude key is only needed for the AI Generate screen. You can always build sliders by hand or over the MCP server without one.

How do preview links work?

Preview links are created only through the MCP server (`create_preview_link`). They render a slider as a standalone page and expire after one hour, returning a 404 afterwards. If an administrator enables preview passwords, each link is minted with an auto-generated password that is returned to the MCP caller once.

Where is the MCP endpoint?

`https://YOUR-SITE/wp-json/knowsliderpromo/v1/mcp`. Each user mints a personal bearer token under KnowSlider → MCP Keys.

Who can use the plugin?

Administrators always have full access. Other users get access if their role or email is granted under KnowSlider → Access; they can manage only their own sliders and their own MCP keys.