Blocks & Page Design

Horuph Studio Usage Guide Version 1.0.0

What It Is

Content pages can use a template to control the overall layout and structure. On top of that, admins can build pages using Blocks — reusable sections you can place on pages (think SharePoint-style page building).

Blocks are designed for fast editing: if you are viewing a page and notice something needs to change, you can adjust it directly from the page without hunting through the console.

Templates vs Blocks

• Templates: define the page structure (layout, sections, and where blocks are allowed to appear).
• Blocks: the actual content pieces you place inside those sections.

Show Blocks (On/Off)

The Show Blocks switch enables block editing mode on the page. When enabled, block controls appear on top of the page so you can manage sections without leaving the page.

• Off: You see the page normally (no block controls).
• On: Block overlays and actions become visible.

How Blocks Work

• Reusable building units: each block is a section of content (markup) that you can add to pages.
• Mix with addons: addon blocks can appear alongside your own blocks.
• Flexible placement: blocks are placed into specific page sections based on the active template.
• Scope-aware: blocks can be global or page-specific (so you can reuse or customize safely).

Where a Block Can Appear

Blocks can be configured to show in different scopes:

• Every Page: the block is visible across all content pages (global).
• This Page: the block is only visible on the current page.
• This Section: the block is tied to a specific section of the template layout.

In practice: a “header banner” might be Every Page, a landing page hero might be This Page, and a footer widget might be This Section.

Block Controls

When block mode is enabled, blocks provide quick actions:

• Block Info: view details about the block (source, scope, settings).
• Hide Block: hide the block without deleting it (easy to restore later).
• Remove Block: permanently remove the block from its scope.
• Add Block: use the “+” control to insert a new block into a section.

Drag & Drop Reordering

Blocks can be rearranged using drag & drop. This lets you change the order of sections visually, without touching code.

• Drag a block to move it up/down within the same section.
• Drop it into another valid section (if the template allows it).
• Reordering affects how the page renders for visitors.

Saving and Publishing

• Changes apply based on your system’s save behavior (instant, autosave, or manual save).
• If you do not see changes on the public site, make sure you saved the block order/visibility correctly.

Best Practices

• Use templates for structure, and blocks for content sections.
• Keep global blocks minimal (Every Page) to avoid clutter on pages that don’t need them.
• Prefer page-scoped blocks (This Page) for custom landing pages and one-off layouts.
• Hide vs Remove: hide if you might reuse it later, remove only when you’re sure.
• Use addon blocks intentionally: if an addon adds blocks, treat them like reusable tools, not decoration.

Troubleshooting

• If a block appears on pages you didn’t expect, check its scope (Every Page / This Page / This Section).
• If a block disappears, check whether it was hidden instead of removed.
• If a block can’t be placed somewhere, the current template may not expose that section as a valid drop target.