Skip to main content

Site Configuration

To add a new page (domain), you need to create a configuration file. Follow these steps:

  1. Navigate to your private directory.
  2. Create a new folder with the name of the site identifier under private/config/sites/. For example: private/config/sites/main.
  3. Create a file named config.json in this new folder.

You can also set this up through the CMS backend. Navigate to Sites and then click on Configuration. If you want to create a new site, click on + Add Site.

sites

info

If you place a favicon.ico file in the site identifier folder, it will be used as the favicon for that site. You can then access it via /wac/fa/<site-identifier>/ using the WAC.

config.json​

The config.json file contains the configuration settings for your new page. Here is an example of the content of the config.json file:

/private/config/sites/<site-identifier>/config.json
{
  "base": "<base-domain>",
  "siteIdentifier": "<site-identifier>",
  "siteTitle": "Title of Page",
  "languages": {
    "flag": "en"
  },
  "baseVariants": [
    {
      "base": "<base-variants-domain>",
      "conditions": ""
    }
  ],
  "errorHandling": {
    "errorPage404": "<error-page-id>"
  },
  "routes": [],
  "importRoutes": {
    "url": "<importRoutes-url>"
  }
}

Base Variants​

Define different variants for the entry point.

"baseVariants": [
  {
    "base": "http://example.dev",
    "conditions": "mod='devMod' status='live'"
  }
]

Conditions (Variabeln)​

example:

"conditions": "mod='devMod' status='live'"
mod='devMod'

devMod is a variable that activates debugging mode to view errors.

status='live'

status sets the status of the site.

Custom Error Page​

If you want to set up a custom error page, you can do so by configuring the errorHandling section in your config.json file. For example:

"errorHandling": {
    "errorPage404": "12"
}

Import Routes​

The Import Static Route function in PingoJS allows you to import static routes from external sources via a URL. This simplifies the management and integration of routes by automatically incorporating them into the system, eliminating the need to manually create each individual route. It is ideal for quickly implementing URL structures using a JSON schema.