How-tos
Use a Multi-Page widget — auto-place the player across pages
A Multi-Page widget is built for maximum convenience. When you activate the Cloud Console for a website, GSpeech creates the required widgets automatically — Multi-Page, RHT, Welcome Message, and three shortcode players (Full / Button / Circle). Multi-Page and RHT are published by default; the three shortcode widgets are ready too (you only need to paste a shortcode where you want them); Welcome Message stays disabled until you turn it on. On typical sites the Multi-Page player appears with no shortcode per post. Defaults are already filled — change a field only when you want something different.
- Why useful — one auto-created, already-published widget covers many posts/pages without pasting shortcodes everywhere.
- Created on activation — Multi-Page + RHT published; shortcodes ready to place; Welcome disabled by default.
- Defaults = ready — Render Element already lists the main content wrappers; Content Selector is self_class.
- self_class — means “read the same place the player is.” Player and spoken content stay together.
- Change only if needed — custom wrapper, Exclude List / nospeech, or Allowed / Blocked Urls.
Open Cloud Console
WordPress docs
All How-tos
Defaults
Already set — leave them for maximum convenience
On a normal WordPress / blog theme you usually do nothing after Cloud activation — Multi-Page is already created and published. Both placement and reading targets are prefilled:
- Render Element — already a comma-separated list of common content wrappers (where the player appears). Default: .entry-content,.post-content,.post_content,.post,.blog,.blog-body,.content,.section,article.
- Content Selector — already self_class (what is spoken).
Change Render Element only if your theme uses a custom content wrapper that is not in that list (for example .wp-content or #main). Until then, leave it.
self_class
self_class = right where the player is
self_class means: narrate the same element the player was injected into. Player UI and spoken text stay in one place — that is the convenient default.
- Do not change Content Selector for normal use — keep self_class.
- If you later change Render Element for a custom wrapper, keep self_class — it still means “read that same place.”
- Change Content Selector only when spoken text must come from a different node than where the player sits.
- Render Position — Before or After (After is typical). Change only if you want a different insert side.
Exclude
Exclude List and the nospeech class
Optional — only when something inside the content block should stay silent (comments, share buttons, related posts, promo boxes):
- Exclude List — comma-separated CSS selectors that must not be read, even inside the spoken block. Example: #comments,.sidebar,.ads,.share-buttons,.related-posts.
- nospeech class — built into GSpeech. Any element with class nospeech is skipped automatically (no need to put it in Exclude List).
Example: <div class="promo-box nospeech">…</div>
Prefer nospeech when you control the HTML. Use Exclude List when you cannot edit the markup.
URLs
Allowed Urls and Blocked Urls (optional)
By default the player can appear on every page where Render Element matches. Touch URL lists only when you want to limit that:
- Allowed Urls — only these URLs get the player. One URL per line. * = wildcard.
- Blocked Urls — hide the player on these URLs.
- Only About — Allowed: https://example.com/about.
- Everywhere except About — Blocked: https://example.com/about.
- All blog posts — Allowed: https://example.com/blog/*.
- Hide homepage — Blocked: homepage URL.
Setup
How to use Multi-Page (usually already on)
- Activate Cloud for your website — the Multi-Page widget is created and published by default (with RHT; Welcome stays disabled; shortcode widgets are ready when you place a shortcode).
- Open Widgets → Multi-Page Full Page Player only if you want to review settings.
- Leave Render Element and Content Selector (self_class) as they are — maximum convenience.
- Change something only if you need it: custom Render Element, Exclude List / nospeech, or Allowed / Blocked Urls.
- Hard-reload a page and confirm the player appears where you expect.
FAQ
Multi-Page widget FAQ
-
Usually no. After Cloud activation, Multi-Page is already published. Defaults place the player and self_class reads the same place. Change fields only when you want a custom result.
-
Read the same element where the player is. Player and audio stay together — that is why it is the default.
-
Only if the default wrappers do not match your theme. Point it at your real content class/ID, keep self_class, and the player still reads that same place.
-
nospeech = class on HTML, always skipped. Exclude List = console selectors when you cannot edit markup. Both optional.
-
Yes — Allowed Urls for that page, or Blocked Urls to hide it on About while keeping everywhere else.