Resource Resolution

Zesty.io Open Source ATOM Plugin Start Trial

Search…

Resource Resolution

The order in which specific types of behavior or views load, from 301 redirects to 404s.

When a request is served by WebEngine, it reads the url path and attempts to match the url path to a content item resources. URL are checked against resource in a specific order, and will resolve the resource first if a match is found. If two resources share a URL path, then the one that loads first will resolve and the other is ignored.
Resource load order:
1.
Static files generated by Zesty.io: site.css and site.js
2.
Instant JSON API e.g. /-/instant/7-zyx-zyxzyc.json
3.
GQL API e.g. /-/gql/*
4.
Static files generated by Zesty.io: sitemap.xml, feed.xml, robots.txt
5.
Legacy JSON endpoints e.g. /-/custom/
6.
Well Known Files e.g. /.well-known/*
7.
Custom endpoints e.g. /custom/endpoints.json
8.
Legacy HTML endpoints e.g. /ajax/ 
9.
Content Models Views if a content item's meta path matches the request page e.g. /about/team/
10.
Wild Card Views e.g. /store/*/cool-shirt/
11.
301 redirects
12.
404 Pages e.g. when no resources match the url pattern
Base Directory Setting
Overview
Zesty.io will default all automated assets files to the root / directory unless the base directory setting has been added and set. 

there is a setting on the instance with category:general key:base_directory with a directory set as its value e.g. /blog/
Base Directory and Zesty.io Auto-created Files
Once the Base Directory settings has a value the Zesty.io auto-created files listed below will be immediately affected.
site.js
site.css
sitemap.xml
robots.txt
feed.xml
​Instant JSON API​
​GQL API​
Using the Base Directory setting with non-automated files
Other files created in the code editor such as custom endpoints must be manually named to follow the path of your choice. If you want content items to follow the same path as the Base Directory setting value, then a content model must exist with that path. For example, if you're using Zesty.io WebEngine only for your website's  /blog/ subdirectory then you need to setup a content item as a placeholder with /blog/ as its URL and create the Base Directory setting (as shown below)  with the value /blog/. 
Adding the Base Directory Setting
The Base Directory setting can be added via API with the following JSON body:
1
{
2
    "category": "general",
3
    "keyFriendly": "Base Directory",
4
    "key": "base_directory",
5
    "value": "",
6
    "admin": false,
7
    "parselyAccess": false,
8
    "dataType": "text",
9
    "options": "",
10
    "tips": ""
11
}
Copied!
 If you know what value you want the base directory set to go ahead and add it to the JSON body under value.

Environment States & Caching Behaviors

View Templating

Last modified 5mo ago

Export as PDF

Copy link

Contents

Base Directory Setting