Creating a page (screen)

Whether you are creating or editing a page (or screen), there is an outer level of tabs above the editor: Basic data (the page itself) and Engagement forms for the entire module (data from engagement forms connected to the whole Pages module; see Usage in modules).

When you create a page (or screen), it has four tabs:

• Basic data (opens in a new tab)
• Categories (opens in a new tab)
• Attributes (opens in a new tab)
• Blocks (opens in a new tab)

When you edit a saved page (or screen), additional tabs appear:

• Engagement forms (opens in a new tab): if engagement forms are connected to the page
• Ratings: if a rating form is connected to the page
• Version History: the page's change history

1. Basic data

The "Basic data" tab has three sections:

• Types of pages: the type of the page (or screen) you are creating. The following types are available:

  1. Common page: for regular pages (or screens), such as home or about;
  2. Catalog page: for pages (or screens) that will contain a catalog, for example of products or media items;
  3. Error page: for error pages (or screens). Link the error code in the Additional settings (opens in a new tab) block;
  4. External page: for creating a link to an external site. In the Page URL field, you can enter any external URL (for example, https://example.com).
     Blocks and forms are not available for these pages; they don't appear in the editor.
     This type is used in the menu as an external link (for example, to a corporate website, social media, or partner sites).

• Details has three input fields: "Page title" (the title of the page or screen), "Page URL" (a unique identifier used later to call the page or screen), and "Name of the menu item for the page" (the name of the page or screen shown in "Menu"). The "Menu" block is covered in later chapters (opens in a new tab).

• Editor: the block where you add the content of the page (or screen) itself. Above the editor there are three modes: HTML, Markdown, and Plain Text.
  HTML (a text editor with formatting) is selected by default. To use Markdown markup, select Markdown:
  
  To switch to plain text without formatting, select Plain Text:
  The editor can also optimize uploaded images. This is enabled by default and has its own checkbox:
  

  For the text editor documentation, see here. For Markdown, see here.

2. Categories

The "Categories" tab lets you build the app's tree structure and set up parent-child relationships between pages (or screens).
For example, the demo page (or screen) has the following nesting: "catalog" -> "shop" -> "demo"

You can also see the nesting on the main screen of the "Pages" module, which lists all created pages (or screens). In this list, you can also change the nesting by dragging pages (or screens) in the table.

3. Attributes

The "Attributes" tab has two dropdown lists for selecting a template (opens in a new tab) and an attribute set (opens in a new tab). "Attributes" are a core concept of the OneEntry platform and are described in detail in later chapters.

After you select an attribute set, fill in the values. In our example, the "Homepage" page uses the "Page attribute" set with the following attributes:

• "Name": "String" type. We set its value to "Name";
• "Description": "Text with header" type, a text with a heading;
• "demo_attr": "String" type;
• "Menu icon": "Image" type, a field for uploading an image. You can also optimize the uploaded image by clicking "Optimize uploaded images" and change the image parameters directly in OneEntry;
• "List": "List" type, for selecting a value from a list.

4. Blocks

The "Blocks" tab has a dropdown list for selecting blocks and a list of the selected blocks. You can move (sort) blocks the same way as pages (or screens). Each block also has an actions column:

Configure

Delete

For a catalog page, you can attach any set of blocks as a template for new products.
To do this, select the blocks you created in "Product blocks that are attached to all child products".
New products on this page will then be created with this set of blocks:

Blocks are covered in detail in later chapters

(opens in a new tab)

5. Engagement forms

The "Engagement forms" tab appears on a saved page (or screen) if engagement forms are connected to it: for this page, for its parent page together with its nested pages, or for all entities of the module.

The tab shows data submitted through the connected forms. In the "Form" selector, select a form, set filters if needed ("User ID who sent data", "Status", dates in DD-MM-YYYY format, the "Sent by administrator" checkbox), and click "Select". The "Reset" button clears the filters. The "Turn on forms sort mode" switch turns on form sorting mode.

Forms are covered in detail in later chapters

(opens in a new tab)

6. Ratings

The "Ratings" tab appears on a saved page (or screen) if a form of the Rating Form type is connected to it (for this page, for its parent page together with its nested pages, or for all entities of the module). The tab shows the page's rating based on the connected "Rating configuration" settings.

7. Version History

Every saved page (or screen) has a "Version History" tab. It stores the page's change history; the "Restore Data" button restores data from the selected version.