Configuring Menus and Layouts

• Default Layout: This is the primary structure your users will see when they visit the portal. Setting it ensures consistency and proper navigation.

• Authentication Portal: This layout controls how users log in to the portal, ensuring secure access and a professional login experience.

• Authentication Guard (Optional): This adds an extra layer of security, requiring users to log in before accessing certain layouts.
  
  

• Open the Menu List section in the Website Edit page.

• Click on the + icon to create a new menu. A form will appear to configure the menu settings.
  
  

  Open

  

Define Menu Details

• Title: Enter a descriptive title for the menu, such as "Header Menu." This helps in identifying the menu.

• Status: Set the menu status to ACTIVE to ensure it is functional and displayed on the website.

• Description (Optional): Add a description for the menu to provide context for future reference.
  
  

Add Menu Items

Open

• Open the Menu Items tab under the created menu.

• Click on the + icon to add a new menu item.

• Fill in the following fields:

  • Title: Specify the name of the menu item, such as "E-Invoice."

  • Link Type: Choose the type of link:

    • Internal: Use for linking to pages within the system (e.g., Layout Instance Link).

    • External: Use for linking to an external URL.

  • Layout Instance: Select the relevant layout instance for the menu item, such as "e-invoice."

  • Order: Specify the order in which the menu item will appear (e.g., "1" for the first item).

  • Additional Options:

    • Authentication Link: Enable this if users need to log in to access the linked page.

    • Visible to Logged-In Users Only: Restrict visibility to authenticated users.

    • Display Menu Title: Ensure the title of the menu item is visible to users.
      
      

• Save the menu item after filling in the required fields.
  
  

Steps to Configure the Default Layout and Authentication Portal

• Open the Website Edit section in the CP-Commerce Admin App. This is where you manage website-specific settings.

• Set the Default Layout
  Under the Details tab, locate the field labeled Default Layout Routing.
  Select the layout you previously created for the portal (e.g., "e-invoice").
  This ensures that all users visiting the portal will see this layout as the primary structure.

• Configure the Authentication Portal
  In the same Details tab, locate the field labeled Default Authentication Portal.
  Choose the layout designated for the login page (e.g., "login").
  This ensures that users are directed to a professional and functional login interface when accessing the portal.

• Save the Settings
  Click the Save button to confirm and apply the changes.

Enable Authentication Guard (Optional)

Why This Step is Important

• Ensures a consistent and branded user experience by setting a default layout.

• Protects sensitive information by requiring users to log in through the authentication portal.

• Adds an optional security feature (Authentication Guard) to control access to specific layouts, maintaining the integrity of your portal.

By completing this step, your portal will be secure, user-friendly, and well-structured for your audience.

• What is an Authentication Guard?
  This feature ensures that users must log in before accessing specific layouts, enhancing security.

• How to Enable Authentication Guard
  Navigate to the Platform Config tab within the Layout Edit section.
  In the JSON configuration, add the following code snippet to require authentication for the layout:

   

"guards": [
"REQUIRED_AUTH"
],

• Save the updated configuration.