Building a Page

This theme uses WordPress’s new Gutenberg block builder with a few customizations to meet the needs of Wake Forest’s users. You can follow along with the text instructions below and/or watch WordPress’s Intro to Publishing with the Block Editor video to get started.

Watch Video ยป

Top Menu

Once you have created a new page and given it a title you’ll be presented with all your page building options. Here is are all the features of the top menu.

  1. Add blocks: Reveals a menu from the left listing all available blocks. Choose a block and it will be added to the page.
  2. Mode Select: Toggle between selecting (moving) and editing your blocks.
  3. Undo/Redo
  4. Document Overview: Displays a clickable outline of your page’s block structure. Very helpful for selecting specific groups and columns for changing widths and adding backgrounds. It also offers a page Outline, useful for checking the accessibility of your heading levels.
  5. Preview: Lets you view your changes before publishing.
  6. View Page
  7. Settings: Hides and reveals the right Page/Block menu, if you’ve accidentally hidden the menu this is how you add it back.
  8. Options: A collection of more advanced page settings

Switch to Draft: Returns a live page to a draft.
Update: Publishes your changes.
Page/Block: Toggles the right side menu between the page’s settings and your selected block’s settings.

Review Adding a New Page for page publishing options.

Blocks

You can add a block to the page by clicking #1 above, clicking into the editing area then clicking the plus icon that appears or even typing a “/” and the name of your desired block. Here are all the available blocks in this theme.

clicking the plus
typing a slash

Once you’ve added a block there will be a menu with a variety of block-specific options that appears both above the block when selected and in the right-hand menu under the Block tab. Below is the Pullquote block for example.

Block Menu

block menu
  1. Block Type: This icon shows what type of block this is, clicking allows you to change to other similar blocks.
  2. Handle: Holding this allows you to grab the block and move it, it’s helpful for moving blocks in and out of columns when layouts change.
  3. Move Up/Down: Clicking this allows you to reorder your block up and down the page.
  4. Alignment: If your block has alignment and width (see next section) options you can make those changes here.
  5. Bold (this area will be slightly different depending on your block’s options, see Available Blocks for specifics)
  6. Italics
  7. Link: Adds a link to your block
  8. Text Settings
  9. More Settings: Remove block, Group, Edit as HTML, Duplicate, etc.

Block Sidebar Menu

Here is where you can apply available styles and more advanced options than the smaller block menu. Make sure you’ve selected the block and toggled to the Block tab. Block Setting show under the tab labeled with a gear icon and Styles are offered under the icon that looks like a half moon.

Document Overview/List View

A very helpful tool for managing your page layout is the Document Overview/List View (#4 under Top Menu above) marked by three offset lines in the top left of your editor. This allows you to see a nested list of all your blocks. It is great for selecting specific blocks and columns for changing widths and adding backgrounds. The Outline tab is important to help you maintain accessible heading levels.

Block Widths

Most blocks come in three different widths, Narrow by default, Wide and Full. Text blocks like Paragraph and List are limited to only the Narrow width for legibility, but choosing Wide will make your block the width of the content area (the width of the menu) and Full will touch the edges of the screen.

For Columns and other nested blocks, you’ll need to change the width on the parent Columns, not in the individual Column. You can navigate to the parent by clicking on the “List View”, #5 under Top Menu above.

You can change the width of a block (if applicable) by clicking the Change Alignment icon above the block. NOTE: This is also where you can float the block to the left and right, but use these with caution, it allows other blocks below it to be able to flow around the block with potentially undesirable results.

block widths

Patterns (Reusable Blocks)

If you’d like to have a block on your site that you’ll use on more than one page and be able to make edits that will update on all those pages at once, then you’ll need to create a Pattern.

First, you’ll need to create the block once on a page, Group the blocks if more than one block is used. Then, click on the three dots on the right end of the block menu while selected and choose “Create pattern” from the drop-down menu. Then name the block in the pop-up and keep the “Synced” toggle on.

Your Pattern will now be available in the Add Block menu (large plus sign) at the top left of the builder under the icon on the far right. Your site’s Patterns should be under “My patterns” (all the other options are just messy things from our team, we’ll have more organized offerings coming soon.) You now can edit the Pattern on the page and you’ll be prompted to add those updates to all pages using that Patten when you save the page.

To unsync any Pattern, just click on the the same menu where you created the Pattern and choose “Detach pattern”, this will return it to normal blocks.