Configuring the Directory Block in MemberPress App

The Directory Block displays archive-style listings of WordPress content within app pages. This block creates organized content directories with customizable metadata, search functionality, and filtering options. This document explains how to add the Directory Block, configure display settings, and optimize directory listings for member engagement.

Understanding the Directory Block

The Directory Block presents collections of WordPress posts, pages, or custom post types in structured list formats. Members can browse, search, and filter content within directories. The block supports featured images, author avatars, metadata display, and sorting options. Directory Blocks must occupy entire app pages without other blocks due to full-screen layout requirements.

Directory Block Limitations

Directory Blocks require exclusive page occupancy. Multiple blocks cannot coexist with Directory Blocks on the same page.

Single-block requirement: Directory Blocks must be the only block on an App Page. Adding additional blocks triggers configuration errors.

Full-screen layout: Directory Blocks utilize the complete screen space for optimal content browsing. Mixed layouts with other blocks compromise directory functionality.

Error prevention: Remove all other blocks before adding Directory Blocks. Add Directory Blocks only to empty App Pages.

Adding the Directory Block

Directory Blocks are added through the App Page editor interface.

1. Vaya a Dashboard > MP App > App Pages.
   
2. Haga clic en Añadir nuevo to create a new App Page or Editar an existing empty page.

3. Enter a page title in the Título campo.

4. Haga clic en el botón Toggle Block Inserter icon in the editor toolbar.

5. Enter “Directorio” in the block search field.

6. Drag the Directory Block onto the page canvas.
   
7. Haga clic en Publique o Actualización to save the page.

The Directory Block displays a skeleton preview with placeholder metadata labels after insertion.

Understanding Directory Preview

The skeleton preview shows the directory layout structure during configuration.

Placeholder labels indicate metadata field positions. Labels display as “META 1,” “META 2,” “META 3,” and “META 4” representing available metadata slots.

Layout preview demonstrates how the content will appear in the directory. Actual content populates these placeholders in the published app.

Configuration guidance helps identify customization opportunities. Placeholders visually indicate where metadata fields will display.

Configuring Directory Block Settings

Directory Block settings control content source, display options, and sorting behavior.

Selecting Post Type

Post type selection determines which content populates the directory.

1. Select the Directory Block in the page editor.
2. Localice el Ajustes de bloque sidebar on the right.
   
3. Encuentra el Select Post Type dropdown under Block Settings.
   
4. Choose the desired post type from the available options:
   • Puestos for blog posts;
   • Páginas for WordPress pages;
   • Custom Post Types for specialized content types.

5. Haga clic en Update/Publish to save the page.

Directory content updates immediately based on the selected post type.

Enabling Featured Images

Featured images provide visual context in directory listings.

1. Select the Directory Block in the page editor.
   
2. Localice el Show Featured Image toggle in Block Settings.
   
3. Toggle the switch to En to enable featured image display.

4. Haga clic en Actualización to save the page.

Featured images display as thumbnails in directory list items when available. Content without featured images displays placeholder graphics.

Configuring Metadata Display

Metadata fields provide additional context about directory items. Up to four metadata fields can be displayed per item.

Adding First Metadata Field

1. Select the Directory Block in the page editor.
   
2. Desplácese hasta el Metadata section in Block Settings.
   
3. Toggle Meta 1 a En.
   
4. Select the desired metadata field from the Meta 1 desplegable:
   • Título
   • Excerpt
   • Contenido
   • Author Name

5. Haga clic en Actualización to save the page.

The first metadata field displays in the META 1 placeholder position.

Adding Additional Metadata Fields

1. Haga clic en Add Meta below the first metadata field.

2. Select the desired field from the dropdown.
   
3. Repeat steps 1-3 to add up to four total metadata fields.
   
4. Haga clic en Actualización to save the page.

Metadata fields display in the order they are added. Rearrange fields by adjusting their configuration order.

Configuring Directory Options

Directory options enable interactive features and display enhancements.

Enabling Search Functionality

Search bars allow members to find specific content within directories.

1. Toggle Show Search Bar a En.

2. Haga clic en Actualización to save the page.

Search bars appear at the top of directory screens in the published app.

Enabling Search Filters

Search filters refine search results by categories or taxonomies.

1. Toggle Show Search Filter a En in Directory Options.

2. Haga clic en Actualización to save the page.

Search filters appear alongside search bars when both options are enabled. Filters provide category or tag selections for narrowed results.

Enabling Author Avatars

Author avatars identify content creators visually in directory listings.

1. Toggle Avatar a En in Directory Options.

2. Haga clic en Actualización to save the page.

Author avatars display as small circular images next to content titles. Avatars require author profile images configured in WordPress.

Enabling Comment Counts

Comment counts indicate discussion activity on content items.

1. Toggle Show Comment a En in Directory Options.

2. Haga clic en Actualización to save the page.

Comment counts display as numbers with comment icons in directory listings. Counts update as members add comments.

Enabling Bookmarks

Bookmarks allow members to save content for later access.

1. Toggle Show Bookmark a En in Directory Options.

2. Haga clic en Actualización to save the page.

Bookmark icons display in directory listings. Members tap icons to bookmark or unbookmark content.

Configuring Sorting Options

Sorting options control the order of content within directories.

Setting the Order By Field

1. Select the Directory Block in the page editor.
2. Localice el Pedir por dropdown in Block Settings.

3. Select the sorting field:
   • Fecha for chronological sorting;
   • Título for alphabetical sorting;
   • Modified for recently updated content;
   • Menu Order for manual ordering.

4. Haga clic en Actualización to save the page.

The sort field determines which content attribute controls display order.

Setting Order Direction

1. Localice el Pida dropdown below Order By.

2. Select the sort direction:
   • Ascendente for A-Z or oldest-first ordering;
   • Descendente for Z-A or newest-first ordering.

3. Haga clic en Actualización to save the page.

Sorting (order) direction works in combination with the sort field. Date descending displays the newest content first.

Deleting Directory Blocks

Directory Blocks can be removed when no longer needed.

1. Vaya a Dashboard > MP App > App Pages.
   
2. Open the page containing the Directory Block.
   
3. Select the Directory Block in the editor.
   
4. Haga clic en el botón Opciones menu (three vertical dots) in the block toolbar.

5. Haga clic en Borrar.

6. Haga clic en Actualización to save the page.

Removing Directory Blocks allows other block types to be added to the page.